<?php

/**
 * CodeIgniter
 *
 * An open source application development framework for PHP
 *
 * This content is released under the MIT License (MIT)
 *
 * Copyright (c) 2019 - 2022, CodeIgniter Foundation
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * @package CodeIgniter
 * @author  EllisLab Dev Team
 * @copyright   Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
 * @copyright   Copyright (c) 2014 - 2019, British Columbia Institute of Technology (https://bcit.ca/)
 * @copyright   Copyright (c) 2019 - 2022, CodeIgniter Foundation (https://codeigniter.com/)
 * @license https://opensource.org/licenses/MIT MIT License
 * @link    https://codeigniter.com
 * @since   Version 1.0.0
 * @filesource
 */

defined('BASEPATH') or exit('No direct script access allowed');

/**
 * CodeIgniter HTML Helpers
 *
 * @package     CodeIgniter
 * @subpackage  Helpers
 * @category    Helpers
 * @author      EllisLab Dev Team
 * @link        https://codeigniter.com/userguide3/helpers/html_helper.html
 */

// ------------------------------------------------------------------------

if (! function_exists('heading')) {
    /**
     * Heading
     *
     * Generates an HTML heading tag.
     *
     * @param   string  content
     * @param   int heading level
     * @param   string
     * @return  string
     */
    function heading($data = '', $h = '1', $attributes = '')
    {
        return '<h' . $h . _stringify_attributes($attributes) . '>' . $data . '</h' . $h . '>';
    }
}

// ------------------------------------------------------------------------

if (! function_exists('ul')) {
    /**
     * Unordered List
     *
     * Generates an HTML unordered list from an single or multi-dimensional array.
     *
     * @param   array
     * @param   mixed
     * @return  string
     */
    function ul($list, $attributes = '')
    {
        return _list('ul', $list, $attributes);
    }
}

// ------------------------------------------------------------------------

if (! function_exists('ol')) {
    /**
     * Ordered List
     *
     * Generates an HTML ordered list from an single or multi-dimensional array.
     *
     * @param   array
     * @param   mixed
     * @return  string
     */
    function ol($list, $attributes = '')
    {
        return _list('ol', $list, $attributes);
    }
}

// ------------------------------------------------------------------------

if (! function_exists('_list')) {
    /**
     * Generates the list
     *
     * Generates an HTML ordered list from an single or multi-dimensional array.
     *
     * @param   string
     * @param   mixed
     * @param   mixed
     * @param   int
     * @return  string
     */
    function _list($type = 'ul', $list = array(), $attributes = '', $depth = 0)
    {
        // If an array wasn't submitted there's nothing to do...
        if (! is_array($list)) {
            return $list;
        }

        // Set the indentation based on the depth
        $out = str_repeat(' ', $depth)
            // Write the opening list tag
            . '<' . $type . _stringify_attributes($attributes) . ">\n";

        // Cycle through the list elements.  If an array is
        // encountered we will recursively call _list()

        static $_last_list_item = '';
        foreach ($list as $key => $val) {
            $_last_list_item = $key;

            $out .= str_repeat(' ', $depth + 2) . '<li>';

            if (! is_array($val)) {
                $out .= $val;
            } else {
                $out .= $_last_list_item . "\n" . _list($type, $val, '', $depth + 4) . str_repeat(' ', $depth + 2);
            }

            $out .= "</li>\n";
        }

        // Set the indentation for the closing tag and apply it
        return $out . str_repeat(' ', $depth) . '</' . $type . ">\n";
    }
}

// ------------------------------------------------------------------------

if (! function_exists('img')) {
    /**
     * Image
     *
     * Generates an <img /> element
     *
     * @param   mixed
     * @param   bool
     * @param   mixed
     * @return  string
     */
    function img($src = '', $index_page = false, $attributes = '')
    {
        if (! is_array($src)) {
            $src = array('src' => $src);
        }

        // If there is no alt attribute defined, set it to an empty string
        if (! isset($src['alt'])) {
            $src['alt'] = '';
        }

        $img = '<img';

        foreach ($src as $k => $v) {
            if ($k === 'src' && ! preg_match('#^(data:[a-z,;])|(([a-z]+:)?(?<!data:)//)#i', $v)) {
                if ($index_page === true) {
                    $img .= ' src="' . get_instance()->config->site_url($v) . '"';
                } else {
                    $img .= ' src="' . get_instance()->config->base_url($v) . '"';
                }
            } else {
                $img .= ' ' . $k . '="' . $v . '"';
            }
        }

        return $img . _stringify_attributes($attributes) . ' />';
    }
}

