A Professional Business Template
image Follow Us:
RokTwittie

Versatile Real Time Twitter

RokTwittie is a widget that integrates Twitter into your WordPress site. Display tweets of any username, or even by search terms, as well as your profile information and various other elements from Twitter itself. RokTwittie is the perfect compliment to any Social site, or Business site that uses Twitter.

The plugin is highly configurable with everything being entirely collapsible and segmented. Only show what you want, whether that is just a twitter feed, or something more substantial with search times and profile information. RokTwittie also uses Twitter’s App Authentication service.

Requirements

  • WordPress – ensure you are using the latest version.
  • CURL – this needs to be enabled on your server for the widget to work. You can contact your hosting provider to activate this for you.

NOTICE: If you experience the Fatal error: Call to undefined function curl_init() error then you need to have CURL enabled on your server. You can ask your hosting provider to activate this.

List of Features

  • Real Time Tweets: Tweets update live from Twitter
  • Search: Use the inbuilt search to scan for usernames or keywords
  • Profile information: Show your profile details, such as name, avatar and bio
  • Fast Loading: Written from the ground up for greater performance
  • Highly configurable: Options to control every aspect of RokTwittie
  • Twitter Authentication: Choose between Anonymous and App Authentication
  • Retweet Support: http://support.twitter.com/forums/10711/entries/77606-what-is-retweet-rt
  • Caching
  • Friendly Errors: If Twitter is down, or CURL is not installed, RokTwittie will fail gracefully

WordPress RokTwittie Installation

Standard Installation

  • Download the RokTwittie WordPress plugin
  • In WordPress, navigate to Plugins → Add New → Upload
  • Find the plugin zip file and upload to install
  • Activate the plugin

FTP Installation and Updating:

  • Unzip the downloaded RokTwittie plugin file
  • Upload the unzipped folder to your website files → wp-content → plugins
  • Navigate to the Plugins screen in WordPress and activate the plugin

RokTwittie Widget

In order to display RokTwittie on the front end of your website, the RokTwittie widget must be placed into a Widget position in your theme. Navigate to Appearance → Widgets and place the widget where you would like it to appear.

You may choose a Widget title and add custom CSS variations for custom styling in the widget controls. All other settings are found in the plugin settings screen.

roktwittie-widget

RokTwittie Settings

All RokTwittie settings can be found on the settings page located under the Plugins menu → RokTwittie

Authorize RokTwittie

In order for RokTwittie to display your Twitter feed, it must be authenticated with a Twitter app.

Twitter App Registration

First, you will need to register your website as a Twitter Application:

  • Go to https://dev.twitter.com/apps/new and log in with your Twitter account.
  • Once logged in your will be taken to the Create an Application screen

    roktwittie-auth01

    Fill in the details, agree to terms of service, CAPTCHA protection and click save.
    • Name: Name of Application
    • Description: Description of Application
    • Website: Your website URL
    • Callback URL: Also your website URL
  • Once saved, you will be taken to a screen with your OAuth settings.
    Make Note of the Consumer Key and Consumer Secret – you will enter these keys into the RokTwittie Settings.

    roktwittie-auth02

RokTwittie Settings

In your RokTwittie settings, you will need to Authenticate the app you just created and configure RokTwittie to work with it.

  • In the settings, click Yes for the Use OAuth setting. The authentication fields will then appear below.
  • Copy and Paste your application consumer key into the field
  • Copy and Paste your application consumer secret in the field
  • Save The RokTwittie Settings

    twittie-save twittie-save
    Clicking on Sign in to Twitter before the key and secret are saved in the settings will give a keys not configured error. You must save the settings before Authenticating.
  • Once you have saved, click the Authenticate “Sign in with Twitter” Button

    authenticate
  • You will be taken to a Twitter Login Screen, log in with your Twitter account information to complete the Authentication process.
  • You will then be re-directed back to the settings screen and the Status will change to Using Authenticated Mode.

    joomla-auth-mode
  • Save the settings once again

Tips: If you are still seeing the RocketTheme Twitter stream on your website, disable output caching and make sure your user name is entered in the user name field. Once you have the display correct, you can re-enable the output caching.

joomla-oauth-tips

RokTwittie Settings

RokTwittie is a highly configurable plugin that allows you to control the various aspects of its appearance and functions. Details of each options are as follows:

