From eb6db84333c40ed8d15dec5014564120ee0c60e6 Mon Sep 17 00:00:00 2001
From: admin <devnull@localhost>
Date: Sat, 2 Sep 2006 02:39:45 +0000
Subject:

---
 user_guide/libraries/config.html | 32 +++++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

(limited to 'user_guide/libraries')

diff --git a/user_guide/libraries/config.html b/user_guide/libraries/config.html
index c173f5690..ca4773d24 100644
--- a/user_guide/libraries/config.html
+++ b/user_guide/libraries/config.html
@@ -97,6 +97,22 @@ so you will only need to load a config file if you have created your own.</p>
 
 <p>Where <var>filename</var> is the name of your config file, without the .php file extension.</p>
 
+<p>If you need to load multiple config files normally they will be merged into one master config array.  Name collisions can occur, however, if
+you have identically named array indexes in different config files.  To avoid collisions you can set the second parameter to <kbd>TRUE</kbd>
+and each config file will be stored in an array index corresponding to the name of the config file. Example:
+
+<code>
+// Stored in an array with this prototype:  $this->config['blog_settings'] = $config<br />
+$this->config->load('<var>blog_settings</var>', <kbd>TRUE</kbd>);</code>
+
+<p>Please see the section entitled <dfn>Fetching Config Items</dfn> below to learn how to retrieve config items set this way.</p>
+
+<p>The third parameter allows you to suppress errors in the event that a config file does not exist:</p>
+
+<code>$this->config->load('<var>blog_settings</var>', <dfn>FALSE</dfn>, <kbd>TRUE</kbd>);</code>
+
+
+
 </li>
 <li><strong>Auto-loading</strong></li>
 
@@ -109,7 +125,7 @@ indicated in the file.</p>
 
 <h2>Fetching Config Items</h2>
 
-<p>To retrive an item from your config file, use the following function:</p>
+<p>To retrieve an item from your config file, use the following function:</p>
 
 <code>$this->config->item('<var>item name</var>');</code>
 
@@ -119,6 +135,20 @@ indicated in the file.</p>
 
 <p>The function returns FALSE (boolean) if the item you are trying to fetch does not exist.</p>
 
+<p>If you are using the second parameter of the <kbd>$this->config->load</kbd> function in order to assign your config items to a specific index
+you can retrieve it by specifying the index name in the second parameter of the <kbd>$this->config->item()</kbd> function.  Example:
+
+<code>
+// Loads a config file named blog_settings.php and assigns it to an index named "blog_settings"<br />
+$this->config->load('<var>blog_settings</var>', '<kbd>TRUE</kbd>');<br /><br />
+
+// Retrieve a config item named site_name contained within the blog_settings array<br />
+$site_name = $this->config->item('<dfn>site_name</dfn>', '<var>blog_settings</var>');<br /><br />
+
+// An alternate way to specify the same item:<br />
+$blog_config = $this->config->item('<var>blog_settings</var>');<br />
+$site_name = $blog_config['site_name'];</code>
+
 <h2>Setting a Config Item</h2>
 
 <p>If you would like to dynamically set a config item or change an existing one, you can so so using:</p>
-- 
cgit v1.2.3-24-g4f1b