FAQ

Can’t find what you’re looking for? Ask a question on the support forum.

Mail Server (8)

When you click Test Config Postie tries to connect your your mail server to ensure everything is set up correctly. (Be sure to click Save first if you changed anything!). Unfortunately sometimes the error messages aren’t very clear and you need a way to verify things.

One common issue is that the port you are trying to use is blocked or your mail server isn’t listening on the port. You can verify these conditions by using the telnet command.

Note: You need shell access to the server Postie is installed on.

Connect to your server via RDP, VNC or SSH and open a command/terminal window and type something like the following:

telnet mail.examples.com 110

Substitute the server and port you are trying to verify. If successful you should see something like:

+OK POP3

Type ‘Q’ and press return to tell the mail server you’re done.

For a IMAP (port 143) you should get something like:

*OK Welcome

Type ‘C logout’ and press return to tell the mail server you’re done.

For POP3-SSL or IMAP-SSL you need to use a different command. For example to test if you can get access to Gmail IMAP try:

echo "TAG LOGOUT" | openssl s_client -connect imap.gmail.com:993

For Gmail POP-SSL try:

echo quit | openssl s_client -connect pop.gmail.com:995

Permalink


Yes. You can use either pop3-ssl or imap-ssl with a gmail account (including Google Apps). Before attempting to use with postie, make sure that you enable POP or IMAP in your Gmail preferences. See this for more info.

Permalink


Yes, but you must use an email setup using the GoDaddy email service. See this page for more info.

Permalink


WordPress cron (which Postie relies on) doesn’t run unless a page is accessed on the site. So if you send an email, but nobody accesses the site for 3 days Postie won’t be given the chance to fetch the email and publish the post.

To ensure that Postie runs smoothly on a low or no volume site you need to ensure that a page gets hit (any page is fine). Use something like cron + curl on Linux or install curl on Windows and use the Scheduled Tasks control panel. See this page for more info.

It is also possible to turn the WordPress cron off. Please make sure something like

define('DISABLE_WP_CRON', true);

is not in your wp-config.php file.

Permalink


Postie works well with Gmail (and Google apps for business).

Please take a look at our Gmail settings page for details and prerequisites.

Permalink


Postie works well with GoDaddy hosting, but you are required to use GoDaddy mail servers (rather than something like Gmail).

  • Protocol: pop3
  • Use Transport Layer Security: no
  • Server: pop.secureserver.net
  • Port: 110
  • Userid: your full email address
  • Password: your password

godaddy-setup

Permalink


The answer is “you can’t do that directly”

However, what you can do is have each separate inbox forward their mail to a central mail account which you then configure Postie to check.

For example you have 2 email accounts that you want your users to send email to: askmeaquestion@example.com and news@example.com

You then create a third email account (postie@example.com) that you don’t tell anyone about and your configure both askmeaquestion and news to forward every email to postie@example.com

You then configure Postie to check the postie@example.com email account.

Many people have this arrangement so that emails sent to each account get assigned different categories. To accomplish this you need to purchase the Category Per User AddOn  and follow the directions for configuring Multiple Inboxes.

Permalink


If you get a message like:

Warning: stream_socket_enable_crypto(): Peer certificate did not match expected

And you are using DreamHost take a look at the following DreamHost support article:

https://help.dreamhost.com/hc/en-us/articles/215306748-Certificate-domain-mismatch-error-when-connecting-to-a-DreamHost-mail-server

Permalink


Messages (12)

Make sure that you send e-mail formatted as html (richtext), and set postie to prefer html messages (in the message tab of the postie settings)

Permalink


Make sure you set the preferred text type to html

Permalink


If your admin account is linked to bar@gmail.com, and you send mail from bar@gmail.com, it will show up as being posted by admin. If you have a WordPress user named “John Doe”, which is linked to johndoe@gmail.com, make sure that you send emails from johndoe@gmail.com. It doesn’t matter which email address Postie is checking. That is, if you send mail from johndoe@gmail.com to foo@gmail.com, it gets posted as “John Doe”.

If you send an email to your Postie address from an email address that is not linked to a WordPress user, it will get posted as admin.

Permalink


