Pages

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 7.3

...

  1. Create the modification through the Frosmo Control Panel or the Graniitti API.
  2. Download the content from the Frosmo back end with FProxy.
  3. Edit and test the content.
  4. Upload the edited content back to the Frosmo back end with FProxy.

You can also use FProxy to automatically upload changed content.

Downloading modification content

Use the fproxy download command to download the content of a single modification or all modifications from a site. The content includes templates and template defaults, if defined.

...

  1. In your terminal, go to the sites directory. For example, the following command opens the /dev/my_sites subdirectory in your home directory:

    Code Block
    languagebash
    themeRDark
    cd ~/dev/my_sites


  2. Run the fproxy download command. For more information, see the command syntax and examples below.
Info

If a modification includes image includes image variations or a tracking-type comparison group, these (a deprecated feature of the Frosmo Platform) or variations whose content type is Original content, these variations are not downloaded, since  since they do not contain no any code content.

For more information about the directories and files that FProxy creates, see FProxy files and directories.

Command syntax

Code Block
languagebash
themeRDark
fproxy download <site_directory> <modification_id|all> [--ws=<workspace_id>] [--debug] [--force]

The modification ID (and thereby the modification) must already exist in the Frosmo back end. If it does not, the command fails with an error message about the ID not existing. If used, the same also applies to the workspace ID.

Command examples

Download the content of modification 33556 from the site shop_company_com:

...

Download the content of all modifications in workspace 2020 from the site shop_company_com:

Code Block
languagebash
themeRDark
fproxy download shop_company_com all --ws=2020

Download the content of all modifications from the site shop_company_com with debugging information displayed:

...

Code Block
languagebash
themeRDark
fproxy download shop_company_com 33556 --force

Editing and testing modification content

After you've downloaded the modification content, you can edit and develop it normally in your preferred source code editor. When you're finished, upload the content back to the Frosmo back end.

...

You can test the content during development with Frosmo Preview, provided you have the FProxy server running.

Uploading modification content

Use the fproxy upload command to upload the content of a single modification from your local file system to the Frosmo back end. The content includes a template and template defaults, if defined.

...

Info

If the modification has content preloading enabled or uses a template, the custom script for the site is automatically updated and deployed to the CDN, making the updated modification immediately available to visitors on the site. In all other cases, the modification content is retrieved from the Frosmo back end, so the custom script requires no update.

Command syntax

Code Block
languagebash
themeRDark
fproxy upload <site_directory> <modification_id> [--ws=<workspace_id>] [--debug]

The modification ID (and thereby the modification) must already exist in the Frosmo back end. If it does not, the command fails with an error message about the ID not existing. If used, the same also applies to the workspace ID.

Command examples

Upload the content of modification 33556 for the site shop_company_com:

Code Block
languagebash
themeRDark
fproxy upload shop_company_com 33556

Upload the content of modification 72220 in workspace 2020 for the site shop_company_com:

Code Block
languagebash
themeRDark
fproxy upload shop_company_com 72220 --ws=2020

Upload the content of modification 33556 for the site shop_company_com with debugging information displayed:

Code Block
languagebash
themeRDark
fproxy upload shop_company_com 33556 --debug

Automatically uploading changed modification content

Use the fproxy watch command to monitor for changes in your downloaded modification content and to automatically upload changed files. The content includes templates and template defaults, if defined.

...

To stop monitoring for changes, press Ctrl+C / Cmd+C in your terminal.

Command syntax

Code Block
languagebash
themeRDark
fproxy watch <site_directory> [--debug]

Command examples

Monitor for and upload changes in the modification content for the site shop_company_com:

...