Tags: Status.net, Identica, Twitter, status updates, oauth, Yourls.org
Requires at least: 2.7.0
Tested up to: 3.3.1
Stable tag: 1.4.2
Posts your blog posts to one or multiple Status.net servers and even to Twitter
== Description ==
Every time you make a new blog post this plugin will post a status update to the Status.net servers and Twitter accounts
you have specified. You can set as many acounts on as many servers you like. You can even have the plugin to post to
different account on the same [Status.net](http://status.net) server.
The links to your blog can be shortened by one of seven different link shortener services like TinyURL.com.
== Installation ==
1. Upload `wp-status-net/wp-status-net.php` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to the 'WP-Status.net' menu option under 'Settings' to specify the accounts and servers
== Frequently Asked Questions ==
= How to use Oauth with Twitter? =
1. Register a new application at http://dev.twitter.com/apps/new
* Application Type must be set on Browser
* The Callback URL should be the URL of your blog
* Default Access type MUST be set to Read & Write
2. Fill in the Consumer Key and Consumer Secret in the correct fields (will show up as soon as you select Server Type "Twitter" and "Oauth" in the server list)
3. Click on the link called "My Access Tokens" at http://dev.twitter.com (right menu)
4. Fill in your Access Token and the Access Token Secret in the correct fields
5. Now you should be able to post to Twitter
= How do I get access to the 2ve.org link shortener API? =
The 2ve.org service is at the moment only open for Xavier Media, but you can choose any of the other link shorteners instead.
= How can I suggest a new feature or report a bug? =
Visit our support forum at http://www.xavierforum.com/php-&-cgi-scripts-f3.html
== Changelog ==
= 1.4.2 =
* Added support for Yourls.org on your own site
= 1.4.1 =
* Removed RT.nu since they are no longer in service
= 1.3.1 =
* Minor bug fix in Oauth for Twitter
* Fixed problem with bit.ly links
= 1.3 =
* Oauth is now available for Twitter servers. For Status.net server that will be available in a later version (hopefully 1.4)
* Optional suffix possible for posts
= 1.1 =
* Added possibility to have a unique prefix for each server when posting blog posts to a Status.net server
// if ($statusserver[$i] == "myxavier.com" && $options[pluginlink] == "")
// {
// $options[pluginlink] = "poweredby";
// }
$options[statustype][]=$statustype[$i];
$options[statusauthtype][]=$statusauthtype[$i];
$options[statusserver][]=$statusserver[$i];
$options[statuspath][]=$statuspath[$i];
$options[statususer][]=$statususer[$i];
$options[statuspwd][]=$statuspwd[$i];
$options[statususer2][]=$statususer2[$i];
$options[statuspwd2][]=$statuspwd2[$i];
$options[statusprefix][]=$statusprefix[$i];
$options[statussuffix][]=$statussuffix[$i];
}
}
$opt=serialize($options);
update_option('wpstatusnetoptions',$opt);
}
else
{
$opt=get_option('wpstatusnetoptions');
$options=unserialize($opt);
}
?>
<STYLE>
.hiddenfield
{
display:none;
}
.nothiddenfield
{
}
</STYLE>
<divclass="updated fade-ff0000"><p><strong>Need web hosting for your blog?</strong> Get 10 Gb web space and unlimited bandwidth for only $3.40/month at <ahref="http://2ve.org/xMY3/"target="_blank">eXavier.com</a>, or get the Ultimate Plan with unlimited space and bandwidth for only $14.99/month.</p></div>
If you get stuck on any of these options, please have a look at the <ahref="http://www.xaviermedia.com/wordpress/plugins/wp-status-net.php">WP Status.net plugin page</a> or visit the <ahref="http://www.xavierforum.com/php-&-cgi-scripts-f3.html">support forum</a>.
<h2>Link Shortener</h2>
<p>Select the link shortener you would like to use.</p>
<p>
<INPUTTYPE=radioNAME=apitypeVALUE=""<?phpif($options[apitype]==""){echo' CHECKED';}?>onClick="javascript:document.getElementById('apikeys').className = 'hiddenfield';"><B>Don't</B> use any service to get short links<BR/>
<INPUTTYPE=radioNAME=apitypeVALUE="yourls.org"<?phpif($options[apitype]=="yourls.org"){echo' CHECKED';}?>onClick="javascript:alert('To use this service you need to read the instructions below!');document.getElementById('apikeys').className = 'nothiddenfield';document.getElementById('yourlssetup').className = 'nothiddenfield';"><AHREF="http://yourls.org/"TARGET="_blank">Yourls.org on your own domain</A> *<BR/>
<INPUTTYPE=radioNAME=apitypeVALUE="2ve.org"<?phpif($options[apitype]=="2ve.org"){echo' CHECKED';}?>onClick="javascript:alert('Don\'t forget to fill in the API ID and API key fields below for this link shortener');document.getElementById('apikeys').className = 'nothiddenfield';"><AHREF="http://2ve.org/"TARGET="_blank">2ve.org</A><B>*</B><BR/>
<INPUTTYPE=radioNAME=apitypeVALUE="bit.ly"<?phpif($options[apitype]=="bit.ly"){echo' CHECKED';}?>onClick="javascript:alert('Don\'t forget to fill in the API ID and API key fields below for this link shortener');document.getElementById('apikeys').className = 'nothiddenfield';"><AHREF="http://bit.ly/"TARGET="_blank">bit.ly</A><B>*</B><BR/>
<BR/><B>*</B> = This link shortener service require an <B>API ID</B> and/or an <B>API Key</B> to work. Please see the documentation at the link shorteners web site.
To be able to use the Yourls.org option below on your own domain name you need to follow these instructions. If you're a newbie this option is not really for you.
<OL>
<LI> Download Yourls.org from <AHREF="http://www.yourls.org/"TARGET="_blank">www.yourls.org</A> and follow the setup instructions to install Yourls.org on your own domain name
<LI> Select the Yourls.org option above
<LI> Fill in your <B>API key</B>/signature in the <B>API key</B> field below. THe password and user name option will not work so you have to <aHREF="http://yourls.org/passwordlessapi"TARGET="_blank">setup Yourls.org to work with signatures</A>.
<LI> Fill in the <B>domain name</B> on which you've installed Yourls.org on in the API ID field. Do not include any http:// nor any / at the end of the domain name!<BR/>
For example if the Yourls.org script is installed at <i>http://www.sampleaddress.com/yourls-api.php</i>, then you <U>only</U> fill in <i>sampleaddress.com</i> in the API ID field.
Depending on what you selected above, some link shorteners require that you sign up at their web site to get an API ID (or API login) and/or an API key. For more information on what's required to use the link shortener you've selected, please see the documentation at the web site of the link shortener.<BR/>
API ID: <INPUTTYPE=textNAME=apiidVALUE="<?phpecho$options[apiid];?>"SIZE=40> (this may sometimes be called "login", and in the case of Yourls.org it's the domain name where you installed Yourls.org)<BR/>
API Key: <INPUTTYPE=textNAME=apikeyVALUE="<?phpecho$options[apikey];?>"SIZE=40> (if just a key is required, leave the ID field blank)<BR/>
</div>
<h2>Link to Xavier Media®</h2>
<P>To support our work, please add a link to us in your blog. </P>
<P><INPUTTYPE=checkboxVALUE="poweredby"NAME=pluginlink<?phpif($options[pluginlink]=="poweredby"){echo' CHECKED';}?>> "Powered by WP-Status.net plugin"</P>
<h2>Status.net servers and user accounts</h2>
<p>Fill in the Status.net servers you would like to post status updates to. To post to for example <AHREF="http://identi.ca/"TARGET="_blank">identi.ca</A> just fill in <B>identi.ca</B> as server, <B>api</B> as path and your user name and password.</p>
<p>To turn off updates to a server, just remove the user name for that server and update options.</p>
<p>Post prefix and post suffix are optional, but if you would like to post some text or perhaps a hash tag before/after all your posts you can specify a unique prefix/suffix for each server/account.</p>
<p><b>How to use Oauth with Twitter?</b><br/>
1. Register a new application at <ahref="http://dev.twitter.com/apps/new"target="_blank">dev.twitter.com/apps/new</a><br/>
* Application Type must be set to Browser<br/>
* The Callback URL should be the URL of your blog<br/>
* Default Access type MUST be set to Read & Write<br/>
2. Fill in the Consumer Key and Consumer Secret in the correct fields (will show up as soon as you select Server Type "Twitter" and "Oauth" in the server list (user name column))<br/>
3. Click on the link called "My Access Tokens" at http://dev.twitter.com (right menu)<br/>
4. Fill in your Access Token and the Access Token Secret in the correct fields (password column)<br/>
5. Now you should be able to post to Twitter<br/></p>