There are a couple possible reasons for this. First, check to see if you can add an image through WordPress’s normal posting mechanism. If not, then check the following:

WordPress

  • Your server does not have the php-gd library installed. Ask your hosting provider about this.
  • Your wp-content/uploads directory is not writable by the webserver. Make sure that it is.

Postie

  • “Use custom image field for images” setting is set to “Yes,” change it to “No.”

Permalink


To strip off stuff that they add at the beginning of a message, start your post with :start

To strip off stuff that they add at the end of a message, end your post with :end

Permalink


Simply put the url in the body of your e-mail.

Permalink


Due to the fact that some Postie features use the email subject it is possible for conflicts to arise.

For example the subject “Birds // Bees” will end up with a post title of “Bees” because the “//” is used to specify post types and formats. See Override Post Type and Override Post Format. There isn’t much you can do about this unless you control the email subject lines.

Or you have a title like “12-11-2013 Stats for the day” and end up with a title of “122013 Stats for the day” This is because Postie sees “-11-” and assumes you want category 11 for your post. See Override Post Categories.

More commonly you have a title like “Warning: Storm approaching” and end up with a title of “Storm approaching” and a strange category. This is because Postie uses everything before the “:” as a category wildcard. See Override Post Categories.

The following setting in the Message tab can help you control this behavior.

2016-12-01_1033

You can turn off the wildcard logic by setting “Match short category” to “No”. This will prevent subjects like “No: We don’t want to” from being matched to the category “Normal”

If you don’t want to set any categories from the subject line set “Use colon to match category”, “Use dash to match category” and “Use square bracket to match category” to No.

 

 

Permalink


WordPress has some challenges with some cameras resulting in picture that are rotated 90 degrees left or right or even upsidedown! To resolve this you can install the https://wordpress.org/plugins/image-rotation-repair/ plugin.

Permalink


If you are sending email from one of the email marketing websites to your site via Postie you may notice that the formatting isn’t the same. There are 2 possible reasons for this:

Your WordPress theme conflicts with the styles you assigned when building your email.

In this case you will either need to change the style of the email or the theme. You might be able to add some additional CSS via a plugin like Simple Custom CSS.

Your email does not have inline styles

If your email depends on external or internal stylesheets Postie removes these in order for the resulting post to be valid for WordPress. All the email marketing site recommend that you use inline styles for greatest email client compatibility and this works best for Postie as well.

MailChip in particular has a nice setting to automatically make all the styles inline. See http://kb.mailchimp.com/campaigns/ways-to-build/use-the-css-inliner

Constant Contact CSS recomendation: http://support2.constantcontact.com/articles/FAQ/1095

MailChip also provides a free tool for converting your HTML into inline style. Make sure you copy the entire html source then go to http://templates.mailchimp.com/resources/inline-css/

Permalink


Using the Apple Mail app on iPhones and iPads to send pictures to Postie results in only the pictures showing up with the text missing. This is because by default the mail app does not send a html version of the email, only plain text.

Starting in version 1.8 Postie now has the option to “fall back” to the other “Preferred Text Type” just change the value to “Yes” click Save and you are good to go.

2016-12-01_0916

Permalink


If you are not seeing any thumbnail images being generated you should check your PHP version. There was a bug introduced in PHP 5.6.24 that causes the thumbnail process to fail for some images.

The fix is to roll back to 5.6.23 or forward to 7.0.x

For those interested the bugs are listed here: https://bugs.php.net/search.php?cmd=display&package_name[]=EXIF+related

Permalink


If your images are showing up with 0 height/width you have likely run into a PHP bug. There was a bug introduced in PHP 5.6.24 that causes the image size process to fail for some images (i.e. generating the alternate sizes specified in Settings -> Media).

If you can roll back PHP to 5.6.23 or forward to 7.0.x that will fix the issue.

If you don’t control what version of PHP is on your server you can change the image template Postie uses. Go to the Image tab in Postie settings and look for the Image Template setting.

The default is:

<a href="{PAGELINK}"><img src="{MEDIUM}" alt="{CAPTION}" width="{MEDIUMWIDTH}" height="{MEDIUMHEIGHT}" class="alignnone size-medium wp-image-{ID}" /></a>

