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