From a613d99b15055d64aefa56c611fb728d3e0e44a3 Mon Sep 17 00:00:00 2001
From: Daan van den Bergh <18595395+Dan0sz@users.noreply.github.com>
Date: Mon, 10 Aug 2026 16:50:03 +0200
Subject: [PATCH 1/2] Added: info icons linking to the documentation for
several sections in the settings screen.
---
readme.txt | 2 ++
src/Admin/Settings/API.php | 46 ++++++++++++++++++++++++++++++-------
src/Admin/Settings/Page.php | 6 +++++
3 files changed, 46 insertions(+), 8 deletions(-)
diff --git a/readme.txt b/readme.txt
index a3dd7b0a..0d4fb45d 100644
--- a/readme.txt
+++ b/readme.txt
@@ -279,6 +279,8 @@ Please make sure you make a backup of your database before updating any version
== Changelog ==
= 2.6.1 =
+* Added: info icons linking to the documentation for Cloaked Affiliate Links, Query Parameters, View Your Stats in Your WordPress Dashboard, Track Analytics for User Roles, Show Stats Dashboard to
+Additional User Roles and Disable Menu in Toolbar.
* Fixed: the Getting Started Guide's Next button would stay disabled after entering (or pasting) a Plugin Token.
= 2.6.0 =
diff --git a/src/Admin/Settings/API.php b/src/Admin/Settings/API.php
index 9268fb4d..bf3859dd 100644
--- a/src/Admin/Settings/API.php
+++ b/src/Admin/Settings/API.php
@@ -81,19 +81,44 @@ public function render_checkbox_field( array $field, $is_list = false ) {
render_hook_field( reset( $field['disabled_tooltip'] ), $show_disabled_tooltip ); ?>
-
-
-
-
+
+ render_docs_link( $field['docs'], $field['label'] ); ?>
+
+
+
+ ">
-
+
diff --git a/src/Admin/Settings/Page.php b/src/Admin/Settings/Page.php
index 1ea42480..bb6fc353 100644
--- a/src/Admin/Settings/Page.php
+++ b/src/Admin/Settings/Page.php
@@ -198,6 +198,7 @@ public function __construct() {
'label' => esc_html__( 'Cloaked affiliate links', 'plausible-analytics' ),
'slug' => 'cloaked_affiliate_links',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#cloaked-affiliate-links',
'desc' => sprintf(
// translators: %s: Example URL to affiliate product.
__(
@@ -218,6 +219,7 @@ public function __construct() {
'label' => esc_html__( 'Query parameters', 'plausible-analytics' ),
'slug' => 'query_params',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#query-parameters',
'desc' => sprintf(
// translators: %s: Example URL with query parameter.
__(
@@ -272,6 +274,7 @@ public function __construct() {
'label' => esc_html__( 'View your stats in your WordPress dashboard', 'plausible-analytics' ),
'slug' => 'is_shared_link',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#view-your-stats-inside-wordpress',
'desc' => esc_html__(
'View your site statistics within your WordPress Dashboard.',
'plausible-analytics'
@@ -323,6 +326,7 @@ public function __construct() {
'label' => esc_html__( 'Track analytics for user roles', 'plausible-analytics' ),
'slug' => 'tracked_user_roles',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#exclude-admins-and-other-roles',
'desc' => esc_html__(
'By default, visits from logged in users aren\'t tracked. If you want to track visits for certain user roles then please specify them below.',
'plausible-analytics'
@@ -334,6 +338,7 @@ public function __construct() {
'label' => esc_html__( 'Show stats dashboard to additional user roles', 'plausible-analytics' ),
'slug' => 'expand_dashboard_access',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#view-your-stats-inside-wordpress',
'desc' => esc_html__(
'By default, the stats dashboard is only available to logged in administrators. If you want the dashboard to be available for other logged in users, then please specify them below.',
'plausible-analytics'
@@ -345,6 +350,7 @@ public function __construct() {
'label' => esc_html__( 'Disable menu in toolbar', 'plausible-analytics' ),
'slug' => 'disable_toolbar_menu',
'type' => 'group',
+ 'docs' => 'https://plausible.io/docs/wordpress-integration#disable-the-toolbar-menu',
'desc' => esc_html__(
'Check this option if you don\'t want the Plausible Analytics menu item to be added to the toolbar at the top of the screen.',
'plausible-analytics'
From 9df1fd3e7a95c15605ee76eba63ee76d183d5ac0 Mon Sep 17 00:00:00 2001
From: Daan van den Bergh <18595395+Dan0sz@users.noreply.github.com>
Date: Tue, 11 Aug 2026 10:58:38 +0200
Subject: [PATCH 2/2] Fixed: Add a stable accessible name to the icon-only
link.
---
src/Admin/Settings/API.php | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/src/Admin/Settings/API.php b/src/Admin/Settings/API.php
index bf3859dd..a719fcf0 100644
--- a/src/Admin/Settings/API.php
+++ b/src/Admin/Settings/API.php
@@ -96,7 +96,7 @@ public function render_checkbox_field( array $field, $is_list = false ) {
* @access public
*
* @param string $url URL to the documentation.
- * @param string $label Label of the option/section, used in the link's title attribute.
+ * @param string $label Label of the option/section, used as the link's accessible name.
*
* @return string
*/
@@ -109,7 +109,8 @@ public function render_docs_link( $url, $label = '' ) {
ob_start();
?>
-
+