PHP Класс ElggPlugin, Elgg

This class is currently a stub, allowing a plugin to save settings in an object's private settings for each site.
Наследование: extends ElggObject
Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
__construct ( string $path ) Creates a new plugin from path
__get ( string $name ) : mixed Get an attribute or private setting value
__set ( string $name, mixed $value ) : void Set a value as private setting or attribute.
activate ( ) : boolean Actives the plugin for the current site.
canActivate ( ) : boolean Checks if this plugin can be activated on the current Elgg installation.
canDeactivate ( ) : boolean Checks if this plugin can be deactivated on the current Elgg installation. Validates that this plugin has no active dependants.
deactivate ( ) : boolean Deactivates the plugin.
getAllSettings ( ) : array Returns an array of all settings saved for this plugin.
getAllUserSettings ( integer $user_guid ) : array Returns an array of all user settings saved for this plugin for the user.
getAvailableTextFiles ( ) : array Returns an array of available markdown files for this plugin
getError ( ) : string | null Returns the last error message registered.
getFriendlyName ( ) : string Returns the manifest's name if available, otherwise the ID.
getID ( ) : string Returns the ID (dir name) of this plugin
getManifest ( ) : ElggPluginManifest | null Returns this plugin's \ElggPluginManifest object
getPackage ( ) : ElggPluginPackage | null Returns this plugin's \ElggPluginPackage object
getPath ( ) : string Returns the plugin's full path with trailing slash.
getPriority ( ) : integer Gets the plugin's load priority.
getSetting ( string $name, mixed $default = null ) : mixed Returns a plugin setting
getStaticConfig ( string $key, mixed $default = null ) : mixed Get a value from the plugins's static config file.
getUserSetting ( string $name, integer $user_guid, mixed $default = null ) : mixed Returns a user's setting for this plugin
isActive ( ) : boolean Is this plugin active?
isValid ( ) : boolean Returns if the plugin is complete, meaning has all required files and Elgg can read them and they make sense.
save ( ) : boolean Save the plugin object. Make sure required values exist.
setID ( string $id ) : boolean Sets the location of this plugin.
setPriority ( mixed $priority ) : boolean Sets the priority of the plugin
setSetting ( string $name, string $value ) : boolean Set a plugin setting for the plugin
setUserSetting ( string $name, string $value, integer $user_guid ) : mixed Sets a user setting for a plugin
start ( integer $flags ) : true Start the plugin.
unsetAllSettings ( ) : boolean Removes all settings for this plugin.
unsetAllUserSettings ( integer $user_guid ) : boolean Removes all User Settings for this plugin for a particular user
unsetAllUsersSettings ( ) : boolean Removes this plugin's user settings for all users.
unsetSetting ( string $name ) : boolean Removes a plugin setting name and value.
unsetUserSetting ( string $name, integer $user_guid ) : boolean Removes a user setting name and value.

Защищенные методы

Метод Описание
canReadFile ( string $filename ) : boolean Checks whether a plugin file with the given name exists
includeFile ( string $filename ) : mixed Includes one of the plugins files
initializeAttributes ( ) : void Set subtype to 'plugin'
registerActions ( ) : void Registers the plugin's actions provided in the plugin config file
registerClasses ( ) : true Registers the plugin's classes
registerLanguages ( ) : true Registers the plugin's languages
registerViews ( ) : void Registers the plugin's views
registerWidgets ( ) : void Registers the plugin's widgets provided in the plugin config file

Приватные методы

Метод Описание
isStaticConfigValid ( ) : boolean If a static config file is present, is it a serializable array?
setStatus ( boolean $active ) : boolean Sets the plugin to active or inactive.

Описание методов

__construct() публичный Метод

Creates a new plugin from path
public __construct ( string $path )
$path string The absolute path of the plugin

__get() публичный Метод

Get an attribute or private setting value
public __get ( string $name ) : mixed
$name string Name of the attribute or private setting
Результат mixed

__set() публичный Метод

Attributes include title and description.
public __set ( string $name, mixed $value ) : void
$name string Name of the attribute or private_setting
$value mixed Value to be set
Результат void

activate() публичный Метод

Actives the plugin for the current site.
public activate ( ) : boolean
Результат boolean

canActivate() публичный Метод

Checks if this plugin can be activated on the current Elgg installation.
public canActivate ( ) : boolean
Результат boolean

canDeactivate() публичный Метод

Checks if this plugin can be deactivated on the current Elgg installation. Validates that this plugin has no active dependants.
public canDeactivate ( ) : boolean
Результат boolean

canReadFile() защищенный Метод

Checks whether a plugin file with the given name exists
protected canReadFile ( string $filename ) : boolean
$filename string The name of the file
Результат boolean

deactivate() публичный Метод

Deactivates the plugin.
public deactivate ( ) : boolean
Результат boolean

getAllSettings() публичный Метод

Returns an array of all settings saved for this plugin.
public getAllSettings ( ) : array
Результат array An array of key/value pairs.

getAllUserSettings() публичный Метод

Returns an array of all user settings saved for this plugin for the user.
public getAllUserSettings ( integer $user_guid ) : array
$user_guid integer The user GUID. Defaults to logged in.
Результат array An array of key/value pairs.

