The Postie plugin allows you to blog via e-mail, including many advanced features not found in WordPress's default post by e-mail feature.

Contributors: WayneAllen
Donate link: donate
Tags: e-mail, email
Requires at least: 2.8
Tested up to: 3.4.2
Stable tag: 1.4.5
License: GPLv2 or later (http://www.gnu.org/licenses/gpl-2.0.html)

Description

Postie offers many advanced features for posting to your blog via e-mail, including the ability to assign categories by name, included pictures and videos, and automatically strip off signatures. It also has support for both imap and pop3, with the option for ssl with both. For usage notes, see the other notes page

What's new?

Installation

Automating checking e-mail

By default, postie checks for new e-mail every 30 minutes. You can select from a number of different checking intervals in the settings page, under the mailserver tab.

If you would prefer to have more fine-grained control of how postie checks for mail, you can also set up a crontab. This is for advanced users only. If your site runs on a UNIX/linux server, and you have shell access, you can enable mail checking using cron; if you don't know anything about cron, skip to the cronless postie section.

Setup a cronjob to pull down the get_mail.php Examples:

*/5 * * * * /usr/bin/lynx --source http://blog.robfelty.com/wp-content/plugins/postie/get_mail.php >/dev/null 2>&1

This fetches the mail every five minutes with lynx

*/10 * * * * /usr/bin/wget -O /dev/null http://blog.robfelty.com/wp-content/plugins/postie/get_mail.php >/dev/null 2>&1

This fetches the mail every ten minutes with wget

Frequently Asked Questions

Postie won't connect to my mailserver. Why Not?

Make sure the port you are using is open. For example, bluehost seems to block ports 993 and 995 (for pop3-ssl and imap-ssl) by default. I have heard that you can request that they open them for you ( you might have to pay extra).

You can check for open ports with the following command on your server: netstat -ln|grep -E ':::(993|995|143)'

If nothing shows up, then the ports are not open.

How can I get postie to display inline images?

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)

Mail is not showing up right when I send html (rich formatted) e-mail!

Make sure you set the preferred text type to html

Do I need to any code to my theme for postie to work?

No.

I read somewhere to add an iframe to my footer. Should I do this?

No. Do not add an iframe in your footer to get postie to check mail periodically. To check e-mail periodically, either set-up a cron job, or use cronless postie. See installation instructions

My mail host requires SSL, but postie will not allow me to select pop3-ssl or imap-ssl

You must have php-imap installed on your server for this to work. Ask your hosting provider about this.

Can I use postie to check a gmail account?

Yes. You can use either pop3-ssl or imap-ssl with a gmail account. Before attempting to use with postie, make sure that you enable pop or imap in your gmail preferences.

My posts show up as being posted by 'admin' instead of me. Why?

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 e-mails from johndoe@gmail.com. It doesn't matter which e-mail 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 e-mail to your postie address from an e-mail address that is no t linked to a wordpress user, it will get posted as admin.

Images aren't showing up at all?

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 there is probably 1 or 2 problems: 1. Your server does not have the php-gd library installed. Ask your hosting provider about this.

  1. Your wp-content/uploads directory is not writable by the webserver. Make sure that it is

Can I delete the wp-files directory needed by postie version <1.3.0?

If you have posts published already by older versions of postie, getting rid of those directories will delete any files you might have had associated with those old posts. If you don't have any such posts, then you can safely delete them.

How can I get rid of stupid stuff my e-mail provider adds to my messages?

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

How can I add custom attachment icons?

Simply upload the icons you want to the postie/icons/custom directory. You must name the icons according to the following scheme: {filetype}-{size}.png

For example, for word documents, you could use:

doc-32.png

for a 32x32 pixel icon. (You can actually create any size icon you want, but if you name it 32, then it will only be used if you select to use size 32 icons)

See the other directories in icons for more examples.

Currently the following filetypes are supported:

Can I add special text to the body of the post when using postie?

Yes. You can create your own function, and use the postie_post filter. Two short examples are included in the filterPostie.php.sample file

Can I add special text to the title of the post when using postie?

