Was_sind_Platzhalter
Platzhalter werden in Clansphere verwendet, um an deren Stelle die eigentlichen Inhalte automatisch einfügen zu lassen.
Sie werden in den anpassbaren Themes und Templates von Clansphere verwendet.
Template Platzhalter
Durch Template Platzhalter werden die Templates mit von PHP erstellten Inhalten gefüllt. So wird zum Beispiel bei {func:show} der Inhalt geladen, bei {users:login} der Login und die Kontoverwaltung und so weiter.
Generell sind die Template platzhalter folgendermaßen aufgebaut:
{MOD:ACTION}
An dieser Stelle wird mods/MOD/ACTION.php geladen und eingebunden. Einige Dateien benötigen zusätzliche Parameter. Diese werden zB. so übermittelt:
{static:view:id=5}
So wird die Statische Seite Nummer 5 angezeigt. Es gibt aber auch einige spezielle Platzhalter, die direkt von Clansphere kommen. Eine Liste der typischen Template Platzhalter gibt es Templates_Platzhalter.
Erstellen eigener Platzhalter
Das Erstellen eigener Template Platzhalter ist recht simpel.- Zu erst erstellt man die so genannte Action PHP Datei, welches sich in dem Modul Ordner befinden muss, um dessen Modul es geht.
- Nach erstellen der PHP Datei, ist eigentlich der Platzhalter schon erstellt. System dem Platzhalters {mod:actiondatei}. Beispiel, Gästebuch Navliste /mods/gbook/navlist.php wurde erstellt. Der Name des Platzhalters ist nun {gbook:navlist}
Theme Platzhalter
Auch in Themes können Platzhalter verwendet werden:- {url:mod_action} => Links einbinden, Bsp: {url:gbook_list} öffnet das Gästebuch (siehe auch Allgemeine Platzhalter)
- {lang:variable} => Sprachdateien nutzen, nutzt eine Sprachvariable aus der aktuell geladenen Sprachdatei
Allgemeine Platzhalter
In den Templates, sowie in den Themes, kann man auf folgenden Platzhalter zugreifen:{url:MOD_ACTION}
Dieser Platzhalter erstellt dynamisch einen seiteninternen Verweis, in dem Fall index.php?mod=MOD&action=ACTION. Das funktioniert auch ohne ACTION, also {url:MOD} verweist auf index.php?mod=MOD. Allerdings ist dieser Platzhalter weitaus dynamischer als schlicht den Verweis zu benutzen. Die Datei, mit der man browst, wird automatisch angepasst (index.php, board.php, debug.php, admin.php etc). Verwendet man AJAX, werden die Verweise so abgeändert, dass der Inhalt durch AJAX neu geladen wird. Zudem ist es nun auch kein Problem mehr, auf mod_rewrite umzusteigen, da die Links automatisch angepasst werden.
Benutzt wird der Platzhalter z.B. so: <a href="{url:gbook}">Gbook</a>. Nun wird die /mods/gbook/list.php aufgerufen.
| Linkliste_fuer_die_Designanpassung« | Was_sind_Platzhalter | »Templates_Platzhalter |
