Creating the Kazology Blogroll – Part 1

The Kazology Blog uses Word Press, no surprise there. What makes it fun is the amount of customization even a “non-programmer” like me can do to make it a personal thing.
You can get thousands of themes, and thousands of various plugins to modify the basic installation of WP. Even better are “Widgets” which are an even simpler version of a plugin. You only have to know how to:

  • Copy a file from the web to a directory on your server or home computer
  • Unzip the file
  • Move it to the proper directory in the Word Press install on the host server.
  • Access the WP Admin Control Panel to activate the plugin / Widget
  • Access the WP Admin Control Panel configure settings, if any

How simple is that!

I enjoy trying out new plugins, although sometime with nasty results. To be fair, normally all you have to do is delete the offending plugin from the Host Server and you are back in business. Even then I did manage to lock myself completely once. Guess what? Another plugin to the rescue. (Maybe not technically a plug in, but PHP file, but you use it just like a plugin.)

So where the heck is all this going – to my latest project – The BlogRoll page. It seems everyone posts a list of links to other blogs/websites they like, but it seems the normal default is just that, a list of links. Boring, unordered list like “Georges Web Site”, “A Cool Web Site”, “A boring Web Site”, “Aardvarks Are Us” to “Zebra’s need a home too”.

I didn’t like that list.

I didn’t like that list. So a search began. While there are a number of plugins out there that do this the one I found was “Zo’C’s Powerblogroll“. I downloaded and installed. Oops… had some trouble here. It is not a widget, so requires some knowledge of coding to put the BlogRoll where you want it. That wasn’t getting me to far. I had used another widget “Widgetize Anything” to convert a Plugin to a Widget so gave it a try. With a lot of playing around with the single line of PHP code I finally got it working! At that point I had a nice BlogRoll in the sidebar. Looked pretty good with a nice Favicon and the name showing. Not quite satisfied I thought I would add a short description to let the reader know what “Aardvarks Are Us” is all about. (in ten words or less…) That worked great also. But did make the sidebar column sort of long, okay, but sort of long. Then I starting adding a few more links to things I use in Word Press or the web page itself (some day I am going to figure out how to switch the current home page to a page in Word Press . . some day.) At this point it just wasn’t going to be practical any longer to keep the BlogRoll in the sidebar.

Creating the Kazology Blogroll – Part 2

Once I made the decision to create the BlogRoll page I needed a new “Links” page template that I could use. Some page templates come with a links page, but not the one I am using. No big deal, just use the WP Theme editor to open a few different themes until I found one that had a separate links page… how ’bout that, the default WP theme has one! A quick copy and paste into the current theme’s directory and I was good to go. Oops, you need to do a little CSS work to make a stock page work the way you want. It’s no secret I can hardly spell CSS let alone edit it. (My web page design skills are still stuck in html version .5) The creator of the plugin did give some lines of code that should be added to make the whole thing work right, so I started doing my version of “plugging and playing” – put some code in, try it on the web page, see what happens and then try again. The goal is twofold

  1. Do NOT blow up the page so bad you have to resort to extreme measure’s to get it back, and
  2. Make it work.

After awhile I did finally succeed in getting enough code in the correct places to actually make the thing work! I was successful in getting the correct code in the link page to display the links, and the style sheet updated to format the information the way I wanted . . . almost. Everything looked (to me anyway) really good, nice favicons or other graphic showing, the really annoying bullets created by the original “ul” format were gone. Life is grand! But . . . always a “but” it seems like.

I really like the “Aardvarks Are Us” page, I really prefer “Tigers R Terrific”

While I really like the “Aardvarks Are Us” page, I really prefer “Tigers R Terrific” and it was way down on the list since links are ordered alphabetically. Not only that, the foundation of Kazology lies in the Genealogy pages that caused me to begin a web page… golly, at least fifteen years ago?!? (Anyone remember Compuserve??) (Dial up connections at 14,400 baud??) (Setting the modem stop bits, parity, etc… but I digress.) So while Word Press allows the user to assign a category to each of the links there is no control over the order they are displayed in! So again, my list did not have MY favorite Category at the top, or the links within them in the order I wanted. What to do now? Searched a little more until I found “My Link Order” and “My Page Order” and “My Category Order” on the Geeky Weekly web site. Cool, now we’re cooking with solar power. Installed the plugins, activated them, and neato the pages can be rearranged in the tool bar just the way I want them! I used the Admin Control Panel and rearranged the categories and links just perfectly… so lets see what that looks like…. oops… nothing… nada…. zilch… zero… you get the idea. Seems that Powerblogroll and My Links just aren’t gonna play together nice. I resign myself to that and life goes on, although in the back of my mind I am constantly being nagged that while life is going on, it is not going on in an “orderly” manner! Well, lo and behold, I had created a post about this process and the plugins I was attempting to use and the author of “My Link Order” noticed the link back to his web page. He apparently read the entry where I lamented over the two kids not playing nice and he commented back with just three lines of code that he said would fix this! Hot dog, we’re back in business. . . almost. More after the break!

