=== Wordpress Comment Warrior === Contributors: flarefox Donate link: Tags: comments, warrior,period,stats Requires at least: 2.7 Tested up to: 2.8 Stable tag: 0.3.15 Show relevant comment warriors in different period. Also an honor cup can be inserted for comment warriors in their comments. == Description == Dunno what is a comment warrior? Please refer to FAQ Section. = This plugin has two purposes = Firstly, stat comment warriors periodically, and show relevant warriors for different period. For example, when open an article posted in Jul. 2009, widget will list warriors in Jul. 2009. Secondly, if a comment's author is a warrior, an cup image can be shown in the warrior's comment. = Options = Period can be `calendar month`, `calendar year` or `custom days`. Display style of warrior list can be `only text`, `only image` or `image and text`. You can also choose whether to show `comment counts`, whether to show `cup image`, `image size of warrior`, `image of cup`, `image size of cup` and so on. = And more = Find more information in `FAQ` section. If you have any question or suggestion, please post here or send mail to flarefox@163.com. I will appreciate it very much and response as soon as possible. == Installation == 1. Upload `wp-comment-warrior` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Add widget in admin panel. You can use functions too, please refer to FAQ section. == Screenshots == 1. Widget(image and text) preview 2. Cup preview 3. Widget Settings 4. Filter Settings 5. Cup Settings == Frequently Asked Questions == = What is comment warrior? = In 2005 and 2006 I played world of warcraft for several months. That's why I name *the most active commentators* as WARRIORS. = How to use the plugin? = After install and activate it, you can add `Comment Warrior` Widget in admin panel, or you can add below codes anywhere: `` A `ul-li` list will be generated. = I cannot see any photo in widget! = Please check comment warrior settings first. Do you choose `Warrior Show Style` to be `Image and Text` or `Image`? Then check General->Discussion settings. You should focus on: 1. `Avatar Display` must be turned on, that is to say, `Show Avatars`. 2. If `Default Avatar` is `Blank`, persons who haven't custom their photoes in avatar site will be displayed as a blank image. = Can I add stats period in widget? = Sure. You can use such codes: `` Example( Period Type : get_warrior_period() ) `Calendar month` : Jul. 2009 `Calendar month` : 2009 `Custom 30 days` : recent 30 days `Custom 0 days` : all days = The widget's style is urgely, or it doesn't display at all! = This problem is probably caused by css style. You can modify comment-warrior.css in plugin folder. After V0.3.15, there is not comment-warrior.css in plugin folder any more. You can modify `Css Style` settings in option page. = Option page doesn't work, why? = This plugin's option page need jQuery. I have tested it in wordpress 2.7 and 2.8. I dunno if other versions support jQuery too. = How to show cup image? = Well, it's a little complicated. You must manually insert below codes into a right place in comments.php or elsewhere. For example, you can append them to *comment time* or *comment author picture*. `comment_author_email); ?>` An img tag will be generated. = How to find the right place to add cup codes? = Here is a sample walkthrough. 1. Open comments.php in your theme folder, then search `wp_list_comments`. 2. If find, check args of wp_list_comments function. 3. If the args contain some string like `callback=custom_list_comments`, the right place is just in function `custom_list_comments`. 4. If the args don't contain `callback`, the right place lies in function start_el in wp-includes/comment-template.php. 5. If not find `wp_list_comments`, the right place is somewhere in comment.php in the theme folder. *I admit it may be not simple. If anyone have a better idea such as auto insert the cup image, please mail to `flarefox at 163 dot com`. I would appreciate it very much!* == Changelog == = 0.3.15 = * You have the ability to ban warriors through email or url filters. * CSS style is saved in options table, so plugin's update will not reset your customed style. (Remember to backup your custom style before update to this version) * When display style is `Image and Text`, the image size can be changed now. * Warriors won't be displayed as links any more if their site urls are empty. * Fix the bug that warrior's photo is very big in some conditions. * Add help info in option page. Just click (?). = 0.2.01 = * Fix the bug that warriors don't update. * Add alt for image in widget. * Add a setting. Those who comment less than `minimum comment counts` times will not be warriors. * Widget can display stats period now. * `Custom 0 days` equals to `all days` now. = 0.1.66 = * Rewrite option page with jQuery, thus all elements are ajaxed. * Add some option items. * = 0.0.89 = * Works on wordpress 2.8 and 2.7.