Inhalt
HTML Ausgaben von WPCarSync anpassen
Mittels Templates lassen sich einzelne HTML Ausgaben sowie E-Mail Inhalte von WPCarSync dauerhaft verändern, ohne dass diese Änderungen nach einem Updates des Plugins überschrieben werden.
Dazu werden die originalen Template-Dateien aus dem Plugin Ordner in einen Unterordner unterhalb von wp-content/uploads/wpcarsync/templates/ dupliziert und können dort dann beliebig angepasst werden.
Standard-Templates anpassen
Quellordner
- Alle Templates in WPCarSync (und aller AddOns) liegen immer im Unterordner „tpl“ des jeweiligen Plugin-Ordners
- Dabei liegt jedes Template immer in einem weiteren Unterordner,
z.B. Template für [WPCS_single]: ../plugins/WPCarSync/tpl/single/single.php - Den Namen des jeweiligen Templates erfahren sie in der Dokumentation der entsprechenden Funktion, sofern diese ein Template verwendet. Im Fall von WPCS_single hier.
ZielOrdner
Um Templates verändern zu können, müssen sie in ein anderes Verzeichnis dupliziert werden
- Der Pfad zum Ordner für eine Kopie des Templates lautet: ../wp-content/uploads/wpcarsync/templates
- Dabei muss die exakte Unterordner- und Dateibenamung eingehalten werden,
im Beispiel von WPCS_single lautet der vollständige Pfad../wp-content/uploads/wpcarsync/templates/single/single.php
Eigene Templates erstellen
Sie haben die Möglichkeit, neben den Standard-Templates auch eigene Templates anzulegen und zu verwenden. Der Name des eigenen Templates kann frei gewählt werden.
Dazu bieten viele Shortcodes den Parameter template, um die Bezeichnung eines Templates anzugeben.
Beispiel: Sie möchten eine Template für die Ausgabe von Personen für den Shortcode [WPCS_persons] umsetzen, mit dem Namen mein_template
- Legen Sie das Template unter wp-content/uploads/wpcarsync/templates/theme/person/mein_template.php ab
- Verwenden Sie beim Aufruf des Shortcode den Template-Parameter: [WPCS_persons template=“mein_template“]
So können Sie Personen an beliebigen Stellen der Website unterschiedlich darstellen.
Loop Templates
Die meisten Shortcodes bieten neben dem template – Parameter zusätzlich den loop_template – Parameter.
Beispiel: Sie möchten wieder Personen darstellen, in einem 3er – Raster, allerdings möchten sie die Darstellung der einzelnen Person im Raster bestimmen.
Da der Shortcode bereits ein Raster-Template bietet (grid), nutzen wir dieses und Ändern mittels Loop Template nur die Person:
[WPCS_persons layout=“grid“ grid=“3″ loop_template=“mein_template“]
Abbildung zeigt Personen mit Standoard Loop Template (tpl/theme/person/loop_grid.php)
Abbildung zeigt Personen mit eigenem Loop Template (../uploads/wpcarsync/templates/theme/person/loop_mein_template.php)