Navigation
Logged in as: Guest

MyTwitterBB

From Supa Comix Forums

[Image: mytwitterbb.png]

About

This is a MyBB Forum Plugin which allows users to sync their twitter accounts with their forum accounts. The basics include:
    * MyTwitterBB Global - This allows users to display a simple little twitter feed wherever they want on the forum.
    * MyTwitterBB Profile - This allows users to change their usertitle and keep it up to date with their own twitter profile as it updates whenever the admin allows it to be.

Download

Click one of the mirrors:
Installation

NOTE: If you have version any previous version of MyTwitterBB then please backup your users twitter account names as this update requires a proper re-install of all fields and data. So any usernames used would be lost. This should hopefully be the last time that we do it as i have just implemented code to support upgrades.

All you need to do is to upload "mytwitterbb.php" into your "inc/plugins/" folder on your forum. Then find it in your forum admin section and then activate the plugin.

By default both of the MyTwitterBB Global and Profile sections are by default on. You can disable either one if you wish.

Change Log
Version 2.4 -> Version 2.5 - Unreleased
- Addition of RT removal
- Adding the MyTwitterBB Global Box to the template area.
- Fix for status sometimes not updating.
- Fix an error when users select users with no twitter account

Version 2.3 -> Version 2.4
- Added the ability for admins to set it so that MyTwitterBB does not change the users title, meaning that they're tweets can only be seen on the profile page
- Change the time difference between tweets to 5 minutes rather than 10.
- Set it so that users using MyTwitterBB will have their original user titles reset if the plugin is disabled

Version 2.2 -> Version 2.3
- Added support for html special characters allowing the display of language characters from hebrew, german, etc.

Version 2.1 -> Version 2.2
- Support for hashtags
- Changed code that identifies html links
- MyBB Global now supports more than one url.

Version 2.0 -> Version 2.1
- Fixed a minor bug where it appears that the tweets are cascading style sheet data.

Version 1.0 -> Version 2.0
- Complete change of code from Version 1.0 so that the workload of the forum when a page is loaded is lessened and it now uses Mybb Task manager system.

Global Use

Using global is a very simple thing to do.

Settings Description

MyTwitterBB Global On? This one is self explanatory. Default: Yes

Twitter Username Enter in the username that you wish to use for the Global Feed. Default: none

Use Class MyTwitterBB by default uses the class "panel" which comes with MyBB so that during its use it blends in with your forum. If you wish to use a class to style the output then set this to yes. Default: Yes

Class The class that you wish to use to display. Default: panel

Link Style This is the style that the links for the display are done like. There is a link to the users twitter profile as well as any links that are included in the tweet are converted. This will be used to display them. Default: color: black; font-weight: bolder;

Box Style If you have chosen not to use the Class to display the box then this can be used to set the style. Default: background: 000000; font-size: 11px; border: 1px solid #D4D4D4; padding: 8px;

Current Tweet This shows what the current tweet is, you can then update it if you wish to for spelling fixes or whatever. Keep in the mind that MyTwitterBB will update every 10 minutes so this may be over-written soon. Default: none

Show Time Do you wish to show the time of when the last tweet was fetched? This uses the same time display settings as the forum as well as takes into account the forums time offset.

Use Hashtags If set to yes then hashtags will be clickable, if set to no then hashtags will not be displayed on the forum. Default: Yes

Best Position

I find that the best place for the Global Twitter Feed would be just below the welcome block. To add this in you need to find the correct template.

Templates & Style > Templates > Default Templates > Header Templates (Expand) > header

Then stick {$template->mytwitterbb} where it says:
PHP Code:
</div>
<
hr class="hidden" />
<
br class="clear" /> 

So it should look like this:

PHP Code:
</div>
{
$template->mytwitterbb}
<
hr class="hidden" />
<
br class="clear" /> 

Profile Use
This is for users profiles. They can enter in their twitter name and then it will update their user title to the retrieved tweet.

Settings

MyTwitterBB Profile On? Self explanatory Default: Yes
Hashtags On? Should hashtags be added into the users usertitle information? Default: Yes
Update User titles If set to yes then when MyTwitterBB runs it will update

Adding in a Twitter username

This is done very simply by going to your User CP > Edit Profile. Then there will be a field with "Twitter Username" just fill that bit in.

FAQ
What happens on activation?

Well firstly we add a couple of settings and settings groups to your database. We also add in a custom profile field which allows users to add in their twitterusername. We also add in a new task to the Mybb Task Manager system which is set to go off every 10 minutes.

I added in my Twitter Username but its not working!

This is something that may happen at time to time, there are two reasons for this:
1. You entered in an invalid twitter username, if you did you will find that your twitter username has been cleared out of your profile data.
2. Your twitter account is set to private. MyTwitterBB does not store passwords for your twitter account so if your account is set to private it will not be able to fetch the data.
3. You've just set it, wait about 10 minutes before checking it as it will update itself along with every other user.

How often does MyTwitterBB update itself?

It is set to update itself every 10 minutes. This means that at most its connections in an hour will be at most 6. This is a good thing, mostly becuase Twitter only allows 100 connections to its rss feeds and we didn't want it to overload the feed too often. If it is overloaded then no one can get the data at least for another hour.

What about @ messages?

Twitter does allow you to send replies to other twitter users but we think that this is perhaps something between the sender and the reciever so we make sure that it is not stuck down anywhere. Meaning that only global tweets are used, but the catching of this is done by seeing if the first character of the tweet is '@'. If not then it will count it as a valid tweet.

What's in store for the future of MyTwitterBB?

Well mostly i want all of the bugs done, perhaps there may be some more alterations and additions as twitter expands and changes. But i intend for there to one day be a page where users can display all of their tweets in a list. I also hope to write a script that will alllow you to backup all of the entered twitter account information so that when you upgrade to the next version then you won't lose that information.

My/ Someones Twitter Username doesn't appear in their usertitle. Why?

This is basically down to the fact that MyTwitterBB removes the username from the tweet as it would be obvious who posted it. The only thing is that it tries to remove it from your tweet in the same way as you entered it, if the name was in lowercase, and if the name was uppercase. If you enter in a twitter username such as userExample. It will not be able to catch this if the actual account name was UserExample. So be careful about entering in the case of the twitter username.
    Views: 1324 | Last Edited: 08-13-2009 @ 03:24 PM By: Nick