Template Tags
Die nachstehend aufgeführten Template-Tags sind PHP-Anweisungen, die Sie in die Vorlage-Dateien einbinden müssen, um aus einer statischen eine dynamische Vorlage zu machen.
Beim Aufruf einer Seite im Browser wird der Code in der Vorlagen-Datei durch den Inhalt oder die Meta-Dateien der Seiten ersetzt, sodaß als Ergebnis die individuelle Seite erstellt und angezeigt wird.
Sicherlich werden Sie nicht alle Tags benötigen.
Die nachstehende Liste stellt die Standard-Template-Tags vor, die grundsätzlich in GetSimple vorhanden sind.
Möchten Sie weitere Tags nutzen, können Sie diese in der zu einem Theme gehörenden optionalen Datei functions.php definieren.
- get_page_content()
<?php get_page_content(); ?>
Gibt den Seiteninhalt in der Vorlage aus. Keine Parameter.
- get_page_excerpt()
<?php get_page_excerpt($length, $html); ?>
Gibt eine Kurzfassung des aktuellen Seiteninhaltes aus.
Sie können die Länge des Textausschnittes festlegen und regeln, ob die HTML-Formatierungen in den Auszug mitübernommen werden sollen.
Standard-Werte: $length = 200, $html = FALSE.
Enthalten seit Version 2.02
- get_page_meta_keywords()
<?php get_page_meta_keywords(); ?>
Gibt die Key-Worte und Meta-Beschreibungen einer Seite aus. Keine Parameter.
- get_page_title()
<?php get_page_title(); ?>
Gibt den Seitentitel aus. Keine Parameter.
- return_page_title()
<?php return_page_title(); ?>
Gibt den Seitentitel aus. Keine Parameter, enthalten seit Version 2.0
- get_page_clean_title()
<?php get_page_clean_title(); ?>
Gibt den Seitentitel aus, jedoch ohne HTML-Formatierung. Keine Parameter.
- get_page_slug()
<?php get_page_slug(); ?>
Gibt den “Seiten-Teil” einer URL aus. Klingt ungewohnt, meint aber dies:
Die URL einer von GetSimple erzeugten Seite besteht wie jede URL aus Protokoll und Domain-Name, also z.B. http://www.get-simple.de
Darauf folgen Verzeichnisname und Dateiname. Oder der Text, den Sie über die Festlegung der “friendly URLs” in den allgemeinen Einstellungen festgelegt haben.
Der Page Slug für diese Seite wäre also: eigene-themes-erstellen/template-tags/
Keine Parameter.
- return_page_slug()
<?php return_page_slug(); ?>
Identisch wie get_page_slug, gibt aber den slug zurück. Kann zum Erzeugen seitenspezischer CSS-IDs eingesetzt werden. Keine Parameter.
- get_page_url()
<?php get_page_url(); ?>
Gibt die URL der Seite wieder.
Parameter: TRUE = “return”, FALSE oder leer = “echo”.
Ausgabe des Tags auf dieser Seite wäre get-simple.de
- get_parent()
<?php get_parent(); ?>
Diese Anweisung gibt den slug der übergeordneten Seite (in einer hierarchischen Menü-Struktur) aus.
- get_page_date()
<?php get_page_date(); ?> <?php get_page_date('F jS, Y'); ?>Gibt das Datum der letzten Speicherung der aktuellen Seite aus.
Der Parameter ist nur dann notwendig, wenn Sie das Format des Datums selbst bestimmen möchten. Sie können dafür jede Variante der Datumsfunktion von PHP nutzen.
Standardformat ist : l, F jS, Y - g:i A
- get_header()
<?php get_header(); ?>
Gibt den Seiten-Header wieder. Keine Parameter.
Diese Anweisung erstellt automatisch 3 Meta-Tags:
'descripion', 'keywords', 'canonical' und 'generated').
Diese Anweisung gehört in den <head> </head> Abschnitt Ihrer Vorlage-Datei.
- get_footer()
<?php get_footer(); ?>
Gibt den Seiten-Footer aus. Keine Parameter.
Wird meistens genutzt, um Funktionalitäten einzubinden, die am Fuß einer jeden Seite ausgeführt werden sollen (Javascripte z.B.) Seit GS 2.0
- get_site_url()
<?php get_site_url(); ?>
Gibt die Domain der Webseite aus. Keine Parameter.
- get_theme_url()
<?php get_theme_url(); ?>
Gibt das Vorlagen-Verzeichnis (Theme-Verzeichnis) Ihrer GetSimple-Installation aus. Nützlich, um z.B. Stylesheets in diesem Verzeichnis oder spezielle Javascripte korrekt adressieren zu können, die zu der Vorlage-Datei gehören. Keine Paramater
- get_site_name()
<?php get_site_name(); ?>
Gibt den Namen Ihrer GetSimple-Seite wieder, wie er in den Allgemeinen Einstellungen eingetragen ist. Keine Parameter.
- get_site_email()
<?php get_site_email(); ?>
Gibt die Email-Adresse des Administrators aus, wie sie in den Allgemeinen Einstellungen vereinbart ist. Keine Parameter.
- return_site_ver()
<?php return_site_ver(); ?>
Gibt die Versionsnummer der auf Ihrer Seite aktiven GetSimple-Installation aus. Keine Parameter.
- get_site_credits()
<?php get_site_credits(); ?>
Gibt den Text “Powered by GetSimple Version” aus (oder das Äquivalent aus der Sprachdatei). Keine Parameter.
- get_component()
<?php get_component('component_slug'); ?>Gibt den Inhalt einer Komponente aus. Der Parameter component_slug muß angegeben werden. Sie finden diesen Wert auf der Components-Seite, (Vorlagen » Bearbeite Komponente) rechts oben über der gewünschten Komponente.
- get_navigation()
<?php get_navigation(return_page_slug()); ?>
Diese Anweisung gibt eine Liste der Unterseiten aus, die zu der als Parameter mitgegebenen Seite gehören. Deshalb muss dieser Page-Slug eingetragen werden.
Die Anweisung generiert die CSS-Klasse current für die aktuell im Browser geladene Seite.
Diese Anweisung muß in der Vorlage zwischen <ul> und </ul> oder zwischen <ol> und </ol> eingetragen sein, damit die Listenart definiert ist.
- menu_data()
<?php menu_data(); ?> <?php menu_data('page-slug'); ?>Diese Funktion gibt einen Array menüspezifischer Daten aus, mit denen Entwickler neue Menüs erstellen können anstelle der Standard-Funktion get_navigation().
Der optionale Parameter regelt, ob (wenn nicht gesetzt), die kompletten Menüdaten ausgegeben werden sollen oder die Daten der hier vereinbarten Seite.
