phpBB Development Wiki - Recent changes [en]

Event List

2012-05-15T22:47:42Z

Added Events (Hook Locations):

Category:Events and Listeners

2012-05-15T17:39:20Z

Why are listeners helpful?:

Umil.table column update

2012-05-12T08:37:08Z

Example #4:

Creating modules

2012-05-11T17:30:37Z

Brief Tutorial: fixed class name in mcp/info example

Category:Events and Listeners

2012-05-11T10:16:05Z

Should be Add listeners, which needs to be added

Mcp/info

2012-05-10T23:33:26Z

@@ Line 52: / Line 52: @@
 |- id="core.ucp_modules"
 | [[#core.ucp_modules|core.ucp_modules]] || ucp.php || $module || 3.1 Alpha || Can be used to hide modules in the UCP
-|- id="core.viewforum_forumrow"
+|- id="core.viewforum_topicrow"
-| [[#core.core.viewforum_forumrow|core.viewforum_forumrow]] || viewforum.php || $forumrow || 3.1 Alpha || Modifies the forumrow variables
+| [[#core.viewforum_topicrow|core.viewforum_topicrow]] || viewforum.php || $topicrow || 3.1 Alpha || Modifies the topicrow array
 |- id="core.viewonline_get_userdata"
 | [[#core.viewonline_get_userdata|core.viewonline_get_userdata]] || viewonline.php || $sql_ary || 3.1 Alpha || Modifies the query-array which grabs the data for the userlist

@@ Line 15: / Line 15: @@
 ==Why are listeners helpful?==
-In olympus one of the problems with phpBB was MOD installation was difficult. It required editing files and this could be done manually or you would have to download a tool separation. This made things hard for end users when updating and when installing multiple MODs they could conflict.
+MOD installation in phpBB 3.0 (Olympus) was difficult because it required code modification to the core phpBB files. Such edits either had to be done manually  or a separate tool had to be installed to perform automatic changes. Because core files were changed from their original state, administrators often had trouble updating their phpBB version or installing more MODs because the code that was being looked for during the update or MOD installation was no longer present in its original state.
-In 3.1 one of the aims was to make this easier. As such an installer was included in the core and the events & listeners system was recreated as the previous hooks system didn't fit the requirements of the MOD Authors Community. This means that file edits are no longer needed making MOD creation alot easier.
+One of the aims of phpBB 3.1 (Ascraeus) is to make the extension of default functionality much easier without causing problems in the future with updating. Instead of MODs, our customisations community is encouraged to create Extensions and to hook their functionality into the core by the use of Event Listeners.
 ==How do I use a listener?==

@@ Line 57: / Line 57: @@
 ===Example #4===
-In UMIL automatix syntax:
+In UMIL automatic syntax:
 <php>'table_column_update' => array(
 		array('phpbb_test', 'test_foo' , array('VCHAR', '')),

@@ Line 34: / Line 34: @@
 The chosen mode (defined in the mcp/info file) is available in the $mode parameter. Of course you can also use all features ([[Template system]], [[DBAL]], etc.) you know from normal phpBB pages. You just need to globalize variables like $db or $template, because your code is now running inside a function and not in the global scope. Here is a more advanced example:
-<php>class mcp_foo
+<php>class mcp_foo_info
+{
 	var $p_master;

@@ Line 20: / Line 20: @@
 ==How do I use a listener?==
-Create a file in your extension which uses the identifier to hook into the code and inject the code you need into the core or modify the data you need. For more information see the [[Add_Events]] page.
+Create a file in your extension which uses the identifier to hook into the code and inject the code you need into the core or modify the data you need. For more information see the [[Add_Listeners]] page.
 = Terminology =

← Older revision		Revision as of 23:33, 10 May 2012
Line 1:		Line 1:
−	The '''mcp/info/''' directory is used to contain the install uninstall and title information for modes of modules installed in the [[Moderator Control Panel]]	+	The '''mcp/info/''' directory is used to contain the install, uninstall and title information for modes of modules installed in the [[Moderator Control Panel]]

	==Example Info Page==		==Example Info Page==