Change it by removing the height and width attributes:

<a href="{PAGELINK}"><img src="{MEDIUM}" alt="{CAPTION}" class="alignnone size-medium wp-image-{ID}" /></a>

For those interested the bugs are listed here: https://bugs.php.net/search.php?cmd=display&package_name[]=EXIF+related

Permalink


Installation (3)

No. Do not add an iframe in your footer to get Postie to check mail periodically. Postie uses WordPress cron to automatically check mail. To force a email check periodically, set-up a cron job. See our cron troubleshooting page.

Permalink


The IMAP extension was required for some functionality in Postie versions before 1.8, but is no longer needed.

 

Permalink


General (10)

To view the details one time go to the Postie admin page and click the “Debug” button and the details will be displayed on your screen.

See also Get Detailed Postie Output

 

Permalink


If Postie isn’t working right and you see “Fatal error: Out of memory…” in your logs it is time to increase how much memory PHP allocates to WordPress.

By default 40Mb is allocated.

To change your memory open up your wp-config.php file and add one of the following settings

Increase PHP Memory to 64MB

define('WP_MEMORY_LIMIT', '64M');

Increase PHP Memory to 96MB

define('WP_MEMORY_LIMIT', '96M');

Please note, this setting may not work if your host does not allow for increasing the PHP memory limit–in that event, contact your host to increase the PHP memory limit. Also, note that many hosts set the PHP limit at 8MB.

Permalink


Postie relies on the built-in WordPress Cron process to fetch emails and turn them into posts. However, WordPress requires that there be traffic to your site in order to run the Cron process.

The first check you must do to be sure the WordPress Cron is enabled (it is by default). Clicking Test Config on the Postie settings page will tell you if Cron is disabled. Look for

Cron: On

If you see Cron: off open your wp-config.php file and find a line like

define('DISABLE_WP_CRON', true);

if present, remove it. WordPress Cron should now work.

External Cron

If you would prefer to have more fine-grained control of how Postie checks for mail or you can’t get the WordPress Cron to work, you can setup a cron job.

From Wikipedia

The software utility Cron is a time-based job scheduler in Unix-like computer operating systems. People who set up and maintain software environments use cron to schedule jobs (commands or shell scripts) to run periodically at fixed times, dates, or intervals. It typically automates system maintenance or administration—though its general-purpose nature makes it useful for things like connecting to the Internet and downloading email at regular intervals. The name cron comes from the Greek word for time, χρόνος chronos.

The Easy Way

If you are using a hosting company that doesn’t allow you access to cron or you don’t want to mess with it you can use a service like SetCronJob  or EasyCron to access http://<mysite>/wp-cron.php

If your hosting company uses cPanel for managing your domain you can add a cron job through the cPanel interface. See the cron job docs then choose one of the commands listed below.

The Techie Way

Setup a cronjob to access http://<mysite>/wp-cron.php

Note this runs all the WordPress cron jobs if they are scheduled to run. Note also that if you have set Postie to check for emails every 30 minutes accessing this URL every 5 minutes will not speed things up, it will just ignore the request until 30 minutes have passed since the last check. Change the frequency by changing the Postie settings.

Linux

If your site runs on a UNIX/linux server, and you have shell access, you can enable mail checking using cron.

Example: This starts the wp-cron every ten minutes with wget

*/10 * * * * /usr/bin/wget -O /dev/null http://<mysite>/wp-cron.php >/dev/null 2>&1

Windows

You will need to install wget or curl.
Then use the Task Scheduler control panel to call wget or curl.
Examples:
wget example

wget http://<mysite>/wp-cron.php

curl example

curl http://<mysite>/wp-cron.php

The Unusual Way

We currently recommend that you access http://<mysite>/wp-cron.php rather than using http://<mysite>/?postie=get-mail as documented below, however, sometimes direct access is required. Please be aware that this method does not check to see if Postie is already running so it is possible to cause many email checks to be running at the same time which can cause all sorts of problems.

Setup a cronjob to access http://<mysite>/?postie=get-mail Note that every time you access this page Postie will run – it is like clicking Run Postie on the Admin screen.

Note that before Postie 1.6 the URL was: http://<mysite>/wp-content/plugins/postie/get_mail.php This URL is no longer supported.

