VbzCart/docs/v1/class/vcCartData Buyer: Difference between revisions

From Woozle Writes Code
< VbzCart‎ | docs‎ | v1/class
Jump to navigation Jump to search
imported>Woozle
(Created page with "* '''file''': {{l/project|file|cart/cart.data.fg.buyer.php}} * '''extends''': {{l/version|class|vcCartData_Contact}} <source lang=php> /*:::: PURPOSE: Handles Buyer subforms...")
 
m (Woozle moved page VbzCart/VbzCart/v1/class/vcCartData Buyer to VbzCart/docs/v1/class/vcCartData Buyer without leaving a redirect: part 5/5)
 
(9 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{page/code/class}}
* '''file''': {{l/project|file|cart/cart.data.fg.buyer.php}}
* '''file''': {{l/project|file|cart/cart.data.fg.buyer.php}}
* '''extends''': {{l/version|class|vcCartData_Contact}}
* '''extends''' {{l/version|class|vcCartData_Contact}} which...
<source lang=php>
** '''...extends''' {{l/version|class|vcCartData_NameAddress}} which...
/*::::
*** '''...uses''' {{l/version|class|vtCartData_NameAddress}}
  PURPOSE: Handles Buyer subforms:
** '''...uses''' {{l/version|class|vtCartData_EmailPhone}}
    * email/phone
* '''call links''':
    * payment (name/address/details)
** '''created by''':
*/
*** {{l/version/method|vcCartDataManager|GetBuyerObject}}()
class vcCartData_Buyer extends vcCartData_Contact {
** '''field creation''':
 
*** {{l/version|class|vcCartDataFieldGroup}}::'''__construct'''({{l/version|class|vcCartForm}} $oForm) calls...
    const KS_CARDADDRTYPE_EXISTING = 'old';
**** $this->'''CreateFields'''() [protected], which calls...
    const KS_CARDADDRTYPE_NEWENTRY = 'new';
***** {{l/version|class|vcCartData_Contact}}::CreateFields() (parent)
   
***** $this->'''OrderMessageField'''(); // add this field to the standard ones
    // ++ TRAIT REQUIREMENTS ++ //
***** $this->'''CardNumberField'''();
 
***** $this->'''CardExpiryField'''();
    protected function PrecedingLinesForTemplate() {
** '''rendering''':
$htName = $this->FieldName_forContactName();
*** {{l/version|class|vcCartDataManager}}::'''RenderBillingPage'''() calls
$out = "\n  <tr><td align=right>Name on Card:</td><td>[[$htName]]</td></tr>";
**** $this->'''{{l/sub|RenderPayment}}'''($doEdit) [public]
return $out;
** '''capture''':
    }
*** {{l/version|class|vcCartDataManager}}::'''CaptureBillingPage'''() calls...
    protected function FollowingLinesForTemplate() {
**** $this->'''{{l/sub|CapturePayment}}'''() [public]
return NULL;
    }
    protected function FieldName_Prefix() {
return 'buyer-';
    }
    protected function DefaultEmail() {
$oApp = $this->AppObject();
if ($oApp->UserIsLoggedIn()) {
    return $oApp->GetUserRecord()->EmailAddress();
} else {
    return NULL;
}
    }
   
    // -- TRAIT REQUIREMENTS -- //
    // ++ FIELD VALUES ++ //
   
    /*----
      2016-05-17 It's possible this hasn't been used yet. Maybe it should have "Intype" in there somewhere,
to make its role more obvious. TODO: check to see if this is used.
    */
    protected function Value_forCardAddrType($s=NULL) {
$sfName = $this->FieldName_forCardAddrType();
if (!is_null($s)) {
    $this->SetValue($sfName,$s);
}
return $this->GetValue($sfName);
    }
    /*----
      NOTE: This is basically the same as Value_forShipInType in the Recip class, but that may be deceptive.
Right *now* there's only one intype field in Recip and Buyer, but that could change later. So even though
they both use the same base naming function (FieldName_forIntype()), I'm giving the value functions
different names (and adding a suffix to the field name) so there won't be any ambiguity later
if we add more intype choices.
      PUBLIC so Cart object can access it during conversion to Order
    */
    public function Value_forBillInType($s=NULL) {
$sfName = $this->FieldName_forBillIntype();
if (!is_null($s)) {
    $this->SetValue($sfName,$s);
}
return $this->GetValue($sfName);
    }
    public function Value_forBillInType_isNew() {
$sIntype = $this->Value_forBillInType();
return is_null($sIntype) || ($sIntype == KS_FORM_INTYPE_NEWENTRY);
    }
    public function GetValue_forCardNumber() {
$sfName = $this->FieldName_forCardNumber();
return $this->GetValue($sfName);
    }
    public function GetValue_forCardExpiry() {
$sfName = $this->FieldName_forCardExpiry();
return $this->GetValue($sfName);
    }
    public function GetValue_forOrderMessage() {
$sfName = $this->FieldName_forOrderMessage();
return $this->GetValue($sfName);
    }
   
