Jump to: navigation, search

The checkout shopp() tags are used to build the checkout form. The checkout form is defined in the checkout.php template file and used specifically for local checkout processes - payment processors that handle payments on the host website not on a remote website. Remote payment processors, like PayPal Express and Google Checkout skip the checkout.php form altogether.

Contents 1 Utility Tags 1.1 url 1.2 function 1.3 error 1.4 cart-summary 1.5 order-data 1.6 submit 1.7 confirm-button 1.8 local-payment 1.9 xco-buttons 2 Login Fields 2.1 loggedin 2.2 notloggedin 2.3 email-login 2.4 password-login 2.5 login-button 3 Customer Information Fields 3.1 firstname 3.2 lastname 3.3 email 3.4 loginname 3.5 password 3.6 confirm-password 3.7 phone 3.8 customer-info 4 Shipping Tags 4.1 shipping 4.2 shipping-address 4.3 shipping-xaddress 4.4 shipping-city 4.5 shipping-state 4.6 shipping-postcode 4.7 shipping-country 4.8 same-shipping-address 5 Billing Tags 5.1 billing-address 5.2 billing-xaddress 5.3 billing-city 5.4 billing-state 5.5 billing-postcode 5.6 billing-country 6 Billing/Payment Fields 6.1 billing-card 6.2 billing-cardholder 6.3 billing-cardexpires-mm 6.4 billing-cardexpires-yy 6.5 billing-cardtype 6.6 billing-cvv

Utility Tags

url

Overview

<?php shopp('checkout','url'); ?>

For all but the Test Mode payment gateway, this tag outputs a web address that points to the checkout page of the current store over a secure (SSL) connection by using the https:// protocol prefix.

Options

• None

function

Overview

<?php shopp('checkout','function'); ?>

Includes a number of hidden inputs required for the proper operation of the checkout process.

Options

• None

error

Overview

<?php shopp('checkout','error'); ?>

Displays any error messages returned from the payment processor after the shopper attempts to submit their order for processing.

Options

• show: Default is message. Set to code to display the error code instead of the error message.

cart-summary

Overview

<?php shopp('checkout','cart-summary'); ?>

Renders the cart summary as defined in the summary.php template file.

Options

• None

order-data

Overview

<?php shopp('checkout','order-data'); ?>

Displays a custom text field for collecting any number of custom fields with the order.

Options

• name: Specifies the name of the field to be tracked with the order.
• type: Specifies the type of field. Accepts text,password,checkbox,radio,hidden
• Note: Name is required with type.
• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information. The mode option overrides the type option.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

submit

Overview

<?php shopp('checkout','submit'); ?>

Displays a submit button to send the checkout form to Shopp for processing. Depending on store settings, the order will be reprocessed for changes in pricing such as taxes, final shipping, and show a confirmation screen before the order is submitted to the payment engine, or the order will be handed off directly to a payment gateway for processing.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

confirm-button

Overview

<?php shopp('checkout','confirm-button'); ?>

Displays a submit button that submits the order to processed by Shopp and directing the shopper to a final order confirmation screen that allows them to verify their order for mistakes before processing it.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

local-payment

Overview

<?php if (shopp('checkout','local-payment')) { … } ?>

Tests whether a local checkout process is available or not. Typically this is used to show or hide the link to the local checkout form.

Options

• None

Examples

Display link to checkout

<?php if (shopp('checkout','local-payment')): ?>
<a href="<?php shopp('checkout','url'); ?>" class="right">Proceed to Checkout &raquo;</a>
<?php endif; ?>
Displays a link to the checkout form if a local payment system is enabled.

xco-buttons

Overview

<?php shopp('checkout','xco-buttons'); ?>

Displays remote checkout system buttons such as PayPal Express or Google Checkout if they are enabled in Payment Settings.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

Login Fields

DEPRECATED

loggedin

Overview

DEPRECATED: Replaced by shopp('customer','loggedin')

<?php if(shopp('checkout','loggedin')) { … } ?>

Evaluates to either true or false to represent whether the shopper is logged in to their account.

Options

• None

notloggedin

Overview

DEPRECATED: Replaced by shopp('customer','notloggedin')

<?php if(shopp('checkout','notloggedin')) { … } ?>

Evaluates to either true or false to represent whether the shopper is not logged in to their account.

Options

• None

email-login

Overview

