P-TAGS Getting started

Konfiguration

Damit die P-TAGS verwendet werden können, muss im HTML innerhalb von den <head>-Tags folgender Code hinzugefügt werden. Die Einbindung der Skripte bei einer WordPress-Seite ist hier dokumentiert.

<head>

    <script type="module" src="https://unpkg.com/p-tag_v1@latest/dist/p-tags/p-tags.esm.js"></script>
    <script nomodule="" src="https://unpkg.com/p-tag_v1@latest/dist/p-tags/p-tags.js"></script>
    
</head>

Hinweis:
Bei gewissen Einstellungen funktioniert die Einbindung der Skripts nicht. Dann müssen diese hier heruntergeladen werden und anschliessend der Ordner “dist” auf den Server geladen werden. Anschliessend kann bei der Einbindung der Skripte der Pfad entsprechend angepasst werden.

Liste vorhandener P-Tags

Die p-tags können wie normale HTML-Tags verwendet werden. Bei manchen Tags ist zusätzlich ein spezifisches Attribut notwendig. In der Tabelle ist eine Übersicht über die aktuell verfügbaren Tags ersichtlich. Nachfolgend werden die einzelnen Tags genauer erläutert.

Name Beschreibung Rückgabewert Notwendige Attribute Beispiel
pt-counter-diff Aktuelle Anzahl Personen in der Anlage Integer eui (DeviceID) <pt-counter-diff eui="DeviceID"></pt-counter-diff>
pt-counter-last-update Zeitpunkt letzte Aktualisierung String eui (DeviceID) <pt-counter-last-update eui="DeviceID"></pt-counter-last-update>

pt-counter-diff

Der pt-counter-diff Tag gibt die aktuelle Anzahl Personen zurück, die sich ein einer Anlage oder in einem Raum befinden. Das System berechnet die Summe automatisch. Der Tag verlangt zwingend nach dem “eui”-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert (DeviceID) für das Attribut “eui” mitgelifert. Die Verwendung des Tags funktioniert wie folgt:
<pt-counter-diff eui="DeviceID"></pt-counter-diff>

Hinweis:
Ersetzten Sie den Attributwert vom Attribut “eui” mit dem bei der Lieferung erhaltenen Wert

pt-counter-last-update

Der pt-counter-last-update Tag gibt das Datum und die Zeit der letzten Aktualisierung der Daten zurück. Der Tag verlangt zwingend nach dem “eui”-Attribut, um die korrekten Daten von der Schnittstelle abfragen zu können. Bei der Auslieferung der Geräte wird der jeweils zugehörige Attributwert(DeviceID) für das Attribut “eui” mitgelifert. Der Tag hat die Möglichkeit ebenfalls ein “date-format”-Attribut anzugeben, um das Datum und die Zeit entsprechend zu formatieren. Als Attributwert stehen folgende Optionen zur Verfügung:

Attributwert für date-format Format Beispiel
dayDateTime Freitag, 12. November 2020, 15:00 <pt-counter-last-update eui="DeviceID" date-format="dayDateTime"></pt-counter-last-update>
dayDateTimeShort Fr., 12. Nov. 2020, 15:00 <pt-counter-last-update eui="DeviceID" date-format="dayDateTimeShort"></pt-counter-last-update>
dateTime 12. November 2020, 15:00 <pt-counter-last-update eui="DeviceID" date-format="dateTime"></pt-counter-last-update>
dateTimeShort 12. Nov. 2020, 15:00 <pt-counter-last-update eui="DeviceID" date-format="dateTimeShort"></pt-counter-last-update>
time 15:00 <pt-counter-last-update eui="DeviceID" date-format="time"></pt-counter-last-update>

Hinweise:
Falls ein falscher oder kein Wert für das “date-format”-Attribut angegeben wird, kommt automatisch das “dayDateTime”-Format. Ersetzten Sie zudem den Attributwert vom Attribut “eui” mit dem bei der Lieferung erhaltenen Wert

Vollständiges Beispiel

Code

<html>
    <head>

        <script type="module" src="https://unpkg.com/p-tags_v1@latest/dist/p-tags/p-tags.esm.js"></script>
        <script nomodule="" src="https://unpkg.com/p-tags_v1@latest/dist/p-tags/p-tags.js"></script>

        <title>p-tags Beispiel</title>

    </head>
    <body>

        <h1>Aktuelle Auslastung</h1>
            
        <p>Aktuell befinden sich <b><pt-counter-diff eui="DeviceID" /></b> Personen in der Anlage.</p>
        <p>Letztes Update: <p>dayDateTime: <b><pt-counter-last-update eui="DeviceID" date-format="dayDateTime" /></b> </p>

    </body>
</html> 

Ausgabe auf Website

Aktuelle Auslastung

Aktuell befinden sich 50 Personen in der Anlage.

Letztes Update: Freitag, 16. Juli 2020, 11:00