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