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.
- Download the plugin.
- 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.
- Go to the WordPress admin page and activate the plugin under the Plugins tab.
- 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.
- I won’t go into how to digg works since you should already know this if you are reading this.
- 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.
- If you want to include the digg this button in WordPress pages files (like this one) in addition to post files, you will need to add the same line of code to the page.php file located in the same folder.
- To edit the single.php or page.php file, use the editor under Design-Theme Editor. Be sure to make a backup first.
- Your first part of your single.php file should look like this:
- The bold text is the additions. Red text are my comments and should not appear in the file. In short, if you want the digg button to appear at the end of the article, enter the code after this section Read more »
- The code you enter will vary depending on what you want to appear. Refer back to the author’s site for examples. I used < ?php digg_this_button(); ?> to create the digg button.
- Time for testing. You cannot test this just by refreshing your blog. You must first go to the article in digg.com and click on the link to your article. Doing this will update your link and the button should now appear in your blog as dugg. If it does not appear, wait a few hours. For some reason, the digg button may not appear right away.
If you did everything right, you should see a digg button at the end of your post like the one you see here. If this article was helpful, feel free to digg it!
0 comments:
Post a Comment