Documentation

rex_package_interface
in

Interface for packages.

Tags
author

gharlan

Table of Contents

Methods

getAddon()  : rex_addon_interface
Returns the related Addon.
getAssetsPath()  : non-empty-string
Returns the assets path.
getAssetsUrl()  : non-empty-string
Returns the assets url.
getAuthor()  : string|null
Returns the author.
getCachePath()  : non-empty-string
Returns the cache path.
getConfig()  : mixed
getDataPath()  : non-empty-string
Returns the data path.
getName()  : non-empty-string
Returns the name of the package.
getPackageId()  : non-empty-string|null
Returns the package ID.
getPath()  : non-empty-string
Returns the base path.
getProperty()  : mixed
Returns a property.
getSupportPage()  : string|null
Returns the supportpage.
getType()  : "addon"|"plugin"
Returns the package type as string.
getVersion()  : string
Returns the version.
hasConfig()  : bool
hasProperty()  : bool
Returns if a property is set.
i18n()  : non-empty-string
Adds the package prefix to the given key and returns the translation for it.
includeFile()  : mixed
Includes a file in the package context.
isAvailable()  : bool
Returns if the package is available (activated and installed).
isInstalled()  : bool
Returns if the package is installed.
isSystemPackage()  : bool
Returns if it is a system package.
removeConfig()  : bool
removeProperty()  : void
Removes a property.
setConfig()  : bool
setProperty()  : void
Sets a property.

Methods

getAssetsPath()

Returns the assets path.

public getAssetsPath([string $file = '' ]) : non-empty-string
Parameters
$file : string = ''

File

Return values
non-empty-string

getAssetsUrl()

Returns the assets url.

public getAssetsUrl([string $file = '' ]) : non-empty-string
Parameters
$file : string = ''

File

Return values
non-empty-string

getAuthor()

Returns the author.

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

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

Return values
string|null

getCachePath()

Returns the cache path.

public getCachePath([string $file = '' ]) : non-empty-string
Parameters
$file : string = ''

File

Return values
non-empty-string

getConfig()

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

The associated key

$default : mixed = null

Default return value if no associated-value can be found

Tags
see
rex_config::get()
template

T as ?string

throws
InvalidArgumentException
psalm-return

(T is string ? mixed|null : array<string, mixed>)

Return values
mixed —

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

getDataPath()

Returns the data path.

public getDataPath([string $file = '' ]) : non-empty-string
Parameters
$file : string = ''

File

Return values
non-empty-string

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|null
Return values
non-empty-string|null

getPath()

Returns the base path.

public getPath([string $file = '' ]) : non-empty-string
Parameters
$file : string = ''

File

Return values
non-empty-string

getProperty()

Returns a property.

public getProperty(non-empty-string $key[, mixed $default = null ]) : mixed
Parameters
$key : non-empty-string

Key of the property

$default : mixed = null

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

getSupportPage()

Returns the supportpage.

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

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

Return values
string|null

getType()

Returns the package type as string.

public getType() : "addon"|"plugin"
Return values
"addon"|"plugin"

getVersion()

Returns the version.

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

See

Return values
string

hasConfig()

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

The associated key

Tags
see
rex_config::has()
Return values
bool

hasProperty()

Returns if a property is set.

public hasProperty(non-empty-string $key) : bool
Parameters
$key : non-empty-string

Key of the property

Return values
bool

i18n()

Adds the package prefix to the given key and returns the translation for it.

public i18n(string $key, string|int ...$replacements) : non-empty-string
Parameters
$key : string

Key

$replacements : string|int

A arbritary number of strings used for interpolating within the resolved messag

Return values
non-empty-string —

Translation for the key

includeFile()

Includes a file in the package context.

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

Filename

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

Context values, available as variables in given file

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()

Returns if it is a system package.

public isSystemPackage() : bool
Return values
bool

removeConfig()

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

The associated key

Tags
see
rex_config::remove()
Return values
bool

removeProperty()

Removes a property.

public removeProperty(non-empty-string $key) : void
Parameters
$key : non-empty-string

Key of the property

setConfig()

public setConfig(string|array<string, mixed> $key[, mixed $value = null ]) : bool
Parameters
$key : string|array<string, mixed>

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

$value : mixed = null

The value to save

Tags
see
rex_config::set()
Return values
bool —

TRUE when an existing value was overridden, otherwise FALSE

setProperty()

Sets a property.

public setProperty(non-empty-string $key, mixed $value) : void
Parameters
$key : non-empty-string

Key of the property

$value : mixed

New value for the property


        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results