Permalink


As of version 1.5.5 you can click the “Debug” button to have Postie check for emails and report debugging information to the screen.

2016-12-01_1023

To always log debug info to a log file

You can enable a higher level of logging for Postie activity by setting the “Enable Debug Logging” setting on the Mailserver tab.

2016-12-01_1024

Once you turn this on Postie will display on screen and write to your log file some very detailed information about what is happening. This information can be very useful in diagnosing an issue.

 

Typically the WordPress log file is located at wp-content\debug.log

If the debug.log file doesn’t show up then create a file debug.log in the wp-content directory and then “chmod 666 debug.log” or use cpanel to do the same thing.

It is possible that the error log is in a different location. Clicking Test Config will tell you where it is located.

2016-12-01_1030

Permalink


There are 2 features that can be used to remove signatures.

The first one is the “Signature Patterns” setting. This is a list of regular expressions (RegEx) that are used to specifically look for signatures. These work best with the “plain” “Preferred Text Type” setting and if your email come from a variety of sources, but you may need to play with the RegExes to meet your needs.

The second method is the “Text for Message End” setting. This is a word or phrase that indicates the end of the post and that it and everything after it in the email should be ignored.

For example I get a newsletter that always has the text “I hope you enjoy the post.” after the real content. If I put that in “Text for Message End” everything from that text to the end of the email will be ignored.

This method works best if you have a single email source such as a newsletter.

Permalink


It appears that Google mail (Gmail) will add a placeholder to the plain text version of your email that looks something like this: [image: Inline image 1]

This will occur for each image inserted “inline” which is the default.

This text is actually in the message, Postie is not adding it.

The best workaround is to change the “Preferred Text Type” setting to “Html”

Permalink


If you can’t get Postie to work and you’ve checked all the other FAQs it is likely that you are experiencing a conflict between Postie and another plugin or your theme.

The first thing to try is switching your theme to one of the standard themes such as twentyfifteen. Now trying testing Postie again. If Postie works then you need to get in contact with your theme author to see what the problem is.

If Postie is still not working the next step is to disable all plugins except Postie. Test that Postie works with no other plugins active. If Postie still doesn’t work then something more serious is wrong and you will need to ask for help in the support forum.

Assuming Postie works with all the plugins disabled then next step is to enable one plugin at a time and test to see if Postie is still working. If Postie stops working then you know which plugin caused the conflict and you should contact the plugin author.

Permalink


If your posts are blank except for attachments it is likely that you have your “Preferred Text Type” setting set to “plain” and you are using one of the following email clients:

  • Apple Mail on iPhone/iPad
  • SquirrelMail

When you send an email your client has the option of sending plain (unstyled) email, HTML (styled) email or both. In the case of the above email clients they only send HTML email in some cases and if Postie is set to look for plain it won’t find any content. The fix is to turn on the “Text Fallback” option.

Permalink


bbPress is a forum plugin for WordPress. Since most forums allow you to interact with them via email there are many people looking for this feature in bbPress. Out of the box bbPress does not have the ability to send or receive emails so many people look to Postie to help.

Unfortunately there are many difficulties in getting Postie to work with bbPress (or any other forum software) due to the fact that the incoming and outgoing emails need to have some way to hook them together so the right forum topic is updated. Postie only deals with incoming emails so it is not an ideal solution for this problem.

Luckily there is a ppPress plugin located here: https://github.com/rmccue/Falcon

There are some limitations, but it seems to be the only solution that supports a full round trip emails.

 

Permalink


If you ever see the message “Could not update post in the database” when researching why an email didn’t show up here are the things to check:

  • Click the Test Config button and look at the encoding section:
    • default_charset, DB_CHARSET, WordPress encoding and Postie encoding should all the same and are ideally UTF-8.
    • Verify that the DB_CHARSET actually matches the encoding on the database and the tables.
  • Consider upgrading your version of PHP to 5.6 or newer. Some users have reported that the error goes away when upgrading from PHP 5.3 to 5.6.
  • Consider upgrading MySQL. The function that detects the condition which causes this error relies on the database to do character set conversion/validation in some cases.
  • Add a pre_post_update filter and inspect the values in the $data parameter.

 

