Inhaltsportfolio – Ajax-Dokumentation

1. Voraussetzungen

• Joomla mit der Kernkomponente „Artikel“ (com_content) aktiviert.
• Veröffentlichte Artikel, auf die der aktuelle Besucher Zugriff hat.
• Ein beschreibbares Joomla-Cache-Verzeichnis, wenn die Bildgrößenanpassung aktiviert ist.
• Joomla 4 oder neuer für die AJAX-Funktion „Mehr laden“.

2. Installation

1. Öffnen Sie im Joomla-Administrator „System > Installieren > Erweiterungen“.
2. Laden Sie mod_mx_contentportfolio.zipoder installieren Sie das Paket über dessen URL.
3. Öffnen Sie „Erweiterungen > Module“, suchen Sie „Content Portfolio Ajax“ und erstellen oder bearbeiten Sie eine Instanz.
4. Setzen Sie den Modulstatus auf „Veröffentlicht“ und wählen Sie eine Template-Position aus.
5. Wählen Sie unter „Menüzuordnung“ die Seiten aus, auf denen das Portfolio angezeigt werden soll.
6. Speichern Sie das Modul und überprüfen Sie die Seite im Frontend.

Das Modul lädt seine CSS- und JavaScript-Dateien aus seinem eigenen assets Verzeichnis. Entfernen Sie die assets, core, languageoder tmpl Verzeichnisse.

3. Schnellstart

Für ein einfaches Portfolio:

1. Erstellen oder bearbeiten Sie Joomla-Artikel und veröffentlichen Sie diese. Fügen Sie auf der Registerkarte „Bilder und Links“ jedes Artikels ein Einführungsbild hinzu, falls Bilder erforderlich sind.
2. Wählen Sie auf der Registerkarte „Quelle“ des Moduls unter „Kategorie auswählen“ eine oder mehrere Kategorien aus.
3. Stellen Sie die Anzahl der Artikel auf die Anzahl der Elemente ein, die zunächst angezeigt werden sollen.
4. Wählen Sie unter „Einstellungen“ einen visuellen Stil aus und legen Sie die Anzahl der Elemente pro Ansicht fest.
5. Lassen Sie die Optionen „Bilder anzeigen“, „Titel anzeigen“, „Beschreibung anzeigen“ und „Weiterlesen anzeigen“ aktiviert, sofern das Design nichts anderes erfordert.
6. Veröffentlichen Sie das Modul und überprüfen Sie, ob die ausgewählten Artikel sichtbar sind.

Wenn keine Kategorie ausgewählt ist, kann das Modul alle ansonsten in Frage kommenden Artikel verwenden. Die Auswahl von Kategorien wird empfohlen, um eine vorhersehbare Ausgabe zu gewährleisten.

4. Quelleneinstellungen

Artikel

• „Kategorie auswählen“ beschränkt die Quellartikel auf die ausgewählten Kategorien.
• „Artikel in Unterkategorien“ schließt Artikel in Unterkategorien ein oder aus.
• „Ebenen“ legt die maximale Tiefe der Unterkategorien fest.
• „Tags“ beschränkt die Quellartikel auf ausgewählte Joomla-Tags.
• „Ausgewählte Artikel“ zeigt ausgewählte Artikel an, blendet sie aus oder zeigt nur ausgewählte Artikel an.
• „Artikelreihenfolge und Reihenfolgerichtung“ steuert die Reihenfolge der Abfrage, einschließlich Titel, ID, Datum, Aufrufe, Reihenfolge nach Manager und zufällige Reihenfolge.
• „Anzahl der Artikel“ legt die Anzahl der pro Anfrage geladenen Artikel fest.
• „Link-Ziel“ öffnet Links im selben Fenster, in einem neuen Fenster/Tab oder in einem Popup.
• „Inhaltsereignisse auslösen“ aktiviert Joomla-Inhalts-Plugin-Ereignisse für angezeigte Artikel.

Text und Metadaten

• Titel anzeigen oder ausblenden und die maximale Zeichenanzahl festlegen.
• Zeigen Sie Tags an oder blenden Sie sie aus, wählen Sie die Anzahl der Tags und platzieren Sie sie oberhalb oder unterhalb der Beschreibung.
• Zeigen Sie die Beschreibung an oder blenden Sie sie aus und legen Sie die maximale Zeichenanzahl fest.
• Kategorietitel, Autor, Datum und den „Weiterlesen“-Link ein- oder ausblenden.
• Legen Sie optionale Präfixe für Kategorie und Autor, das Datumsformat sowie die Bezeichnung für den „Weiterlesen“-Link fest.

