= sfMicroBlog Plugin =

== Overview ==
sfMicroBlogPlugin provides a tool box to manipulate microbloging sites.
Currently [http://twitter.com twitter], [http://identi.ca identi.ca] (or
any other [http://laconi.ca laconi.ca]) and [http://ping.fm pingfm] are
supported.

NOTE: this is a very early version of this plugin. It works for me. use
at your own risk.

== Installation ==

To install sfMicroBlogPlugin:

{{{
./symfony plugin-install symfony/sfMicroBlogPlugin
}}}

To install from svn:
{{{
svn co http://svn.symfony-project.com/plugins/sfMicroBlogPlugin plugins/sfMicroBlogPlugin
}}}

Clear your cache

{{{
./symfony cc
}}}

== Usage ==
The plugins includes 2 other libraries to use twitter API and pingFM api. I slightly modified the
twitter library to allow other urls and thus to use it on identi.ca.

Currently only the updateStatus function is properly wrapped:
{{{
	$options	= array('serviceName'	=> 'twitter',
				'username'	=> 'yourownusername',
				'password'	=> 'yourownpassword',
				);
	$microblog	= new sfMicroBlog($options);
	$microblog->updateStatus("example of sfMicroblog update");
}}}

To build a sfMicroblog object for identica: 
{{{
	$options	= array('serviceName'	=> 'identica',
				'username'	=> 'yourownusername',
				'password'	=> 'yourownpassword',
				);
}}}

To build a sfMicroblog object for pingfm:
{{{
	$options	= array('serviceName'	=> 'pingfm',
				'app_key'	=> 'yourownappkey',
				'api_key'	=> 'yourownapikey',
				);
}}}

For twitter and identi.ca, added support for the source parameter.


== TODO ==
 * To write a wrapper between them all when possible

== License ==

For the full copyright and license information, please view the LICENSE
file that was distributed with this source code.