DEPRECATED: Replaced by shopp('customer','account-login')

<?php shopp('checkout','email-login'); ?>

Renders a text field used to take an e-mail address for identifying the account of the user during the login process.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

password-login

Overview

DEPRECATED: Replaced by shopp('customer','password-login')

<?php shopp('checkout','password-login'); ?>

Renders a password field used to take the password for authenticating the credentials of a user during the login process.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

login-button

Overview

DEPRECATED: Replaced by shopp('customer','submit-login')

<?php shopp('checkout','login-button'); ?>

Displays a button for submitting the login fields (email-login and password-login) for processing the user's credentials and logging them in. A successful login pulls previously entered account information to populate the other checkout form fields.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

Customer Information Fields

firstname

Overview

<?php shopp('checkout','firstname'); ?>

Displays a text field for taking the first name of the shopper.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

lastname

Overview

<?php shopp('checkout','lastname'); ?>

Displays a text field for taking the last name of the shopper.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

email

Overview

<?php shopp('checkout','email'); ?>

Displays a text field for taking the first name of the shopper.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

loginname

Overview

<?php shopp('checkout','loginname'); ?>

Displays a text field for the login name the customer would like to use for their account. Only used when Shopp is set to use accounts integrated with WordPress logins in the Checkout Settings.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

password

Overview

<?php shopp('checkout','password'); ?>

Displays a password field for the shopper to create a new password when creating a new account during checkout.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

confirm-password

Overview

<?php shopp('checkout','confirm-password'); ?>

Displays a password field for the shopper to confirm that the password they entered in the password field matches to ensure they entered the password they wanted to enter correctly.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

phone

Overview

<?php shopp('checkout','phone'); ?>

Displays a text field for the customer's phone number.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

customer-info

Overview

<?php shopp('checkout','customer-info'); ?>

Displays a field of a specified type with a specific name for taking and tracking custom information about the customer.

Options

• name: Specifies the name of the field to be tracked with the customer details.
• type: Specifies the type of field. Accepts text,password,checkbox,radio,hidden
• Note: Name is required with type.
• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information. The mode option overrides the type option.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

Shipping Tags

shipping

Overview

<?php if(shopp('checkout','shipping')) { … } ?>

Used to test whether the current shopping cart/order has items that need to be shipped to a physical address.

Options

• None

Examples

Show shipping inputs if shipping required

<?php if (shopp('checkout','shipping')): ?>
	<div class="inline"><?php shopp('checkout','same-shipping-address'); ?></div>
	</li>
	<li class="half right" id="shipping-address-fields">
		<label for="shipping-address">Shipping Address</label>
		<div><?php shopp('checkout','shipping-address','required=true&title=Shipping street address'); ?><label for="shipping-address">Street Address</label></div>
		<div><?php shopp('checkout','shipping-xaddress','title=Shipping address line 2'); ?><label for="shipping-xaddress">Address Line 2</label></div>
		<div class="left"><?php shopp('checkout','shipping-city','required=true&title=City shipping address'); ?><label for="shipping-city">City</label></div>
		<div class="right"><?php shopp('checkout','shipping-state','required=true&title=State/Provice/Region shipping address'); ?><label for="shipping-state">State / Province</label></div>
		<div class="left"><?php shopp('checkout','shipping-postcode','required=true&title=Postal/Zip Code shipping address'); ?><label for="shipping-postcode">Postal / Zip Code</label></div>
		<div class="right"><?php shopp('checkout','shipping-country','required=true&title=Country shipping address'); ?><label for="shipping-country">Country</label></div>
	</li>
<?php else: ?>
	</li>
<?php endif; ?>

shipping-address

Overview

<?php shopp('checkout','shipping-address'); ?>

Displays a text field for the street address of the shipping destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

shipping-xaddress

Overview

<?php shopp('checkout','shipping-xaddress'); ?>

Displays a text field as an additional line for the street address of the shipping destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

shipping-city

Overview

<?php shopp('checkout','shipping-city'); ?>

Displays a text field for the city of the shipping destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

shipping-state

Overview

<?php shopp('checkout','shipping-state'); ?>

Displays a drop-down menu (HTML <select>) for the state/province of the shipping destination. The menu will change according to the currently selected country in the shipping-country field. This field can be omitted when all of the target market countries do not use regional states or provinces in shipping address

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

shipping-postcode

Overview

