Mitsol Tweet display documentation for wordpress
*Before purchase/running the plugin, make sure system requirements are met(look for tab in settings page)
*To run the plugin you must create twitter application and get all keys as summarized in sections below.
Because of displaying tweets from twitter.com, lots of things have to consider for successful tweet display, so if there are any problems caused by your site, just contact and problem will be solved.
How to install
Installation is easy just click add new->uplaod in plugins menu in admin dashboard, then select the plugin zip to install. If pro version, then find the installable zip inside downloaded zip. Before installing pro version, uninstall free version completely by deleting all the files. Then install pro version.Important: Twitter api call/request limit
There are limits on calling to twitter api to get tweet data. loading a tweet plugin with data is said to be one request to twitter api. One unique plugin can make -1. total 180 requests per 15 minutes for getting tweets of a user and
2. total 180 requests per 15 minutes for getting tweets of a hashtag or search string
here one unique plugin means where there are different plugin settings(if you used different shortcodes in website) but have same settings(same username/hashtag/search string input and application consumer key, secret key, access token, token secret), does not matter on how many pages you have that unique plugin displaying twitter feed in your site.
If each unique plugin's requests to twitter api exceeds above request limit in your site, your twitter application/account may be banned, so to overcome the problem, caching the tweet data in database table is used. each unique plugin will save tweet data for 3 minutes in database table before making another request to twitter api to get all new tweet data.
Because of cache, unique plugin's combination will be different from above like - "same username/hashtag/search string input & application consumer key, secret key, access token, token secret & number of posts value"
For an example, if your unique plugin set to show tweets of user "twitterapi" and number of tweets set is "10" then tweet data will be saved in database with this name combination - "mitsoltweets_user_twitterapi_10" and 3 minutes counting will start with it, in this 3 minutes no matter how many times your users load your different pages along with that unique plugin, they will see same tweet display unitil 3 minutes expired to see new data. If you change either username/hashtag/search string or number of tweets then unique plugin will get & save new tweets data to cache table with new name like - "mitsoltweets_user_twitterapi_20" or "mitsoltweets_user_messi_10" and 3 mintues counting starts with it. So always make sure how many unique plugins you place in your site which don't exceed request limit of 180 per 15 minutes to twitter api (Although caching reduced that limit to 5 in 15 minutes, but can vary if you use different unique plugins with different tweet display). FYI if you use one twitter application's keys and access token for a unique plugin then its counting of request limit is different from another unique plugin request limit which uses another application's keys and access token.
To run twitter plugin, you must create twitter application and use its keys. All steps are written below -
Create twitter application and keys -
Step1: Login to your twitter account. Then go to this page - https://apps.twitter.com/. Click 'Create new app'. Following page will appear as shown in image below. enter all fields except Callback url, then check 'yes i agree' check box and click 'Create your twitter application' button.
you will get application generation success message and application details tab.
Step2: There click 'API keys' tab and you will see api key and secret codes as shown at the top of the image below. At bottom click 'Create my access token' button and your access token and token secret codes will be created after some time by refreshing the page if needed As shown finally in the image below -
copy that 'API key' value and put in 'Consumer key' box in plugin 'general settings' tab in tweet plugin settings page. In the same way -
copy 'API secret' value into 'Consumer secret' box in tweet plugin general settings tab,
copy 'Access token' value in 'Access token' box in tweet plugin general settings tab,
copy 'Access token secret' value in 'Access secret' box in tweet plugin general settings tab and save plugin settings.
Configure plugin settings to display tweets -
1. In plugin's general settings tab in settings page, select either "tweets" or "tweet slide" by the setting "Select tweet display view" to display tweets normally with scroll or as sliding of tweets.2. Also select for "Get tweets from" to display tweets from a user or hashtag or search string.
3. Acoording to that selection above enter your twitter username or hashtag or search string in the corresponding setting input box( twitter user name, hashtag(excluding #), search string )
4. Rest of the settings are relating with layuout/general settings of tweet display.
5. "Slide view settings" tab are for customizing tweet slide display