b2evolution

Multilingual multiuser multiblog engine

b2evolution Technical Documentation (Version 1.10) [ class tree: plugins ] [ index: plugins ] [ all elements ]

Class: generic_ping_plugin

Source Location: /blogs/plugins/_generic_ping.plugin.php

Class generic_ping_plugin

Inherited Properties, Constants, and Methods
Inherited Properties Inherited Methods Inherited Constants

Inherited From Plugin

Plugin::$long_desc
Plugin::$name
Plugin::$number_of_installs
Plugin::$ping_service_name
Plugin::$ping_service_note
Plugin::$short_desc
Plugin::$sub_group

Inherited From Plugin

Plugin::Plugin()
Constructor.
Plugin::AdminAfterMenuInit()
Event handler: Gets invoked in /admin/_header.php for every backoffice page after the menu structure is build. You could use the $AdminUI object to modify it.
Plugin::AdminAfterPageFooter()
Event handler: Called right after displaying the admin page footer.
Plugin::AdminBeforeItemEditCreate()
Event handler: Called before a new item gets created (in the backoffice).
Plugin::AdminBeforeItemEditUpdate()
Event handler: Called before an existing item gets updated (in the backoffice).
Plugin::AdminBeginPayload()
Event handler: Gets invoked before the main payload in the backoffice.
Plugin::AdminDisplayEditorButton()
Event handler: Called when displaying editor buttons.
Plugin::AdminDisplayItemFormFieldset()
Event handler: Called at the end of the "Edit item" form.
Plugin::AdminDisplayToolbar()
Event handler: Called when displaying editor toolbars.
Plugin::AdminEndHtmlHead()
Event handler: Called when ending the admin html head section.
Plugin::AdminTabAction()
Event handler: Method that gets invoked when our tab is selected.
Plugin::AdminTabPayload()
Event handler: Gets invoked when our tab is selected and should get displayed.
Plugin::AdminToolAction()
Event handler: Called when handling actions for the "Tools" menu.
Plugin::AdminToolPayload()
Event handler: Called when displaying the block in the "Tools" menu.
Plugin::AfterCommentDelete()
Event handler: called at the end of deleting a comment from the database.
Plugin::AfterCommentFormInsert()
Event handler: Called when a comment form has been processed and the comment got inserted into DB.
Plugin::AfterCommentInsert()
Event handler: called at the end of inserting a comment into the database, which means it has been created.
Plugin::AfterCommentUpdate()
Event handler: called at the end of updating a comment in the database, which means that it has changed.
Plugin::AfterInstall()
Event handler: Called after the plugin has been installed.
Plugin::AfterItemDelete()
Event handler: called at the end of deleting an item/post from the database.
Plugin::AfterItemInsert()
Event handler: called at the end of inserting a item/post into the database, which means it has been created.
Plugin::AfterItemUpdate()
Event handler: called at the end of updating an item/post in the database, which means that it has been changed.
Plugin::AfterLoginAnonymousUser()
Event handler: Called at the end of the login procedure, if the user is anonymous ($current_User NOT set).
Plugin::AfterLoginRegisteredUser()
Event handler: Called at the end of the login procedure, if the $current_User is set and the user is therefor registered.
Plugin::AfterUserDelete()
Event handler: called at the end of deleting an user from the database.
Plugin::AfterUserInsert()
Event handler: called at the end of inserting an user account into the database, which means it has been created.
Plugin::AfterUserRegistration()
Event handler: Called when a new user has registered and got created.
Plugin::AfterUserUpdate()
Event handler: called at the end of updating an user account in the database, which means that it has been changed.
Plugin::AlternateAuthentication()
Event handler: called at the end of the login process, if the user did not try to login (by sending "login" and "pwd"), the session has no user attached or only "login" is given.
Plugin::AppendItemPreviewTransact()
Event handler: called when instantiating an Item for preview.
Plugin::AppendUserRegistrTransact()
Event handler: Called when a new user has registered, at the end of the DB transaction that created this user.
Plugin::are_events_available()
Check if the requested list of events is provided by any or one plugin.
Plugin::BeforeBlogDisplay()
Event handler: Called before a blog gets displayed (in _blog_main.inc.php).
Plugin::BeforeCommentFormInsert()
Event handler: Called before a comment gets inserted through the public comment form.
Plugin::BeforeDisable()
Event handler: Your plugin gets notified here, just before it gets disabled.
Plugin::BeforeEnable()
Event handler: Called when the admin tries to enable the plugin, changes its configuration/settings and after installation.
Plugin::BeforeInstall()
Event handler: Called before the plugin is going to be installed.
Plugin::BeforeTrackbackInsert()
Event handler: called before a trackback gets recorded.
Plugin::BeforeUninstall()
Event handler: Called before the plugin is going to be un-installed.
Plugin::BeforeUninstallPayload()
Event handler: Gets invoked to display the payload before uninstalling the plugin.
Plugin::CacheIsCollectingContent()
Event handler: gets asked for if we are generating cached content.
Plugin::CacheObjects()
Event handler: called to cache object data.
Plugin::CachePageContent()
Event handler: called to cache page content (get cached content or request caching).
Plugin::CaptchaPayload()
Event handler: general event to inject payload for a captcha test.
Plugin::CaptchaValidated()
Event handler: general event to validate a captcha which payload was added through CaptchaPayload().
Plugin::CaptchaValidatedCleanup()
Event handler: general event to be called after an action has been taken, which involved CaptchaPayload() and CaptchaValidated().
Plugin::CommentFormSent()
Event handler: Called before at the beginning, if a comment form gets sent (and received).
Plugin::debug_log()
Log a debug message.
Plugin::disable_event()
Disable an event.
Plugin::DisplayCommentFormButton()
Event handler: Called in the submit button section of the frontend comment form.
Plugin::DisplayCommentFormFieldset()
Event handler: Called at the end of the frontend comment form.
Plugin::DisplayCommentToolbar()
Event handler: Called when displaying editor toolbars.
Plugin::DisplayItemAsHtml()
Event handler: Called when displaying an item/post's content as HTML.
Plugin::DisplayItemAsText()
Event handler: Called when displaying an item/post's content as text.
Plugin::DisplayItemAsXml()
Event handler: Called when displaying an item/post's content as XML.
Plugin::DisplayLoginFormFieldset()
Event handler: Called at the end of the "Login" form.
Plugin::DisplayMessageFormButton()
Event handler: Called in the submit button section of the frontend message form.
Plugin::DisplayMessageFormFieldset()
Event handler: Called at the end of the frontend message form, which allows to send an email to a user/commentator.
Plugin::DisplayRegisterFormFieldset()
Event handler: Called at the end of the "Register as new user" form.
Plugin::DisplaySkin()
Event handler: Display a skin. Use Plugin::GetProvidedSkins() to return a list of names that you register.
Plugin::DisplayTrackbackAddr()
Event handler: called to display the URL that accepts trackbacks for an item.
Plugin::DisplayValidateAccountFormFieldset()
Event handler: Called at the end of the "Validate user account" form, which gets invoked if newusers_mustvalidate is enabled and the user has not been validated yet.
Plugin::enable_event()
Enable an event.
Plugin::ExecCronJob()
Execute/handle a cron job, which has been scheduled by the admin out of the list that the Plugin provides (see GetCronJobs()).
Plugin::FilterCommentAuthor()
Event handler: called to filter the comment's author name (blog name for trackbacks)
Plugin::FilterCommentAuthorUrl()
Event handler: called to filter the comment's author URL.
Plugin::FilterCommentContent()
Event handler: called to filter the comment's content
Plugin::FilterIpAddress()
Event handler: Called when an IP address gets displayed, typically in a protected area or for a privileged user, e.g. in the backoffice statistics menu.
Plugin::forget_events()
Call this to unregister all your events for the current request.
Plugin::GetCronJobs()
This method gets asked for a list of cronjobs that the plugin provides.
Plugin::GetDbLayout()
This method should return your DB schema, consisting of a list of CREATE TABLE queries.
Plugin::GetDefaultSettings()
Define here default settings that are then available in the backoffice.
Plugin::GetDefaultUserSettings()
Define here default user settings that are then available in the backoffice.
Plugin::GetDependencies()
Get the list of dependencies that the plugin has.
Plugin::GetExtraEvents()
This method gets asked when plugins get installed and allows you to return a list of extra events, which your plugin triggers itself (e.g. through $Plugins->trigger_event()).
Plugin::GetHtsrvMethods()
Override this method to define methods/functions that you want to make accessible through /htsrv/call_plugin.php, which allows you to call those methods by HTTP request.
Plugin::GetProvidedSkins()
Event handler: Gets asked about a list of skin names that the plugin handles.
Plugin::GetSpamKarmaForComment()
Event handler: Called to ask the plugin for the spam karma of a comment.
Plugin::get_class_id()
Get a string, unqiue for the plugin, usable in HTML form elements.
Plugin::get_edit_settings_link()
Get a link to edit the Plugin's settings (if the user has permission).
Plugin::get_help_file()
Get the help file for a Plugin ID. README.LOCALE.html will take precedence above the general (english) README.html.
Plugin::get_help_link()
Get a link to a help page (with icon).
Plugin::get_help_url()
Get the plugin's external help/website URL.
Plugin::get_htsrv_url()
Get the URL to call a plugin method through http. This links to the /htsrv/call_plugin.php file.
Plugin::get_plugin_url()
Get the absolute URL to the plugin's directory (where the plugins classfile is).
Plugin::get_README_link()
Plugin::get_sql_table()
Get canonical name for database tables a plugin uses, by adding an unique prefix for your plugin instance.
Plugin::ItemApplyAsRenderer()
Event handler: Does your Plugin want to apply as a renderer for the item?
Plugin::ItemCanComment()
Event handler: the plugin gets asked if an item can receive feedback/comments.
Plugin::ItemSendPing()
Event handler: send a ping about a new item.
Plugin::ItemViewsIncreased()
Event handler: Called when the view counter of an item got increased.
Plugin::LoginAttempt()
Event handler: called when a user attemps to login.
Plugin::Logout()
Event handler: called when a user logs out.
Plugin::MessageFormSent()
Event handler: Called when a message form has been submitted.
Plugin::MessageFormSentCleanup()
Event handler: Called after a message has been sent through the public email form.
Plugin::msg()
A simple wrapper around the $Messages object with a default catgory of 'note'.
Plugin::PluginInit()
Init the Plugin after it has been registered/instantiated.
Plugin::PluginSettingsEditAction()
Event handler: Called as action before displaying the "Edit plugin" form, which includes the display of the Plugin::Settings.
Plugin::PluginSettingsEditDisplayAfter()
Event handler: Called after the form to edit the Plugin::Settings has been displayed.
Plugin::PluginSettingsUpdateAction()
Event handler: Called as action just before updating the Plugin::Settings.
Plugin::PluginSettingsValidateSet()
Event handler: Called before displaying or setting a plugin's setting in the backoffice.
Plugin::PluginUserSettingsEditAction()
Event handler: Called as action before displaying the "Edit user" form, which includes the display of the Plugin::UserSettings.
Plugin::PluginUserSettingsEditDisplayAfter()
Event handler: Called after the form to edit the Plugin::UserSettings has been displayed.
Plugin::PluginUserSettingsUpdateAction()
Event handler: Called as action just before updating the Plugin::UserSettings.
Plugin::PluginUserSettingsValidateSet()
Event handler: Called before displaying or setting a plugin's user setting in the backoffice.
Plugin::PluginVersionChanged()
Event handler: Called when we detect a version change (in Plugins::register()).
Plugin::PrependItemInsertTransact()
Event handler: called at the beginning of inserting an item/post in the database.
Plugin::PrependItemUpdateTransact()
Event handler: called at the beginning of updating an item/post in the database.
Plugin::RegisterFormSent()
Event handler: Called when a "Register as new user" form has been submitted.
Plugin::register_menu_entry()
Register a tab (sub-menu) for the backoffice Tools menus.
Plugin::RenderItemAsHtml()
Event handler: Called when rendering item/post contents as HTML. (CACHED)
Plugin::RenderItemAsText()
Event handler: Called when rendering item/post contents other than XML or HTML.
Plugin::RenderItemAsXml()
Event handler: Called when rendering item/post contents as XML.
Plugin::SessionLoaded()
Event handler: Called after initializing plugins, DB, Settings, Hit, .. but quite early.
Plugin::session_delete()
Delete a value from the session data, using a unique prefix to the Plugin.
Plugin::session_get()
Get a data value for the session, using a unique prefix to the Plugin.
Plugin::session_set()
Set a data value for the session.
Plugin::set_status()
Set the status of the plugin.
Plugin::SkinBeginHtmlHead()
Event handler: Called at the beginning of the skin's HTML HEAD section.
Plugin::stop_propagation()
Stop propagation of the event to next plugins (with lower priority) in events that get triggered for a batch of Plugins.
Plugin::T_()
Translate a given string, in the Plugin's context.
Plugin::ValidateAccountFormSent()
Event handler: Called when a "Validate user account" form has been submitted.
Plugin::__get()
PHP5 overloading of get method to lazy-load (User)Settings.

