2.3.3.additives.php (Widget)
A barely styled widget using shortcode [wppizza type='additives']
displaying all additives defined in WPPizza -> Additives
For shortcode attributes please refer to the shortcode section
CSS Targeting
-
Wrapper div element id:
#wppizza-additives-[unique_id]
(unique to each instance of a widget) -
Wrapper div element class:
.wppizza-additives
(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_additives_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)
@param: $additives int (additives parameters)
@return: arrayexamples:
add_filter('wppizza_filter_additives_widget_markup', 'prefix_filter_additives_widget_markup', 10, 4); function prefix_filter_totals_widget_markup($markup, $atts, $id, $additives ){ /* 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 print_r($additives) to view additives parameters 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 the wrapper div for the first instance of the widget on the page */ if($id == 1){ unset($markup['div_']); unset($markup['_div']); } /* 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['_div'] = $markup['_div'] . $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/additives.php
Modules used in file
- None
Module used by file(s)
- None
documentor id 5