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
파일 보기 프로젝트 열기: elgg/elgg 1 사용 예제들

공개 메소드들

메소드 설명
__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