How to install ‘digg this’ WordPress plugin

It baffles me why someone would go to the trouble of writing a WordPress plugin but not take the time to write some decent step-by-step documentation for how to install it and make it work. A prime example is a very handy WordPress plugin for adding a digg button to your post. The plugin is written by Aviran Mordo and can be found here. Take a brief look of the comments and you will see that there are more than a few people having trouble implementing this plugin. I was in the same boat and it took me hours to figure out how this plugin was suppose to be implemented. Since no documentation exist, I am writing this to help these who are having problems installing it. Please note that I can only impart on you my experience and I am in no position to answer any technical questions. Those questions should still be directed to the original author of the plugin. Before I begin, I would like to say thanks to Aviran Mordo for writing this plugin. Let’s hope he implements better directions for those who are not php programmers.

  1. Download the plugin.
  2. Upload the plugin to your WordPress plugin folder which is located under wp-content/plugins off your blog’s home folder. I like to put the plugin in a folder called ‘digg’ to keep my plugins organized but you can just put it in the plugin folder.
  3. Go to the WordPress admin page and activate the plugin under the Plugins tab.
  4. At this point, I suggest you submit a post to digg for testing. Having the article already dugg makes it easier to confirm if your installation is working.
  5. I won’t go into how to digg works since you should already know this if you are reading this.
  6. Find the appropriate single.php file in your blog folder. If you are using themes, you will have multiple single.php files. Each will be located under the theme’s folder which is located under /wp-content/themes. If you have not installed any themes, the file will be located under /wp-content/themes/default. Make sure you edit the correct single.php file. The author refers to this action as putting the code in the Loop. Some themes will make a call from the single.php file to another file (ie: theloop.php). If this is the case, you will see something like include (TEMPLATEPATH . ‘/theloop.php’); in the single.php file. If you are using such a theme, you will have to edit theloop.php file instead. The exact location of where to put the code will vary from theme to theme so you’ll have to experiment but it has to be put inside the loop which is often indicated by comments in the file. There will often be clues to where you can put it. Usually below lines that read ‘title’ and above lines that read ‘footer’. Remember to re-input the changes if you change themes.