=== dzone Widget ===
Contributors: Robert Buffone
Tags: widget, dzone
Requires at least: 2.0
Tested up to: 2.3
Stable tag: trunk

== Description ==

This plugin will allow users to add a DZone vote widget to specific 
posts in their Blog.  Easy to setup and configure, and new to this version
is the ability to use the widget without changing your template.
Information on the DZone widget can be found
http://www.dzone.com/buttons.jsp.

Based on the Comment-Closed Plugin by 

http://www.jamesmckay.net/code/comment-timeout/


== Installation ==

* Copy the directory `dzone` and all the files in it into your
`/wp-content/plugins` directory.
* Activate the plugin through the "Plugins" menu in the WordPress dashboard.
* Configure the plugin by going to the "DZone" page on the "Options" menu.

Need to add the following code to your post.php template file.

<?php if (display_dzone_widget($post)){ ?>
	<!-- Add required formatting around this line -->
	<!-- Change the value "1" for vertical widget to "2" for horizontal -->

	<?php echo_dzone_widget($post, 1); ?>		

	<!-- Add required formatting around this line -->
<?php } ?>


== Global Configuration ==

You can change various settings globally on the "DZone" page under the
"Options" tab on the WordPress dashboard. 

When to display DZone Widget? All posts, No posts, or specified posts.  If specified need 
to use the "Display DZone Widget" option on the post page.
How to dislay the dzone widget? Vertical or Horizontal?
Where do you want the widget displayed? Top, Bottom, or using the manual display function.

== Post Configuration ==

Each post has "DZone" Section that allows you to configure if you want to show the dzone
widget.  

"Display DZone Widget"  - Display the dzone widget for this entry, "Check" to display

"Override URL prefix for this post" - This setting will provide a custom prefix to the 
posts URL that will be used to load the DZone widget.  If not set the url will be based 
on the current URL.  

I noticed over the course of time that I either didn't use the same name or
the same url for the dzone entries.  For many of my posts I left off the 
"www".  This setting allows me to override the prefix for the post.

== Redistribution ==

Copyright (c) 2007 Bob Buffone
http://www.rockstarapps.com/

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

== Reporting bugs ==

When reporting bugs, please provide me with the following information:

1. Which version of DZone you are using;
2. Which version of WordPress you are using;
3. The URL of your blog;
4. Which platform (Windows/IIS/PHP or Linux/Apache/MySQL/PHP) your server
   is running, and which versions of Apache and PHP you are using, if you
   know them;
5. The steps that need to be taken to reproduce the bug.

== For more information ==

For more information, please visit the plugin's home page:

http://www.rockstarapps.com/pmwiki/pmwiki.php?n=Wordpress.Dzone
http://www.rockstarapps.com/