KudoMetrics Preferred Source Button for Google
| 开发者 | kudometricsllc |
|---|---|
| 更新时间 | 2026年9月11日 00:54 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Official Google button — Use Google's official Preferred Sources button design
- 40+ unique button styles — Choose from a wide range of ready-made designs
- Live preview — See how your selected button looks before publishing it
- Custom button text — Change the button label to match your website and audience
- Custom site name — Add your website or publication name with the
{site_name}merge tag - Supporting text — Add optional short text above or below the button. Show it always, on hover, or from an info (i) icon
- Design customization — Customize the icon, border/fill, text color, background, tooltip background, corner radius, and font size
- Flexible positioning — Display the button at the top, middle, or end of an article, below the post meta, near the table of contents, in the sidebar, above comments, and more
- Floating button — Keep the Preferred Source button visible while visitors scroll
- Floating button triggers — Show immediately, after a selected scroll percentage, or after a time delay
- Device controls — Display automatic buttons on mobile and desktop, desktop only, or mobile only
- Multiple content types — Posts, pages, homepage/blog, category pages, tag pages, author pages, search results, archives, and supported custom content types
- Per-post control — Enable or disable the button for individual posts
- Exclusion rules — Hide the automatic button from specific posts, pages, or categories
- Bulk controls — Enable or disable the button across existing posts
- Shortcode —
[kmpsbg_preferred_source_button] - Block — Insert the button in the WordPress editor
- Widget — Add the button in a sidebar
- Custom Google domain — Specify the domain used for the Preferred Source link
- Open in new tab — Choose whether the Google link opens in a new browser tab
- Button name/text — For example, “Add as preferred on Google”
- Site name — Add your website or publication name
- Supporting text — Optionally add a short explanation above or below the button (always, on hover, or info icon)
- At the top of an article
- In the middle of an article (after a chosen paragraph)
- At the end of an article
- Below the post meta
- Above or below the table of contents
- In the sidebar (below Share this article, or at the end)
- Below the featured image or after the first heading
- Above comments
- As a floating button that stays visible while scrolling
安装:
- Upload the plugin files to
/wp-content/plugins/kudometrics-preferred-source-button-for-google, or install through the WordPress plugins screen. - Activate the plugin through the Plugins screen in WordPress.
- Go to Settings → Preferred Source.
- On the Design tab, choose Custom or Google official, pick a style, set the button text, supporting-text trigger, and devices.
- On the Display tab, turn the button on, choose who sees it, pick content types, and set placement (including post meta, TOC, and sidebar options).
- Save settings. Optional: add
[kmpsbg_preferred_source_button]or the Preferred Source Button block anywhere you want a manual copy.
屏幕截图:
常见问题:
What is a Google Preferred Source?
Preferred Sources is a Google Search feature that allows users to select websites and publications they want to see more content from in eligible Google Search experiences.
What does this plugin do?
It makes it easy to add a Preferred Source button to your WordPress website. Visitors can click the button and proceed to Google to add your website as a preferred source.
Does this register my site with Google?
No. It builds the google.com/preferences/source link for your domain, matching the format Google documents for site owners. Whether your site can be selected depends on Google's own criteria.
Does the plugin include the official Google button?
Yes. You can use the official Google Preferred Sources button design or choose from 40+ unique custom button styles.
Can I customize the button design?
Yes. Custom designs can be personalized with button text, site name, colors, background, border, font size, corner radius, Google icon visibility, and supporting text. A live preview shows the result before you publish.
Where can I display the button?
You can automatically display the button at the top, middle, or end of an article, below the post meta, near the table of contents, in the sidebar, above comments, or as a floating button. You can also place it manually using the shortcode, block, or widget.
How do I put it under the post meta, table of contents, or in the sidebar?
On the Display tab, tick one or more of: Below the post meta, Above the table of contents, Below the table of contents, Sidebar, below Share this article, End of the sidebar. The plugin finds the author line, TOC, and share box automatically. You do not need a CSS selector.
Can I show the button only on specific posts or pages?
Yes. You can control where the button appears by content type, enable or disable it for individual posts, and exclude specific posts, pages, or categories.
How do I show the button on every post?
Turn Show the button on your site on, choose All posts, tick Post (and any other types), pick at least one placement, then save.
How do I show the button on only some posts?
Choose Choose per post. Open a post, find the Preferred Source Button box in the editor sidebar, set Show on this post to Enable, then update.
How do I hide it on one post or page?
Under Exclude specific posts and pages, enter that item's ID only. Example: 1000 hides post 1000 and nothing else. Find the ID in the editor URL (post=1000). You can also tick a category to hide every post in that category.
Can I control the button on mobile and desktop?
Yes. Automatic placements can be shown on mobile and desktop, desktop only, or mobile only. With Mobile and desktop you can set a different button name and supporting-text trigger for each.
Is there a shortcode?
Yes. Use [kmpsbg_preferred_source_button] anywhere shortcodes are supported.
Can I add supporting text around the button?
Yes. You can add optional supporting text above or below the button. Choose Always visible, On hover, or Info icon (i). Hover and icon use a square tooltip with an arrow and no border.
Can I use a floating Preferred Source button?
Yes. The plugin includes a floating button that can stay visible while users scroll. You can choose its corner position and configure it to appear immediately, after a specific scroll percentage, or after a time delay.
Does scroll or delay hide in-content buttons?
No. Scroll percentage and time delay apply only to the floating corner button.
Can I change the button's destination domain?
Yes. By default it uses your site's own domain. Override it in Settings if needed (for example on a staging or subdomain setup).
Does adding the button improve my Google rankings?
No. Using the plugin or being selected as a Preferred Source does not guarantee higher search rankings, increased traffic, or visibility in Google Search.
Is this plugin affiliated with Google?
No. KudoMetrics Preferred Source Button for Google is an independent WordPress plugin and is not affiliated with, endorsed by, or sponsored by Google. Google and related trademarks belong to their respective owners.
Does it work with caching plugins?
When you save settings, the plugin tries to clear page caches from WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, and similar plugins if they are installed.
What happens if I deactivate or uninstall the plugin?
Deactivating keeps your settings. Uninstalling deletes plugin settings, widget settings, and per-post enable/disable data.
更新日志:
- Fix: Prevented nested form submission conflicts on admin settings bulk actions.
- Fix: Improved custom CSS selector saving and JSON synchronization in settings.
- Fix: Allowed wildcard (*) characters in custom CSS selector validation.
- Fix: Enhanced button placement detection for themes with hero/slide sections and Genesis child themes.
- Fix: Cleaned up legacy placement settings flags.
- Moved settings-page admin CSS from inline style to assets/css/admin.css (Plugin Check).
- Moved settings-page admin JavaScript from inline script to assets/js/admin.js (Plugin Check).
- Bulk post actions now use POST via admin-post.php instead of GET links.
- Added post revision/autosave guard on per-post meta save.
- Block editor script translations, directory index.php files, and minor Plugin Check fixes.
- Renamed to KudoMetrics Preferred Source Button for Google (slug: kudometrics-preferred-source-button-for-google).
- Prefixed functions, options, shortcode, block, and script handles with
kmpsbg_(6 characters). - Documented Google external services in readme (Terms of Service and Privacy Policy links).
- Fixed admin bulk-action URLs to use the new settings page slug.
- Internal development release.
- Text domain and plugin folder slug are now
preferred-source-button-for-google(does not start with “google”).
- Plugin name and WordPress.org listing copy: Preferred Source Button for Google.
- Readme documents the official Google button, 40+ styles, how it works, and display controls.
- Load front-end CSS/JS only when the plugin is on, and load the info-icon script only when that trigger is used.
- Added uninstall cleanup and a safe deactivation hook.
- Stronger Google disclaimer in settings, readme, and license.txt.
- Plugin Check: verify bulk-action nonce before reading request data, set a version on Google’s publisher script, and match the readme plugin name to the plugin header.
- Hardened input sanitization, output escaping, nonce checks, and capability checks for WordPress.org review.
- Site name in hero buttons stays extra-bold on the front end, matching the settings preview (theme CSS can no longer flatten it).
- Hero cards wrap at about 300px so the label sits on two lines next to the Google G.
- Hover / info-icon tooltip has no border. The box and arrow use fill and shadow only.
- Below-post-meta placement stays a compact button width instead of stretching across the full header.
- New placement: Below the post meta (under author, last updated, and read time). Found automatically — no CSS selector.
- Removed the grey strip that appeared between the button and the tooltip on hover.
- Mobile tooltip stays inside the column without clipping.
- Info (i) icon is bolder.
- Hero cards stay compact so the label wraps onto two lines next to the Google G.
- Info (i) icon sits 8px beside the button instead of being pushed to the far right.
- Info icon matches a circled “i”. Tooltip is a square box with an arrow (Forbes-style).
- Choose Tooltip background on the Design tab. Label color switches automatically for contrast.
- TOC and sidebar placements no longer ask for a CSS selector.
- New options: Above the table of contents, Below the table of contents, Sidebar below Share this article, End of the sidebar.
- Desktop only / Mobile only hides the extra mobile (or desktop) copy card. Two columns appear only for Mobile and desktop.
- Devices, supporting-text triggers, and live Desktop / Mobile preview live on the Design tab.
- Hero Google G icon is 24×24 with tighter padding.
- Separate desktop and mobile button name, supporting text, and always / hover / info-icon trigger.
- New placements: below the table of contents, sidebar below Share this article, below the featured image, after the first heading, and above comments.
- Supporting text can show always, on hover, or from an info (i) icon beside the button.
- Moved Devices and bulk actions to the Placement column on the Display tab.
- Clearer exclude fields for specific post IDs and page IDs.
- Device targeting for automatic placements.
- Floating button scroll and delay triggers.
- Category and ID exclusions for automatic placements.
- Purge popular page caches when settings are saved.
- Style names describe the look instead of publisher brands.
- Visibility and Placement combined on the Display tab.
- Added compact pill, bordered card, and gradient card button styles.
- Added a {site_name} merge tag for button text and optional supporting text.
- Added a second color option for gradient styles.
- Added Google-style light and dark badge designs.
- Added automatic placement: post header, mid-content, and post footer.
- Added a sidebar widget.
- Initial release: shortcode, Gutenberg block, floating button, and settings page.