Author: super_admin_v3x

wppizza / markup / search

Displaying WPPizza menu items in search results If you are using the Wppizza search widget WP -> Appearance -> Widgets -> WPPizza Type:Search or search widget shortcode you will most probably want to create a dedicated search template that works with your theme instead of 

wppizza / markup / search / search.php

Display wppizza menu items in search results keeping prices and other relevant WPPizza menu item information intact to work with your theme Only really used/needed if using WPPizza search widget with wppizza menu items enabled or equivalent shortcode NOTE: although the following would work the 

wppizza / markup / single

Displaying single WPPizza menu items called from permalink or search results

If you are using/displaying permalinks in your list of menu items by using the relevant shortcode and/or are using the Wppizza search widget WP -> Appearance -> Widgets -> WPPizza Type:Search or search widget shortcode you will most probably want to create a single item template that works with your theme instead of using the default (as this would not display any prices and other wppizza related elements)

To do so , please follow the documentation regarding setting up the single.php template

wppizza / markup / single / single.php

Display single wppizza menu item keeping prices and other relevant WPPizza menu item information intact to work with your theme Only really used/needed if using WPPizza search widget with wppizza menu items enabled or including “permalink” in elements attributes of shortcode. NOTE: although the below 

wppizza / markup / loop

Category loop – displaying menu items in category/ies depending on shortcode CSS Targeting Use your browsers element inspector to identify all classes and id’s for each element if you simply want to edit some styles/layout (text-sizes, color, margins, paddings etc etc ) it is strongly 

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

wppizza / markup / loop / no_results.php

Menu items – No results Note: many display options are also available by simply using the relevant shortcode attributes instead of using filters CSS Targeting div element class: .wppizza-no_results_found Use your browsers element inspector to identify all classes and id’s if you simply want to 

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 

wppizza / markup / loop / posts.thumbnail.php

Menu items – featured images / thumbnails / image placeholder (if any)

Note: many display options are also available by simply using the relevant shortcode attributes or setting options in WPPizza -> Layout instead of using filters

CSS Targeting

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

/* featured images */
 <div>
	<img src='path/to/image' />
 </div>

/* placeholder image (uses css to display placeholder) */
 <div>
	<div>[empty]</div> 
 </div>

Filters available

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

  • filter name: wppizza_filter_post_thumbnail_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_thumbnail_class', 'prefix_filter_post_thumbnail_class', 10 ,2);
    function prefix_filter_post_thumbnail_class($classes, $post_data){
    	/* adding your own class name */
    	$classes[] ='my-class';
    return $classes;
    }
    		
  • 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)
    @param: $has_thumbnail bool (true|false)
    @param: $has_placeholder bool (true|false)
    @return: array

    examples:

    
    
    add_filter('wppizza_filter_post_thumbnail_markup', 'prefix_filter_post_thumbnail_markup', 10 ,4);
    function prefix_filter_post_thumbnail_markup($markup, $style, $has_thumbnail, $has_placeholder){
    
    	/* 
    		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 print_r($has_thumbnail) to find out if post should display thumbnail
    		use print_r($has_placeholder) to find out if post should display placeholder
    		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_thumbnail_', 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_thumbnail');
    
    
    	/* 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.thumbnail.php

Modules used in file

  • none

Module used by other template file(s)

  • none

wppizza / markup / loop / posts.prices.php

Menu items – displaying sizes, prices, currency symbols, cart icon Note: many display options are also available by simply using the relevant shortcode attributes or setting options in WPPizza -> Layout instead of using filters CSS Targeting element ID: #wppizza-article-sizes-[post_id] element class: .wppizza-article-sizes element class: