wppizza / markup / global / search.php

A search widget using shortcode [wppizza type='search'] or the widget available from Appearance -> Widgets -> Wppizza -> Widget Type='Search'

For shortcode attributes please refer to the shortcode section

CSS Targeting

  • Wrapper div element id: wppizza-search-[unique_id] (unique to each instance of a widget)
  • Wrapper div element class: wppizza-search (used by all instances of widget)

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

Filters available

apply filters by adding them to your child-theme’s functions.php (notes regarding functions.php).
many display options are also available by simply using the relevant shortcode attributes instead of filters

  • filter name: wppizza_filter_search_widget_markup
    purpose: modify the html markup of the html as required

    @param: $markup array (array of markup elements)
    @param: $atts array (attributes)
    @param: $id int (unique id for each instance)
    @return: array

    examples:

    
    
    add_filter('wppizza_filter_search_widget_markup', 'prefix_filter_search_widget_markup', 10, 3);
    function prefix_filter_search_widget_markup($markup, $atts, $id){
    
    	/* 
    		notes: 
    		use print_r($markup) to view array keys with their respective markup
    		use print_r($atts) to view attributes
    		use print_r($id) to view id of instance
    		use global $wppizza_options; to access all options/settings/localization strings etc set in the plugin 
    	*/
    
    	/* example: adding a paragraph AFTER opening div element using standard php concatenation */
    	$markup['div_'] .= '<p>more text after opening div</p>'; 
    
    	/* example: adding a paragraph BEFORE opening div element  using standard php concatenation */
    	$markup['div_'] = '<p>more text before opening div</p>' . $markup['div_']; 
    
    	/* example: adding a paragraph AFTER opening div element using wppizza array_splice helper function */
    	$splice_after['myprefix_paragraph'] = '<p>more text after opening div</p>'; 
    	$markup = wppizza_array_splice($markup, $splice_after, 'div_' );
    
    	/* example: adding a paragraph BEFORE opening div element  using wppizza array_splice helper function */
    	$splice_before['myprefix_paragraph'] = '<p>more text before opening div</p>'; 	
    	$markup = wppizza_array_splice($markup, $splice_before, 'div_' , true);
    
    	/* example: removing wrapping span elements for the first instance of the widget on the page */
    	if($id == 1){
    	unset($markup['span_']);
    	unset($markup['_span']);
    	}
    
    	/* example: using actions of another plugin that by default outputs html to add it after the wrapper div */
    	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['_span'] = $markup['_span'] . $buffer; # add buffered output after end of wrapper
    
    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/global/search.php

Modules used in file

  • None

Module used by file(s)

  • None