## 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 the store root/ directory:
  - Upload a default stylesheet file
  - Upload a favicon image - your marketing icon in your customers' browser address bars, favorites and tabs.
- In the store templates/ directory:
  - Upload website header and footer
  - Edit or upload an HTML website header
  - Add offline payment conditions description. To add or adjust the offline payments description, edit this file and save the changes.
  - Customize website pages preloader (a special popup that appears while site pages are being loaded).
- In the store images/ directory:
  - Upload site logotype `logo.gif`.
  - Upload the icon used by site pages preloader `loading.gif`.

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.

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.

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:

- Name. The name of a file or directory.
- Size. A file size. For files without default location specified in customization.xml the Size and Date are not shown.
- Description. A file short description.
- Date. The date a file or directory has been modified the last time.

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:

- Make Directory. Add a new directory to your website under your current working directory;
- Upload File.Upload a file to your system;

To perform an action with a file or a directory:

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

- Edit. Edit a file contents.
- Properties. View file or directory size, file type, etc.
- Rename. Rename and/or move file or directory. Select a file or directory and click Rename. Enter the path and name of the new location of the file or directory, and click OK to save changes;
- Copy. Copy a file or a directory to another location. Select an object for copying then click Copy. You will be offered to select the destination and copying options.
- Move. Move a file or a directory to another location. Select an object for moving then click Move. You will be offered to select the destination and moving options.
- Pack. Pack a file or a directory. Select file(s) by selecting check-box to the left of file name. Then click Pack. You will be offered to select the packaging options.
- Unpack. Extract a file or a directory from an archive. Select file(s) then click Unpack. You will be offered to select the packaging options.
- Delete. Remove a file or directory.

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:
   - Do not upload if a file with the same name exists in the destination directory - to prevent overwriting existing files with a new ones in case exiting files have same names as new ones.
   - Skip all the files that exist in the destination directory. to prevent overwriting existing files with a new ones in case exiting files have same names as new ones.
   - Overwrite all the files in the destination directory - to overwrite files existing in destination directory in case these files have the same names as filed being uploaded.
4. Click the OK button to upload a file.

Please send us your feedback on this help page