Dokumentation zu Fahrplankomponenten

MX Timetable verwaltet wiederkehrende wöchentliche Termine und zeigt diese in einem interaktiven Zeitplan an. Administratoren können Termine in Zeitplänen organisieren, das Erscheinungsbild der einzelnen Zeitpläne konfigurieren und Joomla-Menüpunkte für den Zeitplan, einen einzelnen Termin oder ein Terminformular erstellen.

Installieren oder aktualisieren

1. Öffnen Sie im Joomla-Administratorbereich System → Installieren → Erweiterungen.
2. Laden Sie das Installationspaket der Komponente (com_mxtimetable.zip) und führen Sie den Installationsvorgang ab.
3. Bei einer Aktualisierung installieren Sie das neue Paket über die vorhandene Komponente. Sichern Sie die Website vor Aktualisierungen als allgemeine Vorsichtsmaßnahme bei der Joomla-Wartung.
4. Öffnen Sie Komponenten → Zeitplan, um Zeitpläne und Veranstaltungen zu verwalten.

Einen Stundenplan einrichten

1. Gehen Sie zu Komponenten → Timetable → Zeitpläne und erstellen Sie einen Zeitplan. Geben Sie ihm einen Namen und veröffentlichen Sie ihn.
2. Konfigurieren Sie die unten beschriebenen zeitplanspezifischen Anzeigeoptionen oder belassen Sie die Einstellung auf Komponenteneinstellung verwenden, um die globalen Standardeinstellungen zu übernehmen.
3. Gehen Sie zu Komponenten → Timetable → Timetable-Veranstaltungen und erstellen Sie eine Veranstaltung.
4. Geben Sie einen Titel ein, wählen Sie den Stundenplan aus, wählen Sie einen Wochentag aus und legen Sie die Start- und Endzeiten fest. Verwenden Sie das 24-Stunden-Format (zum Beispiel 08:30). Die Endzeit muss später liegen als die Startzeit.
5. Fügen Sie optionale Veranstaltungsinformationen hinzu, veröffentlichen Sie die Veranstaltung und speichern Sie sie.
6. Wiederholen Sie diesen Vorgang für die anderen Ereignisse im Wochenplan.

Ereignisse, denen kein Stundenplan zugewiesen ist, werden nur in der Ansicht „Alle Stundenpläne“ angezeigt. Ein Menüpunkt für einen Stundenplan zeigt die diesem Stundenplan zugewiesenen Ereignisse an.

Veranstaltungsfelder

• Titel: Name des Termins. Termine mit demselben Titel werden durch den Titelfilter des Stundenplans gruppiert; veröffentlichte Termine mit demselben Titel werden zudem auf den jeweiligen Detailseiten als verwandte Termine angezeigt.
• Stundenplan: Der Stundenplan, zu dem diese Veranstaltung gehört.
• Tag und Uhrzeit: Wochentag und Start-/Endzeiten im 24-Stunden-Format. Termine wiederholen sich wöchentlich; diese Komponente weist keine Kalenderdaten zu.
• Veranstaltungsfarbe: Wählen Sie „Auto“ (tagesbasiert), eine der voreingestellten Farben oder „Benutzerdefinierte Farbe“. Bei „Benutzerdefinierte Farbe“ können Sie auch die Textfarbe der Veranstaltung festlegen.
• Ort: Optionaler Ortsname.
• Breiten- und Längengrad: Optionale Dezimal-Koordinaten. Geben Sie beide gültigen Koordinaten ein, um einen Marker auf der OpenStreetMap-Einbettung des Eintrags zu platzieren, wenn die Karte aktiviert ist.
• Standortfoto: Optionales Bild für den Standort.
• Kursleiter und Kursleiterfoto: Optionaler Name und Bild des Kursleiters. Die Einstellung zur Sichtbarkeit des Fotos ist unabhängig davon, ob der Name des Kursleiters angezeigt wird.
• Preis: Optionaler, nicht negativer Betrag. Das Währungssymbol wird in den Anzeigeeinstellungen konfiguriert.
• Beschreibung: Optionale Rich-Text-Details, die angezeigt werden, wenn die Details einer Veranstaltung geöffnet werden.
• Veröffentlicht: Nur veröffentlichte Veranstaltungen erscheinen im öffentlichen Stundenplan und unter „Ähnliche Veranstaltungen“.

Frontend-Seiten erstellen

Erstellen Sie unter Menüs einen Menüeintrag und wählen Sie den Komponententyp MX Timetable aus:

• Wochenplan zeigt Veranstaltungen für alle Zeitpläne oder für einen ausgewählten Zeitplan an.
• Einzelnes Element zeigt eine Veranstaltung an. Wählen Sie die Veranstaltung in den erforderlichen Einstellungen des Menüpunkts aus.
• ItemForm stellt ein Frontend-Formular zum Hinzufügen oder Bearbeiten eines Termins bereit. Legen Sie die Element-ID gemäß den Vorgaben in den Einstellungen des Menüeintrags fest; verwenden Sie 0 für ein Hinzufügungsformular.