    // -- FIELD VALUES -- //
    // ++ FIELD NAMES ++ //
   
    protected function FieldName_forBillIntype() {
return 'intype-bill';
    }
    protected function FieldName_forCardAddrType() {
return 'card-addr-type';
    }
    protected function FieldName_forCardNumber() {
return 'card-num';
    }
    protected function FieldName_forCardExpiry() {
return 'card-exp';
    }
    protected function FieldName_forOrderMessage() {
return 'order-msg';
    }
   
    // -- FIELD NAMES -- //
    // ++ FIELD OBJECTS ++ //
   
    private $oField_CardAddrType;
    protected function CardAddrTypeField() {
if (empty($this->oField_CardAddrType)) {
    $sName = $this->FieldName_forCardAddrType();
    $oField = new fcFormField_Text(
      $this->FormObject(),
      $sName
      );
    //$oField->SetValue(self::KS_INTYPE_EXISTING);
   
    $arBtns = array(
self::KS_CARDADDRTYPE_EXISTING => new fcInstaModeButton($sName,"Ship to Card's Billing Address"),
self::KS_CARDADDRTYPE_NEWENTRY => new fcInstaModeButton($sName,"Enter Card's Billing Address"),
      );
    $oCtrl = new fcFormControl_HTML_InstaMode($oField,$arBtns);
   
    $this->oField_Intype = $oField;
}
return $this->oField_Intype;
    }
    private $oField_CardNum;
    protected function CardNumberField() {
if (empty($this->oField_CardNum)) {
    $oField = new fcFormField_Text(
      $this->FormObject(),
      $this->FieldName_forCardNumber()
      );
 
    $oCtrl = new fcFormControl_HTML($oField,array('size'=>20));
      $oCtrl->DisplayAlias('card number');
      $oCtrl->Required(TRUE);
 
    $this->oField_CardNum = $oField;
}
return $this->oField_CardNum;
    }
    private $oField_CardExp;
    protected function CardExpiryField() {
if (empty($this->oField_CardExp)) {
    $oField = new fcFormField_Text(
      $this->FormObject(),
      $this->FieldName_forCardExpiry()
      );
 
    $oCtrl = new fcFormControl_HTML($oField,array('size'=>5));
      $oCtrl->DisplayAlias('card expiration');
      $oCtrl->Required(TRUE);
 
    $this->oField_CardExp = $oField;
}
return $this->oField_CardExp;
    }
    private $oField_OrderInstrux;
    protected function OrderMessageField() {
if (empty($this->oField_OrderInstrux)) {
    $oField = new fcFormField_Text(
      $this->FormObject(),
      $this->FieldName_forOrderMessage()
      );
 
    $oCtrl = new fcFormControl_HTML_TextArea($oField,array('rows'=>3,'cols'=>50));
      $oCtrl->Required(FALSE);
     
    $this->oField_OrderInstrux = $oField;
}
 
return $this->oField_OrderInstrux;
    }
    protected function InvokeCardNumberFields() {
$this->CardNumberField();
$this->CardExpiryField();
    }
    /*----
      TODO: When other payment types are available, this will have to invoke different sets of fields
depending on which type is selected... or maybe we'll just invoke all the fields all the time,
to simplify troubleshooting.
    */
    protected function LoadPaymentFields() {
$this->InvokeCardNumberFields();
// (if entering new card)
$this->InvokeNameAddressFields();
 
// copy blob data to field objects
$this->FormObject()->LoadFields_fromBlob();
    }
    protected function LoadContactFields() {
      $this->OrderMessageField(); // add this field to the standard ones
parent::LoadContactFields(); // load standard ones
    }
 
    // -- FIELD OBJECTS -- //
    // ++ FORM I/O: CAPTURE ++ //
   
    public function CapturePayment() {
$this->LoadPaymentFields();
$this->ReceiveForm();
    }
 
    // -- FORM I/O: CAPTURE -- //
    // ++ FORM I/O: RENDER ++ //
 
    // OVERRIDE of trait method
    protected function ContactTemplate_FollowingLines() {
$htMsg = $this->FieldName_forOrderMessage();
// Main label and additional explanation above; everything centered
$out = "\n<tr><td align=center colspan=2>"
  .'Special instructions for this order only:'
  ."\n<br>[[$htMsg]]"
  .'</td></tr>'
  ;
return $out;
    }
   
