shopp('customer.billing-country')

Displays the customer billing country drop-down input field, populated with the currently stored billing country.

shopp('customer', 'billing-country', 'options')

@param string $object the object or object.tag combination, if object.tag is used, the tag parameter can be omitted
@param string $tag the tag, can be hyphenated or not. Prefix with 'get' as shorthand for the return=true option
@param mixed $options associative array, or url-style name=value pairs separated by ampersands (&). Each pair is passed to the theme api tag as an option.
@returns void by default, billing country drop-down menu string if return option is used.

Alternative Forms

shopp('customer.billing-country', 'options');

Description

Displays the customer billing country drop-down input field, populated with the currently stored billing country.

Universal Options

All Theme API calls have these options.

  • return: when set to true, 1, or on, this option forces the tag to return the value instead of displaying/echoing the value to the page. Alternatively, prefix the tag parameter with get to get the same effect. All theme api tags that return a boolean value will return by default.
  • echo: when set to false, 0, or off, this option forces the tag to display the value to the page. This is the default for all non-boolean tags.
  • is: when set to true, 1, or on, this option will evaluate the return of the theme api call as a boolean true or false value. See how values are converted to boolean.

Options

The following options are valid.

  • mode: (default null) set to mode=value to display the current billing country stored for the customer.
  • selected: (defaults to the base country) set to a two-letter country code to set the current country in the option menu.

Examples

// display the current customer's billing country drop-down menu
shopp('customer.billing-country');
// display the current customer's billing country drop-down menu
// set US as the selected country
shopp('customer.billing-country','selected=US);
// display the current customer's billing country
shopp('customer.billing-country','mode=value');
// get the current customer's billing country
$country = shopp('customer.get-billing-country','mode=value');

See Also

You must be logged in to post a comment.

© Ingenesis Limited. Shopp™ is a registered trademark of Ingenesis Limited.

Skip to toolbar