=== AddonLogic Email This Article ===
Contributors: snehalpancholi
Tags: email, share, mailto, email button, share article
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add an 'Email this article' button that opens a prefilled mailto link with the post title and URL.

== Description ==

AddonLogic Email This Article adds a simple, no-tracking "Email this article" button to your posts and pages. When clicked it opens the visitor's email client with a prefilled subject and body — no form, no server, no SMTP. Just a clean `mailto:` link.

**Features:**
* Prefilled email subject and body via template tokens: `{title}`, `{url}`, `{site}`, `{excerpt}`
* Optional inclusion of the post excerpt in the email body
* Three button styles: Filled, Outline, Minimal
* Custom button and text colours (colour picker)
* Optional SVG email icon
* Auto-insert before or after post content (toggle)
* `[email_article]` shortcode — works anywhere
* `[email_article post_id="42"]` for a specific post
* Limit to specific post types
* No JavaScript required — pure HTML link
* No external requests, no tracking

== Installation ==

1. Upload `email-this-article/` to `/wp-content/plugins/`
2. Activate through **Plugins › Installed Plugins**
3. Go to **Settings › Email This Article** and customise the subject, body, and appearance
4. Or use `[email_article]` in any post or page

== Frequently Asked Questions ==

= Does this send emails through WordPress / SMTP? =
No. It generates a `mailto:` link. The visitor's own email client opens and sends the email — no server involved.

= What template tokens can I use? =
`{title}` — post title, `{url}` — post permalink, `{site}` — site name, `{excerpt}` — post excerpt (requires "Include Excerpt" to be enabled).

= Can I show the button for a specific post from a sidebar widget? =
Yes: `[email_article post_id="42"]` replaces the current-post URL with the post whose ID is 42.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
