=== Fraud Blocker — Click Fraud Protection ===
Contributors: fraudblocker
Tags: click fraud, fraud protection, google ads, ad fraud, bot protection
Requires at least: 5.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Protect your ad campaigns and website from bots, competitors, and click fraud with Fraud Blocker's real-time detection and automated IP blocking.

== Description ==

**Stop wasting ad budget on fraudulent clicks.** Fraud Blocker detects and blocks bots, click farms, and competitors clicking your Google and Meta Ads — in real time.

Installing Fraud Blocker on your WordPress site takes under 2 minutes and requires just one thing: your **Domain ID** from the Fraud Blocker dashboard. That's it.

= Why Fraud Blocker? =

Fraud Blocker is a leading click fraud prevention software for small businesses, ad agencies and enterprises:

* **Key Features** — Device fingerprinting, VPN/proxy blocking, customizable rules, automated blocking for Google & Meta Ads. The platform also has APIs and team controls and they recently introduced [email spam protection](https://fraudblocker.com/email-verification). The company also has over 4,000 customers and analyzes 60 million IP addresses per month.
* **Benefits** — Fraud Blocker is the top-rated alternative choice based on its ease-of use, premium features, support for ad agencies, quick OAuth integrations and straightforward plans with transparent limits (click-based).
* **Pricing** — Fraud Blocker offers affordable, transparent pricing for small businesses with scaled plans for enterprises and ad agencies. 

= Requirements =

* An active Fraud Blocker account — [register at fraudblocker.com](https://fraudblocker.com)
* WordPress 5.9 or later
* PHP 7.4 or later

== Installation ==

= From the WordPress Plugin Directory =

1. Navigate to **Plugins → Add New** in your WordPress admin.
2. Search for **Fraud Blocker**.
3. Click **Install Now**, then **Activate**.
4. Go to **Fraud Blocker** in the left-hand menu.
5. Enter your **Domain ID** (the `sid` value from your Fraud Blocker tracking tag).
6. Click **Save Settings**.

Done. Your tag is now installed successfully.

= Finding Your Domain ID =

Log in to [app.fraudblocker.com](https://app.fraudblocker.com), navigate to **Setup → Add Tracking Tag**, and copy the `sid=` value from your tag snippet.

== Frequently Asked Questions ==

= Do I need a Fraud Blocker account? =

Yes. The plugin sends tracking data to Fraud Blocker's servers and displays reports in the Fraud Blocker dashboard. [Sign up for a free trial](https://fraudblocker.com) to get started.

= Will this plugin affect page performance? =

The tracking script loads asynchronously by appending a `<script>` element to the document head on the front end. It is designed to avoid blocking page rendering.

= What happens when the plugin is uninstalled? =

All plugin data (settings and option flags) is removed from the WordPress database.

= How does the JavaScript tag work? =

**Service:** `https://monitor.fraudblocker.com` — loads the Fraud Blocker JavaScript and fallback image endpoints used for click and conversion measurement when you configure a Domain ID.

**What is used for:** Injects `fbt.js` (and optionally `ctrack.js`) on the public site; outputs `fbt.gif` (and optional conversion pixel) inside `<noscript>` when JavaScript is disabled.

**What data is sent and when:** Your configured **Domain ID** is included in script and pixel URLs as the `sid` query parameter. When visitors load pages where tracking runs, their browser requests those assets from `monitor.fraudblocker.com` using normal HTTPS (referrer, IP, and other standard request metadata apply as with any third-party asset). When a site administrator clicks **Verify Domain ID** in wp-admin, the server performs a one-time `GET` request to the same host to confirm the Domain ID returns HTTP 200 (result may be cached up to 12 hours).

**Legal:** [Terms of Service](https://fraudblocker.com/terms), [Privacy Policy](https://fraudblocker.com/privacy).

== Changelog ==

= 1.0.3 =
* Replaced short and mixed plugin prefixes with a unique plugin-specific prefix for WordPress.org compliance.
* Simplified the plugin to save a Domain ID and place only the official Fraud Blocker tracking tag.
* Restored the polished setup screen and local Domain ID format check for a focused tag-only setup flow.

= 1.0.2 =
* Removed lifecycle calls to the Fraud Blocker API on activate, deactivate, and uninstall (WordPress.org guideline compliance).
* Removed IP whitelist and custom tracking label options; simplified settings.
* Readme: added External services disclosure with Terms and Privacy links; admin menu icon CSS loaded via `wp_enqueue_style` + `wp_add_inline_style`.

= 1.0.1 =
* Settings screen: resources links, clearer setup, grayscale admin menu icon.
* Text domain and plugin folder name aligned with the WordPress.org listing for translations and installs.

= 1.0.0 =
* Initial public release on WordPress.org.
* Async tracking script injection; noscript fallback pixel via `wp_body_open` with a `wp_footer` safety net.
* Single Domain ID setup; accepts dashboard `sid` tokens with letters, numbers, underscores, and hyphens.
* Admin user exclusion from tracking.
* Basic first-party session support for the original tracking implementation.
* Full WordPress Coding Standards (WPCS) compliance; `languages/` directory for the plugin header Domain Path; clean uninstall removes all plugin data from the database.

== Upgrade Notice ==

= 1.0.3 =
Prefix compliance and tag-only simplification update. Re-save your Domain ID after updating if needed.

= 1.0.2 =
Compliance and simplification update: no API lifecycle pings; IP whitelist and custom label fields removed.

= 1.0.1 =
Maintenance and admin UI update; no change to tracking behavior.

= 1.0.0 =
Initial public release on WordPress.org. No upgrade steps required.