Merge pull request #6927 from kenjis/fix-docs-helpers

docs: improve helpers

Author: kenjis

user_guide_src/source/general/helpers.rst

@@ -32,6 +32,8 @@ global **system/Helpers** directory.
 Loading a Helper
 ================
 
+.. note:: The URL helper is always loaded so you do not need to load it yourself.
+
 Loading a helper file is quite simple using the following method:
 
 .. literalinclude:: helpers/001.php
@@ -44,22 +46,31 @@ For example, to load the **Cookie Helper** file, which is named
 
 .. literalinclude:: helpers/002.php
 
+.. note:: The Helper loading method above does not return a value, so
+    don't try to assign it to a variable. Just use it as shown.
+
+Loading Multiple Helpers
+------------------------
+
 If you need to load more than one helper at a time, you can pass
 an array of file names in and all of them will be loaded:
 
 .. literalinclude:: helpers/003.php
 
+Loading in a Controller
+-----------------------
+
 A helper can be loaded anywhere within your controller methods (or
 even within your View files, although that's not a good practice), as
-long as you load it before you use it. You can load your helpers in your
+long as you load it before you use it.
+
+You can load your helpers in your
 controller constructor so that they become available automatically in
-any function, or you can load a helper in a specific function that needs
+any method, or you can load a helper in a specific method that needs
 it.
 
-.. note:: The Helper loading method above does not return a value, so
-    don't try to assign it to a variable. Just use it as shown.
-
-.. note:: The URL helper is always loaded so you do not need to load it yourself.
+However if you want to load in your controller constructor, you can use the ``$helpers``
+property in Controller instead. See :ref:`Controllers <controllers-helpers>`.
 
 Loading from Non-standard Locations
 -----------------------------------
@@ -73,9 +84,9 @@ sub-directory named **Helpers**. An example will help understand this.
 
 For this example, assume that we have grouped together all of our Blog-related
 code into its own namespace, ``Example\Blog``. The files exist on our server at
-**/Modules/Blog/**. So, we would put our Helper files for the blog module in
-**/Modules/Blog/Helpers/**. A **blog_helper** file would be at
-**/Modules/Blog/Helpers/blog_helper.php**. Within our controller we could
+**Modules/Blog/**. So, we would put our Helper files for the blog module in
+**Modules/Blog/Helpers/**. A **blog_helper** file would be at
+**Modules/Blog/Helpers/blog_helper.php**. Within our controller we could
 use the following command to load the helper for us:
 
 .. literalinclude:: helpers/004.php
@@ -89,7 +100,7 @@ Using a Helper
 Once you've loaded the Helper File containing the function you intend to
 use, you'll call it the way you would a standard PHP function.
 
-For example, to create a link using the ``anchor()`` function in one of
+For example, to create a link using the :php:func:`anchor()` function in one of
 your view files you would do this:
 
 .. literalinclude:: helpers/005.php
@@ -119,7 +130,7 @@ functions:
 
 .. literalinclude:: helpers/006.php
 
-The ``helper()`` method will scan through all PSR-4 namespaces defined in **app/Config/Autoload.php**
+The ``helper()`` function will scan through all PSR-4 namespaces defined in **app/Config/Autoload.php**
 and load in ALL matching helpers of the same name. This allows any module's helpers
 to be loaded, as well as any helpers you've created specifically for this application. The load order
 is as follows:

user_guide_src/source/incoming/controllers.rst

@@ -35,21 +35,26 @@ Included Properties
 
 The CodeIgniter's Controller provides these properties.
 
-**Request Object**
+Request Object
+==============
 
 The application's main :doc:`Request Instance </incoming/incomingrequest>` is always available
 as a class property, ``$this->request``.
 
-**Response Object**
+Response Object
+===============
 
 The application's main :doc:`Response Instance </outgoing/response>` is always available
 as a class property, ``$this->response``.
 
-**Logger Object**
+Logger Object
+=============
 
 An instance of the :doc:`Logger <../general/logging>` class is available as a class property,
 ``$this->logger``.
 
+.. _controllers-helpers:
+
 Helpers
 =======