TweetUpdater

TweetUpdater will send a message to your Twitter account, from you WordPress installation, whenever a new post is published, or when a previously published post is updated; as you choose. The tweet format is flexible, with placeholders for title and URL. URLs can be included from a variety of sources. In addition to full post permalinks (standard or friendly urls as selected in your site setup) the following short url services are supported: Internal services:

• la petite url plugin
• WordPress Permalink

Generic shorteners

• YOURLS

External services:

• Bit.ly
• Stwnsh
• TinyURL

Posts tweeting can be ommited based on post category, or custom field, or custom field and value pair. Derived from the original TwitterUpdater, version 3 has been fully rewritten to include OAuth authorisation with Twitter; because basic authentication (username & password) has now been deactivated for applications using the Twitter API. The TwitterUpdater plugin has a great tradition of being updated and improved by anyone who needed it to do something different, and as such TweetUpdater is one of a handful of TwitterUpdater forks. If the short url service you like to use is not included, please see the FAQ on how to add it. If you add a service, let me know and I'll add the code to the next release.

• Support & Bug reports at github.com/DefProc/TweetUpdater/issues

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

1. Download and extract the plugin from the zip file
2. Copy the plugin folder into the /wp-content/plugins/ directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Link the plugin with your Twitter account by following the instructions on the new TweetUpdater Settings page.

To Upgrade: Either upgrade automatically from your admin pages. Or if upgrading manually: deactivate TweetUpdater before copying the new files across; then enable when completed.

• You will keep your settings when you upgrade from version 3.x and above
• TweetUpdater will remain linked to your Twitter account when you upgrade from version 3.x or above.

Requirements:

• php cURL

TweetUpdater uses the php cURL module to retrieve external short URLs and to contact Twitter. Your server will need to have cURL installed and activated for TweetUpdater to function. For most hosting providers, it will be installed already. Check <?php phpinfo() ?> if you're not sure if cURL is activated.

3.1

• Added "limit by category or custom field" (LimitCategory Branch) - From BjornW.
• Added tweet length checking, will trim the title and force shortening of long urls to keep tweets under 140 characters.
• Added generic YOURLS shortener support - for both public and private installations. Can use timestamp-hashed secret keys (preferred) or usename/password combo (sent in plaintext).
• Removed CURL dependency for short URL retreval, replaced with WP_Http (CURL is still required for sending updates to Twitter).
• Removed zz.gd as a shortener option (service has closed).

3.0.1

• Rearranged URL selection to internal/external sources.
• Added Welsh language URL shortener - From Gareth Jones, Stwnsh.
• Added warning if Bit.ly is selected without API credentials.

3.0

• Changed name to TweetUpdater
• Uses OAuth as the Twitter account authentication method. (Uses the TwitterAuth php library from Abraham)
• Updated the settings page to better fit in with the WordPress styles.
• Reduced the number of entries in the wp-options table to 2 by using arrays.
• Renamed functions and DB entries to reduce the chance of collision with other plugins.
• Complete code revision.
• Revised documentation.
• Set cURL as standard retrieval method for short URLs
• Added Settings link on plugins admin page
• Added to the WordPress Plugins Directory.
• Updated functions for WP 3.0.1

Previous to version 2.11, this plugin is the same as TwitterUpdater. 2.11 http://www.deferredprocrastination.co.uk

• Added support for la_petite_url plugin
• Add #url# placeholder instead of "Link title to blog?" checkbox
• Added option to use full WordPress permalink as url

2.10 Jordan Trask "@comm"

• Added support for Bit.ly

2.09 Jordan Trask "@comm" - http://geektank.net/

• ZZ.gd broke with 403 forbidden error, fixed with setting different user agent.
• Move menu to "Settings".
• Added option under configuration to choose ZZ.gd or TinyURL. Added 1 function.
• Re-worked the code for url shortening services, change in one place instead of three. Created a function instead. which makes it easier to add more services if necessary. Bit.ly support in the future?

2.08 Eric Austin Lee - http://www.ericaustinlee.com

• Corrected to fit new needs of Wordpress 2.7

2.07.1 Ingo "Ingoal" Hildebrandt (v2.07.1)

• corrected tinyurl-api-url...

2.07 Marco Luthe - http://www.saphod.net

• Changed "save_post" hook to "publish_post"
• Added "future_to_publish" hook and vc_twit2

2.06 Ingo "Ingoal" Hildebrandt

• added cascading short-url generation (if zz.gd is down, it'll cascade to tinyurl.com)

2.05 Ingo "Ingoal" Hildebrandt

• added alternative method to get shorturl (using curl instead of fopen)

2.04 Ingo "Ingoal" Hildebrandt

• fixed character escaping in post-title ( ' and & )
• fixed empty post-title when scheduled post appears

2.03 Ingo "Ingoal" Hildebrandt

• fixed the multi-tweet issue in WP2.6 (due to post revisions the same post was twittered multiple times before)
• streamlined the options...only new posts and edited old-posts from now on out...

2.02 Ingo "Ingoal" Hildebrandt

• added twitter source parameter to replace "from web"

2.01 Ingo "Ingoal" Hildebrandt - http://www.ingoal.info/archives/2008/07/08/twitter-updater/

• replaced tinyurl-support with zz.gd-support even shorter short-url

2.0 Jonathan Dingman (v2.0) - http://www.firesidemedia.net/dev/software/wordpress/twitter-updater/

• added tinyurl-support

1.0 Based on Version 1.0 TwitterUpdater by Victoria Chan - http://blog.victoriac.net/ja/geek/twitter-updater