[ Top ]
Property Summary
mixed   $apply_rendering  
mixed   $author  
mixed   $code   Variables below MUST be overriden by plugin implementations, either in the subclass declaration or in the subclass constructor.
mixed   $group  
mixed   $help_url  
mixed   $priority  
mixed   $version  

[ Top ]
Method Summary
void   BeforeEnable()   Check ping service URL and plugin code.
array   GetDefaultSettings()   Get the settings that the plugin can use.
void   ItemSendPing()   Send a ping to the configured service.
false|array   parse_ping_url()   Parse a given ping service URL
void   PluginInit()   Init
void   PluginSettingsValidateSet()   Check ping service URL.

[ Top ]
Properties
mixed   $apply_rendering = 'never' [line 55]

Redefinition of:
Plugin::$apply_rendering
If this is a rendering plugin, when should rendering apply?

[ Top ]
mixed   $author = 'The b2evo Group' [line 49]

Redefinition of:
Plugin::$author
Plugin author.

[ Top ]
mixed   $code = '' [line 46]

Variables below MUST be overriden by plugin implementations, either in the subclass declaration or in the subclass constructor.


Redefinition of:
Plugin::$code
Globally unique code for this plugin functionality. 32 chars. MUST BE SET.

[ Top ]
mixed   $group = 'ping' [line 56]

