Changeset 3804224
- Timestamp:
- 11/16/2026 05:02:25 AM (32 hours ago)
- Location:
- simply-invent-labs-simply-send
- Files:
-
- 8 edited
-
tags/1.0.8/includes/class-simply-send-admin.php (modified) (1 diff)
-
tags/1.0.8/includes/class-simply-send-settings.php (modified) (2 diffs)
-
tags/1.0.8/readme.txt (modified) (2 diffs)
-
tags/1.0.8/simply-send.php (modified) (1 diff)
-
trunk/includes/class-simply-send-admin.php (modified) (1 diff)
-
trunk/includes/class-simply-send-settings.php (modified) (2 diffs)
-
trunk/readme.txt (modified) (2 diffs)
-
trunk/simply-send.php (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
simply-invent-labs-simply-send/tags/1.0.8/includes/class-simply-send-admin.php
r3804121 r3804224 233 233 <header class="ss-header"> 234 234 <div class="ss-brand"><img src="<?php echo esc_url( SIMPLY_SEND_PLUGIN_URL . 'assets/images/simply-send-logo.png' ); ?>" alt="" width="48" height="48" /><span><?php echo esc_html__( 'Simply Send', 'simply-invent-labs-simply-send' ); ?><small class="ss-publisher"><?php echo esc_html__( 'by Simply Invent Labs', 'simply-invent-labs-simply-send' ); ?></small></span></div> 235 <a class="ss-help" href="https://www.simplysend. email/docs/guide/integrations/wordpress-plugin" target="_blank" rel="noopener noreferrer"><span class="dashicons dashicons-book" aria-hidden="true"></span><span><?php echo esc_html__( 'Setup guide', 'simply-invent-labs-simply-send' ); ?></span><span class="dashicons dashicons-external" aria-hidden="true"></span></a>235 <a class="ss-help" href="https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin" target="_blank" rel="noopener noreferrer"><span class="dashicons dashicons-book" aria-hidden="true"></span><span><?php echo esc_html__( 'Setup guide', 'simply-invent-labs-simply-send' ); ?></span><span class="dashicons dashicons-external" aria-hidden="true"></span></a> 236 236 </header> 237 237 <?php if ( $ready && ! $edit_setup ) : ?> -
simply-invent-labs-simply-send/tags/1.0.8/includes/class-simply-send-settings.php
r3804121 r3804224 13 13 14 14 const OPTION_KEY = 'simply_send_settings'; 15 const API_URL = 'https://tapi.simplysend. email/send';15 const API_URL = 'https://tapi.simplysend.dev/send'; 16 16 17 17 … … 23 23 public static function regions() { 24 24 return array( 25 'us' => array( 'country' => __( 'United States', 'simply-invent-labs-simply-send' ), 'location' => __( 'East', 'simply-invent-labs-simply-send' ), 'flag' => '🇺🇸', 'label' => __( 'United States (East)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://app.simplysend. email', 'api_url' => self::API_URL ),26 'au' => array( 'country' => __( 'Australia', 'simply-invent-labs-simply-send' ), 'location' => __( 'Sydney', 'simply-invent-labs-simply-send' ), 'flag' => '🇦🇺', 'label' => __( 'Australia (Sydney)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://au-app.simplysend. email', 'api_url' => 'https://au-tapi.simplysend.email/send' ),27 'ca' => array( 'country' => __( 'Canada', 'simply-invent-labs-simply-send' ), 'location' => __( 'Central', 'simply-invent-labs-simply-send' ), 'flag' => '🇨🇦', 'label' => __( 'Canada (Central)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://ca-app.simplysend. email', 'api_url' => 'https://ca-tapi.simplysend.email/send' ),28 'eu' => array( 'country' => __( 'Europe', 'simply-invent-labs-simply-send' ), 'location' => __( 'Frankfurt, Germany', 'simply-invent-labs-simply-send' ), 'flag' => '🇪🇺', 'label' => __( 'Europe (Frankfurt)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://eu-app.simplysend. email', 'api_url' => 'https://eu-tapi.simplysend.email/send' ),25 'us' => array( 'country' => __( 'United States', 'simply-invent-labs-simply-send' ), 'location' => __( 'East', 'simply-invent-labs-simply-send' ), 'flag' => '🇺🇸', 'label' => __( 'United States (East)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://app.simplysend.dev', 'api_url' => self::API_URL ), 26 'au' => array( 'country' => __( 'Australia', 'simply-invent-labs-simply-send' ), 'location' => __( 'Sydney', 'simply-invent-labs-simply-send' ), 'flag' => '🇦🇺', 'label' => __( 'Australia (Sydney)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://au-app.simplysend.dev', 'api_url' => 'https://au-tapi.simplysend.dev/send' ), 27 'ca' => array( 'country' => __( 'Canada', 'simply-invent-labs-simply-send' ), 'location' => __( 'Central', 'simply-invent-labs-simply-send' ), 'flag' => '🇨🇦', 'label' => __( 'Canada (Central)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://ca-app.simplysend.dev', 'api_url' => 'https://ca-tapi.simplysend.dev/send' ), 28 'eu' => array( 'country' => __( 'Europe', 'simply-invent-labs-simply-send' ), 'location' => __( 'Frankfurt, Germany', 'simply-invent-labs-simply-send' ), 'flag' => '🇪🇺', 'label' => __( 'Europe (Frankfurt)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://eu-app.simplysend.dev', 'api_url' => 'https://eu-tapi.simplysend.dev/send' ), 29 29 ); 30 30 } -
simply-invent-labs-simply-send/tags/1.0.8/readme.txt
r3804121 r3804224 1 1 === Simply Invent Labs — Simply Send === 2 2 Contributors: simplysend 3 Tags: email, transactional email, api, deliverability, simply send3 Tags: smtp, api, transactional email, simplysend, simply send 4 4 Requires at least: 5.8 5 5 Tested up to: 7.1 … … 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Send WordPress email through the Simply Send transactional API — contact forms, notifications, and plugin mail from your verified domain.11 Send WordPress site email through Simply Send’s transactional API. Connect your site to a verified sender and deliver mail from one selected region. 12 12 13 13 == Description == 14 14 15 This is the official WordPress integration for the Simply Send email service, a product of Simply Invent Labs LLC. It is designed for site owners who already use, or want to use, a Simply Send account for transactional email.15 [Simply Send](https://www.simplysend.dev) is an email delivery platform from [Simply Invent Labs](https://simplyinventlabs.com/). This official WordPress plugin connects your site to the Simply Send transactional API, so messages sent through WordPress `wp_mail` can use your Simply Send account for delivery. 16 16 17 The plugin routes WordPress `wp_mail` messages to the Simply Send transactional HTTPS API using an Account ID and transactional API key. It does not configure a generic SMTP server or offer a choice of third-party mail providers.17 Use it for WordPress notifications, password resets, contact forms, and messages from other plugins that rely on `wp_mail`. Plugins that use their own email provider or bypass `wp_mail` need to be configured separately. 18 18 19 Service-specific features include separate checks for Simply Send company-address, unsubscribe, and report-abuse template markers, encrypted storage of the API key, and recipient/attachment validation that matches the Simply Send public API. This connects WordPress password resets, site notifications, and contact forms that use `wp_mail` to the user's Simply Send account. Plugins that use their own email service need separate configuration.19 **Set up the Simply Send WordPress plugin:** Follow the [plugin setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin) for detailed instructions on connecting your site to Simply Send. 20 20 21 Service publisher: [Simply Invent Labs LLC](https://simplyinventlabs.com/).21 **Looking for SMTP?** This plugin sends through the API and does not configure SMTP. To connect a compatible SMTP plugin, follow Simply Send’s [WordPress SMTP setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress). 22 22 23 Simply Send replaces unreliable PHP `mail()` by routing `wp_mail` through the [Simply Send](https://www.simplysend.email) transactional HTTP API. 23 === Key features === 24 24 25 * Paste a transactional API key + Account ID 26 * Works even when hosts block SMTP ports 27 * Force a verified From address 28 * Adds missing Simply Send compliance placeholders without duplicating existing ones 29 * Send a test email from Settings → Simply Send 25 * Send WordPress site email through the Simply Send transactional API over HTTPS. 26 * Choose the region where your Simply Send workspace is located: 27 * 🇺🇸 United States (East) 28 * 🇦🇺 Australia (Sydney) 29 * 🇨🇦 Canada (Central) 30 * 🇪🇺 Europe (Frankfurt) 31 * Don’t see your region? [Contact us](https://www.simplysend.dev/support) and let us know which region you need. 30 32 31 == External service == 33 * Connect with a transactional API key and Account ID. 34 * Choose a From email address on a verified transactional sending domain and an optional sender name. Optionally use this sender for all site email. 35 * Send a test email from the plugin settings. 36 * Send messages with attachments, subject to your account’s email size limit and approval. 37 * Store the API key encrypted in WordPress options. The plugin does not collect separate telemetry. 32 38 33 This plugin requires a Simply Send account, a transactional API key, and a verified transactional sending domain. Email usage is subject to your Simply Send plan; the plugin does not bill separately.39 One plugin installation connects to one Simply Send region at a time. Select the region that contains your workspace and matches your data residency requirements. API credentials, sender-domain verification, templates, subscriptions, and account limits are region-specific. If you need another region, [contact Simply Send](https://www.simplysend.dev/support). 34 40 35 After you configure and enable the plugin, each intercepted wp_mail call sends the sender and recipient addresses and names, subject, HTML and plain-text message bodies, Reply-To, supported CC/BCC recipients, and any supported attachments over HTTPS to the selected workspace region: https://tapi.simplysend.email/send (United States), https://au-tapi.simplysend.email/send (Australia), https://ca-tapi.simplysend.email/send (Canada), or https://eu-tapi.simplysend.email/send (Europe). Your API key and Account ID are sent as authentication headers. For emails with attachments estimated at 1.5 MiB or larger (including Base64 expansion and message overhead), the plugin first sends file names, types, sizes, and SHA-256 checksums to the selected region’s `/attachments` endpoint. It uploads file bytes to the returned short-lived HTTPS URLs in that region’s Amazon S3 storage, then sends the email with the returned attachment submission reference. API credentials are sent only to the Simply Send API, never to the upload URLs. Sending a test email makes a normal send request. Activation alone does not contact the service. No separate telemetry is collected by this plugin. 41 == Plans and pricing == 36 42 37 Service: https://www.simplysend.email 38 Terms of Service: https://www.simplysend.email/terms 39 Privacy Policy: https://www.simplysend.email/privacy 43 Simply Send offers these plans: 40 44 41 == Delivery limits == 45 * **Free:** Up to 1,000 emails per month. 46 * **Paid:** Plans start at US$5 per month. 47 * **Enterprise:** Custom plans for organizational needs. 42 48 43 * Use either To/CC recipients or BCC recipients, not both in one message. 44 * Attachments require exactly one To recipient, with no CC or BCC. 45 * At most 10 readable local file attachments are supported. Unsupported messages fail before an API request; recipients and attachments are never silently dropped. 46 * OpenSSL with AES-256-GCM is required to save an API key. Older stored keys must be re-entered after upgrading. Changing WordPress authentication salts also requires re-entering the key. 47 * Larger attachments are uploaded automatically above a 1.5 MiB estimated email cutoff. The service enforces your approved message-size limit, up to 40 MB including MIME overhead; this is not a 40 MB file allowance. PHP memory and execution limits can impose lower limits. 48 * API endpoints are fixed per workspace region; custom API URLs and automatic cross-region fallback are not supported. 49 The plugin is free to install; email usage and account limits are determined by your Simply Send plan and selected region. Availability and eligibility can vary by plan and region. 50 51 * [Compare plans and pricing](https://www.simplysend.dev/pricing) 52 * [Estimate costs with the pricing calculator](https://www.simplysend.dev/pricing/calculator) 49 53 50 54 == Installation == 51 55 52 1. After directory approval, install the plugin from Plugins → Add New. For review or manual installation, upload the official ZIP via Plugins → Add New → Upload Plugin. 53 2. Activate **Simply Invent Labs — Simply Send**. 54 3. Choose your workspace region in Settings → Simply Send, then use its dashboard links to create a **transactional API key** and copy your **Account ID**. 55 4. Go to Settings → Simply Send in WordPress and paste the API key, Account ID, and From email. 56 5. Enable Simply Send and send a test email. 56 **Connect your site to Simply Send** 57 58 Choose your workspace region, add your API credentials and verified sender, then complete setup and send a test email. 59 60 1. Install and activate **Simply Invent Labs — Simply Send** from Plugins → Add New. 61 2. In WordPress, open Settings → Simply Send and select the region where your Simply Send workspace is set up. 62 3. Use the dashboard links in the plugin to create a transactional API key and find your Account ID. Use credentials from the same region you selected. 63 4. Enter your API key, Account ID, and a From email address verified for transactional sending in that region. The From name is optional. 64 5. Enable sending, complete setup, and send a test email to an inbox you can check. 65 66 For screenshots and step-by-step instructions, visit the [Simply Send WordPress plugin setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin). 67 68 == Requirements and account limits == 69 70 * WordPress 5.8 or later and PHP 7.4 or later. 71 * A Simply Send account and a transactional API key and Account ID from the selected region. 72 * A verified transactional sending domain and sender address in that region. 73 * Outbound HTTPS access from your WordPress host to the selected region’s API. 74 * OpenSSL with AES-256-GCM support to store the API key securely. 75 76 The default Simply Send limit is 2 MB for the complete email, including message content and attachments. If your emails need to exceed that limit, request approval for a higher limit in the Simply Send User Portal under **Accounts → select your account → Limits**. Your account’s Limits page also shows other sending limits. PHP memory and execution limits may impose a lower practical limit. 77 78 Email usage is billed under your Simply Send account and subscription; the WordPress plugin itself does not provide a subscription. Subscribe in the region where your workspace is located, especially if you have data residency requirements. Switching the plugin’s region changes the API endpoint and dashboard links; enter that region’s credentials and sender details before saving the new setup. 57 79 58 80 == Frequently Asked Questions == 59 81 60 = Do I still need WP Mail SMTP? =82 = What does the plugin do? = 61 83 62 No. This plugin intercepts `wp_mail` and sends via the Simply Send API. Disable other SMTP/email plugins to avoid conflicts.84 When enabled, the plugin routes WordPress `wp_mail` messages through the Simply Send transactional API. This can cover site notifications, password resets, and messages from plugins that use WordPress mail. It does not take over delivery for plugins that use a separate provider or send outside `wp_mail`. 63 85 64 = Wh ere do I pay for email volume? =86 = Which regions are supported? = 65 87 66 In your Simply Send account (workspace plan / usage). The WordPress plugin does not bill separately.88 🇺🇸 United States (East), 🇦🇺 Australia (Sydney), 🇨🇦 Canada (Central), and 🇪🇺 Europe (Frankfurt). One installation connects to one region at a time. Choose the region where your Simply Send workspace and subscription are located, and where your data should be processed. If you need another region, please [contact support](https://www.simplysend.dev/support). 67 89 68 = Why was my email rejected? =90 = Can I use SMTP credentials with this plugin? = 69 91 70 The From address must be on a verified transactional domain, and the API key must be a transactional key with a valid Account ID (`X-Id`).92 No. This plugin uses the transactional HTTP API and requires an API key and Account ID. If you prefer SMTP, use a compatible WordPress SMTP plugin such as WP Mail SMTP or FluentSMTP with Simply Send SMTP credentials. Follow the [WordPress SMTP setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress). 71 93 72 = Can I use my SMTP username and password? =94 = What is the default email size limit? = 73 95 74 No. This plugin uses the HTTP API and requires a transactional API key and Account ID. SMTP credentials are for a separate SMTP mailer integration. 96 The default Simply Send limit is 2 MB for the complete email, including message content and attachments. To request approval for a higher limit or review other sending limits, open the Simply Send User Portal and go to Accounts → select your account → Limits. 97 98 = Where do I manage subscriptions and usage? = 99 100 Subscriptions, billing, and email usage are managed in your Simply Send account, not through WordPress.org. Subscribe to the region where your workspace is located. 101 102 = Why was an email rejected? = 103 104 Check that the selected region matches your workspace and that the API key, Account ID, verified From address, compliance templates, and account limits are correct for that region. See the [setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin) for troubleshooting. 75 105 76 106 = How are compliance placeholders handled? = 77 107 78 The plugin checks the HTML body for {{company_address_html}}, {{unsubscribe_email_html}}, and {{report_abuse_email_html}} separately and adds only the missing placeholders. Simply Send replaces the markers with your configured templates during sending. Configure any required compliance templates in your Simply Send accountbefore sending.108 The plugin checks the HTML body for the Simply Send company address, unsubscribe, and report-abuse template markers, and adds any missing markers. Simply Send replaces these markers using templates configured for your account. Configure any required templates before sending. 79 109 80 110 == Support == 81 111 82 For account setup, API credentials, or delivery questions, visit https://www.simplysend.email/contact. Include the error message and your WordPress and PHP versions. Do not share API keys or passwords in public support posts. 112 Choose the support option that best fits your question: 113 114 * [Simply Send Support](https://www.simplysend.dev/support): Setup guides, FAQs, account questions, and direct support. 115 * [WordPress.org plugin support forum](https://wordpress.org/support/plugin/simply-invent-labs-simply-send/): Questions about installing, configuring, or using the plugin. 116 117 When requesting help, include the error message and your WordPress and PHP versions. Never post API keys, passwords, or message contents publicly. 118 119 == External services == 120 121 This plugin connects to Simply Send, a hosted email delivery service operated by Simply Invent Labs LLC. You need a Simply Send account, a transactional API key, and a verified transactional sending domain. Email usage is subject to your Simply Send subscription and account limits; the plugin does not bill separately. 122 123 After you configure and enable delivery, each intercepted `wp_mail` request sends the sender and recipient addresses and names, subject, HTML and plain-text message bodies, Reply-To, supported CC/BCC recipients, and supported attachments over HTTPS to the endpoint for your selected region: 124 125 * United States: https://tapi.simplysend.dev/send 126 * Australia: https://au-tapi.simplysend.dev/send 127 * Canada: https://ca-tapi.simplysend.dev/send 128 * Europe: https://eu-tapi.simplysend.dev/send 129 130 Your API key and Account ID are sent to the selected Simply Send API as authentication headers. When a message includes attachments, attachment details are sent to the API and file contents are transferred over HTTPS to temporary storage in the selected region for delivery. API credentials are not sent to the file-storage URLs. Your account’s total email size limit applies to messages with attachments. 131 132 Sending a test email makes a normal send request. Plugin activation alone does not contact Simply Send. The plugin collects no separate telemetry. 133 134 * Service: https://www.simplysend.dev 135 * [Terms of Service](https://www.simplysend.dev/terms) 136 * [Privacy Policy](https://www.simplysend.dev/privacy) 137 * [Acceptable Use Policy](https://www.simplysend.dev/legal/acceptable-use) 138 * [Data Processing Addendum](https://www.simplysend.dev/legal/dpa) 139 * [Subprocessors and data processing information](https://www.simplysend.dev/legal/subprocessors) 140 141 == Delivery details == 142 143 * Use either To/CC recipients or BCC recipients, not both in one message. 144 * Attachments require exactly one To recipient, with no CC or BCC, and support up to 10 readable local files. 145 * Unsupported messages fail before an API request; recipients and attachments are not silently dropped. 146 * Email size limits apply to the complete email, including message content and attachments. Review your account’s Limits page for current limits and approval status. 147 * API endpoints are fixed for the selected region. Custom API URLs and automatic cross-region fallback are not supported. 83 148 84 149 == Changelog == 85 150 151 = Contribute to development = 152 153 Contributions are welcome. To work on the plugin: 154 155 1. Clone the [Simply Send WordPress plugin repository](https://github.com/simply-invent-labs/simply-send-wordpress). 156 2. Create a branch for your change and make the update there. 157 3. Run the local regression checks documented in the repository’s README. 158 4. Open a pull request on GitHub describing the change and how you verified it. For larger changes, open an issue first to discuss the approach. 159 160 Do not include API keys, passwords, customer information, or other secrets in code, issues, or pull requests. Please report suspected security vulnerabilities privately through [Simply Send Support](https://www.simplysend.dev/support) instead of posting them publicly. 161 162 = Version history = 163 86 164 = 1.0.8 = 87 * Initialrelease.165 * First release. -
simply-invent-labs-simply-send/tags/1.0.8/simply-send.php
r3804121 r3804224 2 2 /** 3 3 * Plugin Name: Simply Invent Labs — Simply Send 4 * Plugin URI: https://www.simplysend. email/integrations/wordpress4 * Plugin URI: https://www.simplysend.dev/integrations/wordpress 5 5 * Description: Send WordPress email through the Simply Send transactional API — contact forms, notifications, and plugin mail from your verified domain. 6 6 * Version: 1.0.8 -
simply-invent-labs-simply-send/trunk/includes/class-simply-send-admin.php
r3804121 r3804224 233 233 <header class="ss-header"> 234 234 <div class="ss-brand"><img src="<?php echo esc_url( SIMPLY_SEND_PLUGIN_URL . 'assets/images/simply-send-logo.png' ); ?>" alt="" width="48" height="48" /><span><?php echo esc_html__( 'Simply Send', 'simply-invent-labs-simply-send' ); ?><small class="ss-publisher"><?php echo esc_html__( 'by Simply Invent Labs', 'simply-invent-labs-simply-send' ); ?></small></span></div> 235 <a class="ss-help" href="https://www.simplysend. email/docs/guide/integrations/wordpress-plugin" target="_blank" rel="noopener noreferrer"><span class="dashicons dashicons-book" aria-hidden="true"></span><span><?php echo esc_html__( 'Setup guide', 'simply-invent-labs-simply-send' ); ?></span><span class="dashicons dashicons-external" aria-hidden="true"></span></a>235 <a class="ss-help" href="https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin" target="_blank" rel="noopener noreferrer"><span class="dashicons dashicons-book" aria-hidden="true"></span><span><?php echo esc_html__( 'Setup guide', 'simply-invent-labs-simply-send' ); ?></span><span class="dashicons dashicons-external" aria-hidden="true"></span></a> 236 236 </header> 237 237 <?php if ( $ready && ! $edit_setup ) : ?> -
simply-invent-labs-simply-send/trunk/includes/class-simply-send-settings.php
r3804121 r3804224 13 13 14 14 const OPTION_KEY = 'simply_send_settings'; 15 const API_URL = 'https://tapi.simplysend. email/send';15 const API_URL = 'https://tapi.simplysend.dev/send'; 16 16 17 17 … … 23 23 public static function regions() { 24 24 return array( 25 'us' => array( 'country' => __( 'United States', 'simply-invent-labs-simply-send' ), 'location' => __( 'East', 'simply-invent-labs-simply-send' ), 'flag' => '🇺🇸', 'label' => __( 'United States (East)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://app.simplysend. email', 'api_url' => self::API_URL ),26 'au' => array( 'country' => __( 'Australia', 'simply-invent-labs-simply-send' ), 'location' => __( 'Sydney', 'simply-invent-labs-simply-send' ), 'flag' => '🇦🇺', 'label' => __( 'Australia (Sydney)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://au-app.simplysend. email', 'api_url' => 'https://au-tapi.simplysend.email/send' ),27 'ca' => array( 'country' => __( 'Canada', 'simply-invent-labs-simply-send' ), 'location' => __( 'Central', 'simply-invent-labs-simply-send' ), 'flag' => '🇨🇦', 'label' => __( 'Canada (Central)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://ca-app.simplysend. email', 'api_url' => 'https://ca-tapi.simplysend.email/send' ),28 'eu' => array( 'country' => __( 'Europe', 'simply-invent-labs-simply-send' ), 'location' => __( 'Frankfurt, Germany', 'simply-invent-labs-simply-send' ), 'flag' => '🇪🇺', 'label' => __( 'Europe (Frankfurt)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://eu-app.simplysend. email', 'api_url' => 'https://eu-tapi.simplysend.email/send' ),25 'us' => array( 'country' => __( 'United States', 'simply-invent-labs-simply-send' ), 'location' => __( 'East', 'simply-invent-labs-simply-send' ), 'flag' => '🇺🇸', 'label' => __( 'United States (East)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://app.simplysend.dev', 'api_url' => self::API_URL ), 26 'au' => array( 'country' => __( 'Australia', 'simply-invent-labs-simply-send' ), 'location' => __( 'Sydney', 'simply-invent-labs-simply-send' ), 'flag' => '🇦🇺', 'label' => __( 'Australia (Sydney)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://au-app.simplysend.dev', 'api_url' => 'https://au-tapi.simplysend.dev/send' ), 27 'ca' => array( 'country' => __( 'Canada', 'simply-invent-labs-simply-send' ), 'location' => __( 'Central', 'simply-invent-labs-simply-send' ), 'flag' => '🇨🇦', 'label' => __( 'Canada (Central)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://ca-app.simplysend.dev', 'api_url' => 'https://ca-tapi.simplysend.dev/send' ), 28 'eu' => array( 'country' => __( 'Europe', 'simply-invent-labs-simply-send' ), 'location' => __( 'Frankfurt, Germany', 'simply-invent-labs-simply-send' ), 'flag' => '🇪🇺', 'label' => __( 'Europe (Frankfurt)', 'simply-invent-labs-simply-send' ), 'portal' => 'https://eu-app.simplysend.dev', 'api_url' => 'https://eu-tapi.simplysend.dev/send' ), 29 29 ); 30 30 } -
simply-invent-labs-simply-send/trunk/readme.txt
r3804121 r3804224 1 1 === Simply Invent Labs — Simply Send === 2 2 Contributors: simplysend 3 Tags: email, transactional email, api, deliverability, simply send3 Tags: smtp, api, transactional email, simplysend, simply send 4 4 Requires at least: 5.8 5 5 Tested up to: 7.1 … … 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Send WordPress email through the Simply Send transactional API — contact forms, notifications, and plugin mail from your verified domain.11 Send WordPress site email through Simply Send’s transactional API. Connect your site to a verified sender and deliver mail from one selected region. 12 12 13 13 == Description == 14 14 15 This is the official WordPress integration for the Simply Send email service, a product of Simply Invent Labs LLC. It is designed for site owners who already use, or want to use, a Simply Send account for transactional email.15 [Simply Send](https://www.simplysend.dev) is an email delivery platform from [Simply Invent Labs](https://simplyinventlabs.com/). This official WordPress plugin connects your site to the Simply Send transactional API, so messages sent through WordPress `wp_mail` can use your Simply Send account for delivery. 16 16 17 The plugin routes WordPress `wp_mail` messages to the Simply Send transactional HTTPS API using an Account ID and transactional API key. It does not configure a generic SMTP server or offer a choice of third-party mail providers.17 Use it for WordPress notifications, password resets, contact forms, and messages from other plugins that rely on `wp_mail`. Plugins that use their own email provider or bypass `wp_mail` need to be configured separately. 18 18 19 Service-specific features include separate checks for Simply Send company-address, unsubscribe, and report-abuse template markers, encrypted storage of the API key, and recipient/attachment validation that matches the Simply Send public API. This connects WordPress password resets, site notifications, and contact forms that use `wp_mail` to the user's Simply Send account. Plugins that use their own email service need separate configuration.19 **Set up the Simply Send WordPress plugin:** Follow the [plugin setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin) for detailed instructions on connecting your site to Simply Send. 20 20 21 Service publisher: [Simply Invent Labs LLC](https://simplyinventlabs.com/).21 **Looking for SMTP?** This plugin sends through the API and does not configure SMTP. To connect a compatible SMTP plugin, follow Simply Send’s [WordPress SMTP setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress). 22 22 23 Simply Send replaces unreliable PHP `mail()` by routing `wp_mail` through the [Simply Send](https://www.simplysend.email) transactional HTTP API. 23 === Key features === 24 24 25 * Paste a transactional API key + Account ID 26 * Works even when hosts block SMTP ports 27 * Force a verified From address 28 * Adds missing Simply Send compliance placeholders without duplicating existing ones 29 * Send a test email from Settings → Simply Send 25 * Send WordPress site email through the Simply Send transactional API over HTTPS. 26 * Choose the region where your Simply Send workspace is located: 27 * 🇺🇸 United States (East) 28 * 🇦🇺 Australia (Sydney) 29 * 🇨🇦 Canada (Central) 30 * 🇪🇺 Europe (Frankfurt) 31 * Don’t see your region? [Contact us](https://www.simplysend.dev/support) and let us know which region you need. 30 32 31 == External service == 33 * Connect with a transactional API key and Account ID. 34 * Choose a From email address on a verified transactional sending domain and an optional sender name. Optionally use this sender for all site email. 35 * Send a test email from the plugin settings. 36 * Send messages with attachments, subject to your account’s email size limit and approval. 37 * Store the API key encrypted in WordPress options. The plugin does not collect separate telemetry. 32 38 33 This plugin requires a Simply Send account, a transactional API key, and a verified transactional sending domain. Email usage is subject to your Simply Send plan; the plugin does not bill separately.39 One plugin installation connects to one Simply Send region at a time. Select the region that contains your workspace and matches your data residency requirements. API credentials, sender-domain verification, templates, subscriptions, and account limits are region-specific. If you need another region, [contact Simply Send](https://www.simplysend.dev/support). 34 40 35 After you configure and enable the plugin, each intercepted wp_mail call sends the sender and recipient addresses and names, subject, HTML and plain-text message bodies, Reply-To, supported CC/BCC recipients, and any supported attachments over HTTPS to the selected workspace region: https://tapi.simplysend.email/send (United States), https://au-tapi.simplysend.email/send (Australia), https://ca-tapi.simplysend.email/send (Canada), or https://eu-tapi.simplysend.email/send (Europe). Your API key and Account ID are sent as authentication headers. For emails with attachments estimated at 1.5 MiB or larger (including Base64 expansion and message overhead), the plugin first sends file names, types, sizes, and SHA-256 checksums to the selected region’s `/attachments` endpoint. It uploads file bytes to the returned short-lived HTTPS URLs in that region’s Amazon S3 storage, then sends the email with the returned attachment submission reference. API credentials are sent only to the Simply Send API, never to the upload URLs. Sending a test email makes a normal send request. Activation alone does not contact the service. No separate telemetry is collected by this plugin. 41 == Plans and pricing == 36 42 37 Service: https://www.simplysend.email 38 Terms of Service: https://www.simplysend.email/terms 39 Privacy Policy: https://www.simplysend.email/privacy 43 Simply Send offers these plans: 40 44 41 == Delivery limits == 45 * **Free:** Up to 1,000 emails per month. 46 * **Paid:** Plans start at US$5 per month. 47 * **Enterprise:** Custom plans for organizational needs. 42 48 43 * Use either To/CC recipients or BCC recipients, not both in one message. 44 * Attachments require exactly one To recipient, with no CC or BCC. 45 * At most 10 readable local file attachments are supported. Unsupported messages fail before an API request; recipients and attachments are never silently dropped. 46 * OpenSSL with AES-256-GCM is required to save an API key. Older stored keys must be re-entered after upgrading. Changing WordPress authentication salts also requires re-entering the key. 47 * Larger attachments are uploaded automatically above a 1.5 MiB estimated email cutoff. The service enforces your approved message-size limit, up to 40 MB including MIME overhead; this is not a 40 MB file allowance. PHP memory and execution limits can impose lower limits. 48 * API endpoints are fixed per workspace region; custom API URLs and automatic cross-region fallback are not supported. 49 The plugin is free to install; email usage and account limits are determined by your Simply Send plan and selected region. Availability and eligibility can vary by plan and region. 50 51 * [Compare plans and pricing](https://www.simplysend.dev/pricing) 52 * [Estimate costs with the pricing calculator](https://www.simplysend.dev/pricing/calculator) 49 53 50 54 == Installation == 51 55 52 1. After directory approval, install the plugin from Plugins → Add New. For review or manual installation, upload the official ZIP via Plugins → Add New → Upload Plugin. 53 2. Activate **Simply Invent Labs — Simply Send**. 54 3. Choose your workspace region in Settings → Simply Send, then use its dashboard links to create a **transactional API key** and copy your **Account ID**. 55 4. Go to Settings → Simply Send in WordPress and paste the API key, Account ID, and From email. 56 5. Enable Simply Send and send a test email. 56 **Connect your site to Simply Send** 57 58 Choose your workspace region, add your API credentials and verified sender, then complete setup and send a test email. 59 60 1. Install and activate **Simply Invent Labs — Simply Send** from Plugins → Add New. 61 2. In WordPress, open Settings → Simply Send and select the region where your Simply Send workspace is set up. 62 3. Use the dashboard links in the plugin to create a transactional API key and find your Account ID. Use credentials from the same region you selected. 63 4. Enter your API key, Account ID, and a From email address verified for transactional sending in that region. The From name is optional. 64 5. Enable sending, complete setup, and send a test email to an inbox you can check. 65 66 For screenshots and step-by-step instructions, visit the [Simply Send WordPress plugin setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin). 67 68 == Requirements and account limits == 69 70 * WordPress 5.8 or later and PHP 7.4 or later. 71 * A Simply Send account and a transactional API key and Account ID from the selected region. 72 * A verified transactional sending domain and sender address in that region. 73 * Outbound HTTPS access from your WordPress host to the selected region’s API. 74 * OpenSSL with AES-256-GCM support to store the API key securely. 75 76 The default Simply Send limit is 2 MB for the complete email, including message content and attachments. If your emails need to exceed that limit, request approval for a higher limit in the Simply Send User Portal under **Accounts → select your account → Limits**. Your account’s Limits page also shows other sending limits. PHP memory and execution limits may impose a lower practical limit. 77 78 Email usage is billed under your Simply Send account and subscription; the WordPress plugin itself does not provide a subscription. Subscribe in the region where your workspace is located, especially if you have data residency requirements. Switching the plugin’s region changes the API endpoint and dashboard links; enter that region’s credentials and sender details before saving the new setup. 57 79 58 80 == Frequently Asked Questions == 59 81 60 = Do I still need WP Mail SMTP? =82 = What does the plugin do? = 61 83 62 No. This plugin intercepts `wp_mail` and sends via the Simply Send API. Disable other SMTP/email plugins to avoid conflicts.84 When enabled, the plugin routes WordPress `wp_mail` messages through the Simply Send transactional API. This can cover site notifications, password resets, and messages from plugins that use WordPress mail. It does not take over delivery for plugins that use a separate provider or send outside `wp_mail`. 63 85 64 = Wh ere do I pay for email volume? =86 = Which regions are supported? = 65 87 66 In your Simply Send account (workspace plan / usage). The WordPress plugin does not bill separately.88 🇺🇸 United States (East), 🇦🇺 Australia (Sydney), 🇨🇦 Canada (Central), and 🇪🇺 Europe (Frankfurt). One installation connects to one region at a time. Choose the region where your Simply Send workspace and subscription are located, and where your data should be processed. If you need another region, please [contact support](https://www.simplysend.dev/support). 67 89 68 = Why was my email rejected? =90 = Can I use SMTP credentials with this plugin? = 69 91 70 The From address must be on a verified transactional domain, and the API key must be a transactional key with a valid Account ID (`X-Id`).92 No. This plugin uses the transactional HTTP API and requires an API key and Account ID. If you prefer SMTP, use a compatible WordPress SMTP plugin such as WP Mail SMTP or FluentSMTP with Simply Send SMTP credentials. Follow the [WordPress SMTP setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress). 71 93 72 = Can I use my SMTP username and password? =94 = What is the default email size limit? = 73 95 74 No. This plugin uses the HTTP API and requires a transactional API key and Account ID. SMTP credentials are for a separate SMTP mailer integration. 96 The default Simply Send limit is 2 MB for the complete email, including message content and attachments. To request approval for a higher limit or review other sending limits, open the Simply Send User Portal and go to Accounts → select your account → Limits. 97 98 = Where do I manage subscriptions and usage? = 99 100 Subscriptions, billing, and email usage are managed in your Simply Send account, not through WordPress.org. Subscribe to the region where your workspace is located. 101 102 = Why was an email rejected? = 103 104 Check that the selected region matches your workspace and that the API key, Account ID, verified From address, compliance templates, and account limits are correct for that region. See the [setup guide](https://www.simplysend.dev/docs/guide/integrations/wordpress-plugin) for troubleshooting. 75 105 76 106 = How are compliance placeholders handled? = 77 107 78 The plugin checks the HTML body for {{company_address_html}}, {{unsubscribe_email_html}}, and {{report_abuse_email_html}} separately and adds only the missing placeholders. Simply Send replaces the markers with your configured templates during sending. Configure any required compliance templates in your Simply Send accountbefore sending.108 The plugin checks the HTML body for the Simply Send company address, unsubscribe, and report-abuse template markers, and adds any missing markers. Simply Send replaces these markers using templates configured for your account. Configure any required templates before sending. 79 109 80 110 == Support == 81 111 82 For account setup, API credentials, or delivery questions, visit https://www.simplysend.email/contact. Include the error message and your WordPress and PHP versions. Do not share API keys or passwords in public support posts. 112 Choose the support option that best fits your question: 113 114 * [Simply Send Support](https://www.simplysend.dev/support): Setup guides, FAQs, account questions, and direct support. 115 * [WordPress.org plugin support forum](https://wordpress.org/support/plugin/simply-invent-labs-simply-send/): Questions about installing, configuring, or using the plugin. 116 117 When requesting help, include the error message and your WordPress and PHP versions. Never post API keys, passwords, or message contents publicly. 118 119 == External services == 120 121 This plugin connects to Simply Send, a hosted email delivery service operated by Simply Invent Labs LLC. You need a Simply Send account, a transactional API key, and a verified transactional sending domain. Email usage is subject to your Simply Send subscription and account limits; the plugin does not bill separately. 122 123 After you configure and enable delivery, each intercepted `wp_mail` request sends the sender and recipient addresses and names, subject, HTML and plain-text message bodies, Reply-To, supported CC/BCC recipients, and supported attachments over HTTPS to the endpoint for your selected region: 124 125 * United States: https://tapi.simplysend.dev/send 126 * Australia: https://au-tapi.simplysend.dev/send 127 * Canada: https://ca-tapi.simplysend.dev/send 128 * Europe: https://eu-tapi.simplysend.dev/send 129 130 Your API key and Account ID are sent to the selected Simply Send API as authentication headers. When a message includes attachments, attachment details are sent to the API and file contents are transferred over HTTPS to temporary storage in the selected region for delivery. API credentials are not sent to the file-storage URLs. Your account’s total email size limit applies to messages with attachments. 131 132 Sending a test email makes a normal send request. Plugin activation alone does not contact Simply Send. The plugin collects no separate telemetry. 133 134 * Service: https://www.simplysend.dev 135 * [Terms of Service](https://www.simplysend.dev/terms) 136 * [Privacy Policy](https://www.simplysend.dev/privacy) 137 * [Acceptable Use Policy](https://www.simplysend.dev/legal/acceptable-use) 138 * [Data Processing Addendum](https://www.simplysend.dev/legal/dpa) 139 * [Subprocessors and data processing information](https://www.simplysend.dev/legal/subprocessors) 140 141 == Delivery details == 142 143 * Use either To/CC recipients or BCC recipients, not both in one message. 144 * Attachments require exactly one To recipient, with no CC or BCC, and support up to 10 readable local files. 145 * Unsupported messages fail before an API request; recipients and attachments are not silently dropped. 146 * Email size limits apply to the complete email, including message content and attachments. Review your account’s Limits page for current limits and approval status. 147 * API endpoints are fixed for the selected region. Custom API URLs and automatic cross-region fallback are not supported. 83 148 84 149 == Changelog == 85 150 151 = Contribute to development = 152 153 Contributions are welcome. To work on the plugin: 154 155 1. Clone the [Simply Send WordPress plugin repository](https://github.com/simply-invent-labs/simply-send-wordpress). 156 2. Create a branch for your change and make the update there. 157 3. Run the local regression checks documented in the repository’s README. 158 4. Open a pull request on GitHub describing the change and how you verified it. For larger changes, open an issue first to discuss the approach. 159 160 Do not include API keys, passwords, customer information, or other secrets in code, issues, or pull requests. Please report suspected security vulnerabilities privately through [Simply Send Support](https://www.simplysend.dev/support) instead of posting them publicly. 161 162 = Version history = 163 86 164 = 1.0.8 = 87 * Initialrelease.165 * First release. -
simply-invent-labs-simply-send/trunk/simply-send.php
r3804121 r3804224 2 2 /** 3 3 * Plugin Name: Simply Invent Labs — Simply Send 4 * Plugin URI: https://www.simplysend. email/integrations/wordpress4 * Plugin URI: https://www.simplysend.dev/integrations/wordpress 5 5 * Description: Send WordPress email through the Simply Send transactional API — contact forms, notifications, and plugin mail from your verified domain. 6 6 * Version: 1.0.8
Note:
See TracChangeset
for help on using the changeset viewer.