How to Use Genesis Hooks to Manipulate Theme Elements
Within the earlier submit on this sequence we talked in regards to the fundamentals of PHP and the way capabilities are put collectively. At this time we’re going to construct on that and speak about methods to use Genesis hooks to control theme components.
Have you ever ever puzzled how the Genesis theme framework is aware of methods to name all that code out of your baby theme information in the fitting order?
Genesis makes use of a WordPress conference known as hooks to “hook” into the code on the desired spot identical to WordPress as a complete does. (Genesis additionally makes use of one thing known as filters too, which we’ll deal with within the subsequent submit on this sequence.)
One Large Program
Actually if you get proper all the way down to it your WordPress web site is only one massive lengthy program. Every part together with your core WordPress installations, all your plugins, your Genesis framework and your baby theme are actually all only one massive lengthy program. It executes within the order that’s specified by the WordPress core information.
And hooks are one of many highly effective methods we are able to modify the presentation of our web site.
That’s how there will be so many WordPress web sites and plenty of of them look and performance radically totally different from each other on the general public going through exterior.
WordPress Hooks Outlined
We most likely ought to take a look at what a hook is earlier than we get all the way down to the specifics of utilizing them within the Genesis framework.
Right here’s a working definition:
You may consider it type of like a hook on a wall. If that wall is your important program, the hook is the place you’re going to hold your operate so it does what you need the place you need it to do it.
It seems that is an extremely highly effective idea. Personally I feel it is among the massive elements that has made using WordPress develop so quick in recent times. (At this time WordPress powers 21.2% of the web’s web sites, up from 17.4% a yr in the past.)
WordPress has a do_action operate constructed into it that builders can use of their code. This permits folks akin to you and I to return in behind them and alter their code at that time.
Hooks in Genesis
If you happen to take a look at the code within the numerous core Genesis theme framework information you will notice do_action capabilities scattered all through the code.
For instance, should you look within the /genesis/header.php file immediately you will notice this line of code:
This hook is usually used to control the principle navigation menu in Genesis.
Notice: Since you have an interest in Genesis theme customization you already know that it is best to by no means (by no means, by no means ever, I imply by no means!) modify your Genesis information immediately. All your customizations go in your baby theme information.
Genesis has hooks like this scattered all through the framework. To seek out the fitting hook to do what you need you may both take a look at the helpful Genesis Hook Reference that StudioPress supplies, or you may look by way of the code for these do_action capabilities.
Accessing Hooks
WordPress additionally has a pair different capabilities in-built that enable us to faucet into these hooks. These are the add_action and the remove_action capabilities. Of their primary format they seem like this in accordance with the WordPress Codex:
The $hook is the bit inside the precise do_action operate that identifies the hook we wish to faucet into. In our instance above that half could be ‘genesis_after_header’ as our hook.
The $function_to_add is the operate in our baby theme that we wish to execute at that time.
Within the remove_action operate we are able to make capabilities in the principle Genesis framework not execute at that hook by noting them within the $function_to_remove spot.
Highly effective Mixture
This makes for a strong mixture. For instance, say we wish to transfer the principle navigation of our Genesis baby theme from its traditional place under the header to above it.
Once I first began messing with themes in WordPress doing one thing like that meant I needed to copy the header.php file to my baby theme and make my adjustments to that file. (Truly I began earlier than WordPress even had the power to do baby themes. However by no means thoughts that. Simply know that WordPress is continually bettering and issues have gotten significantly better and simpler to make use of over time.)
The difficulty with doing issues by way of copying information wholesale is that if the developer comes out with updates to the guardian theme that alter the header.php file I’m caught. I can both ignore these updates or I’ve to manually incorporate them into my baby theme’s information.
If I solely have one website to handle that is perhaps workable. However what if I’ve acquired 100 or extra consumer websites to take care of?
As an alternative of doing that, I can use hooks in Genesis and make that very same change to maneuver my important navigation with simply two traces of code in my baby theme’s capabilities.php file like this:
Do you see what we did there?
The remove_action operate tells the positioning to not execute the Genesis important navigation on the ‘genesis_after_header’ hook. And the add_action tells the positioning to place the principle navigation earlier than the header the place the ‘genesis_before_header’ hook is discovered.
Once we extrapolate that out we have now an extremely highly effective mixture of instruments to customise our Genesis themes.
Advantages of Hooks
Clearly it’s a entire lot simpler to only add a pair traces of code to our capabilities.php file slightly than copying over the whole contents of our theme information and enhancing them. However there are another advantages to utilizing hooks as effectively.
For one factor we already talked about that hooks make it far simpler to get the complete profit from upgrading our guardian theme as a result of we’ve moved the minimal quantity of code obligatory into our baby themes.
That is additionally a comparatively crash proof method to modify issues in our themes. If you happen to reference a operate that doesn’t exist or the guardian theme developer adjustments or removes a hook, your website won’t crash. WordPress simply skips over add or take away actions that reference invalid hooks or capabilities.
Your website might not look the best way you need it too. However not less than it gained’t crash fully if one thing adjustments.
One other profit to utilizing hooks is that it streamlines your code as a result of it permits you reuse capabilities everytime you wish to repeat the identical performance. So a number of add_action statements can reference the identical operate utilizing totally different hooks.
So for instance, say you had a operate to show an promoting block in your theme. Relatively than duplicating that operate in numerous theme template information you may merely checklist it as soon as in your capabilities.php file and have a number of add_action statements that decision your operate by way of hooks to show your advertisements the place you need them.
That’s fairly highly effective. And it enormously simplifies the method for making your customization tweaks too, when you get your head round it.
If you happen to ever have to make a change to your advert block you solely have to alter one operate in your capabilities.php file and it applies your change to all your advert blocks directly. That’s a complete lot simpler than looking by way of your theme information for each occasion of of your advert block code and enhancing every of them.
Precedence
It’s best to learn about what is known as precedence if you find yourself utilizing hooks. One problem when working with hooks is that by default they execute within the order that they seem within the total WordPress code. Understand that our WordPress website is only one massive lengthy program that features our core WordPress information, all of our lively plugins and the theme/baby theme information which can be lively on our website.
Typically it may be a problem to get issues to look within the order we wish when there are a number of capabilities hanging on the identical Genesis hook in our theme. I run into this a good quantity when working with plugins which can be used so as to add a little bit of performance. WordPress masses plugins earlier than themes so any motion known as in a plugin will naturally seem earlier than that very same motion is known as in your theme.
Luckily you may designate a precedence in your motion statements.
The precedence is simply an optionally available quantity added to the motion assertion to find out the order by which the operate affiliate with that motion is known as in relation to different capabilities utilizing that very same hook. So including a precedence to our earlier instance it might seem like this:
On this case 10 is the precedence. We will regulate that quantity 10 up or down to alter the order by which our operate will get known as. Decrease numbers are known as earlier than increased numbers. The default precedence is 10 so setting it to 10 is form of pointless. That’s what it will likely be once we go away off the precedence anyway.
Understanding precedence is necessary if you find yourself customizing your Genesis themes as a result of with the brand new HTML5 loop in Genesis 2.0+ the builders have included fewer hooks than we had accessible beforehand. In doing so that they have simplified issues to make it simpler for us to recollect which hooks to make use of.
Nevertheless this additionally means we have to faucet into the hook precedence extra to get our capabilities’ output positioned the best way we wish them.
Precedence additionally comes into play when eradicating actions too. You can’t take away an motion earlier than it’s added. So if the add_action assertion for the operate we wish to take away has, say a precedence of 15, if we attempt to use a remove_action assertion with the default precedence of 10 it gained’t work. As an alternative we’ll want to make use of a precedence of 15 or increased to deactivate that operate in our theme.
The most effective factor to do is to have a look at the code and see what precedence it’s essential to use. However typically it simply isn’t sensible to truly put our eyes on the code in query. In these circumstances a little bit trial and error with precedence normally will get us to the fitting place.
In the case of Genesis theme customization hooks are a tremendously highly effective software we must always maintain helpful in our software belt. They provide us the power to control and construction our theme the best way we wish to obtain nice wanting designs.
This post is also available in: 
Français
