What is this plugin used for?
Tweet Blender is a sidebar widget that displays tweets from keywords (i.e. Ryerson) hashtags (i.e. #Ryerson) and/or Twitter IDs (i.e. @RyersonU).
To use this plugin, you must have a Twitter account – you will need to authorize Tweet Blender using this Twitter account.
Tweet Blender plugin page: https://wordpress.org/plugins/tweet-blender/
Before you begin
These instructions assume you have already activated the plugin in the Plugins section of your blog’s Dashboard. For more information on plugin activation, please see the page on Plugins.
Start by logging in to your Twitter account
- You will need to have a Twitter account in order to use this plugin.
- Login at https://twitter.com. Doing this before you start the plugin setup is a good idea.
Authorizing the plugin with Twitter
You need to authorize the plugin with your Twitter account before it will work. It’s best to do this at the beginning, so you don’t forget.
- In your blog’s Dashboard, go to Settings > Tweet Blender.
- Click the Status tab in the Tweet Blender settings page.
- Look for the “oAuth Access Tokens” setting – notice that it says “Not Present”. Click the link to “Use your Twitter account to login”.
- A Twitter popup window will appear. Since you logged into Twitter before starting the plugin setup process, it should already know who you are. Click the blue “Authorize app” button.
- You will receive a message that “Authorization was successful”. Click the “close” button to return to the Tweet Blender setup page.
To authorize Tweet Blender with a different account
If you have already authorized Tweet Blender to use a Twitter account, and you would like to switch it to a different Twitter account, you can do the following to clear the authorization so you can start over.
- In your blog’s Dashboard, go to Settings > Tweet Blender > Advanced tab.
- Check the box to “Clear oAuth Access Tokens” (this will only appear if you have already authorized a Twitter account).
- Click the blue Save Settings button.
- Follow the above steps to authorize a new Twitter account.
Some useful plugin settings
There are a variety of settings for the Tweet Blender plugin. Some will be useful for you, and some will not. I recommend trying the Tweet Blender widget with the default settings before you start changing anything. That will give you an idea of how it works out of the box.
The following are just a few of the settings that you may want to use. Don’t forget to click the blue Save Settings button once you have made a change!
- Show tweet source for each tweet. – This will show which method the poster used to tweet (such as Twitter for iPhone, Instagram, and TweetDeck).
You can create an archive page on your blog, to collect and display the tweets aggregated by the plugin.
- Create archive page automatically – creates an archive page for you
- Maximum number of tweets to show – how many tweets should it retain?
- there are a few other settings that may be useful for the archive page
This tab has some options that allow you to filter out certain elements from the feed.
- Filter by language
- Hide tweets that come from different users but have exactly the same tweet
- Hide replies
- Hide retweets
Adding the Tweet Blender widget
To display tweets on your blog, you will need to add a widget to one of the widgetized areas (a sidebar, footer, etc.).
- In your blog’s Dashboard, go to Appearance > Widgets.
- Scroll through the available widgets on the left side, and click on Tweet Blender.
- Click to select the widget area where you would like the Tweet Blender widget to appear.
- Click the blue “Add Widget” button.
- On the right side, locate the widget area that contains the Tweet Blender widget. If it appears to be closed, click the widget to open up the options.
- Widget options:
- Title: the default is Tweet Blender, but you can change it.
- Sources: enter the keywords (i.e. Ryerson) hashtags (i.e. #Ryerson) , Twitter IDs (i.e. @RyersonU) and/or lists (i.e. @RyersonU/Ryerson University) that you want aggregated by the widget. Be sure to enter each term on its own line.
IMPORTANT: You may only add up to 3 sources here. If you add more, and your blog taxes the system, we reserve the right to take it offline immediately. How to add content from more sources? See the section below.
- Refresh: The preferred option is “Only once, on load”, after which a visitor can manually refresh the tweets as needed.
- Show: select the number of tweets to display. It’s best to not display too many, but try out different values to see what works best for your blog.
- URL for “view more” link: this is most useful if you are only adding a single account or hashtag to the widget. You can enter the Twitter URL for that hashtag or account – or you can just leave this field blank.
- Text for “view more” link: Only enter text here if you are using the “view more” link option. Make sure the link is meaningful, and not just “view more”.
- Click the blue Save button to save the changes to the widget.
- Go to the front-end of your blog and refresh the page.
Adding content from more than 3 sources using Twitter Lists
The limit of 3 sources added to the Tweet Blender widget is a precaution that we must take in order to keep our system running smoothly. Add too many sources to your site, and it could cause performance problems that affect ALL blogs on the network.
If you would like to pull tweets from more than 3 sources, start by creating a list in Twitter. Lists allow you to aggregate the tweets of multiple users. For more details on Twitter lists, please see this document: https://support.twitter.com/articles/76460-using-twitter-lists