<?php shopp('checkout','shipping-postcode'); ?>

Displays a text field for the postal code of the shipping destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

shipping-country

Overview

<?php shopp('checkout','shipping-postcode'); ?>

Displays a drop-down menu (HTML <select>) field for the country of the shipping destination. The menu is populated by the countries selected as target markets in Shopp's General Settings.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• selected: Specify the default selected country in the menu by using the two-letter country ISO code.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

same-shipping-address

Overview

<?php shopp('checkout','same-shipping-address'); ?>

Displays an interactive checkbox toggle to use the same address entered as the billing address for the shipping address. This input is tied to JavaScript behaviors that automatically hide the shipping fields (if the default template markup is retained) and copy data from the billing address fields to the shipping address fields.

Options

• label: Default is set to Same shipping address. Used to specify a custom label for the same shipping address control.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

Billing Tags

billing-address

Overview

<?php shopp('checkout','billing-address'); ?>

Displays a text field for the street address of the billing destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-xaddress

Overview

<?php shopp('checkout','billing-xaddress'); ?>

Displays a text field as an additional line for the street address of the billing destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-city

Overview

<?php shopp('checkout','billing-city'); ?>

Displays a text field for the city of the billing destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-state

Overview

<?php shopp('checkout','billing-state'); ?>

Displays a drop-down menu (HTML <select>) for the state/province of the billing destination. The menu will change according to the currently selected country in the billing-country field. This field can be omitted when all of the target market countries do not use regional states or provinces in billing address

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-postcode

Overview

<?php shopp('checkout','billing-postcode'); ?>

Displays a text field for the postal code of the billing destination.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-country

Overview

<?php shopp('checkout','billing-postcode'); ?>

Displays a drop-down menu (HTML <select>) field for the country of the billing destination. The menu is populated by the countries selected as target markets in Shopp's General Settings.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• selected: Specify the default selected country in the menu by using the two-letter country ISO code.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

Billing/Payment Fields

billing-card

Overview

<?php shopp('checkout','billing-card'); ?>

Displays a text field for the credit card number.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information. The credit card number only displays the last 4 digits of the card. The rest of the numbers are replaced with X;
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-cardholder

Overview

<?php shopp('checkout','billing-cardholder'); ?>

Displays a text field for the name of the credit card holder on the credit card.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-cardexpires-mm

Overview

<?php shopp('checkout','billing-cardexpires-mm'); ?>

Displays a text field for the month portion of the credit card's expiration date.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-cardexpires-yy

Overview

<?php shopp('checkout','billing-cardexpires-yy'); ?>

Displays a text field for the year portion of the credit card's expiration date.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-cardtype

Overview

<?php shopp('checkout','billing-cardtype'); ?>

Displays a drop-down menu for the accepted credit/debit card types.

Options

• mode: Default is (not set). Set this option to value to display the value of the field instead of rendering an input element. This is useful for showing the currently entered value to the user to confirm their information.
• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.

billing-cvv

Overview

<?php shopp('checkout','billing-cvv'); ?>

Displays a text field for the card verification value, a number usually printed on the back of the card to prove the card is in the presence of the shopper.

Options

• accesskey: Allows you to specify an HTML access key.
• alt: Useful for providing alternative text for the element.
• checked: Marks a checkbox field as checked causing it to display toggled on. Be mindful that some shopp() fields will have internal functionality that may override this setting.
• class: Adds a CSS class to a field.
• disabled: Disables the field from being changed by the user and prevents its value from being submitted with the form.
• format:
• minlength: Specifies a required minimum amount of information that must be entered in the field before the form will submit successfully. If the minimum is not met, an error is displayed that uses the value set for the title option as the description of the field.
• maxlength: Limits the amount of characters that the user may enter on text and password type fields.
• readonly: Prevents the user from changing the input or control, but the value is still submitted with the form.
• required: A boolean value that forces the field to have a non-empty value before the form can be successfully submitted. If the value is left empty when the form is submitted an error message is displayed that uses the value specified in the title option as the description of the field.
• size: Specifies the width of the field in pixels except when the field is a text or password field. For text and password fields, the value of size specifies the width in number of characters.
• tabindex: Specifies the position of the element in the tabbing order for the current document.
• title: Provides advisory information about the element.
• value: Specifies the initial value for the element. Note that shopp() fields may override your setting in some circumstances.