Hook attach

From Sohowiki
(Difference between revisions)
Jump to: navigation, search
m (Reverted edit of UtiNjo, changed back to last version by Lwyau)
Line 17: Line 17:
 
'''The end-result of examples 1 and 2''' is that Pro Edition will include() your script at the designated location (determined by hook id). So when Pro Edition processes header.php and gets to that line with a hook() on it that your plugin has attached to (by calling hook_attach in its install_manifest.php), it basically does this...
 
'''The end-result of examples 1 and 2''' is that Pro Edition will include() your script at the designated location (determined by hook id). So when Pro Edition processes header.php and gets to that line with a hook() on it that your plugin has attached to (by calling hook_attach in its install_manifest.php), it basically does this...
 
<pre>include("[path_your_plugin_folder]/quickedit_js.php");</pre>
 
<pre>include("[path_your_plugin_folder]/quickedit_js.php");</pre>
 +
 +
==Additional Attach Locations==
 +
 +
===pgm-realtime_builder.php:template_loop===
 +
<pre>hook_attach("attachment_file.php", "pgm-realtime_builder.php:template_loop");</pre>
 +
Allows adding code to the beginning of the template parsing loop.  Replace attachment_file.php with your file name.
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]

Revision as of 10:40, 5 June 2008

Syntax
hook_attach(plugin file, hook id name)


What it does 
Includes (attaches) your custom script (plugin file) at a pre-designated place (hook id) in the Pro Edition source code.


Example 1 - What a designated hook looks like in the Pro Edition source code
Taken from in sohoadmin/program/header.php (~line #375 as of v4.9 Beta2)

eval(hook("header.php:top_javascript", basename(__FILE__)));


Example 2 - calling hook attachement() from your install_manifest.php
Taken from QuickEdit Dropdown Menu plugin

hook_attach("quickedit_js.php", "header.php:top_javascript");


The end-result of examples 1 and 2 is that Pro Edition will include() your script at the designated location (determined by hook id). So when Pro Edition processes header.php and gets to that line with a hook() on it that your plugin has attached to (by calling hook_attach in its install_manifest.php), it basically does this...

include("[path_your_plugin_folder]/quickedit_js.php");

Additional Attach Locations

pgm-realtime_builder.php:template_loop

hook_attach("attachment_file.php", "pgm-realtime_builder.php:template_loop");

Allows adding code to the beginning of the template parsing loop. Replace attachment_file.php with your file name.

Personal tools