Projekt:Schaffenbot: Unterschied zwischen den Versionen

keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 124: Zeile 124:
  crontab -e
  crontab -e
  * * * * * php /var/www/telegrambot-webroot/cron.php
  * * * * * php /var/www/telegrambot-webroot/cron.php
=Schaffenburg Data Tracking=
Es gibt eine Möglichkeit Daten aller Art zu loggen.<br />
Der Schaffenburg-Telegram-Bot kann auf diese Daten zugreifen und sie der Allgemeinheit zur Verfügung stellen.<br />
Aktuell sind folgende Daten in das Data-Tracking eingebunden:<br />
* Status der Räumlichkeiten von Schaffenburg e.V. (Offen, Geschlossen)
* Temperatur in den Räumlichkeiten von Schaffenburg e.V.
* Mülleimerstatus (Regelmäßiges leeren der Mülleimer)
* Anwesenheits-Summary (Personen können freiwillig angeben, ob sie in den Räumlichkeiten sind/sein werden)
==Daten loggen==
Über die folgende URL können Daten ins Logging aufgenommen werden:<br />
http://codeblatz.ddns.net/soap.php?token=<secret token>&tag=<string>&value=<string> <br />
Erklärung:<br />
* token: Damit nicht jeder einfach Daten loggen kann, muss ein valider Token in der URL mitgegeben werden.<br />Ein neuer Token kein beim Benutzer [[Benutzer:VinRisen360|Paul Freudenberger]] angefordert werden.
* tag: Ein Search-Tag, der mit den Infos hinterlegt wird.<br />Es sollte ein einzelnes Wort sein, dass beschreibend für den Wert ist. (Beispiel: temperature)
* value: Der eigentliche Wert, den man loggen möchte.<br />Hier kann eigentlich alles mitgegeben werden.
==Daten auslesen==
Über die folgende URL können die Daten wieder ausgelesen werden:<br />
http://codeblatz.ddns.net/soap.php?token=<secret token>[&tag=<string>][&limit=100] <br />
Erklärung:<br />
* token: Damit nicht jeder einfach Daten auslesen kann, muss ein valider Token in der URL mitgegeben werden.<br />Ein neuer Token kein beim Benutzer [[Benutzer:VinRisen360|Paul Freudenberger]] angefordert werden.
* tag: OPTIONAL: Filtert die LOG-Ausgabe auf Werte mit dem angegebenen Search-Tag.<br />Wenn kein tag angegeben wird, werden alle Datensätze aus dem Log ausgegeben.
* limit: OPTIONAL: Die Anzahl der Datensätze bei der Ausgabe festlegen.<br />Wenn kein limit angegeben wird, wird nur der neuste Datensatz ausgegeben
AUSGABEFORMAT:<br />
Die Daten werden in Form eines JSON-Files ausgegeben.<br />
Beispiel:<br />
{"time":"22.10.2017 00:00:01","spacetemperature":20.5,"metric":"C (degree Celsius)"}<br />


=Nett-to-know=
=Nett-to-know=
Zeile 145: Zeile 175:
http://api.openweathermap.org/data/2.5/weather?q=Berlin&units=metric&APPID=z825bl24x5xx1p44w9i6c3g1g22ve299
http://api.openweathermap.org/data/2.5/weather?q=Berlin&units=metric&APPID=z825bl24x5xx1p44w9i6c3g1g22ve299


* Die meisten Commands haben in ihren Klassen "extends UserCommand" stehen. Dies bedeutet jeder Nutzer kann diesen Command triggern <br />
* Die meisten Commands haben in ihren Klassen "extends UserCommand" stehen. Dies bedeutet jeder Nutzer kann diesen Command triggern
* Manche Commands haben in ihren Klassen "extends AdminCommand" stehen. Dies bedeutet, nur Nutzer deren ID unter /[webroot]/hook.php im Array $admin_users = []; gelistet sind können diesen Command triggern <br />
* Manche Commands haben in ihren Klassen "extends AdminCommand" stehen.Dies bedeutet, nur Nutzer deren ID unter /[webroot]/hook.php im Array $admin_users = []; gelistet sind können diesen Command triggern <br />
* Manche Commands haben in ihren Klassen "extends SystemCommand" stehen. Dies bedeutet der Command wird nicht unter /help aufgelistet, es gibt ihn aber <br />
* Manche Commands haben in ihren Klassen "extends SystemCommand" stehen. Dies bedeutet der Command wird nicht unter /help aufgelistet, es gibt ihn aber <br />


mitglieder, Administratoren
292

Bearbeitungen