InstallerScript
Base install script for use by extensions providing helper methods for common behaviours.
| since |
3.6 |
|---|---|
| package |
Joomla CMS |
Methods
getInstances
Gets each instance of a module in the #__modules table
getInstances(bool isModule) : array
| since |
3.6 |
|---|
Arguments
- isModule
boolTrue if the extension is a module as this can have multiple instances
Response
arrayAn array of ID's of the extension
getItemArray
Builds a standard select query to produce better DRY code in this script.
getItemArray(string element, string table, string column, mixed identifier) : array
This should produce a single unique cell which is json encoded - it will then return an associated array with this data in.
| since |
3.6 |
|---|
Arguments
- element
stringThe element to get from the query- table
stringThe table to search for the data in- column
stringThe column of the database to search from- identifier
mixedThe integer id or the already quoted string
Response
arrayAssociated array containing data from the cell
getParam
Gets parameter value in the extensions row of the extension table
getParam(string name, int id) : string
| since |
3.6 |
|---|
Arguments
- name
stringThe name of the parameter to be retrieved- id
intThe id of the item in the Param Table
Response
stringThe parameter desired
moveCliFiles
Moves the CLI scripts into the CLI folder in the CMS
moveCliFiles() : void
| since |
3.6 |
|---|
preflight
Function called before extension installation/update/removal procedure commences
preflight(string type, \Joomla\CMS\Installer\InstallerAdapter parent) : bool
| since |
3.6 |
|---|
Arguments
- type
stringThe type of change (install, update or discover_install, not uninstall)- parent
\Joomla\CMS\Installer\InstallerAdapterThe class calling this method
Response
boolTrue on success
removeFiles
Remove the files and folders in the given array from
removeFiles() : void
| since |
3.6 |
|---|
setParams
Sets parameter values in the extensions row of the extension table. Note that the this must be called separately for deleting and editing. Note if edit is called as a type then if the param doesn't exist it will be created
setParams(array paramArray = null, string type = 'edit', int id) : bool
| since |
3.6 |
|---|
Arguments
- paramArray
arrayThe array of parameters to be added/edited/removed- type
stringThe type of change to be made to the param (edit/remove)- id
intThe id of the item in the relevant table
Response
boolTrue on success
Properties
release
The version number of the extension.
| since |
3.6 |
|---|
Type(s)
string
paramTable
The table the parameters are stored in.
| since |
3.6 |
|---|
Type(s)
string
extension
The extension name. This should be set in the installer script.
| since |
3.6 |
|---|
Type(s)
string
deleteFiles
A list of files to be deleted
| since |
3.6 |
|---|
Type(s)
array
deleteFolders
A list of folders to be deleted
| since |
3.6 |
|---|
Type(s)
array
cliScriptFiles
A list of CLI script files to be copied to the cli directory
| since |
3.6 |
|---|
Type(s)
array
minimumPhp
Minimum PHP version required to install the extension
| since |
3.6 |
|---|
Type(s)
string
minimumJoomla
Minimum Joomla! version required to install the extension
| since |
3.6 |
|---|
Type(s)
string
allowDowngrades
Allow downgrades of your extension
Use at your own risk as if there is a change in functionality people may wish to downgrade.
| since |
3.6 |
|---|
Type(s)
bool