Die Beschreibung wird aus dem Einleitungstext des Artikels übernommen. Bei positiven Zeichenbegrenzungen wird der Text gekürzt; bei Aktivierung der Ausblendoption wird der Inhalt vollständig ausgeblendet.

5. Bildeinstellungen

Aktivieren Sie „Bilder anzeigen“ für die ausgewählten Stile. Das Modul sucht nach Bildern in der unter „Bildreihenfolge“ festgelegten Reihenfolge.

• image_intro: das Bild aus der Einleitung des Artikels.
• image_fulltext: das Bild aus dem Artikelvolltext.
• inline_introtext: ein Bild, das im Einleitungstext gefunden wurde.
• inline_fulltext: ein Bild, das im Volltext gefunden wurde.
• external: ein extern referenziertes Bild, sofern dies unterstützt wird.

Beispiel für die Bildreihenfolge:

image_intro, image_fulltext, inline_introtext, inline_fulltext

Wenn kein Bild gefunden wird, ist der Standard-Platzhalter modules/mod_mx_contentportfolio/assets/images/noimage.jpg.

Wenn die Größenanpassung aktiviert ist, konfigurieren Sie die Größenanpassungsfunktion, den Ausgabetyp, die Qualität, die Transparenz sowie die Breite und Höhe. Das Joomla-Cache-Verzeichnis muss beschreibbar sein, damit generierte Bilder gespeichert und wiederverwendet werden können.

6. Layout und Darstellung

• Stil: Wählen Sie Stil 1 bis Stil 6 oder „Zufällig“.
• Elemente pro Ansicht: Wählen Sie 1 bis 6 Spalten.
• Benutzerdefinierte Elementgrößen verwenden: Aktiviert das Größenmuster für das erste Element.
• Größenmuster für das erste Element: durch Kommas getrennte Werte wie double, normal, double-height, normal, normal, double-width.
• Volle Breite: Erweitert das Modul auf die Breite des Ansichtsbereichs.
• Ausrichtung der Filter: Platziert Filter rechts, mittig oder links.
• „Bootstrap laden“ und „jQuery laden“: Nur aktivieren, wenn die Vorlage diese nicht bereits bereitstellt.
• Benutzerdefiniertes CSS: Fügt CSS hinzu, das auf diese Modulinstanz beschränkt ist.

double erstreckt sich über zwei Spalten und zwei Zeilen, double-width erstreckt sich über zwei Spalten und double-height erstreckt sich über zwei Zeilen. Ungültige oder fehlende Werte werden als normal.

7. Filter

Aktivieren Sie „Kategoriefilter“ und/oder „Tag-Filter“, um Filterlinks oberhalb der Tabelle anzuzeigen. Kategoriefilter verwenden die Artikelliste des Moduls; wenn Tag-Filter bei ausgewählten Kategorien aktiviert sind, umfassen die Tag-Links alle veröffentlichten Artikel-Tags aus diesen Kategorien, einschließlich Tags auf Artikeln, die über die anfängliche Seitengröße hinausgehen.

• Filterbezeichnungen zeigen Kategorie- oder Tag-Bezeichnungen an.
• Die Beschriftung „Alle anzeigen“ fügt den Link hinzu, der durch den Text „Alle“ konfiguriert wurde.
• Der Filtermodus steuert, wie viele Filterlinks ein Besucher auswählen kann:
• - „Einzeln“: Durch die Auswahl eines Filters wird die vorherige Auswahl gelöscht. Verwenden Sie diese Option, wenn Besucher jeweils nur eine Kategorie oder ein Tag durchsuchen sollen.
• - „Mehrfach“: Besucher können mehrere Kategorie- und/oder Tag-Filter auswählen. Ausgewählte Filter werden hervorgehoben und können ein- oder ausgeschaltet werden.
• Die Logik für mehrere Filter wird nur verwendet, wenn der „Filtermodus“ auf „Mehrfach“ eingestellt ist. Sie steuert, wie ausgewählte Filter kombiniert werden:
• - „ODER“: Ein Artikel wird angezeigt, wenn er mindestens einem ausgewählten Filter entspricht.
• - „UND“: Ein Artikel wird nur angezeigt, wenn er allen ausgewählten Filtern entspricht.
• Die Reihenfolge der Tag-Filter sortiert die Tags nach der Reihenfolge im Joomla-Backend oder nach dem Titel.

