Тема на орге:
http://www.vbulletin.org/forum/showthread.php?t=236278
What Does This Hack Do?
I use v4.0.5 of this hack at Wolfshead Solutions and have had no issues at all.
Depending on the options you select in the AdminCP, you can:
- Automatically create a new tweet when you create a new thread only
- Automatically create a new tweet when you post a new reply/quick reply to a thread only
- Automatically create a new tweet when you create a new thread and post a new reply/quick reply
These tweets are
live updates.... the instant you post a new thread or a new reply/quick reply in a vBulletin2Twitter enabled forum, a tweet is made at the same time. These tweets will only be posted if they are 140 characters or shorter (this is automatically checked) and the number of calls the Twitter OAuth API per hour has not been exceeded (again, this is automatically checked).... so instead of throwing errors, in these cases this hack will not even attempt to tweet the thread/post.
As of v4.0.003, this hack is very, very loosely based on
Buro9's
vBulletin To Twitter hack (there is not one line of original untouched code left from his hack in this hack, and his hack is based on Basic authentication). I have totally rewritten his hack to made it into a product and have added extra functionality, which includes support for posting to Twitter via OAuth authentication,
is.gd,
TinyURL.com &
Metamark as alternative url shortening services, as well as options to tweet replies to threads as well as tweet new threads.
From monitoring
Buro9's thread I noticed that a lot of people have been having problems related to
bit.ly, mainly due to JSON, "safe_mode" and "open_basedir" generated errors, so I also added the
is.gd,
TinyURL &
Metamark url shortening services, as you do not require JSON support and the API does not require you to register with the site.
What is required before installing this hack?
Your server needs the following options installed on it for this hack to work. You can check this yourself in the AdminCP by selecting
Maintenance ->
View PHP Info (see screenshots attached for what to look for). If you do not have the first two option installed, then you should ask your web host about compiling support in for you.
- cURL with OpenSSL compiled into your php - http://curl.haxx.se/, http://php.net/manual/en/book.curl.php
- JSON support compiled into your php - http://www.json.org/, http://php.net/manual/en/book.json.php
Once you have server requisites from above covered, you will then need the following accounts setup before you can install this hack:
- You need to have a normal Twitter account details to post to - http://twitter.com
- You will need to register a new Twitter Application (while logged with your normal Twitter account) - http://dev.twitter.com/apps/new
- You will need the items below for step 4 of the attached install instructions:
- Note down the "Consumer Key" and "Consumer Secret" (Under App Details)
- Note down the "Access Token" and "Access Token Secret" (under My Access Token on the App details screen)
- If you want to use bit.ly url shortening (Optional)
- You need to have registered with bit.ly to obtain a username and your API Key - http://bit.ly
- Then install this hack by following the "Installation/Upgrade Instructions" attached.
TWITTER DEMO: @wolfs_solutions (any tweets that you see that were twitted by
wolfshead-solutions.com are generated using v4.0.003 of this hack and any twitted by
API are generated using v4.0.001/2 of this hack). Check this tweet
here and this tweet
here as they show this hack working absolutely fine with vBulletin 4.1.0 and using different
hashtags.
What Do You Get?
The settings in the AdminCP options are:
- Turn this hack on or off
- Enter your twitter "Consumer Key" and "Consumer Secret"
- Enter your twitter "Access Token" and "Access Token Secret"
- Select which url shortening service to use, is.gd, TinyURL.com, Metamark, bit.ly or none (default is bit.ly)
- Enter your bit.ly username and API key
- Option to include all, include selected or exclude selected forums when posting to twitter
- Enter which forums to include or exclude when posting to twitter
- Select if you want to use your thread prefixes when posting a new thread to twitter
- Select if you want to post your new threads to twitter or not
- Select if you want to post your replies/quick replies to twitter or not
- There is a link to edit the new reply/quick reply prefix (default is Re:)
- Date prefix to add to new reply/quick reply to make it unique to not be detected as a duplicate by twitter
Frequently Asked Questions
Question:
It doesn't work! Help!!!
Answer:
That does not help me help you. Please explain exactly what the issue is, give as much information as possible and ensure you have clicked Mark as Installed as I only support people who have.
Question:
I don't know how to setup a Twitter Application! Help!!!
Answer:
Enter the following details when creating your application:- Application Name: I advise your website url (for instance I used "wolfshead-solutions.com")
- Application Website: Enter the full url to your site (for instance I used "http://www.wolfshead-solutions.com")
- Application Type: Set to "Client"
- Default Access type: Set to "Read & Write"
Stay logged into your Twitter account, as the first time you tweet from your forum you will need to authorise the domain.
Question:
Can you please add the ability to tweet RSS feeds, CMS articles, Blogs, calendar events etc?
Answer:
This hack tweets live to twitter, and as none of the requests above are guaranteed to be live (ie they can be set to be published later), I will not be adding the any of the above to this hack and that is highly unlikely to ever change.
Question:
I see an "Basic authentication is not supported on line 204" error
Answer:
It means you still have either v4.0.001 or v4.0.002 of this hack installed, which uses Basic Authentication API calls which Twitter switched off on Tuesday 31st August 2010.
The solution is to upgrade to v4.0.003 or above of this hack, which uses OAuth Authentication.
Question:
I see "Fatal error: Cannot redeclare class OAuthException in [path]/includes/twitteroauth/OAuth.php on line 8" error
Answer:
Edit the OAuth.php file in the twitteroauth folder. Find all instances of OAuthException and change them to OAuthException_tw. That should fix it up.
Question:
I see "Warning: require_once([path]/includes/twitteroauth/twitteroauth.php) [function.require-once]: failed to open stream", "Warning: require_once([path]/includes/twitteroauth/OAuth.php) [function.require-once]: failed to open stream" or "Warning: require_once([path]/includes/bitly.php) [function.require-once]: failed to open stream" error
Answer:
Ensure you have uploaded the twitteroauth folder and it's contents and/or bitly.php file to your /includes folder
Question:
I see an "INVALID_JSON" error
Answer:
Select is.gd, TinyURL or Metamark in your AdminCP Options instead of bit.ly for url shortening.
Question:
As I do not have to register with is.gd, how to I view click statistics with the generated link?
Answer:
Simply add a hyphen (dash) to the end of the shortened URL, and instead of being redirected to the original long address automatically, you'll be taken to a preview page telling you where the link goes and gives you the click statistics for the url.
For example: You have been given the shortened link http://is.gd/8HdYu and want to check where it goes. Copy/paste it into your browser's address bar and then add a hyphen, making the link http://is.gd/8HdYu-. Now simply visit that address, and instead of being taken directly to the original URL, you'll be taken to a preview page on the is.gd site which will tell you the link's destination along with the click statistics.
Question:
I see an "You must be authenticated to access shorten" error
Answer:
Ensure you have entered your bit.ly username & API key correctly.
Question:
Threads with titles that have special characters in them (such as ? ? ? ? ? ? ? ?) do not tweet, what do I do?
Answer:
Sorry, but it looks like an issue with the Twitter (OAuth) class file by Abraham Williams and not with this hack at all.
I have checked his bug tracker and this issue has been reported twice and has not been fixed yet by the author, please see:
You might want to reply to both of the bug reports to see if you can get the author to fix his Twitter class any quicker.
Question:
I see an error that says "Warning: curl_setopt_array() [function.curl-setopt-array]: CURLOPT_FOLLOWLOCATION cannot be activated when in safe_mode or an open_basedir is set in [path]/bitly.php"
Answer:Looks like that is a safe_mode issue... but should be easily fixable. In
bitly.php, find:
PHP Code:
$options[CURLOPT_FOLLOWLOCATION] = true;
Change it to:
PHP Code:
$options[CURLOPT_FOLLOWLOCATION] = false;
$options[CURLOPT_HEADER] = true;
В архиве 2 версии продукта.
Для веток 3.6 и выше и для веток 4.х
vBulletin 2 Twitter (OAuth version)
