Beschrijving
Qndrs Traffic Display for Telraam toont verkeersstatistieken uit de Telraam API op een WordPress site.
De plugin biedt momenteel een shortcode om verkeerstotalen voor een Telraam segment te tonen. De plugin gebruikt de HTTP API van WordPress voor aanvragen en tijdelijke WordPress cacheopslag, zodat de beperkingen van de Telraam API worden gerespecteerd.
De uitvoer aan de front-end gebruikt semantische HTML met gelabelde secties, samenvattende gegevens, toegankelijke tabelbijschriften en een neutrale responsive basisstijl.
Huidige shortcode:
[qndrs_telraam_segment]
Met attributen:
[qndrs_telraam_segment id="9000010390" days="7"]
Tabelweergave:
[qndrs_telraam_segment id="9000010390" days="7" view="table"]
Beperk het aantal tabelrijen:
[qndrs_telraam_segment id="9000010390" days="7" view="table" rows="24"]
Tabelrijen worden van nieuw naar oud getoond. Gebruik rows="all" om alle teruggestuurde rijen te tonen. De standaardwaarde is 24.
Pas de koptekst van de plugin aan of verberg deze visueel:
[qndrs_telraam_segment title="Traffic in our street"]
[qndrs_telraam_segment title=""]
De plugin vereist een Telraam API-token. Je kunt het token en de standaard segmentinstellingen configureren via Instellingen > Qndrs Traffic Display for Telraam.
De instellingenpagina bevat een API-verbindingstest. De test gebruikt het opgeslagen token en het standaard segment-ID, maar toont het token nooit.
Het opgeslagen API-token kan op de instellingenpagina worden gewist zonder een vervangend token in te voeren.
De instellingenpagina gebruikt een compacte kaartlay-out met token- en cacheacties naast de bijbehorende velden.
Externe diensten
Deze plugin maakt verbinding met de Telraam-API om verkeersstatistieken op te halen voor het Telraam-segment dat de sitebeheerder heeft ingesteld of dat in een shortcode is opgegeven.
De plugin stuurt een HTTPS POST aanvraag naar https://telraam-api.net/v1/reports/traffic wanneer er geen gegevens in de cache beschikbaar zijn, wanneer de API-verbindingstest wordt gebruikt of wanneer de cache handmatig wordt vernieuwd. De aanvraag bevat het ingestelde Telraam API-token in de header X-Api-Key en een JSON-body met het opgevraagde segment-ID, de starttijd, eindtijd, het rapportniveau en rapport format. De plugin stuurt geen WordPress gebruikersdata of bezoekersdata naar Telraam.
Verkeersdata die Telraam terugstuurt, worden aan de front-end van de site getoond en kunnen gedurende de ingestelde cacheduur tijdelijk door WordPress worden opgeslagen.
Telraam dienst: https://telraam.net/
Documentatie van de Telraam API: https://faq.telraam.net/en/category/2/data-interpretation-and-the-telraam-api
Gebruiksvoorwaarden van Telraam: https://telraam.net/en/terms-of-use
Privacybeleid van Telraam: https://telraam.net/en/privacy-policy
Overzicht van Telraams datalicenties: https://telraam.net/en/network
Deze plugin is niet verbonden met of goedgekeurd door Telraam. Op het gebruik van de Telraam-API zijn de eigen voorwaarden, verzoeklimieten en licentievoorwaarden voor data van Telraam van toepassing.
Installatie
- Upload de pluginmap naar
/wp-content/plugins/qndrs-traffic-display-for-telraam. - Activeer Qndrs Traffic Display for Telraam via het pluginscherm van WordPress.
- Ga naar Instellingen > Qndrs Traffic Display for Telraam.
- Voer je Telraam API-token in.
- Stel een standaard Telraam-segment-ID en cacheduur in.
- Gebruik de API-verbindingstest om het token en segment te controleren.
- Voeg de shortcode toe aan een bericht of pagina.
FAQ
-
Heb ik een Telraam API-token nodig?
-
Ja. De plugin gebruikt de Telraam API en heeft een geldig API-token nodig.
-
Slaat de plugin mijn API-token op?
-
Ja. Het token wordt opgeslagen als een WordPress optie. Het wordt niet aan de front-end van de site getoond en kan op de instellingenpagina worden gewist.
-
Maakt de plugin verbinding met een externe dienst?
-
Ja. De plugin stuurt aanvragen naar het Telraam API-endpoint op
https://telraam-api.net. -
Waarom is caching ingeschakeld?
-
Voor toegang tot de Telraam API geldt een verzoekbeperking. Caching vermindert herhaalde API-aanvragen en beschermt je API-quotum.
-
Kan ik een openbare Telraam locatie-URL gebruiken in plaats van een segment-ID?
-
Nog niet. Dit staat gepland voor een latere versie.
-
Is de plugin geschikt voor vertaling?
-
Ja. De plugin gebruikt het tekstdomein
qndrs-traffic-display-for-telraamen is voorbereid op taalpakketten van WordPress.org.
Beoordelingen
Er zijn geen beoordelingen voor deze plugin.
Bijdragers & ontwikkelaars
“Qndrs Traffic Display for Telraam” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
Bijdragers“Qndrs Traffic Display for Telraam” is vertaald in 1 locale. Dank voor de vertalers voor hun bijdragen.
Vertaal “Qndrs Traffic Display for Telraam” in je eigen taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
0.3.5
- Bevestigde compatibiliteit met WordPress 7.1.
0.3.4
- Een niet-beschikbare link over Telraams datalicenties vervangen door een werkende officiële Telraam-pagina.
0.3.3
- De plugin hernoemd naar Qndrs Traffic Display for Telraam om duidelijker te maken dat een externe dienst wordt gebruikt.
- De pluginslug en het tekstdomein gewijzigd in
qndrs-traffic-display-for-telraam. - De URI van de privéplugin op GitHub uit de pluginheader verwijderd.
- Meegeleverde Nederlandse
.po– en.mo-bestanden verwijderd ten gunste van taalpakketten van WordPress.org. - De tabeluitvoer gewijzigd om de nieuwste rijen met verkeersdata eerst te tonen.
0.3.2
- Telraam S2-tellingen voor nachtverkeer als aparte verkeerscategorie toegevoegd.
- De afhandeling van Telraam API-snelheidsbeperkingen verbeterd bij het opbouwen van pagina’s met een lege cache.
- Afgestemde responsive samenvattingskaart breakpoints voor smalle en brede containers.
- Het shortcode-attribuut
titletoegevoegd, inclusieftitle=""om de koptekst van de plugin visueel te verbergen.
0.3.1
- De weergave in zijbalken voor compacte lay-outs verbeterd.
- Dubbele meldingen over opgeslagen instellingen voorkomen.
- Labels aan de front-end ingekort voor compacte plaatsingen.
0.3.0
- Het shortcode-attribuut
rowsvoor tabeluitvoer toegevoegd. - De tijdstempels in tabellen aan de front-end verbeterd.
- Een neutrale responsive front-end basisstijl toegevoegd.
- De lay-out van de instellingenpagina en de beheerdersopmaak verbeterd.
- Het wissen van het API-token hersteld, zodat het opgeslagen token daadwerkelijk wordt verwijderd.
- Verkeersdata van segmenten uit de cache wissen wanneer het API-token wordt verwijderd.
0.2.0
- Een zichtbare API-tokenstatus toegevoegd zonder het token prijs te geven.
- Een actie voor het wissen van het API-token toegevoegd.
- Een API-verbindingstest toegevoegd.
- Een normalisator voor verkeersrapporten toegevoegd.
- De toegankelijke HTML-structuur aan de front-end verbeterd.
0.1.0
- Eerste basisstructuur van de plugin.
- Een instellingenpagina toegevoegd.
- Een Telraam API-client toegevoegd.
- Tijdelijke cacheopslag toegevoegd.
- De shortcode
[qndrs_telraam_segment]toegevoegd. - Internationalisatie voorbereid.