Settings
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.
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.
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>” → “<p>”) . 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>” → “<p>”) . 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.
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)
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)
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”