Zur Hauptnavigation springen Zum Inhalt springen Zur Fußnavigation springen

Erstellen von benutzerdefinierten Datei-Überschreibungen

Creating Custom File Overrides

Wir haben bereits einige der Möglichkeiten beschrieben, wie Sie das Verzeichnis THEME_DIR/custom/custom/ verwenden können, um Partikel- und Themendateien zu duplizieren und anzupassen, aber für den erfahrenen Webentwickler, der diesen zusätzlichen Schritt gehen und praktisch alle Aspekte des Gantry-basierten Themas anpassen möchte, bieten wir eine detaillierte Anleitung für Sie.

Dieses spezielle Handbuch enthält Informationen, die Ihnen helfen, benutzerdefinierte Versionen von Dateien zu erstellen, die sich auf den Kern von Gantry, das Thema und vieles mehr beziehen. Diese Ressource ist nur für fortgeschrittene Benutzer gedacht und kann die Funktionalität beeinträchtigen oder unterbrechen. In diesem Fall sollten Sie den Inhalt Ihres THEME_DIR/custom/ Verzeichnisses löschen können, um zu den Standardeinstellungen zurückzukehren.

Wenn Sie benutzerdefinierte Dateien erstellen, sollten Sie diese Dateien immer in Ihrem benutzerdefinierten Verzeichnis aufbewahren. Wenn Sie überschriebene Dateien platzieren oder bestehende Dateien außerhalb dieses Verzeichnispfades bearbeiten, laufen Sie Gefahr, diese Anpassungen zu verlieren, wenn das Gantry-basierte Design oder das Gantry-Framework aktualisiert wird.

In diesem und anderen Teilen der Dokumentation verweist THEME_DIR auf das primäre Themenverzeichnis. In Joomla mit dem Hydrogen-Template, wäre der wahre Verzeichnispfad /templates/g5_hydrogen/ mit dem benutzerdefinierten Verzeichnispfad des Benutzers /templates/g5_hydrogen/custom.

Gantry-Verzeichnisstruktur

Das Gantry installiert 6 Erweiterungen. Wir haben diese Erweiterungen detailliert beschrieben, einschließlich exemplarischer benutzerdefinierter Dateiüberschreibungen für Erweiterungen mit Dateien, die Sie wahrscheinlich anpassen werden, unten.

Der Einfachheit halber haben wir in den folgenden Abschnitten eine Kurzreferenz-Tabelle der Informationen beigefügt.

ErweiterungInstallierter VerzeichnispfadBenutzerdefinierter Verzeichnispfad
Gantry 5 Framework (Library) /libraries/gantry5 (see notes below)
  /media/gantry5/assets TEMPLATE_DIR/custom
Gantry 5 Nucleus Engine (File) /media/gantry5/engines/nucleus TEMPLATE_DIR/custom/engine
Gantry 5 Themes (Component) /administrator/components/com_gantry5 TEMPLATE_DIR/custom/admin
  /components/com_gantry5 TEMPLATE_DIR/custom/admin

PHP-Klassen, die sich in /libraries/gantry5 befinden, können ebenfalls überschrieben werden, aber da sie automatisch geladen werden müssen, erfordert dies einige zusätzliche manuelle Eingriffe, die das Hinzufügen eines Laders für Klassen erfordern.

Gantry 5 (Paket)

Dieses Paket enthält den Installer / Uninstaller für alle anderen Kernerweiterungen. Es ist das eine Paket, das Sie installieren und deinstallieren würden, wobei alle anderen Pakete an dieses Paket gebunden sind. Es gibt keine Dateien in diesem Paket, die wir Ihnen empfehlen würden, da es für den Betrieb von Gantry unerlässlich ist und keinen wirklichen Nutzen durch die Anpassung bringen würde.

Gantry 5 Framework (SAP-Bibliothek)

Diese Erweiterung enthält den Code des Frameworks. Dieser Code wird in /libraries/gantry5 installiert und ist immer für jede Joomla-Erweiterung verfügbar. Gängige Asset-Dateien werden in /media/gantry5/assets installiert. Alle Assets können in /templates/TEMPLATE_DIR/custom überschrieben werden.

Beispiel-DateiBeispiel für eine benutzerdefinierte Datei
/media/gantry5/assets/css/font-awesome.min.css /templates/TEMPLATE_DIR/custom/css/font-awesome.min.css

Gantry 5 Nucleus Engine (Datei)

Die Nucleus Engine ist die intern vom Gantry-Administrator verwendete Rendering-Engine und alle kommerziellen RocketTheme-Vorlagen. Es wird auf /media/gantry5/engines/nucleus installiert und alle diese Dateien können in /templates/TEMPLATE_DIR/custom/engine angepasst werden.

Beispiel-DateiBeispiel für eine benutzerdefinierte Datei
/media/gantry5/engines/nucleus/templates/page.html.twig /templates/TEMPLATE_DIR/custom/engine/templates/page.html.twig

Gantry 5 Themen (Komponente)

Dies ist der Gantry-Themenmanager innerhalb des Joomla-Administrators. Es wird auch im Frontend für benutzerdefinierte Seitenaufrufe verwendet. Es wird sowohl auf /administrator/components/com_gantry5 als auch auf /components/com_gantry5 installiert. Gantry-spezifische Verwaltungsdateien können in /templates/TEMPLATE_DIR/custom/admin überschrieben werden.

Beispiel-DateiBeispiel für eine benutzerdefinierte Datei
/administrator/components/com_gantry5/templates/pages/about/about.html.twig /templates/TEMPLATE_DIR/custom/admin/templates/pages/about/about.html.twig

Quick-Icon - Gantry 5 (Plugin)

Dieses einfache Plugin fügt ein Verknüpfungssymbol aus dem Joomla Administrator Control Panel (Landing Page nach der Anmeldung) zum Gantry Theme Manager hinzu.

System - Gantry 5 (Plugin)

Dieses Plugin Bootstraps Gantry5 Framework und hakt in einige Ereignisse ein, um die Benutzerfreundlichkeit zu verbessern. Es muss immer aktiviert sein, damit Gantry 5-Vorlagen funktionieren.

Gantry-Themendateien

Alle Vorlagen befinden sich im Ordner /templates. Ändern oder ergänzen Sie keine Dateien in der Vorlage selbst, da diese Änderungen bei der nächsten Aktualisierung der Vorlage gelöscht werden. Wenn Sie eine Vorlagendatei anpassen möchten, können Sie dies im Ordner templates/TEMPLATE_DIR/custom/ tun.

Hier ist ein Beispiel dafür, wo sich die Quelldatei und die angepasste doppelte Datei befinden würden:

Beispiel-DateiBeispiel für eine benutzerdefinierte Datei
/templates/TEMPLATE_DIR/images/ipad.png /templates/TEMPLATE_DIR/custom/images/ipad.png

Dies gilt nicht nur für die Anpassung bestehender Dateien, sondern auch für das Hinzufügen neuer Dateien, wie z.B. Partikel-Dateien. Wir haben diesen Prozess in unseren vorherigen Leitfäden zum Anpassen von Theme-Dateien und zum Erstellen eines neuen Partikels beschrieben. Sie können auch gemeinsame Assets, die Rendering-Engine oder Teile des Administrators anpassen.