Hot fix update

If you downloaded the AAG WordPress Remote Poster before September 09, 2011 please redownload the zip file again and reinstall it. There was a bug that was missed prior to rollout and although it won’t affect the functionality of the script from a user stand point, there was still something that had to be fixed.

All you have to do is redownload the file. You can copy your configuration from your working copy over the configuration of the new copy. No changes to the config section was made so it could be a seamless install.

UPDATE:It hasn’t been two days since its official release and we’ve had HUNDREDS of downloads already! Thank you! And remember, if you want a free backlink to your blog be sure to use the metrics option as public!


Download v.04 of the WordPress Poster [here]


The WordPress Poster enables a WordPress blogger to literally submit content to their blogs at any time from any where, so long as there is an internet connection. Sometimes it is more convenient to write yourself an email or type up a multi-post TXT file and send it over to your web server than it is to load your blog and manually create posts.

Tip: For bloggers who like to blog at work but fear getting in trouble from visiting your blog! You never have to launch your blog at all, all you need is to send an email to yourself and WOALA! The posts will automatically appear on your blog!


  • Post to your WordPress blog from ANYWHERE there is an internet connection!
  • Automatically post to your WordPress blog through email!
  • Automatically post to your WordPress blog through FTP!
  • The only WordPress remote poster that allows unlimited posts per attachment/ftp log AND unlimited attachment/ftp log scanning. Load up hundreds of posts at once if you want!
  • Fully documented tag system with examples so you know how to use the system
  • The only WordPress remote poster that fixes the “smart quotes” problem!
  • The only WordPress remote poster that allows you to post under ANY registered account (author rights or above)! That’s right, you can have others post content to your blog with their accounts!
  • Optional metrics allowing free linkbacks to your blog
  • Easy to set up and get going in under 10 minutes!


  • Web server with Perl
  • Mail::Pop3Client perl module (not standard)
  • Mail::MboxParser::Mail perl module (not standard)
  • List::Util perl module (standard)
  • WWW::Mechanize perl module (standard)


    1) Transfer to your web server (typically in the cgi-bin)

    2) Set the file permissions (chmod) of the file to 755

    3) Make sure you have the required Perl modules installed. You may need to ask your web host to install the non-standard ones if they aren’t already installed

    4) Configure the script as detailed below.

    How to use this script:

    1) Decide if you want to use FTP or Email, or both

    2) Write yourself a .txt or .log file with the shortcodes and tags and attach it to your email or upload it to your site’s FTP location. (note: when using email, the content of the email is ignored. The only thing the script looks at are attachments).

    3) Load the script in your browser to make it “work”. Loading the script directly will make it scan the FTP or email locations and post the content to the blog. OR set up a chron job to run the script every X minutes or X hours. This can be done through Cpanel. If you have questions setting up a chron job, try asking your web host for assistance. My settings are set up to run the script every 10 minutes automatically.


    Incoming Email/Server settings
    $email_user Change to email address the script will be loading emails from
    $email_pass Change to password of above mentioned email account
    $email_server Change to mail server name, ie:
    $file_backup Change to full file path of directory to store backup files. Ie: /home/user/public_html/folder. Do not include a trailing /.
    $tag_check Set to 1 if you want the script to test for proper shortcodes. Script will not publish posts that contain errors. Set to 0 to not check for errors.
    $server_backup Set to 1 to back up all posts to the server as log files. Otherwise set to 0.
    $check_where Set to 1 for script to check an email account for content. Set to 2 for script to check an FTP location. Set to 3 for the script to check both email AND ftp locations.
    $ftp_loc Change to full file path of FTP location where it should check for content. Do not add trailing /.
    $rem_smart_quotes Set to 1 if you want the script to repair “smart quotes”. Othewise set to 0.
    Outgoing email settings (for confirmation email)
    $path_to_sendmail Change to location of sendmail. Typically it is /usr/sbin/sendmail
    $email Change to email address the confirmation email will be sent to
    $from_email Change to the FROM email address for the confirmation email to be sent from
    $subject Change to the message you want the confirmation email to use
    $verification Set to 1 if you want to receive confirmation of each post. Otherwise set to 0
    WordPress settings (to sign in and post to WordPress)
    $url_to_sign_on Change to the location of the wp-login.php file. Typically:
    $post_new Change to the location of the post-new.php file. Typically:
    Metrics settings
    $use_metrics Set to ‘yes’ to use metrics. Otherwise set to ‘no’
    $metric_type Set to ‘public’, ‘anony’, or ‘limited’.

    public: Tells the server how many posts you published via the script, the URL of your web site, the last post title and the last post link. *

    private: Tells the server how many posts you published via the script and the url of your web site. *

    anonymous: Tells the server how many posts you published via the script and the url of your web site (URL of web site is not made public). *

    * Other metrics that are recorded for all three options: whether or not you allowed gratitude_link, script version number. These metrics are always kept private.

    $gratitude_link Set to ‘yes’ to allow a small linkback to at the bottom of each post. Set to ‘no’ to not allow the linkback. Set to ‘maybe’ to post the linkback on approximately 10% of the posts.

    Why opt in to use metrics? It helps us track usage of the script to see how frequent we should update its features. Allowing metrics and choosing the non-anonymous options allows free publicity and a free link back to your site! Anyone who opts in will have their URLs posted.


    All shortcodes with exception to [:start] and ########## must appear twice to enclose the information for the shortcode. For example, to specify a particular post category the code would look like: [:categories]12[:categories].

    The [:start] shortcode has to be the first shortcode in the attachment or log file. It is used only once to tell the WordPress script where to start looking at content.

    The ########## shortcode is used to separate one attachment or log file into separate posts. This means it is possible to create one email attachment that contains any number of posts to create. To separate posts, use ########## between them.




    The shortcode should be self explanatory. Wrap the post title in [:title], tags in [:tags] separated by a comma, categories in [:categories], the content of the post in [:post] and status in [:status]. You’ll need to look at the HTML code to look for the category ID numbers to use this.

    The [:status] tag is different. It will publish in draft mode if this shortcode isn’t defined or set to publish. Set [:status]publish[:status] to make the post go live instantly.

    All shortcodes other than [:start] can appear in any order and they aren’t all required. The [:author] and [:password] shortcodes ARE required. If authentication is left off or fails, that particular post will not succeed. Whatever shortcodes you leave out will not be defined in the post.

    Complete list of shortcodes
    Start of email [:start]
    Author username [:author]
    Author password [:password]
    Post title [:title]
    Post tags [:tags]
    Post categories [:categories]
    Post content [:post]
    Post status [:status]
    Post separator ##########

    Shortcode Examples:

    Example 1: Use of all tags in one post




    [:title]Hello world![:title]

    [:tags]hello world, this is cool[:tags]




    This was posted with’s free WordPress poster!



    Example 2: More than one post in same attachment or log file AND not all codes used




    [:title]Hello world![:title]

    [:tags]another test, and more tags[:tags]




    This was posted with’s free WordPress poster!




    [:title]Another example with fewer tags[:title]




    This was posted with’s free WordPress poster!


    See it in action!!

    We have set up a fully functional version of this script for you to demo. Below you’ll find a sample post you can copy and paste into a .txt document and send to our mailbox at Feel free to change what it says, the order of the tags, remove some tags, etc (don’t remove the few required tags!). Note: The contents of the email and subject are ignored. Only attachments are parsed.

    As this is a demo, all of the posts are set up to go to our special category regardless of what you change that shortcode to. Also note the password for this user account is not the true password (so don’t try), the demo knows the real password. So although the field isn’t accurate, it still needs to exist in the script to prevent it from failing.

    Create your attachments, send them to and check them out [here]! The demo is set up to run off a chron job every 5 minutes, however if you are impatient and don’t want to wait you can launch the script directly [here]!

    Feel free to customize this for testing!

    [:tags]test post, wordpress poster,[:tags]
    [:title]Hello everybody! This was posted with the AAG WordPress poster![:title]
    This is a test post I created to see
    How this script would make my blogging life EASY!
    [:tags]second post in same text[:tags]
    [:title]Hello everybody! This was posted with the AAG WordPress poster![:title]
    This is the second post in the same attachment. Only AAG WordPress poster has this ability!

    Special Thanks

    We would like to thank Paul (from for the hours he put in testing the Remote WordPress Poster script and offering new ideas to improve its performance. If it weren’t for him, the FTP parser and “smart quote” filtering wouldn’t have been imagined in this update. Thank you for your help!


    For any questions or comments, please go to Look through the main threads for this script or start your own question!

    If you want to use the script but don’t have Perl installed or don’t want to try the installation yourself, please post on the boards at the above link. There are people around who’ll be able to help you.

    License Information

    This script is provided free of charge by Because it is free we do not guarantee or warantee the script in any way. We are not responsible for any issues it may cause.

    You may modify the script to suit your needs. You may not distribute any modified versions of this script, even without monetary gain, or customize it for others.

    VN:F [1.9.22_1171]
    Rating: 0.0/10 (0 votes cast)
    VN:F [1.9.22_1171]
    Rating: 0 (from 0 votes)