b2evolution

Multilingual multiuser multiblog engine

b2evolution Technical Documentation (CVS HEAD) [ class tree: plugins ] [ index: plugins ] [ all elements ]

Class: auto_p_plugin

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

Class auto_p_plugin

Class Overview

The Auto-P Plugin.

It wraps text blocks, which are devided by newline(s) into HTML P tags (paragraphs) and optionally replaces single newlines with BR tags (line breaks).

Located in /blogs/plugins/_auto_p.plugin.php [line 20]

Plugin
   |
   --auto_p_plugin

Properties

Methods

[ Top ]
Inherited Properties, Constants, and Methods
Inherited Properties Inherited Methods Inherited Constants

Inherited From Plugin

Plugin::$author
Plugin::$help_url
Plugin::$ping_service_name
Plugin::$ping_service_note
Plugin::$sub_group

Inherited From Plugin

Plugin::Plugin()
Constructor.
Plugin::AdminAfterEvobarInit()
Event handler: Gets invoked in /toolbar.inc.php after the menu structure is built.
Plugin::AdminAfterMenuInit()
Event handler: Gets invoked in /admin.php for every backoffice page after the menu structure is built. 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::AdminBeforeItemEditDelete()
Event handler: Called before an item gets deleted (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::AdminDisplayCommentFormFieldset()
Event handler: Called at the end of the "Edit comment" form.
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::AfterCollectionDelete()
Event handler: called at the end of deleting a blog from the database.
Plugin::AfterCollectionInsert()
Event handler: called at the end of inserting a blog into the database, which means it has been created.
Plugin::AfterCollectionUpdate()
Event handler: called at the end of updating a blog in the database.
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.
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.
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::AfterTrackbackInsert()
Event handler: Gets called after a trackback has been recorded.
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::AppendHitLog()
Event handler: Called when a hit gets logged, but before it gets recorded.
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::BeforeSessionsDelete()
Event handler: Called before pruning sessions. The plugin can prevent deletion of particular sessions, by returning their IDs.
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::DisplayProfileFormFieldset()
Event handler: Called at the end of the "User profile" form.
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 default settings here.
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/trackback.
Plugin::get_class_id()
Get a string, unqiue for the plugin, usable in HTML form elements.
Plugin::get_coll_setting()
Get a skin specific param value from current Blog
Plugin::get_coll_setting_definitions()
Define here default collection/blog settings that are to be made available in the backoffice.
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::get_tools_tab_url()
Get URL for the tools tab for this plugin.
Plugin::get_widget_param_definitions()
Get definitions for widget specific editable params
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::LoginAttemptNeedsRawPassword()
Event handler: your Plugin should return true here, if it needs a raw (un-hashed) password for the Plugin::LoginAttempt() event. If any Plugin returns true for this event, client-side hashing of the password is not used.
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::ProfileFormSent()
Event handler: Called before at the beginning, if a profile form gets sent (and received).
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_coll_setting()
Set a skin specific param value for current Blog
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::SkinEndHtmlBody()
Event handler: Called at the end of the skin's HTML BODY section.
Plugin::SkinTag()
Called when a plugin gets called by its @{link $code}.
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::TS_()
Translate and escape single quotes.
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, when they get accessed.

[ Top ]
Property Summary
mixed   $apply_rendering  
string   $block_tags   List of block elements (we want a paragraph before and after), excludes: address, added: td, th
mixed   $br_allowed_in  
mixed   $code  
mixed   $group  
mixed   $long_desc  
mixed   $name  
mixed   $number_of_installs  
mixed   $priority  
mixed   $p_allowed_in  
mixed   $short_desc  
mixed   $version  

[ Top ]
Method Summary
string   autobr()   Add "
" to the end of newlines, which do not end with "
" already and which aren't the last line, if the "Auto-BR" setting is enabled.
array   GetDefaultSettings()  
string   handle_blocks()   - Split text into blocks, using $block_tags pattern.
string   handle_br()   Handles adding BR.
string   handle_pre_blocks()   Handle text which may contain inline tags
array   handle_pre_blocks_helper()   This is a helper for handling blocks from handle_pre_blocks_helper().
void   PluginInit()   Init
void   RenderItemAsHtml()   Perform rendering
array   split_text_for_tag()   Split the text for a given tag, mainly to find the closing tag.

[ Top ]
Properties
mixed   $apply_rendering = 'opt-in' [line 26]

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

[ Top ]
string   $block_tags = 'blockquote|dd|div|dl|dt|fieldset|form|h[1-6]|hr|li|object|ol|p|pre|select|script|table|td|th|ul' [line 36]

List of block elements (we want a paragraph before and after), excludes: address, added: td, th


[ Top ]
mixed   $br_allowed_in = array(
// Block level:
'address', 'center', 'dd', 'dir', 'div', 'dt', 'fieldset', 'form', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'isindex', 'menu', 'noframes', 'noscript', 'p', 'pre',
// Inline:
'a', 'abbr', 'acronym', 'applet', 'b', 'basefont', 'bdo', 'big', 'button', 'cite', 'code', 'dfn', 'em', 'font', 'i', 'img', 'input', 'iframe', 'kbd', 'label', 'li', 'map', 'object', 'q', 'samp', 'select', 'small', 'span', 'strong', 'sub', 'sup', 'textarea', 'td', 'th', 'tt', 'var' )
[line 42]

[ Top ]
mixed   $code = 'b2WPAutP' [line 22]

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

[ Top ]
mixed   $group = 'rendering' [line 27]

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

[ Top ]
mixed   $long_desc [line 29]

Redefinition of:
Plugin::$long_desc
Plugin long description.

[ Top ]
mixed   $name = 'Auto P' [line 23]

Redefinition of:
Plugin::$name
Default plugin name as it will appear in lists.

[ Top ]
mixed   $number_of_installs = 1 [line 30]

Redefinition of:
Plugin::$number_of_installs
Number of allowed installs.

[ Top ]
mixed   $priority = 70 [line 24]

Redefinition of:
Plugin::$priority
Default priority.

[ Top ]
mixed   $p_allowed_in = array('address', 'applet', 'blockquote', 'body', 'button', 'center', 'dd', 'del', 'div', 'fieldset', 'form', 'iframe', 'ins', 'li', 'map', 'noframes', 'noscript', 'object', 'td', 'th' ) [line 39]

[ Top ]
mixed   $short_desc [line 28]

Redefinition of:
Plugin::$short_desc
Plugin short description.

[ Top ]
mixed   $version = '3.3' [line 25]

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

[ Top ]
Methods
autobr  [line 623]

  string autobr( $text, [ $replace_last = true]  )

Add "
" to the end of newlines, which do not end with "
" already and which aren't the last line, if the "Auto-BR" setting is enabled.

Parameters:
   $text: 
   $replace_last: 


[ Top ]
GetDefaultSettings  [line 63]

  array GetDefaultSettings( )



Redefinition of:
Plugin::GetDefaultSettings()
Define default settings here.

[ Top ]
handle_blocks  [line 126]

  string handle_blocks( string $text, [string $in_tag = '']  )

- Split text into blocks, using $block_tags pattern.

Parameters:
string   $text:  Text
string   $in_tag:  The HTML tag where $text is in


[ Top ]
handle_br  [line 520]

  string handle_br( $text, $in_tag  )

Handles adding BR.

Parameters:
   $text: 
   $in_tag: 


[ Top ]
handle_pre_blocks  [line 196]

  string handle_pre_blocks( string $text, string $in_tag  )

Handle text which may contain inline tags

  • Explode by \n\n
  • Merge blocks that span over multiple tags
  • Apply BR to blocks
  • Wrap block in P

Parameters:
string   $text:  Text
string   $in_tag:  Tag where $text is in


[ Top ]
handle_pre_blocks_helper  [line 433]

  array handle_pre_blocks_helper( $block, $in_tag, $wrap_in_p, [ $ignore_NL = true]  )

This is a helper for handling blocks from handle_pre_blocks_helper().

What comes here is supposed to have no block tags.

Parameters:
   $block: 
   $in_tag: 
   $wrap_in_p: 
   $ignore_NL: 

API Tags:
Return:  array( $text, $has_p )


[ Top ]
PluginInit  [line 52]

  void PluginInit( &$params  )

Init

Parameters:
   &$params: 


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

[ Top ]
RenderItemAsHtml  [line 91]

  void RenderItemAsHtml( &$params  )

Perform rendering

Parameters:
   &$params: 


Redefinition of:
Plugin::RenderItemAsHtml()
Event handler: Called when rendering item/post contents as HTML. (CACHED)

[ Top ]
split_text_for_tag  [line 543]

  array split_text_for_tag( $tag, &$text_after_tag  )

Split the text for a given tag, mainly to find the closing tag.

Parameters:
   $tag: 
   &$text_after_tag: 


[ Top ]

Documentation generated on Sat, 06 Mar 2010 04:00:49 +0100 by phpDocumentor 1.4.2. This site is hosted and maintained by Daniel HAHLER (Contact).