{"id":346137,"date":"2026-08-21T06:23:48","date_gmt":"2026-08-21T06:23:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/qndrs-telraam-inzicht\/"},"modified":"2026-08-21T06:23:14","modified_gmt":"2026-08-21T06:23:14","slug":"qndrs-traffic-display-for-telraam","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/qndrs-traffic-display-for-telraam\/","author":14254762,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.3.4","stable_tag":"0.3.4","tested":"7.0.4","requires":"6.5","requires_php":"8.3","requires_plugins":null,"header_name":"Qndrs Traffic Display for Telraam","header_author":"Qndrs","header_description":"Display Telraam traffic statistics on your WordPress website.","assets_banners_color":"","last_updated":"2026-08-21 06:23:14","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/qndrs.nl","rating":0,"author_block_rating":0,"active_installs":0,"downloads":32,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.3.4":{"tag":"0.3.4","author":"Qndrs","date":"2026-08-21 06:23:14"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3658826,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3658826,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3.4"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[3524,51735,80,521,493],"plugin_category":[36,43,55],"plugin_contributors":[271598],"plugin_business_model":[],"class_list":["post-346137","plugin","type-plugin","status-publish","hentry","plugin_tags-data","plugin_tags-mobility","plugin_tags-shortcode","plugin_tags-statistics","plugin_tags-traffic","plugin_category-analytics","plugin_category-customization","plugin_category-seo-and-marketing","plugin_contributors-qndrs","plugin_committers-qndrs"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/qndrs-traffic-display-for-telraam\/assets\/icon-128x128.png?rev=3658826","icon_2x":"https:\/\/ps.w.org\/qndrs-traffic-display-for-telraam\/assets\/icon-256x256.png?rev=3658826","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Qndrs Traffic Display for Telraam displays traffic statistics from the Telraam API on a WordPress website.<\/p>\n\n<p>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.<\/p>\n\n<p>Frontend output uses semantic HTML with labelled sections, summary data, accessible table captions, and a neutral responsive base style.<\/p>\n\n<p>Current shortcode:<\/p>\n\n<pre><code>[qndrs_telraam_segment]\n<\/code><\/pre>\n\n<p>With attributes:<\/p>\n\n<pre><code>[qndrs_telraam_segment id=\"9000010390\" days=\"7\"]\n<\/code><\/pre>\n\n<p>Table view:<\/p>\n\n<pre><code>[qndrs_telraam_segment id=\"9000010390\" days=\"7\" view=\"table\"]\n<\/code><\/pre>\n\n<p>Limit table rows:<\/p>\n\n<pre><code>[qndrs_telraam_segment id=\"9000010390\" days=\"7\" view=\"table\" rows=\"24\"]\n<\/code><\/pre>\n\n<p>Table rows are shown from newest to oldest. Use <code>rows=\"all\"<\/code> to show all returned rows. The default is <code>24<\/code>.<\/p>\n\n<p>Customize or visually hide the plugin heading:<\/p>\n\n<pre><code>[qndrs_telraam_segment title=\"Traffic in our street\"]\n\n[qndrs_telraam_segment title=\"\"]\n<\/code><\/pre>\n\n<p>The plugin requires a Telraam API token. You can configure the token and default segment settings in Settings &gt; Qndrs Traffic Display for Telraam.<\/p>\n\n<p>The settings page includes an API connection test. The test uses the saved token and default segment ID, but never displays the token.<\/p>\n\n<p>The saved API token can be cleared from the settings page without entering a replacement token.<\/p>\n\n<p>The settings page uses a compact card layout with token and cache actions next to the related fields.<\/p>\n\n<h3>External services<\/h3>\n\n<p>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.<\/p>\n\n<p>The plugin sends an HTTPS POST request to <code>https:\/\/telraam-api.net\/v1\/reports\/traffic<\/code> 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 <code>X-Api-Key<\/code> 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.<\/p>\n\n<p>Traffic data returned by Telraam is displayed on the site frontend and may be cached in WordPress transients for the configured cache duration.<\/p>\n\n<p>Telraam service: https:\/\/telraam.net\/<\/p>\n\n<p>Telraam API documentation: https:\/\/faq.telraam.net\/en\/category\/2\/data-interpretation-and-the-telraam-api<\/p>\n\n<p>Telraam terms of use: https:\/\/telraam.net\/en\/terms-of-use<\/p>\n\n<p>Telraam privacy policy: https:\/\/telraam.net\/en\/privacy-policy<\/p>\n\n<p>Telraam data licensing overview: https:\/\/telraam.net\/en\/network<\/p>\n\n<p>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.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/qndrs-traffic-display-for-telraam<\/code>.<\/li>\n<li>Activate Qndrs Traffic Display for Telraam through the WordPress Plugins screen.<\/li>\n<li>Go to Settings &gt; Qndrs Traffic Display for Telraam.<\/li>\n<li>Enter your Telraam API token.<\/li>\n<li>Configure a default Telraam segment ID and cache duration.<\/li>\n<li>Use the API connection test to verify the token and segment.<\/li>\n<li>Add the shortcode to a post or page.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20telraam%20api%20token%3F\"><h3>Do I need a Telraam API token?<\/h3><\/dt>\n<dd><p>Yes. The plugin uses the Telraam API and needs a valid API token.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20store%20my%20api%20token%3F\"><h3>Does the plugin store my API token?<\/h3><\/dt>\n<dd><p>Yes. The token is stored as a WordPress option. It is not shown on the frontend and can be cleared from the settings page.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20call%20an%20external%20service%3F\"><h3>Does the plugin call an external service?<\/h3><\/dt>\n<dd><p>Yes. The plugin sends requests to the Telraam API endpoint at <code>https:\/\/telraam-api.net<\/code>.<\/p><\/dd>\n<dt id=\"why%20is%20caching%20enabled%3F\"><h3>Why is caching enabled?<\/h3><\/dt>\n<dd><p>Telraam API access is rate limited. Caching reduces repeated API requests and protects your API quota.<\/p><\/dd>\n<dt id=\"can%20i%20use%20a%20public%20telraam%20location%20url%20instead%20of%20a%20segment%20id%3F\"><h3>Can I use a public Telraam location URL instead of a segment ID?<\/h3><\/dt>\n<dd><p>Not yet. This is planned for a later version.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20translation-ready%3F\"><h3>Is the plugin translation-ready?<\/h3><\/dt>\n<dd><p>Yes. The plugin uses the <code>qndrs-traffic-display-for-telraam<\/code> text domain and is prepared for WordPress.org language packs.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.3.4<\/h4>\n\n<ul>\n<li>Replaced an unavailable Telraam data licensing link with a working official Telraam page.<\/li>\n<\/ul>\n\n<h4>0.3.3<\/h4>\n\n<ul>\n<li>Renamed the plugin to Qndrs Traffic Display for Telraam for clearer third-party service naming.<\/li>\n<li>Changed the plugin slug and text domain to <code>qndrs-traffic-display-for-telraam<\/code>.<\/li>\n<li>Removed the private GitHub Plugin URI from the plugin header.<\/li>\n<li>Removed packaged Dutch <code>.po<\/code> and <code>.mo<\/code> files in favor of WordPress.org language packs.<\/li>\n<li>Changed table output to show the newest traffic rows first.<\/li>\n<\/ul>\n\n<h4>0.3.2<\/h4>\n\n<ul>\n<li>Added Telraam S2 night traffic counts as a separate traffic category.<\/li>\n<li>Improved Telraam API rate-limit handling during cold-cache page renders.<\/li>\n<li>Refined responsive summary card breakpoints for narrow and wide containers.<\/li>\n<li>Added a <code>title<\/code> shortcode attribute, including <code>title=\"\"<\/code> to visually hide the plugin heading.<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Improved sidebar display for compact layouts.<\/li>\n<li>Prevented duplicate settings saved notices.<\/li>\n<li>Shortened frontend labels for compact placements.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>Added a <code>rows<\/code> shortcode attribute for table output.<\/li>\n<li>Improved frontend table timestamps.<\/li>\n<li>Added a neutral responsive frontend base style.<\/li>\n<li>Improved settings page layout and admin styling.<\/li>\n<li>Fixed API token clearing so the saved token is actually removed.<\/li>\n<li>Clear cached segment traffic data when the API token is removed.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Added visible API token status without exposing the token.<\/li>\n<li>Added API token clearing action.<\/li>\n<li>Added API connection test.<\/li>\n<li>Added traffic report normalizer.<\/li>\n<li>Improved accessible frontend HTML structure.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial plugin scaffold.<\/li>\n<li>Added settings page.<\/li>\n<li>Added Telraam API client.<\/li>\n<li>Added transient caching.<\/li>\n<li>Added <code>[qndrs_telraam_segment]<\/code> shortcode.<\/li>\n<li>Prepared internationalization.<\/li>\n<\/ul>","raw_excerpt":"Display Telraam traffic statistics on your WordPress website using a shortcode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/346137","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=346137"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/qndrs"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=346137"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=346137"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=346137"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=346137"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=346137"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=346137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}