# sfMicroBlog Plugin

## Overview

sfMicroBlogPlugin provides a tool box to manipulate microbloging sites.
Currently [twitter], [http://identi.ca identi.ca](http://twitter.com) (or
any other [laconi.ca]) and [http://ping.fm pingfm](http://laconi.ca) 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.