Differences

This shows you the differences between two versions of the page.

--- vufind2:building_a_view_helper [2012/09/21 17:32] – created demiankatz
+++ development:plugins:view_helpers [2015/12/10 19:13] – ↷ Links adapted because of a move operation demiankatz
@@ Line 1: / Line 1: @@
 ====== Building a View Helper ======
-View helpers are a convenient way of encapsulating logic that is useful during template rendering.  All registered view helpers are accessible as methods of $this within templates.
+View helpers are a convenient way of encapsulating logic that is useful during template rendering.  All registered view helpers are accessible as methods of $this within templates. See the [[http://framework.zend.com/manual/current/en/modules/zend.view.helpers.html|Zend Framework manual]] for more general information. The notes below account for some VuFind-specific details (since VuFind's theme system makes some details slightly different than in a "vanilla" ZF application).
 Creating a view helper is simple:
-  * Pick a namespace for your view helpers.  This should usually be inside a [[customizing_vufind_2.0#modules|custom module]].
+  * Pick a namespace for your view helpers.  This should usually be inside a [[vufind2:customizing_vufind_2.0#modules|custom module]].
-  * In your chosen namespace, create a class that extends \Zend\View\Helper\AbstractHelper.  You can either implement all of your functionality in the class's __invoke() method (in which case you can use the helper with calls like $this->myHelper()) or else you can leave __invoke out and add a number of public methods (in which case you can use the helper with calls like $this->myHelper()->myMethod()).
+  * In your chosen namespace, create a class that extends \Zend\View\Helper\AbstractHelper.  You can either implement all of your functionality in the class's <nowiki>__invoke()</nowiki> method (in which case you can use the helper with calls like <nowiki>$this->myHelper()</nowiki>) or else you can leave <nowiki>__invoke()</nowiki> out and add a number of public methods (in which case you can use the helper with calls like <nowiki>$this->myHelper()->myMethod()</nowiki>).
-  * Create a [[customizing the user interface|custom theme]] if you have not done so already.
+  * Create a [[vufind2:customizing_the_user_interface|custom theme]] if you have not done so already.
-  * Specify your helper namespace with the helper_namespace setting in your theme's theme.ini file (all helpers for a given theme should reside in the same namespace).
+  * Configure the new helper in the 'helpers' section of the theme.config.php file for your current theme.  This is a standard [[http://framework.zend.com/manual/2.0/en/modules/zend.service-manager.quick-start.html|Zend Framework 2 service manager]] configuration with invokables, factories, etc.
-  * Specify the name of your helper by adding a new helpers_to_register[] entry to theme.ini.
 ---- struct data ----
 ----