Developers

  1. Modify Css / Styles / Layout
    1. Frontend Css
    2. Admin Css
  2. Templates
    1. Pages
      1. page.order.php
      2. page.confirm-order.php
      3. page.processing.php
      4. page.thankyou.php
      5. page.cancelled.php
      6. page.purchase-history.php
    2. Order
      1. itemised.php
      2. summary.php
      3. transaction_details.php
    3. Global
      1. orderinfo.php (Widget)
      2. openingtimes.php (Widget)
      3. additives.php (Widget)
      4. navigation.list.php (Widget)
      5. navigation.dropdown.php (Widget)
      6. search.php (Widget)
      7. totals.php (Widget)
      8. pickup_choice.php (Mixed)
      9. login.php (Module)
      10. profile.register.php (Module)
      11. profile.update.php (Module)
      12. pages.pickup_note.php (Module)
      13. formfields.inputs.php (Module)
      14. formfields.values.php (Module)
    4. Cart
      1. cart.container.php
      2. cart.shopclosed.php
      3. cart.empty.php
      4. cart.pickup_note.php
      5. cart.checkout_button.php
      6. cart.empty_cart_button.php
      7. cart.minimum_order.php
      8. minicart.php
    5. Loop (Menu Items)
      1. header.php
      2. no_results.php
      3. posts.title.php
      4. posts.thumbnail.php
      5. posts.prices.php
      6. posts.content.php
      7. posts.permalink.php
      8. additives.php
      9. pagination.php
      10. theme-wrapper.php
    6. Search Results
      1. search.php
    7. Single Menu Item
      1. single.php
    8. functions.php
  3. Filters, Actions, Functions
    1. Global WPPizza functions
    2. WPPizza options (Filter)
    3. Currency (Filter)
    4. After every order (Action)
    5. Getting Orders (Function)
  4. Constants
    1. Admin Name
    2. Admin Menu Icon
    3. SORT_ITEMS_AS_ADDED
    4. SINGLE_PERMALINK_VAR
    5. WIDGET_CSS_CLASS
    6. PLAINTEXT_LINE_LENGTH
    7. ADMIN_{CONSTANTS}
    8. DEV_{CONSTANTS}
    9. INSTALL_{CONSTANTS}
    10. TRANSACTION_{CONSTANTS}
  5. Codesnippets
    1. Create your own sales report
    2. Order history - todays orders
    3. Add attachment to email
    4. On order status update
    5. Unconfirmed Orders
    6. Customise order id
    7. Changing post type arguments
    8. Gateway filter frontend
    9. Users previous orders
    10. Dynamic menu item prices
    11. Prices output loop
    12. Pickup Opening Times
    13. Additional validation function

2.3.14.formfields.values.php (Module)

Submitted customer information values received from form fields set in WPPizza -> Order Form Settings

Display submitted formfield values in “confirmation page” – if used and – “thank you page” – if “Show Order Details on “Thank You” page” is enabled in WPPizza -> Order Settings -> Global

CSS Targeting

  • Wrapper fieldset element class: .wppizza-order-wrap-confirmationpage .wppizza-personal-details
    (confirmation page customer details – if used)
    Wrapper fieldset element class: .wppizza-order-wrap-thankyoupage .wppizza-personal-details
    (thank you page customer details – if displayed)

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).

