WP Plugin – My Twitter

Xhanch – My Twitter is a WordPress plugin/widget made by Xhanch Studio to show your latest tweets and other stuff related to twitter. This plugin/widget provide customizations to suit your taste and it is also flexible since it can be placed on your sidebar, post or page.

Features of this widget/plugin:

• Display a number of latest tweets
• Display/hide tweet replies (there are two methods provided to achieve this, by using or without your Twitter password)
• Display/hide user’s profile picture/avatar or you may just show the name instead of picture
• Changeable avatar’s size
• Display/hide post date(changeable format and layout)
• Display date time based on timezone setting on your WordPress
• Convert all url, @username, #tag(hash tags) to click-able links
• Convert URLs to click-able links
• Show your direct messages
• Flexible way to show your tweets since you can arrange your tweet content
• Show how/where a tweet is posted
• Multi widget support
• Multiple profile system that will let you put multiple Xhanch – My Twitter widgets with separate settings for each widget. Each new profile will provide a new Xhanch – My Twitter widget
• Retweet link for every status
• Status Reply link for every status
• View Status link for every status
• Cache System; activate it via the configuration page
• Display a number of your followers, total statuses/tweets, favorites, and friends
• Display your join date to twitter and full name on Twitter
• Shortcode is available to display your tweet list within a post or page (Click here to read how to use the shortcode).
• Tweet ordering: you may display your tweets from oldest to latest or from latest to oldest
• Convert smilies/emoticon syntax to smilies/emoticon images
• Display custom texts(can be HTML code) before and after the tweets list.
• Wrap long word in tweets into multiple lines so that it won’t be displayed outside the box/area anymore
• Choose one of available header styles that suits your taste
• Generates very clean, table-less and valid W3C XHTML codes.
• You can activate scrolling mode to save space on your webpage and to display more tweets
• Personalize the layout of the widget by adding custom CSS codes
• Theme friendly
• Optimized and very efficient SQL queries and performance

Widget/Plugin Installation Procedure

1. Download and unzip the package.
2. Upload/FTP the entire “xhanch-my-twitter” directory to your /wp-content/plugins/ directory on your blog
3. Activate the plugin on the “Plugins” tab of the administration panel.
4. Open Xhanch -> My Twitter from your WP admin area to access the configuration page
5. Create a new profile or several profiles
6. Configure your profiles by selecting an available profile via Profile Configuration
7. Update your profile
8. Open the widget manager and place Xhanch – My Twitter widget(s) into certain sidebars as you wished

To enable the smilies, you need to update your “Formatting” in “Settings” -> “Writing”. Make sure “Convert emoticons like : – ) and : – P to graphics on display” is checked.

To put it within your post or page

You just need to add this simple code within your post or page content
[xhanch_my_twitter profile=<profile name>]

You can have some parameters to it. Here’s the complete syntax
[xhanch_my_twitter profile=<profile name> before_widget=”" after_widget=”" before_title=”" after_title=”"]

Replace <profile name> with an Xhanch – My Twitter profile name you wish to show

For WordPress Themes Without Dynamic Sidebar

You can use our template code

<?php
    $args = array(
        'before_widget' => '',
	'after_widget' => '',
	'before_title' => '',
	'after_title' => '',
    );
    xhanch_my_twitter($args, '<profile name>');
?>

While the configuration will be done via the configuration page at the admin area (Xhanch -> My Twitter).

Plugin Configuration

Once this plugin installed, My Twitter will be listed on your widgets so you can determine where to place it. The configuration page can be found on the left menu, Xhanch -> My Twitter

Add Profiles

Profile name must only contain alphanumeric characters (A to Z and 0 to 9).
Profile name will identify every Xhanch – My Twitter widgets.

Profile Configuration

Widget Setting

• Title: optional, the title of the widget
• Name: optional, your name
• Header style: required, choose one of available header styles that suits your taste
• Turn title to link: optional, check it to convert the widget title into click-able link
• Header text: optional, add some text (can contain HTML codes) before the tweets list. There are some available variables related to your twitter account that can be placed on this part.
• Footer text: optional, add some text (can contain HTML codes) after the tweets list. There are some available variables related to your twitter account that can be placed on this part.

