Integration with vBulletin - vBTwitter

Description

This modification adds basic Twitter integration to vBulletin. Once a user defines their Twitter username & password within their vB Options (User CP -> Edit Options), the Tweet This X links will appear.

It automatically adds a tweet to their account with the default text of "Check this out! " (which can be edited editing the "twitter_checkout" phrase) and uses your forum URL with either tp or tt.php as the link. These redirect to the thread / post that was tweeted.

Installation

1. Upload files in the /upload/ folder of the .zip into the directories as is.
2. Install product file.
3. Register an OAuth Application here, using:
   • Application Name: Your Site!
   • Description: Site Integration into Twitter.
   • (I request this one not be changed!) Application Website: https://vborg.vbsupport.ru/showthread.php?t=204694
   • Website: Your URL!
   • Application Type: Browser
   • (change url) Callback URL: http://www.yoururl.com/twitter_auth.php
   • Default Access type: Read & Write
4. Click Install on vB.org
5. Tell Your users.
6. Enjoy

Upgrading to v1.0.4

• Upload all files, overwrite everything.
• Install product file.
• Register an OAuth Application here, using:
  • Application Name: Your Site!
  • Description: Site Integration into Twitter.
  • (I request this one not be changed!) Application Website: https://vborg.vbsupport.ru/showthread.php?t=204694
  • Website: Your URL!
  • Application Type: Browser
  • (change url) Callback URL: http://www.yoururl.com/twitter_auth.php
  • Default Access type: Read & Write
• Gain and copy the Consumer Key & Secret into vBulletin Options.

Upgrading to v1.0.3 or before.

• Upload all files, overwrite everything.
• install product file.
• Remove template edits. For the record, they are here:
  • Open the postbit or postbit_legacy template (depending on what you use). Find:
    

    <if condition="$show['postcount']">#<a href="showpost.php?$session[sessionurl]p=$post[postid]&amp;postcount=$post[postcount]" target="new" rel="nofollow" id="postcount$post[postid]" name="$post[postcount]"><strong>$post[postcount]</strong></a></if>

    Add before that:
    

    <if condition="$post['twitter_username']"><a href="tweet.php?do=post&amp;id=$post[postid]&amp;c=$post[postid]">Tweet this post!</a></if>

  • Open the SHOWTHREAD template.
    Find:
    

    	<if condition="$show['addpoll']">
    	<tr>
    		<td class="vbmenu_option"><img class="inlineimg" src="$stylevar[imgdir_button]/addpoll.gif" alt="$vbphrase[add_a_poll]" /> <a href="poll.php?$session[sessionurl]do=newpoll&amp;t=$threadinfo[threadid]">$vbphrase[add_a_poll_to_this_thread]</a></td>
    	</tr>
    	</if>

    Add After:
    

    	<if condition="$vbulletin->userinfo['twitter_username']">
    	<tr>
    		<td class="vbmenu_option">
    			<a href="tweet.php?do=thread&ampid=$threadinfo[threadid]">Tweet This  Thread!</a>
    		</td>
    	</tr>
    	</if>

    Find:
    

    		<if condition="!$show['search_engine']">
    
    			<div><img class="inlineimg" src="$stylevar[imgdir_button]/printer.gif" alt="$vbphrase[show_printable_version]" vspace="1" /> <a href="printthread.php?$session[sessionurl]t=$threadid" rel="nofollow">$vbphrase[show_printable_version]</a></div>
    			<div><img class="inlineimg" src="$stylevar[imgdir_button]/sendtofriend.gif" alt="$vbphrase[email_this_page]" vspace="1" /> <a href="sendmessage.php?$session[sessionurl]do=sendtofriend&amp;t=$threadid" rel="nofollow">$vbphrase[email_this_page]</a></div>
    		</if>

    Add After:
    

    		<if condition="$vbulletin->userinfo['twitter_username']"><a href="tweet.php?do=thread&amp;id=$threadinfo[threadid]">Tweet This  Thread!</a></if>

Requirements

