diff options
-rw-r--r-- | system/helpers/html_helper.php | 130 | ||||
-rw-r--r-- | user_guide/changelog.html | 1 | ||||
-rw-r--r-- | user_guide/helpers/html_helper.html | 54 |
3 files changed, 163 insertions, 22 deletions
diff --git a/system/helpers/html_helper.php b/system/helpers/html_helper.php index 56e25316c..d887be6ce 100644 --- a/system/helpers/html_helper.php +++ b/system/helpers/html_helper.php @@ -182,17 +182,122 @@ if (! function_exists('br')) // ------------------------------------------------------------------------
/**
- * Generates non-breaking space entities based on number supplied
+ * Image
+ *
+ * Generates an image tag
*
* @access public
* @param integer
* @return string
*/
-if (! function_exists('nbs'))
+if (! function_exists('image'))
{
- function nbs($num = 1)
+ function image($src = '', $alt = '', $index_page = FALSE)
{
- return str_repeat(" ", $num);
+ $CI =& get_instance();
+
+ $css = '';
+
+ foreach ($stylesheets as $stylesheet)
+ {
+ if (strpos($stylesheet, '://') !== FALSE)
+ {
+ $href = ' href="'.$stylesheet.'"';
+ }
+ elseif ($index_page === TRUE)
+ {
+ $href = ' href="'.$CI->config->site_url($stylesheet).'"';
+ }
+ else
+ {
+ $href = ' href="'.$CI->config->slash_item('base_url').$stylesheet.'"';
+ }
+
+ $media = ($media !== '') ? ' media="'.$media.'"' : '';
+
+ $css .= 'link type="text/css" rel="stylesheet"'.$href.$media.' />'."\n";
+ }
+
+ return $css;
+ }
+}
+
+// ------------------------------------------------------------------------
+
+/**
+ * Link
+ *
+ * Generates link to a CSS file
+ *
+ * @access public
+ * @param mixed stylesheet name(s)
+ * @param string media type
+ * @param boolean should index_page be added to the css path
+ * @return string
+ */
+if (! function_exists('link'))
+{
+ function link($href = '', $rel = 'stylesheet', $type = 'text/css', $title = '', $media = '', $index_page = FALSE)
+ {
+ $CI =& get_instance();
+
+ $link = 'link ';
+
+ if (is_array($href))
+ {
+ foreach ($href as $k=>$v)
+ {
+ if ($k == 'href' AND strpos($k, '://') === FALSE)
+ {
+ if ($index_page === TRUE)
+ {
+ $link .= ' href="'.$CI->config->site_url($v).'" ';
+ }
+ else
+ {
+ $link .= ' href="'.$CI->config->slash_item('base_url').$v.'" ';
+ }
+ }
+ else
+ {
+ $link .= "$k=\"$v\" ";
+ }
+ }
+
+ $link .= "/>\n";
+ }
+ else
+ {
+ if ( strpos($href, '://') !== FALSE)
+ {
+ $link .= ' href="'.$href.'" ';
+ }
+ elseif ($index_page === TRUE)
+ {
+ $link .= ' href="'.$CI->config->site_url($href).'" ';
+ }
+ else
+ {
+ $link .= ' href="'.$CI->config->slash_item('base_url').$href.'" ';
+ }
+
+ $link .= 'rel="'.$rel.'" type="'.$type.'" ';
+
+ if ($media != '')
+ {
+ $link .= 'media="'.$media.'" ';
+ }
+
+ if ($title != '')
+ {
+ $link .= 'title="'.$title.'" ';
+ }
+
+ $link .= '/>'."\n";
+ }
+
+
+ return $link;
}
}
@@ -219,4 +324,21 @@ if (! function_exists('meta')) }
}
+// ------------------------------------------------------------------------
+
+/**
+ * Generates non-breaking space entities based on number supplied
+ *
+ * @access public
+ * @param integer
+ * @return string
+ */
+if (! function_exists('nbs'))
+{
+ function nbs($num = 1)
+ {
+ return str_repeat(" ", $num);
+ }
+}
+
?>
\ No newline at end of file diff --git a/user_guide/changelog.html b/user_guide/changelog.html index c37b0951c..2ccfbd88c 100644 --- a/user_guide/changelog.html +++ b/user_guide/changelog.html @@ -131,6 +131,7 @@ Change Log <li>Helpers & Plugins
<ul>
+ <li>Added link() to the <a href="./helpers/html_helper.html">HTML helper.</a></li>
<li>Added ability to <a href="./general/helpers.html">"extend" Helpers</a>.</li>
<li>Added an <a href="./helpers/email_helper.html">email helper</a> into core helpers.</li>
<li>Added <kbd>strip_quotes()</kbd> function to <a href="./helpers/string_helper.html">string helper</a>.</li>
diff --git a/user_guide/helpers/html_helper.html b/user_guide/helpers/html_helper.html index e07f27778..7abe01af9 100644 --- a/user_guide/helpers/html_helper.html +++ b/user_guide/helpers/html_helper.html @@ -68,16 +68,49 @@ Directory Helper <p>The following functions are available:</p>
+<h2>br()</h2>
+<p>Generates line break tags (<br />) based on the number you submit. Example:</p>
+<code>echo br(3);</code>
+<p>The above would produce: <br /><br /><br /></p>
<h2>heading()</h2>
-
<p>Lets you create HTML <h1> tags. The first parameter will contain the data, the
second the size of the heading. Example:</p>
-
<code>echo heading('Welcome!', 3);</code>
-
<p>The above would produce: <h3>Welcome!</h3></p>
+<h2>link()</h2>
+<p>Lets you create HTML <link /> tags. The parameters are href, with optional rel, type, title, media and index_page. index_page is a TRUE/FALSE value that specifics if the href should have the page specified by $config['index_page'] added to the address it creates.</p>
+<p>While stylesheets are more conveniently handled through the stylesheet() function, they can also be called here.</p>
+<code>
+link('css/mystyles.css');<br />
+ // gives <link href="http://site.com/css/mystyles.css" rel="stylesheet" type="text/css" /></code>
+<p>Further examples:</p>
+
+<code>
+link('favicon.ico', 'shortcut icon', 'image/ico');<br />
+ // <link href="http://site.com/favicon.ico" rel="shortcut icon" type="image/ico" /> </p>
+<br />
+<br />
+link('feed', 'alternate', 'application/rss+xml', 'My RSS Feed');<br />
+ // <link href="http://site.com/feed" rel="alternate" type="application/rss+xml" title="My RSS Feed" /> <br />
+<br />
+
+<br />
+$link = array(<br />
+ 'href' => 'css/printer.css',<br />
+ 'rel' => 'stylesheet',<br />
+ 'type' => 'text/css',<br />
+ 'media' => 'print'<br />
+ );<br />
+ <br />
+ link($link);<br />
+ // <link href="http://site.com/css/printer.css" rel="stylesheet" type="text/css" media="print" /></code>
+
+<h2>nbs()</h2>
+<p>Generates non-breaking spaces (&nbsp;) based on the number you submit. Example:</p>
+<code>echo nbs(3);</code>
+<p>The above would produce: &nbsp;&nbsp;&nbsp;</p>
<h2>ol() and ul()</h2>
@@ -196,21 +229,6 @@ echo ul($list);</code> </ul>
</code>
-
-<h2>nbs()</h2>
-<p>Generates non-breaking spaces (&nbsp;) based on the number you submit. Example:</p>
-<code>echo nbs(3);</code>
-<p>The above would produce: &nbsp;&nbsp;&nbsp;</p>
-
-
-<h2>br()</h2>
-<p>Generates line break tags (<br />) based on the number you submit. Example:</p>
-<code>echo br(3);</code>
-<p>The above would produce: <br /><br /><br /></p>
-
-
-
-
</div>
<!-- END CONTENT -->
|