GithubHelp home page GithubHelp logo

bhubbard / postmark-wordpress Goto Github PK

View Code? Open in Web Editor NEW

This project forked from activecampaign/postmark-wordpress

1.0 0.0 0.0 427 KB

The Official Postmark Wordpress Plugin

License: GNU General Public License v2.0

PHP 86.02% CSS 2.92% JavaScript 11.06%

postmark-wordpress's Introduction

Postmark Logo

ActiveCampaign Postmark for WordPress

If you’re still sending email with default SMTP, you’re blind to delivery problems! ActiveCampaign Postmark for WordPress enables sites of any size to deliver and track WordPress notification emails reliably, with minimal setup time and zero maintenance.

If you don’t already have an ActiveCampaign Postmark account, you can get one in minutes, sign up at https://postmarkapp.com.

Installation

  1. Upload postmark directory to your /wp-content/plugins directory or install from plugin marketplace
  2. Activate plugin in WordPress admin
  3. In WordPress admin, go to Settings then ActiveCampaign Postmark. You will then want to insert your ActiveCampaign Postmark details. If you don’t already have an ActiveCampaign Postmark account, get one at http://postmarkapp.com.
  4. Verify sending by entering a recipient email address you have access to and pressing the “Send Test Email” button. Enable logging for troubleshooting and to check the send result.
  5. Once everything is verified as working, check Send emails using ActiveCampaign Postmark and Save, to override wp_mail to send using the ActiveCampaign Postmark API instead.

FAQ

What is ActiveCampaign Postmark?

ActiveCampaign Postmark is a hosted service that expertly handles all delivery of transactional webapp and web site email. This includes welcome emails, password resets, comment notifications, and more. If you've ever installed WordPress and had issues with PHP's mail function not working right, or your WordPress install sends comment notifications or password resets to spam, ActiveCampaign Postmark makes all of these problems vanish in seconds. Without ActiveCampaign Postmark, you may not even know you're having delivery problems. Find out in seconds by installing and configuring this plugin.

Will this plugin work with my WordPress site?

The ActiveCampaign Postmark for WordPress plugin overrides any usage of the wp_mail function. Because of this, if any 3rd party code or plugins send mail directly using the PHP mail function, or any other method, we cannot override it. Please contact the makers of any offending plugins and let them know that they should use wp_mail instead of unsupported mailing functions.

TLS Version Requirements/Compatibility

The ActiveCampaign Postmark API requires TLS v1.1 or v1.2 support. We recommend using TLS v1.2.

You can check your TLS v1.2 compatibility using this plugin. After installing the plugin, change the dropdown for 'Select API Endpoint' to How's My SSL? and run the test. If compatibility with TLS v1.2 is not detected, contact your server host or make the necessary upgrades to support TLS v1.1 or v1.2.

TLS 1.2 requires:

  • PHP 5.5.19 or higher
  • cURL 7.34.0 or higher
  • OpenSSL 1.0.1 or higher

Does this cost me money?

The ActiveCampaign Postmark service (and this plugin) are free to get started, for up to 100 emails a month. You can sign up at https://postmarkapp.com/. When you need to process more than 100 emails a month, ActiveCampaign Postmark offers monthly plans to fit your needs.

My emails are still not sending, or they are going to spam! HELP!?

First, enable logging in Settings and check your send attempts for any errors returned by the ActiveCampaign Postmark API. These errors can let you know why the send attempts are failing. If you aren't seeing log entries for your send attempts, then the plugin or contact form generating the emails is likely not using wp_mail and not compatible with this plugin.

If you are still unsure how to proceed, just send an email to [email protected] or tweet @postmarkapp for help. Be sure to include as much detail as possible.

Why should I trust you with my email sending?

Because we've been in this business for many years. We’ve been running an email marketing service, Newsberry, for five years. Through trial and error we already know what it takes to manage a large volume of email. We handle things like whitelisting, ISP throttling, reverse DNS, feedback loops, content scanning, and delivery monitoring to ensure your emails get to the inbox.

Most importantly, a great product requires great support and even better education. Our team is spread out across six time zones to offer fast support on everything from using ActiveCampaign Postmark to best practices on content and user engagement. A solid infrastructure only goes so far, that’s why improving our customer’s sending practices helps achieve incredible results.

Why aren't my HTML emails being sent?

This plugin detects HTML by checking the headers sent by other WordPress plugins. If a "text/html" content type isn't set then this plugin won't send the HTML to ActiveCampaign Postmark to be sent out only the plain text version of the email.

Why are password reset links not showing in emails sent with this plugin?

There are a couple ways to resolve this issue.

  1. Open the ActiveCampaign Postmark plugin settings and uncheck Force HTML and click Save Changes. If the default WordPress password reset email is sent in Plain Text format, the link will render as expected.

  2. Access your WordPress site directory and open the wp-login.php file.

Change this line:

$message .= ‘<‘ . network_site_url(“wp-login.php?action=rp&key=$key&login=” . rawurlencode($user_login), ‘login’) . “>\r\n”;

Remove the brackets, so it becomes:

$message .= network_site_url(“wp-login.php?action=rp&key=$key&login=” . rawurlencode($user_login), ‘login’) . “\r\n”;

And save the changes to the file.

How do I set the from name?

The plugin supports using the wp_mail_from_name filter for manually setting a name in the From header.

Additional Resources

ActiveCampaign Postmark for WordPress FAQ

Can I use the ActiveCampaign Postmark for WordPress plugin with Gravity Forms?

