Create custom Twitter feeds to show on your website using Twitter API.
|Author:||Theme Blvd (profile at wordpress.org)|
|WordPress version required:|
|WordPress version tested:||4.9.5|
|Added to WordPress repository:||18-06-2013|
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|Total downloads:||67 336|
|Active installs:||5 000+|
Click to start download
Manage the Twitter feeds you've created.
Edit a Twitter feed.
Grab your application credentials from dev.twitter.com and put them in the plugin's Authorization settings.
Use the "Tweeple Twitter Feed" widget to display tweets in one of your widget areas.
Should fit naturally into most themes with no frontend styling added by the plugin.
If you're using a Theme Blvd theme, the widget will integrate as your old Theme Blvd Twitter widget did.
tweeplefolder to the
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to Tools > Tweeple to setup your Twitter API authentication and mange your Twitter feeds.
NOTE: This plugin does NOT require a theme with Theme Blvd framework. This is a plugin for all tweeple!
Once you’ve setup your Twitter API authentication settings (see FAQ), and created a Twitter feed, there are two ways to display a Twitter feed on the frontend of your website.
- Shortcode: You can use the
[tweeple_feed]shortcode like this:
- Widget: From Appearance > Widgets, use the “Tweeple Twitter Feed” widget in one of your sidebars.
What are “Authentication” settings?
This is sort of a pain, but as of June 2013, in order to access Twitter API from your website, you need to setup credentials with Twitter. The general concept is that you’ll need to create what Twitter calls a “developer application.”
Think of your WordPress website as the “application” — Once you have these credentials setup for your site, you’ll have full access to use Tweeple to pull from Twitter API.
How do I setup the “Authentication” settings?
After installing Tweeple, in your WordPress admin, go to Tools > Tweeple > Authentication and you’ll find your Twitter API application settings.
To create your “application,” login to Twitter, and go to: https://dev.twitter.com/apps
Create an application, and then create a user token for that application.
After you’re done, you’ll need to put in the following information to Tweeple at WP Admin > Tools > Tweeple > Authentication:
- API key — formerly “Consumer key”
- API secret — formerly “Consumer secret”
- Access token
- Access secret
Does it matter what account I setup my Twitter developer application under?
Nope. The Twitter account you create your developer application with doesn’t really matter. Once you have your authorization credentials setup, you’ll be able to use Tweeple to pull tweets from any public Twitter account, list, or search.
I posted to Twitter, but it’s not showing up on my website right away. What gives?
This is because of caching. Tweeple stores the information retrieved from Twitter in your WordPress database for a certain amount of time, before going back to Twitter to update the information.
Why does Tweeple use caching?
In the process of pulling from Twitter API for your website, caching is crucial. It is a big process for your web server to go out and pull from Twitter. So, you don’t want Tweeple pulling from Twitter every time someone visits your website.
Additionally, Twitter API has rate limits. So, in theory, if you had consistent traffic coming to your website and your server could handle pulling from Twitter on every page load without exploding, Twitter API would keep cutting your server’s IP address off.
Can I manually clear a Twitter feed’s cache?
Yup! Let’s say you’ve just posted a breaking Tweet that’s really important and you want your website visitors to see it right away. —
Just go to WP Admin > Tools > Tweeple > Twitter Feeds and click the button to clear a specific Twitter feed’s cache. After this, the next visitor to your website will trigger Tweeple to go out to Twitter and pull the latest tweets to be stored in the cache again.
Also note that any time you update a Twitter feed’s settings, the feed’s cache is cleared automatically.
Can I change how long Twitter feeds are cached for?
Yup. When editing any Twitter feed at WP Admin > Tools > Tweeple, you can change the cache time seconds under “Performance.”
Our recommended, and default, setting for this is 7200 seconds (i.e. 2 hours).
Note: We have safeguard implemented that does not allow you to set this less than 60 seconds. If you’re a developer and you know what you’re doing, you can change this limit with the filter “tweeple_cache_time_minimum”.
0.9.5 – 12/19/2017
- Added FontAwesome 5 compatibility (for Theme Blvd Framework 2.7+ themes).
0.9.4 – 01/27/2016
- Added filter
tweeple_cache_timefor manually filtering the cache time on a given feed.
- More detailed frontend error message when Twitter API credentials haven’t been setup by the user.
0.9.3 – 08/18/2015
- Fixed incorrect formatting of email addresses in tweets.
- Fixed WordPress 4.3 deprecated PHP4 style constructors.
0.9.2 – 07/31/2014
- Changed wording in admin to reflect new Twitter verbiage “API key” and “API secret” which were formerly “Consumer key” and “Consumer secret”.
- Added support for multiple feeds in shortcode. Ex:
- Further improvements to support for international characters.
0.9.1 – 02/18/2014
- Fixed Twitter icon for Recent Tweet element added to Layout Builder.
0.9.0 – 02/15/2014
- Admin style changes for WordPress 3.8+
0.8.0 – 02/11/2014
- Added option to control UTF-8 encoding on Twitter Feeds.
0.7.0 – 02/08/2014
- Fixed issues where cache would return ‘a’ instead of list of tweets when a non unicode character is in a tweet. (props @nielsvr)
0.6.0 – 06/26/2013
- Fixed “Exclude @replies” bug that resulted from 0.5 update.
0.5.0 – 06/24/2013
- Clear your Twitter feed caches, at Tools > Tweeple > Twitter Feeds, after this update.
- Separated out “Tweet Display Limit” with new “Raw Tweet Count” performance option for number of Tweets. — So, if you’re excluding retweets or @replies, you’ll want your raw Tweet count to be higher than your display limit.
- Expanded cached feeds to include
langfor your custom templating.
tweeple_do_entitiesboolean filter for advanced users to add entities to feeds for custom templating.
#hashtaglinks in Tweets not linking correctly to Twitter search.
- Tweet “Time” in admin is now “Details” for better referencing.
- Action hook
tweeple_tweet_metaand hooked functions also use term “meta” instead of “time”.
- Started library of helper functions that can be used for templating — See /inc/functions.php
- Developers can now merge multiple Twitter feeds, keeping Tweets all arranged chronilogically. — See code example
- Fixed “Tweet” element from last update in Theme Blvd framework v2-2.2.
- Minor improvements to error handling for end-user when fetching from Twitter.
- Minor improvements to Add/Edit Twitter feeds form.
0.4.0 – 06/20/2013
- Added support for “Tweet” Builder element in Theme Blvd themes.
0.3.0 – 06/19/2013
- Fixed CSS quirk with “Twitter Feeds” admin interface in Firefox.
- Improved saving and handling notices for Authentication settings page.
0.1.0 – 06/18/2013
- This is the first release.