Creating the Kazology Blogroll – Part 3

After getting the suggested changes to the PHP code courtesy of Andrew at Geeky Weekly. . . I spent a few more hours playing around editing the Powerblogroll PHP code – down in the area below the big “DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING” remark….. (insert screen capture of the really nasty errors here – I didn’t even know my blog spoke Japanese!)

“DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING”

Code Hacker Tip #3,298 – when editing code that you have no idea what will happen… always, and I repeat, always, keep a copy of the original code in a different directory to move back real quick when you hose everything up! (I saw an article on how to create a local copy of Word Press for experimenting on… which would be really cool, but again… I need the Ultimate Dummy directions for something like that, so all my changes go out live to see what happens being prepared to make a quick reversal if it is really bad. – get back on focus here George)
I wonder different times as I play with plugins, and reading the FAQ on the authors web site, or the “readme.txt” file with the plugin in, do they have any idea how confusing this is for many people?

Hey after all I took Fortran back in college!

While I joke about being completely illiterate, I do have some degree of familiarity with code and at least vaguely understand the principles, (Hey after all I took Fortran back in college!) but still this is difficult. So when an author documents, or replies to an already confused person trying to implement their plugin by just writing “just add < !-YouAreDense$&%20##.PHP> and it will work”, what I think they do not understand is

a) If I am having to write you for help I am obviously already confused
b) that I have no idea WHERE to add this
c) The code is maybe garbled since it was converted to HTML and back again inserting bogus characters into the “very simple statement to be added”.

I think this is no great revelation here, anyone that has never written a plugin or widget probably understands what I am talking about. So authors, please, comment your code carefully, then in your instructions show related code so we know where to put that little line… Even in one plugin you are to “change the option from false to true” to do something else… how about adding “This is easily done by removing the “remarks code” “//” from the line you want to activate and adding it to the line you wish to de-activate.” Maybe, you argue, if the user does not even have that degree of knowledge they should not be doing this… I disagree. I am willing to try, but need more hand holding to get me started. Maybe some day I will learn this and would not need to refer to a step-by-step direction, but until then help us out!

Getting to the conclusion – eventually: Taking the offered lines of code, figuring out where to replace them (another aside… drat I am never going to get to the end… the author really did do a good job of explaining, even adding the line number to be replaced. That helps, IF I am using a “real PHP code editor” that lists line numbers, but if I am using Note Pad to edit… I got no line numbers! See how this is all confusing to newbies? Anyway… I compared the suggested code to the original, figured out where it went, converted the mangled characters to the proper syntax and saved the modified version. I uploaded it, and boom, trashed web page. Oops, put back the original, check changes, save again and upload again. Success!! A great looking web page, ordered the way I want it, not how it want to. Went into the Admin Panel again, changed some links around and checked the results…ooops, nothing again. What the #$@%^! is going on. In the Admin Panel for MyLinkOrder when I selected a category to order I was getting extra entries showing. I carefully checked the listing of entries, opened each one up, verified each one had the correct category assigned and tried again… No luck. I kept playing around for a while, I finally found that I had to open each blogroll entry up, select the proper category again, even if it looked correct, save it, then tried again. Success! Only the proper links assigned to a category appeared in the “order links here” field. I set the order the way I wanted them to appear, updated, and went out to view the BlogRoll Page for the 257th time. TA-DA!! I am one happy camper now! It is a work of art, a sight to behold (or is that site to behold), cooking with gas, better ‘en sliced bread. I pwned it (honestly I have never figured that one out.) W00T W00T.

TA-DA!! I am one happy camper now! It is a work of art, a sight to behold!

Check it out!

Now… since this is so long, I think I am going to try out the “continued on page” plug in…. cross your fingers!

Until the final link opens,

Mini Post A new widget

Playing around with different widgets. ????? ???? This is called “Mini-Post”. Hopefully you can tell why.

Update: You can’t tell – because it isn’t working. There seems to be a conflict with the plugin and another one somewhere. This is supposed to appear as a small text item in the right column, it does, but seems to destroy all the formatting on the regular posts so I have turned it off.

Setting up Zo’C PowerBlogRoll

UPDATE 11/16/2015: I think this is all gone now… cannot locate the web site any longer, and do not see the plugin on the WP site anymore.) I am using this pretty cool plug in to create a BlogRoll page. Called “powerblogroll and written by Zo’C. I had used it as a widget using the “widgetize anything” plugin, but decided to move it to a “links” page after it outgrew the sidebar. (Link to web site removed 11/16/2015 no longer worked and I could not locate web site any longer.)

