Hooks List
Hooks are used to add content to your themes. To learn how to use hooks, read the tutorial: Using Hooks to Add Content.
This page should then be used as a reference to see all of the hooks available to you. These are the locations at which you can add (or remove) content.
The images below are to represent a generalized view of a theme. They contain only the core elements and some elements (e.g. the position of the sidebar or menu) may vary from theme to theme (Though the hooks are all the same!).
<head> Hooks
There are 2 hooks that aren’t for adding visual content to (e.g. you might add JavaScript to them, or hook on other PHP functions).
- ply_theme_start – The very first hook loaded when a page on the site loads.
- ply_head – Similar to wp_head (But called first), this is in the <head> section of the page.
Main Layout Hooks
Some things to note:
- The sidebars are hooked onto ply_after_content_outside, so then if you wanted content between the end of #content and the start of #sidebar, you could use:
add_action('ply_after_content_outside', 'your_function', 5);
(Read here for more info on ordering content on a hook)
- The footer function (ply_footer) is hooked onto ply_after_main.
- Most of our themes use just one column in the sidebar. That sidebar is the full width sidebar.
- There are quite a few footer hooks. ply_before_footer_fullwidth sits inside the #footer div, whereas ply_before_footer sits inside the inner .footer-wrapper div. ply_before_expanded_footer is only loaded when the site is using an expanded footer.
Post Hooks
And again, just a few extra notes:
- ply_before_post_single is the same as ply_before_post, except it is only loaded on the full post page.
- The post meta section (ply_post_meta) is usually hooked onto ply_after_post_title (Except on Chameleon itself, where it is hooked to ply_before_post).
Comment Hooks
Each of the comment form elements has a before and after hook, in the form: ply_before_commentform_name and ply_after_commentform_name
The names of the 5 elements have been written on the image (name, email, website, message and submit). You can use any of them, following the format above, e.g.
- ply_before_commentform_website
- ply_before_commentform_message
- ply_after_commentform_submit
With hooks, it is possible to insert code in any part of your theme. If you’re having trouble finding the hook you need, just ask in the forum.