VbzCart/pieces/checkout - Revision history

Woozle at 14:34, 4 June 2019

2019-06-04T14:34:50Z

← Older revision		Revision as of 14:34, 4 June 2019
Line 1:		Line 1:
			''see also [[../../coding/checkout\|coding/checkout]]''
	==About==		==About==
	The checkout subsystem handles customer interaction from the point when the customer presses "check out" on the shopping cart up to the point where the order is placed ("finish" button in old system).		The checkout subsystem handles customer interaction from the point when the customer presses "check out" on the shopping cart up to the point where the order is placed ("finish" button in old system).

Woozle: partial reconstruction of lost edit

2018-09-18T12:37:44Z

partial reconstruction of lost edit

← Older revision		Revision as of 12:37, 18 September 2018
Line 21:		Line 21:
	Where form data does not need to be saved, switching modes for a given page can be done with a clickable link rather than a button.		Where form data does not need to be saved, switching modes for a given page can be done with a clickable link rather than a button.
	* '''{{l/sub\|page 0}}''': shopping cart - handled by a different Page class, but can be navigated to from here (i.e. pressing the "back" button on Page 1)		* '''{{l/sub\|page 0}}''': shopping cart - handled by a different Page class, but can be navigated to from here (i.e. pressing the "back" button on Page 1)
			** '''output''': <code>RenderCart()</code>
	* '''{{l/sub\|page 1}}''': shipping info		* '''{{l/sub\|page 1}}''': shipping info
	* '''{{l/sub\|page 2}}''': payment info		* '''{{l/sub\|page 2}}''': payment info
			** '''input''': <code>CaptureBilling()</code>
	* '''{{l/sub\|page 3}}''': confirmation		* '''{{l/sub\|page 3}}''': confirmation
	* '''{{l/sub\|page 4}}''': take action, provide receipt		* '''{{l/sub\|page 4}}''': take action, provide receipt

			I/O functions are handled by the <code>vcPageContent_ckout</code> class.
	==Related Pages==		==Related Pages==
	* [[/archive]]: outdated stuff		* [[/archive]]: outdated stuff

Woozle: pages

2018-09-16T18:43:19Z

pages

← Older revision		Revision as of 18:43, 16 September 2018
Line 15:		Line 15:
	Basically, the Cart object now supervises the creation of new records as needed. Customer objects just create customer records, not address or name or whatever.		Basically, the Cart object now supervises the creation of new records as needed. Customer objects just create customer records, not address or name or whatever.
	===Navigation===		===Navigation===
			We'll treat the shopping cart as being Page 0 of the checkout process, even though it's handled by a different page class, because it is part of the checkout navigation flow i.e. from Page 1, the "back" button takes you back to the shopping cart page.

	It looks like the best way to handle form navigation is to have constant control names for the "back" and "next" buttons and to include the name of the submitting form in a hidden field.<ref name=navbtns />		It looks like the best way to handle form navigation is to have constant control names for the "back" and "next" buttons and to include the name of the submitting form in a hidden field.<ref name=navbtns />

	Where form data does not need to be saved, switching modes for a given page can be done with a clickable link rather than a button.		Where form data does not need to be saved, switching modes for a given page can be done with a clickable link rather than a button.
			* '''{{l/sub\|page 0}}''': shopping cart - handled by a different Page class, but can be navigated to from here (i.e. pressing the "back" button on Page 1)
			* '''{{l/sub\|page 1}}''': shipping info
			* '''{{l/sub\|page 2}}''': payment info
			* '''{{l/sub\|page 3}}''': confirmation
			* '''{{l/sub\|page 4}}''': take action, provide receipt
	==Related Pages==		==Related Pages==
	* [[/archive]]: outdated stuff		* [[/archive]]: outdated stuff

Woozle: more obsolete code notes moved to archive

2018-09-16T15:44:31Z

more obsolete code notes moved to archive

