wppizza / markup / loop / posts.title.php

Menu items – Title with additive idents (if any)

Note: many display options are also available by simply using the relevant shortcode attributes instead of using filters

CSS Targeting

  • h2 element ID: #wppizza-article-[post_id]-[size_id]-0
  • h2 element class: .wppizza-article-h2
  • 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

 <h2>
	<span>
		post title
	</span>
	
	/* additive idents */
	<sup>
		/* each additive idents */
		<span>(ident)</span>

	</sup>

 </h2>

Filters available

apply filters by adding them to your child-theme’s functions.php (notes regarding functions.php).

  • filter name: wppizza_filter_post_title_element
    purpose: modify h2 element to be something else

    @param: $element str (default h2)
    @return: str

    examples: changing the element will also change the class name ! i.e wppizza-article-h2 will become wppizza-article-h3 in the example below

    
    add_filter('wppizza_filter_post_title_element', 'prefix_filter_post_title_element');
    function prefix_filter_post_title_element($element){
    	/* change h2 to an h3 */
    return 'h3';
    }
    		
  • filter name: wppizza_filter_post_title_class
    purpose: modify classes used

    @param: $classes array (array of classes used in wrapper div)
    @param: $post_data array (array of post_data)

    @return: array

    examples:

    
    add_filter('wppizza_filter_post_title_class', 'prefix_filter_post_title_class', 10 ,2);
    function prefix_filter_post_title_class($classes, $post_data){
    	/* adding your own class name */
    	$classes[] ='my-class';
    return $classes;
    }
    		
  • filter name: wppizza_filter_post_title
    purpose: modify title

    @param: $post_title str (menu item title)
    @param: $post_id int (menu item id)

    @return: array

    examples:

    
    add_filter('wppizza_filter_post_title', 'prefix_filter_post_title', 10 ,2);
    function prefix_filter_post_title($post_title , $post_id ){
    	/* adding some text after the title */
    	$post_title .=' some text';
    return $post_title ;
    }
    		
  • filter name: wppizza_filter_post_title_markup
    purpose: modify output of element

    @param: $markup array (array of markup elements)
    @param: $style string (style used – default|responsive|grid)

    @return: array

    examples:

    
    
    add_filter('wppizza_filter_post_title_markup', 'prefix_filter_post_title_markup', 10 ,2);
    function prefix_filter_menu_header_markup($markup, $style){
    
    	/* 
    		notes: 
    		use print_r($markup) to view markup array keys with their respective markup
    		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 element using helper function*/
    	$splice_before['my_new_markup']  = '<p>more text before</p>'; 
    	$markup = wppizza_array_splice($markup, $splice_before, 'post_title_', true );
    
    	/* example: adding a another paragraph AFTER element using helper function*/
    	$splice_after['my_new_markup']  = '<p>more text after</p>'; 
    	$markup = wppizza_array_splice($markup, $splice_after, '_post_title');
    
    
    	/* 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/posts.title.php

Modules used in file

  • none

Module used by other template file(s)

  • none