Qndrs Traffic Display for Telraam

Description

Qndrs Traffic Display for Telraam displays traffic statistics from the Telraam API on a WordPress website.

The plugin currently provides a shortcode for showing traffic totals for a Telraam segment. It uses the WordPress HTTP API for requests and WordPress transients for caching, so Telraam API limits are respected.

Frontend output uses semantic HTML with labelled sections, summary data, accessible table captions, and a neutral responsive base style.

Current shortcode:

[qndrs_telraam_segment]

With attributes:

[qndrs_telraam_segment id="9000010390" days="7"]

Table view:

[qndrs_telraam_segment id="9000010390" days="7" view="table"]

Limit table rows:

[qndrs_telraam_segment id="9000010390" days="7" view="table" rows="24"]

Table rows are shown from newest to oldest. Use rows="all" to show all returned rows. The default is 24.

Customize or visually hide the plugin heading:

[qndrs_telraam_segment title="Traffic in our street"]

[qndrs_telraam_segment title=""]

The plugin requires a Telraam API token. You can configure the token and default segment settings in Settings > Qndrs Traffic Display for Telraam.

The settings page includes an API connection test. The test uses the saved token and default segment ID, but never displays the token.

The saved API token can be cleared from the settings page without entering a replacement token.

The settings page uses a compact card layout with token and cache actions next to the related fields.

External services

This plugin connects to the Telraam API to retrieve traffic statistics for the Telraam segment configured by the site administrator or provided in a shortcode.

The plugin sends an HTTPS POST request to https://telraam-api.net/v1/reports/traffic when cached data is not available, when the API connection test is used, or when the cache is manually refreshed. The request includes the configured Telraam API token in the X-Api-Key header and a JSON body containing the requested segment ID, start time, end time, report level, and report format. The plugin does not send WordPress user data or visitor data to Telraam.

Traffic data returned by Telraam is displayed on the site frontend and may be cached in WordPress transients for the configured cache duration.

Telraam service: https://telraam.net/

Telraam API documentation: https://faq.telraam.net/en/category/2/data-interpretation-and-the-telraam-api

Telraam terms of use: https://telraam.net/en/terms-of-use

Telraam privacy policy: https://telraam.net/en/privacy-policy

Telraam data licensing overview: https://telraam.net/en/network

This plugin is not affiliated with or endorsed by Telraam. Telraam API use is subject to Telraam’s own terms, rate limits, and data licensing conditions.