WordPress.org

This section describes how to install the plugin and get it working.

1. Upload the entire tweet-blender directory to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use admin Settings > Tweet Blender to specify configuration options

Adding Tweet Blender to Sidebar

If you'd like to show one or more widgets in your sidebar follow these simple steps.

1. Go to WP admin > Appearance > Widgets
2. Drag and drop widget of your choice into the appropriate place on your sidebar. You can add multiple widgets and have each of them blend different sources.
3. Update configuration options and Save them

Note: The Tweet Blender For Tags widget will show up in your sidebar only on a dedicated post page and only if that post has tags. For index and custom pages (and for posts without tags) nothing will be shown.

Adding Tweet Blender to Posts and Pages

You can insert the widget directly into the body of your post or page by following these simple steps:

1. Click on New Post in WP Admin to start working on your new post
2. In editor, click on the HTML tab in the upper right corner so you are looking at the HTML source of your post
3. Enter the following HTML where you want the widget to appear and update configuration options

<form id="tweetblender1" class="tb-widget-configuration" action="#"><div>
<input type="hidden" name="sources" value="@tweetblender,#tweetblender,@tweetblender/testlist,tweetblender" />
<input type="hidden" name="refreshRate" value="60" />
<input type="hidden" name="tweetsNum" value="4" />
<input type="hidden" name="viewMoreUrl" value="http://twitter.com/tweetblender" />
<input type="hidden" name="viewMoreText" value="Follow Us!" />
</div></form>

1. When you are done editing, save the page/post.

Notes: make sure the id of the form is unique on that page. Only sources is a required setting.

Adding Tweet Blender to Templates

For greater flexibility, there is a PHP template tag that allows you to add tweet blender to a custom page template or a template in your theme. Edit the PHP page template where you want to include the widget and put the following tag in:

tweet_blender_widget(array(
    'unique_div_id' => 'tweetblender-t1',
    'sources' => '@knovitchenko,@tweetblender/testlist,#tweetblender,twitter',
    'refresh_rate' => 60,
    'tweets_num' => 5,
    'view_more_url' => 'http://twitter.com/tweetblender',
    'view_more_text' => 'follow us!'
));

Options

• unique_id_id = Required. The ID of your widget. It has to be unique on each page where widget(s) is on. Widgets added through Appearance > Widgets automatically have unique IDs because WordPress creates them for you using 'tweetblender-X' format where X is a number. It is recommended that you use a similar format for this ID e.g. 'tweetblender-t1' or 'tweetblender-tag1'
• sources = Required. List of sources to blend separated by comma. Don't forget the single quotes around this parameter.
• refresh_rate = Optional. How often to refresh the list. In seconds i.e. 60 = 1 minute. Set to 0 to disable automatic refresh.
• tweets_num = Optional. How many tweets to show in the widget.
• view_more_url = Optional. The url where "view more" link points to. Don't forget the single quotes around this parameter.

For the related tweets widget that uses post's tags you would use the following:

tweet_blender_widget_for_tags(array(
    'unique_div_id' => 'tweetblender-tt1',
    'refresh_rate' => 60,
    'tweets_num' => 5
));

Options

• unique_div_id = Required. The ID of your widget. As mentioned above, it has to be unique on each page where widget(s) is on.
• refresh_rate = Optional. How often to refresh the list. In seconds i.e. 60 = 1 minute. Set to 0 to disable automatic refresh.
• tweets_num = Optional. How many tweets to show in the widget