چگونه کار می کند

The publication process is the process which starts when the client presses button "Publish" in builder toolbar. The process can be divided into several parts which are executed one after another in specified order:

• saving draft — this step saves website draft — the same action which is triggered when pressing button "Save Draft". This step takes <1 second; when it completes the state "preparing..." is displayed;
• website generation — during this step builder generates final website files which will be published to client's hosting. They consist mostly of .php, .js, .css and different media files. During this step the state "building website..." is displayed;
• connection to hosting FTP server — this is the 1st step of deploying part. The builder tries to establish FTP connection with hosting server where it will publish website. The connection is made with 3 different IPs in specified order until it finally connects (when it connects with some of them it does not try the rest):
  • IP address which was passed by hosting control panel API to builder plugin when builder was opened (in case if "Custom (API)" is used then it is defined by parameter "apiUrl");
  • IP address of domain which was opened (in case if "Custom (API)" is used then it is defined by parameter "baseDomain" [or "domain" if "baseDomain" is not provided]);
  • remote IP address of server which made API call to builder during opening;
  During this step the state "connecting..." is displayed;
• logging to hosting FTP account — this is the 2nd step of deploying part. After successful connection to FTP server builder tries to log in with username and password of FTP account. Builder gets FTP data from builder plugin on hosting control panel (API) (in case if "Custom (API)" is used then FTP details are defined by parameters "username" and "password");
• files uploading — this is the 3rd step of deploying part. During this step website files are uploaded to hosting. Note that only changed files are uploaded from last publication. This is usually the longest part. It can take from few seconds to few minutes (depending on website size and connection speed between builder and hosting servers);
• verification — this is the 4th step of deploying part. After successfully uploaded website files (only changed) to hosting then builder makes verification whose purpose is to check if all required website files are on hosting and they are all correct. During this step builder connects to website hosting on port 80 or 443. The connection is made also with different IPs in the same order and same IPs as during builder connection to FTP server with one difference — firstly it tries IP address which could successful establish connection to FTP server. During this step the state "verifying..." is displayed;
• files re-uploading (full) (optional) — this step is taken only in the case if verification returned negative result, that is some website file on hosting was removed or changed since last publication. During files re-uploading the connection to FTP is made again as described in step (3). When the uploading ends then no second verification is made.

Note that practically all these steps are executed quite quickly and usually client does not see them all in publication process bar.

Website 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 website builder button can be customized with your own icon and title.

The website builder plugin works as a gateway from panel to website builder. Plugin purpose is to retrieve all required information of client account from hosting control panel (using internal API) and pass it to website 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 website builder during publication)
• client's domain
• client's account package (if supported by panel).

After plugin collects information it calls website builder via API and pass information for it. Website builder checks the license of your hosting server and determines whether to let you in or not. If the license is verified then website builder API returns URL otherwise it returns error message. In case if plugin gets URL from website builder it redirects the client by this URL to website builder where client can construct his website. If the license verification fails then website 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 website builder plugin and website builder is made via HTTP port 80 or 443 depending what protocol website builder uses. In case if you use Cloud website builder then 443 port is always used. If you use On-Premises website builder then it depends on what protocol your website builder is running on.

When the client opens website builder for the first time then website builder suggests to choose a template first before starting constructing website. During website construction all website data is saved in special ".dat" files in website builder storage and all media files which client uploads are also stored in website builder. Note that during website construction in website builder no changes are made on client's hosting. Changes are applied only when client presses button "Publish" in website builder toolbar — then website 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 website builder then website builder finds his ".dat" files and loads them instead of offering to choose template anew. Note that when client opens website builder then website 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 website 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 website builder separately for all of them. If client's domain is renamed further then it also must be renamed in website builder separately. Otherwise the client will be offered to choose template a new 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 website builder by implementing your own plugin using website builder API method to create session.

Site.pro recommends On-Premises license because of stability reason:

1. Website Builder is stored on your server (in your country) so it will never be affected:
• by local or global internet shutdowns (e.g. Pakistan, Kazakhstan, Iran, Belarus),
• blockages (e.g. China, South Korea),
• data storage regulations (e.g. Russia, Europe, USA),
• smaller ping between builder and clients' hostings (a faster website publication time).
2. Prices are the same (for On-Premises and Cloud);
3. On-premises has additional features and much more customisation options.