38cdebd0c6
Initial import of the bdmurphy Bookshelf work: the bd-bookshelf theme, bd-bookshelf-plugin, bd-bookshelfhelper and bd-simpleemail plugins, plus the specification documents, mockups and release archives.
74 lines
2.3 KiB
Plaintext
74 lines
2.3 KiB
Plaintext
# 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
|