=== Snappy Post Word Count ===
Contributors:      snappyplugins
Tags:              word count, content, posts, admin, column
Requires at least: 5.0
Tested up to:      7.0
Stable tag:        1.0.0
Requires PHP:      7.2
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Lightweight sortable word count column for your posts list. See exactly which posts need more content, right in your WordPress admin.

== Description ==

Snappy Post Word Count adds a sortable "Words" column to your WordPress posts list so you can instantly spot which posts are too short and need expanding — without opening each one individually.

**Features:**

* Sortable "Words" column sits just before the Date column
* Toggleable via Screen Options like any native WordPress column
* Word counts are cached as post meta for fast, reliable sorting
* Automatically recalculates on every save
* Strips Gutenberg block markup for an accurate count
* Works with non-Latin character sets
* Zero configuration — activate and it just works

== Installation ==

1. Upload the `snappy-post-word-count` folder to the `/wp-content/plugins/` directory, or install via Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins screen in WordPress.
3. Visit Posts > All Posts — the Words column appears automatically, no configuration needed.

== Usage ==

**The plugin works immediately on activation. No settings page, no configuration required.**

1. Go to **Posts > All Posts** in your WordPress admin.
2. A new **"Words"** column will appear automatically in the posts list, just to the left of the Date column.
3. Each row displays the word count for that post.
4. Click the **"Words"** column header to sort all posts by word count, ascending or descending.
5. To hide the column, click **Screen Options** at the top right of the Posts screen and uncheck "Words". You can re-enable it the same way at any time.

**Note on existing posts:** Word counts are stored as post meta when a post is saved. For posts that existed before the plugin was activated, the count is calculated and cached automatically the first time the Posts list is loaded. After that first page view, sorting works correctly for all posts.

== Frequently Asked Questions ==

= Where do I find the word count column? =

Go to Posts > All Posts in your WordPress admin. The Words column appears automatically between the Categories and Date columns. There is no settings page — the plugin works as soon as it is activated.

= The column isn't showing — what do I do? =

Click "Screen Options" at the top right of the Posts screen and make sure "Words" is checked.

= Does this work with custom post types? =

The column currently appears on the standard Posts list. Support for custom post types may be added in a future release.

= Why do some posts show 0 after first activation? =

Word counts are stored as post meta when a post is saved. For posts created before the plugin was activated, the count is calculated automatically the first time the posts list is loaded. After that first page view, sorting works correctly for those posts too.

= Will this slow down my site? =

No. The plugin only runs in wp-admin on the posts list screen. It adds no code or queries to your public-facing site.

== Screenshots ==

1. The Words column displayed in the Posts list, just before the Date column.
2. Clicking the Words column header sorts all posts by word count.
3. The Words checkbox in Screen Options allows you to show or hide the column.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
