Verwendung von CMS-Inhalten in Partikeln

Neue Funktion in Gantry 5.2.14.

Partikel sind großartig darin, benutzerdefinierte Inhalte in bestimmten Bereichen Ihrer Website anzuzeigen, aber wussten Sie, dass Sie auch Inhalte direkt aus dem Content Management System (CMS) anzeigen können? Das ist möglich, und so läuft das hier.

Dies ist ein anspruchsvoller Prozess, und wir empfehlen, ihn nur auszuprobieren, wenn Sie ein erfahrener Entwickler mit guten Kenntnissen im Umgang mit Daten im CMS sind. Dies ist etwas, mit dem sich Endbenutzer und Site-Manager wahrscheinlich nie befassen müssen, da sie Zugriff auf die vorab erstellten Formularfelder im Administrator haben.

Sie müssen Gantry Content Finders verwenden, um die Informationen direkt aus Joomla zu laden. Danach können Sie diese Daten auf dem Frontend rendern.

Gemeinsame Funktionen für alle Finder

Erstellen eines neuen Finders

{% set options = {published: true, id: [14, 3]} %}
{% set finder = joomla.finder('category', options) %}

parse(options) Parse-Optionen Array nach Regeln analysieren

Entspricht dem zweiten Parameter beim Erstellen des Finders.

{% set options = {published: true, id: [14, 3]} %}
{% tun finder.parse(options) %}

.find() Finden Sie Elemente mithilfe von Seitenumbrüchen.

Standard-Seitengrenze, abhängig vom Objekttyp.

{% set results = finder.find() %}

.count() Zählt die Gesamtzahl der Elemente.

Diese Funktion gibt eine Anzahl von Elementen zurück und ignoriert die eingestellte Seitenzahl.

Gesamtzahl der Elemente: {{ finder.count() }}

Operations

.start(limitstart = 0) Seitenanfang

Definiert das erste anzuzeigende Element. Standardwert ist 0.

{% do finder.start(10) %}

.limit(limit = 10) Seitenumbruchgrenze

Definiert die maximale Anzahl der Elemente. Standardwert ist 10.

{% do finder.limit(3) %}

.order(by, direction ='ASC', alias = 'a') Seitenumbruchreihenfolge

Gibt die Reihenfolge der Artikel an.

{% do finder.order('id', 'DESC') %}

.where(field, operation, value) Benutzerdefinierte where-Klausel

Der Betrieb ist einer von: >, >=, <, <, <=, =, BETWEEN, NOT BETWEEN, IN und NOT IN.

{% do finder.where('id', '<', 5) %}
{% do finder.where('id', 'BETWEEN', [1,5]) %}
{% do finder.where('id', 'NOT IN', [1,2,3,4,5]) %}

Kategorie-Finder

Erstellen eines neuen Kategorienfinders

{% set options = {published: true, id: [[14,15], 3]} %}
{% set finder = joomla.finder('category', options) %}

.id(ids, include = true)

• ids Entweder Array von ids oder einzelne IDs
• include Set True, wenn Sie aufgelistete Kategorien einbeziehen möchten, false, wenn Sie sie ausschließen möchten.

{% do finder.id([1,2,3]) %}

.language(language = true)

• language Wahr, wenn der Benutzer den Standardwert verwendet, andernfalls den Sprachschlüssel.

{% do finder.language('en-GB') %}

HINWEIS: Sie müssen einen Sprachfilter hinzufügen, sonst sieht der Benutzer Artikel aus allen Sprachen.

Inhalts-Finder

Erstellen eines neuen Content Finders

{% set options = {featured: true, id: [[1,2,3]]} %}
set finder = joomla.finder('content', options) %}

.id(ids, include = true)

• ids Entweder Array von ids oder einzelne IDs
• include Set True, wenn Sie aufgelistete Artikel einbeziehen möchten, false, wenn Sie sie ausschließen möchten.

{% do finder.id([1,2,3]) %}

.featured(include = true)

• include Setzen Sie True, wenn Sie ausgewählte Artikel einbeziehen möchten, false, wenn Sie sie ausschließen möchten.

{% do finder.featured() %}

.author(ids, include = true)

• ids Entweder Array von ids oder einzelne IDs
• include Setzen Sie True, wenn Sie nach Autor einschließen möchten, false, wenn Sie davon ausschließen möchten.

{% do finder.author(64) %}

.language(language = true)

• language Wahr, wenn der Benutzer den Standardwert verwendet, andernfalls den Sprachschlüssel.

{% do finder.language('en-GB') %}

HINWEIS: Sie müssen einen Sprachfilter hinzufügen, sonst sieht der Benutzer Artikel aus allen Sprachen.

.category(ids, include = true)

• ids Entweder Array von IDs oder einzelne IDs - akzeptiert auch die Sammlung von Kategorien, die vom Finder gefunden wurden.
• include Setzen Sie True, wenn Sie aufgelistete Kategorien einbeziehen möchten, false, wenn Sie sie ausschließen möchten.

{% do finder.category([1,2,3]) %}