Product Field List

Refer to the Adding Products topic for general information about products.

General Info

Product ID: A unique numeric system-generated identifier assigned to the Product by SOLO Server at the time you add the Product. This field cannot be modified.
Product Name: Any name you want to use for this Product.
Product Image: An image of the Product, in either .gif or .jpg format, which must be uploaded to SOLO Server. To upload an image, click the Browse... button and locate the image file to upload, then click the Save button. Once an image is uploaded, a thumbnail view of that image will be displayed. To display the full size version of the image, click the "View Full Size Image" link. To delete the image, click the "Remove Image" link.
Short Description: An abbreviated description of the product. (This field is reserved for future catalog enhancements and is not currently used.)
Description: A full description of the product.
Category: SOLO Server allows creating Product Categories and assigning categories to each Product ID. These categories can be used in the Shopping Cart's catalog page to allow filtering by category. Please refer to Configuring Categories for more information. Note that multiple categories can be selected.
Display Index: Display index for sorting in the Product Catalog.
Page Title: The title to display on the Product Catalog detail page.
Meta Description: The text for the Description meta tag on the Product Catalog detail page.
Meta Keywords: The text for the Keywords meta tag on the Product Catalog detail page.
Latest Version: The latest available version of the Product ID. This optional field is used for display purposes in the cart and Customer License Portal; it is also referenced for informational purposes during order processing and License ID generation activities. The Latest Version field, if specified, is also recorded in the Download Log when downloads of the purchased software are performed via the SOLO Server ESD facility. The format of the version number is NNNNN.NNNNN.NNNNN.NNNNN, where N represents a non-negative integer ranging from 0 to 99999, inclusive. No leading zeroes are required. Please note that all four version elements must be specified to avoid the generation of an error message. For version numbering schemes using less than four version elements, use trailing zeroes (e.g., for version 3.0, specify 3.0.0.0).
Latest Version Shipping: The latest version of the Product ID that is available to be shipped. This field is generally for informational purposes only, and is primarily used by SOLO Server Authors who offer CD (or other physical media) versions of their software. On many occasions, due to manufacturing lead times or other external factors, the version of the physical software in stock may lag behind the ESD version. The format of the version number is NNNNN.NNNNN.NNNNN.NNNNN, where N represents a non-negative integer ranging from 0 to 99999, inclusive. No leading zeroes are required. Please note that all four version elements must be specified to avoid the generation of an error message. For version numbering schemes using less than four version elements, use trailing zeroes (e.g., for version 3.0, specify 3.0.0.0).

Order & License Information

EULA

The End User License Agreement for the product. Click Edit to enter or modify the EULA. See Product EULA.

Storefront Template

The custom markup template to use for the shopping cart Customized Storefront. Note that this only applies if running the shopping cart in Single Order Mode.

Order Confirm HTML

This markup is displayed as part of the invoice line item on invoices, as well as on the Customer License Portal License Details page (unless overridden by the Customer License Portal HTML outlined below). Order Confirm HTML instructions can be specified at both the Product and the Product Option levels. Both values (if present) will be concatenated. The following variables can be used in this HTML:

[varMerchantDispName] - The merchant account name that will appear on the customer's credit card statement. If no merchant account is associated with the order, the SOLO Server Author's company name will be used.
[varLicenseID] - The License ID assigned to this purchase.
[varPassword] - The customer Password. Important Note: It is strongly recommended this not be used. In a future version of SOLO Server, the [varPassword] search/replace field will be updated to replace this with an empty value for customers who have chosen their own password.
[varActivationPassword] - The license Activation Password.
[varOriginalQS] - The original query string which initiated the order through the cart.
[varQOrdered] - The quantity ordered.
[varLicenseCounter] - The License Counter value from the license record.
[varCustomerID] - The Customer ID.
[varLatestVersion] - The Latest Version field from the product.
[varOriginalLicenseID] - The License ID of the original license that this license was used to renew or upgrade through the rules engine.
[varProductID] - The Product ID.
[varProductName] - The product name.
[varProdOptionID] - The Product Option ID.
[varProdOptionName] - The product option name.
[varDistributorID] - The Distributor ID, if present.
[varEnteredDate] - The license entered date.
[varExpirationDate] - The license download until date.
[varSalePrice] - The sale price of the license.

Use of the Order Confirm HTML field is completely optional. If you decide to implement its functionality, however, please be aware that you should use <br> tags for line spacing within the HTML instead of <p> tags, as <p> tags will be expunged from the online invoice. Also, please note that any <hr> tags will be arbitrarily replaced with <br> tags.

Order Confirm Email

Selects which Mailing is to be generated when an order is placed. Order confirmation e-mails can be defined at the Author level and can be overridden at the Product level. Refer to Mailing Field List for more information on creating custom e-mail notifications to be sent when orders are placed. Note that this e-mail is only sent for the single order process. The cart process uses its own invoice e-mail.

