wppizza / markup / loop / header.php
Category header
Note: many display options are also available by simply using the relevant shortcode attributes instead of using filters
CSS Targeting
-
header element id:
#wppizza-header-[category-slug]-[category-id]
-
header element class:
.wppizza-header
-
header element class:
.wppizza-header-[category-slug]
- Use your browsers element inspector to identify all classes and id’s
if you simply want to edit some styles/layout (text-sizes, color, margins, paddings etc etc ) it is strongly recommended to use css instead of filters/actions. Please refer to Modify Styles/Layout
Structure
<header> <h1> category name </h1> <div> category description </div> </header>
Filters available
apply filters by adding them to your child-theme’s functions.php (notes regarding functions.php).
-
filter name:
wppizza_filter_menu_header_element
purpose: modify h1 element to use another element@param: $element str (defaults to h1)
@return: str
examples:add_filter('wppizza_filter_menu_header_element', 'prefix_filter_menu_header_element'); function prefix_filter_menu_header_element($element){ /* simply changing h1 to a h2 element */ return 'h2'; }
-
filter name:
wppizza_filter_menu_header_class
purpose: modify classes used in header@param: $header_class array (array of classes used in various section of the header)
@return: array
examples:add_filter('wppizza_filter_menu_header_class', 'prefix_filter_menu_header_class'); function prefix_filter_menu_header_class($classes){ /* adding a class to header - h1 element. use print_r($classes) to view array */ $classes['h1'][] ='my-class'; return $classes; }
-
filter name:
wppizza_filter_menu_header_markup
purpose: modify output of header element@param: $markup array (array of markup elements)
@param: $category array (array of category slug/id)
@param: $style string (style used – default|responsive|grid)@return: array
examples:
add_filter('wppizza_filter_menu_header_markup', 'prefix_filter_menu_header_markup', 10 ,3); function prefix_filter_menu_header_markup($markup, $category, $style){ /* notes: use print_r($markup) to view markup array keys with their respective markup use print_r($category) to view $category parameters available use print_r($style) to view style used ( default|responsive|grid ) use global $wppizza_options; to access all options/settings/localization strings etc set in the plugin */ /* example: adding a paragraph AFTER all elements */ $markup['my_new_markup'] = '<p>more text after</p>'; /* example: adding a paragraph BEFORE all elements */ $new_markup = array(); $new_markup['my_new_markup'] = '<p>more text before</p>'; $new_markup += $markup; # add original markup after return $new_markup ; # return new markup /* example: adding a another paragraph BEFORE h1 element using helper function*/ $splice_before['my_new_markup'] = '<p>more text before</p>'; $markup = wppizza_array_splice($markup, $splice_before, 'h1', true ); /* example: adding a another paragraph AFTER h1 element using helper function*/ $splice_after['my_new_markup'] = '<p>more text after</p>'; $markup = wppizza_array_splice($markup, $splice_after, 'h1'); /* example: using actions of another plugin that by default outputs html to add it after all elements */ ob_start(); # start buffering do_action('other_plugin_output'); # run action of other plugin that outputs things $buffer= ob_get_contents(); # capture buffer in variable ob_end_clean(); # clean buffer $markup['my_new_markup'] = $buffer; # add buffered output return $markup; }
Actions available
- none
Editing files directly
ensure you have also read the Modify/Edit Templates
basepath: [plugin-path]/wppizza/templates/markup
filepath: [plugin-path]/wppizza/templates/markup/loop/header.php
Modules used in file
- none
Module used by other template file(s)
- none