Changeset 3751958

Timestamp:

10/17/2026 01:27:04 PM (14 hours ago)

Author:

arbling

Message:

Arbling Beacon 0.3.2

Location:

arbling-beacon

Files:

• assets/banner-1544x500.png (added)
• assets/banner-772x250.png (added)
• assets/icon-128x128.png (added)
• assets/icon-256x256.png (added)
• assets/screenshot-1.png (added)
• tags/0.3.2 (added)
• tags/0.3.2/arbling-beacon.php (added)
• tags/0.3.2/assets (added)
• tags/0.3.2/assets/privacy-adapter.js (added)
• tags/0.3.2/readme.txt (added)
• trunk/arbling-beacon.php (modified) (3 diffs)
• trunk/readme.txt (modified) (7 diffs)

arbling-beacon/trunk/arbling-beacon.php

@@ -3 +3 @@
  * Plugin Name: Arbling Beacon
  * Description: Adds the Arbling AI-arrival beacon to any WordPress site, bound by its site key and gated by consent. On a WooCommerce store, product pages also report the product. With a connector key it reports AI crawlers and counts visits server-side, with no personal data.
- * Version: 0.3.1
+ * Version: 0.3.2
  * Requires at least: 6.3
  * Requires PHP: 7.4
@@ -17 +17 @@
 }
 
-const ARBLING_BEACON_VERSION = '0.3.1';
+const ARBLING_BEACON_VERSION = '0.3.2';
 const ARBLING_BEACON_SRC = 'https://api.arbling.com/ati-beacon.js';
 const ARBLING_BEACON_CRAWL_URL = 'https://api.arbling.com/api/ati/v1/crawl-events';
@@ -511 +511 @@
     echo '<form method="post" action="options.php">';
     settings_fields('arbling_beacon');
-    echo '<p><label for="arbling_beacon_site_key">' . esc_html__('Site key (Arbling: Integrations, Install on any website)', 'arbling-beacon') . '</label><br>';
+    echo '<p><label for="arbling_beacon_site_key">' . esc_html__('Site key (Arbling: Settings → Integrations → AI Visibility tracking code)', 'arbling-beacon') . '</label><br>';
     echo '<input type="text" id="arbling_beacon_site_key" name="arbling_beacon_site_key" class="regular-text" value="' . esc_attr(arbling_beacon_site_key()) . '" pattern="atisk_[0-9A-Za-z]{22}"></p>';
     $saved = arbling_beacon_connector_key() !== '' ? __('saved; leave empty to keep it', 'arbling-beacon') : __('not set', 'arbling-beacon');
-    echo '<p><label for="arbling_beacon_connector_key">' . esc_html__('Crawler reporting key (Arbling: Settings, Connectors)', 'arbling-beacon') . ' (' . esc_html($saved) . ')</label><br>';
+    echo '<p><label for="arbling_beacon_connector_key">' . esc_html__('Crawler reporting key, optional (from Arbling; if your dashboard does not show one, write to hi@arbling.com)', 'arbling-beacon') . ' (' . esc_html($saved) . ')</label><br>';
     echo '<input type="password" id="arbling_beacon_connector_key" name="arbling_beacon_connector_key" class="regular-text" value="" autocomplete="off"></p>';
     submit_button();

arbling-beacon/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 0.3.1
+Stable tag: 0.3.2
 License: MIT
 License URI: https://opensource.org/license/mit
@@ -25 +25 @@
 * Visit counts made on your server carry no personal data.
 
-You need an Arbling account to see the numbers. You copy both keys from your Arbling dashboard.
+You need an Arbling account to see the numbers. You copy the site key from your Arbling dashboard; the crawler reporting key is optional (see Installation).
 
 == External services ==
@@ -35 +35 @@
 * **What loads:** your pages load `https://api.arbling.com/ati-beacon.js`, tagged with your public site key.
 * **What it sends for every page view:** the page's path, the host name of the site the visitor came from, and whether that site is an AI assistant. This carries no identifier.
-* **What it adds only when the visitor's consent allows it:** for a visit that arrives from an AI assistant, it sends that visit with a random identifier kept in the browser's local storage. Arbling uses the identifier to connect the visit to what the visitor does next.
+* **What it adds only when the visitor's consent allows it and your Arbling account has this turned on:** for a visit that arrives from an AI assistant, it sends that visit with a random identifier kept in the browser's local storage. Arbling uses the identifier to connect the visit to what the visitor does next. With a WP Consent API banner, the visitor must allow both statistics and marketing.
 * **What it never does:** set a cookie.
 * **Where:** `https://api.arbling.com/api/ati/visits`.
@@ -57 +57 @@
 
 1. Install the plugin from Plugins → Add New, or upload the zip, and activate it.
-2. In your Arbling dashboard, open Integrations → Install on any website and copy your site key.
+2. In your Arbling dashboard, open Settings → Integrations → AI Visibility tracking code and copy "Your site key".
 3. In WordPress, open Settings → Arbling Beacon, paste the site key and save.
-4. Optional: to see AI crawlers and visit counts, copy the crawler reporting key from Arbling (Settings → Connectors), paste it on the same page and save.
+4. Optional: AI crawler reports and server-side visit counts need a WordPress connector key from Arbling. If your dashboard does not offer one, ask us at hi@arbling.com. Paste it into "Crawler reporting key" on the same page and save.
+5. Open one of your pages, then check your Arbling dashboard. If your Arbling account limits which site addresses may send visits, visits from an address that is not on that list are refused. If no visits appear, write to hi@arbling.com with your site's address.
 
 == Frequently Asked Questions ==
@@ -73 +74 @@
 = Does it work with my consent banner? =
 
-If your banner supports the WP Consent API, the beacon follows the visitor's choice. The page-view count carries no identifier and is sent for every visit. The identifier that connects a visit from an AI assistant to what happens next is only kept with consent.
+If your banner supports the WP Consent API, the beacon follows the visitor's choice. The page-view count carries no identifier and is sent for every visit. The identifier that connects a visit from an AI assistant to what happens next is kept only when your Arbling account has it turned on and, with a WP Consent API banner, only when the visitor allows both statistics and marketing.
+
+= I don't see any visits in Arbling =
+
+Check that the site key is saved under Settings → Arbling Beacon. If your Arbling account limits which site addresses may send visits, visits from an address that is not on the list are refused; write to hi@arbling.com with this site's address.
 
 = Will it slow my site down? =
@@ -81 +86 @@
 == Screenshots ==
 
-1. The settings page: the site key, and the optional crawler reporting key.
+1. The settings page before any key is saved: the site key, and the optional crawler reporting key.
 
 == Changelog ==
+
+= 0.3.2 =
+* The settings screen names the current Arbling dashboard paths.
 
 = 0.3.1 =
@@ -102 +110 @@
 == Upgrade Notice ==
 
+= 0.3.2 =
+Updates the settings screen's directions; nothing else changes.
+
 = 0.3.1 =
 The first release on WordPress.org. It adds server-side visit counts: save a crawler reporting key to turn them on.