Add as Preferred Source on Google

Beskriuwing

Add as Preferred Source on Google plugin displays a banner and inline button on your website that directs visitors to Google’s preferred sources feature. When clicked, the banner takes users to Google’s preferences page where they can add your site as a preferred source for their personalized search results.

What it does:

• Displays a customizable banner on your website
• Links to Google’s preferred sources feature
• Allows users to set your site as a preferred source in their Google Search settings
• Provides banner customization options (colors, text, position)
• Includes device-specific display controls
• Controls exactly where the banner appears with Display Rules (all pages, posts only, pages only, or front page only)
• Excludes specific categories or individual posts/pages from showing the banner
• Triggers the banner immediately on page load, after the visitor scrolls a set percentage, or after a time delay
• Tracks impressions, clicks, and dismissals with a built-in 30-day analytics dashboard

About Google Preferred Sources:

Google’s preferred sources is a feature that allows users to indicate which sources they want to see more of in their search results. This is a Google feature, not affiliated with this plugin. Users who add your site as a preferred source may see your content more frequently in their personalized search results.

DISCLAIMER: This plugin is not associated with Google and was created to help website owners make a banner and inline card for adding their sites to Google’s Preferred Source. The term “Google” is used solely to convey the plugin’s function, and we are not related to Google in any way.

Plugin Features:

• Customizable banner text with website name variable
• Color customization for background and text
• Position control (top or bottom of page)
• Device-specific display (mobile, desktop, or both)
• Cookie-based dismissal (banner stays hidden for 7 days after user closes it)
• Responsive design
• Translation ready
• Display Rules — show the banner everywhere, on posts only, pages only, or the front page only; exclude specific categories or individual post/page IDs
• Display Trigger — show immediately on page load, after the visitor scrolls a configurable percentage of the page (10–90%), or after a set time delay (1–60 seconds)
• Click-Through Analytics Dashboard — view 30-day impressions, clicks, dismissals, and click rate with a visual bar chart directly in the admin

Technical Requirements:

• WordPress 5.0 or higher
• PHP 7.2 or higher
• Modern web browser with JavaScript enabled

Configuration

After installation, go to Settings > Add as Preferred Source in your WordPress admin to configure the plugin.

Step 1: Basic Settings

• Enable Banner: Check this box to activate the banner on your website. The banner will not appear until this is enabled.

• Website Name: Enter your website or publication name. This defaults to your WordPress site title but can be customized. This name will replace the {website_name} placeholder in your banner text.

• Banner Text: Customize the message displayed to visitors. Default text is “Add as a preferred source on Google”. You can use the placeholder {website_name} anywhere in your text, and it will be automatically replaced with the website name you specified above.

  • Example: “Add {website_name} as your preferred source on Google”
  • Example: “Get more content from {website_name} – add us as a preferred source”

• Banner Position: Choose where the banner appears on your website:

  • Top: Banner appears at the top of the page, above all content
  • Bottom: Banner appears at the bottom of the page (recommended for better user experience)

Step 2: Appearance Customization

• Banner Background Color: Click the color picker to choose a background color that matches your website design. Default is dark gray (#1a1a1a).

• Text Color: Select the color for the banner text and close button. Ensure good contrast with your background color for readability. Default is white (#ffffff).

Step 3: Display Options

• Show on Mobile: Check this box to display the banner on mobile devices (phones and tablets).

• Show on Desktop: Check this box to display the banner on desktop computers and laptops.

You can enable both, or choose to show the banner only on specific device types based on your audience preferences.

Step 4: Save and Test

1. Click Save Changes to apply your settings
2. Visit your website to see the banner in action
3. Click the banner to test the Google redirect functionality
4. Use the close (×) button to test the dismissal feature

Testing Tips:
* Clear your browser cache and any server/plugin caches after making changes
* Test in incognito/private browsing mode to see the banner fresh
* Add a parameter to your URL (e.g., ?test=1) to bypass cache
* Check on different devices based on your display settings
* The banner will stay hidden for 7 days after a user closes it

Preview Feature:
The settings page includes a live preview that updates as you modify colors, text, and position. This helps you see how the banner will look before saving changes.

Step 5: Display Trigger

Control when the banner appears to a visitor:

• Immediately on page load — the banner shows as soon as the page finishes loading (default behaviour).
• After user scrolls — the banner only appears once the visitor has scrolled a set percentage of the page. You can choose any value between 10% and 90% in 5% increments. Useful for keeping the banner out of the way until the reader is engaged with your content.
• After a time delay — the banner waits a number of seconds (1–60) before appearing. This lets visitors settle in before the prompt is shown.

Step 6: Display Rules

Target exactly which pages show the banner:

• Everywhere — the banner appears on all pages and posts across your site (default).
• Posts only — restricts the banner to single post pages.
• Pages only — restricts the banner to static WordPress pages.
• Front page only — shows the banner exclusively on your site’s home/front page.

You can further refine visibility with two exclusion options:

• Exclude Categories — search for and select any categories whose posts should never show the banner. The picker supports live search so you can find categories quickly without loading a long list.
• Exclude Post/Page IDs — enter a comma-separated list of post or page IDs to suppress the banner on specific pieces of content.

Step 7: Analytics Dashboard

Open the Analytics tab on the settings page to view banner performance over the last 30 days:

• Impressions — how many times the banner was displayed to visitors.
• Clicks — how many visitors clicked through to the Google preferences page.
• Dismissals — how many visitors closed the banner without clicking.
• Click Rate — the percentage of impressions that resulted in a click (clicks ÷ impressions).

A colour-coded bar chart shows the daily breakdown of all three metrics so you can spot trends at a glance. Data is stored locally in your WordPress database and requires no third-party services.