cellarius
19.11.2009, 01:32
Einleitung
Dies ist eine Übersetzung meines Artikels auf vb.org (http://www.vbulletin.org/forum/showthread.php?t=228078).
In vB4 werden Templates nicht länger durch eval() ausgegeben:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------ist veraltet.
Dazu kommt: Variablen und Arrays, die in Plugins definiert werden, die auf einer Seite ausgeführt werden, stehen nicht mehr automatisch in den Templates dieser Seite zur Verfügung. Sie müssen zunächst registriert werden.
.
Grundfunktion zum Rendern und Registrieren von Variablen/Arrays
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Die erste Zeile stellt das Template zur Verfügung, das gerendert (berechnet) werden soll, indem es die neue vB_Template-Klasse (vB_Template::create) verwendet. An die Methode wird der Name des Templates als Argument übergeben. Die beiden folgenden Zeilen registrieren eine Variable und ein Array, die im Template zur Verfügung stehen sollen. Als Argumente werden jeweils 1. der Name übergeben, unter dem die Variable im Template aufgerufen werden soll, sowie 2. die Variable, die übergeben werden soll. Man kann das beliebig oft wiederholen, also beliebig viele Variablen übergeben. Sinnvoll ist es aber, Daten ggf. besser in ein oder mehrere Arrays zu verpacken. Die vierte Zeile rendert (berechnet) letztendlich das Template ($templater->render()).
Im Template können die registrierten Variablen/Arrays nun wie folgt aufgerufen werden:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Hinweis zur letzten Zeile: Ja, multidimensionale Arrays sind kein Problem.
.
.
.
Was man mit den gerenderten Daten anstellen kann - was mache ich mit meinem gerendertenTemplate?
.
Template direkt ausgeben - für eigene Seiten
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Das gibt das Template unmittelbar aus. Damit kann man etwa das Template für eine eigene Seite ausgeben.
Besonders hinweisen möchte ich in diesem Zusammenhang auf die zweite Zeile des Beispieles:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Diese Zeile registriert automatisch einige Templates, die für die Seitendarstellung wichtig sind: header, footer und headinclude; diese drei Templates braucht man zur Darstellung einer "ordentlichen" vB-Seite.
.
Ausgabe über einen Template-Hook
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Dieses Template wird in den ausgewählten Template-Hook gespeichert und dort ausgegeben (Beispiel hier: $template_hook[forumhome_wgo_pos2]).
Der Punkt vor dem Gleichheitszeichen sorgt dafür, dass der Code nur an den Hook angehängt wird, statt ihn zu überschreiben. Das ist wichtig, weil auch andere Mods diesen Hook verwenden könnten. So bleibt erhalten, was sich evtl. schon dort befindet.
.
In eine Variable speichern und später in einem weiteren Template verwenden
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Dies speichert das gerenderte Template in eine Variale. Diese Variable wiederum können wir später für ein weiteres Template registrieren (wenn wir also das aktuelle Template in einem anderen Template aufrufen wollen):
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Wieder wäre der Aufruf in my_other_template:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Häufig wird das erste Template in einer Schleife berechnet, um eine Reihe serieller Daten auszugeben. Wenn das so ist, sollte auch hier .= statt nur = Anwendung finden - das hängt ganz von der jeweiligen Anwendung ab.
.
In ein Array speichern zur Verwendung in einem bereits existierenden Template von vBulletin
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Wenn man das gerenderte Template in einem bereits vorhandenen vB-Template verwenden will, hat man ein Problem: Wenn etwa FORUMHOME gerendert wird, haben wir darauf keinen Zugriff, um dort Variablen registrieren zu können. Es wird erstellt und berechnet innerhalp der php-Dateien, und die wollen wir - natürlich - nicht verändern.
Um das Problem, das während der Alpha-Testphase aufgetaucht ist, zu lösen, wurde eine neue Methode für die vB_Template-Klasse entwickelt: preRegister. Sie kann dazu verwendet werden, unsere Daten in den Registrierungsprozess einzuschleusen, bevor das Template gerendert wird. Achtung: erwartet wird ein Array, nicht eine einfache Variable als Argument ($templatevalues['my_insertvar']).
In der letzten Zeile wird das Array vorregistriert (preregister); dazu werden zwei Argumente übergeben: 2. der Name des existierenden Templates, und 2. das Array das die Daten enthält. Auch diese Prozedur kann man beliebig oft wiederholen. Allerdings sollte man dann eher die Arrayschreibweise verwenden (siehe unten).
Die vorregistrierte Variable wird im Template wie folgt aufgerufen:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Nota bene: Nicht {vb:raw templatevalues.my_insertvar}!
Im Grunde genau das Gleiche wie oben, nur in einer anderen Schreibweise, bedeuted diese Zeile zur Vorregistrierung. Die beiden Zeilen könnten die letzen zwei Zeilen des Codes von eben ersetzen:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Zu dem hier verwendeten Array lassen sich selbstverständlich beliebig viele weitere Einträge hinzufügen.
.
Hoffe, das hilft!
-cel
----
Addendum - There are now two blog posts on vb.com related to this topic:
http://www.vbulletin.com/forum/entry.php?2387-Pushing-your-variables-to-vBulletin-4-templates
http://www.vbulletin.com/forum/entry.php?2388-Using-custom-templates-within-your-own-vBulletin-4-based-files
Dies ist eine Übersetzung meines Artikels auf vb.org (http://www.vbulletin.org/forum/showthread.php?t=228078).
In vB4 werden Templates nicht länger durch eval() ausgegeben:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------ist veraltet.
Dazu kommt: Variablen und Arrays, die in Plugins definiert werden, die auf einer Seite ausgeführt werden, stehen nicht mehr automatisch in den Templates dieser Seite zur Verfügung. Sie müssen zunächst registriert werden.
.
Grundfunktion zum Rendern und Registrieren von Variablen/Arrays
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Die erste Zeile stellt das Template zur Verfügung, das gerendert (berechnet) werden soll, indem es die neue vB_Template-Klasse (vB_Template::create) verwendet. An die Methode wird der Name des Templates als Argument übergeben. Die beiden folgenden Zeilen registrieren eine Variable und ein Array, die im Template zur Verfügung stehen sollen. Als Argumente werden jeweils 1. der Name übergeben, unter dem die Variable im Template aufgerufen werden soll, sowie 2. die Variable, die übergeben werden soll. Man kann das beliebig oft wiederholen, also beliebig viele Variablen übergeben. Sinnvoll ist es aber, Daten ggf. besser in ein oder mehrere Arrays zu verpacken. Die vierte Zeile rendert (berechnet) letztendlich das Template ($templater->render()).
Im Template können die registrierten Variablen/Arrays nun wie folgt aufgerufen werden:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Hinweis zur letzten Zeile: Ja, multidimensionale Arrays sind kein Problem.
.
.
.
Was man mit den gerenderten Daten anstellen kann - was mache ich mit meinem gerendertenTemplate?
.
Template direkt ausgeben - für eigene Seiten
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Das gibt das Template unmittelbar aus. Damit kann man etwa das Template für eine eigene Seite ausgeben.
Besonders hinweisen möchte ich in diesem Zusammenhang auf die zweite Zeile des Beispieles:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Diese Zeile registriert automatisch einige Templates, die für die Seitendarstellung wichtig sind: header, footer und headinclude; diese drei Templates braucht man zur Darstellung einer "ordentlichen" vB-Seite.
.
Ausgabe über einen Template-Hook
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Dieses Template wird in den ausgewählten Template-Hook gespeichert und dort ausgegeben (Beispiel hier: $template_hook[forumhome_wgo_pos2]).
Der Punkt vor dem Gleichheitszeichen sorgt dafür, dass der Code nur an den Hook angehängt wird, statt ihn zu überschreiben. Das ist wichtig, weil auch andere Mods diesen Hook verwenden könnten. So bleibt erhalten, was sich evtl. schon dort befindet.
.
In eine Variable speichern und später in einem weiteren Template verwenden
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Dies speichert das gerenderte Template in eine Variale. Diese Variable wiederum können wir später für ein weiteres Template registrieren (wenn wir also das aktuelle Template in einem anderen Template aufrufen wollen):
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Wieder wäre der Aufruf in my_other_template:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Häufig wird das erste Template in einer Schleife berechnet, um eine Reihe serieller Daten auszugeben. Wenn das so ist, sollte auch hier .= statt nur = Anwendung finden - das hängt ganz von der jeweiligen Anwendung ab.
.
In ein Array speichern zur Verwendung in einem bereits existierenden Template von vBulletin
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Wenn man das gerenderte Template in einem bereits vorhandenen vB-Template verwenden will, hat man ein Problem: Wenn etwa FORUMHOME gerendert wird, haben wir darauf keinen Zugriff, um dort Variablen registrieren zu können. Es wird erstellt und berechnet innerhalp der php-Dateien, und die wollen wir - natürlich - nicht verändern.
Um das Problem, das während der Alpha-Testphase aufgetaucht ist, zu lösen, wurde eine neue Methode für die vB_Template-Klasse entwickelt: preRegister. Sie kann dazu verwendet werden, unsere Daten in den Registrierungsprozess einzuschleusen, bevor das Template gerendert wird. Achtung: erwartet wird ein Array, nicht eine einfache Variable als Argument ($templatevalues['my_insertvar']).
In der letzten Zeile wird das Array vorregistriert (preregister); dazu werden zwei Argumente übergeben: 2. der Name des existierenden Templates, und 2. das Array das die Daten enthält. Auch diese Prozedur kann man beliebig oft wiederholen. Allerdings sollte man dann eher die Arrayschreibweise verwenden (siehe unten).
Die vorregistrierte Variable wird im Template wie folgt aufgerufen:
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Nota bene: Nicht {vb:raw templatevalues.my_insertvar}!
Im Grunde genau das Gleiche wie oben, nur in einer anderen Schreibweise, bedeuted diese Zeile zur Vorregistrierung. Die beiden Zeilen könnten die letzen zwei Zeilen des Codes von eben ersetzen:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------Zu dem hier verwendeten Array lassen sich selbstverständlich beliebig viele weitere Einträge hinzufügen.
.
Hoffe, das hilft!
-cel
----
Addendum - There are now two blog posts on vb.com related to this topic:
http://www.vbulletin.com/forum/entry.php?2387-Pushing-your-variables-to-vBulletin-4-templates
http://www.vbulletin.com/forum/entry.php?2388-Using-custom-templates-within-your-own-vBulletin-4-based-files