Integrating PHP Store With Existing Website

This section describes how to place pre-selected hosting packages (domains, subscription periods, purchase steps) composed in the Parallels Business Automation - Standard PHP store into a ready website.

Using the parameters described below, it is possible to construct an URL or FORM data, that can be placed at a ready website. This URL redirects a customer to a particular step of PHP store.

The URL is to be composed as follows:

http://<PHP_Store_hostname>/hspc/index.php?action=preselect&<parameter=value><parameter=value><parameter=value>....

where <PHP_Store_hostname> is hostmane of server where PHP store is deployed, and the sequence <parameter=value> is a chain of parameters that set a hosting package.

Pre-selected parameters are divided into two classes:

• action - should be always named as 'action' and pass parameters to PHP Store using the GET method, by this parameter the index.php will decide what it should do.
• set - should always start with the ps_ prefix,i.e., pre-select to prevent mixing it with parameters selected by a customer. Every parameter is unique. If one parameter contains a list of values (like applications set), values in a list are to be joined by some delimiter, for example, comma, semicolon, pipe.

List of parameters and their values:

action

1. <action=preselect> (always should be set)

domain scope set

1. [ps_domain_name=domain-name.tld] (well-formed domain name)
2. [ps_tld=net|com|org|...] (supported by plugin tld)
3. [ps_domain_names=domain-name1.tld domain-name2.tld ...] (list of well-formed domain names, separated by space(s))
4. [ps_domain_selection_type=single|multi] (default - 'single')
5. [ps_domain_selection] (deprecated)
6. <<ps_dm_action=register_new|reg_transfer|domain_pointer>> (always should be set, if you want to check something)
7. [ps_dm_period=1|2|3|5|...] (Domain Registration period in years, can differ from one plug-in to another, default - first set up period)

hosting package scope set

1. [ps_series_key=1|2|3|...] (Hosting Plan series key)

   Note: To know out a hosting plan series key, log in to the Provider Control Center, go to Billing Director > Product Manager > Hosting Plans. Select a hosting plan you want to link to your website, then select the General Settings tab within a hosting plan properties. See the Series Key field value.

2. [ps_period=2592000|7776000|15552000|31104000|...] (Hosting Plan period, in seconds, default - first set up period)
3. [ps_for_trial=0|1] (trial registration, default - 0)

Legend:

[] - optional parameter

<> - mandatory parameter

<<>> - mandatory parameter in scope

Example of URL

For example, your store hostname is mystore.com. Then, the URL that redirects a customer to a particular hosting package with pre-selected subscription period of one month looks as follows:

http://mystore.com/hspc/index.php?action=preselect&ps_series_key=5&ps_period=31104000

In our example, the hosting plan series key is 5.

Please send us your feedback on this help page