Custom Twitter Feeds Plugin

Price: FREE
Sold By:

Author: Smash Balloon
Contributors: smashballoon, craig-at-smash-balloon
Support Website: http://smashballoon/custom-twitter-feeds/
Tags: Twitter, Twitter feed, Tweets, Twitter widget, Custom Twitter Feed
Requires at least: 3.0
Tested up to: 5.3
Stable tag: 1.4.1
License: GPLv2 or later
License URI:

Custom Twitter Feeds allows you to display completely customizable Twitter feeds of a user timeline, home timeline, or hashtag on your website.

== Description ==
Display **completely customizable**, **responsive** and **search engine crawlable** versions of your Twitter feed on your website. Completely match the look and feel of your site with tons of customization options!

= Features =
* **Completely Customizable** - by default inherits your theme's styles
* Twitter feed content is **crawlable by search engines** adding SEO value to your site
* **Completely responsive and mobile optimized** - works on any screen size
* Display tweets from any user, your own Twitter account and those you follow, or from a specific hashtag
* Display **multiple feeds** from different Twitter users on multiple pages or widgets
* Post caching means that your Twitter feed loads **lightning fast** and minimizes Twitter API requests
* **Infinitely load more** of your Tweets with the 'Load More' button
* Built-in easy to use "Custom Twitter Feeds" Widget
* Fully internationalized and translatable into any language
* Display a beautiful header at the top of your Twitter feed
* Enter your own custom CSS or JavaScript for even deeper customization

For simple step-by-step directions on how to set up the Custom Twitter Feeds plugin please refer to our [setup guide]( 'Custom Twitter Feeds setup guide').

= Benefits =
* **Increase social engagement** between you and your users, customers, or fans
* **Save time** by using the Custom Twitter Feeds plugin to generate dynamic, search engine crawlable content on your website
* **Get more follows** by displaying your Twitter content directly on your site
* **Improve your SEO** as all of that quality keyword-rich Twitter content is directly embedded into your website
* **Keep users on your site** by letting them reply and like your Tweets directly on your site
* Display your Twitter content **your way** to perfectly match your website's style
* The plugin is **updated regularly** with new features, bug-fixes and Twitter API changes
* Support is quick and effective
* We're dedicated to providing the **most customizable**, **robust** and **well supported** Twitter feed plugin in the world!

