Previous Topic

Next Topic

Customizing Store Using File Manager

The File Manager integrated into the Store Manager is a quick-start tool for store customization. It allows performing a basic and simple customization of the store and go live as soon as possible.

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 allows customizing the basic Store files and uploading a static content of vendor's website:

In addition, it is possible to use SSI.

Customized default files are shown on Store pages and you can preview the Store by entering your server name (vendor management node hostname or reseller hiding hostname) into your browser.

To preview the site content, enter into your browser your server name with the following path appended:

/hspc/path_to_file

where path_to_file must be replaced with an actual path to a file starting from customization root. For example, if you have created a custom /site directory and uploaded a content.html file, then to preview this content you must enter into your browser:

http://your_server_name/hspc/site/content.html

where your_server_name must be replaced with actual hostname of your Parallels Business Automation - Standard server.

You can add a standard store templates to your site pages using SSI.

For example, you can include the standard header and footer into your site page (index.html or index.shtml - you can use both extensions):

<html>

<head>

<title>My Index Page</title>

</head>

<body>

<!--#include virtual="templates/header.inc" -->

My Page Content

<!--#include virtual="templates/footer.inc" -->

</body>

</html>

Important notes regarding SSI: to preview SSI config please explicitly enter the page URL in your browser, do not use the link shown at the File Manager screen, because Apache does not actually process this content. Please remember that you cannot include customizable files that have not been customized yet, i.e., the files that are shown in italic font at the File Manager screen. To make it possible for a file to be included, you must edit it so it will be saved in your personal customization directory. Running executable modules using SSI directives is not possible.

By default, the File Manager screen shows the names of Store files and directories that can be customized. These names are not a real links, but only hints showing the Store files and directories names. Such a 'symbolic' links are shown in italic font. The italic font a file or directory is shown means that a file or directory have not been customized yet, so there is no real files in the customization directory /var/opt/hspc-frontend/vendor/accountID.

Note: The set of Store files available for customization is defined by vendor. Please refer to the Parallels Business Automation - Standard SDK (HTML or PDF document) for details.

To copy a default file into your customization directory, check the box next to a file name (directories cannot be edited) and click Edit. To save a default file in your customization directory, you do not need to change a file content. Just click OK and a file will be considered as customized and saved.

As soon as you customize the default files or edit them, the custom files or copies of default files are saved in the personal directory /var/opt/hspc-frontend/vendor/accountID. Customized files are shown in normal font.

Default files are not affected by customization performed using the File Manager. You can restore defaults simply by deleting custom files or directories. As the defaults are restored, files' and directories' names become shown in italic font again.

File Manager. Images have been customized. Other files are default.

Since the original default files cannot be renamed or customized, a default file with its original name (shown in italic font) appears each time you rename it.

File Manager. Default file and directory have been renamed.

Files and directories names are built in the Store code and thus, it is critical for Store functionality that you follow the files and directories naming convention. As soon as you change the default name of customized file or directory, the File Manager detects that there is no customized file with correct name and immediately switches to the default file that always stays named correctly. At the screen it looks like a not customized default file or directory (name shown in italic font) has appeared, as this is shown on the screenshot above.

In respect to options and controls provided, the store File Manager is similar to an ordinary file manager, except for access permissions setup. Permissions are not needed here. User apache is set as files/directories owner by default and this ownership cannot be changed.

The list of files and directories displays the following:

To open a specific directory click a directory name. The path at the top of the list shows the current location. To view a file contents, click on its name.

The buttons at the top of the files and directories list serve for the following actions:

To perform an action with a file or a directory:

Check the box next to a file or a directory name and use controls:

To create a directory:

  1. Click the Make Directory button.
  2. Fill the form that appears on the screen:
    1. Type the directory name into the Directory name field.
    2. Select the correct set of permissions using checkboxes. If you are not sure about permissions setup, then leave the default permissions.
  3. Click the OK button.

To upload a file:

  1. Change the location to the directory you want to upload a file into.
  2. Click the Upload File button.
  3. Fill the form:
    1. Enter the file name and location on your local computer in the File to Upload field. Or click the Browse... button to locate the file.
    2. You can rename the file on uploading. Type the new file name in the New file name field.

      Note: You can upload up to 15 files at once. To upload several files, select the number of files from the Upload_files at once drop-down menu and click the Display button. The required number of fields to enter file name(s) to be uploaded appears on the screen.

    3. Specify the rules to be applied to the files to be uploaded in case other files are already exist in the destination directory. Set the option button to one of the following:
  4. Click the OK button to upload a file.

Please send us your feedback on this help page