Previous Topic

Next Topic

Locate topic in Contents

Selecting Store Files Customizable via Web Interface

Using the File Manager, provider can quickly upload some basic templates and images, and resellers can use the store File Manager as a place to start and a default tool to perform their own customization.

File Manager provides the same customization capabilities both for provider and resellers. However, only provider (or store installation owner) can define what files can be customized using the File Manager.

Store files and directories allowed for customization

The File Manager screen shows the customizable Store files and directories. The set of files and directories allowed for customization using the File Manager is defined in the special file customization.xml located in the

/var/opt/hspc-frontend/vendor/

directory.

The customization.xml file defines what Store files and directories are to be customizable using the File Manager for all vendors that use default Store installation.

By default, the customization.xml file allows customizing only the basic Store files and looks as follows:

<?xml version="1.0" encoding="UTF-8" ?>

<customization>

<file name="stylesheet.css" editable="1" default="/var/opt/hspc-frontend/stylesheet.css">Stylesheet of PHP pages.</file>

<directory name="templates">

<file name="header.inc" editable="1" default="/var/opt/hspc-frontend/templates/header.inc">HTML code for page header.</file>

<file name="footer.inc" editable="1" default="/var/opt/hspc-frontend/templates/footer.inc">HTML code for page footer.</file>

</directory>

<directory name="images">

<file name="logo.gif" default="/var/opt/hspc-frontend/images/logo.gif">Logo for default header of PHP pages.</file>

</directory>

</customization>

Tag

Used For

<customization>

Opens and closes the customizable files description.

<file>

File description

</file>

Add a customizable file. Parameters:

  • name - file name.
  • editable - whether a file can be edited (=1) or not (=0).
  • default - the default file location starting from the root directory.

<directory>

Directory description

<file> </file>

</directory>

Add a customizable directory. Parameters:

  • name - directory name.

Files located inside a directory must be specified using the <file> tag inside the <directory> tag.

Upload custom files or use the default ones

The root directory shown at the File Manager screen is actually the customization root, i.e.:

/var/opt/hspc-frontend/vendor/accountID

where the AccountID is replaced with an actual ID or Provider account or a reseller account.

Files and directories shown are only the hints saying to a customer that these particular files with these particular names are used for Store pages. These 'hint' files and directories are shown in italic font.

Store Files Location

A vendor (i.e., a person who has access to all Store files and templates) can add into the Store code some more features (for example, a banner) and leave a place for a custom file in this custom code.

Having been uploaded, a banner file builds into a banner code and enabled banner appears at a Store page. Using the customization.xml file you can specify such files. In this case, a user will see only the default file name and its description at the File Manager screen. This will be a hint for a customer that the default file does not actually exist, but there is a place or a piece of code for this file in one of the Store templates. For example, let us continue with banner. A customer uploads a banner file and the banner appears on a Store pages. To add hints about files that can be uploaded additionally, do not specify a file location (<default> tag) in a file definition. For example,

<file name="banner.gif">Place this file here to enable banner.</file>

Please send us your feedback on this help page