Dokumentation zur Komponente zur Erstellung von Menüs

Zugriff auf das Backend

1. Melden Sie sich im Backend (Administrationsbereich) Ihrer Joomla-Website unter yoursite.com/administrator.
2. Navigieren Sie über das Hauptmenü zur Komponente „Mx Menu Creator“: Komponenten > Mx Menu Creator.

Verwalten von Kategorien

Kategorien dienen zur Organisation Ihrer Menüpunkte. Die Komponente nutzt das in Joomla integrierte Kategoriesystem.

Eine neue Kategorie hinzufügen

1. Gehen Sie im Joomla-Backend zu „Inhalte“ > „Kategorien“.
2. Wählen Sie im Dropdown-Menü „Erweiterung auswählen“ die Option „Mx Menu Creator“ aus.
3. Klicken Sie in der Symbolleiste auf die Schaltfläche „Neu“ (grünes Plus-Symbol).
4. Geben Sie die Details zur Kategorie ein:
- Titel: Geben Sie einen Namen für die Kategorie ein (z. B. „Vorspeisen“, „Hauptgerichte“).
- Alias: (Optional) Eine URL-freundliche Version des Titels.
- Beschreibung: (Optional) Eine Beschreibung der Kategorie.
   - Status: Setzen Sie den Status auf „Veröffentlicht“, um die Kategorie zu aktivieren.
- Zugriff: Legen Sie die Zugriffsebene fest (z. B. „Öffentlich“).
- Sprache: Wählen Sie die Sprache oder „Alle“.
5. Klicken Sie auf „Speichern & Schließen“, um die Kategorie anzulegen.

Eine Kategorie bearbeiten

1. Gehen Sie zu „Inhalt“ > „Kategorien“.
2. Wählen Sie „Mx Menu Creator“ aus dem Dropdown-Menü „Erweiterungen“ aus.
3. Klicken Sie auf den Kategorietitel oder markieren Sie ihn und klicken Sie auf „Bearbeiten“.
4. Nehmen Sie Ihre Änderungen vor und speichern Sie sie.

Eine Kategorie löschen

1. Wählen Sie die Kategorie in der Kategorieliste aus.
2. Klicken Sie in der Symbolleiste auf „Löschen“.
3. Bestätigen Sie den Löschvorgang.

Hinweis: Durch das Löschen einer Kategorie werden die darin enthaltenen Elemente nicht gelöscht, sondern als „unkategorisiert“ angezeigt.

Elemente verwalten

Elemente stellen die einzelnen Menüeinträge (z. B. Gerichte, Produkte) in Ihrem Menü-Generator dar.

Neuen Eintrag hinzufügen

1. Gehen Sie im Joomla-Backend zu „Komponenten“ > „Mx Menu Creator“ > „Elemente“.
2. Klicken Sie in der Symbolleiste auf die Schaltfläche „Neu“.
3. Geben Sie die Details zum Element ein:

   Grundlegende Informationen:
- Titel: Der Name des Menüelements (erforderlich).
- Alias: (Optional) URL-freundlicher Alias.
- Bild: Laden Sie das Hauptbild für das Menüelement hoch oder wählen Sie es aus (erforderlich). Empfohlene Größe: 1170px x 800px.
- Bildlayout: Wählen Sie das Layout aus (Quadrat, Rechteck, Turm oder Original).
- Allergene: (Optional) Fügen Sie über das Unterformular (Schaltflächen „Hinzufügen“, „Entfernen“ und „Verschieben“) Bilder zu Allergenen hinzu.
   - Beschreibung: Detaillierte Beschreibung des Artikels (erforderlich). Verwenden Sie den Editor zur Formatierung.

   Zusätzliche Einstellungen (Seitenleiste):
- Preis: Geben Sie den Preis ein (optional).
- Kategorie: Wählen Sie die Kategorie aus, zu der dieser Artikel gehört.
- Status: Setzen Sie den Status auf „Veröffentlicht“, um den Artikel sichtbar zu machen.
- Sprache: Wählen Sie die Sprache aus.
- Zugriff: Legen Sie die Zugriffsebene fest.
   - Erstellt: (Optional) Legen Sie das Erstellungsdatum fest.
- Erstellt von: (Optional) Legen Sie den Autor fest.

4. Klicken Sie auf „Speichern & Schließen“, um den Eintrag zu erstellen.

Ein Element bearbeiten

1. Gehen Sie zu „Komponenten“ > „Mx Menu Creator“ > „Elemente“.
2. Klicken Sie auf den Titel des Elements oder wählen Sie es aus und klicken Sie auf „Bearbeiten“.
3. Nehmen Sie Ihre Änderungen vor und speichern Sie sie.

Ein Element löschen

1. Wählen Sie den oder die Einträge in der Eintragsliste aus.
2. Klicken Sie in der Symbolleiste auf „Löschen“.
3. Bestätigen Sie den Löschvorgang.