Das Frontend-Formular enthält dieselben Veranstaltungsdetails wie das Administratorformular. Die Berechtigungen für Joomla-Komponenten legen fest, wer Veranstaltungen erstellen, bearbeiten, veröffentlichen oder löschen darf. Erteilen Sie nur die für Ihre Website geeigneten Berechtigungen und testen Sie den Menüpunkt, während Sie als der vorgesehene Benutzer angemeldet sind.

Veranstaltungstitel im Zeitplan können mit ihren Elementseiten verlinkt werden, wenn die Option Veranstaltungstitel mit Elementseiten verknüpfen aktiviert ist. Elementseiten bieten außerdem eine Navigation mit „Zurück“ und „Weiter“, wenn benachbarte veröffentlichte Veranstaltungen im Wochenplan vorhanden sind. Benutzer mit ausreichenden Berechtigungen sehen auf den Elementseiten möglicherweise Steuerelemente zum Bearbeiten, Einchecken oder Löschen.

Anzeigeeinstellungen

Globale Standardeinstellungen finden Sie unter Komponenten → Zeitplan → Optionen. Zeitplan-Einträge und Menüelemente können die entsprechenden Einstellungen überschreiben; wählen Sie Komponenteneinstellung verwenden (oder lassen Sie das Feld leer), um die Einstellungen zu übernehmen. Bei Zeitplan-Optionen mit der Angabe Zeitplan- oder Komponenteneinstellung verwenden wird die Standardeinstellung der Komponente verwendet, wenn der Zeitplan selbst keinen Wert enthält.

Wochenplan

• Stundenplantitel anzeigen: Die Überschrift ein- oder ausblenden.
• Stundenplankategorie anzeigen: Den Namen des ausgewählten Stundenplans anzeigen oder ausblenden.
• Auslöser für Details: Öffnen Sie die Veranstaltungsdetails durch Anklicken oder zeigen Sie einen Tooltip an, wenn Sie mit der Maus darüberfahren (sofern diese Funktion verfügbar ist).
• Veranstaltungszeit, Ort, Ortsfoto, Kursleiter, Kursleiterfoto, Beschreibung und Preis anzeigen: Legen Sie unabhängig voneinander fest, welche Details angezeigt werden sollen.
• Maximale Zeichenanzahl für die Beschreibung: Begrenzen Sie die Länge der Beschreibung in den Veranstaltungsdetails. 0 bedeutet, dass die vollständige Beschreibung angezeigt wird.
• Währungssymbol für den Preis: Text, der hinter den Veranstaltungspreisen angezeigt wird (globale Standardeinstellung ist €).
• Überschreibungen von Frontend-Bezeichnungen: Ersetzen Sie Bezeichnungen wie „Titel“, „Tag“, „Zeit“, „Ort“, „Kursleiter“, „Preis“ und „Beschreibung“. Lassen Sie ein Feld leer, um den Standardtext der Sprache zu verwenden.

Wenn sich Veranstaltungen überschneiden, teilen sie sich die verfügbare Breite der Tagesspalte. Veranstaltungen, die sich nicht überschneiden, können sich über angrenzenden freien Platz bis zur vollen Breite der Tagesspalte ausdehnen. Auf schmalen Bildschirmen wird der Wochenplan zu einer vertikal gestapelten Liste von Tagen und Veranstaltungen. Ein Titel-Dropdown filtert Veranstaltungen nach Titel.

Veranstaltungsdetailseite

• Zeitplan-Kategorie anzeigen: Zeigen Sie den Namen des Zeitplans in den Veranstaltungsdetails an oder blenden Sie ihn aus.
• Zeit, Ort, Ortsfoto, Kursleiter, Kursleiterfoto, Beschreibung und Preis anzeigen: Steuert die entsprechenden Veranstaltungsfelder auf der Einzelansicht.
• Verwandte Veranstaltungen anzeigen: Zeigt andere veröffentlichte Veranstaltungen mit demselben Titel an, sortiert nach Wochentag und Beginnzeit. Ihre Titel sind mit den jeweiligen Veranstaltungsseiten verlinkt.
• OpenStreetMap auf Einzelseiten anzeigen: Zeigt eine Karte an, wenn für die Veranstaltung gültige Längen- und Breitengradkoordinaten vorliegen.
• Maximale Zeichenanzahl für die Beschreibung, Währungssymbol für den Preis und Überschreibungen der Frontend-Bezeichnungen: Konfigurieren Sie die Veranstaltungsseite wie oben beschrieben.

Berechtigungen und Zugriff

Die Komponente nutzt Joomla-ACL-Aktionen für die Verwaltung, das Management, das Anlegen, Löschen, Bearbeiten, Statusänderungen sowie das Bearbeiten eigener Veranstaltungen. Konfigurieren Sie diese unter Benutzer → Verwalten → Gruppen (oder in den Berechtigungseinstellungen der Website). Frontend-Formulare zum Erstellen/Bearbeiten erfordern die entsprechenden Berechtigungen; öffentliche Besucher sollten keinen Schreibzugriff erhalten, es sei denn, dies ist beabsichtigt.