genesis_setup

Description

This is an action event with the Genesis theming framework. Its intent is to setup the web page before the rest of the web page construction begins. In the logical sequence of the program execution, it occurs after the genesis_setup event fires. Therefore, first you initialize and then you setup your theme.

Genesis uses this event to setup the default widget (sidebar) areas:

• Header right
• Main sidebar
• Alternative sidebar

When the event genesis_setup fires, each of the pre-registered callbacks (see the add_action Docx for more information) are invoked, i.e. meaning they run one-by-one in order.

In your theme or plugin, you register callbacks to this event setup the theme itself before the page begins to be built when genesis() is called. Some tasks include, but are not limited to:

• Adding theme supports, e.g. HTML5, menus, viewport meta tag, widgets, structural wraps, etc.
• Adding custom image sizes
• Registering custom widget areas (sidebars)
• Unregistering any standard components that your project does not need, such as default sidebars and/or layouts.

Syntax

You register your callback as follows:

bool add_action ( 
	'genesis_setup',
	callable $callback_name, 
	integer $priority = 10
);

The event is then fired from the genesis/lib/init.php file using do_action( 'genesis_setup' );.

Genesis documentation

Parameters

This function does not accept any parameters.

Return Values

It does not return anything.