[View the reviews]( to see what other users are saying about the Custom Twitter Feeds plugin.

= Feedback or Support =
We're dedicated to providing the most robust and well supported Twitter feed plugin in the world, so if you have an issue or any feedback on how to improve the plugin then please [let us know]( 'Twitter Feed Support').

If you like the plugin then please consider leaving a review, as it really helps to support the plugin. If you have an issue then please allow us to help you fix it before leaving a review. Just [let us know]( 'Twitter Feed Support') what the problem is and we'll get back to you right away.

= Featured Reviews =
"***Great for Customization** - Great plugin! Superb customization options! Am changing all twitter feeds for all my websites to this! I have tried several plugins so far. This is the best I have come across :)*" - [@nehavivekpatil](

"***Excellent plug-in. Excellent support.** - Excellent instructions and guidance. Patient and prompt support for the newbies. Regular updates. You can't lose. Thank you Smash Balloon.* - [@nuspa](

"***Amazing Support and a Great Twitter Plugin** - I am using the free version of this plugin and identified a real problem in the display on my website. I emailed support and Craig was all over the fix for me. Seven or so emails later (even on a Sunday) the problem was fixed and Craig was still reaching out to make sure all was well.*

*In a world of crappy support for premium plugins, and even worse support for free plugins, this kind of support (and listening to customers) that Craig and Smash Balloon provided me make their premium products worth every penny. In fact, I am going to buy them on my next project. They deserve it.*

*Thanks again, Craig!*" - [@kcwebguy](

"***At last a configurable Feed that WORKS!** - I have messed with Twitter feeds on sites so many times only to be frustrated. This Plugin is the best I have tried. Stable, configurable and not too hefty a drag on performance. Well done!* - [@mikemac67](

"***Everything you'll need in a Twitter feed plugin** - We've tried a few Twitter feed plugins across a bunch of our sites, and this one is now our go-to favorite. Most of the others we've tried have either styling or performance issues, but we've been using this plugin for a few months now, and it's been perfect. There are tons of customization options, the feed looks great, and... it works!*

*Kudos to the SmashBalloon team on a well supported, tightly developed, feature-packed WordPress Plugin.* - [@laymanlab](

= Pro Version =
We recently released a [Pro version]( 'Custom Twitter Feeds Pro') which includes some awesome additional features:

* Display Tweets from **multiple users or hashtags in the same feed**
* Display **photos**, **videos**, and **gifs** and view them in a **popup lightbox** directly on your site
* Multi-column **Masonry layout** [demo]( 'Custom Twitter Feeds Pro Masonry Demo')
* Allow **filtering** of user timelines include/exclude any/all keywords/hashtags
* Customizable **Carousels** and **Slideshows**
* Fully functional **search endpoint**
* Display Tweets you're mentioned in
* Tweet-specific **moderation system**
* Visual **Twitter cards** displayed with links which support them
* Include **Tweet replies** (in reply to tweets)
* **Combine multiple feeds** into one
* **Autoload more Tweets** when scrolling

Try the Pro version [demo here]( 'Custom Twitter Feeds Pro Demo')

== Installation ==
1. Install the Custom Twitter Feeds plugin either via the WordPress plugin directory, or by uploading the files to your web server (in the /wp-content/plugins/ directory).
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to the 'Twitter Feed' settings page to configure your Twitter feed.
4. Use the shortcode [custom-twitter-feeds] in your page, post or widget to display your feed.
5. You can display multiple Twitter feeds with different configurations by specifying the necessary parameters directly in the shortcode: [custom-twitter-feeds hashtag=#smashballoon].

For simple step-by-step directions on how to set up the Custom Twitter Feeds plugin please refer to our [setup guide]( 'Custom Twitter Feeds setup guide').

= Setting up the Free Custom Twitter Feeds WordPress Plugin =

The Custom Twitter Feeds plugin is brand new and so we're currently working on improving our documentation for it. If you have an issue or question please submit a support ticket and we'll get back to you as soon as we can.

1) Once you've installed the Custom Twitter Feeds plugin click on the "Twitter Feeds" item in your WordPress menu

2) Click on the large blue Twitter login button to get your Twitter Access Token and Twitter Secret. Note; if you have your own Twitter Developer App set up then you can enter your Twitter information manually by enabling the checkbox below the Twitter login button.

3) Authorize the Custom Twitter Feeds plugin to read your Tweets.
Note; the plugin does not obtain permission to edit or write to your Twitter account, only to read your Twitter content.

4) Twitter sends back your Twitter Access Token and Twitter Secret which are then automatically saved by the Custom Twitter Feeds plugin. This information is required in order to connect to the Twitter API.

5) Enter a Twitter screenname to display Tweets from. Alternatively, choose to display Tweets from your Twitter home timeline or a Twitter hashtag.

6) Navigate to the Customize and Style pages to customize your Twitter feed.

7) Once you've customized your Twitter feed, click on the "Display Your Feed" tab for directions on how to display your Twitter feed (or multiple Twitter feeds).

8) Copy the [custom-twitter-feeds] shortcode and paste it into any page, post or widget where you want the Twitter feed to appear.

9) You can paste the [custom-twitter-feeds] shortcode directly into your page editor.

10) You can use the default WordPress 'Text' widget to display your Twitter Feed in a sidebar or other widget area.

11) View your website to see your Twitter feed(s) in all their glory!

== Frequently Asked Questions ==

= Can I display multiple Twitter feeds on my site or on the same page? =

Yep. You can display multiple Twitter feeds by using our built-in shortcode options, for example: `[custom-twitter-feeds screenname="smashballoon" num=3]`.

= How do I embed the Twitter Feed directly into a WordPress page template? =