← Older revision		Revision as of 15:44, 16 September 2018
Line 1:		Line 1:
	==About==		==About==
	The checkout subsystem handles customer interaction from the point when the customer presses "check out" on the shopping cart up to the point where the order is placed ("finish" button in old system).		The checkout subsystem handles customer interaction from the point when the customer presses "check out" on the shopping cart up to the point where the order is placed ("finish" button in old system).
	===Requirements===		==Requirements==
	* Record shipping information		* Record shipping information
	* Record payment information		* Record payment information
	* Prevent customer from proceeding if required fields are missing or contain invalid data		** Allow customer to indicate that payment address is same as shipping.
	* Send notification email to customer and store when order is placed		* Prevent customer from proceeding if required fields are missing or contain invalid data.
			* Keep records of customer information as entered and also as interpreted for order processing.
			* Send notification email to customer and store when order is placed.
			** Present customer with printable/saveable receipt.
			==Process==
	===Conversion===		===Conversion===
	Converting the cart data to order data seems to be one of the trickiest parts to get right.		Converting the cart data to order data seems to be one of the trickiest parts to get right.

	~~Revised code flow:~~
	* '''cart/cart.logic.php''': function ToOrder_Data(clsOrder $rcOrd)
	** $tCust->CreateRecord_fromContact($idUser,$oBuyer);
	** $tCust->CreateRecord_fromContact($idUser,$oRecip);

	Basically, the Cart object now supervises the creation of new records as needed. Customer objects just create customer records, not address or name or whatever.		Basically, the Cart object now supervises the creation of new records as needed. Customer objects just create customer records, not address or name or whatever.

	===Navigation===		===Navigation===
	It looks like the best way to handle form navigation is to have constant control names for the "back" and "next" buttons and to include the name of the submitting form in a hidden field.		It looks like the best way to handle form navigation is to have constant control names for the "back" and "next" buttons and to include the name of the submitting form in a hidden field.<ref name=navbtns />

	For the 2009 rewrite, I initially tried to have the "back" and "next" buttons specify the target form, removing the need for the submitting-form-identifier, but this causes problems under the following circumstances:		Where form data does not need to be saved, switching modes for a given page can be done with a clickable link rather than a button.
			==Related Pages==
			* [[/archive]]: outdated stuff
			==Footnote==
			<references>
			<ref name=navbtns>For the 2009 rewrite, I initially tried to have the "back" and "next" buttons specify the target form, removing the need for the submitting-form-identifier, but this causes problems under the following circumstances:
	* determining if the user should be allowed to load the requested form when required fields in the current form have been left empty:		* determining if the user should be allowed to load the requested form when required fields in the current form have been left empty:
	** If the user is moving forward, then NO - the submitting form should be re-displayed with a message listing the missing fields		** If the user is moving forward, then NO - the submitting form should be re-displayed with a message listing the missing fields
Line 27:		Line 30:
	** If this page has been submitted previously, then the stored data should be checked		** If this page has been submitted previously, then the stored data should be checked
	** If this page is being re-loaded because the user requested a forward move while leaving one or more required fields blank, then the submitted data must be checked (this rule can be simplified by storing it first and then always checking stored data)		** If this page is being re-loaded because the user requested a forward move while leaving one or more required fields blank, then the submitted data must be checked (this rule can be simplified by storing it first and then always checking stored data)
			</ref>
	~~==Related Pages==~~		</references>
	* [[/~~archive]]: outdated stuff~~

Woozle: moved code flow to archive

2018-09-16T15:26:32Z

moved code flow to archive

@@ Line 6: / Line 6: @@
 * Prevent customer from proceeding if required fields are missing or contain invalid data
 * Send notification email to customer and store when order is placed
 ===Conversion===
 Converting the cart data to order data seems to be one of the trickiest parts to get right.

Woozle: /* Code Flow */

2016-06-27T22:29:45Z

Code Flow