Beispiele für den Filtermodus

Im Einzelmodus wird durch die Auswahl eines Filters die vorherige Auswahl gelöscht. Im Mehrfachmodus mit „ODER“-Logik muss ein Artikel mindestens einem der ausgewählten Filter entsprechen. Bei der „UND“-Logik muss er allen ausgewählten Filtern entsprechen. Der Link „Alle“ löscht die aktiven Filter und zeigt alle Artikel aus den Quell-Ergebnissen an.

8. „Mehr laden“

Aktivieren Sie in den Einstellungen die Option „Mehr laden anzeigen“ und stellen Sie die „Anzahl der Artikel“ auf die Seitengröße ein. Die Schaltfläche fordert den nächsten Satz an, ohne die Seite vollständig neu zu laden, und verschwindet, wenn keine passenden Artikel mehr verfügbar sind.

Stileinstellungen

Stil

Wählen Sie die Darstellung des Portfolios aus:

• Random: Wählt zufällig einen der verfügbaren Stile aus.
• Style 1 bis Style 6: Verwenden Sie einen bestimmten Portfolio-Stil.

Standard: Style 2.

Elemente pro Zeile

Legt die Anzahl der in jeder Zeile angezeigten Portfolioelemente fest. Mögliche Werte sind 1 bis 6.

Standard: 3.

Benutzerdefinierte Elementgröße verwenden

Aktiviert benutzerdefinierte Elementgrößen im Portfolio-Raster.

• Yes: Wendet das konfigurierte Muster für die Elementgröße an.
• No: Verwende für alle Elemente die normale Elementgröße.

Standard: Yes.

Elementgrößen

Sichtbar, wenn Use Custom items size aktiviert ist. Geben Sie ein durch Kommas getrenntes Muster für die Elementgrößen ein. Unterstützte Werte sind:

• normal: eine Spalte und eine Zeile.
• double: zwei Spalten und zwei Zeilen.
• double-width: zwei Spalten und eine Zeile.
• double-height: eine Spalte und zwei Zeilen.

Beispiel:

double,normal,double-height,normal,normal,double-width

Das Muster wird der Reihe nach angewendet und wiederholt sich für nachfolgende Elemente, die mit „Load More“ geladen werden. double-width und double-height sind für Stil 6 vorgesehen. Das Standardmuster enthält 16 Einträge.

Einstellungen für „Mehr laden“

„Mehr laden“ anzeigen

Legt fest, ob die Schaltfläche „Mehr laden“ verfügbar ist.

• Yes: Ermöglicht es Besuchern, weitere Artikel anzufordern.
• No: Nur die erste Ergebnismenge anzeigen.

Standard: Yes.

„Mehr laden“ erfordert Joomla 4 oder neuer sowie eine positive Artikelanzahl in den Quelleneinstellungen.

Text für „Mehr laden“

Sichtbar, wenn Show Load More die Funktion aktiviert ist. Legt den Text fest, der auf der Schaltfläche angezeigt wird.

Standard: Load More.

„Mehr laden“-Effekt

Sichtbar, wenn Show Load More aktiviert ist. Wählt die Einblendanimation für Elemente aus, die über die Schaltfläche geladen werden:

• Appear In
• Simple Fade
• Fade In Up
• Fade In Down
• Zoom In
• Bounce In
• Flip In
• Light Speed In Left
• Rotate In Down Left
• Jack in box
• None

Layout in voller Breite

Volle Breite

Steuert die Modulbreite:

• Yes: Das Portfolio wird über die gesamte Breite des Viewports angezeigt, unabhängig vom Container der Vorlage.
• No: Verwendet die vom Template-Layout vorgegebene Breite.

Standard: No.

Filtereinstellungen

Filterposition

Legt die horizontale Position der Kategorie- und Tag-Filter fest:

• Right
• Center
• Left

Standard: Right.

Filterbezeichnungen anzeigen

Steuert den beschreibenden Text, der vor den Filterelementen angezeigt wird.

• Yes: Zeigt die Bezeichnungen der Kategorie- und Tag-Filter an.
• No: Diese Beschriftungen ausblenden.

Standard: Yes.

Kategoriefilter

Legt fest, ob Links zu den Kategorie-Filtern angezeigt werden.

• Yes: Filter für die Kategorien anzeigen, die durch die Artikelergebnisse des Moduls repräsentiert werden.
• No: Kategorie-Filter ausblenden.