THIS MODIFICATION REQUIRES PHP 5 DUE TO THE CLASS THAT IS USED!

PHP'S CURL EXTENSION IS ALSO USED! THE API CALLS ARE COMPLETELY DEPENDENT ON THEM!

This modification should work on vBulletin v3.5+, but was only tested on a vB 3.8 install.

Using the "tp.php" switch added in v1.0.2

With the release of v1.0.2, a switch between showpost.php?p=ID&postcount=COUNT and showthread.php?p=ID#postID has been added. Using it is simple, but requires a code edit (Note: This is a SUPPORTED code edit!). Open up tp.php and find this line:

PHP Code:

define('SHOWPOST', true); 


Change that line to this:

PHP Code:

define('SHOWPOST', false); 


This will automatically trigger the change any time it is loaded. This works retroactively and any links will automatically use the new settings once changed!

[birdie]

I caught the comments earlier in the thread re it working on 3.7 .... BUT, will it work on 3.6.11 (don't ask about why not upgrading!)

[mykkal]

Hey King, how are you?

Please, if you know...I'm just wondering if you know what code I need to change so that the "tweet" title reflects the title of the post "tweeted".

[redlabour]

Are the .svn and .DS_Store Folders needed on a Linux/Windows Server or are they only for Mac?

And can you integrate a more modern and Twitter-Like Icon to send the Tweets?

This blue old Style Button in the Package looks terrible.

Waiting for 1.1.

[King Kovifor]

Originally Posted by birdie

I caught the comments earlier in the thread re it working on 3.7 .... BUT, will it work on 3.6.11 (don't ask about why not upgrading!)

I haven't tried it, but I don't see why not.

Originally Posted by mykkal

Hey King, how are you?

Please, if you know...I'm just wondering if you know what code I need to change so that the "tweet" title reflects the title of the post "tweeted".

That's a feature for v1.1.

Originally Posted by redlabour

Are the .svn and .DS_Store Folders needed on a Linux/Windows Server or are they only for Mac?

And can you integrate a more modern and Twitter-Like Icon to send the Tweets?

This blue old Style Button in the Package looks terrible.

Waiting for 1.1.

Thanks. I am not a good graphic artist. But, I have attached the new one we are using (thanks @fattony69!).

And .svn and .DS_Store can be removed. They are hidden on mac and I totally missed them. .DS_Store is a Mac thing... So yeah, delete.

[King Kovifor]

ATTN: I need opinions. Twitter opened their OAuth integration beta to the public and I really want to use it, as it will remove the need for me to actually store and secure a users password, thus removing the mcrypt requirement.

But, the requirement for using OAuth would be for you to individually register an OAuth application specific for your site. I would provide you with all necessary details, but it won't be as simple as upload and install. Would you rather keep it as this, and not use OAuth (which I will learn as it provides a secure method of not sharing a users Password!) for vBTwitter? Please, I need opinions. You may also @vBTwit me on Twitter and I'll get the replies!

[redlabour]

What i still hardly miss is a Profil-Box for each User showing his last X Tweets and a short Twitter-Statistic for every User.

[ragtek]

Originally Posted by redlabour

What i still hardly miss is a Profil-Box for each User showing his last X Tweets

Also included in 1.1

and a short Twitter-Statistic for every User.

was meinst du damit?

[mykkal]

Originally Posted by King Kovifor

That's a feature for v1.1.

I understand. Just noticed that its been done in your test forums for a long time now. How long off is the release? If its a more then a month can you just PM those few lines of code? If you can't I'm totaly fine with it.

Traffic on my site would jump 35%. Its needed.

[redlabour]

Originally Posted by ragtek

Also included in 1.1

was meinst du damit?

s. Screenshot

But it should be completely phrased.

[ragtek]

In my opinion i'd like to stop including new functions until we release 1.1 and then we can discuss the new features.

If we now include all wishes, 1.1 wouldn't be released until december 2011.
Don't know how king kovifor is thinking about it, i'm just the co-author^^