Hilfe:MarktHalle: Unterschied zwischen den Versionen

Aus SchnuppTrupp
Wechseln zu: Navigation, Suche
K (→‎Beschreibung)
K (→‎Liste der Standardfunktionen)
 
(23 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Beschreibung==
 
==Beschreibung==
−
Der MarktHallen Tag ermöglicht es Daten aus der Markthalle anzuzeigen. Die Daten aus der offiziellen [http://services.runescape.com/m=itemdb_rs/l=1/frontpage.ws Runescape Markthalle] werden in einer internen Datenbank einmal alle 24 Stunden synchronisiert. Der einfachste und vermutlich häufigste Anwendungsfall ist den aktuellen Preis anzuzeigen. Hierfür benötigt ihr nur die ''offizielle Nummer'' (ID) des entsprechenden Gegenstands.
+
Der MarktHallen 'Parser-Tag' ermöglicht es Daten aus der Markthalle anzuzeigen. Die Daten aus der offiziellen [http://services.runescape.com/m=itemdb_rs/l=1/frontpage.ws Runescape Markthalle] werden in einer internen Datenbank einmal alle 24 Stunden synchronisiert. Der einfachste und vermutlich häufigste Anwendungsfall ist den aktuellen Preis anzuzeigen. Hierfür benötigt ihr nur die ''offizielle Nummer'' (ID) des entsprechenden Gegenstands.
−
Dieser muss mit dem Parameter ''id='' angegeben werden.
+
Diese ID muss als erster Parameter angegeben werden.
−
Um also z.B. den aktuellen Preis für eine '''Kanonenkugel''' anzuzeigen müsst ihr folgenden Tag in eurer Seite verwenden.
+
Um also z.B. den aktuellen Preis für eine '''Kanonenkugel''' anzuzeigen müsst ihr folgenden 'Parser-Tag' in eurer Seite verwenden.
  
 
<pre>
 
<pre>
−
<mh id="2" />
+
{{#mh:2}}
 
</pre>
 
</pre>
 +
Ausgabe: {{#mh:2}}
  
−
Die '''id''' ist hierbei die ''offizielle'' Nummer des entsprechenden Gegenstands
+
Die '''2''' ist in diesem Beispiel die ''offizielle Nummer'' des Gegenstands ''Kanonenkugel''
 +
 
 +
Sobald ein Gegenstand in der Datenbank vorhanden ist kann dieser auch mit seinem Namen referenziert werden.
 +
 
 +
<pre>
 +
{{#mh:Kanonenkugel}}
 +
</pre>
 +
Ausgabe: {{#mh:Kanonenkugel}}
  
 
== Funktionen ==
 
== Funktionen ==
  
−
Der MarktHallen Tag erlaubt es auf viele verschiedene Daten zuzugreifen und diese anzuzeigen. Wenn ihr eine bestimmte Funktion benutzen wollt müsst ihr diese im Tag mit Parameter ''function='' angeben.
+
Der MarktHallen 'Parser-Tag' erlaubt es auf viele verschiedene Daten zuzugreifen und diese anzuzeigen. Wenn ihr eine bestimmte Funktion benutzen wollt müsst ihr diese im 'Parser-Tag' als zweiten Parameter angeben.
  
 
<pre>
 
<pre>
−
<mh id="2" function="name"/>
+
{{#mh:2|name}}
 
</pre>
 
</pre>
 +
Ausgabe: {{#mh:2|name}}
  
 
=== Liste der Standardfunktionen ===
 
=== Liste der Standardfunktionen ===
Zeile 24: Zeile 33:
 
!scope="col" class="unsortable"|Beschreibung
 
!scope="col" class="unsortable"|Beschreibung
 
|-
 
|-
−
|aktuell||Gibt den aktuellen Preis des Gegenstands aus. Wenn keine Funktion angegeben ist, wird automatisch diese Funktion verwendet.
+
|''leer''||Wenn keine Funktion angegeben ist, wird der aktuelle Preis (jedoch unformatiert) ausgegeben. Das ist wichtig um damit Berechnungen durchführen zu können. (Mehr dazu [[Help:MarktHalle#Komplexe Berechnungen|hier]]).
 
|-
 
|-
−
|vortag||Gibt den Preis des Vortags aus.
+
|aktuell ''oder'' a||Gibt den aktuellen Preis des Gegenstands formatiert aus. z.B. 99, 1.002, 10,2T, 13,5M, 1,2Md
 
|-
 
|-
−
|diff||Gibt die Preisdifferenz von Gestern auf Heute aus. (mit Vorzeichen)
+
|''<zahl>''||Wenn als Funktion eine Zahl angegeben ist, wird der aktuelle Preis mit ''<zahl>'' multipliziert. Somit kann man den Preis von ''<zahl>'' Stücken des Gegenstands ausrechnen. z.B. Würde <nowiki>{{#mh:2|1000}}</nowiki> den formatierten Preis für 1000 Kanonenkugeln ausgeben
 +
|-
 +
|vortag ''oder'' v||Gibt den formatierten Preis des Vortags aus.
 +
|-
 +
|diff ''oder'' d||Gibt die formatierte Preisdifferenz von Gestern auf Heute aus. (mit Vorzeichen)
 
|-
 
|-
 
|id||Gibt die offizielle ID des Gegenstands aus.
 
|id||Gibt die offizielle ID des Gegenstands aus.
 
|-
 
|-
−
|name||Gibt den Namen des Gegenstands aus.
+
|name ''oder'' n||Gibt den Namen des Gegenstands aus.
 
|-
 
|-
−
|beschreibung||Gib den Text aus den man erhält wenn man den Gegenstand untersucht.
+
|beschreibung ''oder'' b||Gib den Text aus den man erhält wenn man den Gegenstand untersucht.
 
|-
 
|-
−
|seit||Gibt das Datum aus, seitdem der Gegenstand in der internen Datenbank vorhanden ist.
+
|member ''oder'' m||Gibt den Text '''Ja''' aus wenn es sich im einen Gegenstand für Mitglieder handelt, ansonsten wird der Text '''Nein''' ausgegeben.
 
|-
 
|-
−
|datum||Gebt den Preis an einem bestimmten Datum aus. Erfordert zusätzlich den Parameter ''datum=''. '''Achtung''' das Datum muss im englischen Format angeben werden z.B.: ''datum="2011-03-01"'' (entspricht 01.03.2011)
+
|seit ''oder'' s||Gibt das Datum aus, seitdem der Gegenstand in der internen Datenbank vorhanden ist.
 +
|-
 +
|tag ''oder'' t||Gibt den Preis an einem bestimmten Tag aus. Erfordert zusätzlich einen 3. Parameter welcher das Datum für diesen Tag enthält. '''Achtung''' das Datum muss im englischen Format angeben werden z.B.: <nowiki>{{#mh:2|tag|2011-03-01}}</nowiki> (entspricht 01.03.2011)
 +
|-
 +
|laden ''oder'' l||Gibt den Ladenpreis bzw. den Wert für niedrige Alchemie aus.
 +
|-
 +
|hohe ''oder'' h||Gibt den Wert für hohe Alchemie aus.
 
|-
 
|-
 
|min||Der kleinste Preis seit der Gegenstand in der internen Datenbank geführt wird.
 
|min||Der kleinste Preis seit der Gegenstand in der internen Datenbank geführt wird.
Zeile 46: Zeile 65:
 
|mittel||Der Durchschnittspreis seit der Gegenstand in der internen Datenbank geführt wird.
 
|mittel||Der Durchschnittspreis seit der Gegenstand in der internen Datenbank geführt wird.
 
|-
 
|-
−
|min_datum||Das Datum an dem der kleinste Preis notiert wurde.
+
|min_datum ''oder'' min_d||Das Datum an dem der kleinste Preis notiert wurde.
 
|-
 
|-
−
|max_datum||Das Datum an dem der höchste Preis notiert wurde.
+
|max_datum ''oder'' max_d||Das Datum an dem der höchste Preis notiert wurde.
 
|}
 
|}
  
−
=== Liste der Statistik Funktionen ===
+
=== Liste der Statistikfunktionen ===
  
−
Statistiken werden für folgende Zeiträume erstellt 7,14,30,90,180 und 360 Tage um auf den entsprechenden Zeitraum zuzugreifen müsst ihr die Zahl vor der entsprechenden Funktion notieren. z.B. Maximalpreis der letzten 90 Tage -> ''90_max''
+
Statistiken werden für folgende Zeiträume erstellt 7,14,30,90,180,360 und 720 Tage um auf den entsprechenden Zeitraum zuzugreifen müsst ihr die Zahl vor der entsprechenden Funktion notieren. z.B. Maximalpreis der letzten 90 Tage -> ''90_max''
  
 
{| class="wikitable sortable" border="1" width="80%"
 
{| class="wikitable sortable" border="1" width="80%"
Zeile 68: Zeile 87:
 
|-
 
|-
 
|_max_datum||Datum an welchem der Maximalpreis im angegebenen Zeitraum notiert wurde.
 
|_max_datum||Datum an welchem der Maximalpreis im angegebenen Zeitraum notiert wurde.
−
|-
 
−
|_graph||Eine Grafik welche den Preisverlauf im angegebenen Zeitraum anzeigt.
 
 
|}
 
|}
 +
 +
zusätzlich gibt es noch die Möglichkeit eine Grafik auszugeben. Dieses funktioniert jedoch nur mit folgendem 'Tag'
 +
 +
<pre>
 +
<mh id="2" function="7_graph" />
 +
</pre>
 +
Ausgabe:<br /><mh id="2" function="7_graph" />
 +
 +
Die '''7''' von '''7_graph''' bezieht sich auf den Zeitraum und kann ersetzt werden durch (7, 14, 30, 90, 180, 360 oder 720).<br />
 +
Die '''id''' ist die ''offizielle Nummer'' des Gegenstands.
  
 
== Gegenstand ID herausfinden ==
 
== Gegenstand ID herausfinden ==
Zeile 80: Zeile 107:
 
Für euch ist nur der letzte Teil interessant '''obj=948'''. Das bedeutet die offizielle Nummer für diesen Gegenstand ist '''948'''
 
Für euch ist nur der letzte Teil interessant '''obj=948'''. Das bedeutet die offizielle Nummer für diesen Gegenstand ist '''948'''
  
−
== Alternativen für die Gegenstand ID ==
+
== Gegenstand hinzufügen ==
  
−
Wenn ihr die Gegenstand ID nicht habt, und nicht danach suchen wollt, könnt ihr auch den Namen des Gegenstands angeben. Hier ist jedoch Vorsicht geboten, denn es gibt auch Gegenstände welche den gleichen Namen haben aber unterschiedliche IDs und somit unterschiedliche Preise. Dieses ist z.B. häufig der Fall bei unterschiedlichen Farben. Um den Gegenstand mit Namen auszuwählen gebt ihr statt ''id='' den Parameter ''name='' an. '''Die ID sollte immer vorgezogen werden wenn irgendwie möglich.'''
+
Gegenstände welche noch nicht in der internen Datenbank vorhanden sind werden automatisch hinzugefügt. Wenn der Gegenstand neu hinzugefügt wird, erhaltet ihr bei der ersten Vorschau oder laden der Seite folgende Meldung.
  
 
<pre>
 
<pre>
−
<mh name="Kanonenkugel" />
+
Gegenstand zur Datenbank hinzugefügt. Daten stehen erstmals nach 24h zur Verfügung.
 
</pre>
 
</pre>
  
−
Ermittelt anschließend die richtige ID mit der ''function="id"'' und tauscht anschließend den Namen durch die ID aus.
+
Bei allen weiteren aufrufen erhaltet ihr dann in den ersten 24 Stunden keine gültigen Angaben, da die Datenbank nur einmal Täglich mit der [http://services.runescape.com/m=itemdb_rs/l=1/frontpage.ws Runescape Markthalle] synchronisiert wird.
  
−
#Schritt
+
Sollte die ID falsch sein oder die Markthalle gerade nicht verfügbar sein erhaltet ihr folgende Meldung.
−
#:<pre><mh name="Kanonenkugel" function="id"/></pre>
+
−
#:Angezeigter Text:<pre>2</pre>
+
−
#Schritt
+
−
#:<pre><mh id="2" /></pre>
+
  
−
== Gegenstand hinzufügen ==
+
<pre>
 +
Gegenstand nicht auf Runescape gefunden oder Runescape gerade nicht erreichbar.
 +
</pre>
  
−
Gegenstände welche noch nicht in der internen Datenbank vorhanden sind werden automatisch hinzugefügt. Dies ist jedoch nur möglich wenn der Gegenstand mit ID angegeben wurde, da nur dann eine fehlerfreie Identifikation des Gegenstands möglich ist. Wenn der Gegenstand neu hinzugefügt wird, erhaltet ihr bei der ersten Vorschau oder laden der Seite folgende Meldung.
+
Kontrolliert in diesem Fall die ID und versucht es einfach zu einem späteren Zeitpunkt nochmal.
 +
 
 +
== Komplexe Berechnungen ==
 +
 
 +
In manchen Fällen reicht es leider nicht aus nur den Preis (oder ein vielfaches) anzuzeigen. z.B. möchte man gerne anzeigen wie viel 100 Kampfstäbe und 100 Luft-Kugeln zusammen kosten. Um das möglich zu machen benutzt den 'Parser-Tag' ''#expr:'' welche Rechenaufgaben durchführt.
  
 
<pre>
 
<pre>
−
Gegenstand zur Datenbank hinzugefügt. Daten stehen erstmals nach 24h zur Verfügung.
+
{{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }}
 
</pre>
 
</pre>
 +
Ausgabe: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }}
  
−
Bei allen weiteren aufrufen erhaltet ihr dann in den ersten 24 Stunden keine gültigen Angaben, da die Datenbank nur einmal Täglich mit der [http://services.runescape.com/m=itemdb_rs/l=1/frontpage.ws Runescape Markthalle] synchronisiert wird.
 
  
−
Sollte die ID falsch sein oder die Markthalle gerade nicht verfügbar sein erhaltet ihr folgende Meldung.
+
um das Ergebnis noch formatiert auszugeben bettet den 'Parser-Tag' ''#expr:'' noch in den 'Parser-Tag' ''#pp:'' ein.
  
 
<pre>
 
<pre>
−
Gegenstand nicht auf Runescape gefunden oder Runescape gerade nicht erreichbar.
+
{{#pp: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}
 
</pre>
 
</pre>
 +
Ausgabe: {{#pp: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}
  
−
Kontrolliert in diesem Fall die ID und versucht es einfach zu einem späteren Zeitpunkt nochmal.
+
um das Ergebnis mit allen Stellen und Tausenderpunkten auzugeben könnt ihr den Tag ''#pl:'' verwenden
 +
 
 +
<pre>
 +
{{#pl: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}
 +
</pre>
 +
Ausgabe: {{#pl: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}
 +
 
 +
 
 +
 
 +
 
 +
----
 +
[[Kategorie:Hilfe]]

Aktuelle Version vom 27. Januar 2017, 18:50 Uhr

Beschreibung

Der MarktHallen 'Parser-Tag' ermöglicht es Daten aus der Markthalle anzuzeigen. Die Daten aus der offiziellen Runescape Markthalle werden in einer internen Datenbank einmal alle 24 Stunden synchronisiert. Der einfachste und vermutlich häufigste Anwendungsfall ist den aktuellen Preis anzuzeigen. Hierfür benötigt ihr nur die offizielle Nummer (ID) des entsprechenden Gegenstands. Diese ID muss als erster Parameter angegeben werden. Um also z.B. den aktuellen Preis für eine Kanonenkugel anzuzeigen müsst ihr folgenden 'Parser-Tag' in eurer Seite verwenden. 

{{#mh:2}}

Ausgabe: 899

Die 2 ist in diesem Beispiel die offizielle Nummer des Gegenstands Kanonenkugel

Sobald ein Gegenstand in der Datenbank vorhanden ist kann dieser auch mit seinem Namen referenziert werden. 

{{#mh:Kanonenkugel}}

Ausgabe: 899

Funktionen

Der MarktHallen 'Parser-Tag' erlaubt es auf viele verschiedene Daten zuzugreifen und diese anzuzeigen. Wenn ihr eine bestimmte Funktion benutzen wollt müsst ihr diese im 'Parser-Tag' als zweiten Parameter angeben. 

{{#mh:2|name}}

Ausgabe: Kanonenkugel

Liste der Standardfunktionen

Funktionsname Beschreibung
leer Wenn keine Funktion angegeben ist, wird der aktuelle Preis (jedoch unformatiert) ausgegeben. Das ist wichtig um damit Berechnungen durchführen zu können. (Mehr dazu hier).
aktuell oder a Gibt den aktuellen Preis des Gegenstands formatiert aus. z.B. 99, 1.002, 10,2T, 13,5M, 1,2Md
<zahl> Wenn als Funktion eine Zahl angegeben ist, wird der aktuelle Preis mit <zahl> multipliziert. Somit kann man den Preis von <zahl> Stücken des Gegenstands ausrechnen. z.B. Würde {{#mh:2|1000}} den formatierten Preis für 1000 Kanonenkugeln ausgeben
vortag oder v Gibt den formatierten Preis des Vortags aus.
diff oder d Gibt die formatierte Preisdifferenz von Gestern auf Heute aus. (mit Vorzeichen)
id Gibt die offizielle ID des Gegenstands aus.
name oder n Gibt den Namen des Gegenstands aus.
beschreibung oder b Gib den Text aus den man erhält wenn man den Gegenstand untersucht.
member oder m Gibt den Text Ja aus wenn es sich im einen Gegenstand für Mitglieder handelt, ansonsten wird der Text Nein ausgegeben.
seit oder s Gibt das Datum aus, seitdem der Gegenstand in der internen Datenbank vorhanden ist.
tag oder t Gibt den Preis an einem bestimmten Tag aus. Erfordert zusätzlich einen 3. Parameter welcher das Datum für diesen Tag enthält. Achtung das Datum muss im englischen Format angeben werden z.B.: {{#mh:2|tag|2011-03-01}} (entspricht 01.03.2011)
laden oder l Gibt den Ladenpreis bzw. den Wert für niedrige Alchemie aus.
hohe oder h Gibt den Wert für hohe Alchemie aus.
min Der kleinste Preis seit der Gegenstand in der internen Datenbank geführt wird.
max Der höchste Preis seit der Gegenstand in der internen Datenbank geführt wird.
mittel Der Durchschnittspreis seit der Gegenstand in der internen Datenbank geführt wird.
min_datum oder min_d Das Datum an dem der kleinste Preis notiert wurde.
max_datum oder max_d Das Datum an dem der höchste Preis notiert wurde.

Liste der Statistikfunktionen

Statistiken werden für folgende Zeiträume erstellt 7,14,30,90,180,360 und 720 Tage um auf den entsprechenden Zeitraum zuzugreifen müsst ihr die Zahl vor der entsprechenden Funktion notieren. z.B. Maximalpreis der letzten 90 Tage -> 90_max

Funktionsname Beschreibung
_min Minimalpreis im angegebenen Zeitraum
_max Maximalpreis im angegebenen Zeitraum
_mittel Durchschnittspreis im angegebenen Zeitraum
_min_datum Datum an welchem der Minimalpreis im angegebenen Zeitraum notiert wurde.
_max_datum Datum an welchem der Maximalpreis im angegebenen Zeitraum notiert wurde.

zusätzlich gibt es noch die Möglichkeit eine Grafik auszugeben. Dieses funktioniert jedoch nur mit folgendem 'Tag' 

<mh id="2" function="7_graph" />

Ausgabe:

Die 7 von 7_graph bezieht sich auf den Zeitraum und kann ersetzt werden durch (7, 14, 30, 90, 180, 360 oder 720).
Die id ist die offizielle Nummer des Gegenstands.

Gegenstand ID herausfinden

Sucht am besten nach dem gewünschten Gegenstand in der Runescape Markthalle. Wenn ihr auf der Seite zu dem Gegenstand seit, seht euch die URL im Browser an. Für den Gegenstand Bärenfell sieht diese so aus.

http://services.runescape.com/m=itemdb_rs/l=1/Barenfell/viewitem.ws?obj=948

Für euch ist nur der letzte Teil interessant obj=948. Das bedeutet die offizielle Nummer für diesen Gegenstand ist 948

Gegenstand hinzufügen

Gegenstände welche noch nicht in der internen Datenbank vorhanden sind werden automatisch hinzugefügt. Wenn der Gegenstand neu hinzugefügt wird, erhaltet ihr bei der ersten Vorschau oder laden der Seite folgende Meldung. 

Gegenstand zur Datenbank hinzugefügt. Daten stehen erstmals nach 24h zur Verfügung.

Bei allen weiteren aufrufen erhaltet ihr dann in den ersten 24 Stunden keine gültigen Angaben, da die Datenbank nur einmal Täglich mit der Runescape Markthalle synchronisiert wird.

Sollte die ID falsch sein oder die Markthalle gerade nicht verfügbar sein erhaltet ihr folgende Meldung. 

Gegenstand nicht auf Runescape gefunden oder Runescape gerade nicht erreichbar.

Kontrolliert in diesem Fall die ID und versucht es einfach zu einem späteren Zeitpunkt nochmal.

Komplexe Berechnungen

In manchen Fällen reicht es leider nicht aus nur den Preis (oder ein vielfaches) anzuzeigen. z.B. möchte man gerne anzeigen wie viel 100 Kampfstäbe und 100 Luft-Kugeln zusammen kosten. Um das möglich zu machen benutzt den 'Parser-Tag' #expr: welche Rechenaufgaben durchführt. 

{{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }}

Ausgabe: 530200


um das Ergebnis noch formatiert auszugeben bettet den 'Parser-Tag' #expr: noch in den 'Parser-Tag' #pp: ein. 

{{#pp: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}

Ausgabe: 530,2T

um das Ergebnis mit allen Stellen und Tausenderpunkten auzugeben könnt ihr den Tag #pl: verwenden 

{{#pl: {{#expr: ( {{#mh:1391}} + {{#mh:573}} ) * 100 }} }}

Ausgabe: 530.200



Von „http://www.schnupptrupp.org/w/index.php?title=Hilfe:MarktHalle&oldid=129451“