If you wish to automate the installation of Scripts using a different software e.g. a billing system like WHMCS you can do that in Softaculous as there is an API Class which enables us to do so.<\/p>\n\n\n\n
You can find the API Class in your Softaculous folder e.g. in cPanel its located here : <\/p>\n\n\n\n
\/usr\/local\/cpanel\/whostmgr\/docroot\/cgi\/softaculous\/sdk\/installapi.php<\/p>\n\n\n\n
The API is a simple class which will pass the data to Softaculous to install a script. Here is a sample example to install a script :<\/p>\n\n\n\n
<?php\n\n@set_time_limit(100);\n\n$new = new Soft_Install();\n$new->login = 'https:\/\/'.rawurlencode(\"user\").':'.rawurlencode(\"password\").'@domain.com:2083\/frontend\/jupiter\/softaculous\/index.live.php';\n$new->data['softdomain'] = 'domain.com'; \/\/ OPTIONAL - By Default the primary domain will be used\n$new->data['softdirectory'] = 'folder'; \/\/ OPTIONAL - By default it will be installed in the \/public_html folder\n$new->data['admin_pass'] = 'qwerty';\n$new->data['admin_email'] = 'admin@domain.com';\n$res = $new->install(26); \/\/ Will install WordPress\n\nif($res == 'installed'){\n\techo 'Installed';\n}else{\n\techo $res; \/\/ A serialized array of error will be returned\n}<\/pre>\n\n\n\nAs you may see this will install WordPress.
Lets go through the Code :<\/p>\n\n\n\n
Initializing and Authentication<\/h4>\n\n\n\n$new = new Soft_Install();\n$new->login = 'https:\/\/'.rawurlencode(\"user\").':'.rawurlencode(\"password\").'@domain.com:2083\/frontend\/jupiter\/softaculous\/index.live.php';<\/pre>\n\n\n\nThis will load the Class in $new and we are setting the LOGIN URL as without authentication you will not be able to access Softaculous. The code here is an example to Auto Install in cPanel. cPanel allows User Authentication via the URL itself and many other panels also.<\/p>\n\n\n\n
https:\/\/'.rawurlencode(\"user\").':'.rawurlencode(\"password\").'@domain.com:2083<\/pre>\n\n\n\nInstalling scripts as ROOT<\/h4>\n\n\n\n
You can install a script for your user as ROOT. You will have to modify your login URL as follows :<\/p>\n\n\n\n
$new = new Soft_Install();\n$new->login = 'https:\/\/'.rawurlencode(\"user\").':'.rawurlencode(\"ROOT_PASSWORD\").'@domain.com:2083\/frontend\/jupiter\/softaculous\/index.live.php';<\/pre>\n\n\n\nThe above code will allow you to install a script as ROOT for your users.<\/p>\n\n\n\n
If your panel has some different method, you must first implement that code and then proceed.<\/p>\n\n\n\n
NOTE : <\/strong>This is the URL which is used to install ANY Script. Hence it is very important to install any script.<\/p>\n\n\n\nDont send emails<\/h4>\n\n\n\n
If you want no emails to be sent by Softaculous on the installation of a script please pass the &noemail=1&<\/strong> in the login url. e.g :<\/p>\n\n\n\n$new->login = 'https:\/\/'.rawurlencode(\"user\").':'.rawurlencode(\"password\").'@domain.com:2083\/frontend\/jupiter\/softaculous\/index.live.php?&noemail=1&';<\/pre>\n\n\n\nData Fields<\/h4>\n\n\n\n
Softaculous will expect you to submit the data fields as it shows during the installation of Scripts. Now most scripts have common fields like Admin Username and Password and stuff like that. The values that you pass for the fields in this API Call will replace the default ones shown in Softaculous. If you dont specify any field the default value is used by Softaculous.<\/p>\n\n\n\n
$new->data['softdomain'] = 'domain.com'; \/\/ OPTIONAL - By Default the primary domain will be used\n$new->data['softdirectory'] = 'folder'; \/\/ OPTIONAL - By default it will be installed in the \/public_html folder\n$new->data['admin_pass'] = 'qwerty';\n$new->data['admin_email'] = 'admin@domain.com';\n$res = $new->install(26); \/\/ Will install WordPress<\/pre>\n\n\n\nThe above code is just setting the Domain, Folder to install in, Admin Password and Admin Email.
The field names for each script can be obtained by viewing the SOURCE in the browser while installing a Script in Softaculous.
The line $res = $new->install(26);<\/strong> will start the installation process and $res will have the result that is obtained.<\/p>\n\n\n\nReturn Values<\/h4>\n\n\n\nif($res == 'installed'){\n\techo 'Installed';\n}else{\n\techo $res; \/\/ A serialized array of error will be returned\n}<\/pre>\n\n\n\nOn a successful install $res will have the value installed<\/strong>
On error a SERIALIZED PHP ARRAY is returned with the error details.<\/p>\n\n\n\nCustom Scripts<\/h4>\n\n\n\n
If you have made Custom Script packages and would like to use this API to install it just copy the cscripts.php<\/strong> from your server and place it next to this file.
Thats it!! You can now install the Custom Scripts.<\/p>\n\n\n\nOverwrite Files<\/h4>\n\n\n\n
If you wish to install the software even if the files exists you need to uncomment following line in the file installapi.php<\/p>\n\n\n\n
$new->data['overwrite_existing'] = true;<\/pre>\n\n\n\nSupport<\/h3>\n\n\n\n