|
| Geeklog Dokumentation - Variablen in Themen |
Hinweis: Dies ist keine vollständige Dokumentation der Themenvariablen – diese Dokumentation beschäftigt sich nur mit den Variablen, die in den Seitenkopf- und Artikeltemplates benutzt werden.
Geeklog benutzt die Template-Engine der PHP
Base Library (auch bekannt als PHPlib). Diese Library ermöglicht die
Nutzung
sogenannter "Variablen" in Template-Dateien. Eine Variable ist ein Wort
in geschweiften
Klammern, wie z.B. {variable}. Wenn Geeklog eine Webseite erzeugt,
werden die Variablen in den Template-Dateien durch bestimmte Werte ersetzt. Eine
Variable kann einen statischen Text (dann wird die Variable immer durch
dem selben Text ersetzt),
dynamische Inhalte (z.B. die Anzahl der Kommentare zu einem Artikel) und sogar
den Inhalt einer anderen Template-Datei (dieses Feature wird z.B. in Listen benutzt)
enthalten.
Bitte beachten Sie, dass nicht alle Variablen in allen Template-Dateien zur
Verfügung stehen. Während die Variable {site_url} (in
der die URL Ihrer Geeklog steht) in den meisten Template-Dateien definiert
ist, sind viele Variablen nur in einer Template-Datei definiert (die Variable {formatted_article} ist
nur in der Template-Datei article.thtml verfügbar). Geeklog ersetzt
alle Variablen, die für das jeweilige Template nicht definiert sind, durch
einen leeren String. Wenn Sie eine nicht-definierte Variable benutzen, wird
keine Fehlernachricht erzeugt, sondern die Variable wird stillschweigend entfernt
– genauer ausdrückt: Sie wird durch einen leeren String ersetzt.
Die folgenden Variablen sind im Header der Site, in der Template-Datei header.thtml definiert:
| Variable | Example | Description |
|---|---|---|
site_url |
http://www.example.com | Die URL Ihrer Geeklog-Site (genau die URL, die in der Datei config.php als
$_CONF['site_url'] angegeben ist). |
layout_url |
http://www.example.com/layout/XSilver | Die URL des Ordners layout mit dem augenblicklichen Thema des Benutzers. |
page_title |
Geeklog Site - Another Nifty Geeklog Site | Enthält entweder den Namen und den Slogan der Site oder den Seitennamen und den Titel des augenblicklichen Artikels. |
background_image |
http://www.example.com/layout/ XSilver/images/bg.gif |
Verweist auf ein Bild mit dem Namen bg.gif im Verzeichnis images des augenblicklichen Themas, das als Hintergrundbild benutzt werden soll. |
site_mail |
admin@example.com | Die Email-Adresse für die Kontaktaufnahme mit dem Administrator der Site. Um dem Spam-Problem zu entgegnen, sollten Sie diese Adresse nicht auf Ihrer Site benutzen und stattdessen einen Link auf das Email-Formular des Admins angeben: {site_url}/profiles.php?uid=2 (wobei "2" die User ID des Email-Empfängers ist – i.d.R der Admin-User). |
site_name |
Geeklog Site | Der Name Ihrer Geeklog-Seite |
site_slogan |
Another Nifty Geeklog Site | Der Slogan oder Wahlspruch Ihrer Site |
welcome_msg |
Welcome to Geeklog Site | Eine Willkommens-Nachricht, gefolgt durch den Namen des Besuchers (für registrierte Benutzer). |
datetime |
Thursday, November 28 2002 @ 11:43 AM PST | Die augenblickliche Zeit und das Datum, formatiert entsprechend dem Eintrag
in $_CONF['date']. |
site_logo |
http://www.example.com/layout/ XSilver/images/logo.gif |
Verweist auf eine Datei namens logo.gif im Verzeichnis images des augenblicklichen Themas, die als Seitenlogo verwendet werden soll. |
css_url |
http://www.example.com/layout/ XSilver/style.css |
Verweist auf das Stylesheet des augenblicklichen Themas. |
theme |
XSilver | Name des augenblicklichen Themas. |
charset |
iso-8859-1 | Der Zeichensatz der augenblicklichen Sprachdatei. |
rss_url |
http://www.example.com/backend/geeklog.rdf | Die URL des RSS-Feeds Ihrer Seite (identisch zu {rdf_file}).
Diese Variable ist auch in der Template-Datei footer.thtml
für den Seitenfuß verfügbar. |
rdf_file |
http://www.example.com/backend/geeklog.rdf | Die URL des RSS-Feeds Ihrer Seite (identisch zu{rss_url}).
Diese Variable ist auch in der Template-Dateifooter.thtml für
den Seitenfuß verfügbar. |
Die folgenden Variablen sind in den Template-Dateien storytext.thtml,
storybodytext.thtml, featuredstorytext.thtml und featuredstorybodytext.thtml definiert.
Diese Dateien werden benutzt, um Artikel auf der Index-Seite darzustellen und
werden auch für den Inhalt der Variablen {formatted_article} in
der Datei article/article.thtml
benutzt (für die Darstellung eines Artikels in einer eigenen Seite).
| Variable | Example | Description |
|---|---|---|
site_url |
http://www.example.com | Die URL Ihrer Geeklog-Site (exakt die URL, die Sie in $_CONF['site_url'] in
Ihrer config.php
Datei angeben). |
layout_url |
http://www.example.com/layout/XSilver | Die URL des Verzeichnisses layout des augenblicklichen Themas des Benutzers. |
story_date |
Tuesday, October 22 2002 @ 11:50 PM PDT | Das Datum und die Zeit des Artikels, formatiert entsprechend der Einstellung der bevorzugten Darstellung von Datum und Uhrzeit eines Benutzers. |
lang_views |
Views | Das Wort "Views" in der vom Benutzer eingestellten Sprache. |
story_hits |
42 | Gibt an, wie oft der Artikel gelesen wurde. |
article_url |
http://www.geeklog.net/article.php ?story=20021022234959146 |
Die URL zum Artikel auf der individuellen Seite (article.php). Die Variable referenziert auch gleichzeitig die korrekte URL, wenn URL Rewriting aktiviert wird. |
story_id |
20021022234959146 | Die ID eines Artikels (die auch zum Aufbau von URLs wie z.B. für den Link "Link auf diesen Artikel" benutzt werden kann). |
story_title |
Welcome to Geeklog! | Der Titel (Überschrift) eines Artikels |
story_introtext |
Welcome and let me be the first to congratulate you on installing GeekLog ... | Bei der Darstellung auf der Indexseite enthält die Variable die Einleitung (intro text) des Artikels. Wenn die Variable innerhalb eines Artikels auf einer individuellen Seite benutzt wird, enthält sie sowohl die Einleitung als auch den Bodytext. |
lang_todays_featured_article |
Today's Featured Article | Die Worte "Der Leitartikel von heute" in der vom Benutzer eingestellten Sprache. Steht nur zur Verfügung, wenn der Artikel der Leitartikel ist. |
Die folgenden Variablen stehen nur zur Verfügung, wenn der Artikel auf der Index-Seite dargestellt wird und der Bodytext des Artikels nicht leer ist:
| Variable | Example | Description |
|---|---|---|
lang_readmore |
read more | Die Worte "read more" in der vom Benutzer eingestellten Sprache. |
lang_readmore_words |
words | Das Wort "words" in der vom Benutzer eingestellten Sprache. |
readmore_words |
62 | Die Anzahl der Worte im Bodytext des Artikels. |
readmore_link |
<a href="...">read more</a> (62 words) |
Link zum Artikel auf einer separaten Seite, wobei die Anzahl der Wörter im Bodytext bereits in der Variablen enthalten ist. |
start_readmore_anchortag |
<a href=".../article.php |
Öffnender Tag für einen Link auf den Artikel auf einer separaten Seite. |
end_readmore_anchortag |
</a> |
Schliessender Tag für einen Link zum Artikel. |
email_icon |
(icon) | Das Email-Icon, das zum Formular verweist, mit dem der Artikel in der Email verschickt wird. |
print_icon |
(icon) | Das Drucker-Icon, das zu einer "druckerfreundlichen" Version des Artikels linkt. |
recent_post_anchortag |
-- | Solange noch keine Kommentare abgegeben wurden, enthält diese Variable
einen Link zum Kommentar-Formular
(just
like
{post_comment_link}). Wenn es bereits Kommentare zum Artikel
gibt, enthält diese Variable keinen Link, sondern den Namen desjenigen,
der den letzten Kommentar abgegeben hat sowie das Datum und die Zeit,
zu dem der Kommentar abgegeben wurde. |
Die folgenden Variablen sind nur dann verfügbar, wenn Kommentare zu einem Artikel möglich sind und bereits Kommentare zu einem Artikel existieren:
| Variable | Example | Description |
|---|---|---|
comments_url |
http://www.example.com/article.php ?story=20021022234959146#comments |
URL des Kommentarbereichs (wenn ein Artikel auf einer separaten Seite dargestellt wird). |
comments_text |
2 comments | Die Anzahl der Kommentare gefolgt von dem Wort "comments" in der vom Benutzer eingestellten Sprache. |
comments_count |
2 | Die Anzahl der Kommentare zu einem Artikel (ist immer 1 oder größer als 1). |
lang_comments |
comments | Das Wort "comments" in der vom Benutzer eingestellten Sprache. |
start_comments_anchortag |
<a href=".../article.php |
Öffnendes Tag für einen Link zum Kommentarbereich eines Artikels. |
end_comments_anchortag |
</a> |
Schließendes Tag für einen Link zum Kommentarbereich eines Artikels. |
post_comment_link |
<a href=".../comment.php |
Link zum Formular, in dem ein Kommentar abgegeben wird (benutzt den Ausdruck "Post a comment" in der vom Benutzer eingestellten Sprache als Linktext). |
Die folgenden Variablen sind nur dann verfügbar, wenn $_CONF['contributedbyline']
= 1; in der config.php eingetragen ist, d.h., wenn Sie erlauben,
dass der Name des Artikelautors dargestellt wird:
| Variable | Example | Description |
|---|---|---|
lang_contributed_by |
Contributed by: | Der Text "Contributed by:" in der vom Benutzer eingestellten Sprache. |
contributedby_uid |
7 | Die Benutzer-ID des Autors des Artikels. |
contributedby_user |
Tony | Der Benutzername (Kurzform) des Autors. |
contributedby_fullname |
Tony Bibbs | Der volle Name des Autors. Wenn der Benutzer seinen vollen Namen nicht angegeben hat, wird stattdessen der Benutzername verwendet. |
start_contributedby_anchortag |
<a class="storybyline" href="http://www.example.com/ |
Öffnendes Tag für einen Link auf das Profil des Autors (leer, wenn der Autor anonym ist). |
end_contributedby_anchortag |
</a> |
Schließendes Tag für einen Link auf das Profil des Autors (leer, wenn der Autor anonym ist). |
contributedby_url |
http://www.example.com/ users.php?mode=profile&uid=7 |
Link auf das Profil des Autors (leer, wenn der Autor anonym ist). |
contributedby_photo |
<img src=".../images/userphotos/Tony.gif" alt="Tony Bibbs"> | Benutzerfoto des Autors, sofern es zur Verfügung gestellt wurde (immer leer, wenn der Autor anonym ist). |
camera_icon |
Kamera-Icon und Link zum Userprofil des Autors | Wenn der User ein Bild von sich hochgeladen hat, enthält diese Variable das kleine Kamera-Symbol (wie im Block "Wer ist online?") und einen Link zum Userprofil des Autors. Andernfalls (und für Beiträge von Gästen) ist die Variable leer. |
Die folgenden Variablen sind nur verfügbar, wenn Themensymbole (topic icons) für den Artikel benutzt werden und der Benutzer die Themensymbole in seinen Einstellungen nicht deaktiviert hat:
| Variable | Example | Description |
|---|---|---|
story_anchortag_and_image |
<a href="http://www.example.com/ (shortened) |
Themensymbol für das Thema des Artikels, eingeschlossen in einen Link auf die Indexseite der Site, sortiert nach Thema (topic). |
story_topic_image |
<img align="right" src="http://www.example.com/ |
Themensymbol für den Artikel. |
story_topic_id |
General | Id (interner Name) des Themas, die z.B. in Links benutzt werden kann. |
story_topic_name |
General News | Themenname (so wie er im Sektionsblock angezeigt wird). |
story_topic_url |
<a href="http://www.example.com/ |
URL der Indexseite Ihrer Site mit der ausschliesslich Artikel zu dem angegebenen Thema dargestellt werden. |
Die folgenden Variablen sind nur verfügbar, wenn der augenblickliche Benutzer das Recht hat, den Artikel zu bearbeiten (editieren):
| Variable | Example | Description |
|---|---|---|
edit_link |
<a href=".../admin/story.php |
Der Link, mit dem der Artikel im Storyeditor des Admins geöffnet wird. |
edit_icon |
<a href=".../admin/story.php |
Ein Icon, das auf den Artikel im Storyeditor des Admins verweist. |
edit_url |
http://www.example.com/admin/story.php ?mode=edit&sid=20021022234959146 |
URL, die den Artikel im Storyeditor des Admins öffnet. |
lang_edit_text |
edit | Das Wort "edit" in der vom Benutzer eingestellten Sprache. |
| The Geeklog Documentation Project All trademarks and copyrights on this page are owned by their respective owners. GeekLog is copyleft. |