Modifications are real-time changes to a web page designed to improve the user experience and guide visitors to complete conversions. You create modifications through the Frosmo Control Panel.
Frosmo Control Panel
You define the content in the Control Panel. The only tool you need is a browser running the Control Panel. You can, of course, use an external source code editor to write the content, but to deploy the content you need to copy it to the Control Panel.
You use FProxy to download the content to your local file system, edit the content in any source code editor, and use FProxy to upload the content back to the Frosmo back end. You can manage the downloaded content files with any version control system.
If a modification uses a template, FProxy automatically downloads and uploads the template content alongside the modification content. You can work on the template content the same as the modification content. For simplicity, this guide mostly talks about "modification content" or just "content", but you can assume that to also include template content.
The Control Panel is the simpler way to develop modification content, but FProxy gives you more options for using your own tools and processes, especially if you're a software developer. This guide focuses on FProxy. For more information about developing modifications in the Control Panel, see Modifications and Creating your first modification.
Regardless of where you develop your modification content, you test the content on the site using the Frosmo Debugger.
For more information, see:
FProxy consists of a desktop-based command-line interface (CLI) and a web proxy server:
FProxy server allows you to live-preview and hot-reload modification content (including templates) on your site during development, without the need to first upload the content to the Frosmo back end or update the Frosmo custom script for your site. Hot reloading allows you to reload only the content of the changed modification rather than the entire page.
You can also hot-reload changes to modification content made in the Control Panel, provided you do not have the same modification (or template) downloaded on your computer.
Figure: FProxy CLI in Bash
With the FProxy server enabled, retrieving modification content works as follows:
Compared to the Control Panel, developing modifications with FProxy has several advantages:
FProxy also has a few limitations you need to be aware of:
FProxy supports workspaces. You can use FProxy to develop and test workspace modifications the same way you would production modifications:
The only difference to working with production modifications is that you cannot hot-reload changes to workspace modification content made in the Control Panel.
If a workspace modification uses a template, the template must also be in the workspace. If you try to download a workspace modification that uses a production template, FProxy throws an error and fails the download.
For more information about workspaces and workspaces preview mode, see Workspaces and Previewing a workspace.
The Frosmo Debugger is a web application that allows you to preview and debug modifications on your site during development. You need the Frosmo Debugger for setting up the FProxy server for your site.
For more information about the Frosmo Debugger, see Frosmo Debugger.
Figure: Tools and components of modification development
Before you can start developing with FProxy, you need to:
After you have everything set up, you can start developing.
To get started with a simple example, see Example: Creating a simple site banner.
If you run into problems, see Troubleshooting and FProxy CLI commands and parameters.