TrueSift Ad Detect

By webdigitech

0+ active installationsVersion 1.0.5

Privacy-conscious AdBlock detection and lightweight content protection for WordPress powered by TrueSift.

Description

TrueSift Ad Detect helps publishers respond to ad blocking without turning the website into a wall. It checks the browser quietly and gives you control over what happens only when blocking is confidently confirmed.

Choose the experience that fits your site:

  • Show a friendly reminder banner and let visitors continue.
  • Redirect confirmed detections to your own information or support page.
  • Use the browser event to build a completely custom front-end experience.
  • Discourage casual copying with independent right-click and copy controls.
  • Keep copying available while automatically adding the current page URL as the source.

The banner can be matched to your website with light, dark or custom colors, adjustable width, corner radius, typography, six placement options and independent left, center or right alignment for its action buttons. Its message and actions occupy separate rows so longer text can use the available banner width; on small screens it fits the viewport and scrolls if the text exceeds the screen height. A live preview in the WordPress admin helps you see the result before saving.

TrueSift uses a fail-open approach. Only a confirmed blocked result triggers the action you selected. clear, limited, unknown, invalid responses and scanner or network failures allow the visitor to continue normally.

The Scanner V2 runtime is loaded locally from the plugin. Only the public probe resources are requested from the TrueSift scanner service.

TrueSift Ad Detect does not create a detection history in WordPress. If a visitor dismisses the optional reminder banner, only the reminder expiry is stored in browser localStorage. Content protection runs locally in the browser and does not send copied content to TrueSift. A hidden banner and local scanner script are included on public pages so a cached page can still respond when detection is switched on. The browser checks the current WordPress settings through a same-site request before scanning; disabled detection makes no TrueSift probe requests.

TrueSift Ad Detect is Made in Germany by WebDigiTech.

Product page: https://truesift.de/adblock-check?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=truesift_ad_detect&utm_content=product_page
TrueSift: https://truesift.de?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=truesift_ad_detect&utm_content=truesift_website
WebDigiTech: https://webdigitech.de?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=truesift_ad_detect&utm_content=webdigitech_brand

External service

AdBlock detection is disabled by default. When a WordPress administrator enables detection, the visitor browser contacts the public TrueSift scanner service at https://ad-detect.truesift.de to request neutral and ad-specific probe resources. These requests are necessary for the AdBlock detection feature.

Like ordinary web requests, the scanner service processes standard connection metadata such as the visitor IP address and HTTP request headers. The WordPress plugin does not send a WordPress user account, site secret, management token, form content or detection history to the scanner service.

Privacy policy: https://truesift.de/datenschutz?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=truesift_ad_detect&utm_content=privacy_policy

Privacy

When detection is enabled, the browser requests probe resources from the public TrueSift scanner service. Standard network metadata is processed by that service as part of normal HTTP delivery. See https://truesift.de/datenschutz?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=truesift_ad_detect&utm_content=privacy_policy for details.

The plugin stores only administrator configuration and a plugin cache version in WordPress. A dismissed banner stores its reminder expiry only in browser localStorage. The browser requests current public feature flags through the site’s WordPress AJAX endpoint, using the logged-in session when present. This request sends no copied content, detection results or scanner probes. Content protection settings act locally in the browser. If source attribution is enabled, the current page URL is added to the clipboard locally; copied content is not sent to TrueSift.

Development

The source code and build tooling for the JavaScript scanner distributed
with this plugin are publicly available at:

https://gitlab.com/webdigitech-wordpress/truesift-scanner-js

Scanner release tags correspond to the scanner versions distributed with
this WordPress plugin.

The distributed scanner artifact is accompanied by
assets/js/truesift-scanner.v2.0.0.manifest.json, which records the scanner
version, public API version, bundle format, JavaScript target and SHA-256 of
the exact JavaScript artifact included with this plugin.

Installation

  1. Upload the truesift-ad-detect folder to /wp-content/plugins/ or install the ZIP through Plugins > Add Plugin.
  2. Activate TrueSift Ad Detect.
  3. Open TrueSift Ad Detect > Detection.
  4. Choose how your site should respond when blocking is confirmed.
  5. Open Content Protection if you want to control right-click, copying or source attribution.
  6. Open Appearance to match the banner to your website and preview its position and width.
  7. Enable detection when you are ready.

FAQ

Does TrueSift block a visitor when it is not sure?

No. Only a confirmed blocked result is authoritative. limited, unknown, invalid results and scanner failures fail open, so the visitor continues normally.

