PHP Class ElggPlugin, Elgg

This class is currently a stub, allowing a plugin to save settings in an object's private settings for each site.
Inheritance: extends ElggObject
Afficher le fichier Open project: elgg/elgg Class Usage Examples

Méthodes publiques

Méthode Description
__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.

Méthodes protégées

Méthode Description
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

Private Methods

Méthode Description
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.

Method Details

__construct() public méthode

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

__get() public méthode

Get an attribute or private setting value
public __get ( string $name ) : mixed
$name string Name of the attribute or private setting
Résultat mixed

__set() public méthode

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
Résultat void

activate() public méthode

Actives the plugin for the current site.
public activate ( ) : boolean
Résultat boolean

canActivate() public méthode

Checks if this plugin can be activated on the current Elgg installation.
public canActivate ( ) : boolean
Résultat boolean

canDeactivate() public méthode

Checks if this plugin can be deactivated on the current Elgg installation. Validates that this plugin has no active dependants.
public canDeactivate ( ) : boolean
Résultat boolean

canReadFile() protected méthode

Checks whether a plugin file with the given name exists
protected canReadFile ( string $filename ) : boolean
$filename string The name of the file
Résultat boolean

deactivate() public méthode

Deactivates the plugin.
public deactivate ( ) : boolean
Résultat boolean

getAllSettings() public méthode

Returns an array of all settings saved for this plugin.
public getAllSettings ( ) : array
Résultat array An array of key/value pairs.

getAllUserSettings() public méthode

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.
Résultat array An array of key/value pairs.

getAvailableTextFiles() public méthode

Returns an array of available markdown files for this plugin
public getAvailableTextFiles ( ) : array
Résultat array

getError() public méthode

Returns the last error message registered.
public getError ( ) : string | null
Résultat string | null

getFriendlyName() public méthode

Returns the manifest's name if available, otherwise the ID.
Since: 1.8.1
public getFriendlyName ( ) : string
Résultat string

getID() public méthode

Returns the ID (dir name) of this plugin
public getID ( ) : string
Résultat string

getManifest() public méthode

Returns this plugin's \ElggPluginManifest object
public getManifest ( ) : ElggPluginManifest | null
Résultat ElggPluginManifest | null

getPackage() public méthode

Returns this plugin's \ElggPluginPackage object
public getPackage ( ) : ElggPluginPackage | null
Résultat ElggPluginPackage | null

getPath() public méthode

Returns the plugin's full path with trailing slash.
public getPath ( ) : string
Résultat string

getPriority() public méthode

Gets the plugin's load priority.
public getPriority ( ) : integer
Résultat integer

getSetting() public méthode

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
Résultat mixed

getStaticConfig() public méthode

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
Résultat mixed

getUserSetting() public méthode

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
Résultat mixed The setting string value, the default value or false if there is no user

includeFile() protected méthode

Includes one of the plugins files
protected includeFile ( string $filename ) : mixed
$filename string The name of the file
Résultat mixed The return value of the included file (or 1 if there is none)

initializeAttributes() protected méthode

Set subtype to 'plugin'
protected initializeAttributes ( ) : void
Résultat void

isActive() public méthode

Is this plugin active?
public isActive ( ) : boolean
Résultat boolean

isValid() public méthode

Returns if the plugin is complete, meaning has all required files and Elgg can read them and they make sense.
public isValid ( ) : boolean
Résultat boolean

registerActions() protected méthode

Registers the plugin's actions provided in the plugin config file
protected registerActions ( ) : void
Résultat void

registerClasses() protected méthode

Registers the plugin's classes
protected registerClasses ( ) : true
Résultat true

registerLanguages() protected méthode

Registers the plugin's languages
protected registerLanguages ( ) : true
Résultat true

registerViews() protected méthode

Registers the plugin's views
protected registerViews ( ) : void
Résultat void

registerWidgets() protected méthode

Registers the plugin's widgets provided in the plugin config file
protected registerWidgets ( ) : void
Résultat void

save() public méthode

Save the plugin object. Make sure required values exist.
See also: ElggObject::save()
public save ( ) : boolean
Résultat boolean

setID() public méthode

Sets the location of this plugin.
public setID ( string $id ) : boolean
$id string The path to the plugin's dir.
Résultat boolean

setPriority() public méthode

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
Résultat boolean

setSetting() public méthode

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
Résultat boolean

setUserSetting() public méthode

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
Résultat mixed The new setting ID or false

start() public méthode

Start the plugin.
public start ( integer $flags ) : true
$flags integer Start flags for the plugin. See the constants in lib/plugins.php for details.
Résultat true

unsetAllSettings() public méthode

Removes all settings for this plugin.
public unsetAllSettings ( ) : boolean
Résultat boolean

unsetAllUserSettings() public méthode

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.
Résultat boolean

unsetAllUsersSettings() public méthode

Use {@link removeAllUserSettings()} if you just want to remove settings for a single user.
public unsetAllUsersSettings ( ) : boolean
Résultat boolean

unsetSetting() public méthode

Removes a plugin setting name and value.
public unsetSetting ( string $name ) : boolean
$name string The setting name to remove
Résultat boolean

unsetUserSetting() public méthode

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
Résultat boolean