Tweet Settings

• Username: required, username of your twitter account. Please don;t use your twitter’s email address
• Password: optional, password of your twitter account to enable more functionalities
• Tweet order: required, you may display your tweets from oldest to latest or from latest to oldest
• # Latest tweets: required, maximum number of tweets to show
• Inc. public replies: optional, check it to display replies to your public tweets
• Inc. replies: optional, check it to display replies to your non-public tweets (password is required to enable this feature)
• Inc. direct messages: optional, check it to display your direct message (password is required to enable this feature)
• Date format: required, hide the date or display the date in a preferable format. My Twitter provides quite a complete collections on how to display the post date.
• GMT add: optional, put in the difference (in minutes) between the displayed time and your local timezone.
• Tweet layout: required, determine how should Xhanch – My Twitter display your tweet. There are several useful variables provided, which are: @name, @name_plain, @tweet, @date, @source, @reply_url, @reply_link, @retweet_url, @retweet_link and @status_url
• Show Divider Line: optional, check it to display a divider line between the tweets in the list.
• Click-able URL: optional, check it to convert URLs in your tweets into click-able links.
• Click-able user tag: optional, check it to convert user tags (@user) into click-able links.
• Click-able hash tag: optional, check it to convert hash tags (#topic) into click-able links.
• Show avatar: optional, check it to show avatar for each tweets
• Avatar size: optional, set the avatar’s size. If you want to use the default size, just leave these settings blank/empty
• Enable cache: optional, check it to activate the cache system
• Cache expiry: optional, how many minutes will the cached tweets be considered as expired. It will refresh the cache as it gets expired

Display Mode

• Selected mode: required, determine how your tweets will be displayed.

Scrolling option (only applied when selected mode is scrolling)

• Area Height: required when scrolling mode is enabled, specify the max height or the tweets list are to display a scroll bar. So, the scroll bar will only appear when the height of the list has reached or over this value.
• Animate scrolling: optional, check it to animate the scrolling mode
• Scroll amount: required when animate scrolling is enabled, this is the height (px) to be scrolled for every ms specified in scroll delay. For example, if the scroll amount is 2, then it will scroll up for 2px for every ms specified in scroll delay.
• Scroll delay: required when animate scrolling is enabled, this is to determine the speed of scrolling. Its value is in milliseconds ms).

CSS

• Custom CSS: optional, add CSS codes to personalize/modify the look of the widget.

Other Settings

• Open link on new tab: optional, check it to make all links to be opened on new tab or window.
• Show credit: optional, give us a back link. (We will appreciate those who give us a credit as your gratitude)

Plugin Debugging

If you want to know the plugin performance and to track or find out what’s wrong when the plugin fails or not working, add ?xmt_debug (Logs are viewable when view the page source) or ?xmt_debug_show (Logs are viewable on the web page) at the end of your URL and view the page source, you’ll find complete logs started with the keyword XMT:

Layout Customization

By default, the layout will inherit your WordPress theme’s style. But if you want to make it looks different, you can modify the CSS code for this plugin (located on this plugin’s folder)

Requirements and Notice

Before you say/assume that this plugin/widget is not working or you encounter an error, check these out:

• PHP 5 is recommended. Though, this plugin may run on PHP 4.
• Your web server must support/provide PHP CURL extension and SimpleXML
• Make sure you only type in your twitter username in the username field. Not your twitter email and without the @ tag. Just the username.
• In case you encounter a messed up or strange layout, it means that your WordPress theme is not compatible. You may ask me to fix that for you

Handy Tutorials/Hacks

• Making a Table-style Layout of Xhanch – My Twitter
• Adding a Custom Header Image to Xhanch – My Twitter

Download

Click here to download the latest version of Xhanch – My Twitter

Credit

If you want to thank us, you may consider activating the “Display Credit” option or make a donation to us. Thanks!

Received Awards