Step 3: Uploading the Snapshot and Preparing for Editing

In this step, you need to upload the site snapshot to the Presence
Builder server and convert it to a ZIP archive for further editing.

To upload a snapshot to the server and convert it to a ZIP package:

1. Connect to the server using SSH or a Remote Desktop connection.

2. Upload your snapshot file to the server. You can upload it, for
   example, to the /home directory.

3. Convert the snapshot file to a ZIP archive by issuing the following
   command:

   /usr/local/psa/bin/sw-engine-pleskrun /usr/local/sb/utils/snapshot2wst.php --create --snapshot=<source_snapshot_file.ssb> --file=<resulting_ZIP_archive.zip> --templateCategory=<category_code> --templateCode=<topic_code>
   

   Where:

   <source_snapshot_file.ssb> is the path to the source snapshot
   archive in the SSB format that you uploaded to the server. For
   example: /home/source-snapshot.ssb.

   <resulting_ZIP_archive.zip> is the location and file name of the
   resulting ZIP package. For example: /home/package-file.zip.

   <category_code> is an identification code of the topic category.
   You can specify a name of a new category if you want to create it, or
   specify the code of an existing category. Do not use white spaces in
   category names. You will be able to set a human-readable name for
   this category later, by editing a file in the topic archive
   (/resources/locale/en_US/SiteTemplates.lng).

   The following is a list of codes for the default categories present
   in Presence Builder 11.1.

<topic_code> is an identification code for the new topic. Be sure to
use a unique name that does not coincide with an already existing one,
otherwise, your custom topic will overwrite an existing topic. Do not
use white spaces in topic codes. You will be able to set a
human-readable name for this topic later, by editing a file in the topic
archive
(/resources/locale/en_US/site_templates/<topic_code>/info.lng).

Note that there is also the option --useSnapshotDesign. It can be
used to indicate that the styles, colors, layout, and images used in the
site snapshot must be applied to the new website topic, and should not
be overridden when new sites are generated based on that topic.

After the ZIP archive is created, you can unpack it for further editing,
or you can edit the files without unpacking if your ZIP archive manager
supports that.