← Older revision		Revision as of 22:29, 27 June 2016
Line 18:		Line 18:
	*** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions		*** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions
	**** '''cart/cart.data.fg.recip.php''' class vcCartData_Recip public function '''RenderShipping()'''		**** '''cart/cart.data.fg.recip.php''' class vcCartData_Recip public function '''RenderShipping()'''
			***** $this->LoadShippingFields();
	* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderBillingPage()'''		* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderBillingPage()'''
	** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderBillingPage()'''		** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderBillingPage()'''

Woozle: /* Form Render */ RenderPayment

2016-06-18T00:56:46Z

Form Render: RenderPayment

← Older revision		Revision as of 00:56, 18 June 2016
Line 15:		Line 15:
	*** $oCD_Recip = $oCDMgr->RecipObject();		*** $oCD_Recip = $oCDMgr->RecipObject();
	*** $oCD_Buyer->RenderContact(TRUE) // edit email/phone		*** $oCD_Buyer->RenderContact(TRUE) // edit email/phone
			**** '''cart/cart.data.fg-ep.php''' trait vtCartData_EmailPhone public function '''RenderContact()'''
	*** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions		*** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions
			**** '''cart/cart.data.fg.recip.php''' class vcCartData_Recip public function '''RenderShipping()'''
	* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderBillingPage()'''		* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderBillingPage()'''
	** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderBillingPage()'''		** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderBillingPage()'''
Line 21:		Line 23:
	*** $oCD_Buyer = $oCDMgr->BuyerObject();		*** $oCD_Buyer = $oCDMgr->BuyerObject();
	*** $oCD_Buyer->RenderPayment(TRUE) // edit payment information		*** $oCD_Buyer->RenderPayment(TRUE) // edit payment information
			**** '''cart/cart.data.fg.buyer.php''' class vcCartData_Buyer public function '''RenderPayment()'''

	===Form Capture===		===Form Capture===

Woozle: /* Elements */ billing; bolded function names in declarations

2016-06-18T00:35:28Z

Elements: billing; bolded function names in declarations

← Older revision		Revision as of 00:35, 18 June 2016
Line 6:		Line 6:
	* Prevent customer from proceeding if required fields are missing or contain invalid data		* Prevent customer from proceeding if required fields are missing or contain invalid data
	* Send notification email to customer and store when order is placed		* Send notification email to customer and store when order is placed
	==~~Elements~~==		==Code Flow==
	===Form Render===		===Form Render===
	* '''cart/cart-shop.php''' vcrCart_ShopUI function RenderShippingPage()		* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderShippingPage()'''
	** $oCDMgr = $this->FieldsManager();		** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderShippingPage()'''
	** $oCDMgr->FetchBlob();		*** $oCDMgr = $this->FieldsManager();
	** $oCD_Buyer = $oCDMgr->BuyerObject();		*** $oCDMgr->FetchBlob();
	** $oCD_Recip = $oCDMgr->RecipObject();		*** $oCD_Buyer = $oCDMgr->BuyerObject();
	** $oCD_Buyer->RenderContact(TRUE) // edit email/phone		*** $oCD_Recip = $oCDMgr->RecipObject();
	** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions		*** $oCD_Buyer->RenderContact(TRUE) // edit email/phone
			*** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions
			* '''page/vbz-page-ckout.php''' class vcPageCkout protected function '''RenderBillingPage()'''
			** '''cart/cart-shop.php''' vcrCart_ShopUI public function '''RenderBillingPage()'''
			*** $oCDMgr = $this->FieldsManager();
			*** $oCD_Buyer = $oCDMgr->BuyerObject();
			*** $oCD_Buyer->RenderPayment(TRUE) // edit payment information

	===Form Capture===		===Form Capture===
	~~Code flow:~~		* '''page/vbz-page-ckout.php''': class clsPageCkout function '''CapturePage()'''
	* '''page/vbz-page-ckout.php''': class clsPageCkout function CapturePage()		** '''page/vbz-page-ckout.php''': class clsPageCkout function '''CaptureShipping()'''
	** '''page/vbz-page-ckout.php''': class clsPageCkout function CaptureShipping()
	*** $rcCart->CaptureShippingPage();		*** $rcCart->CaptureShippingPage();
	**** '''cart/cart.shop.php''': class vcrCart_ShopUI function CaptureShippingPage()		**** '''cart/cart.shop.php''': class vcrCart_ShopUI function '''CaptureShippingPage()'''
	***** $oCD_Buyer->CaptureContact();		***** $oCD_Buyer->CaptureContact();
	***** $oCD_Recip->CaptureShipping();		***** $oCD_Recip->CaptureShipping();
	****** '''cart/cart.data.fg-na.php''': trait vtCartData_NameAddress function CaptureShipping()		****** '''cart/cart.data.fg-na.php''': trait vtCartData_NameAddress function '''CaptureShipping()'''
	******* $this->InvokeNameAddressFields();		******* $this->InvokeNameAddressFields();
	******* $this->ReceiveForm();		******* $this->ReceiveForm();
	***** $oCDMgr->FetchBlob();		***** $oCDMgr->FetchBlob();
	****** '''cart/cart.data.mgr.php''': class vcCartDataManager function FetchBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function '''FetchBlob()'''
	******* $sBlob = $this->GetBlobString();		******* $sBlob = $this->GetBlobString();
	******* $this->SetBlobArray(...)		******* $this->SetBlobArray(...)
