CMS Installer

CMS installer - is the built-in tool for automatic uploading and installing of the desired CMS engine. In fact - is the installation of CMS (or even several CMS) in a single click.

CMS installation scripts are located in separate folders in the directory Zebroid\CMS Installer\.

The basic configuration

• Name - the name of the profile

• CMS – CMS you want to install. To the left is a list of versions/builds of this CMS. All these versions/builds are unpacked in separate folders in your engine folder

• FTP - FTP account to upload the CMS files

• CMS Installation Settings - parameters that are necessary for the CMS script

Plugins - the list of plugins to be installed, along with CMS. Plugins should be located in the plugins folder of your installation script. For each of your script exist special order of plugins (in some they are in separate folders, in others - in the files).

Templates - the list of templates from which you select the desired to install. Templates must be in templates folder of desired installation script.

Due to the fact that different CMS requires a different approach to configuring, installing plugins and templates, we created page with description of different CMS settings features, which are included with the program.

Creating CMS install scripts

Scripting is not a simple task. You need to have a good understanding of the mechanism of setting the desired CMS and have some skills in Zebroid auto posting scripting.

Scripts consist of the following files and folders:

Folder engine - there are different versions of the CMS
Folder extra upload - there are files and folders that you want to upload in addition on the FTP after uploading CMS
A folder plugins - there are plugins
The folder templates - there are templates
File icon.png - CMS 16x16 Icon
File settings.ini - templates and plugins uploading configuration file (the file format is described below)
File ftp_rights.txt - a file with a description what rights to the files and folders you have set. The file format is simple: write a tab path to the folder/file and the numeric identifier of the rights that must be installed
File ftp_delete.txt - list of files and folders to be removed after installation. The presence of a slash at the end of the path is a sign of the folder
File macroses.txt - a list of macro scripts (file format is described below)
File cms install.zcs - file with the CMS installation script (the file format is described below)
The file plugin-template install.zcs - file with the plug-ins and templates installation script (the file format is described below)

Format of the file settings.ini (for example, is configured for WordPress)

[Plugins]
upload_folder=wp-content/plugins/
upload_type=folder_content
script_single_exec=1
[Templates]
upload_folder=wp-content/themes/
preview_filename=screenshot.*
upload_type=folder

upload_folder (Section [Plugins]) - the path to the folder for plugin installation
upload_type (Section [Plugins]) - the type of uploading. There are several types: folder - each plugin in a separate folder, you should upload whole folder on FTP; folder_content - each file is located in a separate folder, but you need to upload only the contents of the folder; file - each plugin is a separate file
script_single_exec (Section [Plugins]) – you need to set 1 - if you need to run a script for activation of all plugins only once and 0 - if for each plug-in you need to run a separate script
upload_folder (Section [Templates]) - the path to the folder for templates installation
preview_filename (Section [Templates]) - a file with template thumbnail (if any). You can specify the extension as *, then the program will take the first file with the appropriate name
upload_type (Section [Templates]) - the same as upload_type in [Plugins] section

Format of the file macroses.txt:

MACRO_NAME=DESCRIPTION|DEFAULT_VALUE

The macro name can be anything. This is essentially what the program looks before running the script to replace the value. The description is what users see in the list of add. fields, which he is required to fill while creating account. The default value - a value that is set before the user enters his own.

Example:

URL=blog address|httр://

Format of the file cms install.zcs

program CMSInstall;
procedure BeforeFTPUpload();
begin
// Function to be executed prior to export on FTP (need to edit configuration files before uploading)
end;
procedure AfterFTPUpload();
begin
//Function to be executed after uploading through FTP (used for filling fields of CMS Installer)
end;

Scripts are written using all the features of Zebroid auto posting scripts. The procedures are started only when they are available in the file, ie they are not required.

Format of the file plugin-template install.zcs

program AdditInastall;
procedure LogIn();
begin
// The function is responsible for the entrance to the site admin area after installing the CMS and before installing plugins/templates
end;
procedure InstallPlugin(name:string);
begin
// Function setup (activation) of plugins. As a parameter passed the plugin name in the same form as it appears in the list of plugins in Zebroid. If you select "script_single_exec" mode - then transferred an empty parameter
end;
procedure InstallTemplate(name:string);
begin
// Function of templates setup (activation). As a parameter passed the template name in the same form as it appears in the list of templates in Zebroid
end;

Scripts are written using all the features of Zebroid auto posting scripts. The procedures are started only when they are available in the file, ie they are not required.