Plugin / BW Twitter Blocks

Installation

1. Upload bw-twitter-blocks folder to your /wp-content/plugins/ directory
2. Activate the plugin in WordPress admin
3. Setup plugin options under #BW Options -> Twitter Blocks
   3a. Connect Twitter Account: Connect to your Twitter account by clicking the “Sign in with Twitter” button. You will be taken to twitter.com to sign in and authorize the plugin to access your tweets and then be redirected back to WordPress.
   3b. Twitter Update Frequency: The plugin will automatically fetch new tweets on a regular schedule, set here.
   3c. Convert to Links: Selected types of links in tweets will be converted to HTML links, with some additional data tags for use by custom scripts.
   3d. Unshorten Links: The plugin will convert shortened links to their original full URL. The conversion significantly affects performance so please specify only the services you absolutely need to convert. In practice most links do not need to be converted.
   3e. Manual Update Twitter Blocks: Click “Update Now!” to manually fetch new tweets. You will need to click this when setting up the plugin, after connecting your twitter account.
   3f. Clear Stored Tweets: Delete all cached twitter posts.
4. After connecting your Twitter account for the first time, you must manually fetch new tweets (see 3e above).
5. Add bw_twitter_blocks_fetch() to template file to display tweet blocks.

How to display tweet blocks:

Use <?php $blocks = bw_twitter_blocks_fetch( $args ); ?> in a template file.

<?php $default_args = array(
    'orderby' => 'menu_order',  // orderby for blocks of tweets
    'order' => 'ASC',           // order for blocks
    'blocks' => -1,             // how many blocks to display (-1 for all)
    'tweets_per_block' => 6,    // how many tweets to display per block,
    'single' => 0               // pass a post ID to fetch a single specific block (returns a single post object)
); ?>

Return value is an array of objects from get_posts() for the blocks. The ‘tweets’ key for each object holds an array from get_posts for the tweets within that block. Tweets within each block are ordered by original tweet date.