# BD SimpleEmail

**Contributors:** B.D. Murphy  
**Tags:** email, newsletter, subscribers, mailing list  
**Requires at least:** WordPress 6.0  
**Tested up to:** WordPress 6.4  
**Requires PHP:** 7.4  
**License:** GPL v2 or later  
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html  

Email newsletter management with AI-assisted composition using Gemini API and subscriber management.

## Description

BD SimpleEmail provides comprehensive email newsletter capabilities:

- **Subscriber Management:** Add, remove, and manage email subscribers
- **AI-Assisted Writing:** Generate newsletter drafts using Gemini AI
- **Gmail SMTP:** Send newsletters via your Gmail account
- **One-Click Unsubscribe:** Compliant with Gmail/Yahoo requirements
- **CAN-SPAM Compliance:** Automatic business information in email footers
- **Shortcode Support:** `[bdm_signup]` for embeddable signup forms

## Installation

1. Upload the `bd-simpleemail` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure Gmail settings under BD SimpleEmail > Settings

## Configuration

### Gmail Setup

1. Enable 2-Factor Authentication on your Google account
2. Generate an App Password: https://support.google.com/accounts/answer/185833
3. Enter your Gmail address and App Password in plugin settings

### Gemini AI (Optional)

1. Get an API key: https://makersuite.google.com/app/apikey
2. Enter the API key in plugin settings

### Business Information

Configure your business address in Appearance > Theme Options (required for CAN-SPAM compliance).

## Sending Newsletters

1. Go to BD SimpleEmail > New Newsletter
2. Enter a subject line
3. (Optional) Use AI to generate content
4. Write or edit your newsletter
5. Click "Send Newsletter"

## Shortcodes

Use `[bdm_signup]` to display a signup form anywhere on your site.

## Frequently Asked Questions

### Do I need to use Gmail?
Yes, this plugin uses Gmail SMTP for sending. App passwords are required.

### Is AI required?
No, AI assistance is optional. You can write newsletters manually.

### Is one-click unsubscribe included?
Yes, all emails include one-click unsubscribe links compliant with Gmail/Yahoo requirements.

## Changelog

### 2.0.0
- Initial release with subscriber management, AI composition, and Gmail SMTP sending
