# A guide to Hybrid Hook

Hybrid Hook was created to make it easy for average users to plug custom code into their site without having to learn how the hooks system (Plugin API) works in WordPress.

This plugin adds an additional theme settings paged named Hybrid Hook under the Appearance menu in the admin. You can use it to input custom HTML, PHP, JavaScript, and even shortcodes. You don't have to dig into those theme files just to add a little extra content to your blog. You can use this plugin to add content anywhere.

## How to install the plugin

1. Uzip the `hybrid-hook.zip` folder.
2. Upload the `hybrid-hook` folder to your `/wp-content/plugins` directory.
3. In your WordPress admin, head over to the Plugins section.
4. Activate Hybrid Hook.

## How to use the plugin

Once you've activated the plugin, a new menu item labeled Hybrid Hook will be under your Appearance/Themes menu in your WordPress admin. This item will only be shown to users with the `edit_theme_options` capability (the Administrator role in default WordPress installations).

On the Hybrid Hook Settings page, you'll be presented with several meta boxes, one for each available action hook. Within each meta box, there'll be three settings:

- Textarea: This is where you input your custom code. You can add HTML, PHP, JavaScript, and shortcodes here.
- Priority: This is when your code will be fired on the action hook. It's useful for adding things before/after the default actions fired by Hybrid. Typically, it's best to just leave this at the default of `10`.
- Execute PHP?: If you added PHP code to your textarea, you need to select this option for the code to be executed.

That's pretty much it. Just remember that you're responsible for the code you add to your site.

Note that most HTML is stripped and PHP won't be executed if the user inputting the code doesn't have the `unfiltered_html` capability (Administrators have this capability on a default WordPress install). This is a safety precaution to make sure users without permission don't add stuff they shouldn't add.

## Plugin support

I run a WordPress community called Theme Hybrid, which is where I fully support all of my WordPress projects, including plugins. You can sign up for an account to get plugin support for a small yearly fee ($25 USD at the time of writing).

I know. I know. You might not want to pay for support, but just consider it a donation to the project. To continue making cool, GPL-licensed plugins and having the time to support them, I must pay the bills.

## Copyright & license

Hybrid Hook is licensed under the GNU General Public License, version 2 (GPL).

This plugin is copyrighted to Justin Tadlock.

2008 – 2011 © Justin Tadlock