{"id":361434,"date":"2026-09-03T06:29:17","date_gmt":"2026-09-03T06:29:17","guid":{"rendered":"https:\/\/en-gb.wordpress.org\/plugins\/add-as-preferred-source-button-popup-analytics-for-google-seo-ai-overviews\/"},"modified":"2026-09-03T06:55:27","modified_gmt":"2026-09-03T06:55:27","slug":"opace-preferred-source-button-for-google","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/opace-preferred-source-button-for-google\/","author":14986347,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.5","stable_tag":"1.1.5","tested":"7.1","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Opace Preferred Source Button & Analytics for Google","header_author":"Opace Digital Agency","header_description":"Add Google's official Preferred Sources popup button anywhere \u2014 block, shortcode, widget, floating banner or auto-placement \u2014 with CRO triggers, click analytics, GA4 events, an eligibility checker and GDPR consent mode.","assets_banners_color":"003d6a","last_updated":"2026-09-03 06:55:27","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/opace.agency\/add-as-preferred-source-button-for-google\/","header_author_uri":"https:\/\/opace.agency\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.4":{"tag":"1.1.4","author":"opacewebdesign","date":"2026-09-03 06:28:43","revision":3679099},"1.1.5":{"tag":"1.1.5","author":"opacewebdesign","date":"2026-09-03 06:55:27","revision":3679146}},"upgrade_notice":{"1.1.5":"<p>Adds a bundled English (UK) translation, tidies the help page and wizard markup and updates the activation notice wording.<\/p>","1.1.4":"<p>Aligns the package and translation identifiers with the final WordPress.org slug and clarifies settings sanitisation.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3679099,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3679099,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3679134,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3679134,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"opsrc\/preferred-source-button":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"opsrc\/preferred-source-button","title":"Preferred Source Button","category":"widgets","icon":"star-filled","description":"Invite readers to add your site as a preferred source on Google.","keywords":["google","preferred source","follow","popup"],"textdomain":"opace-preferred-source-button-for-google","attributes":{"style":{"type":"string","default":""},"label":{"type":"string","default":""},"theme":{"type":"string","default":""},"align":{"type":"string","default":""}},"supports":{"align":["left","center","right","wide"],"html":false},"editorScript":"file:.\/index.js","editorStyle":"file:.\/editor.css"}},"tagged_versions":["1.1.4","1.1.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3679134,"resolution":"1","location":"assets","locale":"","width":1280,"height":800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3679134,"resolution":"2","location":"assets","locale":"","width":1280,"height":800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3679134,"resolution":"3","location":"assets","locale":"","width":1280,"height":800},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3679134,"resolution":"4","location":"assets","locale":"","width":1280,"height":800},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3679134,"resolution":"5","location":"assets","locale":"","width":1280,"height":800},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3679134,"resolution":"6","location":"assets","locale":"","width":1280,"height":800},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3679134,"resolution":"7","location":"assets","locale":"","width":1280,"height":800},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3679134,"resolution":"8","location":"assets","locale":"","width":1280,"height":800}},"screenshots":{"1":"Settings placement tab with Smart placement, automatic placement and supported insertion positions.","2":"Settings design tab with button styles, live preview, label and theme controls.","3":"Banner trigger settings for immediate, scroll-depth and delayed display, plus audience frequency controls.","4":"Advanced consent and Google button language settings.","5":"Analytics dashboard with aggregate impressions, button clicks and click-through rate. These are trigger metrics, never confirmed additions.","6":"Gutenberg editor with the Preferred Source Button block selected and its block settings visible.","7":"Front-end floating banner with the Google-colours button and direct-link fallback.","8":"Help &amp; shortcodes reference with setup guidance and measurement limits."}},"plugin_section":[],"plugin_tags":[232,3019,148076,271892,186],"plugin_category":[36,55],"plugin_contributors":[166550],"plugin_business_model":[],"class_list":["post-361434","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-google-search","plugin_tags-gutenberg","plugin_tags-preferred-sources","plugin_tags-seo","plugin_category-analytics","plugin_category-seo-and-marketing","plugin_contributors-opacewebdesign","plugin_committers-opacewebdesign"],"banners":{"banner":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/banner-772x250.png?rev=3679134","banner_2x":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/banner-1544x500.png?rev=3679134","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/icon-128x128.png?rev=3679099","icon_2x":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/icon-256x256.png?rev=3679099","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-1.png?rev=3679134","caption":"Settings placement tab with Smart placement, automatic placement and supported insertion positions."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-2.png?rev=3679134","caption":"Settings design tab with button styles, live preview, label and theme controls."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-3.png?rev=3679134","caption":"Banner trigger settings for immediate, scroll-depth and delayed display, plus audience frequency controls."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-4.png?rev=3679134","caption":"Advanced consent and Google button language settings."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-5.png?rev=3679134","caption":"Analytics dashboard with aggregate impressions, button clicks and click-through rate. These are trigger metrics, never confirmed additions."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-6.png?rev=3679134","caption":"Gutenberg editor with the Preferred Source Button block selected and its block settings visible."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-7.png?rev=3679134","caption":"Front-end floating banner with the Google-colours button and direct-link fallback."},{"src":"https:\/\/ps.w.org\/opace-preferred-source-button-for-google\/assets\/screenshot-8.png?rev=3679134","caption":"Help &amp; shortcodes reference with setup guidance and measurement limits."}],"raw_content":"<!--section=description-->\n<p>Need to audit a live implementation first? <a href=\"https:\/\/chromewebstore.google.com\/detail\/add-as-preferred-source-b\/dnifhlampnjpfigeniaoihblbdegijgp\">Install the free Preferred Source Checker for Chrome<\/a> to check eligibility, the publisher SDK, button rendering and the fallback link.<\/p>\n\n<p>Add Google's hosted Preferred Sources popup button to a WordPress site. Readers can choose a source in Google's own flow without leaving the page. Custom button presets use Google's direct preferences link if the script cannot load; the native style includes a no-JavaScript fallback.<\/p>\n\n<h4>Google Preferred Sources for WordPress<\/h4>\n\n<p>Google Preferred Sources is a reader choice, not a site-wide ranking factor. Google says selected fresh, relevant content may appear more often in Top Stories and receive a preferred badge in AI Overviews and AI Mode. No traffic, AI citation or visibility is guaranteed. See <a href=\"https:\/\/developers.google.com\/search\/docs\/appearance\/preferred-sources\">publisher guidance<\/a> and <a href=\"https:\/\/blog.google\/products-and-platforms\/products\/search\/preferred-sources-language-expansion\/\">click-through finding<\/a>.<\/p>\n\n<h4>Add as Preferred Source with a Preferred Source Button<\/h4>\n\n<p>Give readers a way to add your publication as a Preferred Source in Google's popup. Show a Preferred Source Button in an article, footer, widget or floating banner; custom presets use a direct-link fallback if the script cannot load.<\/p>\n\n<h4>Preferred Source Button placement and controls<\/h4>\n\n<ul>\n<li>Place the button with the Gutenberg block, <code>[opace_preferred_source]<\/code>, <code>[opace_preferred_source_button]<\/code> or <code>[opsrc_button]<\/code> shortcode, classic widget, floating banner, footer, after the first H2 or at the end of content.<\/li>\n<li>Use Smart placement to rotate five supported positions, then favour the highest measured click-through rate with continued exploration. It measures clicks, not completed additions.<\/li>\n<li>Show a banner immediately, after scroll depth or delay, or on desktop exit intent. Include returning-visitor and post-click or dismissal suppression controls.<\/li>\n<li>Choose Google's native button or custom Google-colours and neutral presets, with light, dark and language settings.<\/li>\n<\/ul>\n\n<h4>Analytics, eligibility and consent<\/h4>\n\n<ul>\n<li>Record anonymous aggregate impressions, clicks and click-through rate for 30 or 90 days, with a per-placement table. Optional GA4\/dataLayer events record clicks only.<\/li>\n<li>Check whether the WordPress address is a domain or subdomain. Google has no eligibility API, so the plugin links to its preferences tool for the owner to check manually. Subdirectories are not eligible.<\/li>\n<li>Enable GDPR two-click mode to defer the Google script until a reader agrees. Declining uses the direct preferences link.<\/li>\n<li>Use network activation-safe defaults, per-site settings, optional network settings locking and a documented white-label filter for agency installations.<\/li>\n<\/ul>\n\n<h4>External services and privacy<\/h4>\n\n<p>The plugin loads Google's <code>publisher.js<\/code> from <code>news.google.com<\/code> only on pages where a button or banner renders, so Google's popup can open. The plugin itself sends no personal data to Google. A browser request to Google may involve IP address and browser data under <a href=\"https:\/\/policies.google.com\/terms\">Google's Terms of Service<\/a> and <a href=\"https:\/\/policies.google.com\/privacy\">Privacy Policy<\/a>.<\/p>\n\n<p>The fallback link and eligibility panel point to <code>google.com\/preferences\/source<\/code> but make no automatic request. The two-click mode prevents a Google request until the reader agrees. Plugin analytics are anonymous aggregate counts in the WordPress database. Optional GA4\/dataLayer events send placement, style and popup-or-deeplink mode to an existing setup; the plugin does not load GA4. Browser local storage supports consent, banner suppression and returning-visitor behaviour. A short-lived transient based on an anonymised IP hash rate-limits public analytics events.<\/p>\n\n<h4>Measurement limit<\/h4>\n\n<p>Google's SDK has no completion callback, promise or event. Analytics record impressions and clicks on the trigger, never confirmed Preferred Source additions, conversions, rankings or visibility results.<\/p>\n\n<h4>Related Preferred Sources tools<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/opace.agency\/tools\/suite\/add-as-preferred-source-button-for-google\/\">Preferred Sources suite hub<\/a><\/li>\n<li><a href=\"https:\/\/opace.agency\/tools\/suite\/add-as-preferred-source-button-for-google\/button-checker\/\">Eligibility checker<\/a><\/li>\n<li><a href=\"https:\/\/opace.agency\/tools\/suite\/add-as-preferred-source-button-for-google\/button-generator\/\">Button and code generator<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/OpaceDigitalAgency\/add-as-preferred-source-button-for-google\">Preferred Sources framework packages for React, Vue, Svelte and Astro<\/a><\/li>\n<li><a href=\"https:\/\/chromewebstore.google.com\/detail\/add-as-preferred-source-b\/dnifhlampnjpfigeniaoihblbdegijgp\">Install the Preferred Source Checker Chrome extension<\/a> or <a href=\"https:\/\/github.com\/OpaceDigitalAgency\/preferred-source-checker-for-google-chrome-extension\">inspect its source<\/a><\/li>\n<li><a href=\"https:\/\/opace.agency\/services\/seo\/\">Opace SEO services<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/OpaceDigitalAgency\">Opace Digital Agency on GitHub<\/a><\/li>\n<\/ul>\n\n<p>Independently developed by Opace Digital Agency and not affiliated with, endorsed by or sponsored by Google.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In your WordPress admin, go to Plugins \u2192 Add New and search for \"Opace Preferred Source\", or upload the plugin ZIP via Plugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n<li>Install and activate the plugin.<\/li>\n<li>Complete the setup wizard to review address guidance, choose a button style and enable a placement.<\/li>\n<li>Open Preferred Source \u2192 Settings to refine placement, triggers, analytics and consent mode.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20the%20plugin%20confirm%20that%20my%20site%20is%20eligible%3F\"><h3>Can the plugin confirm that my site is eligible?<\/h3><\/dt>\n<dd><p>No. It checks whether the current address is a supported domain or subdomain format and links to Google's source preferences tool. Google provides no automated eligibility API. Subdirectories such as <code>example.com\/blog<\/code> are not eligible.<\/p><\/dd>\n<dt id=\"are%20the%20analytics%20confirmed%20additions%20or%20conversions%3F\"><h3>Are the analytics confirmed additions or conversions?<\/h3><\/dt>\n<dd><p>No. Google's SDK does not report whether a reader completed the popup. The plugin records impressions and clicks, and Smart placement uses click-through rate only.<\/p><\/dd>\n<dt id=\"does%20the%20button%20improve%20rankings%20or%20guarantee%20ai%20overview%20visibility%3F\"><h3>Does the button improve rankings or guarantee AI Overview visibility?<\/h3><\/dt>\n<dd><p>No. Preferred Sources is a reader-level personalisation feature. The button is an invitation for readers to use Google's flow; it does not change general rankings or guarantee inclusion in any Google surface.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20google%27s%20script%20is%20blocked%3F\"><h3>What happens if Google's script is blocked?<\/h3><\/dt>\n<dd><p>Custom button presets open Google's direct source-preferences link. With JavaScript disabled, every style renders a plain link. The native style relies on Google's rendered button when JavaScript is available.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20load%20data%20from%20google%3F\"><h3>Does the plugin load data from Google?<\/h3><\/dt>\n<dd><p>It loads Google's hosted <code>publisher.js<\/code> on pages where a button or banner renders. Enable two-click mode to wait for reader agreement. The script tag also includes <code>data-opsrc-sdk=\"1\"<\/code> for consent-management tools that target scripts by attribute.<\/p><\/dd>\n<dt id=\"what%20are%20the%20shortcodes%3F\"><h3>What are the shortcodes?<\/h3><\/dt>\n<dd><p>Use <code>[opace_preferred_source]<\/code>, <code>[opace_preferred_source_button]<\/code> or <code>[opsrc_button]<\/code>. All accept <code>style<\/code>, <code>label<\/code>, <code>theme<\/code>, <code>lang<\/code> and <code>align<\/code>. Use Preferred Source \u2192 Help &amp; shortcodes for examples and developer-filter guidance.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20button%20or%20white-label%20the%20admin%3F\"><h3>Can I change the button or white-label the admin?<\/h3><\/dt>\n<dd><p>Yes. The plugin documents filters including <code>opsrc_render_button_html<\/code>, <code>opsrc_render_banner_html<\/code> and <code>opsrc_white_label<\/code> on its Help &amp; shortcodes screen.<\/p><\/dd>\n<dt id=\"is%20this%20plugin%20affiliated%20with%20google%3F\"><h3>Is this plugin affiliated with Google?<\/h3><\/dt>\n<dd><p>No. It integrates Google's publicly documented Preferred Sources button. Google is a trademark of Google LLC.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.5<\/h4>\n\n<ul>\n<li>Bundled an English (UK) translation and now load the plugin text domain from the languages folder.<\/li>\n<li>Regenerated the translation template from the published 1.1.4 strings.<\/li>\n<li>Removed line-break tags from the help page and setup wizard markup in favour of list and paragraph elements.<\/li>\n<li>Updated the activation notice to use the approved plugin name.<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Aligned the plugin directory, main file and translation domain with the approved <code>opace-preferred-source-button-for-google<\/code> slug.<\/li>\n<li>Made the existing field-by-field settings sanitisation callback explicit on the registered settings instance.<\/li>\n<li>Standardised the remaining developer filters and uninstall helpers on the unique <code>opsrc<\/code> prefix before publication.<\/li>\n<li>Restored WordPress's confirmation notice after settings are saved.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Renamed the plugin to Opace Preferred Source Button &amp; Analytics for Google.<\/li>\n<li>Replaced short internal prefixes with unique <code>opsrc<\/code>\/<code>opace<\/code> identifiers and updated the directory installation instructions.<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Refreshed the directory documentation with the complete shortcode list and clearer multisite and agency deployment guidance; no runtime behaviour changed.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added Smart and content-aware placement, per-placement analytics and the Help &amp; shortcodes screen.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Fixed index-permalink REST URLs and block editor dependencies.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Let readers open Google&#039;s Preferred Sources popup from WordPress, with placement controls and honest click analytics.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/361434","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=361434"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/opacewebdesign"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=361434"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=361434"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=361434"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=361434"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=361434"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=361434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}