How do I send with Ninja Forms and ActiveCampaign Postmark for WordPress?

How do I send with Contact Form 7 and ActiveCampaign Postmark for WordPress?

Can I use the ActiveCampaign Postmark for WordPress plugin with Divi contact forms?

Changelog

v1.15.7

  • ActiveCampaign branding update.

v1.15.6

  • Do wp_mail_succeeded action after successful sends (introduced in WordPress v5.9).

v1.15.5

  • Honour pre_wp_mail filters.

v1.15.4

  • Fix notice when overriding force_from setting.

v1.15.3

  • Ensure Postmark plugin is loaded before attempting to load settings from it after upgrading.

v1.15.2

  • Use correct admin.js file version for v1.15

v1.15.1

  • Bugfix for using Force From setting.

v1.15. 0

  • Adds new Force From setting to allow preventing override of From address using headers, if desired.

v1.14.0

  • Adds ability to override settings for environment specific Postmark plugin settings.

v1.13.7

  • Fix limit of 500 sending logs deleted per day.

v1.13.6

  • Even better handling of apostrophes in email address From names.

v1.13.5

  • Handle apostrophes in email address From names. These are sometimes used in site titles, which can be the default From address name with other plugins.

v1.13.4

  • Handle special characters in site titles for test emails.

v1.13.3

  • Additional bugfix for using wp_mail_from_name filter.

v1.13.2

  • Fixes error when upgrading by ensuring $postmark is set before trying to load settings.

v1.13.1

  • Fixes error from using incorrect filter name and mailparse_rfc822_parse_addresses function.

v1.13.0

  • Adds support for using the wp_mail_from_name filter to specify a from_name when sending.

v1.12.5

  • Fixes 'POSTMARK_DIR is undefined' warning when upgrading other plugins via the CLI.

v1.12.4

  • Fixes potential collation mismatch errors from date comparisons during old sending logs deletion.

v1.12.3

  • Uses count() for check of logs query result count.

v1.12.2

  • Corrects SQL for deletion of log entries older than 7 days.

v1.12.1

  • Checks if stream_name is set in settings before determining which stream to use.

v1.12

  • Adds support for message streams.

v1.11.6

  • Updates server API token location hint in plugin settings.

v1.11.5

  • Changes Settings form field validation to allow using POSTMARK_API_TEST for server token.

v1.11.4

  • Fixes handling of situation where call to Postmark API results in WP_Error instead of array for response, such as during incidents of the API being offline and not returning a response.

v1.11.3

  • Fixes log page display of From/To addresses including the From/To names. Only email addresses will now appear in logs page, to avoid confusion, while also preserving the sanitation of email addresses before inserting into db.

v1.11.2

  • Fixes no index error with track links check in wp_mail.

v1.11.1

  • Fixes call of non-global load_settings function during upgrade.

v1.11.0

  • Adds link tracking support.
  • Fixes send test with HTML/open tracking option not being honored in sent test email.

v1.10.6

  • Fixes undefined index error.
  • Adds Upgrade Notice

v1.10.5

  • Corrects logs deletion cron job unscheduling issue.

v1.10.4

  • Removes index on logs table.

v1.10.3

  • Corrects version mismatch in constructor.

v1.10.1

  • Adds a new logging feature that can be enabled to store logs for send attempts. Logs include Date, From address, To address, Subject, and Postmark API response. Logs are displayed in a Logs tab in the plugin setting once enabled.
  • Switch loading of JS/CSS to use enqueue()

v1.9.6

  • Resolves issue when saving settings in UI.
  • Falls attachment Content-Type back to 'application/octet-stream' when other methods fail.

v1.9.5

  • Update javascript to fix settings update issue.

v1.9.4

v1.9.3

  • Interface cleanup
  • Minor code restructuring

v1.9.2

  • Make the errors available in the PHP variable Postmark_Mail::$LAST_ERROR if wp_mail() returns false, examine this variable to find out what happened.
  • When doing a test send, if an error occurs, it will be printed in the settings page header.

v1.9.1

  • Fix case where 'From' header is specified as a literal string, instead of in an associative array.

v1.9

  • Allow the 'From' header to override the default sender.
  • Don't send TextBody when the user has specified the 'Content-Type' header of 'text/html'
  • Allow individual messages to opt-in to Track-Opens by including a header of 'X-PM-Track-Opens' and a value of true

v1.8

  • Modernization of codebase.

v1.7

  • Support headers for cc, bcc, and reply-to

v1.6

  • Added open tracking support.

v1.5

  • Fix issue with new WordPress HTTP API Integration.

v1.4

  • New option to force emails to be sent as HTML. Previously just detected Content-Type.
  • Now uses the WordPress HTTP API.

v1.3

  • Resolved error with handing arrays of recipients

v1.2

  • Arrays of recipients are now properly handled
  • HTML emails and Text Emails are now handled by checking the headers of the emails sent, and sends via Postmark appropriately.
  • Optional "Powered by Postmark" footer of sent emails. "Postmark solves your WordPress email problems. Send transactional email confidently using http://postmarkapp.com"
  • Add license to README and PHP file

v1.0.0

  • First Public release.

postmark-wordpress's People

Contributors

andrewhaines avatar atheken avatar bhubbard avatar chexwarrior avatar cklosowski avatar ethanclevenger91 avatar guillaumemolter avatar jptoto avatar mgibbs189 avatar multisuperfreek avatar renatonascalves avatar robertocorreale avatar tflight avatar

Stargazers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.