    public function RenderPayment($doEdit) {
$this->LoadPaymentFields();
$out =
  $this->RenderPayTypeSection($doEdit)
  ;
return $out;
    }
    /*----
      FUTURE: This will display instamode buttons to allow switching payment types.
For now, we're only supporting credit card, so this just dispatches to
the credit card form.
    */
    protected function RenderPayTypeSection($doEdit) {
$sWhere = __METHOD__."() - ".__FILE__." LINE ".__LINE__;
$out = $this->RenderPayCardSection($doEdit);
/*
$out =
  "\n<!-- vv $sWhere vv -->"
  //.$this->SectionHeader('Payment type:')
  ."\n<table class=\"form-block\" id=\"pay-type\">"
  ;
 
$isShipCardSame = $this->CartFields()->IsShipToCard();
$htChecked = $isShipCardSame?' checked':'';
 
$out .= "\n<tr><td align=center>\n"
  .$this->Skin()->RenderPaymentIcons()
  ."<table><tr><td>"
  .'<input name=payType value="'.KSF_CART_PTYP_CARD_HERE.'" type=radio checked disabled> Visa / MasterCard / Discover / American Express - pay here'
  .'<br>&emsp;<input name="'.KSF_SHIP_IS_CARD.'" type=checkbox value=1'.$htChecked.'>billing address is same as shipping address above'
  ."</td></tr></table>\n"
  ."<hr>More payment options will be available soon.\n"
  ."</td></tr>";
 
$out .=
//  "\n</table>"
//  .$this->Skin()->SectionFooter()
  "\n<!-- ^^ $sWhere ^^ -->"
  ;
*/
return $out;
    }
    /*----
      RENDERS: Form controls for credit card name, number, expiration;
dispatches to RenderPayCardAddr_* depending on whether address is
same as shipping or not.
 
Name defaults to recipient name, but is editable.
    */
    protected function RenderPayCardSection($doEdit) {
$out =
  $this->RenderPayCardNumberSection($doEdit)
  .$this->RenderPayCardAddrSection($doEdit)
  ;
 
return $out;
    }
    protected function RenderPayCardNumberSection($doEdit) {
$oForm = $this->FormObject();
$oTplt = $this->PayCardNumberTemplate($doEdit);
$arCtrls = $oForm->RenderControls($doEdit);
$oTplt->SetVariableValues($arCtrls);
return $oTplt->RenderRecursive();
    }
    protected function RenderPayCardAddrSection($doEdit) {
$sCAType = $this->Value_forCardAddrType();
$doOld = ($sCAType == self::KS_CARDADDRTYPE_EXISTING);
if ($doOld) {
    $out = $this->RenderPayCardAddr_Old($doEdit);
} else {
    $out = $this->RenderPayCardAddr_New($doEdit);
}
return $out;
    }
    protected function RenderPayCardAddr_New($doEdit) {
$oTplt = $this->NameAddressTemplate();
$arCtrls = $this->FormObject()->RenderControls($doEdit);
$oTplt->SetVariableValues($arCtrls);
return $oTplt->RenderRecursive();
    }
    protected function RenderPayCardAddr_Old($doEdit) {
    }
 
    // -- FORM I/O: RENDER -- //
    // ++ TEMPLATES ++ //
   
    protected function PayCardNumberTemplate($doEdit) {
$sMsg = $doEdit
  ?"<tr><td colspan=2><span class=note><b>Tip</b>: It's okay to use dashes or spaces in the card number - reduces typing errors!</span></td></tr>"
  :''
  ;
 
$og = vcGlobalsApp::Me();
$wsVisa = $og->GetWebSpec_forVisaCard();
$wsMCard = $og->GetWebSpec_forMasterCard();
$wsAmex = $og->GetWebSpec_forAmexCard();
$wsDisc = $og->GetWebSpec_forDiscoverCard();
 
$sTplt = <<<__END__
<table class="form-block" id="card-address">
  <tr><td align=right valign=middle>We accept:</td>
  <td>
  <img align=absmiddle src="$wsVisa" title="Visa">
  <img align=absmiddle src="$wsMCard" title="MasterCard">
  <img align=absmiddle src="$wsAmex" title="American Express">
  <img align=absmiddle src="$wsDisc" title="Discover / Novus">
  </td></tr>
  <tr><td align=right valign=middle>Card Number:</td>
  <td>[[card-num]] Expires: [[card-exp]] (mm/yy)
  </td></tr>
  $sMsg
</table>
__END__;
return new fcTemplate_array('[[',']]',$sTplt);
    }
   
    // -- TEMPLATES -- //
 
}
</source>

Latest revision as of 01:58, 25 February 2024

Template:Page/code/class

Retrieved from "https://wooz.dev/mw/index.php?title=VbzCart/docs/v1/class/vcCartData_Buyer&oldid=7025"