Plugin:Twitter - Revision history

Indy: /* Messages */

2016-04-19T03:03:22Z

Messages

← Older revision		Revision as of 03:03, 19 April 2016
Line 18:		Line 18:
	I did it that way so you could easily enable/disable each item as you want.<br>		I did it that way so you could easily enable/disable each item as you want.<br>
	Also, all the messages work just like Song/DJNew/DJChange in your channel.<br>		Also, all the messages work just like Song/DJNew/DJChange in your channel.<br>
	For TwitterSongSource/TwitterSong if AutoDJ or SimpleDJ are active you can use the %songid% variable to get the songs internal ID. This could be used to link to your WebRequest for example.		For TwitterSongSource/TwitterSong:
			If AutoDJ or SimpleDJ are active you can use the %songid% variable to get the songs internal ID. This could be used to link to your WebRequest for example.
			%artisttag% - Song artist in #tag format, lowercase with spaces removed.

	TwitterSong - The text to display when a new song is played.		TwitterSong - The text to display when a new song is played.

Indy: /* Messages */

2015-10-22T23:42:14Z

Messages

← Older revision		Revision as of 23:42, 22 October 2015
Line 25:		Line 25:
	TwitterDJNew - The text to display when a DJ comes on and there wasn't one on before.		TwitterDJNew - The text to display when a DJ comes on and there wasn't one on before.
	TwitterDJChange - The text to display when a new DJ comes on and there was a DJ on before.		TwitterDJChange - The text to display when a new DJ comes on and there was a DJ on before.

			You can also put an _X at the end of the message name to define a different message for a specific Twitter account. X = the Account number, for example: TwitterSong_0

	==Messages Example==		==Messages Example==

Indy at 17:40, 7 November 2013

2013-11-07T17:40:07Z

New page

[[Category:RadioBot Plugins|Twitter]]
==Plugin Info==
This [[plugins|plugin]] adds support for tweeting songs and stream updates to [http://twitter.com Twitter]. 
For this plugin, you will need an access Token and Secret from Twitter. To generate a token for your plugin, follow these steps:

1. Log in to your www.ShoutIRC.com account and click on the My Account link.
2. Then click Twitter to go to the Twitter token page.
3. Click on the generate tokens link, and it will give you a URL to Twitter.com that will open in a new window.
4. On the new page at Twitter.com, click the Allow button and copy the PIN # you get afterwards.
5. Back on ShoutIRC.com, paste your PIN # into the text box and click the Continue button.
6. You will now see your token information and Twitter username, you can just copy/paste them into the Twitter section in your ircbot.conf

Not too hard, but unfortunately it's necessary for Twitter's authorization system.

==Messages==
This plugin uses 3 messages defined in ircbot.text. 
All messages are undefined by default so if you do not define them in ircbot.text the plugin will not tweet anything. 
I did it that way so you could easily enable/disable each item as you want. 
Also, all the messages work just like Song/DJNew/DJChange in your channel. 
For TwitterSongSource/TwitterSong if AutoDJ or SimpleDJ are active you can use the %songid% variable to get the songs internal ID. This could be used to link to your WebRequest for example.

TwitterSong - The text to display when a new song is played.
TwitterSongSource - Optional alternate text to display when a new song is played if a source plugin like AutoDJ is active.
TwitterRequest - The text to display when a requested song is played.
TwitterDJNew - The text to display when a DJ comes on and there wasn't one on before.
TwitterDJChange - The text to display when a new DJ comes on and there was a DJ on before.

==Messages Example==
Here is an example of messages you could use:
TwitterDJChange=[Demo Radio] %olddj is Off --> Coming up: %dj
TwitterDJNew=[Demo Radio] Current DJ: %dj
TwitterSong=%dj is playing %song [Listeners: %clients/%max] [Requests: %req] [Song Ratings: %ratings%] [Song Rating: %rating% with %votes% vote(s)]
TwitterRequest=The current song was requested by %requestedby%

==Twitter Commands==
{{cmd-table-start}}
{{cmd-table-entry|@BotsUsername !followme|N/A|Makes the bot's Twitter account follow you}}
{{cmd-table-entry|@BotsUsername !unfollow|N/A|Makes the bot's Twitter account unfollow you}}
{{cmd-table-end}}

==Configuration==
See the [[Configuration:Twitter|Configuration]] page.

==Libraries in Use==
[http://code.google.com/p/twitcurl/ twitcurl] (MIT License)

==OS Support==
{{OS_Support2|Yes|Untested|Yes|Yes|Yes|Yes}}

{{radiobot}}