1.8.36 Released

Postie 1.8.36 was released today with the following changes

  • Allow user to specify a IMAP folder (supplied by Alejandro Liu)
  • New setting “use time offset” which controls whether or not the postie time offset is applied.
  • New setting “ignore_email_date” which controls whether or not the email “from” date is used.
  • New setting “Notify on Error” to control who gets notified on significant errors.
  • Email admins on some errors
  • Improvement to post date handling
  • Fix bug when parsing headers that have multiple encoded sections
  • Fix postie_file_added action

Specify an IMAP folder

Alejandro Liu provided a nice enhancement to allow you to specify a IMAP folder to check other than the INBOX.

To use, when entering the username, for the IMAP account, you append the folder name to it using a “/”.

For example, if the user is ‘bob@somewhere.net’, if you want to use a different folder (like EXAMPLE), you would configure the user to be ‘bob@somewhere.net/EXAMPLE’.

Date/Time Improvements

In addition to some internal date math improvements 2 new settings have been added to allow more control over how dates are handled.

The standard date handling for Postie is to take the date from the email and apply the delay (if any specified in the email) then apply the Postie offset.

You can now ignore the Postie offset with the “Use Postie Time Correction” setting. With this setting set to “No” the timezone set in your Settings::General menu will be respected.

Additionally you can now also ignore the date in the email and use the system date instead. The “Ignore Email Date” setting controls this.

Error Emails

There are a few errors that cause confusion on a regular basis. Postie will now email all the administrators when one of these errors happens. You can control these emails with the new “Notify on Error” setting. You can disable these emails, send them to all administrators or pick a single administrator to receive them.

These emails are sent if there is a error that impacts a post in some significant way such as: database errors, banned files, failed to add media, unsupported MIME types and temp file issues.

Encoded Subject Lines

Postie now parses encoded email headers (like subject lines) according to RFC 2047. Previously there were a few edge cases that were not being parsed correctly resulting in extra spaces in odd places.

Previous versions

You can download the last 35 releases of Postie here in case you need to roll back for some reason.

Current Version

1.9.2 - download

Other Versions

1.8.35 Released

  • Check for blank image file extension and replace with mime subtype to get around new filetype checking in WordPress 4.7.2 https://core.trac.wordpress.org/ticket/39550
  • Additional logging of message and part headers
  • Fix base64 header decoding so trailing space isn’t removed
  • Fix header decoding to remove extra utf-8 byte order mark
  • Add current WordPress time to logging

1.8.33 Released

  • New setting “Remove matched categories” allows category specifiers to remain in post title.
  • New filter postie_cleanhtml to determine if Postie should clean up the html or if some other AddOn will do it.
  • Specifically call out public methods

1.8.32 Released

  • Ensure password not in logs for POP3.
  • Additional POP3 header checks.
  • Additional POP3 logging.
  • Ensure postie_raw always gets called.
  • Default to GMT when timezone is blank.
  • Use WordPress function to upload images rather than old custom function.
  • Remove Generate Thumbnails option as now handled by WordPress.
  • ATT00001.txt and its ilk are now always considered a banned attachment regardless of MIME type.
  • Removed call to date_default_timezone_set()
  • Send notifications to all WP admins if configured.
  • Add support for postie_category filter.

Filter: postie_category

This filter is called after the category is detected in the subject line. You could use this filter to create a missing category or force it to be one of a list of approved categories. Note this filter will be called multiple times if there are multiple categories in the subject line.

You should return a string that is a valid category or taxonomy term. If the returned value is not a valid category or taxonomy term then the unknown category will remain in the subject line.

Parameters:
  • $category_name – the category extracted from the subject line. Note this could be a category ID. The delimiters are not included e.g. for the subject line “[mycategory] subject line” this parameter would be “mycategory”
  • $match_short_category – a boolean indicating if Postie will try to look up the category using “starts with” logic. Controlled by the “Match short category” setting.
  • $default – the default category as defined by the “Default category” setting or the results of the postie_category_default filter.
add_filter('postie_category', 'my_postie_category', 10, 3);

function my_postie_category($category_name, $match_short_category, $default) {
 return ''; //don't allow user to set category
}

1.8.33 Released

  • Ensure password not in logs for POP3.
  • Additional POP3 header checks.
  • Additional POP3 logging.
  • Ensure postie_raw always gets called.
  • Default to GMT when timezone is blank.
  • Use WordPress function to upload images rather than old custom function.
  • Remove Generate Thumbnails option as now handled by WordPress.
  • ATT00001.txt and its ilk are now always considered a banned attachment regardless of MIME type.
  • Removed call to date_default_timezone_set()
  • Send notifications to all WP admins if configured.
  • Add support for postie_category filter.