Permalink


Extending/Developing (2)

Yes. You can create your own function which utilizes one of the filters provided by Postie such as postie_post_before. Two short examples are included in the filterPostie.php.sample file. See also Extending Postie.

Permalink


Yes. You can create your own function, and use the postie_post_before filter. Two short examples are included in the filterPostie.php.sample file. See also Extending Postie.

Permalink


Usage (13)

Postie has a setting called “Tag Of Message Start” which allows you to specify some text that indicates the start of the post. This is useful when the email is coming from a mailing list and you want to automatically strip out the headers or your ISP adds unwanted text to the beginning of your emails.

The default value of “Tag Of Message Start” is “:start”.

So if your message looks like:

:start
Here is my message

Postie will remove everything up to and including the “:start” resulting in a post like:

Here is my message

If your incoming emails look like:

[This e-mail has been automatically generated.]

You have one or more bugs assigned to you in the Bugzilla bug tracking system that require attention.
You will get this message once a day until you've dealt with these bugs!

 Sample defect
    -> http://app.devzing.com/testopia/bugzilla/show_bug.cgi?id=1
 test
    -> http://app.devzing.com/testopia/bugzilla/show_bug.cgi?id=2
 [Test Case 2] Test Case 1

You could change the “Tag Of Message Start” to “until you’ve dealt with these bugs!” and your post will look like:

 Sample defect
    -> http://app.devzing.com/testopia/bugzilla/show_bug.cgi?id=1
 test
    -> http://app.devzing.com/testopia/bugzilla/show_bug.cgi?id=2
 [Test Case 2] Test Case 1

Permalink


Posts can have their status set to draft, publish, pending, future or private. This will override the Default Post Status set in the settings screen.

Usage (in the message body):

status: [draft | publish | pending | private | future]

Note that the future status will only be detected with Postie 1.6.18 or higher.

You can use status: future combined with date to created a scheduled post.

Example

status: draft

Permalink


Postie has a setting called “Tag Of Message End” which allows you to specify some text that indicates the end of the post. This is useful when the email is coming from a mailing list and you want to automatically strip out the footers or your ISP adds unwanted text to the end of your emails.

The default value of “Tag Of Message End” is “:end”.

So if your message looks like:

Here is my message
:end

Postie will remove everything after and including the “:end” resulting in a post like:

Here is my message

If your incoming emails look like:

Daily Backup of Database ( test )
Rotating last weeks Backup...
removed `/var/lib/automysqlbackup/daily/test/test_2014-09-12_07h47m.Friday.sql.gz'

Backup Information for /var/lib/automysqlbackup/daily/test/test_2014-09-19_07h47m.Friday.sql
         compressed        uncompressed  ratio uncompressed_name
                563                1412  64.4% /var/lib/automysqlbackup/daily/test/test_2014-09-19_07h47m.Friday.sql
----------------------------------------------------------------------
Backup End Fri Sep 19 07:47:03 BST 2014
======================================================================
Total disk space used for backup storage..
Size - Location
682M /var/lib/automysqlbackup

======================================================================
If you find AutoMySQLBackup valuable please make a donation at
http://sourceforge.net/project/project_donations.php?group_id=101066
======================================================================

You could change the “Tag Of Message End” to “If you find AutoMySQLBackup” and your post will look like:

Daily Backup of Database ( test )
Rotating last weeks Backup...
removed `/var/lib/automysqlbackup/daily/test/test_2014-09-12_07h47m.Friday.sql.gz'

Backup Information for /var/lib/automysqlbackup/daily/test/test_2014-09-19_07h47m.Friday.sql
         compressed        uncompressed  ratio uncompressed_name
                563                1412  64.4% /var/lib/automysqlbackup/daily/test/test_2014-09-19_07h47m.Friday.sql
----------------------------------------------------------------------
Backup End Fri Sep 19 07:47:03 BST 2014
======================================================================
Total disk space used for backup storage..
Size - Location
682M /var/lib/automysqlbackup

======================================================================

Note you can’t use “====” as the “Tag Of Message End” as Postie looks for the tag starting at the beginning of the message and will remove too much.

Permalink