Menüelemente erstellen (Joomla-Menüs)

Um die Inhalte Ihres Menü-Generators im Frontend anzuzeigen, müssen Sie Joomla-Menüelemente erstellen, die auf die Ansichten der Komponente verweisen.

Menüpunkt hinzufügen

1. Gehen Sie im Joomla-Backend zu „Menüs“ > [Name Ihres Menüs] (z. B. „Hauptmenü“).
2. Klicken Sie in der Symbolleiste auf „Neu“.
3. Klicken Sie im Abschnitt „Menüpunkt-Typ“ neben „Mx Menu Creator“ auf „Auswählen“.
4. Wählen Sie die passende Ansicht aus:
- Standard: Zeigt eine Liste von Elementen an (kann nach Kategorie gefiltert werden).
5. Konfigurieren Sie den Menüpunkt:
- Menütitel: Der Text, der im Menü angezeigt wird.
   - Alias: URL-freundlicher Alias.
- Übergeordnetes Element: (Optional) Legen Sie ein übergeordnetes Menüelement fest.
- Status: Setzen Sie den Status auf „Veröffentlicht“.
- Zugriff: Legen Sie die Zugriffsebene fest.
- Link: Die URL wird automatisch generiert.

6. Konfigurieren Sie für die Ansicht „Elemente“ die Anzeigeeinstellungen:
- Kategorie: Wählen Sie aus, ob Elemente aus allen Kategorien oder aus einer bestimmten Kategorie angezeigt werden sollen.
- Sortierung: Wählen Sie aus, wie die Elemente sortiert werden sollen (z. B. nach Erstellungsdatum, Titel).
   - Stil: Wählen Sie den Layoutstil aus (Standard, Karussell, Registerkarten, Einfach, Scrollen, Animiert, Ersetzen, Klassisch).
- Version: Wählen Sie das dunkle oder helle Design aus.
   - Spalten: Anzahl der anzuzeigenden Spalten (1, 2 oder 3).
- Begrenzung: Maximale Anzahl der anzuzeigenden Elemente (Standard: 12).
- Elementhöhe: Legen Sie die Höhe für den Karussell-Stil fest (verschiedene Optionen wie 600px, 80vh).
   - Deckkraft: Hintergrunddeckkraft für Überlagerungen (0,1 bis 0,9).
- Miniaturbildstil: Quadratische oder runde Miniaturbilder.
- Miniaturbildtyp: Masonry- oder quadratisches Layout.
- Allergene anzeigen: Anzeige von Allergenen aktivieren/deaktivieren.
   - Miniaturbilder für Allergene verwenden: Verwenden Sie Miniaturbilder für Allergene (sofern aktiviert).
- Popup-Bild: Bildlayout für Popups (Standard, Quadrat, Rechteck, Turm).
- „Weiterlesen“ anzeigen: Aktivieren/deaktivieren Sie „Weiterlesen“-Links.

7. Klicken Sie auf „Speichern & Schließen“, um den Menüpunkt zu erstellen.

Menüpunkt bearbeiten

1. Gehen Sie zu „Menüs“ > [Name Ihres Menüs].
2. Klicken Sie auf den Titel des Menüelements oder wählen Sie ihn aus und klicken Sie auf „Bearbeiten“.
3. Nehmen Sie Änderungen vor und speichern Sie diese.

Menüpunkt löschen

1. Wählen Sie den Menüpunkt aus.
2. Klicken Sie in der Symbolleiste auf „Löschen“.
3. Bestätigen Sie den Löschvorgang.

Weitere Tipps

- Veröffentlichung: Stellen Sie sicher, dass Kategorien, Einträge und Menüeinträge veröffentlicht sind, damit sie im Frontend angezeigt werden.
- Reihenfolge: Verwenden Sie die Sortierfunktion in Listen, um die Anzeigereihenfolge zu steuern.
- Module: Die Komponente enthält ein Modul (mod_mxmenucreator), mit dem Menüpunkte in Modulpositionen angezeigt werden können.
- Berechtigungen: Überprüfen Sie die Benutzerberechtigungen, wenn bestimmte Aktionen nicht verfügbar sind.
- Zwischenspeicher: Leeren Sie den Joomla-Zwischenspeicher nach Änderungen, um Aktualisierungen sofort zu sehen.

Fehlerbehebung

- Wenn Einträge nicht angezeigt werden, überprüfen Sie, ob sie veröffentlicht und einer veröffentlichten Kategorie zugeordnet sind.
- Stellen Sie sicher, dass Menüpunkte korrekt verlinkt sind und das Menü einem Modul zugeordnet ist.
- Überprüfen Sie die Fehlerprotokolle in der globalen Konfiguration von Joomla auf mögliche Probleme.

Für erweiterte Konfigurationen sehen Sie sich die Konfigurationsoptionen der Komponente unter „Komponenten > Mx Menu Creator > Optionen“ an.