The Purpose

This post is intended to be an introduction to the basic structure of a WordPress plugin. The plugin is, arguably, not extremely useful. But it does do something. So that has to count for something, right?

The purpose of a user group is to bring product users together to learn from each other. I’m not an expert in WordPress plugin development. So I would love to learn from you. If I missed something, or could say something better, feel free to leave a comment below!

The Problem

On our family blog, I posted a picture of our children, with their names.

The only problem was that my wife and I would rather not post their names online. Our preference is that we will refer to them as “Thing 1″, “Thing 2″ and “Thing 3″.

The Solution
Now, I could try and remember to change their names every time I write a post. I suppose that wouldn’t be too difficult. However, as a true geek, I decided to find a way to automate it. I created a WordPress plugin that will change their names in each post.

WordPress plugins are an easy way to enhance, suppress or filter some of the basic WordPress functionality. It makes it fairly simple to customize the functionality, without editing the application itself.

Plugins are stored in the wp-content/plugins folder in your WordPress installation.

The Start

The first thing we do is create the plugin file. For this project, I created the PHP file:

wp-content/plugins/thing1.php


/*
Plugin Name: Thing 1
*/

That is the minimum amount of information needed to create a plugin. With that file created, I should be able to go the “Plugin” section of my WordPress dashboard, and see the plugin listed.

Sweet!

Now, let’s make something happen

Now that the plugin file has been created, we will add a simple PHP function to replace the girls’ names with the generic replacements:


function thing_1($text) {
$text = str_replace('Helga', 'Thing 1', $text);
$text = str_replace('Olga', 'Thing 2', $text);
$text = str_replace('Inga', 'Thing 3', $text);
return $text;
}

What we’ve done here is created a function called “thing_1″ that will process the content it is sent ($text) and replace the names with the replacement words.

The next step is to attach this function to WordPress. We are going to do this with a hook the WordPress API has provided for plugin creation.

Hooks

There are two types of hooks in WordPress. Action hooks and Filter hooks.

Action hooks are used to add a function when WordPress “does something” (like sending an email or writing to the database)

Filter hooks are used to modify data before it is written to the database, or published to the browser.

There are a lot of hooks. I’m not going to get into them here, but here are some great links to learn more about the various hooks in WordPress:

• http://codex.wordpress.org/Plugin_API (a general guide to understanding how hooks work with the API)
• http://codex.wordpress.org/Plugin_API/Filter_Reference (a list of Filter hooks in WordPress)

For this project, we are going to use a “Filter Hook” to modify the post content before it is published to the browser. This will keep the names intact in the database, but will change them before it is displayed on the browser screen:

add_filter('the_content', 'thing_1');

This uses the WordPress function “add_filter” to add my function “thing_1″ to the filter hook “the_content”. Essentially, it will take the contents of “the_content” and pass it through the function “thing_1″.

There are other arguments that can be passed to the “add_filter” function. For more information, visit this reference on the function.

Let’s take a look.

Now that we have created the plugin file, created a function, and assigned that function to a Filter Hook, I am going to activate the plugin and see how it impacts my site:

You can see now, that the plugin has replaced the names in the post. The only remaining issue is that the name “Helga” still shows up in the post title:

Let’s add one more filter to the plugin, to apply the same function (thing_1) to the post title.

add_filter('the_title', 'thing_1');

Here we are grabbing onto the Filter Hook “the_title” to apply the same function. Let’s take a look:

Perfect.

Now that the function works, I am going to add a few more lines to the comments at the top of the plugin file, to take a little credit for my work:

/*
Plugin Name: Thing 1
Plugin URI: http://www.carlbliss.com/?p=528
Description: Protects the identity of my daughters by changing their names to generic Dr. Seuss References
Author: Carl Bliss
Author URI: http://www.carlbliss.com
Version: 1.0b
*/

Those comments will add extra information to the plugin page in the dashboard.

And the process has now been automated!

Here is the completed plugin code (wp-content/plugins/thing_1.php)


/*
Plugin Name: Thing 1
Plugin URI: http://www.carlbliss.com/thing_1
Description: Protects the identity of my daughters by changing their names to generic Dr. Seuss References
Author: Carl Bliss
Author URI: http://www.carlbliss.com
Version: 1.0b
*/

function thing_1($text) {
$text = str_replace('Helga', 'Thing 1', $text);
$text = str_replace('Olga', 'Thing 2', $text);
$text = str_replace('Inga', 'Thing 3', $text);
return $text;
}

add_filter('the_content', 'thing_1');
add_filter('the_title', 'thing_1');

You can download the entire plugin file here: thing_1.php (ZIP)

My bedroom had Space Shuttle Wallpaper, and I would make every effort to see any launches or landings that were covered on television. Until I realized that I would be around 6 1/2 feet tall, I had a young man’s aspirations to be a part of that program when I grew up.

So, I am always excited when I come across some Space Shuttle Geekery.

Here is a 4MB photo of a Space Shuttle cockpit. 

If you don’t mind all the buttons and nobs getting in the way of your icons, it might make decent desktop wallpaper!

You can download it here.

My first reaction is amazement at the technology from the 1980s, and the realization that my phone likely has more computing power.

Thank you Mom and Dad for passing on the name “Gerald Nixon Ford”

I have always wanted to see a game there. I won’t make it before it is taken down.

I did, however, come across this great gallery of Yankee Stadium moments.

Click Here

My Twitter status also updates my Facebook Status, so the term occasionally comes up with the “general public”.

Here is a great video that explains it in terms that are easy to grasp.

A bit creepy that the main character (addicted to her phone and blogs) is named “Carla”

I am breaking my “silence” rule, because it has been broken for me with a nice “buzz” campaign.

I am working with the station to create iCanHelpTwinCities.com. This is a site that will allow local churches and non-profit organizations to post volunteer needs they have. People looking for ways to plug in can search the database of opportunities to connect with these volunteer needs (because, HEY, we all have a ton of free time right??).

It is kind of like a “Craig’s List” for volunteers!

We have already heard from a number of organizations that are really excited to have this tool at their disposal.

I guess what excites me about this project is that it really has a chance to make the Twin Cities better, on a large scale. I don’t know that I have worked on a project that has as much potential as this one.

So, here’s the deal! We are looking for organizations to help us test out the sign-up and posting tools. We are pretty confident they work, but we want to make sure they are easy enough to use and meet the needs of the posting organizations. If you work for a non-profit that uses volunteers, or know someone who may be interested (I am thinking Twin Cities 7 County Metro Area), feel free to leave a comment on this blog post. We would love to have you try it out and give us your feedback.

It pretty much sums up my language skills.

But I just can’t put it together.

Mecha Manga Bible Heroes

This one is “David and Goliath”

Here is the copy from their website:

In Spring, 2008 from JMG Comics. The 32-page, full color Mecha-Manga Bible Heroes series is filled with action-packed mecha-manga art and adventure-filled tales from the Old Testament – all for just $2.99! The characters, stories and themes remain the same. Only the setting has changed – to a futuristic world of robots, aliens and advanced technology! Be sure to reserve your copy today.

So… um… David reached into the lava flow an picked up 5 smooth hyper-laser-blaster-beams…

…Goliath sneered “Am I like a Quartog that you come after me with a Proton-parcep?”

31 different ways to lace shoes.