Line 33:		Line 39:
	***** $oCDMgr->UpdateBlob($oCD_Recip);		***** $oCDMgr->UpdateBlob($oCD_Recip);
	***** $oCDMgr->StoreBlob();		***** $oCDMgr->StoreBlob();
	****** '''cart/cart.data.mgr.php''': class vcCartDataManager function StoreBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function '''StoreBlob()'''
	******* $sBlob = serialize($this->GetBlobArray());		******* $sBlob = serialize($this->GetBlobArray());
	******* $this->SetBlobString($sBlob);		******* $this->SetBlobString($sBlob);
	** '''page/vbz-page-ckout.php''': class clsPageCkout function CaptureBilling()		** '''page/vbz-page-ckout.php''': class clsPageCkout function '''CaptureBilling()'''
	*** $rcCart->CaptureBillingPage();		*** $rcCart->CaptureBillingPage();
	**** '''cart/cart.shop.php''': class vcrCart_ShopUI function CaptureBillingPage()		**** '''cart/cart.shop.php''': class vcrCart_ShopUI function '''CaptureBillingPage()'''
	***** $oCD_Buyer = $oCDMgr->BuyerObject();		***** $oCD_Buyer = $oCDMgr->BuyerObject();
	***** $oCD_Buyer->CapturePayment(); // card #/exp, and I think name/address		***** $oCD_Buyer->CapturePayment(); // card #/exp, and I think name/address
	***** $this->AddMissing($oCD_Buyer->GetMissingArray());		***** $this->AddMissing($oCD_Buyer->GetMissingArray());
	***** $oCDMgr->FetchBlob();		***** $oCDMgr->FetchBlob();
	****** '''cart/cart.data.mgr.php''': class vcCartDataManager function FetchBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function '''FetchBlob()'''
	******* $sBlob = $this->GetBlobString();		******* $sBlob = $this->GetBlobString();
	******* $this->SetBlobArray(...)		******* $this->SetBlobArray(...)
	***** $oCDMgr->UpdateBlob($oCD_Buyer);		***** $oCDMgr->UpdateBlob($oCD_Buyer);
	***** $oCDMgr->StoreBlob();		***** $oCDMgr->StoreBlob();
	****** '''cart/cart.data.mgr.php''': class vcCartDataManager function StoreBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function '''StoreBlob()'''
	******* $sBlob = serialize($this->GetBlobArray());		******* $sBlob = serialize($this->GetBlobArray());
	******* $this->SetBlobString($sBlob);		******* $this->SetBlobString($sBlob);