Standard: Yes.

Text „Nach Kategorie filtern“

Sichtbar, wenn beide Category filters und Show filter labels aktiviert sind. Legt die Bezeichnung fest, die für Kategoriefilter angezeigt wird.

Standard: Filter by category.

Tag-Filter

Legt fest, ob Links zu Tag-Filtern angezeigt werden.

• Yes: Filter für Tags anzeigen, die in den Artikelergebnissen des Moduls vertreten sind.
• No: Tag-Filter ausblenden.

Standard: No.

Text „Nach Tags filtern“

Sichtbar, wenn beide Tag filters und Show filter labels aktiviert sind. Legt die Bezeichnung fest, die für Tag-Filter angezeigt wird.

Standard: Filter by tags.

Reihenfolge der Tag-Filter

Sichtbar, wenn Tag filters aktiviert ist. Sortiert die Tag-Filter-Links nach:

• Backend Order: der in Joomla konfigurierten Reihenfolge.
• Title: alphabetischer Reihenfolge der Titel.

Standard: Backend Order.

Reihenfolge des Tag-Filters

Sichtbar, wenn Tag filters aktiviert ist. Legt die Sortierrichtung der Tags fest:

• Ascending
• Descending

Standard: Ascending.

Schaltfläche „Alle anzeigen“

Legt fest, ob ein Link zum Löschen der aktiven Filter angezeigt wird.

• Yes: Den Link „Alle“ anzeigen.
• No: Den Link „Alle“ ausblenden.

Standard: Yes.

Filterauswahl

Legt fest, wie Besucher Filter auswählen:

• One filter at a time: Die Auswahl eines anderen Filters ersetzt die aktuelle Auswahl.
• Multiple filters: Besucher können mehrere Filter gleichzeitig auswählen.

Standard: One filter at a time.

Übereinstimmung bei mehreren Filtern

Sichtbar, wenn Filter selection auf Multiple filters. Legt fest, wie ausgewählte Filter kombiniert werden:

• All selected tags (AND): Ein Artikel muss jedem ausgewählten Filter entsprechen.
• Any selected tag (OR): Ein Artikel muss mindestens einem ausgewählten Filter entsprechen.

Standard: Any selected tag (OR).

Text der Schaltfläche „Alle“

Legt den Text des Links fest, der die aktiven Filter löscht und zur vollständigen Ergebnismenge zurückkehrt.

Standard: All.

9. Fehlerbehebung

Es werden keine Artikel angezeigt

• Stellen Sie sicher, dass die Artikel veröffentlicht und zugänglich sind.
• Überprüfen Sie Kategorien, Tags, den Status „Vorgestellt“, die Sprache und die Menüzuordnung.
• Stellen Sie sicher, dass das Modul an einer Position veröffentlicht ist, die von der aktiven Vorlage gerendert wird.

Bilder fehlen

• Fügen Sie dem Artikel ein Intro- oder Volltextbild hinzu.
• Aktivieren Sie die entsprechende Bildquelle und fügen Sie das Bild in die Bildreihenfolge ein.
• Überprüfen Sie den Pfad des Platzhalters und die Berechtigungen für das Cache-Verzeichnis.

Filter zeigen nicht die erwarteten Optionen an

Filter werden aus den Artikelergebnissen des Moduls erstellt, nicht aus jeder Kategorie oder jedem Tag in Joomla. Erweitern Sie die Quellenauswahl und stellen Sie sicher, dass relevante Artikel veröffentlicht sind.

„Mehr laden“ ist nicht sichtbar

Stellen Sie sicher, dass Joomla 4 oder neuer installiert ist, die Option „Mehr laden“ aktiviert ist, die Artikelanzahl positiv ist und genügend erste Ergebnisse vorhanden sind.

Es treten Stil- oder JavaScript-Konflikte auf

Deaktivieren Sie „jQuery laden“ oder „Bootstrap laden“, wenn die Vorlage diese Bibliotheken bereits lädt. Leeren Sie den Joomla- und den Browser-Cache.

10. Aktualisierung

Sichern Sie vor dem Aktualisieren die Modulkonfiguration und die Website-Dateien. Installieren Sie die neuere ZIP-Datei über den Erweiterungsinstallierer von Joomla. Das Modul gibt einen Update-Server an, sodass Joomla möglicherweise auch Updates anbietet, wenn der Server erreichbar ist.