=== Craftengineer Article Highlights Box ===
Contributors: wpcraftengineer
Tags: summary, content, articles, posts, insights
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a lightweight article insight box at the top of WordPress blog posts.

== Description ==

Craftengineer Article Highlights Box helps readers quickly understand the value of an article by adding a simple insight box above single blog post content.

The box includes:

* Key takeaway
* Why this matters
* What to do next

Admins can enable or disable automatic insertion and edit the default section headings from Settings > Craftengineer Article Highlights Box.

The plugin is PHP-only, lightweight, theme independent, and uses the WordPress `the_content` filter.

== Installation ==

1. Upload the `craftengineer-article-highlights-box` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to Settings > Craftengineer Article Highlights Box.
4. Enable or disable auto insertion and update heading labels as needed.

== Per Post Customization ==

You can override the generated text for any post using custom fields.

Add these custom field keys to a post:

`_crafarhi_key_takeaway`
`_crafarhi_why_matters`
`_crafarhi_next_step`

Example values:

`_crafarhi_key_takeaway` - This article explains how summaries improve reader engagement.
`_crafarhi_why_matters` - Readers can decide quickly whether the article is useful.
`_crafarhi_next_step` - Use the tips from this article on your next blog post.

== Frequently Asked Questions ==

= Does this plugin use JavaScript? =

No. This proof of concept is PHP-only.

= Where does the box appear? =

It appears at the top of single blog posts when auto insertion is enabled.

= Can I change the headings? =

Yes. Go to Settings > Craftengineer Article Highlights Box and edit the heading labels.

== Screenshots ==

1. Admin settings page for configuring the Craftengineer Article Highlights Box, including general settings, placement, headings, and display options.
2. Post editor view showing how article highlights can be added and managed while editing a blog post.
3. Frontend preview of the Article Highlights Box using the default highlighted style above the blog post content.
4. Frontend preview of an alternative bordered Article Highlights Box style displayed within the blog post.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial proof of concept release.
