* @copyright Copyright (c) Alex Tselegidis
* @license https://opensource.org/licenses/GPL-3.0 - GPLv3
* @link https://easyappointments.org
* @since v1.4.0
* ---------------------------------------------------------------------------- */
if (!function_exists('e')) {
/**
* HTML escape function for templates.
*
* Use this helper function to easily escape all the outputted HTML markup.
*
* Example:
*
*
*
* @param mixed $string Provide anything that can be converted to a string.
*/
function e(mixed $string): string
{
return htmlspecialchars((string) $string, ENT_QUOTES, 'UTF-8');
}
}
if (!function_exists('component')) {
/**
* Render a component from the "views/components/*.php" directory.
*
* Use this helper function to easily include components into your HTML markup.
*
* Any loaded template variables will also be available at the component template, but you may also specify
* additional values by adding values to the $params parameter.
*
* Example:
*
* echo component('timezones_dropdown', ['attributes' => 'class"form-control"'], TRUE);
*
* @param string $component Component template file name.
* @param array $vars Additional parameters for the component.
* @param bool $return Whether to return the HTML or echo it directly.
*
* @return string|object Return the HTML if the $return argument is TRUE or NULL.
*/
function component(string $component, array $vars = [], bool $return = false): string|object
{
/** @var EA_Controller $CI */
$CI = get_instance();
return $CI->load->view('components/' . $component, $vars, $return);
}
}
if (!function_exists('extend')) {
/**
* Use this function at the top of view files to mark the layout you are extending from.
*
* @param $layout
*/
function extend($layout): void
{
config([
'layout' => [
'filename' => $layout,
'sections' => [],
'tmp' => [],
],
]);
}
}
if (!function_exists('section')) {
/**
* Use this function in view files to mark the beginning and/or end of a layout section.
*
* Sections will only be used if the view file extends a layout and will be ignored otherwise.
*
* Example:
*
*
*
*
*
* This is the content of the section.
*
*
*
*
*
* @param string $name
*/
function section(string $name): void
{
$layout = config('layout');
if (array_key_exists($name, $layout['tmp'])) {
$layout['sections'][$name][] = ob_get_clean();
unset($layout['tmp'][$name]);
config(['layout' => $layout]);
return;
}
if (empty($layout['sections'][$name])) {
$layout['sections'][$name] = [];
}
$layout['tmp'][$name] = '';
config(['layout' => $layout]);
ob_start();
}
}
if (!function_exists('end_section')) {
/**
* Use this function in view files to mark the end of a layout section.
*
* Sections will only be used if the view file extends a layout and will be ignored otherwise.
*
* Example:
*
*
*
*
*
* This is the content of the section.
*
*
*
*
*
* @param string $name
*/
function end_section(string $name): void
{
$layout = config('layout');
if (array_key_exists($name, $layout['tmp'])) {
$layout['sections'][$name][] = ob_get_clean();
unset($layout['tmp'][$name]);
config(['layout' => $layout]);
}
}
}
if (!function_exists('slot')) {
/**
* Use this function in view files to mark a slot that sections can populate from within child templates.
*
* @param string $name
*/
function slot(string $name): void
{
$layout = config('layout');
$section = $layout['sections'][$name] ?? null;
echo '' . PHP_EOL;
if (!$section) {
return;
}
foreach ($section as $content) {
echo $content;
}
}
}
if (!function_exists('pure_html')) {
/**
* Use this function in order to render HTML that comes from a text editor or similar, but strip the JS from it.
*
* @param string $markup
*
* @return string
*/
function pure_html(string $markup): string
{
$config = HTMLPurifier_Config::createDefault();
$purifier = new HTMLPurifier($config);
return $purifier->purify($markup);
}
}