Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
WS vBulletin Tweet Poster Details »
WS vBulletin Tweet Poster
Mod Version: 4.1.0, by Mosh (Coder) Mosh is offline
Developer Last Online: Jun 2013 I like it Show Printable Version Email this Page

vB Version: 4.x.x Rating: (90 votes - 4.66 average) Installs: 592
Released: 19 Feb 2010 Last Update: 30 Jun 2013 Downloads: 3227
Not Supported Uses Plugins Additional Files Re-usable Code Translations  

Please click Mark as Installed if you are using this hack.

What Does This Hack Do?

I use v4.1.0 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 (including hashtags if selected)
  • 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 or your members post a new thread or a new reply/quick reply in a WS vBulletin Tweet Poster 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 new thread or new reply/quick reply is not sent the moderation queue.... 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 to use OAuth authentication to post to Twitter and have added extra functionality, which includes 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 and to add Hashtags.

What is required before installing this hack?

Your server needs the following options installed on it for this hack to work. This hack will check the requirements for you and will not install this hack if they are not.
  1. cURL with OpenSSL compiled into your php - http://curl.haxx.se/, http://php.net/manual/en/book.curl.php
  2. 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:
  1. You need to have a normal Twitter account details to post to - http://twitter.com
  2. You will need to register a new Twitter Application (while logged with your normal Twitter account) - http://dev.twitter.com/apps/new
  3. You will need the items below for step 4 of the attached install instructions:
    1. Note down the "Consumer Key" and "Consumer Secret" (Under App Details)
    2. Note down the "Access Token" and "Access Token Secret" (under My Access Token on the App details screen)
  4. If you want to use bit.ly url shortening (Optional)
    1. You need to have registered with bit.ly to obtain a username and your API Key - http://bit.ly
  5. Then install this hack by following the "Installation/Upgrade Instructions" attached.

TWITTER DEMO: There is no longer a demo available.

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 allow user or admincp defined hashtags (or no hashtags at all)
  • Enter admincp defined hashtags
  • 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 1:
It doesn't work! Help!!!
Answer:
That does not help others help you. Please explain exactly what the issue is, give as much information as possible and that may aid others in helping you.

