Services  |  Support  |  Account Admin  |  Contact Us  |  Site Map

The default behavior of the "holostore" command is to create a purchase button:

Sample code:

Resulting InstantStore:

You can customize the appearance of your InstantStore using the following style options:

• Changing the Button Style
• Changing the Form Title
• Adding Text Fields
• Adding Checkbox Fields
• Using Templates
• Persistent Options

Changing the Button Style

• -b text

  The "-b" option can be used to change the label of the InstantStore button. The default label is "Purchase". If your label name includes spaces, be sure to surround the "text" with double quotes as shown below:

• -s verbose|url|debug

  Instead of displaying just a button, we can display a bordered verbose form by specifing the style as "verbose" using the "-s" option:

Instead of either a button or a form, you can generate a link for the purchase by specifying the style as "url", again using the "-s" option:

Using the "-s debug" option will display information which may be helpful in diagnosing problems.

Changing the Form Title

-T title

This option allows you to change the title of the purchase form. By default, the title is "Purchase Item". If you wish to have a title with spaces, be sure to surround the title with double quotes, for example:

Adding Text Fields

-[fF] field

This option allows you to add additional fields to the form that is presented the user when making a purchase. "field" is the name of the field. For required fields, use "-F".

Adding Checkbox Fields

-[cC] field text

This option allows you to add checkbox fields to the form that is presented the user when making a purchase. "field" is the name of the field, and "text" is the text presented after the checkbox. You may include HTML in text" if you wish.

To require that the checkbox be checked before the user is allowed to purchase the item, use "-C".

Using Templates

-t templatefile

You can use this option to further customize the appearance of the resulting InstantStore form. Here, "templatefile" is an HTML document that marks where to place the InstantStore purchase form on the resulting order form page and that specifies design elements, such as background, header, and footer, to be placed arround the HoloStore purchase form.

Here is an example of the "holostore" code with the template option that you would place on your InstantStore Page:

The resulting button, when clicked, will bring up a standard InstantStore form with design elements as specified by the template, "ordertemplate.hst".

The file "ordertemplate.hst" is also constucted like an InstantStore page, but with the following command placed where you would like the template form to appear:

The "templatefile" name must end with the ".holostore" or ".hst" extension.

Click HERE to view the source code of the "ordertemplate.hst" file.

Persistent Options

-persistent

The "-persistent" option set defaults for "holostore" commands that follow it in the file. This option would be used if you had multiple "holostore" commands on a page and wanted these commands to have the same options.

For example, suppose you wanted all your buttons to say "Buy Me" instead of the default "Purchase". You could do this by adding the option "-b "Buy Me"" to all of your "holostore" commands, but this would be tedious.

With the "-persistent" option, you could specify the following:

This command would not create a purchase button, but all "holostore" commands that followed it in your file would inherit the button label "Buy Me".

You can set as many options as you wish with the "-persistent" option. For example, the following command would allow the button label, style, and price to be inherited:

Persistent commands also have the following qualities:

• Individual "holostore" commands can override the defaults set by the persistent option by explicity including the option.
• The last persistent command overides all previous persistent commands, but only for the options explicitly mentioned in the last command.

{holostore -persistent -b "Buy Me" -p 9.95}

{holostore -persistent -p 20.00}

• Any command between these two commands would inherit the button label "Buy Me" and the price 9.95.
• Any commands after the second command would inherit the price 20.00 and the button label "Buy Me".