do NOT use this filter to add additional formfields you want to capture with the order or display in emails , print templates , order history etc. Use wppizza_register_formfields instead

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

    @param: $markup array (array of markup elements)
    @param: $formfields array (array of formfield parameters)
    @param: $page str (‘confirmationpage’ or ‘thankyoupage’)
    @return: array

    examples:

    
    
    add_filter('wppizza_filter_formfields_values', 'prefix_filter_formfields_values', 10, 3);
    function prefix_filter_formfields_values($markup, $formfields, $page){
    
    	/* 
    		notes: 
    		use print_r($markup) to view array keys with their respective markup
    		use print_r($formfields) to view formfields parameters and keys ('cemail', 'cname', 'ctel', 'ccomments' etc )
    		$page is either 'thankyoupage' or 'confirmationpage'
    		use global $wppizza_options; to access all options/settings/localization strings etc set in the plugin 
    	*/
    
    	/* example: adding a paragraph AFTER all submitted formfields */
    	$markup['my_paragraph'] = '<p>more text after formfields </p>'; 
    
    	/* example: adding a paragraph BEFORE all submitted formfields */
    	$new_markup = array();	
    	$new_markup['my_paragraph'] = '<p>more text before formfields </p>'; 	
    	$new_markup +=$markup;
    	return $new_markup; # return the new markup array now
    
    	/* example: adding a paragraph AFTER all submitted formfields using wppizza array_splice helper function and numeric index */
    	$splice_after['myprefix_paragraph'] = '<p>more text after all formfields</p>'; 
    	$markup = wppizza_array_splice($markup, $splice_after, 100 );
    	# each formfield consists of an array made up of 4 keys (opening div, label, value, closing div). so if there are 5 formfields the array would consist of20 keys, setting the offset to 100 therefore would ensure it is added to the very end, although setting it to 20 in this case would also suffice #
    
    
    	/* example: adding a paragraph BEFORE all submitted formfields  using wppizza array_splice helper function and numeric index*/
    	$splice_before['myprefix_paragraph'] = '<p>more text before all formfields</p>'; 	
    	$markup = wppizza_array_splice($markup, $splice_before, 0);#set to 0 to add before all submitted formfields
    
    
    	/* example: adding a paragraph BEFORE the submitted email formfield div using wppizza array_splice helper functionx*/
    	$splice_in_place_before['myprefix_paragraph'] = '<p>more text before email formfield wrapper div</p>'; 	
    	$markup = wppizza_array_splice($markup, $splice_in_place_before, 'div_cemail_', true); # insert before opening cemail div element: div_cemail_
    
    
    	/* example: adding a paragraph AFTER the submitted email formfield div using wppizza array_splice helper functionx*/
    	$splice_in_place_after['myprefix_paragraph'] = '<p>more text after email formfield wrapper div</p>'; 	
    	$markup = wppizza_array_splice($markup, $splice_in_place_after, '_div_cemail');# insert after closing cemail div element: _div_cemail
    
    
    	/* example: replacing each formfields surrounding 'div' with 'span' . $key will be something like 'cemail', 'cname', 'ctel', 'ccomments' etc*/
    	foreach($formfields as $key=>$formfield){
    		$markup['div_'.$key.'_'] = str_replace('<div', '<span', $markup['div_'.$key.'_']);
    		$markup['_div_'.$key.''] = str_replace('</div>', '</span>', $markup['_div_'.$key.'']);
    	}
    
    	/* example: using actions of another plugin that by default outputs html to add it after all formfields*/
    	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_buffer'] = $buffer; # simply add buffered output to the array
    
    return $markup;
    }
    		

Actions available

Actions should NOT output / echo / print anything, if you need to output any elements, use the filter provided (see above)

  • action: wppizza_formfields_values
    purpose: run an action when customer input fields are show

    @param: $formfields array (array of form fields)
    @param: $page str (‘confirmationpage’ or ‘thankyoupage’)
    @return: void

  • action: wppizza_formfield_value_'.$key.'
    purpose: run an action when a particular customer input field is show ($key will be something like ‘cemail’, ‘cname’, ‘ctel’, ‘ccomments’ etc )

    @param: $formfield array (array of formfield paramaters of this key)
    @param: $page str (‘confirmationpage’ or ‘thankyoupage’)
    @return: void

  • example: if necessary, replace wppizza_formfields_inputs with one of the action hooks above

    
    add_action('wppizza_formfields_values', 'prefix_formfields_values_myaction', 10 , 2);
    function prefix_formfields_values_myaction($formfields, $page){
    
    
    	/* 
    	#	run your code/action . use $page paramater to restrict to  'confirmationpage' or 'thankyoupage'
    	*/
    
    	/* do not output/echo anything - use the filter above instead if you need to*/
    return;
    }
    		

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/formfields.inputs.php

Modules used in file

  • None

Module used by file(s)

  • [basepath]/pages/page.order.php
  • [basepath]/pages/page.confirm-order.php
Yes No Suggest edit
Suggest Edit

documentor id 5