roktwittie-config

  • Status: Displays which mode you are using, Anonymous or Authenticated Mode.
  • Use OAuth: Enable Twitter’s App Authentication service.
  • Twitter APP consumer key: Only visible if Use OAuth is set to yes. Enter your Twitter APP consumer key in this field.
  • Twitter APP consumer secretOnly visible if Use OAuth is set to yes. Enter your Twitter APP consumer secret in this field.
  • Authenticate: Button only visible if Use OAuth is set to yes, both the consumer key and consumer secret have been set and the plugin settings have been saved. Use this to authenticate your Twitter APP information and complete the OAuth process.
  • Load Built-in CSS: Choose whether to load the standalone styling or to load the CSS from the template. You should disable this option if you are using a Rocket Theme with built in RokTwittie styling or wish to use your own CSS styling.
  • Output Caching: As the name suggests, if this is enabled, the widget will enable caching in order to save on performance and prevent the 100 Twitter API limit being met.
  • Timeout on connect (secs): Set connection timeout limit.
  • Timeout on response (secs): Set response timeout limit.
  • Cache Time: If caching is enable, set, in minutes, the time you wish before it is cleared and new data is called.
  • Usernames, separated by comma: You do not need to fill out the Twitter login or password for RokTwittie to function. You can insert your username or multiple usernames (separated by a comma) here and the widget will load them. If you wish to load your own profile, then enter your username into this field. As Twitter has a 100 hit limit on its API, this field was created to subvert that issue. If you are going to experience high traffic, fill this field then the 100 hit limit does not apply.
  • Inactive user opacity: This sets the opacity of the inactive user tab, if you have multiple users set to show in RokTwittie.

Username Statuses

  • Show default avatars: When enabled, your profile picture from Twitter will appear in the widget, alongside your other profile information.
  • Header style: Choose either a dark header or a light header from the built in CSS if you have Load built-in StyleSheet set to Yes. This function may not work by default with individual theme styles or custom CSS if Load built-in StyleSheet is set to no.
  • Include ReTweets: Includes retweets in the widgets Twitter Feed
  • Enable username statuses: This option controls whether the statuses from each username appears in the widget.
  • Open links in new window: A self explanatory parameter, basically, all links in RokTwittie can be set to either open in a new window (will default to a new tab in certain browsers) or load in the page you are viewing.
  • Show RSS feed link: This parameter controls whether the RSS feed link for your profile appears in the widget, it is accompanied by the RSS feed icon.
  • Show Follow Updates Link: Set to show if you wish to show the updates link.
  • Show the Bio Description: Set to show if you wish to show your Twitter Bio in the widget.
  • Show the URL: If you have a website address in your profile, this option allows you to show it.
  • Show the location: Again, if this is set in your twitter profile, you can set it to appear.
  • Show user updates count: Show the number of updates of the user.
  • Show user followers count: Show the number of those who are following the user.
  • Show user following count: Show the number of those who the user is following.
  • Show following icons: Set to show if you wish to show the icons/avatars of the users who are following the user.
  • Icon Count: If icons are enabled, this option controls the number that are displayed.
  • Show View all after Icons: When enabled, an additional link will be placed below the icons to view all of the following twitter users.

Username Tweets

  • Enable usernames tweets: This parameter allows you to show the tweets from the user set above.
  • Show usernames avatar: Set to show if you wish to show the avatar next to each tweet.
  • Size in pixel of the avatar: If you set the username avatars to show, this controls the size in pixels.
  • Tweet count: This sets the number of tweets to show if enabled.
  • Merge Tweets: Remove duplicate tweets.
  • Open links in new window: A self explanatory parameter, basically, all links in RokTwittie can be set to either open in a new window (will default to a new tab in certain browsers) or load in the page you are viewing.
  • Show tweets sources: When enabled, the sources of each tweet will be shown.
  • Show username as prepended text: If set to show, the username of the tweeter will appear before each tweet.

Search Tweets

  • Enable search tweets: This parameter allows you to show the tweets from the search option.
  • Search string: Enter the value you wish to search for in Twitter.
  • Show search avatar: Set to show if you wish to show the avatar next to each search tweet.
  • Size in pixel of the avatar: If you set the search avatars to show, this controls the size in pixels.
  • Tweet count: This sets the number of tweets to show if enabled.
  • Open links in new window: A self explanatory parameter, basically, all links in RokTwittie can be set to either open in a new window (will default to a new tab in certain browsers) or load in the page you are viewing.
  • Show tweets sources: When enabled, the sources of each tweet will be shown.
  • Show username as preopened text: If set to show, the username of the tweeter will appear before each tweet.