You can embed your Twitter feed directly into a template file by using the WordPress [do_shortcode]( function: ``.

= Is the content of my Twitter feed crawlable by search engines and how does it help improve my SEO? =

Unlike other Twitter plugins which use iframes to embed your Twitter feed into your page once it's loaded, the Custom Twitter Feeds uses server-side code to embed your Twitter feed content directly into your page. This adds dynamic, search engine crawlable content to your site.

= Will Custom Twitter Feeds work with W3 Total Cache or other caching plugins? =

The Custom Twitter Feeds plugin should work in compatibility with most, if not all, caching plugins, but you may need to tweak the settings in order to allow the Twitter feed to update successfully and display your latest posts. If you are experiencing problems with your Twitter feed not updating then try disabling either 'Page Caching' or 'Object Caching' in W3 Total Cache (or any other similar caching plugin) to see whether that fixes the problem and the Twitter feed displays and updates successfully.

= The font in my Twitter feed isn't inherited from my website =

Be default your Twitter feed should inherit the font from your website. If this isn't the case then it's possible that something in the theme is preventing this from happening. An issue that we've run into before is that <code> tags are added into the Twitter feed HTML by either the theme, another plugin, or perhaps even the shortcode being wrapped in code tags in your page editor. To fix this;

1) First – go to your page editor, click on the 'Text' tab in the top right of the editor box, and check whether the [custom-twitter-feeds] shortcode is being wrapped in <code> tags, like so: <code>[custom-twitter-feeds]</code>. If it is, then remove them.

2) If this doesn't solve the problem then try adding the following to the plugin's "Custom CSS" section (Twitter Feeds > Customize > Custom CSS):

`#ctf code { font-family: sans-serif; }`

You can replace the font-family with whatever font your theme is using.

= Differences between the free version and Pro version of the Custom Twitter Feeds plugin =

The main differences between the free version and Pro version of the Custom Twitter Feeds plugin are listed below. The extra features available in the Pro version are as follows:

- Display photos, videos, and gifs in your Tweets, with support for 3rd party services such as YouTube, Vimeo, Vine, and SoundCloud
- View media in a pop-up lightbox directly on your site
- Display Tweets in a multi-column Masonry layout
- Display your Twitter feed in rotating Carousels / Slideshows
- Twitter Cards (rich, standout links) are displayed in Tweets for links that support them
- Create advanced Twitter "Search" feeds or use the "Mentions" timeline
- Combine feeds of multiple types (i.e. User feeds and Hashtag Twitter feeds combined)
- Filter feeds by hashtag, word(s), or remove specific tweets
- Autoload more tweets when scrolling to the bottom of the Twitter feed
- Include Tweet replies ("in reply to")

