From 40a2fc8ab781130761237a29455718d24cb23821 Mon Sep 17 00:00:00 2001
From: Derek Jones <derek.jones@ellislab.com>
Date: Tue, 9 Dec 2008 19:41:25 +0000
Subject: added $lowercase parameter to url_title() to allow forced lowercase

---
 system/helpers/url_helper.php      |  7 ++++++-
 user_guide/changelog.html          |  1 +
 user_guide/helpers/url_helper.html | 10 +++++++++-
 3 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/system/helpers/url_helper.php b/system/helpers/url_helper.php
index fd13dc2d4..9b449ea9e 100644
--- a/system/helpers/url_helper.php
+++ b/system/helpers/url_helper.php
@@ -471,7 +471,7 @@ if ( ! function_exists('prep_url'))
  */
 if ( ! function_exists('url_title'))
 {
-	function url_title($str, $separator = 'dash')
+	function url_title($str, $separator = 'dash', $lowercase = FALSE)
 	{
 		if ($separator == 'dash')
 		{
@@ -501,6 +501,11 @@ if ( ! function_exists('url_title'))
 			$str = preg_replace("#".$key."#i", $val, $str);
 		}
 
+		if ($lowercase === TRUE)
+		{
+			$str = strtolower($str);
+		}
+		
 		return trim(stripslashes($str));
 	}
 }
diff --git a/user_guide/changelog.html b/user_guide/changelog.html
index 9c09fabf2..fe7b36d76 100644
--- a/user_guide/changelog.html
+++ b/user_guide/changelog.html
@@ -79,6 +79,7 @@ SVN Revision: </p>
 	</li>	<li>Helpers
 		<ul>
 			<li>Added a doctype() function to the <a href="helpers/html_helper.html">HTML helper</a>.</li>
+			<li>Added ability to force lowercase for url_title() in the <a href="helpers/url_helper.html">URL helper</a>.</li>
 		</ul>
 	</li>
 </ul>
diff --git a/user_guide/helpers/url_helper.html b/user_guide/helpers/url_helper.html
index 53fde2c3a..8bdf59a32 100644
--- a/user_guide/helpers/url_helper.html
+++ b/user_guide/helpers/url_helper.html
@@ -223,9 +223,17 @@ $url_title = url_title($title);<br />
 <br />
 $url_title = url_title($title, 'underscore');<br />
 <br />
-// Produces:  whats_wrong_with_css
+// Produces:  Whats_wrong_with_CSS
 </code>
 
+<p>The third parameter determines whether or not lowercase characters are forced.  By default they are not.  Options are boolean <dfn>TRUE</dfn>/<dfn>FALSE</dfn>:</p>
+
+<code>$title = "What's wrong with CSS?";<br />
+<br />
+$url_title = url_title($title, 'underscore', TRUE);<br />
+<br />
+// Produces:  whats_wrong_with_css
+</code>
 
 <h3>prep_url()</h3>
 <p>This function will add <kbd>http://</kbd> in the event it is missing from a URL.  Pass the URL string to the function like this:</p>
-- 
cgit v1.2.3-24-g4f1b