=== Postie === Contributors: WayneAllen Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HPK99BJ88V4C2 Author URI: http://allens-home.com/ Plugin URI: http://PostiePlugin.com/ Tags: e-mail, email, post-by-email Requires at least: 3.0 Tested up to: 4.0 Stable tag: 1.6.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Postie allows you to create posts via email, including many advanced features not found in WordPress's default Post by Email feature. == Description == Postie offers many advanced features for creating posts by email, 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](other_notes) page More info at http://PostiePlugin.com/ = Features = * Supports IMAP or POP3 servers * SSL and TLS supported * Control who gets to post via email * Set defaults for category, status, post format, post type and tags. * Set title, category, status, post format, post type, date, comment control and tags in email to override defaults. * Specify post excerpt (including excerpt only images). * Use plain text or HTML version of email. * Remove headers and footers from email (useful for posting from a mailing list). * Optionally send emails on post success/failure. * Control the types of attachments that are allowed by file name (wildcards allowed) and MIME type. * Optionally make the first image the featured image. * Gallery support. * Control image placement with plain text email. * Templates for images so they look the way you want. * Templates for videos. * Templates for audio files. * Templates for other attachments. * Email replies become comments. = Developers = * Several filter hooks available for custom processing of emails. == Screenshots == 1. Postie server options 2. Postie user options 3. Postie message options 4. More message options 5. Even more message options 6. Image options 7. Video and Audio options 8. Attachment options == Installation == * Either: * Put the postie.zip file in wp-content/plugins/ and unzip it * Or: * Use the automatic installer (WP 2.7+) * Login to WordPress as an administrator * Goto the Plugins tab in the WordPress Admin Site * Activate "Postie" * Goto to the "Settings" tab and click on the sub-tab "Postie" to configure it. * Make sure you enter the mailserver information correctly, including the type of connection and the port number. Common port configurations: * (Postie ignores the settings under Settings->Writing->Writing-by-Email) == Usage == = Specifying Beginning and Ending of Post = * If you put in :start - the message processing won't start until it sees that string. * If you put in :end - the message processing will stop once it sees that string. = Post Status = * Posts can have their status set to draft, publish, pending or private. This will override the Default Post Status set in the settings screen. * status: private * status: draft = Post Date = * Posts can have a specific publication date such as Apr 14, 2013. Relative dates like "tomorrow", "monday", "first day of next month" are also supported. * date: date * date: date time * Posts can be delayed by adding a line with delayXdXhXm where X is a number. * delay:1d - 1 day * delay:1h - 1 hour * delay:1m - 1 minute * delay:1d2h4m - 1 day 2 hours 4m = Comment Control = * By putting comments:X in your message you can control if comments are allowed * comments:0 - means closed * comments:1 - means open * comments:2 - means registered only * Replying to an e-mail gets posted as a comment. * For example, you e-mailed a post with the subject line "foo". If you then send an e-mail with the subject line "Re: foo", it will get posted as a comment to the "foo" post. This works by the subject line, so if you have two posts with titles "foo", then the comment will get placed in the more recent post. = Post Excerpt = * Custom excerpt * You can include a custom excerpt of an e-mail by putting it between :excerptstart and :excerptend * You can include images in the excerpt by using the shortcode #eimg1#, #eimg2# etc. = Post type/format = You can specify the post type or format by including it as the first part of the subject followed by 2 forward slashes (//). E.g. aside//real subject = Categories = * If you put a category name in the subject with a : it will be used as the category for the post * If you put a category id number in the subject with a : it will be used as the category for the post * If you put the first part of a category name it will be posted in the first category that the system finds that matches - so if you put Gen: New News The system will post that in General. Note you must turn on the "Match short category" setting for this to work (on by default). * All of the above also applies if you put the category in brackets [] * Using [] or you can post to multiple categories at once Subject: [1] [Mo] [Br] My Subject On my blog it would post to General (Id 1), Moblog, and Brewing all at one time * Using - or you can post to multiple categories at once Subject: -1- -Mo- -Br- My Subject On my blog it would post to General (Id 1), Moblog, and Brewing all at one time = Tags = * You can add tags by adding a line in the body of the message like so: tags: foo, bar * You can also set a default tag to be applied if no tags are included. = Image Handling = * Allows you to attach images to your email and automatically post them to your blog. * You can publish images in the text of your message by using #img1# #img2# - each one will be replaced with the HTML for the image you attached * Captions - you can also add a caption like so: * #img1 caption='foo'# * #img2 caption='bar'# Or, if you use IPTC captions, this caption will be used (adding a caption in many photo editing programs (for example Picasa), will add an IPTC caption) Note that the images are processed in the order they are attached as of version 1.4.6. Note you can only use the #img# feature if your "Preferred Text Type" is set to "plain" * Image templates Postie now uses the default wordpress image template, but you can specify a different one if you wish. You can also specify a custom image template. I use the following custom template: `
` * {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 * {FULL} same as {FILELINK} * {HEIGHT} gets replaced with the height of the photo * {ID} gets replaced with the post id * {IMAGE} same as {FILELINK} * {LARGEHEIGHT} gets replaced with the height of a large image * {LARGEWIDTH} gets replaced with the width of a large image * {LARGE} gets replaced with the url to the large-sized image * {MEDIUMHEIGHT} gets replaced with the height of a medium image * {MEDIUMWIDTH} gets replaced with the width of a medium image * {MEDIUM} gets replaced with the url to the medium-sized image * {PAGELINK} gets replaced with the URL of the file in WordPress * {RELFILENAME} gets replaced with the relative path to the full-size image * {THUMBHEIGHT} gets replaced with the height of a thumbnail image * {THUMB} gets replaced with the url to the 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) = Interoperability = * If your mail client doesn't support setting the subject (nokia) you can do so by putting #your subject/title here# at the beginning of your message * POP3,POP3-SSL,IMAP,IMAP-SSL now supported - last three require php-imap support * The program understands enough about mime to not duplicate post if you send an HTML and plain text message * Automatically confirms that you are installed correctly == Frequently Asked Questions == Please visit our FAQ page at http://postieplugin.com/faq/ == Upgrade Notice == = 1.6.0 = Remote cron jobs need to update the URL used to kick off a manual email check. The new URL is http:// 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 :)
* BUGFIX -problem with subject
* BUGFIX -cronless postie typo
= 1.1 =
* FEATURE: Updated and tested with WordPress 2.1
* BUGFIX:Removed deprecated functions
* FEATURE: Cronless Postie now uses the WordPress native Psuedo Cron.
= 1.0 =
* BUGFIX: TestWPVersion broke with 2.1
* FEATURE: end: now marks the end of a message (Dan Cunningham)
* FEATURE: Better Readme (Michael Rasmussen)
* FEATURE: Smart Sharpen Option -EXPERIMENTAL- (Jonas Rhodin)
* BUGFIX: Issue with google imap fixed (Jim Hodgson)
* BUGFIX: Fixed espacing issue in subjects (Paul Clip)
* BUGFIX: Typo in Div fixed (phil)
= 0.9.9.3.2 =
* BUGFIX: Typo
= 0.9.9.3.1 =
* BUGFIX: Removed debugging code
= 0.9.9.3 =
* BUGFIX: If your email address matches an existing user - then it will post as that user - even if you allow anyone to post.
* BUGFIX: Replaced get_settings('home') with get_settings('siteurl')
* BUGFIX: Better handling for Japanese character sets - Thanks to http://www.souzouzone.jp/blog/archives/009531.html
* BUGFIX: Better thumbnail window opening code - thanks to Gabi & Duntello!
* FEATURE: Added an option to set the MAX Height of an image - idea from Duntello
* BUGFIX: Modified the FilterNewLines for better flowed text handling - You now HAVE TO PUT TWO NEW LINES to end a paragraph.
* FEATURE: Added new CSS tags to support positioning images/attachments/3gp videos
* BUGFIX: Tries to use the date in the message (Thanks Ravan) I tried this once before and it never worked - hopefully this time it will.
* BUGFIX: Added a workaround to fix the problem with Subscribe2 - it will now notify on posts that are not set to show up in the future.
= 0.9.9.2 =
* BUGFIX: Looks for the NOOP error and disgards it
* FEATURE: Postie now detects the version of WordPress being used
* FEATURE: Smarter Parsing of VodaPhone
* FEATURE: Easy place to add new code to handle other brain-dead mail clients
* BUGFIX: Handles insertion of single quotes properly
* BUGFIX: Thumbnails should now link properly
= 0.9.9.1 =
* BUGFIX: Needed a strtolower in places to catch all iso-8859 - thx to Gitte Wange for the catch
* BUGFIX: Fixed issue with the category not being posted properly
= 0.9.9 =
* UPDATE TO WP 2.0
* BUGFIX: Config Page now works
* FEATURES: Supports role based posting
* BUGFIX: Posting updates the category counts.
= 0.9.8.6 =
* BUGFIX: Fixed problems with config page <%php became (Full Name) supported
* BUGFIX: Some images that were not being resized - are now
* BUGFIX: HTML problems - if you posted plain text with HTML on it ignored all images
* BUGFIX: The test system blew up on the thumbnails
* BUGFIX: Selected HTML for preferred text is now shown in the config form properly
* BUGFIX: Postie now complains if it is not in its own directory
* BUGFIX: Postie doesn't include PEAR if it is already available
* BUGFIX: In Test mode rejected emails are simply dropped
* BUGFIX: Markdown messes up Postie - it will warn you if you turn it on.
*
= 0.9.8.3 =
* BUGFIX: Fixed issue with the line feed replacement
* BUGFIX: Added Banned File Config back in
* FEATURE: Added in a link around 3gp video embedded via QT
* BUGFIX: Email that has both Plain and HTML content will show the HTML content and not the plain if html is preferred
= 0.9.8.2 =
* BUGFIX: Fixed an extra new line after attaching non-image files.
* BUGFIX: The Test system now displays any missing gd functions
* BUGFIX: The test system was only using ImageMagick
= 0.9.8.1 =
* BUGFIX: The test images are now included in the zip
= 0.9.8 =
* BUGFIX: New Lines detected and handled properly in cases where the mail client doesn't put a space before the new line (Miss Distance)
* BUGFIX: 3gp mime type added (Paco Cotera)
* BUGFIX: Authorized Email Addresses are not case-insensitive
* FEATURE: The larger image now does a proper pop up
* BUGFIX: Fixed Timeing Issue - turns out it wasn't reading the db at all
* FEATURE: New Test Screen - to help track down problems
= 0.9.7 =
* BUGFIX: removed all short tags
* BUGFIX: There were spacing issues in the way I wrote the QT embed statements
* FEATURE: Added calls to WP-Cron - should work with that properly now if you activate Cronless Postie
* FEATURE: ImageMagick version works without any calls to GD
* BUGFIX: Postie now correctly handles cases wjere tjere are multiple blogs in one db
* BUGFIX: Turned off warnings when using without GD
* FEATURE: add the rotate:X to your message to rotate all images
* FEATURE: new filter_postie_thumbnail_with_full which makes it easy to show a thumbnail on the front page but full image on the single page - see FAQ
= 0.9.6 =
* BUGFIX: handles email addresses that are no name and just (Steve Cooley Reported)
* FEATURE: Basic support for embedding flash files
* BUGFIX: Postie now handles creating the correct URL on non Unix platforms
* BUGFIX: Fixed problem with file attachments not being put in the right place.
* FEATURE: You can now choose to use imagemagick convert to handle making thumbnails
* BUGFIX: Rewrote Cronless Postie to use direct sockets
* BUGFIX: Time offset is now settable just for Postie - hopefully this will fix problems for cases where the normal time offset doesn't work properly.
* FEATURE: First draft of frame for a 3GP video
* FEATURE: Option to embed 3GP in QuickTime Controller.
= 0.9.5.2 =
* BUGFIX: gmt variable not being set correctly
* BUGFIX: Changed the name of the Check Mail button to fix an issue with mod_security
* BUGFIX: Fixed issue with Cronless-Postie
* BUGFIX: There was an argument passed by reference incorrectly
* FEATURE: Added in Cronless Postie Readme
* FEATURE: Added in Postie Readme
= 0.9.5.1 =
* BUGFIX: Confirmed POP3-SSL on debian-3.0
* BUGFIX: Updated the plugin version
* BUGFIX: Stopped displaying the email account
*
= 0.9.5 =
* BUGFIX: Postie handles cases where you do not have GD
* FEATURE: You can now set the access level for posting - so other people can use the gate way
* BUGFIX: Fixed issue when admininstrator email is not tied to a user account.
* FEATURE: Can now reset all Postie configurations back to defaults
* BUGFIX: HTML Emails with embedded images are now handled properly.
* BUGFIX: The time difference should work correctly now
* BUGFIX: Postie's configs are completely seperate from Writing-By-Mail
* FEATURE: Warning if you use Gmail to make sure you turn on POP support
* BUGFIX: Manual Check Mail Button in interface
* BUGFIX: fixed issue of compatability with cjd-notepad
* BUGFIX: Windows Works Now
= 0.9.4 =
* BUGFIX: Cronless Postie - fixed the include statement
* BUGFIX: Authorized Addresses now supports a single address
* FEATURE: All configuration in Postie done in a single screen
* FEATURE: AUTHORIZATION can be completely overridden
* BUGFIX: line 1159 - didn't handle cases where the table didn't exist already very well
* FEATURE: Detects if you can do IMAP
* FEATURE: Added IMAP Support
* FEATURE: Added IMAP-SSL Support
* FEATURE: Added POP3-SSL Support
= 0.9.3 =
* Bug fixes for IIS
= 0.9.2 =
* Moved to more of a DIRECTORY_SEPARATOR structure
= 0.9.1 =
* Added a define to fix a problem with over including
= 0.9 =
* Converted to an honest to god plugin
* BUGFIX: If you put a single category:subject it now works
* BUGFIX: ? Special characters may be supported? The test post now shows a lot of umlats and accents?
* BUGFIX: The last ] in a subject with categories is now filtered out
* FEATURE: -1- subject - will put the post in category 1
= 0.312.13 =
* Code clean up - The main loop is finally readable by even non programmers
* FEATURE - You can now post to multiple categories at one time by using the [#],[Category Name], [Cat] in the subject
* FEATURE - You can now select a category by just including the begining characters [G] will select General
* if you don't have any other categories that start with g
* FEATURE - Jay Talbot - added a new feature so you can have multiple email addresses be allowed in
* Make multi category posting more obvious
* BUG FIX: Timezones of GMT+? should now work properly
* BUG FIX: Able to handle mis-mime typed images as long as they are named with .jpg/.gif/.png
= 0.312.12 =
* Code clean up - slowing shrinking the main to make it easier to fix things
* FEATURE: Be able to turn on/off allowing comments in an email
* BUG FIX: AppleDouble now mostly supported
* BUG FIX: MIME handling improved.
* BUG FIX: Fix issue with timing delay
= 0.312.11 =
* FEATURE: Patterns to define where a sig starts are user configurable
* FEATURE: Add filter options for banned file names
* BUG FIX: Made it possible to turn off posting to the db for testing purposes
= 0.312.10 =
* FEATURE: Added in code to diplay the mime type of the file being linked to
* BUG FIX: It now tests for the existance of the directories and makes sure
* that the web server can write to them
= 0.312.9 =
* FEATURE:Should handle jpg as well as jpeg as the file type
* BUG FIX: Now correctly handles the subject in the message
* BUG FIX: Should handle Text preferences correctly
= 0.312.8 =
* Some general code tidying.
* FEATURE: Can now have email from invalid email addresses automatically forwarded
* to the admin's email account. This forward includes all attachments.
* Props to David Luden for getting this started.
* Minor change: The system will continue if it runs into a message that doesn't have
* any content - it will also continue to process if it gets an email from
* someone not in the system. In the past this could result in deleted mail
* if your cron job didn't run often enough.
= 0.312.7 =
* Confirm the handling of 3gp video for cell phones o
* Added in new directive SUPPORTED_FILE_TYPES -if the mime type is listed here then the system will try to make a link to it without making a thumb nail.
= 0.312.6 =
* Bug Fix: Ok the last bug I fixed - actually caused another bug - man I should set up some unit tests. Now it handles mail from the nokia mail client correctly.
= 0.312.5 =
* Bug Fix : The system was accepting all text/* types. Now you can set a preference (defaults to text/plain)
* to use as the main text for the post.
= 0.312.4 =
* Added in sanitize_title call suggested by Jemima
* Added in ability to provide a subject in an mms - by using #Subject#
* Fixed an issue with the time stamp system so it now automatically uses the gmt_offset from WordPress
* Fixed issue with the delay:1d1h tag that prevented it from being removed from the body.
* Fixed issue with the delay tag that caused problems if it was the last thing before an image.
= 0.312.3-HEY (2005-05) =
* > Some changes and Bugfixes by Adrian Heydecker
* > Not (yet) in main development branch.
* Fixed bug: JPEG-thumbnails had a bigger filesize than full images caused by bad hardcoded compression value.
* Fixed bug: If images and signatures were present but no placeholder tags, the images were deleted together with the signature.
* Fixed bug: Generates valid postnames for users of mod_rewrite. Permalinks to posts should now work even when whitespaces are present in the subject line.
* Added support for Quoted Printable encoded mail.
* Added ability to encode Wordpress-posts in charset ISO-8859-1 instead of UTF-8.
* Added ability to choose JPEG-compression value for thumbnails.
* Added ability to add class="" and style="" to images.
* Added ability to use a different mailadress (eg. mobile) without setting up a new Wordpress-account.
= 0.312.2 =
* BUGFIX: It now removes the delay tag from the message
= 0.312.1 =
* Added modification for placeholder support for images (David Luden)
* Added in support to automatically scale down big images (Dirk Elmendorf)
* Fixed bug with multiple emails all getting the contents of the first image tag (Dirk Elmendorf)
* Added option to allow HTML in the body and subject of the email (Dirk Elmendorf)
* Switch config options to defines to reduce the number of global variables (Dirk Elmendorf)
* Added tests to make sure there is a trailing slash on the DIR definitions (Dirk Elmendorf)
* Add tests to see if they have gd installed (Dirk Elmendorf)
* Separate the scaling out to a function for easier usage (Dirk Elmendorf)
* Add delay feature for future posting. (Dirk Elmendorf)
* Added in ability to use strtotime if it is available (Dirk ELmendorf)
= 0.312 - 2005-03 =
* CHANGE FOR DEFAULT E-mail Categories, instead of [General] Subject you can now use General: Subject in the subject line. Less typing, and there must be a space after the colon.
* Fixed bugs with no default posting for categories and user
= 0.311 - 2005-01 =
* eep, major bug for pop3 server. Next time I test my code more before I released, fixed so that pop3 now works.`
= 0.31 - 2004-12 & 2005-01 =
* (Has it been this long, best get back into the swing of things... did most of this coding on my holiday as I didn't have a machine to play WoW on :)
* moved the deletion of pop3 emails into a check so that e-mails aren't deleted without proper checking.
* added HTML 'decoding' (basic support for Thunderbird & Outlook)
* updated the Category search so that it matches words as well as numbers (i.e. [General] Subjectname will work instead of just [1] Subjectname)
* Changed time function from time to strtotime (as per Senior Pez's suggestion), but found out that strtotime isn't in default php distro so removed...
= 0.3 - 2004-09 =
* Added UBB decoding support
* Added default title (when there is no subject assigned)
* Started doing a little code cleanup, been reading Advanced PHP Book :)
*
= 0.2 - 2004-08 =
* Stopped using pear body decoding in favour of own decoding (may be slower but more modifiable) because of enriched text decoding
* Added base64_decode checking (may help mobile phone users)
* Fixed Subject line for non-english users (htmlentities instead of just trim)
* Fixed error in some pop hanging -> more graceful exit on event on no emails in inbox ($pop3->quit)
* Added work around for email addresses with exta <> in field (ie: instead of blade@lasmash.com
* Added some ===basic=== enriched text support
* Updated readme file for easier install
* Easy modify of globals (such as PHOTOSDIR and FILESDIR)
* Cleaned up some pear stuff in install
*
= 0.1 - 2004-06 =
* First release