=== TrueSift Ad Detect ===
Tags: adblock, ad blocker, content protection, copy protection, truesift
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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 and six placement options. 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.

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

== 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.

== Frequently Asked Questions ==

= 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.1 does not create a detection log and does not store visitor IP addresses, user agents or detection results in the WordPress database.

= 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.

== 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 in WordPress. A dismissed banner stores its reminder expiry only in browser localStorage. 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.

== Screenshots ==

1. Overview dashboard with quick access to AdBlock detection, visitor experience, content protection and privacy settings.
2. Detection settings for enabling TrueSift Ad Detect, choosing the visitor response and configuring reminder behavior.
3. Content Protection settings for blocking right-click, blocking copying and optionally adding the current page URL as a source.
4. Appearance settings with configurable banner width, colors and a live preview of the visitor reminder.
5. Privacy & Data overview explaining what stays in WordPress, what remains in the visitor's browser and how the TrueSift probe service is used.

== Changelog ==

= 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.

== Upgrade Notice ==

= 1.0.1 =
Adds optional right-click protection, copy protection and source attribution for copied excerpts.

= 1.0.0 =
First public release of the rebuilt TrueSift Ad Detect WordPress plugin.