Redefinition of:
Plugin::$group
Main group of the plugin.

[ Top ]
mixed   $help_url = '' [line 50]

Redefinition of:
Plugin::$help_url
URL for more info about the plugin, author and new versions.

[ Top ]
mixed   $priority = 50 [line 47]

Redefinition of:
Plugin::$priority
Default priority.

[ Top ]
mixed   $version = '1.9-dev' [line 48]

Redefinition of:
Plugin::$version
Plugin version number (max 42 chars, so obscure CVS Revision keywords get handled).

[ Top ]
Methods
BeforeEnable  [line 119]

  void BeforeEnable( )

Check ping service URL and plugin code.



Redefinition of:
Plugin::BeforeEnable()
Event handler: Called when the admin tries to enable the plugin, changes its configuration/settings and after installation.

[ Top ]
GetDefaultSettings  [line 88]

  array GetDefaultSettings( )

Get the settings that the plugin can use.

Those settings are transfered into a Settings member object of the plugin and can be edited in the backoffice (Settings / Plugins).


API Tags:
See:  Plugin::PluginSettingsValidateSet()
See:  PluginSettings
See:  Plugin::GetDefaultSettings()


Redefinition of:
Plugin::GetDefaultSettings()
Define here default settings that are then available in the backoffice.

[ Top ]
ItemSendPing  [line 176]

  void ItemSendPing( &$params  )

Send a ping to the configured service.

Parameters:
   &$params: 


Redefinition of:
Plugin::ItemSendPing()
Event handler: send a ping about a new item.

[ Top ]
parse_ping_url  [line 156]

  false|array parse_ping_url( $url  )

Parse a given ping service URL

Parameters:
   $url: 

API Tags:
Return:  False in case of error, array with keys 'host', 'port', 'path' otherwise


[ Top ]
PluginInit  [line 64]

  void PluginInit( &$params  )

Init

This gets called after a plugin has been registered/instantiated.

Parameters:
   &$params: 


Redefinition of:
Plugin::PluginInit()
Init the Plugin after it has been registered/instantiated.

[ Top ]
PluginSettingsValidateSet  [line 139]

  void PluginSettingsValidateSet( &$params  )

Check ping service URL.

Parameters:
   &$params: 


Redefinition of:
Plugin::PluginSettingsValidateSet()
Event handler: Called before displaying or setting a plugin's setting in the backoffice.

[ Top ]

Documentation generated on Tue, 20 May 2008 01:41:08 +0200 by phpDocumentor 1.4.2