'widget_twitter', 'description' => __( 'Follow a Twitter Feed', 'twitter-widget-pro' ) ); $control_ops = array( 'width' => 400, 'height' => 350, 'id_base' => 'twitter' ); $name = __( 'Twitter Widget Pro', 'twitter-widget-pro' ); $this->WP_Widget('twitter', $name, $widget_ops, $control_ops); } private function _getInstanceSettings ( $instance ) { $defaultArgs = array( 'title' => '', 'errmsg' => '', 'fetchTimeOut' => '2', 'username' => '', 'hiderss' => false, 'hidereplies' => false, 'avatar' => false, 'showXavisysLink' => false, 'items' => 10, 'showts' => 60 * 60 * 24, ); return wp_parse_args( $instance, $defaultArgs ); } public function form( $instance ) { $instance = $this->_getInstanceSettings( $instance ); ?>

_getInstanceSettings( $new_instance ); // Clean up the free-form areas $instance['title'] = stripslashes($new_instance['title']); $instance['errmsg'] = stripslashes($new_instance['errmsg']); // If the current user isn't allowed to use unfiltered HTML, filter it if ( !current_user_can('unfiltered_html') ) { $instance['title'] = strip_tags($new_instance['title']); $instance['errmsg'] = strip_tags($new_instance['errmsg']); } return $instance; } public function flush_widget_cache() { wp_cache_delete('widget_twitter_widget_pro', 'widget'); } public function widget( $args, $instance ) { $instance = $this->_getInstanceSettings( $instance ); $wpTwitterWidget = wpTwitterWidget::getInstance(); echo $wpTwitterWidget->display( wp_parse_args( $instance, $args ) ); } } /** * wpTwitterWidget is the class that handles everything outside the widget. This * includes filters that modify tweet content for things like linked usernames. * It also helps us avoid name collisions. */ class wpTwitterWidget { /** * Static property to hold our singleton instance */ static $instance = false; /** * @var array Plugin settings */ private $_settings; /** * This is our constructor, which is private to force the use of getInstance() * @return void */ private function __construct() { /** * Add filters and actions */ add_filter( 'init', array( $this, 'init_locale') ); add_action( 'widgets_init', array($this, 'register') ); add_filter( 'widget_twitter_content', array($this, 'linkTwitterUsers') ); add_filter( 'widget_twitter_content', array($this, 'linkUrls') ); add_filter( 'widget_twitter_content', array($this, 'linkHashtags') ); add_filter( 'widget_twitter_content', 'convert_chars' ); add_filter( 'plugin_action_links', array($this, 'addWidgetLink'), 10, 2 ); add_action ( 'in_plugin_update_message-'.plugin_basename ( __FILE__ ) , array ( $this , '_changelog' ), null, 2 ); add_shortcode( 'twitter-widget', array( $this, 'handleShortcodes' ) ); } /** * Function to instantiate our class and make it a singleton */ public static function getInstance() { if ( !self::$instance ) { self::$instance = new self; } return self::$instance; } public function init_locale() { $lang_dir = basename(dirname(__FILE__)) . '/languages'; load_plugin_textdomain('twitter-widget-pro', 'wp-content/plugins/' . $lang_dir, $lang_dir); } public function _changelog ($pluginData, $newPluginData) { require_once( ABSPATH . 'wp-admin/includes/plugin-install.php' ); $plugin = plugins_api( 'plugin_information', array( 'slug' => $newPluginData->slug ) ); if ( !$plugin || is_wp_error( $plugin ) || empty( $plugin->sections['changelog'] ) ) { return; } $changes = $plugin->sections['changelog']; $pos = strpos( $changes, '

' . $pluginData['Version'] ); $changes = trim( substr( $changes, 0, $pos ) ); $replace = array( '
' => '
', '
' => '
', ); echo str_replace( array_keys($replace), $replace, $changes ); } /** * Returns the user's screen name as a link inside strong tags. * * @param object $user - Twitter user * @return string - Username as link (XHTML) */ private function _getUserName($user) { return << {$user->screen_name} profileImage; } public function addWidgetLink( $links, $file ){ if ( $file == plugin_basename(FILE) ) { // Add settings link to our plugin $link = '' . __('Manage Widgets', 'twitter-widget-pro') . ''; array_unshift( $links, $link ); } return $links; } /** * Replace @username with a link to that twitter user * * @param string $text - Tweet text * @return string - Tweet text with @replies linked / public function linkTwitterUsers($text) { $text = preg_replace('/(^|\s)@(\w)/i', '$1@$2', $text); return $text; } /** * Replace #hashtag with a link to search.twitter.com for that hashtag * * @param string $text - Tweet text * @return string - Tweet text with #hashtags linked / public function linkHashtags($text) { $text = preg_replace_callback('/(^|\s)(#\w)/i', array($this, '_hashtagLink'), $text); return $text; } /** * Replace #hashtag with a link to search.twitter.com for that hashtag * * @param array $matches - Tweet text * @return string - Tweet text with #hashtags linked */ private function _hashtagLink($matches) { return "{$matches[1]}{$matches[2]}"; } /** * Turn URLs into links * * @param string $text - Tweet text * @return string - Tweet text with URLs repalced with links */ public function linkUrls($text) { /** * match protocol://address/path/file.extension?some=variable&another=asf% * $1 is a possible space, this keeps us from linking href="[link]" etc * $2 is the whole URL * $3 is protocol:// * $4 is the URL without the protocol:// * $5 is the URL parameters / $text = preg_replace("/(^|\s)(([a-zA-Z]+:\/\/)([a-z][a-z0-9_\..-][a-z]{2,6})([a-zA-Z0-9~\/-?&%]))/i", "$1$2", $text); /** * match www.something.domain/path/file.extension?some=variable&another=asf% * $1 is a possible space, this keeps us from linking href="[link]" etc * $2 is the whole URL that was matched. The protocol is missing, so we assume http:// * $3 is www. * $4 is the URL matched without the www. * $5 is the URL parameters / $text = preg_replace("/(^|\s)(www\.([a-z][a-z0-9_\..-][a-z]{2,6})([a-zA-Z0-9~\/-?&%]))/i", "$1$2", $text); return $text; } function register() { register_widget('WP_Widget_Twitter_Pro'); } public function display( $args ) { $args = wp_parse_args( $args ); // Validate our options $args['items'] = (int) $args['items']; if ( $args['items'] < 1 || 20 < $args['items'] ) { $args['items'] = 10; } if (!isset($args['showts'])) { $args['showts'] = 86400; } try { $tweets = $this->_getTweets($args); } catch (wpTwitterWidgetException $e) { $tweets = $e; } $widgetContent = $args['before_widget'] . '
'; // If "hide rss" hasn't been checked, show the linked icon if ( $args['hiderss'] != 'true' ) { if ( file_exists(dirname(FILE) . '/rss.png') ) { $icon = str_replace(ABSPATH, get_option('siteurl').'/', dirname(FILE)) . '/rss.png'; } else { $icon = get_option('siteurl').'/wp-includes/images/rss.png'; } $feedUrl = $this->_getFeedUrl($args, 'rss', false); $args['before_title'] .= " "; } $twitterLink = 'http://twitter.com/' . $args['username']; $args['before_title'] .= ""; $args['after_title'] = '' . $args['after_title']; if (empty($args['title'])) { $args['title'] = "Twitter: {$args['username']}"; } $widgetContent .= $args['before_title'] . $args['title'] . $args['after_title']; if (!is_a($tweets, 'wpTwitterWidgetException') && !empty($tweets[0]) && $args['avatar'] == 'true') { $widgetContent .= '
'; $widgetContent .= $this->_getProfileImage($tweets[0]->user); $widgetContent .= '
'; } $widgetContent .= '
'; if (is_a($tweets, 'wpTwitterWidgetException')) { $widgetContent .= '
' . $tweets->getMessage() . '
'; } else if (count($tweets) == 0) { $widgetContent .= '
' . __('No Tweets Available', 'twitter-widget-pro') . '
'; } else { $count = 0; foreach ($tweets as $tweet) { if ( $args['hidereplies'] != 'true' || empty($tweet->in_reply_to_user_id)) { // Set our "ago" string which converts the date to "# ___(s) ago" $tweet->ago = $this->_timeSince(strtotime($tweet->created_at), $args['showts']); $entryContent = apply_filters( 'widget_twitter_content', $tweet->text ); $from = sprintf(__('from %s', 'twitter-widget-pro'), str_replace('&', '&', $tweet->source)); $widgetContent .= << {$entryContent} {$tweet->ago} {$from} WIDGET_START; if (!empty($tweet->in_reply_to_screen_name)) { $rtLinkText = sprintf( __('in reply to %s', 'twitter-widget-pro'), $tweet->in_reply_to_screen_name ); $widgetContent .= << {$rtLinkText} replyTo; } $widgetContent .= << WIDGET_ENTRY_END; if (++$count >= $args['items']) { break; } } } } if ( $args['showXavisysLink'] == 'true' ) { $xavisysLink = sprintf(__('Powered by WordPress Twitter Widget Pro', 'twitter-widget-pro'), 'http://xavisys.com/wordpress-plugins/wordpress-twitter-widget/' ); $widgetContent .= << {$xavisysLink} XAVISYS_LINK; } $widgetContent .= '
' . $args['after_widget']; return $widgetContent; } /** * Gets tweets, from cache if possible * * @param array $widgetOptions - options needed to get feeds * @return array - Array of objects */ private function _getTweets($widgetOptions) { $feedHash = sha1($this->_getFeedUrl($widgetOptions)); $tweets = get_option("wptw-{$feedHash}"); $cacheAge = get_option("wptw-{$feedHash}-time"); //If we don't have cache or it's more than 5 minutes old if ( empty($tweets) || (time() - $cacheAge) > 300 ) { try { $tweets = $this->_parseFeed($widgetOptions); update_option("wptw-{$feedHash}", $tweets); update_option("wptw-{$feedHash}-time", time()); } catch (wpTwitterWidgetException $e) { throw $e; } } return $tweets; } /** * Pulls the JSON feed from Twitter and returns an array of objects * * @param array $widgetOptions - settings needed to get feed url, etc * @return array */ private function _parseFeed($widgetOptions) { $feedUrl = $this->_getFeedUrl($widgetOptions); $resp = wp_remote_request($feedUrl, array('timeout' => $widgetOptions['fetchTimeOut'])); if ( !is_wp_error($resp) && $resp['response']['code'] >= 200 && $resp['response']['code'] < 300 ) { if (function_exists('json_decode')) { $decodedResponse = json_decode( $resp['body'] ); } else { global $wp_json; if ( !is_a($wp_json, 'Services_JSON') ) { require_once( 'class-json.php' ); $wp_json = new Services_JSON(); } $decodedResponse = $wp_json->decode( $resp['body'] ); } if ( empty($decodedResponse) ) { if (empty($widgetOptions['errmsg'])) { $widgetOptions['errmsg'] = ('Invalid Twitter Response.', 'twitter-widget-pro'); } throw new wpTwitterWidgetException($widgetOptions['errmsg']); } elseif( !empty($decodedResponse->error) ) { if (empty($widgetOptions['errmsg'])) { $widgetOptions['errmsg'] = $decodedResponse->error; } throw new wpTwitterWidgetException($widgetOptions['errmsg']); } else { return $decodedResponse; } } else { // Failed to fetch url; if (empty($widgetOptions['errmsg'])) { $widgetOptions['errmsg'] = ('Could not connect to Twitter', 'twitter-widget-pro'); } throw new wpTwitterWidgetException($widgetOptions['errmsg']); } } /** * Gets the URL for the desired feed. * * @param array $widgetOptions - settings needed such as username, feet type, etc * @param string[optional] $type - 'rss' or 'json' * @param bool[optional] $count - If true, it adds the count parameter to the URL * @return string - Twitter feed URL */ private function _getFeedUrl($widgetOptions, $type = 'json', $count = true) { if (!in_array($type, array('rss', 'json'))) { $type = 'json'; } if ( $count ) { $num = ($widgetOptions['hidereplies'])? 100:$widgetOptions['items']; $count = sprintf('?count=%u', $num); } else { $count = ''; } return sprintf('http://twitter.com/statuses/user_timeline/%1$s.%2$s%3$s', $widgetOptions['username'], $type, $count); } /** * Twitter displays all tweets that are less than 24 with something like * "about 4 hours ago" and ones older than 24 hours with a time and date. * This function allows us to simulate that functionality, but lets us * choose where the dividing line is. * * @param int $startTimestamp - The timestamp used to calculate time passed * @param int $max - Max number of seconds to conver to "ago" messages. 0 for all, -1 for none * @return string / private function _timeSince($startTimestamp, $max) { // array of time period chunks $chunks = array( 'year' => 60 60 * 24 * 365, // 31,536,000 seconds 'month' => 60 * 60 * 24 * 30, // 2,592,000 seconds 'week' => 60 * 60 * 24 * 7, // 604,800 seconds 'day' => 60 * 60 * 24, // 86,400 seconds 'hour' => 60 * 60, // 3600 seconds 'minute' => 60, // 60 seconds 'second' => 1 // 1 second ); $since = time() - $startTimestamp; if ($max != '-1' && $since >= $max) { return date_i18n(__('h:i:s A F d, Y', 'twitter-widget-pro'), $startTimestamp); } foreach ( $chunks as $key => $seconds ) { // finding the biggest chunk (if the chunk fits, break) if (($count = floor($since / $seconds)) != 0) { break; } } $messages = array( 'year' => _n('about %s year ago', 'about %s years ago', $count, 'twitter-widget-pro'), 'month' => _n('about %s month ago', 'about %s months ago', $count, 'twitter-widget-pro'), 'week' => _n('about %s week ago', 'about %s weeks ago', $count, 'twitter-widget-pro'), 'day' => _n('about %s day ago', 'about %s days ago', $count, 'twitter-widget-pro'), 'hour' => _n('about %s hour ago', 'about %s hours ago', $count, 'twitter-widget-pro'), 'minute' => _n('about %s minute ago', 'about %s minutes ago', $count, 'twitter-widget-pro'), 'second' => _n('about %s second ago', 'about %s seconds ago', $count, 'twitter-widget-pro'), ); return sprintf($messages[$key], $count); } /** * Returns the Twitter user's profile image, linked to that user's profile * * @param object $user - Twitter User * @return string - Linked image (XHTML) */ private function _getProfileImage($user) { return << profileImage; } /** * Replace our shortCode with the "widget" * * @param array $attr - array of attributes from the shortCode * @param string $content - Content of the shortCode * @return string - formatted XHTML replacement for the shortCode / public function handleShortcodes($attr, $content = '') { $defaults = array( 'before_widget' => '', 'after_widget' => '', 'before_title' => '
', 'after_title' => '
', 'title' => '', 'errmsg' => '', 'fetchTimeOut' => '2', 'username' => '', 'hiderss' => false, 'hidereplies' => false, 'avatar' => false, 'showXavisysLink' => false, 'items' => 10, 'showts' => 60 60 * 24, ); if ( !empty($content) && empty($attr['title']) ) { $attr['title'] = $content; } $attr = shortcode_atts($defaults, $attr); if ( $attr['hiderss'] && $attr['hiderss'] != 'false' && $attr['hiderss'] != '0' ) { $attr['hiderss'] == true; } if ( $attr['hidereplies'] && $attr['hidereplies'] != 'false' && $attr['hidereplies'] != '0' ) { $attr['hidereplies'] == true; } if ( $attr['avatar'] && $attr['avatar'] != 'false' && $attr['avatar'] != '0' ) { $attr['avatar'] == true; } if ( $attr['showXavisysLink'] && $attr['showXavisysLink'] != 'false' && $attr['showXavisysLink'] != '0' ) { $attr['showXavisysLink'] == true; } return $this->display($attr); } } // Instantiate our class $wpTwitterWidget = wpTwitterWidget::getInstance();