HeizölPreise — ReadMe

ÜBERSICHT   —   FREISCHALTUNG  —   SCREENSHOTS

 

  1. Funk­tion­sum­fang
  2. Sys­te­man­forderun­gen
  3. Instal­la­tion
  4. Befehlsref­erenz

 

1. Funktionsumfang

Dieses Mod­ul liest zyk­lisch die aktuellen Heizöl­preise aus, spe­ichert den gün­stig­sten Preis
in ein­er Vari­able (zum Ver­fol­gen der Preisen­twick­lung — Log­ging auf Wun­sch manuell aktivieren), gibt die
Infor­ma­tio­nen in ein­er HTML-Tabelle aus und liefert ein Array mit den auf­bere­it­eten Dat­en zurück.

Einstellungsmöglichkeiten in der Instanz:

  • Postleitzahl (Liefer­ort)
  • Abnah­memenge (min. 500 Liter)
  • Zahlungsart (bar, EC-Karte, Vorkasse, Lastschrift, Wärmekon­to, Rechnung)
  • Tankwa­gen (klein/groß)
  • Abladestellen (Anzahl)
  • Schlauch­länge (egal, 60m, 80m)
  • Heizöl­sorte (nor­mal Schwe­fe­larm, pre­mi­um Schwefelarm)
  • Expressliefer­ung (nein/ja)
  • UpdateIn­ter­vall (in Sekunden)
  • Farbe Hin­ter­grund (HEX-Far­b­code)
  • Farbe Text (HEX-Far­b­code)
  • Schrift­größe Text
  • Fir­men­l­o­go Anzeige (nein/ja)

 

2. Systemanforderungen

  • IP-Sym­con ab Ver­sion 4.x

 

3. Installation

Über die Kern-Instanz "Mod­ule Con­trol" fol­gende URL hinzufügen:

https://GITLAB-BENUTZERNAME:GITLAB-PASSWORT@gitlab.com/BY-IPS-Module/HeizoelPreise.git
Die neue Instanz find­et ihr dort, wo ihr sie angelegt habt.

 

4. Befehlsreferenz

$result = HOELP_Update($InstanzID);
Aktu­al­isiert die Heizoel­Preis-Tabelle und die Vari­able mit dem gün­stig­sten Preis (je 100L) und gibt die Dat­en in einem Array zurück.
Wur­den keine Preise mit den eingegebe­nen Suche­in­stel­lun­gen gefun­den, wird "false" zurück­gegeben und im Mel­dun­gen-Fen­ster kommt ein
entsprechen­der Hinweis.

$result = HOELP_Preisabfrage($InstanzID, inte­ger $Abnah­memenge);
Mit dieser Funk­tion kann eine extra Preis­abfrage für eine bes­timmte Abnah­memenge durchge­führt wer­den. Die sonstigen
Ein­stel­lun­gen wer­den von der Mod­ul-Instanz über­nom­men. Min­d­est Abnah­memenge sind auch hier 500 Liter.
Hat man den Inhalt seines Heizöl­tanks im IP-Sym­con (z.B. Lev­el­Jet), dann kann man über diese Funk­tion immer den
aktuellen Preis, zum Auf­füllen seines Tanks, ermitteln.