Question 2:
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 3:
I think I have set up everything correctly, the thread and/or post is created with no issues, there are no errors, but nothing is posted to twitter. Help !!!
Answer:
On the Details tab of your Twitter Application (at https://dev.twitter.com), check the following:
  • Under the OAuth settings section, check Access level is set to Read and write not Read-only
  • Under the Your access token section, check Access level is set to Read and write not Read-only

If either of the above settings is Read-only, then you need to do the following:
  • Revoke access for the current application on your normal twitter account
  • Delete your current application
  • Create a brand new application with exactly the same information as the application you have just deleted.
  • Under the Settings tab, check the Access level under the Application type
    is set to Read and write not Read-only before you create the Access Token

Question 4:
I am using vBulletin 3.8.7 and the user hash tag field is not showing.... what can I do?
Answer:
Follow the instructions in this post.

Question 5:
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 never be adding the any of the above to this hack and that will never change.

Question 6:
Can I use this hack with vBulletin 4.1.4 which has the new CKEditor, and the hashtag field be visible to my members (if selected in the AdminCP options)?
Answer:
Yes, this hack is already compatible. If you select Only User defined Hashtags or Both User and AdminCP defined Hashtags in the AdminCP Options for this hack, the hashtag field will be displayed to your members.

Question 7:
I see "Basic authentication is not supported on line XXX" or /statuses/update.xml Could not authenticate you. Unauthorized on line XXX errors
Answer:
It means you still have either v4.0.001 or v4.0.002 of this hack installed, and the solution is to upgrade to v4.1.0 or above of this hack, which uses OAuth Authentication.

Question 8:
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 9:
I see a "You must be authenticated to access shorten" or INVALID_LOGIN on line xxx in /xxxxx/xxxxx/xxxxx/includes/bitly.php error message.... what do I do?
Answer:
Ensure you have entered your bit.ly username & API key correctly. If that does not fix it, then select is.gd, TinyURL or Metamark in your AdminCP Options instead of bit.ly for url shortening.

Question 10:
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 11:
bit.ly does not work (gives error messages), what can I do?
Answer:
Select is.gd, TinyURL or Metamark in your AdminCP Options instead of bit.ly for url shortening.

Question 12:
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... the below should fix it (but is not guaranteed that it will, but it should). In bitly.php, find:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Change it to:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

If that does not fix it, then select is.gd, TinyURL or Metamark in your AdminCP Options instead of bit.ly for url shortening.

Question 13:
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 14:
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 15:
This hack has been working fine then stopped working on Tuesday 11th June 2013 and I did not make any changes, what do I do?
Answer:
Twitter updated their API to version 1.1 on 11/6/2013, so any versions of this hack below v4.1.0 will have stopped working. The solution is to upgrade to v4.1.0 of this hack.

If it still does not work, then you will probably need to do the following, then the hack should start working again within 24 hours:
  • Revoke access for the current application on your normal twitter account
  • Delete your current application
  • Create a brand new application with exactly the same information as the application you have just deleted.
  • Under the Settings tab, check the Access level under the Application type
    is set to Read and write not Read-only before you create the Access Token

vBulletin Version Compatibility

This hack can be used with vBulletin versions 4.0.0 - 4.2.1.

This has been tested with vBulletin v3.8.x and works fine, it should also work with v3.7.x and earlier versions (but has not been tested).



Hack Support/Feature Requests

IMPORTANT: This hack is no longer supported, but I have marked it as re-usable code, so it can be developed further (remember to acknowledge me as orignal author of this hack).



Install/Upgrade/Uninstall Instructions

There are no file or template changes at all and is fully phrased. You just need to upload 5 files (in 2 folders), import 1 product and alter the correct vBulletin Options in the AdminCP, and then it will work from then on.

The readme.txt instructions file is included in attached .zip file.


Version History

v4.1.0 - Sunday 30th June 2013 (Final Version Ever)
-- Updated: Installation/Upgrade/Removal Instructions file
-- Updated: OAuth.php & twitteroauth.php files to use the new Twitter API 1.1 (old API 1.0 no longer works)
-- Removed: all references to "account/rate_limit_status", as this has been removed from the Twitter API 1.1
-- Removed: Two plugins to aid in diagnosing problems with this hack (as I no longer support this hack, and have now left the vBulletin community)

v4.0.6 - Saturday 29th January 2011
-- Changed: Hack name
-- Updated: Installation/Upgrade/Removal Instructions file
-- Updated: Screenshots
-- Fixed: New Threads, Replies & Quick Replies in twitter enabled forums are only tweeted when they will not end up on the moderation queue
-- Fixed: Hashtags now work in vBulletin v3.8.x (hack tested and working.... not tested on v3.7.x nor v3.6.x but should also work)
-- Added: Install code to ensure all server requirements are met and all folders and files have been uploaded before the hack will install
-- Added: AdminCP Options to allow for both User & AdminCP defined Hashtags for new threads in twitter enabled forums
-- Added: Two plugins to aid in diagnosing problems with this hack (disabled by default)

v4.0.5 - Saturday 27th November 2010 (first released to Wolfshead Solutions on Wednesday 27th October 2010)
-- Changed: Version number formatting
-- Updated: Installation/Upgrade/Removal Instructions file
-- Updated: Screenshots
-- Added: AdminCP Options to include/exclude forums
-- Added: Hashtags for new threads in twitter enabled forums
-- Added: 2 plugins to cater for new hashtag feature
-- Added: AdminCP Option to also use the Metamark url shortening service
-- Added: Version History file
-- Removed: AdminCP Option for tli.td url shortening service (now requires api key)

v4.0.004 - Saturday 18th September 2010 (first released to Wolfshead Solutions on Wednesday 18th August 2010)
-- Updated: Installation/Upgrade/Removal Instructions file
-- Updated: Screenshots
-- Fixed: Tweets for new replies now correctly use the AdminCP's timezone offset setting along with DST settings for the timestamp
-- Added: AdminCP Options to also use the TinyURL and tli.tl url shortening services
-- Added: Automatic check to see if tweet is longer 140 characters or not (and post tweet if not)
-- Added: Automatic truncate tweet title text in the tweet if the tweet (including the URL) exceeds 140 characters
-- Added: Automatic check to see if number of hourly calls to the Twitter OAuth API has been exceeded or not (and post tweet if not)
-- Added: Ability to use vBulletin "Friendly URLs" (available in vBulletin 4 and later only) or just plain URLs
-- Added: All files needed for this hack in one package (no longer necessary to download other class files separately any more)

v4.0.003 - Friday 2nd July 2010
-- Updated: Installation/Upgrade/Removal Instructions file
-- Updated: Screenshots
-- Updated: 3 plugins to now use OAuth instead of Basic authentication when posting to Twitter
-- Added: AdminCP Option to not use url shortening at all
-- Added: 4 new AdminCP Options for Twitter "Consumer Key", "Consumer Secret", "Access Token" and "Access Token Secret"
-- Removed: 2 AdminCP Options for Twitter "Username" and "Password"

v4.0.002 - Monday 1st March 2010
-- Fixed: When multiple forums selected in AdminCP Options, threads or posts were not twittered at all

v4.0.001 - Friday 19th February 2010
-- Initial vBulletin v4.0.x Release


Thanks

Thanks go out to Buro9 who marked his original hack Re-usable Code. Thanks also go out to Dragonsys for pointing me in the right direction to converting this hack to use OAuth authentication, and also to Videx who bugged me about updating this and I have noticed is doing a lot to support this hack.


Show Your Appreciation

Although not required, if you have enjoyed the benefits of this hack, and would like show your appreciation for my efforts, then please feel free to click on the Support Developer link and donate any amount you feel is appropriate.


Donations

I would like to thank the following people for their kind donations:

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	phpinfo-curl.png
Views:	2938
Size:	6.2 KB
ID:	112588   Click image for larger version

Name:	phpinfo-json.png
Views:	2378
Size:	4.6 KB
ID:	112589   Click image for larger version

Name:	is.gd-preview.png
Views:	6410
Size:	86.2 KB
ID:	112591   Click image for larger version

Name:	tweets.png
Views:	3157
Size:	52.9 KB
ID:	122096  

Click image for larger version

Name:	admincp-options.jpg
Views:	1689
Size:	101.5 KB
ID:	126208   Click image for larger version

Name:	new_thread_3xx.png
Views:	2330
Size:	102.3 KB
ID:	126209   Click image for larger version

Name:	new_thread_4xx.png
Views:	2385
Size:	68.9 KB
ID:	126210  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Integration with vBulletin vBulletin Tweet Poster! Milad vBulletin 3.8 Add-ons 681 12 Mar 2016 22:42
Mini Mods Tweet-This (vBulletin Style) Sparrow-Sean vBulletin 4.x Template Modifications 31 27 Jul 2010 20:11

  #736  
Old 02 Jul 2013, 07:56
HCHQ HCHQ is offline
 
Join Date: Jan 2012
Tried tinyurl and I still have the same problem Someone please help!
__________________
My health article website www.thehealthcloud.co.uk
Reply With Quote
  #737  
Old 02 Jul 2013, 11:52
Videx's Avatar
Videx Videx is offline
 
Join Date: Feb 2007
Originally Posted by HCHQ View Post
Tried tinyurl and I still have the same problem Someone please help!
So did you check the solution you were just given above? Now that you've made me read it more carefully I see it may have nothing to do with bit.ly.

If you have, then I wonder if it's working with no shortening? With is.gd?
Reply With Quote
  #738  
Old 02 Jul 2013, 13:28
HCHQ HCHQ is offline
 
Join Date: Jan 2012
Ah, didn't really understand it at first but I removed the forum component URL and it's working now. Thanks for your help
__________________
My health article website www.thehealthcloud.co.uk
Reply With Quote
  #739  
Old 02 Jul 2013, 13:43
Liff Liff is offline
 
Join Date: Aug 2011
Thanks very much for a great a great mod and I would love to be able to leave it on now that I've got it to work.


Sadly, we have a large Twitter following and sadly some untrustworthy (And drunk!) members who would abuse the facility.

I may have missed this over the 50 pages so far, but is it possible to limit this to usergroups or to only tweet threads with a specific thread prefix (as I think you can limit those to usergroups?)

Or, to simplify.. Is there any way to choose which threads you'd like to tweet once they are open?

Sorry for the questions and thanks in advance to anyone kind enough to reply.
Reply With Quote
  #740  
Old 02 Jul 2013, 16:45
Videx's Avatar
Videx Videx is offline
 
Join Date: Feb 2007
Originally Posted by Liff View Post
Is there any way to choose which threads you'd like to tweet once they are open?
As I recall there isn't a lot of choices with the mod itself; you really have to rely on usergroups. But there hasn't been a lot of discussion here lately so something better may be buried from years ago.

Please report back and let us know what you can find, or install it and try it and see what you can do.

We consider abuse a rule breaker and would quickly penalize the perpetrator. Maybe kick them to a subgroup like Banned Users for a while.
Reply With Quote
  #741  
Old 02 Jul 2013, 18:00
Simon Lloyd's Avatar
Simon Lloyd Simon Lloyd is offline
 
Join Date: Aug 2008
Real name: Simon
Later on when work has settled down i'll look at adding usergroup selection to this and post it here.
__________________
Kind regards,
Simon Microsoft Office Help
My Mods: Find my modifications here
Please do not pm me for support unless i have invited you to!
Reply With Quote
  #742  
Old 02 Jul 2013, 18:05
Liff Liff is offline
 
Join Date: Aug 2011
Originally Posted by Videx View Post
As I recall there isn't a lot of choices with the mod itself; you really have to rely on usergroups. But there hasn't been a lot of discussion here lately so something better may be buried from years ago.

Please report back and let us know what you can find, or install it and try it and see what you can do.

We consider abuse a rule breaker and would quickly penalize the perpetrator. Maybe kick them to a subgroup like Banned Users for a while.
Thanks for the advice, Videx.

We run as libertarian a forum as we can and you'd pretty much need to kill someone to get banned

This Mod isn't a million miles away from what I want, except it posts to an individuals Twitter account rather than the forums.

http://www.vbulletin.org/forum/showthread.php?t=242425

I'm not even as skilled a coder to claim to be a novice and I appreciate it's too much to ask someone to carry out this level of mod for me, but I'll plod along and try some stuff to see if I can fluke success and if anyone else is interested and has the skills to complete it and then share then all the better
Reply With Quote
  #743  
Old 02 Jul 2013, 18:06
Liff Liff is offline
 
Join Date: Aug 2011
Originally Posted by Simon Lloyd View Post
Later on when work has settled down i'll look at adding usergroup selection to this and post it here.
What great timing - Thanks very much Simon and I'll look forward to your work settling down and if you get a chance to add that then it would be great
Reply With Quote
  #744  
Old 02 Jul 2013, 18:20
Simon Lloyd's Avatar
Simon Lloyd Simon Lloyd is offline
 
Join Date: Aug 2008
Real name: Simon
Ok, i've knocked something up, those of you wishing to beta test the new xml with usergroup selection then send me a pm - i haven't had time to test because im at work so you'll be my guinea pig, if all is well then i'll post it here and contact Mosh and see if he'll upload it to the main post.

In this version i've made it so that selected usergroups CANNOT use the twitter app at all!
__________________
Kind regards,
Simon Microsoft Office Help
My Mods: Find my modifications here
Please do not pm me for support unless i have invited you to!
Reply With Quote
  #745  
Old 03 Jul 2013, 18:06
Simon Lloyd's Avatar
Simon Lloyd Simon Lloyd is offline
 
Join Date: Aug 2008
Real name: Simon
Thanks to Liff who has just offered to beta test the usergroup amedment, anyone else want to test just pm me.
__________________
Kind regards,
Simon Microsoft Office Help
My Mods: Find my modifications here
Please do not pm me for support unless i have invited you to!
Reply With Quote
  #746  
Old 03 Jul 2013, 21:23
Spangle Spangle is offline
 
Join Date: Jun 2011
Originally Posted by Liff View Post
Thanks very much for a great a great mod and I would love to be able to leave it on now that I've got it to work.


Sadly, we have a large Twitter following and sadly some untrustworthy (And drunk!) members who would abuse the facility.

I may have missed this over the 50 pages so far, but is it possible to limit this to usergroups or to only tweet threads with a specific thread prefix (as I think you can limit those to usergroups?)

Or, to simplify.. Is there any way to choose which threads you'd like to tweet once they are open?

Sorry for the questions and thanks in advance to anyone kind enough to reply.
The way I work it is to use the forum selection in the settings, I have hidden forums that only Admin and Mods use, these are the only one that are tweeted.

Hope this helps
Reply With Quote
  #747  
Old 03 Jul 2013, 23:53
Videx's Avatar
Videx Videx is offline
 
Join Date: Feb 2007
Originally Posted by Spangle View Post
I have hidden forums that only Admin and Mods use, these are the only one that are tweeted.
I think you may have misspoke? What would be the point of publicly tweeting your hidden forums?

Of course I have our admin forums disabled from tweeting. But this is what we already said - using usergroups to limit tweets by limiting access to certain forums. Not quite the same thing as being able to directly assign usergroups to tweet (or not).
Reply With Quote
  #748  
Old 04 Jul 2013, 23:44
Black Tiger's Avatar
Black Tiger Black Tiger is offline
 
Join Date: Apr 2004
Ik hope somebody can help me. I have disabled hash tags, but do use bit.ly. I already had an app running from another tweet post thing and used those codes and keys, which should be fine.

Installed the mod as should be, but when I start a new thread, this error appears:
{"errorCode": 0, "errorMessage": "", "results": {"http://www.myforums.org/board/showthread.php?t=14483": {"userHash": "1xxxx", "shortKeywordUrl": "", "hash": "1baPagj", "shortCNAMEUrl": "http://bit.ly/1xxxx", "shortUrl": "http://bit.ly/1xxxx"}}, "statusCode": "OK"}
I cloaked my forum url and the bit.ly url a bit.
I'm running 3.8.7.

What am I doing wrong, how can I fix this?
__________________
Greetings, Black Tiger
Reply With Quote
  #749  
Old 04 Jul 2013, 23:59
Black Tiger's Avatar
Black Tiger Black Tiger is offline
 
Join Date: Apr 2004
Seems the problem lies within the bit.ly support.
When I disable that and set it to "is.gd" then it works, but it's only showing the thread title of a new thread.
No text at all.

Is there a way to fix both problems?
__________________
Greetings, Black Tiger
Reply With Quote
  #750  
Old 05 Jul 2013, 01:31
Videx's Avatar
Videx Videx is offline
 
Join Date: Feb 2007
Originally Posted by Black Tiger View Post
Seems the problem lies within the bit.ly support.
When I disable that and set it to "is.gd" then it works, but it's only showing the thread title of a new thread.
No text at all.

Is there a way to fix both problems?
The first is an easy solution - just don't use bit.ly. The second is by design I think. Just a title and a link. Might be a good feature request for the guy working on the newer version with the usergroup permissions.

Sounds a bit complicated though. You would have to ignore quotes and links and attachments. Then you would have to count the total length including the title and the link (shortened or not) and truncate at the previous word(s). If truncated, add <read more> at the end.

I doubt I would want to enable it, but who knows it might be worth a try.
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 01:36.

Layout Options | Width: Wide Color: