Documentation

rex_addon extends rex_package
in package
implements rex_addon_interface

Class for addons.

Tags
author

gharlan

Table of Contents

Interfaces

rex_addon_interface
Interface for addons.

Constants

FILE_BOOT  = 'boot.php'
FILE_INSTALL  = 'install.php'
FILE_INSTALL_SQL  = 'install.sql'
FILE_PACKAGE  = 'package.yml'
FILE_UNINSTALL  = 'uninstall.php'
FILE_UNINSTALL_SQL  = 'uninstall.sql'
FILE_UPDATE  = 'update.php'

Methods

__construct()  : mixed
boot()  : void
clearCache()  : void
Clears the cache of the package.
enlist()  : void
exists()  : bool
Returns if the addon exists.
get()  : rex_addon_interface
Returns the addon by the given name.
getAddon()  : mixed
getAssetsPath()  : mixed
getAssetsUrl()  : mixed
getAuthor()  : string|null
Returns the author.
getAvailableAddons()  : array<non-empty-string, self>
Returns the available addons.
getAvailablePackages()  : array<string, self>
Returns the available packages.
getAvailablePlugins()  : array<string, rex_plugin>
Returns the available plugins.
getCachePath()  : mixed
getConfig()  : mixed
getDataPath()  : mixed
getInstalledAddons()  : array<non-empty-string, self>
Returns the installed addons.
getInstalledPackages()  : array<string, self>
Returns the installed packages.
getInstalledPlugins()  : array<string, rex_plugin>
Returns the installed plugins.
getLicense()  : string|null
getName()  : non-empty-string
Returns the name of the package.
getPackageId()  : non-empty-string
Returns the package ID.
getPath()  : mixed
getPlugin()  : rex_plugin_interface
Returns the child plugin by the given name.
getProperty()  : mixed
Returns a property.
getRegisteredAddons()  : array<non-empty-string, self>
Returns the registered addons.
getRegisteredPackages()  : array<string, self>
Returns the registered packages.
getRegisteredPlugins()  : array<string, rex_plugin>
Returns the registered plugins.
getSetupAddons()  : array<string, self>
Returns the setup addons.
getSetupPackages()  : array<string, self>
Returns the setup packages.
getSupportPage()  : string|null
Returns the supportpage.
getSystemAddons()  : array<string, self>
Returns the system addons.
getSystemPackages()  : array<string, self>
Returns the system packages.
getSystemPlugins()  : array<string, rex_plugin>
Returns the system plugins.
getType()  : mixed
getVersion()  : string
Returns the version.
hasConfig()  : bool
hasProperty()  : bool
Returns if a property is set.
i18n()  : mixed
includeFile()  : mixed
Includes a file in the package context.
initialize()  : void
Initializes all packages.
isAvailable()  : bool
Returns if the package is available (activated and installed).
isInstalled()  : bool
Returns if the package is installed.
isSystemPackage()  : mixed
loadProperties()  : void
Loads the properties of package.yml.
pluginExists()  : bool
Returns if the plugin exists.
removeConfig()  : bool
removeProperty()  : void
Removes a property.
require()  : self
Returns the addon by the given name.
requirePlugin()  : rex_plugin
Returns the child plugin by the given name.
setConfig()  : bool
setProperty()  : void
Sets a property.
splitId()  : array{: string, : ?string}
Splits the package id into a tuple of addon id and plugin id (if existing).

Constants

FILE_BOOT

public mixed FILE_BOOT = 'boot.php'

FILE_INSTALL

public mixed FILE_INSTALL = 'install.php'

FILE_INSTALL_SQL

public mixed FILE_INSTALL_SQL = 'install.sql'

FILE_PACKAGE

public mixed FILE_PACKAGE = 'package.yml'

FILE_UNINSTALL

public mixed FILE_UNINSTALL = 'uninstall.php'

FILE_UNINSTALL_SQL

public mixed FILE_UNINSTALL_SQL = 'uninstall.sql'

FILE_UPDATE

public mixed FILE_UPDATE = 'update.php'

Methods

__construct()

public __construct(non-empty-string $name) : mixed
Parameters
$name : non-empty-string

Name

exists()

Returns if the addon exists.

public static exists(string $addon) : bool
Parameters
$addon : string

Name of the addon

Tags
psalm-assert-if-true

=non-empty-string $addon

Return values
bool

get()

Returns the addon by the given name.

public static get(string $addon) : rex_addon_interface
Parameters
$addon : string

Name of the addon

Tags
throws
InvalidArgumentException
Return values
rex_addon_interface —

If the addon exists, a rex_addon is returned, otherwise a rex_null_addon

getAddon()

public getAddon() : mixed

getAssetsPath()

public getAssetsPath([mixed $file = '' ]) : mixed
Parameters
$file : mixed = ''

getAssetsUrl()

public getAssetsUrl([mixed $file = '' ]) : mixed
Parameters
$file : mixed = ''

getAuthor()

Returns the author.

public getAuthor([mixed $default = null ]) : string|null
Parameters
$default : mixed = null

Default value, will be returned if the property isn't set

Return values
string|null

getAvailableAddons()

Returns the available addons.

public static getAvailableAddons() : array<non-empty-string, self>
Return values
array<non-empty-string, self>

getAvailablePackages()

Returns the available packages.

public static getAvailablePackages() : array<string, self>
Return values
array<string, self>

getAvailablePlugins()

Returns the available plugins.

public getAvailablePlugins() : array<string, rex_plugin>
Return values
array<string, rex_plugin>

getCachePath()

public getCachePath([mixed $file = '' ]) : mixed
Parameters
$file : mixed = ''

getConfig()

public getConfig([mixed $key = null ][, mixed $default = null ]) : mixed
Parameters
$key : mixed = null

The associated key

$default : mixed = null

Default return value if no associated-value can be found

Return values
mixed —

the value for $key or $default if $key cannot be found in the given $namespace

getDataPath()

public getDataPath([mixed $file = '' ]) : mixed
Parameters
$file : mixed = ''

getInstalledAddons()

Returns the installed addons.

public static getInstalledAddons() : array<non-empty-string, self>
Return values
array<non-empty-string, self>

getInstalledPackages()

Returns the installed packages.

public static getInstalledPackages() : array<string, self>
Return values
array<string, self>

getInstalledPlugins()

Returns the installed plugins.

public getInstalledPlugins() : array<string, rex_plugin>
Return values
array<string, rex_plugin>

getLicense()

public getLicense() : string|null
Return values
string|null

getName()

Returns the name of the package.

public getName() : non-empty-string
Return values
non-empty-string —

Name

getPackageId()

Returns the package ID.

public getPackageId() : non-empty-string
Return values
non-empty-string

getPath()

public getPath([mixed $file = '' ]) : mixed
Parameters
$file : mixed = ''

getProperty()

Returns a property.

public getProperty(mixed $key[, mixed $default = null ]) : mixed
Parameters
$key : mixed

Key of the property

$default : mixed = null

Default value, will be returned if the property isn't set

getRegisteredAddons()

Returns the registered addons.

public static getRegisteredAddons() : array<non-empty-string, self>
Return values
array<non-empty-string, self>

getRegisteredPackages()

Returns the registered packages.

public static getRegisteredPackages() : array<string, self>
Return values
array<string, self>

getRegisteredPlugins()

Returns the registered plugins.

public getRegisteredPlugins() : array<string, rex_plugin>
Return values
array<string, rex_plugin>

getSetupAddons()

Returns the setup addons.

public static getSetupAddons() : array<string, self>
Return values
array<string, self>

getSetupPackages()

Returns the setup packages.

public static getSetupPackages() : array<string, self>
Return values
array<string, self>

getSupportPage()

Returns the supportpage.

public getSupportPage([mixed $default = null ]) : string|null
Parameters
$default : mixed = null

Default value, will be returned if the property isn't set

Return values
string|null

getSystemAddons()

Returns the system addons.

public static getSystemAddons() : array<string, self>
Return values
array<string, self>

getSystemPackages()

Returns the system packages.

public static getSystemPackages() : array<string, self>
Return values
array<string, self>

getSystemPlugins()

Returns the system plugins.

public getSystemPlugins() : array<string, rex_plugin>
Return values
array<string, rex_plugin>

getType()

public getType() : mixed

getVersion()

Returns the version.

public getVersion([mixed $format = null ]) : string
Parameters
$format : mixed = null

See

Return values
string

hasConfig()

public hasConfig([mixed $key = null ]) : bool
Parameters
$key : mixed = null

The associated key

Return values
bool

hasProperty()

Returns if a property is set.

public hasProperty(mixed $key) : bool
Parameters
$key : mixed

Key of the property

Return values
bool

i18n()

public i18n(mixed $key, mixed ...$replacements) : mixed
Parameters
$key : mixed
$replacements : mixed

includeFile()

Includes a file in the package context.

public includeFile(mixed $file[, array<string|int, mixed> $context = [] ]) : mixed
Parameters
$file : mixed

Filename

$context : array<string|int, mixed> = []

Context values, available as variables in given file

initialize()

Initializes all packages.

public static initialize([bool $dbExists = true ]) : void
Parameters
$dbExists : bool = true

isAvailable()

Returns if the package is available (activated and installed).

public isAvailable() : bool
Return values
bool

isInstalled()

Returns if the package is installed.

public isInstalled() : bool
Return values
bool

isSystemPackage()

public isSystemPackage() : mixed

loadProperties()

Loads the properties of package.yml.

public loadProperties([bool $force = false ]) : void
Parameters
$force : bool = false

pluginExists()

Returns if the plugin exists.

public pluginExists(mixed $plugin) : bool
Parameters
$plugin : mixed

Name of the plugin

Return values
bool

removeConfig()

public removeConfig(mixed $key) : bool
Parameters
$key : mixed

The associated key

Return values
bool

removeProperty()

Removes a property.

public removeProperty(mixed $key) : void
Parameters
$key : mixed

Key of the property

require()

Returns the addon by the given name.

public static require(string $addon) : self
Parameters
$addon : string
Tags
throws
RuntimeException

if the addon does not exist

Return values
self

requirePlugin()

Returns the child plugin by the given name.

public requirePlugin(string $plugin) : rex_plugin
Parameters
$plugin : string
Tags
throws
RuntimeException

if the plugin does not exist

Return values
rex_plugin

setConfig()

public setConfig(mixed $key[, mixed $value = null ]) : bool
Parameters
$key : mixed

The associated key or an associative array of key/value pairs

$value : mixed = null

The value to save

Return values
bool —

TRUE when an existing value was overridden, otherwise FALSE

setProperty()

Sets a property.

public setProperty(mixed $key, mixed $value) : void
Parameters
$key : mixed

Key of the property

$value : mixed

New value for the property

splitId()

Splits the package id into a tuple of addon id and plugin id (if existing).

public static splitId(string $packageId) : array{: string, : ?string}
Parameters
$packageId : string
Return values
array{: string, : ?string} 

        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results