====================================== Plugin Name: KeywordLuv Plugin URI: http://www.scratch99.com/resources/wordpress-plugin-keywordluv/ Description: Reward your commentators by separating their name from their keywords, in the link to their website, giving them improved anchor text. For example, leaving "Stephen @ Custom WordPress Plugins" in the name field, will result in the following: Stephen from Custom WordPress Plugins. Requires a DoFollow plugin to be effective. Version: 1.03 Date: 7th April 2008 Author: Stephen Cronin Author URI: http://www.scratch99.com/ ====================================== **** RELEASE NOTES **** These notes belong to this release of the KeywordLuv plugin for WordPress. For up to date information see http://www.scratch99.com/resources/wordpress-plugin-keywordluv/ INTRODUCTION Reward your commentators by separating their name from their keywords in the link to their website, giving them improved anchor text. If they enter "Stephen@Custom WordPress Plugins" in the Name field, their comment will have: "Stephen from Custom WordPress Plugins Says:" rather than: "Stephen@Custom WordPress Plugins Says:" If they don't enter the @ symbol, the anchor text will simply display as normal. For a live example, see the first comment below. WHY IS ANCHOR TEXT IMPORTANT? There are many articles about the value of having your keywords in the anchor text of backlinks to your site. This helps your site rank well for those keywords with the search engines, bringing you more traffic. One source of backlinks are comments on DoFollow blogs, but the anchor text is normally your name. While this helps you rank well for your name, it's practically worthless for your keywords. That's why some commentators put keywords in the name field, but they risk being marked as spammers. I understand people's desire to get the best value from their link, but I'm tired of answering comments with "Hi Miami Hotels". I'd like them to leave their name, without it effecting their keyword benefit. Enter KeywordLuv... By using KeywordLuv (and a Dofollow plugin) you give your commentators better links, rewarding them and encouraging more people to comment. DOFOLLOW For your commentators to benefit from KeywordLuv, your blog REQUIRES A SEPARATE DOFOLLOW PLUGIN to remove the nofollow tag. KeywordLuv does not do this and without it, YOUR COMMENTATORS WILL NOT RECEIVE ANY BENEFIT. While KeywordLuv could remove the nofollow tag, there are many existing plugins that do this AND provide advanced features I don't want to replicate. COMPATIBILITY - DOFOLLOW PLUGINS KeywordLuv hasn't been tested with most DoFollow plugins but problems are very unlikely. If you do encounter any, please let me know. COMPATIBILITY - WORDPRESS THEMES There is a compatibility issue with some themes. If your theme uses comment_author_link() to retrieve the comment author link, KeywordLuv will work fine. If it uses comment_author() and comment_author_url() to build the comment author link, then it will do nothing. This issue, along with the possible workarounds, is outlined on the KeywordLuv - Theme Compatibility Issue page (http://www.scratch99.com/wordpress-plugin-keywordluv/keywordluv-theme-compatibility-issue/). Note: If you use Brian’s Threaded Comments or YATCP for threaded comments, KeywordLuv will work as these both use comment_author_link(). REQUIREMENTS WordPress 2.2+ (tested on WordPress 2.5, 2.3 and 2.2). INSTALLATION - Download the keywordluv-1.0.zip file and unzip it. - Upload the keywordluv folder to the wp-content/plugins folder. - Activate the KeywordLuv plugin within WordPress. UPGRADE - Download the keywordluv-1.0.zip file and unzip it. - Upload the keywordluv folder to the wp-content/plugins folder, overwriting the existing files. USAGE When your readers leave a comment, they should leave their name and keywords in the Name field, using the following format: name@keywords. When posts are displayed, the plugin searches for the @ character, strips it out and moves the name to front (outside the link). TELLING YOUR COMMENTATORS This plugin is really to help your commentators, so you need to tell them how to use it. By default, the plugin adds a message to the comment form telling users to enter YourName@YourKeywords in the comment field. You can customise this message in the KeywordLuv options page in the Admin area. Note: This message does not appear if you are logged in, as logged in users normally don’t have a Name field to enter YourName@YourKeywords into. The problem with this message is that there is no way to control exactly where it will appear. It depends on your theme. In some themes, it may not appear at all. If you are comfortable editing your theme, the best solution is for you to disable the message (in the KeywordLuv options page in the Admin area) and add your own message exactly where you want it (in comments.php). IF YOU DISABLE THE PLUGIN Whatever the commentator enters in the Name field is what's actually stored in the database. KeywordLuv simply changes the way it's displayed. If you decide you no longer want to use the plugin, simply deactivate it and commentator's names will revert to what's in the database. For example, if they enter "Stephen@Custom WordPress Plugins", that's what's stored. If the plugin is active, it will display: "Stephen from Custom WordPress Plugins Says:" If the plugin is disabled, it will display: "Stephen@Custom WordPress Plugins Says:" SUPPORT This plugin is officially not supported (due to my time constraints), but if you leave a comment on the plugin's home page or contact me, I should be able to help. DISCLAIMER: This plugin is released under the GPL licence (http://www.gnu.org/copyleft/gpl.html). I do not accept any responsibility for any damages or losses, direct or indirect, that may arise from using the plugin or these instructions. This software is provided as is, with absolutely no warranty. Please refer to the full version of the GPL license for more information.