=== Spam Word Blocker ===
Contributors: kumarharshit
Tags: spam word, spam word filter, spam publish blocker, spam word blocker, block spa word
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 1.1.0
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Prevent posts/pages from being published if they contain unwanted or spam words. Shows instant popup with blocked words.

== Description ==

Spam Word Blocker is a lightweight, WordPress policy-compliant plugin that prevents publishing of any post, page, or custom post type if the content contains unwanted words defined by the admin.

= Key Features =

* **Instant Popup Alert** - Shows exactly which blocked words were found
* **Works for ALL Post Types** - Automatically covers posts, pages, and custom post types
* **Lightweight** - Only runs during publish events, zero background load
* **Server-Side Enforcement** - Cannot be bypassed
* **Beautiful Admin UI** - Clean white and green premium design
* **WordPress Policy Compliant** - Proper escaping, sanitizing, and nonces
* **Case-Insensitive Matching** - Smart word-boundary detection

= How It Works =

1. Admin adds blocked words/phrases (one per line) in plugin settings
2. When user clicks Publish, plugin scans title, content, and excerpt
3. If blocked words found:
   - Instant popup shows which words are blocked
   - Post is saved as draft automatically
   - Admin notice displays after page reload
4. User removes blocked words and republishes successfully

= Perfect For =

* Content moderation
* Preventing accidental spam content
* Multi-author sites
* Guest post management
* Adult content filtering
* Brand protection

== Screenshots ==

1. screenshot-1.png - Main Dashboard with Spam Word Blocker.
2. screenshot-2.png - Blocked words found Realtime popup

### Automatic Installation

1. Log in to your WordPress admin panel
2. Go to **Plugins > Add New**
3. Search for "Spam Word Blocker"
4. Click **Install Now** and then **Activate**
5. Go to **Spam Word Blocker** in your admin menu to start

### Manual Installation

1. Download the plugin zip file
2. Go to **Plugins > Add New > Upload Plugin**
3. Choose the downloaded zip file and click **Install Now**
4. Activate the plugin
5. Go to **Spam Word Blocker** in your admin menu

== Frequently Asked Questions ==

= Does it work for custom post types? =

Yes! It automatically works for all post types without any configuration.

= Will it slow down my site? =

No. The plugin only runs when someone clicks the Publish button. It has zero impact on page load times.

= Can users bypass this? =

No. The plugin enforces blocking on the server-side, so it cannot be bypassed.

= Does it support multi-word phrases? =

Yes! You can block multi-word phrases like "adult content" or "free casino".

= What happens to the post when blocked? =

The post is automatically saved as a draft, and the user sees a popup and admin notice showing which words were blocked.

== Changelog ==

= 1.1.0 =
* NEW: Instant popup modal showing blocked words
* IMPROVED: Simplified code structure for better performance
* IMPROVED: Full WordPress policy compliance (escaping, sanitizing, nonces)
* IMPROVED: Better UX with clear blocked word display
* IMPROVED: Cleaner admin interface

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.1.0 =
Major improvement! Now shows instant popup with blocked words for better user experience.

== Credits ==

Developed by Harshit Kumar - https://kumarharshit.in