Updating TwitterBridge README to be clearer on installation

This commit is contained in:
Mikael Nordfeldth 2014-10-26 23:17:43 +01:00
parent 636ad44f0b
commit fb1b80c915

View File

@ -14,13 +14,12 @@ Installation
------------ ------------
OAuth 1.0a (http://oauth.net) is used to to access protected resources OAuth 1.0a (http://oauth.net) is used to to access protected resources
on Twitter (as opposed to HTTP Basic Auth)*. To use Twitter bridging on Twitter. To use Twitter bridging you will need to register your
you will need to register your instance of StatusNet as an application instance of StatusNet as an application on Twitter (http://twitter.com/apps).
on Twitter (http://twitter.com/apps). During the application During the application registration process your application will be assigned
registration process your application will be assigned a "consumer" key a "consumer" key and secret, which the plugin will use to make OAuth requests
and secret, which the plugin will use to make OAuth requests to Twitter. to Twitter. You can either pass the consumer key and secret in when you
You can either pass the consumer key and secret in when you enable the enable the plugin, or set it using the Twitter administration panel.
plugin, or set it using the Twitter administration panel**.
When registering your application with Twitter set the type to "Browser" When registering your application with Twitter set the type to "Browser"
and your Callback URL to: and your Callback URL to:
@ -42,52 +41,26 @@ To enable the plugin, add the following to your config.php:
) )
); );
or just: or if you want to set the variables from the website's administration panel:
addPlugin('TwitterBridge'); addPlugin('TwitterBridge');
if you want to set the consumer key and secret from the Twitter bridge After saving your configuration file, please run 'php scripts/upgrade.php'
administration panel. (The Twitter bridge wont work at all and also restart the background daemons if they are active on your instance.
unless you configure it with a consumer key and secret.)
* Note: The plugin will still push notices to Twitter for users who
have previously set up the Twitter bridge using their Twitter name and
password under an older version of StatusNet, but all new Twitter
bridge connections will use OAuth.
** For multi-site setups you can also set a global consumer key and
secret. The Twitter bridge will fall back on the global key pair if
it can't find a local pair, e.g.:
$config['twitter']['global_consumer_key'] = 'YOUR_CONSUMER_KEY';
$config['twitter']['global_consumer_secret'] = 'YOUR_CONSUMER_SECRET';
Upgrade
-------
If you've used the Twitter bridge plugin prior to version 0.9.5,
you'll need to run the new scripts/initialize_notice_to_status.php
script to initialize the new notice-to-status mapping file, which
greatly improves the integration between StatusNet and Twitter.
Administration panel Administration panel
-------------------- --------------------
As of StatusNet 0.9.0 there is a new administration panel that allows To access the administration panel, you'll need to use a user with the
you to configure Twitter bridge settings within StatusNet itself, "administrator" role (see: scripts/userrole.php).
instead of having to specify them manually in your config.php.
To access it, you'll need to use a user with the "administrator"
role (see: scripts/userrole.php).
Sign in with Twitter Sign in with Twitter
-------------------- --------------------
With 0.9.0, StatusNet optionally allows users to register and GNU social optionally allows users to register and authenticate using their
authenticate using their Twitter credentials via the "Sign in with Twitter credentials via the "Sign in with Twitter" pattern described here:
Twitter" pattern described here:
http://apiwiki.twitter.com/Sign-in-with-Twitter https://dev.twitter.com/web/sign-in
The option is _on_ by default when you install the plugin, but it can The option is _on_ by default when you install the plugin, but it can
disabled via the Twitter bridge administration panel, or by adding the disabled via the Twitter bridge administration panel, or by adding the