FAQ

Builder plugin is a module for hosting control panel (cPanel, Plesk, etc.) which is installed on panel and displayed for end clients as an extra button among other buttons. The builder button can be customized with your own icon and title.

The builder plugin works as a gateway from panel to site builder. Plugin purpose is to retrieve all required information of client account from hosting control panel (using internal API) and pass it to site builder. The required information includes:

• client's FTP account data (username and password)
• client's hosting IP address (which is used as FTP host in builder during publication)
• client's domain
• client's account package (if supported by panel).

After plugin collects information it calls builder via API and pass information for it. Builder checks the license of your hosting server and determines whether to let you in or not. If the license is verified then builder API returns URL otherwise it returns error message. In case if plugin gets URL from builder it redirects the client by this URL to builder where client can construct his website. If the license verification fails then builder returns error message "License is required" meaning that the license could not be detected by API call and provided parameters (check how to fix this error).

The communication between builder plugin and builder is made via HTTP port 80 or 443 depending what protocol builder uses. In case if you use Cloud builder then 443 port is always used. If you use On-Premises builder then it depends on what protocol your builder is running on.

When the client opens builder for the first time then builder suggests to choose a template first before starting constructing website. During website construction all website data is saved in special ".dat" files in builder storage and all media files which client uploads are also stored in builder. Note that during website construction in builder no changes are made on client's hosting. Changes are applied only when client presses button "Publish" in builder toolbar — then builder generates real website files (consisting of .php, .js, .css and other files) and publishes them to client's hosting via FTP connection (see how publication works in more details).
When the client next time opens builder then builder finds his ".dat" files and loads them instead of offering to choose template anew. Note that when client opens builder then builder does not download client's current website files from hosting — builder has all website data in his own storage.

The identification of website in builder is made only by domain. It means that the client can have multiple websites in his account (addon domains, sub-domains) and construct websites in builder separately for all of them. If client's domain is renamed further then it also must be renamed in builder separately. Otherwise the client will be offered to choose template anew as if the website was opened for the first time.

If you have your own hosting control system for your customers and do not use predefined hosting control panel which we support then you can also use site builder by implementing your own plugin using builder API method to create session.

Most probably you installed site builder plugin on your hosting panel before you set plugin icon and title in your brand on Site.pro licenses page. In order to update icon and title on your hosting panel just make plugin re-installation by instruction which you can find on this page.

Documentation page — https://site.pro/docs/plugins/