Woozle: /* Form Capture */ form rendering code flow

2016-06-17T20:26:36Z

Form Capture: form rendering code flow

← Older revision		Revision as of 20:26, 17 June 2016
Line 7:		Line 7:
	* Send notification email to customer and store when order is placed		* Send notification email to customer and store when order is placed
	==Elements==		==Elements==
			===Form Render===
			* '''cart/cart-shop.php''' vcrCart_ShopUI function RenderShippingPage()
			** $oCDMgr = $this->FieldsManager();
			** $oCDMgr->FetchBlob();
			** $oCD_Buyer = $oCDMgr->BuyerObject();
			** $oCD_Recip = $oCDMgr->RecipObject();
			** $oCD_Buyer->RenderContact(TRUE) // edit email/phone
			** $oCD_Recip->RenderShipping(TRUE) // edit shipping address / instructions
	===Form Capture===		===Form Capture===
	Code flow:		Code flow:

Woozle: updated filenames

2016-06-17T00:46:24Z

updated filenames

← Older revision		Revision as of 00:46, 17 June 2016
Line 15:		Line 15:
	***** $oCD_Buyer->CaptureContact();		***** $oCD_Buyer->CaptureContact();
	***** $oCD_Recip->CaptureShipping();		***** $oCD_Recip->CaptureShipping();
	****** '''cart/cart.~~xdata~~.~~forms~~.php''': trait vtCartData_NameAddress function CaptureShipping()		****** '''cart/cart.data.fg-na.php''': trait vtCartData_NameAddress function CaptureShipping()
	******* $this->InvokeNameAddressFields();		******* $this->InvokeNameAddressFields();
	******* $this->ReceiveForm();		******* $this->ReceiveForm();
	***** $oCDMgr->FetchBlob();		***** $oCDMgr->FetchBlob();
	****** '''cart/cart.~~xdata~~.php''': class vcCartDataManager function FetchBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function FetchBlob()
	******* $sBlob = $this->GetBlobString();		******* $sBlob = $this->GetBlobString();
	******* $this->SetBlobArray(...)		******* $this->SetBlobArray(...)
Line 25:		Line 25:
	***** $oCDMgr->UpdateBlob($oCD_Recip);		***** $oCDMgr->UpdateBlob($oCD_Recip);
	***** $oCDMgr->StoreBlob();		***** $oCDMgr->StoreBlob();
	****** '''cart/cart.~~xdata~~.php''': class vcCartDataManager function StoreBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function StoreBlob()
	******* $sBlob = serialize($this->GetBlobArray());		******* $sBlob = serialize($this->GetBlobArray());
	******* $this->SetBlobString($sBlob);		******* $this->SetBlobString($sBlob);
Line 35:		Line 35:
	***** $this->AddMissing($oCD_Buyer->GetMissingArray());		***** $this->AddMissing($oCD_Buyer->GetMissingArray());
	***** $oCDMgr->FetchBlob();		***** $oCDMgr->FetchBlob();
	****** '''cart/cart.~~xdata~~.php''': class vcCartDataManager function FetchBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function FetchBlob()
	******* $sBlob = $this->GetBlobString();		******* $sBlob = $this->GetBlobString();
	******* $this->SetBlobArray(...)		******* $this->SetBlobArray(...)
	***** $oCDMgr->UpdateBlob($oCD_Buyer);		***** $oCDMgr->UpdateBlob($oCD_Buyer);
	***** $oCDMgr->StoreBlob();		***** $oCDMgr->StoreBlob();
	****** '''cart/cart.~~xdata~~.php''': class vcCartDataManager function StoreBlob()		****** '''cart/cart.data.mgr.php''': class vcCartDataManager function StoreBlob()
	******* $sBlob = serialize($this->GetBlobArray());		******* $sBlob = serialize($this->GetBlobArray());
	******* $this->SetBlobString($sBlob);		******* $this->SetBlobString($sBlob);