By default Postie will use the date of the email as the post publish date. You can override the date in the email. You can provide an exact date with optional time or a relative date.

Usage (in the message body):

date: <the date>

Examples:

date: Apr 14, 2014
date: monday

 

Permalink


Posts can be delayed. You can add days, hours and/or minutes to the email date to delay the publishing of a post.

Usage (in the message body):

delay: [0-99d][0-99h][0-99m]

Example

This will delay 1 day
delay: 1d

This will delay 1 hour
delay: 1h

This will delay 1 day, 2 hours and 4 minutes
delay: 1d2h4m

 

Permalink


You can override the default comment control for the message.

Usage (in the message body):

comments: 0 | 1 | 2

0 means comments closed

1 means comments open

2 means comments from registered users only

Example

comments: 1

 

Permalink


You can include a custom excerpt of an e-mail by putting it between :excerptstart and :excerptend

Example

:excerptstart
This is my excerpt text.
:excerptend
This is the main body of my post.

Images in excerpts

It is possible to include images in the excerpt even if you are using plain text emails. Wherever you want the first image insert the text “#eming1#” the second image “#eming2#” and so on. The images are numbered in the order they were attached to the email.

Example

:excerptstart
This is my excerpt text. An image will go here #eming1#
:excerptend
This is the main body of my post.

 

Permalink


