=== Plugin Name ===
Contributors: CadetCrusher
Donate link: http://xforward.com/
Tags: email posting, image attachments, media attachments, mobile posting, post by email, video posts, WordPress plugin
Requires at least: 2.3.1
Tested up to: 2.3.2
Stable tag: 1.0.2

PostMaster plugin processes all posts-by-email, extracting any attached files and embedding them into the 
body of the post.

== Description ==

The PostMaster plugin allows you to make posts-by-email with multimedia attachments. It processes all 
incomming email-posts, extracts the attachments, and embeds them into the post body. It currently supports 
image and mobile video (3g2) MIME types, with more to come in the future (hopefully). If you want to post entries from your mobile phone, then 
this is the plugin for you!

You can control how media is embedded in the post body by editing PostMaster templates. There is a template 
for each media type group (images, videos, etc).

Visit [xforward.com](http://blog.xforward.com/?page_id=65) for more information and updates.


== Installation ==

This section describes how to install the plugin and get it working.

1. Upload the 'postmaster' directory to the '/wp-content/plugins/' directory of your WordPress installation.
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Create a cron job to run the wp-mail.php script (e.g. wget -N http://yourdomain.com/wp-mail.php). This is necessary in order to make
WordPress check it's email account periodically. For more info on this see this page [WordPress Blog by Email](http://codex.wordpress.org/Blog_by_Email).
4. Start sending emails with attachments to your blog-by-email account.

== Frequently Asked Questions ==

= What video formats are supported ?=

Currently (1.0.2) only the 3g2 format is supported (actually it supports application/octet-stream MIME type). You can try other video formats, but it is not guaranteed that they will work.

= Are there any guidelines I should follow when sending an email post? =

Yes.
Don't use 2 dashes in a row ('--') in your body text. This will cause the parser to prematurely truncate your message.
I am working on a fix for this.

= My email-posts aren't showing up correctly. What's the deal? =

It could be due to the email service you are using. Unfortunately, not every email service sends attachments the same way. PostMaster has been tested using Gmail and a standard POP3 SMTP server.
If you would like your email service supported by PostMaster, send the following information to pm_requests@xforward.com
1. The name of the service (i.e. @hotmail.com)
2. A text file containing the output produced by PostMaster. This would be the actual markup of the post that was generated.
3. Any other information that might be useful (message sent through webmail, pop client? Were you sending video, image, none? etc).

= My attachments aren't showing up in the post, why? =

This may be due to the fact that the directory you have chosen to save attachments to does not exist, does not have the proper permissions, or is outside of the 
WordPress root directory.

= My video isn't embedding correctly, why? =

The default video template has been tested with 3g2 video and FireFox. I don't guarantee it will work with other video format's or browsers.

= I found a bug, you dolt! How can I punish you? =

Send any bugs to pm_bugs@xforward.com
Send any feature requests to pm_requests@xforward.com