WP Twitter Like Box v1.3
WP Twitter Like Box
Created: 20/05/2013
Updated: 31/05/2013
By: Damian Logghe
Email: info@timersys.com
Website: timersys.com
Twitter: @chifliiiii
Thank you for downloading my plugin. If you have any questions that are beyond the scope of this help file, please feel free to email me or contact me via my contact form on my website. Thanks so much!
Table of Contents
A) Installation - top
Move the folder named wp-twitter-like-box (located inside the wp_twitter_like_boxv1.3 folder you just downloaded and extracted from CodeCanyon to your WordPress /wp-content/plugins/ folder.
Navigate to Plugins inside the admin interface of your WordPress website and click Activate for WP Twitter Like Box. Congratulations! the plugin is now installed and activated.
If you have any trouble with the installation, please feel free to contact me for help.
B) Quick Start - top
Once you have installed and activated WP Twitter Like Box, you can follow this quick start guide for displaying the WP Twitter Like Box widget on the sidebar of your WordPress website.
1. Authorization with Twitter
You are required to authorize yourself with Twitter to use Twitters REST API version 1.1. We make it simple for you.
First navigate your browser to Twitters Developer website, if you don't already have an account, create one now.
Once you have a Twitter dev account, log in and navigate to your Twitter apps and create a new application.
Once you have created your Twitter application, navigate to it's settings page and look for the fields called Consumer key, Consumer Consumer secret, Access token and Access token secret. If you just created the app you will need to click the button that says "Create access tokens" and refresh your window.
Now open up a new tab and go to your WordPress admin interface and navigate to Plugins > WP Twitter Like Box > OAuth , copy and paste your Consumer key, Consumer secret, Access token and Access token secret from your Twitter application settings over into your WP Twitter Like Box settings.
And finally, Save the changes.
2. Displaying the widget
Now that you are authorized with Twitter, navigate to your WordPress widgets. You should see 1 new widget:
- Twitter Like Box
For displaying Twitter Like Box, drag and drop the widget into your sidebar. Enter your Twitter screen name into the username field and save the widget. If you want, you can also specify how many users to show. To show followers or people you follow and the width of the widget (default to 100%).
That's it! The Twitter Like Box should now be displayed on your sidebar.
C) Shortcodes - top
As well as WordPress widgets, you can display the Twitter Like Box using shortcodes:
Basic Shortcode
[TLB username="chifliiiii"]
All available options
[TLB id="my-shortcode-id" username="chifliiiii" total="10" width="100%" show_followers="followers" link_followers="yes"]
- id - Used to store the result in cache. Necessary if you use multiple Like boxs with different settings
- username - Twitter username without @
- total - total users to display
- width - the total width of the widget (default to 100%)
- show_followers - if you set this to false the widget will display the users you follow instead of the users that follow you.
- link_followers - By default every user showed on the widget will include a link to their Twitter account. Set this to no to remove the link
D) PHP function - top
It works the same way as shortcodes. Just call it like:
<?php twitter_like_box($username="chifliiiii") ?>
With all the options:
<?php twitter_like_box($id="my-shortcode-id", $username="chifliiiii", $total="10", $width="100%", $show_followers="followers", $link_followers="yes") ?>
- id - Used to store the result in cache. Necessary if you use multiple Like boxs with different settings
- username - Twitter username without @
- total - total users to display
- width - the total width of the widget (default to 100%)
- show_followers - if you set this to false the widget will display the users you follow instead of the users that follow you.
- link_followers - By default every user showed on the widget will include a link to their Twitter account. Set this to no to remove the link
E) Sources and Credits - top
- WordPress
- OAuth - OAuth protocol
- twitteroauth - Twitter PHP OAuth Library by abraham
Once again, thank you so much for purchasing this plugin. As I said at the beginning, I'd be glad to help you if you have any questions relating to this plugin. No guarantees, but I'll do my best to assist. If you have a more general question relating to the plugins on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Timersys