You can see the demo of the Custom Twitter Feeds Pro version [here](, and a video screencast [here](

= I'm receiving an error message when trying to display my Twitter feed =

If you receive an error message when trying to display your Twitter Feed then you can use the error reference below to diagnose the issue and find the relevant solution.

**Twitter Error:**
Could not authenticate you

- You may be using Twitter access tokens that are not valid - See #1 below
- You checked the box to enter your own Twitter app information, but one or more of the fields are incorrect - See #2 below

**Twitter Error:**
Invalid or expired token

- You may not have entered your Twitter access tokens or they are not valid - See #1 below

**Twitter Error:**
Unable to load tweets (with no other explanation)

- You may need to raise the number of tweets to retrieve and display in your Twitter feed - See #3 below

**Twitter Error:**
Sorry, that Twitter page does not exist

- There may be a typo in the Twitter screen name or hashtag you are attempting to use

**Twitter Error:**
Over capacity

- Twitter's servers are over capacity so the API is unusable. This will correct itself after some time.

**Twitter Error:**
Connection timed out after 10000 milliseconds

- Most likely this is due to your server blocking access to the Twitter API – See #4 below


**#1 - Your Twitter access tokens might not be valid**

The easiest way to verify this is by going back to the Settings page for the Custom Twitter Feeds plugin and clicking the big blue Twitter login button on the "Configure" tab to get new Twitter access tokens. If you haven't set up your own Twitter App, the only way to use the Custom Twitter Feeds plugin is to click the big blue button to get a Twitter access token and Twitter access token secret that is compatible with the default Twitter client used by Smash Balloon.

**#2 - You have checked the box to use your own Twitter app information but one or more of the fields are incorrect**

All four fields, consumer token, consumer secret, access token, and access token secret, need to come from the Twitter app that you set up on Try returning to your personal Twitter app management page and confirming that all four fields, consumer token, consumer secret, access token, and access token secret, and entered correctly in the corresponding fields on the plugin's "Configure" tab.

**#3 - You may need to raise the number of tweets to retrieve**

Navigate to the type of Twitter feed you are trying to display on For example, if you are displaying a Twitter feed from the screenname "smashballoon", go to Make sure there are tweets visible. Then click on the link "Tweets & replies". If there are a more recent replies than original tweets, there may be too many tweets being filtered out to display any. Twitter replies are removed by default. You can raise the number of tweets to retrieve initially by going to the Custom Twitter Feed Settings page, "Customize" tab, and navigating to the "Advanced" area. Then raise the "Tweet Multiplier" and test to see if your Twitter feed now displays tweets.

If you're still having trouble displaying your Tweets after trying the common issues above then please [contact support]( for assistance.

= Why do you guys love providing support so much? =

Not many developers love providing support, but we're a rare breed here at Smash Balloon. We take pride in the fact that you've chosen to use our plugin and want to help you with any issues you might have using it. It brings us joy to see our plugins out there in the wild making a difference on people's websites and we love interacting with any and all of our users! If you have a question or issue just let us know, we'll get back to you in no time to help!

== Screenshots ==

1. By default the plugin inherits styles from your theme
2. Display multiple Twitter feeds and customize each one
3. Custom Twitter Feeds Settings pages
4. Built in customization settings make customizing your feed easy
5. Additional styling options are built into the plugin
6. Use handy shortcode options to customize individual feeds
7. To display a feed just copy and paste the shortcode into a widget or page

== Changelog ==
= 1.4.1 =
* Tweak: Added aria-label attributes to SVG icons for improved accessibility.
* Fix: Fixed PHP warning that occurred when a URL in the tweet text did not have a full length URL available from the Twitter API.
* Fix: Using the setting to link the tweet text to Twitter would cause nested links and invalid HTML.
* Fix: Fixed Twitter logo not displaying if avatar, author, and date were hidden.

= 1.4 =
* New: Twitter logo added to the top right of each tweet to fit with Twitter's display guidelines. Customize the logo on the "Style" tab, "Author" area or hide it using the settings on the "Customize" tab "Show/Hide" settings.
* New: Minified versions of JavaScript and CSS files now used.
* New: JavaScript file added to the source of the page only when the shortcode is used on the page.
* New: SVGs used for icons instead of Font Awesome font file. You can switch back to using the Font Awesome font file on the "Customize" tab, "Advanced" area.
* New: Tweets that are replies to the same account or mention the same account can be included in the feed by enabling the setting "Always include replies to self in the feed".
* New: Added a setting to completely disable Twitter intents widget.js file.
* Tweak: The HTML element used for icons has been switched from "i" to "span" for better accessibility.
* Tweak: Changed styling of media placeholder icons.
* Tweak: Combined widgets.js file with native JavaScript file for the plugin.
* Tweak: Twitter widgets.js will only be enqueued when "actions" are included in the feed.
* Tweak: Tweet text line height style set to 1.4.
* Fix: Bio text not displaying in header even when enabled.

= 1.3 =
* New: You can now choose to only display a certain amount of text characters in your Tweets, with a clickable link to display the rest. This is set to be 280 characters by default, but can be changed by using the following setting: Customize > Style > Tweet Text > Text Length, or by using the "textlength" shortcode setting.
* Tweak: Twitter intents JavaScript not loaded on the page if tweet actions are removed
* Fix: Removed target="_blank" from div element

= 1.2.11 =
* Fix: Quoted tweets would not display if saving settings on the "Customize tab". After updating, Enable "Quoted tweet box" in the "Show/Hide" section to display quoted tweets
* Fix: Fixed PHP warning caused by trying to count a boolean in certain circumstances

= 1.2.10 =
* Tweak: Updated the Twitter login button URL
* Fix: Avatar would appear to the right of Tweets or not at all in some versions of Firefox
* Fix: Minor bug fixes

= 1.2.9 =
* Fix: Fixed PHP warning caused by trying to count a boolean in certain circumstances
* Fix: AJAX load more not working when AJAX themes being used

= 1.2.8 =
* Fix: "Preserve settings on uninstall" setting not working correctly
* Fix: Clear cache button would not clear all caches in some situations

= 1.2.7 =
* New: Added screen reader labels for improved accessibility
* Fix: Bug with "persistent" cache duplicating tweets

= 1.2.6 =
* Fix: Twitter hashtag feeds now work for hashtags beginning with a number e.g. #1august
* Fix: Added a workaround for a minor formatting issue caused by some themes

= 1.2.5 =
* New: Added an option to remove the placeholder icon that's used when a Tweet contains media. This can be found under `Customize > Show/Hide > Media placeholder` or using the `exclude` shortcode option, eg: `exclude="placeholder"`.
* Fix: Individual tweet links in mobile would not properly link to
* Fix: Error message displayed instead of empty tweets for empty persistent caches

= 1.2.4 =
* Fix: Custom date format not working in settings area
* Fix: Twitter avatars would disappear from the feed in Firefox for certain accounts
* Fix: Changed http: links to https:
* Fix: Fixed retweets always being included in persistent caches during the initial tweet retrieval

= 1.2.3 =
* Fix: Fix php warning when no media in tweets under certain circumstances
* Fix: Missing "alt" attributes for Twitter avatars

= 1.2.2 =
* Fix: Fixed an issue with include/exclude string to array conversion warning

= 1.2.1 =
* Fix: Fixed an issue where line breaks in tweet text were being ignored
* Fix: Fixed an issue where a small line was added to quoted tweets in retweets that have no media

= 1.2 =
* New: The plugin now uses persistent tweet caching for Twitter hashtag feeds. By default, when displaying hashtag feed Twitter only returns Tweets from the last 7 days, but the persistent cache now allows you to display these Tweets indefinitely.
* New: Tweets with media will have an icon and label that links to the tweet on
* Fix: Fixed an issue with checkbox settings being changed unintentionally after obtaining a new Twitter access token

= 1.1.8 =
* Tweak: Updated Custom Twitter Feed plugin links for new repo
* Fix: Minor bug fixes

= 1.1.7 =
* Fix: Fixed an issue with the Twitter Access Token and Twitter Secrets not automatically being saved when initially obtaining them
* Fix: Fixed an issue with some customization settings not saving occasionally

= 1.1.6 =
* Fix: Fixed an issue when creating a Search feed using the built-in Custom Twitter Feeds widget box
* Fix: Fixed an issue with the checkbox that allows you to toggle links on/off in the Tweet text

= 1.1.5 =
* Fix: Fixed a rare issue when loading more Tweets
* Fix: When there is no bio text in the header then the Twitter screenname text is now automatically centered vertically

= 1.1.4 =
* Fix: Fixed an issue with some setting checkboxes
* Fix: Fixed a rare encoding issue which occurred on some server configurations
* Tested with the upcoming WordPress 4.6 update

= 1.1.3 =
* Fix: Prevented any duplicate Twitter Tweets from being shown
* Fix: Fixed a rare issue where a couple of settings weren't being saved successfully

= 1.1.2 =
* New: Launched a [Pro version]( 'Custom Twitter Feeds Pro') which includes some awesome additional features!
* Fix: Minor bug fixes

= 1.1.1 =
* Fix: Added SSL support for Twitter avatar images so https version is used
* Fix: Fixed an issue with the "hours" custom text string displaying the "minutes" text instead

= 1.1 =
* New: Added a setting to translate the "Retweeted" text
* Tweak: If there aren't enough Tweets to populate the feed them Ajax in more automatically
* Fix: Custom JavaScript is now rerun every time the Load More button is used
* Fix: CSS display tweaks

= 1.0.1 =
* Bug fixes

= 1.0 =
* Launched the Custom Twitter Feeds plugin!

Custom Twitter Feeds Plugin
Price: FREE

Display **completely customizable**, **responsive** and **search engine crawlable** versions of your Twitter feed on your website.

View Cart