Can I keep the reminder subtle?

Yes. The built-in banner is non-blocking. You can adjust its colors, width, position, typography and reminder period, or use your own front-end integration instead.

Does the plugin store detected visitors in WordPress?

No. Version 1.0.5 does not create a detection log and does not store visitor IP addresses, user agents or detection results in the WordPress database.

Do administrators have to turn off content protection while editing the site?

No. Users who can manage WordPress options bypass the right-click, copy and source-attribution controls on public pages. Other visitors follow the saved settings.

What if a page cache serves an older copy after a setting changes?

Before acting, the public scripts request the current setting state from WordPress. If that request fails, detection and content protection remain inactive for that page view. Pages generated by version 1.0.4 include a hidden banner and the local scanner script even when detection is disabled, so a later change to enabled can take effect on cached HTML. On a settings change or upgrade, the plugin also clears the WP-Optimize page cache when WP-Optimize is available. Clear every external page cache or CDN once after upgrading from older versions to replace HTML that does not include these assets.

Do I have to fill in all banner message and button fields?

No. Empty fields use translated default text; placeholders in the administrator form do not need to be saved.

Does the plugin create cookies?

No. If the optional reminder banner is dismissed, only an expiry timestamp is stored in browser localStorage.

Can developers build their own UI?

Yes. Choose the custom integration option and listen for the browser event truesift:ad-detect-result. Its event detail contains the validated Scanner V2 result.

Can TrueSift stop every possible way of copying content?

No. Right-click and copy controls discourage casual copying in the browser, but they are not DRM. Content that has already been delivered to a visitor browser can still be accessed by a determined user.

What happens when source attribution is enabled?

When copy blocking is off, copied page text can receive a short Source: line with the canonical URL of the current page. The clipboard update happens locally in the browser and is not sent to TrueSift or stored in WordPress.

Is the scanner loaded from a CDN?

No. The Scanner V2 runtime is a local plugin asset. Only probe resources are requested from the TrueSift scanner service.

Screenshots

Changelog

1.0.5

  • Added independent left, center and right alignment for the banner action buttons under Appearance, with a live preview.
  • Applied the saved alignment through the current WordPress setting, including on cached pages generated by this version.
  • Added Bulgarian and German translations for the new setting and used versioned admin and public assets to refresh cached styles and scripts.

1.0.4

  • Include a hidden banner and local scanner script on public pages even when detection is off; the current same-site setting still controls whether scanning runs.
  • Apply current message, button labels, behavior and appearance from WordPress before showing a banner so cached HTML does not retain old choices.
  • Use versioned asset filenames for the public stylesheet and controller to avoid browser caches serving the previous layout after an update.

1.0.3

  • Give the banner title, description and reminder note the available text width, with the action buttons on a separate row.
  • Keep long messages usable on narrow or short screens with wrapping and a viewport-height limit.
  • Match the admin preview to the new banner layout and strengthen the primary button style against conflicting theme rules.

1.0.2

  • Check current WordPress settings before scanning or activating content protection, even when an older public page is served from cache.
  • Fail open when the same-site settings check cannot complete.
  • Bypass right-click, copy and source-attribution controls for users with permission to manage WordPress options, including on cached public pages.
  • Clear the WP-Optimize page cache after settings changes and on the first administrator visit after upgrading, when WP-Optimize is available.

1.0.1

  • Added the Scanner V2 release manifest and public source/build reference for release transparency.
  • Added an independent Content Protection section in the WordPress admin.
  • Added optional right-click context-menu blocking for public page content.
  • Added optional copy blocking for public page content while keeping editable form controls usable.
  • Added optional source attribution that appends the canonical current-page URL when copying is allowed.
  • Kept all content-protection behavior local to the visitor browser without server-side logging or external content transfer.
  • Added English, German and Bulgarian interface text for the new controls.

1.0.0

  • First public TrueSift Ad Detect release.
  • Added TrueSift Scanner V2.0.0 as the sole detection engine.
  • Added fail-open handling for uncertain results and scanner failures.
  • Added friendly banner, redirect and custom-integration behaviors.
  • Added configurable visitor messaging and reminder period.
  • Added light, dark and custom appearance styles.
  • Added live banner preview, six placement options and adjustable banner width.
  • Added local browser reminder state without cookies or server-side visitor logs.
  • Added English source strings with German and Bulgarian translations.
  • Added WordPress privacy-policy helper content and clean uninstall handling.