I have seen quite a few questions on the authors web page about setting it up, and while there is some help, it seems there are still quite a few questions. I am certainly no programmer, but with several hours (!) was able to make a page work. Here is my quick guide in case anyone googles for help and happens to find this.

1. You need a “links.php” template. The template I am currently using did not have one included. So I used the Theme Editor in WordPress to look at the other templates I had downloaded to try out before. I found one with a “Links” page. (The “WordPress Default” theme has a “Links” page.)

2. I used FTP to make a copy of that “Links” page into the current theme I wanted to use.

3. I opened the new “links.php” page with the WP Theme Editor. I do not think I removed any code from the original template, only added four lines. The total contents of this page is now:

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

<?php
/*
Template Name: Links (Whatever you put here is what appears in your theme template list.)
*/
?>

<?php get_header(); ?>
<div id=”zoc_powerblogroll”>
<h2>Recommended Links:</h2>
<ul class=”zoc_powerblogroll”>
<?php wp_zoc_powerblogroll(); ?>
</ul>
</div>

<?php get_footer(); ?>
– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

In mine I only added the four lines lines in bold above which are:

<div id=”zoc_powerblogroll”>

<ul class=”zoc_powerblogroll”>
<?php wp_zoc_powerblogroll(); ?>

</ul>

in the code above.

Check the “Template Name: Links” line also. You can name this anything you want. This is the name that will show up in the WP Page Editor when you select the template to use.

Then I had to add the CSS to the StyleSheet page, again using the WP Theme Editor.

I just found a spot in the existing code and stuck this in:

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

/* This section begins the formatting for the BlogRoll Links Page */
.zoc_powerblogroll { list-style: none; }
.zoc_powerblogroll ul{ list-style: none; }
– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

Actually this is not necessary if you do not mind the default “List” bullets (created by the “ul” code) in front of each entry. (assuming the template you are using has them.) In powerblogroll I use the setting to show the favicons and found also showing the extra “ul” bullet was distracting. This actually is what took me the longest to figure out.

That was it. I just used WP Editor, created a new Page, used the “Links” template, left the contents of the blank and it puts in the BlogRoll automatically. If you want to add text into the blogrollpage you probably have to add more CSS for something like “contents”… but that is all dependent on how the theme author wrote the CSS.

Now I am pretty sure that someone that really knows what is going on will say “you don’t need this in the code”, or “you don’t need that in the code”, or there are 32 better ways to do this. But I wasn’t getting much help from the web site, and so just experimented until I got it to work. If there is a better way I am happy to revise this, but until then you can try it this way.

Good Luck!

If any “real” plug in editors read this. What I would *really* like is to combine this plugin with another that would also order the links the way I want them. I do not like seeing “Ardvarks R Us” first in the blogroll just because it starts with “A”. There is another plugin that does this called “mylinkorder” which has manual sorting options. This can be found at . Unfortunately the two do not work together right now.

If you didn’t already know PowerBlogRoll can (Could) be found here: “z-oc.com/blog/powerblogroll” UPDATE: 12/14/2015 this is no longer working so I removed the link. You can try searching for this ULR though.

Since getting this working I have found another issue, which I think is unrelated to the changes above. I use another plugin to format the blog for mobile users. It is now showing the first page, as opposed to post, and it also reveals text in the BlogRollPage which is not visible when viewed with a normal browser.

Until the final WP PlugIn loses power,

Signature Test Post

Will this really add my new signature, or did I screw up the code?

Well, whadda ya know? It looks like it works the first time in the preview window!
How personal is this little touch.