Store fetch: Unterschied zwischen den Versionen
Neonix (Diskussion | Beiträge) |
|||
| Zeile 3: | Zeile 3: | ||
Das Attribut 'name' gibt dabei an, unter welchem Namen es gespeichert werden soll. Der Inhalt selbst wird an dieser Stelle nicht ausgegeben. | Das Attribut 'name' gibt dabei an, unter welchem Namen es gespeichert werden soll. Der Inhalt selbst wird an dieser Stelle nicht ausgegeben. | ||
Der folgende Code speichert '''Inhalt der Variable''' unter dem Namen 'VariablenName' für die Dauer des laufenden Quests: | Der folgende Code speichert '''Inhalt der Variable''' unter dem Namen 'VariablenName' für die Dauer des laufenden Quests: | ||
| − | <code xml> | + | <code xml n> |
| − | <store name="VariablenName" scope="quest"> | + | <store name="VariablenName" scope="quest">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 16: | Zeile 14: | ||
Die Variable wird nicht in der Datenbank zwischengespeichert. | Die Variable wird nicht in der Datenbank zwischengespeichert. | ||
Sie kann nur innerhalb derselben Scene verwendet werden. | Sie kann nur innerhalb derselben Scene verwendet werden. | ||
| − | <code xml> | + | <code xml n> |
| − | <store name="VariablenName" scope="scene"> | + | <store name="VariablenName" scope="scene">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 26: | Zeile 22: | ||
Sobald die Quest beendet wurde wird die Variable gelöscht. | Sobald die Quest beendet wurde wird die Variable gelöscht. | ||
Durch eine über den [[quest|Queststatus]] pending unterbrochene Quest werden Variablen mit dem Scope quest '''nicht''' gelöscht. | Durch eine über den [[quest|Queststatus]] pending unterbrochene Quest werden Variablen mit dem Scope quest '''nicht''' gelöscht. | ||
| − | <code xml> | + | <code xml n> |
| − | <store name="VariablenName" scope="quest"> | + | <store name="VariablenName" scope="quest">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 37: | Zeile 31: | ||
<code xml> | <code xml> | ||
| − | <store name="VariablenName" scope="dungeon"> | + | <store name="VariablenName" scope="dungeon">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 46: | Zeile 38: | ||
<code xml> | <code xml> | ||
| − | <store name="VariablenName" scope="hero"> | + | <store name="VariablenName" scope="hero">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 57: | Zeile 47: | ||
<code xml> | <code xml> | ||
| − | <store name="VariablenName" scope="global"> | + | <store name="VariablenName" scope="global">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
| Zeile 68: | Zeile 56: | ||
<code xml> | <code xml> | ||
| − | <store name="VariablenName" scope="global" expire="4d"> | + | <store name="VariablenName" scope="global" expire="4d">Inhalt der Variable</store> |
| − | |||
| − | </store> | ||
</code> | </code> | ||
Expire kann in zwei Formaten angegeben werden "4d" für vier Ingametage, "12h" für zwölf Ingamestunden. | Expire kann in zwei Formaten angegeben werden "4d" für vier Ingametage, "12h" für zwölf Ingamestunden. | ||
| − | |||
| Zeile 89: | Zeile 74: | ||
===Namenskonvention=== | ===Namenskonvention=== | ||
| − | Die Variablen können zwar technisch frei benannt werden, | + | Die Variablen können zwar technisch frei benannt werden, aber bei scope="hero"-Variablen ist zwingend auf einen aussagekräftigen und eindeutigen Namen zu achten. Dazu wird zunächst der Questname (+ggf. Autor) und danach die Variablenkennung angegeben, z.B. |
| − | + | <code xml n> | |
| − | + | <store name="SchiffBlutrabe-Tagesablauf" scope="hero">Schlaf</store> | |
| − | + | </code> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | Diese Konvention soll sicherstellen das einzelne Variablen sich nicht gegenseitig überschreiben | + | Diese Konvention soll sicherstellen das einzelne Variablen sich nicht gegenseitig überschreiben. |
===fetch=== | ===fetch=== | ||
Das '''<fetch>'''-Tag ruft derart gespeicherte Inhalte wieder ab. | Das '''<fetch>'''-Tag ruft derart gespeicherte Inhalte wieder ab. | ||
| − | Das Attribut 'name' dient hier zum | + | Das Attribut 'name' dient hier zum Identifizieren der richtigen Variable. |
Sollte kein Inhalt unter diesem Namen gespeichert sein, und nur dann, wird der Inhalt des fetch-Tags ausgewertet, sozusagen als Default. | Sollte kein Inhalt unter diesem Namen gespeichert sein, und nur dann, wird der Inhalt des fetch-Tags ausgewertet, sozusagen als Default. | ||
| − | Dies ist einer der Hauptunterschiede zum get-Tag. | + | Dies ist einer der Hauptunterschiede zum [[get]]-Tag. Bei [[get]] wird kein Default-Inhalt ausgewertet. |
| − | Folgendes | + | Folgendes bewirkt zum Beispiel die Ausgabe der Variable "papagei_name". |
<code xml> | <code xml> | ||
| − | <fetch name=" | + | <p><q>Hallo <fetch name="papagei_name"/>!</q></p> |
</code> | </code> | ||
Version vom 8. Januar 2011, 14:47 Uhr
Inhaltsverzeichnis
Store
Das <store>-Tag speichert seinen (ausgewerteten) Inhalt persistent, z.B. zwischen verschiedenen Schritten eines Quests. Das Attribut 'name' gibt dabei an, unter welchem Namen es gespeichert werden soll. Der Inhalt selbst wird an dieser Stelle nicht ausgegeben. Der folgende Code speichert Inhalt der Variable unter dem Namen 'VariablenName' für die Dauer des laufenden Quests:
<store name="VariablenName" scope="quest">Inhalt der Variable</store>
Scopes/Geltungsbereiche
Den Bereich und die Art wie eine Variable gespeichert wird kann man über das Attribut scope festlegen. Im Moment gibt es hierbei fünf verschiedene Möglichkeiten.
scene
Die Variable wird nicht in der Datenbank zwischengespeichert. Sie kann nur innerhalb derselben Scene verwendet werden.
<store name="VariablenName" scope="scene">Inhalt der Variable</store>
quest
Die Variable wird innerhalb dieser Quest gespeichert. Sobald die Quest beendet wurde wird die Variable gelöscht. Durch eine über den Queststatus pending unterbrochene Quest werden Variablen mit dem Scope quest nicht gelöscht.
<store name="VariablenName" scope="quest">Inhalt der Variable</store>
dungeon
Die Variable ist für alle Helden die diese Quest erleben zugreifbar. Die Variable bleibt erhalten auch wenn ein Held die Quest schon beendet hat, bezieht sich aber im Gegensatz zum Scope 'hero' auf die Quest und nicht auf den sie absolvierenden Helden.
<store name="VariablenName" scope="dungeon">Inhalt der Variable</store>
hero
Die Variable wird an den Helden gebunden, solange dieser existiert, kann auf sie zugegriffen werden.
<store name="VariablenName" scope="hero">Inhalt der Variable</store>
global
Die Variable wird unabhängig von Questen und Helden gespeichert. Sie wird nur manuell von Hand gelöscht. Siehe hier.
<store name="VariablenName" scope="global">Inhalt der Variable</store>
expire
Über das Attribut expire kann der Zeitraum angegeben werden in welchem diese (unabhängig vom scope) Gespeichert wird. Folgendes definiert eine Variable die nach 4 Ingame-Tagen wieder gelöscht wird.
<store name="VariablenName" scope="global" expire="4d">Inhalt der Variable</store>
Expire kann in zwei Formaten angegeben werden "4d" für vier Ingametage, "12h" für zwölf Ingamestunden.
Variablen Löschen
Variablen können mittels
<store name="meineVar">NULL</store>
oder
<store name="meineVar"/>
gelöscht werden.
Namenskonvention
Die Variablen können zwar technisch frei benannt werden, aber bei scope="hero"-Variablen ist zwingend auf einen aussagekräftigen und eindeutigen Namen zu achten. Dazu wird zunächst der Questname (+ggf. Autor) und danach die Variablenkennung angegeben, z.B.
<store name="SchiffBlutrabe-Tagesablauf" scope="hero">Schlaf</store>
Diese Konvention soll sicherstellen das einzelne Variablen sich nicht gegenseitig überschreiben.
fetch
Das <fetch>-Tag ruft derart gespeicherte Inhalte wieder ab. Das Attribut 'name' dient hier zum Identifizieren der richtigen Variable. Sollte kein Inhalt unter diesem Namen gespeichert sein, und nur dann, wird der Inhalt des fetch-Tags ausgewertet, sozusagen als Default. Dies ist einer der Hauptunterschiede zum get-Tag. Bei get wird kein Default-Inhalt ausgewertet.
Folgendes bewirkt zum Beispiel die Ausgabe der Variable "papagei_name".
<p><q>Hallo <fetch name="papagei_name"/>!</q></p>