// ------------------------------------------------------------------------

if (! function_exists('doctype')) {
    /**
     * Doctype
     *
     * Generates a page document type declaration
     *
     * Examples of valid options: html5, xhtml-11, xhtml-strict, xhtml-trans,
     * xhtml-frame, html4-strict, html4-trans, and html4-frame.
     * All values are saved in the doctypes config file.
     *
     * @param   string  type    The doctype to be generated
     * @return  string
     */
    function doctype($type = 'xhtml1-strict')
    {
        static $doctypes;

        if (! is_array($doctypes)) {
            if (file_exists(APPPATH . 'config/doctypes.php')) {
                include(APPPATH . 'config/doctypes.php');
            }

            if (file_exists(APPPATH . 'config/' . ENVIRONMENT . '/doctypes.php')) {
                include(APPPATH . 'config/' . ENVIRONMENT . '/doctypes.php');
            }

            if (empty($_doctypes) or ! is_array($_doctypes)) {
                $doctypes = array();
                return false;
            }

            $doctypes = $_doctypes;
        }

        return isset($doctypes[$type]) ? $doctypes[$type] : false;
    }
}

// ------------------------------------------------------------------------

if (! function_exists('link_tag')) {
    /**
     * Link
     *
     * Generates link to a CSS file
     *
     * @param   mixed   stylesheet hrefs or an array
     * @param   string  rel
     * @param   string  type
     * @param   string  title
     * @param   string  media
     * @param   bool    should index_page be added to the css path
     * @return  string
     */
    function link_tag($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' && ! preg_match('#^([a-z]+:)?//#i', $v)) {
                    if ($index_page === true) {
                        $link .= 'href="' . $CI->config->site_url($v) . '" ';
                    } else {
                        $link .= 'href="' . $CI->config->base_url($v) . '" ';
                    }
                } else {
                    $link .= $k . '="' . $v . '" ';
                }
            }
        } else {
            if (preg_match('#^([a-z]+:)?//#i', $href)) {
                $link .= 'href="' . $href . '" ';
            } elseif ($index_page === true) {
                $link .= 'href="' . $CI->config->site_url($href) . '" ';
            } else {
                $link .= 'href="' . $CI->config->base_url($href) . '" ';
            }

            $link .= 'rel="' . $rel . '" type="' . $type . '" ';

            if ($media !== '') {
                $link .= 'media="' . $media . '" ';
            }

            if ($title !== '') {
                $link .= 'title="' . $title . '" ';
            }
        }

        return $link . "/>\n";
    }
}

// ------------------------------------------------------------------------

if (! function_exists('meta')) {
    /**
     * Generates meta tags from an array of key/values
     *
     * @param   array
     * @param   string
     * @param   string
     * @param   string
     * @return  string
     */
    function meta($name = '', $content = '', $type = 'name', $newline = "\n")
    {
        // Since we allow the data to be passes as a string, a simple array
        // or a multidimensional one, we need to do a little prepping.
        if (! is_array($name)) {
            $name = array(array('name' => $name, 'content' => $content, 'type' => $type, 'newline' => $newline));
        } elseif (isset($name['name'])) {
            // Turn single array into multidimensional
            $name = array($name);
        }

        $str = '';
        foreach ($name as $meta) {
            $type       = (isset($meta['type']) && $meta['type'] !== 'name') ? 'http-equiv' : 'name';
            $name       = isset($meta['name']) ? $meta['name'] : '';
            $content    = isset($meta['content']) ? $meta['content'] : '';
            $newline    = isset($meta['newline']) ? $meta['newline'] : "\n";

            $str .= '<meta ' . $type . '="' . $name . '" content="' . $content . '" />' . $newline;
        }

        return $str;
    }
}

// ------------------------------------------------------------------------

if (! function_exists('br')) {
    /**
     * Generates HTML BR tags based on number supplied
     *
     * @deprecated  3.0.0   Use str_repeat() instead
     * @param   int $count  Number of times to repeat the tag
     * @return  string
     */
    function br($count = 1)
    {
        return str_repeat('<br />', $count);
    }
}

// ------------------------------------------------------------------------

if (! function_exists('nbs')) {
    /**
     * Generates non-breaking space entities based on number supplied
     *
     * @deprecated  3.0.0   Use str_repeat() instead
     * @param   int
     * @return  string
     */
    function nbs($num = 1)
    {
        return str_repeat('&nbsp;', $num);
    }
}