getAvailableTextFiles() публичный Метод

Returns an array of available markdown files for this plugin
public getAvailableTextFiles ( ) : array
Результат array

getError() публичный Метод

Returns the last error message registered.
public getError ( ) : string | null
Результат string | null

getFriendlyName() публичный Метод

Returns the manifest's name if available, otherwise the ID.
С версии: 1.8.1
public getFriendlyName ( ) : string
Результат string

getID() публичный Метод

Returns the ID (dir name) of this plugin
public getID ( ) : string
Результат string

getManifest() публичный Метод

Returns this plugin's \ElggPluginManifest object
public getManifest ( ) : ElggPluginManifest | null
Результат ElggPluginManifest | null

getPackage() публичный Метод

Returns this plugin's \ElggPluginPackage object
public getPackage ( ) : ElggPluginPackage | null
Результат ElggPluginPackage | null

getPath() публичный Метод

Returns the plugin's full path with trailing slash.
public getPath ( ) : string
Результат string

getPriority() публичный Метод

Gets the plugin's load priority.
public getPriority ( ) : integer
Результат integer

getSetting() публичный Метод

Returns a plugin setting
public getSetting ( string $name, mixed $default = null ) : mixed
$name string The setting name
$default mixed The default value to return if none is set
Результат mixed

getStaticConfig() публичный Метод

Get a value from the plugins's static config file.
public getStaticConfig ( string $key, mixed $default = null ) : mixed
$key string Config key
$default mixed Value returned if missing
Результат mixed

getUserSetting() публичный Метод

Returns a user's setting for this plugin
public getUserSetting ( string $name, integer $user_guid, mixed $default = null ) : mixed
$name string The setting name
$user_guid integer The user GUID
$default mixed The default value to return if none is set
Результат mixed The setting string value, the default value or false if there is no user

includeFile() защищенный Метод

Includes one of the plugins files
protected includeFile ( string $filename ) : mixed
$filename string The name of the file
Результат mixed The return value of the included file (or 1 if there is none)

initializeAttributes() защищенный Метод

Set subtype to 'plugin'
protected initializeAttributes ( ) : void
Результат void

isActive() публичный Метод

Is this plugin active?
public isActive ( ) : boolean
Результат boolean

isValid() публичный Метод

Returns if the plugin is complete, meaning has all required files and Elgg can read them and they make sense.
public isValid ( ) : boolean
Результат boolean

registerActions() защищенный Метод

Registers the plugin's actions provided in the plugin config file
protected registerActions ( ) : void
Результат void

registerClasses() защищенный Метод

Registers the plugin's classes
protected registerClasses ( ) : true
Результат true

registerLanguages() защищенный Метод

Registers the plugin's languages
protected registerLanguages ( ) : true
Результат true

registerViews() защищенный Метод

Registers the plugin's views
protected registerViews ( ) : void
Результат void

registerWidgets() защищенный Метод

Registers the plugin's widgets provided in the plugin config file
protected registerWidgets ( ) : void
Результат void

save() публичный Метод

Save the plugin object. Make sure required values exist.
См. также: ElggObject::save()
public save ( ) : boolean
Результат boolean

setID() публичный Метод

Sets the location of this plugin.
public setID ( string $id ) : boolean
$id string The path to the plugin's dir.
Результат boolean

setPriority() публичный Метод

Sets the priority of the plugin
public setPriority ( mixed $priority ) : boolean
$priority mixed The priority to set. One of +1, -1, first, last, or a number. If given a number, this will displace all plugins at that number and set their priorities +1
Результат boolean

setSetting() публичный Метод

Set a plugin setting for the plugin
public setSetting ( string $name, string $value ) : boolean
$name string The name to set
$value string The value to set
Результат boolean

setUserSetting() публичный Метод

Sets a user setting for a plugin
public setUserSetting ( string $name, string $value, integer $user_guid ) : mixed
$name string The setting name
$value string The setting value
$user_guid integer The user GUID
Результат mixed The new setting ID or false

start() публичный Метод

Start the plugin.
public start ( integer $flags ) : true
$flags integer Start flags for the plugin. See the constants in lib/plugins.php for details.
Результат true

unsetAllSettings() публичный Метод

Removes all settings for this plugin.
public unsetAllSettings ( ) : boolean
Результат boolean

unsetAllUserSettings() публичный Метод

Use {@link removeAllUsersSettings()} to remove all user settings for all users. (Note the plural 'Users'.)
public unsetAllUserSettings ( integer $user_guid ) : boolean
$user_guid integer The user GUID to remove user settings.
Результат boolean

unsetAllUsersSettings() публичный Метод

Use {@link removeAllUserSettings()} if you just want to remove settings for a single user.
public unsetAllUsersSettings ( ) : boolean
Результат boolean

unsetSetting() публичный Метод

Removes a plugin setting name and value.
public unsetSetting ( string $name ) : boolean
$name string The setting name to remove
Результат boolean

unsetUserSetting() публичный Метод

Removes a user setting name and value.
public unsetUserSetting ( string $name, integer $user_guid ) : boolean
$name string The user setting name
$user_guid integer The user GUID
Результат boolean