Yes. You can create your own function, and use the postie_post filter. Two short examples are included in the filterPostie.php.sample file

Can I select tags or categories based on the content of the e-mail?

Yes. You can create your own function, and use the postie_post filter. See the filterPostie.php.sample file for examples.

Is the IMAP extension required for postie?

The IMAP extension is not required, but it is strongly recommended, especially is you are using non-English text. There is more information on php.net about installing the IMAP extension. If you have control over your server, it is often not hard to install.

On Ubuntu, try sudo apt-get install php5-imap

On Fedora, try sudo yuminstall php-imap

The IMAP extension is known to be installed on the following popular webhosts: * Dreamhost

How can I embed youtube or vimeo videos?

Simply put the url in the body of your e-mail. (Make sure that you have the option to convert url into links turned on)

Screenshots

  1. Postie options (showing video and audio templates)

Changelog

1.4.5

1.4.4 (2012.08.10)

1.4.3

1.4.2 (2011.01.29)

1.4.1 (2010.06.18)

1.3.4 (2009.10.05)

1.3.3 (2009.09.11)

1.3.2 (2009.08.27)

1.3.1 (2009.08.24)

1.3.0 (2009.08.14)

1.3.beta (2009.07.01)

1.3.alpha (2009.06.05)

1.2.3 (2009.05.17)

1.2.2 (2009.05.15)

1.2.1 (2009.05.07)

1.2 (2009.04.22)

1.1.5 (2009.03.10)

1.1.4 (2009.03.06)

1.1.3 (2009.02.20)

1.1.2 (2008.07.12)

<

pre%gt; tags

1.1.1

Below is all the of the version information. As far as I can tell there once was a guy named John Blade. He took some of the original wp-mail.php code and started hacking away on it. He actually got pretty far. About the time I discovered WordPress and his little hack - called WP-Mail at the time - he went on a vacation or something. There were some problems with the script, and it was missing some features I wanted. I hacked away at it and got it into a place where it did what I wanted. I started posting about it since I figured other people might want the features.

John didn't release any more versions at least up til July 2005. So I started accepting submissions and feature requests from people to help make the code better. In June/July 2005 I discovered a little plugin by Chris J Davis (http://www.chrisjdavis.org/cjd-notepad/) called notepad. I added a small feature to it (basically a bookmarklet). In the process I started looking at his code and realized how much you could do with the plugin system available in Word Press.

So I decided to make an offical fork. I put up an article on my blog asking for new names. I picked Postie. I then modified the code to be a proper plugin. And the rest is history :)

1.1

1.0

0.9.9.3.2

0.9.9.3.1

0.9.9.3

0.9.9.2

0.9.9.1

0.9.9

0.9.8.6

0.9.8.5

0.9.8.4

0.9.8.3

0.9.8.2

0.9.8.1

0.9.8

0.9.7

0.9.6

0.9.5.2

0.9.5.1

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9

0.312.13

0.312.12

0.312.11

0.312.10

0.312.9

0.312.8

0.312.7

0.312.6

0.312.5

0.312.4

0.312.3-HEY (2005-05)

0.312.2

0.312.1

0.312 - 2005-03

0.311 - 2005-01

0.31 - 2004-12 & 2005-01

0.3 - 2004-09

0.2 - 2004-08

0.1 - 2004-06

Upgrade Notice

1.4.4
Fixed possible XSS attack vulnerability

Usage

Category and tag handling

Image Handling

{CAPTION} 
* {THUMBNAIL} gets replaced with the url to the thumbnail image
* {MEDIUM} gets replaced with the url to the medium-sized image
* {LARGE} gets replaced with the url to the large-sized image
* {FULL} gets replaced with the url to the full-sized image
* {FILENAME} gets replaced with the absolute path to the full-size image
* {RELFILENAME} gets replaced with the relative path to the full-size image
* {CAPTION} gets replaced with the caption you specified (if any)
* {WIDTH} gets replaced with width of the photo
* {HEIGHT} gets replaced with the height of the photo

Interoperability

Re-Edit your Readme File