I moved my previous post about YM-Online-Status here so it’ll be easier to find and update as the plugin evolve.
YM-Online-Status is a WordPress plugin designed for you–Yahoo! Messenger users–who likes to tell your blog visitors whether you are online or not using your own custom images as ‘buttons’. Normally you can only use the following standard buttons provided by Yahoo!
With this plugin, you can make the button yourself, ensuring your online status button looks nice on your blog’s theme and layout. My Yahoo Messenger online status button on the sidebar of this blog is a simple example for this plugin. Of course, this is only an example. You can create better buttons on your own.
Interested? Just download the latest version of this plugin and put it on your blog
Latest stable version (recommended):
Installation and Usage:
- Decompress this plugin’s archive file. It contains a folder named ‘ym-online-status’
- Upload the folder into your plugins directory which is located by default in
/wp-content/plugins/After uploading this folder, you should have a structure like this:
/wp-content/plugins/ym-online-status/[some files + folder]
- Go to your admin section and select Plugins menu. Activate this plugin from the panel.
- Now go to Options, select the YM Status submenu (you’ll find this new submenu after activating this plugin). Fill in the ‘Yahoo Messenger ID’ field with your yahoo id. If you’d like to enter some different ids, separate each id with a space (see further notes about showing single or multiple button). The ‘Text’ field on the options represents the value of ‘alt’ and ‘title’ attributes of your button. It will show up as a tooltip when you hover your mouse pointer on your button and where browsers doesn’t load your button image.
- Select your preferred YM status button to display.
- Click the Update Options button.
- Now go to Presentation -> Widgets . Select YM-Online-Status widget and drag it into your sidebar. The widget control allows you to specify a title to your widget, e.g. ‘My YM Status’.
- Congratulations! Now you have a unique YM online status button.
Using your own image
I have included some sample online status buttons that you can use on your blog. However if you’d like to use your own creation, please follow these steps:
- Prepare a pair of images. One is for showing the visitors that you are online, and the other one is for showing that you are offline. These paired image’s format and extension have to be identical. You can’t pair an online .jpg image with an offline .gif image. I also suggest that you use a pair of image with the same pixel dimension, although this isn’t a must.
- Name each of the images as
offline-[image_name].[extension]As an example, you might want to name them as online-myimage.gif and offline-myimage.gif.
- Upload these images into images/ dir inside your installation dir:
- Get into the admin panel, select the Options menu and then the YM Status submenu. Now your custom images are shown in the buttons list. Select them and hit the Update Options button.
If you would like to share your custom images to WordPress communities, I would be glad to include them in this plugin, accompanied with the author’s credits and blog urls of course. Please send me your custom images via email: hudatoriq**at**gmail**dot**com. The images must be in PNG format, with 32 bits per pixel color depth (with 8 bit per pixel transparency).
YM-Online-Status prints the status into the page in two modes:
In this mode, YM-Online-Status print only a single Yahoo! ID status, regardless the number of IDs you specified in the configuration page. If you specify more than one IDs (separated with space), it will only show the first one. This mode is suitable for personal blog.
When in the ‘list’ mode, YM-Online-Status print a list of buttons of all IDs specified in the configuration page.
You can switch which mode to use by:
- Selecting it in the widget control dialog
- Supplying the appropriate parameter into $ymstatus->show();
By default, it runs in ‘single’ mode.
Manually Inserting the PHP Code
For those who do not use WordPress widget support, one should manually insert this code into the theme files (preferably sidebar.php).
<?php $ymstatus->show([mode]); ?>
Please substitute the mode parameter with either ‘single’ or ‘list’ string, each corresponding with the printing modes respectively.
Available translation file:
|Bahasa Indonesia||0.1||Huda Toriq||id_ID||id_ID|
To localize your ym-online-status installation, simply upload the desired .mo into your /wp-content/plugins/ym-online-status.
If you want to translate this plugin, use the ym-online-status.pot included in the distribution file. Please drop me a line and send me your translations. I’ll commit them to the repository & link them here so other WP users can easily find & use them.
Frequently Asked Questions
Can somebody else use my image URL to show their YM online status on other site/weblog?
Yes, they can, provided that you allow them by specifying their yahoo username in the Options panel. Otherwise, they won’t be able to do this. You actually are able to lend your friends some help by hosting their custom image status while they don’t have the ability to use it due to their bloghost service limitation. Just tell them to use this url as their image source:
[your blog url]/wp-content/plugins/ym-online-status/image.php?id=[id number]
Why does the button look bad on my blog? There is a rectangular gray background surrounding the button.
That’s probably due to incompatibility with your browser. The images included in this plugin is in PNG format. Besides storing color information, it also stores 256 level of transparency information for each pixel. It makes PNG image’s transparency look perfect on any background color. But unfortunately not all browser support this. If you use Internet Explorer prior to version 7.0, then you’ll have a good chance to face this problem. If you want your button to look fine in browsers that doesn’t support PNG’s transparency, try editing the image with some graphic editor. Remove the image transparency. Use your blog’s background color as your image’s background, then upload it back to your server.
How do I upload my custom images into the designated directory? I can’t find any upload panel to do this from the YM Status Options Menu
Unfortunately I do not provided a form to upload images from the Admin panel. You have to upload it via FTP or your web host file manager.
This YM Online Status plugin for WordPress is released under GPL (GNU Public License).
Yahoo!, Yahoo! Messenger, Yahoo! logo, and some smiley image taken from Yahoo! website or Yahoo Messenger software are registered trademark and properties of Yahoo! Inc. This plugin is not officially released nor supported by Yahoo! Inc. Yahoo! is not responsible for the usage of this plugin on your blog.
Version 0.3 – Oct 19 2007
- Detects PHP’s allow_url_fopen and cURL extension, and intelligently choose the best method to retrieve status from Yahoo! server (thanks to Agung)
- Now supports WordPress Widget
- More solid & object oriented code
- The get_ym_status() is deprecated, introducing $ymstatus->show() instead
- Enhanced configuration page, users can make their custom tag wrapper without messing around with the PHP script
Version 0.2 – Jul 14 2007
- Bug repair – collision with other admin buttons named ‘submit’ that creates undesired update triggers
- Compatibility fixes with WordPress 2.0 regarding array serialization
- Auto redirection to configuration page after activation
- Automatically assign smile.png as the default status button after plugin activation
- Notification messages in configuration page
- Using WP’s built in ‘init’ hook to intercept user (admin) input (I should’ve done it earlier )
- Other minor changes (localizations, code cleaning, etc)
Version 0.1 – May 3 2007
- Now PHP 4 compatible (tested with PHP 4.3.11)
Version 0.1 Beta – May 2 2007
- Initial release, still having problems with PHP 4.x.x