You can specify the post type by including it as the first part of the email subject followed by forward slashes (//).

Example (in the subject line)

customtype//real subject

The post title would be “real subject” and the post type will be “customtype”. This assumes you have a plugin or theme that added a custom post type called “customtype”.

Permalink


You can specify the post format by including it as the first part of the email subject followed by forward slashes (//).

Example (in the subject line)

aside//real subject

The post title would be “real subject” and the post format will be “aside”.

Permalink


There are 3 different ways to specify categories in your email and they all involve the subject line.

Note the category must already be set up, Postie will not create new categories.

(although there is an AddOn that will do this now – Create Categories)

The first way is to put a category name (or partial name) or a category id then a colon (:) then the actual subject.

Usage (in the subject line):

<category name>: Real subject
<category id>: Real subject
<partial category name>: Real subject

The second and third ways are very similar and allow you to specify multiple categories. Enclose the category name (or partial name) or id in square brackets ([]) or between dashes (-).

Examples

[category1] [19] Real subject
[1] [2] [10] Real subject
[cat] Real subject
-category1- -19- Real subject
-1- -2- -10- Real subject
-cat- Real subject

If you don’t want to make use of partial matches you can turn off the “Match short category” setting.

Custom Taxonomies

This technique also works with custom taxonomies. You may have to enable the “Force User Login” setting depending on how the taxonomies were set up.

Specifying Post Type/Post Format

If you are trying to also specify the post type/format you need to do that first, like so:

myposttype//[mycategory] my subject

You can learn more about specifying post type and post format.

Disabling Category/Taxonomy Matching

Set all of the following settings to “No”

2016-12-01_1033

Permalink


You can override the default tags for a post in the email.

Usage (in the message body):

tags: <tag1>[, <tag2>][, <tagN>]

Example

tags: cats, funny

 

Permalink


It is possible to place images in certain places when using plain text emails by using the #img# directive in your mail text.

Example

Here is a sample plain text email.
#img1#
With an image displayed in the middle of the text.

This will generate a post with the first attached image between the two paragraphs.

The number following #img directs Postie as to which image it should use. You do not have to use them in order. I.e. you can have #img3# before #img1# in your email.

Additionally you can specify a caption like so:

Here is a sample plain text email.
#img1 caption='pretty kitty'#
With an image displayed in the middle of the text.

Note you can only use the #img# feature if your “Preferred Text Type” is set to “plain”

Permalink


Some SMS providers supply their own not so useful subjects when going through a SMS to email gateway. You can provide your own subject in the message body by including it on the first line surrounded by the hash symbol (#). Note that you must have “Preferred Text Type” set to “plain” to have any chance of this working.

#my subject#

The rest of my message

The subject must be on the very first line and the # character must be the first character in the message (no blank lines, spaces or html). You must also set the “Allow Subject In Mail” setting to “Yes”

Permalink


Settings (6)

Connection

Sockets is preferred, but doesn’t work with some hosts.

Mail Protocol

 

Port

Standard Ports:
POP3 – 110
IMAP – 143
IMAP-SSL- 993
POP3-SSL – 995

Mail Server

Mail Userid

Mail Password

Postie Time Correction

Should be the same as your normal offset, but this lets you adjust it in cases where that doesn’t work.

Check for mail every

Maximum number of emails to process

Delete email after posting

Only set to no for testing purposes

Enable Error Logging

Log error messages to the web server error log.

Enable Debug Logging

Log debug messages to the web server error log.

 

Permalink


 

Roles That Can Post

This allows you to grant access to other users to post via email if they have the proper access level. Administrators can always post.

Authorized Addresses

Put each email address on a single line. Posts from emails in this list will be treated as if they came from the admin. If you would prefer to have users post under their own name – create a WordPress user with the correct access level.

Default Poster

This will be the poster if you allow posting from emails that are not a registered blog user.

Force User Login

Changing this to yes will cause Postie to try and login as the ‘from’ user if they exist. This should be set to ‘Yes’ if you use custom taxonomies in the subject line.

Allow Anyone To Post Via Email

Changing this to yes is not recommended – anything that gets sent in will automatically be posted.

Permalink


Preferred Text Type
Emails typically contain both plain and html formatted versions of your email. Use html if you want the “rich text” version of the email used to create the post.

Text Fallback
Use plain if html is missing and vice versa.

Default category
Specifies the category to apply to the post by default.

Match short category
Try to match categories using ‘starts with logic’ otherwise only do exact matches. Note that custom taxonomies will not be found if this setting is ‘No’

Use colon to match category
One option for specifying a category is to place it on the subject line followed by a colon (:). E.g. “category1: The real subject”. However, some mailing lists include colons for other reasons so you can turn off the colon based category detection if needed.

Use dash to match category
One option for specifying a category is to place it on the subject line surrounded by the dash (-). E.g. “-category1- The real subject”. However, some mailing lists include dashes for other reasons so you can turn off the dash based category detection if needed.

Use square bracket to match category
One option for specifying a category is to place it on the subject line surrounded by square brackets ([]). E.g. “[category1] The real subject”. However, some mailing lists include square brackets for other reasons so you can turn off the square bracket based category detection if needed.

Default tag(s)
The optional list of tags to be applied to the post.Separated each tag with commas. E.g. “tag1, tag2, long tag”

Default Post Status
The status to assign to the post.

Default Post Format
The format to assign to the post.

Default Post Type
The type to assign to the post.

Default Title
If no subject is found then use this text. It is unusual for a subject to be missing. Some SMS to email systems don’t add a subject which is why this setting exists.

Treat Replies As
When a reply is detected you can choose how you want Postie to treat the reply.

Strip Original Content from Replies

Forward Rejected Mail

Allow Subject In Mail
Enclose the subject between ‘#’ on the very first line. E.g. #this is my subject#

Allow HTML In Mail Subject
If set to “No” Postie will convert all HTML markup into html entities (“<p>” → “&lt;p&gt;”) . This allows you to display html tags. Otherwise no conversion will happen and the html will be applied when the post is displayed in WordPress.

Allow HTML In Mail Body
If set to “No” Postie will convert all HTML markup into html entities (“<p>” → “&lt;p&gt;”) . This allows you to display html tags. Otherwise no conversion will happen and the html will be applied when the post is displayed in WordPress.

Text for Message Start
Remove all text from the beginning of the message up to the point where this is found. Optional.

Text for Message End
Remove all text from the point this is found to the end of the message.Optional.

Filter newlines
Plain text email have automatic newlines about every 70 characters. If set to “Yes” Postie will remove these newlines, but will retain any double newlines as a paragraph break. This setting has no effect on HTML emails.

Replace newline characters with html line breaks (<br />)
Filter newlines must be turned on for this option to take effect

Return rejected mail to sender
If the email is rejected for any reason should the sender be notified?

Send post confirmation email to
Who should receive an email for each successfully processed email?

Automatically convert urls to links
Should bare URLs be converted to real links?

Encoding for pages and feeds
The character set for your blog. UTF-8 is recommended, but you may need something else if your WordPress is very old.

Drop The Signature From Mail
Use the signature patterns (below) to try and find the email signature and remove it.

Signature Patterns
Put each pattern on a separate line. Patterns are regular expressions and are put inside ‘/^{pattern}\s?$/miu’. For HTML content the inner text of each element is evaluated against the pattern. E.g for <p>some test</p><p>– <br>signature</p> Postie will evaluate ‘some text’, ‘– ‘ and ‘signature’ against the pattern(s) and the first time it find a match it will assume that is the signature and remove it and anything below it from the post.

Permalink


Use First Image as Featured Image
If any images are attached, the first one will be the featured image for the post. As of 1.7.5 the featured image will not be included in the post content.
Include Featured Image in Post
Should the featured image be included in the post.
Automatically insert image gallery
If any images are attached, they will automatically be inserted as a gallery
Gallery Link Type
Allows you to specify the link type used with the gallery. (requires 1.6.18 or above)
Image Location
Location of attachments if using ‘plain’ format. Before or After content.
Generate Thumbnails
Some hosts crash during thumbnail generation. Set this to ‘No’ if you have this issue
Start Image Count At
For use if using “Image Place Holder Tag” below.
Use custom image field for images
When set to ‘Yes’ no images will appear in the post (other attachment types will be processed normally). Instead the url to the attachment will be put into a custom field named ‘image’. Your theme will need logic to display these attachments.
Image Place Holder Tag
For use in ‘plain’ messages. The code for inserting an image. I.e. put “#img1# in your email where you want the first image to show. See also “Start Image Count At”
Image Template
Choose a default template, then customize to your liking in the text box. Note that this template are only used if the “Preferred Text Type” setting is set to “plain.” Sizes for thumbnail, medium, and large images can be chosen in the Media Settings.

{CAPTION} gets replaced with the caption you specified (if any)
{FILELINK} gets replaced with the url to the media
{FILENAME} gets replaced with the name of the attachment from the email
{FILEID} gets replaced with the ID of the media
{HEIGHT} gets replaced with the height of the photo
{ID} gets replaced with the post id
{LARGE} gets replaced with the url to the large-sized image
{LARGEHEIGHT} gets replaced with the height of a large image
{LARGEWIDTH} gets replaced with the width of a large image
{MEDIUM} gets replaced with the url to the medium-sized image
{MEDIUMHEIGHT} gets replaced with the height of a medium image
{MEDIUMWIDTH} gets replaced with the width of a medium image
{PAGELINK} gets replaced with the URL of the file in WordPress
{RELFILENAME} gets replaced with the relative path to the full-size image
{THUMB} gets replaced with the url to the thumbnail image
{THUMBHEIGHT} gets replaced with the height of a thumbnail image
{THUMBNAIL} same as {THUMB}
{THUMBWIDTH} gets replaced with the width of a thumbnail image
{TITLE} same as {FILENAME}
{URL} same as {FILELINK}
{WIDTH} gets replaced with width of the photo
{ICON} insert the icon for the attachment (for non-audio/image/video attachments only – e.g. PDF or DOCX)

Permalink


Video template 1
Note that this template are only used if the video is not “inline” or the “Preferred Text Type” setting is set to “plain”
Video 1 file extensions
Use video template 1 for files with these extensions (separated by commas)
Video template 2
Note that this template are only used if the video is not “inline” or the “Preferred Text Type” setting is set to “plain”
Video 2 file extensions
Use video template 2 for files with these extensions (separated by commas)
Audio template
Note that this template are only used if the audio is not “inline” or the “Preferred Text Type” setting is set to “plain”
Audio file extensions
Use the audio template for files with these extensions (separated by commas)

Permalink


Supported MIME Types
Add just the type (not the subtype). Text, Video, Audio, Image and Multipart are always supported. Put each type on a single line
Banned File Names
Put each file name on a single line.Files matching this list will never be posted to your blog. You can use wildcards such as *.xls, or *.* for all files
Attachment icon set
Attachment icon size (in pixels)
Attachment template
Note that this template are only used if the attachment is not “inline” or if the email type is “plain”

Permalink