Customer License Portal HTML

This markup is displayed on the License Details page in the Customer License Portal, and will override any markup specified in the Order Confirm HTML. Customer License Portal HTML instructions can be specified at both the Product ID and the Product Option levels. Both values (if present) will be concatenated. The following variables can be used in this HTML:

[varMerchantDispName] - The merchant account name that will appear on the customer's credit card statement. If no merchant account is associated with the order, the SOLO Server Author's company name will be used.
[varLicenseID] - The License ID assigned to this purchase.
[varPassword] - The customer Password. Important Note: It is strongly recommended this not be used. In a future version of SOLO Server, the [varPassword] search/replace field will be updated to replace this with an empty value for customers who have chosen their own password.
[varActivationPassword] - The license Activation Password.
[varOriginalQS] - The original query string which initiated the order through the cart.
[varQOrdered] - The quantity ordered.
[varLicenseCounter] - The License Counter value from the license record.
[varCustomerID] - The Customer ID.
[varLatestVersion] - The Latest Version field from the product.
[varOriginalLicenseID] - The License ID of the original license that this license was used to renew or upgrade through the rules engine.
[varProductID] - The Product ID.
[varProductName] - The product name.
[varProdOptionID] - The Product Option ID.
[varProdOptionName] - The product option name.
[varDistributorID] - The Distributor ID, if present.
[varEnteredDate] - The license entered date.
[varExpirationDate] - The license download until date.
[varSalePrice] - The sale price of the license.

Use of the Customer License Portal HTML field is completely optional.

Download URL

A URL for downloading the software product.

Screen Shot

This field is no longer used.

Info URL

A URL to an information page for the Product Option. This is used by the upsell table on the cart to offer a pop-up link to obtain additional information about the product. The page entered here should be designed for a 400x400 pop-up window.

Image URL

A URL to an image for the option. (This field is currently not used, and is reserved.)

Auth S/N Type

This is an advanced option. For more information, contact us.

Author S/N Text

This is an advanced option. For more information, contact us.

Author S/N Next

This is an advanced option. For more information, contact us.

Author S/N Inc.

This is an advanced option. For more information, contact us.

License Labels

A custom label set for the user-defined fields displayed on the User-Defined Fields tab on the License Details page. See Customizing License Labels for more information. When editing a product, you can click the Configure License Labels link to open the license labels configuration page.

Trial Information

Trial URL: If you have a trial version of your software product, specify the complete URL to access the trial or the trial download request form. Example: http://www.softwarekey.com/plus/demo.asp. This supports a [varLatestVersion] search/replace parameter which will be replaced with the current value of the Latest Version field on the product.
Trial Text HTML: Used with Trial Tracking Service. Contains the HTML that will be displayed to the user when they successfully complete the trial request form. This HTML must contain the link to the file to download. This supports a [varLatestVersion] search/replace parameter which will be replaced with the current value of the Latest Version field on the product.
Trial Welcome Mailing: Used with Trial Tracking Service. The mailing to send to a prospective customer when the request a trial.
Trial Teaser Mailing: Used with Trial Tracking Service. The mailing to send to a prospective customer a specified number of days after requesting the trial.
Trial Teaser Days Back: Used with Trial Tracking Service. The number of days back after requesting the trial to send the trial teaser mailing.
Register URL: A URL to a page where the customer can register the trial version of the software product.
Register Mailing: Specifies the mailing to be sent to the customer once the trial version of the software product is registered.

Other Information

LF Password: Shorthand for License File Password. This field is currently not used, but is reserved for future use.
Custom License Options: This field is currently not used, but is reserved for future use.
Custom Data: Additional data to be included within the Product/CustomData element in the XML License File when using Protection PLUS 5 SDK. This can be string or XML data.
Use Test CC No.: Whether or not the use of the test credit card number is enabled for Testing the Order Process.
Enabled: Set this flag to True to enable the product. If not enabled, any cart order containing the product will be declined, and the product will be hidden from ordering pages and drop-down menus. Please note that disabling a product will also automatically set it to Hidden.
Hidden: Enable to "hide" this product from the online catalog that is displayed to customers.
Include in Ticket Log: Check this box to have the product show up in the ticket log product drop down.
Product Activation Mailing: Mailing sent to the customer when the product is activated. This e-mail will also be sent by postregdata.asp if the customer e-mail is blank prior to registration and the license has only one activation logged.

Tabs

Current Options: Adding a Product and Product Option

Upsell Product Options: Configuring Upsells can increase revenue by attempting to persuade a customer to purchase either a more expensive item or related additional items

Product Updates: Product Updates allow users of a product to be automatically notified of a new version when one becomes available.