Display

Complexity

Total Complexity

406

Size/Duplication

Total Lines	3037
Duplicated Lines	0 %

Importance

Changes	3
Bugs	0	Features	0

80 Methods

Rating	Name	Duplication	Size	Complexity
A	badgeGroup()	0	9	2
A	return_sortable_table()	0	23	1
A	return_introduction_section()	0	4	1
A	returnIconPath()	0	3	1
B	display_sortable_config_table()	0	40	11
F	encrypted_mailto_link()	0	71	14
A	display_introduction_section()	0	6	1
B	display_sortable_table()	0	33	10
A	__construct()	0	2	1
B	display_footer()	0	49	8
A	get_alphabet_options()	0	13	3
A	toolList()	0	12	1
A	display_reduced_header()	0	6	1
A	display_header()	0	11	1
A	display_no_header()	0	8	1
A	display_reduced_footer()	0	3	1
A	get_numeric_options()	0	14	4
A	return_sortable_grid()	0	26	2
B	return_message()	0	33	10
A	display_sortable_grid()	0	21	1
A	url()	0	9	2
A	div()	0	3	1
F	return_icon()	0	84	17
A	span()	0	3	1
B	img()	0	33	7
A	tag()	0	18	5
A	tabsOnlyLink()	0	33	4
A	groupButton()	0	9	2
C	select()	0	61	13
A	button()	0	7	2
A	advancedPanelStart()	0	32	2
A	paginationIndicator()	0	9	3
A	page_subheader()	0	9	2
A	groupButtonWithDropDown()	0	47	2
B	returnFontAwesomeIcon()	0	33	10
C	getSessionTitleBox()	0	66	12
A	grid_html()	0	6	1
A	prose()	0	6	1
B	getMdiIcon()	0	34	8
A	tip()	0	9	2
A	randomColor()	0	25	3
F	parsePaginationItem()	0	58	16
A	getVCardUserLink()	0	3	1
A	page_header()	0	14	4
A	table()	0	27	6
A	getFrameReadyBlock()	0	28	3
A	bar_progress()	0	24	4
A	panel()	0	37	5
B	progressPaginationBar()	0	49	10
A	getMdiIconSimple()	0	32	5
F	return_rating_system()	0	43	11
B	input()	0	41	10
A	toolbarButton()	0	22	4
A	getPagination()	0	17	5
A	toolbarAction()	0	25	4
A	noDataView()	0	15	1
A	dateToStringAgoAndLongDate()	0	13	4
A	page_header_and_translate()	0	5	1
A	addFlash()	0	12	6
B	getMediaPlayer()	0	30	10
A	contentPanel()	0	7	2
A	getProfileEditionLink()	0	8	2
A	description()	0	13	3
B	toolbarGradeAction()	0	26	7
A	advancedPanelEnd()	0	3	1
F	tabs()	0	101	16
F	grid_js()	0	206	33
A	page_subheader3()	0	3	1
A	actions()	0	13	3
A	label()	0	19	2
B	panelCollapse()	0	69	6
A	returnPrimeIcon()	0	23	4
B	fileHtmlGuesser()	0	27	8
A	page_subheader2()	0	3	1
A	getMdiIconTranslate()	0	12	2
C	getFlash()	0	38	12
A	getUserCard()	0	21	4
B	mySpaceMenu()	0	108	7
A	get_icon_path()	0	3	1
B	sessionSubscriptionPage()	0	102	6

<?php

/* For licensing terms, see /license.txt */

use Chamilo\CoreBundle\Entity\ExtraField;

This use statement conflicts with another class in this namespace, ExtraField. Consider defining an alias.

use Chamilo\CoreBundle\Entity\ExtraFieldValues;
use Chamilo\CoreBundle\Enums\ActionIcon;
use Chamilo\CoreBundle\Enums\ObjectIcon;
use Chamilo\CoreBundle\Enums\StateIcon;
use Chamilo\CoreBundle\Enums\ToolIcon;
use Chamilo\CoreBundle\Framework\Container;
use Chamilo\CoreBundle\Helpers\ThemeHelper;
use ChamiloSession as Session;
use Symfony\Component\HttpFoundation\Response;

/**
 * Class Display
 * Contains several public functions dealing with the display of
 * table data, messages, help topics, ...
 *
 * Include/require it in your code to use its public functionality.
 * There are also several display public functions in the main api library.
 *
 * All public functions static public functions inside a class called Display,
 * so you use them like this: e.g.
 * Display::return_message($message)
 */
class Display
{
    /** @var Template */
    public static $global_template;
    public static $preview_style = null;
    public static $legacyTemplate;

    public function __construct()
    {
    }

    /**
     * @return array
     */
    public static function toolList()
    {
        return [
            'group',
            'work',
            'glossary',
            'forum',
            'course_description',
            'gradebook',
            'attendance',
            'course_progress',
            'notebook',
        ];
    }

    /**
     * Displays the page header.
     *
     * @param string The name of the page (will be showed in the page title)
     * @param string Optional help file name
     * @param string $page_header
     */
    public static function display_header(
        $tool_name = '',
        $help = null,
        $page_header = null
    ) {
        global $interbreadcrumb;
        $interbreadcrumb[] = ['url' => '#', 'name' => $tool_name];

        ob_start();

        return true;
    }

    /**
     * Displays the reduced page header (without banner).
     */
    public static function display_reduced_header()
    {
        ob_start();
        self::$legacyTemplate = '@ChamiloCore/Layout/no_layout.html.twig';

        return true;
    }

    /**
     * Display no header.
     */
    public static function display_no_header()
    {
        global $tool_name, $show_learnpath;
        self::$global_template = new Template(
            $tool_name,
            false,
            false,
            $show_learnpath
        );
    }

    /**
     * Display the page footer.
     */
    public static function display_footer()
    {
        $contents = ob_get_contents();
        if (ob_get_length()) {
            ob_end_clean();
        }
        $tpl = '@ChamiloCore/Layout/layout_one_col.html.twig';
        if (!empty(self::$legacyTemplate)) {
            $tpl = self::$legacyTemplate;
        }
        $response = new Response();
        $params['content'] = $contents;

$params was never initialized. Although not strictly required by PHP, it is generally a good practice to add $params = array(); before regardless.

        global $interbreadcrumb, $htmlHeadXtra;

        $courseInfo = api_get_course_info();
        if (!empty($courseInfo)) {
            $url = $courseInfo['course_public_url'];
            $sessionId = api_get_session_id();
            if (!empty($sessionId)) {
                $url .= '?sid='.$sessionId;
            }

            if (!empty($interbreadcrumb)) {
                array_unshift(
                    $interbreadcrumb,
                    ['name' => $courseInfo['title'], 'url' => $url]
                );
            }
        }

        if (empty($interbreadcrumb)) {
            $interbreadcrumb = [];
        } else {
            $interbreadcrumb = array_filter(
                $interbreadcrumb,
                function ($item) {
                    return isset($item['name']) && !empty($item['name']);
                }
            );
        }

        $params['legacy_javascript'] = $htmlHeadXtra;
        $params['legacy_breadcrumb'] = json_encode(array_values($interbreadcrumb));

        Template::setVueParams($params);
        $content = Container::getTwig()->render($tpl, $params);
        $response->setContent($content);
        $response->send();
        exit;

Using exit here is not recommended.

    }

    /**
     * Display the page footer.
     */
    public static function display_reduced_footer()
    {
        return self::display_footer();

Are you sure the usage of self::display_footer() targeting Display::display_footer() seems to always return null.

    }

    /**
     * Displays the tool introduction of a tool.
     *
     * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
     *
     * @param string $tool          these are the constants that are used for indicating the tools
     * @param array  $editor_config Optional configuration settings for the online editor.
     *                              return: $tool return a string array list with the "define" in main_api.lib
     *
     * @return string html code for adding an introduction
     */
    public static function display_introduction_section(
        $tool,
        $editor_config = null
    ) {
        // @todo replace introduction section with a vue page.
        return;
    }

    /**
     * @param string $tool
     * @param array  $editor_config
     */
    public static function return_introduction_section(
        $tool,
        $editor_config = null
    ) {
    }

    /**
     * Displays a table.
     *
     * @param array  $header          Titles for the table header
     *                                each item in this array can contain 3 values
     *                                - 1st element: the column title
     *                                - 2nd element: true or false (column sortable?)
     *                                - 3th element: additional attributes for
     *                                th-tag (eg for column-width)
     *                                - 4the element: additional attributes for the td-tags
     * @param array  $content         2D-array with the tables content
     * @param array  $sorting_options Keys are:
     *                                'column' = The column to use as sort-key
     *                                'direction' = SORT_ASC or SORT_DESC
     * @param array  $paging_options  Keys are:
     *                                'per_page_default' = items per page when switching from
     *                                full-    list to per-page-view
     *                                'per_page' = number of items to show per page
     *                                'page_nr' = The page to display
     * @param array  $query_vars      Additional variables to add in the query-string
     * @param array  $form_actions
     * @param string $style           The style that the table will show. You can set 'table' or 'grid'
     * @param string $tableName
     * @param string $tableId
     *
     * @author bart.mollet@hogent.be
     */
    public static function display_sortable_table(
        $header,
        $content,
        $sorting_options = [],
        $paging_options = [],
        $query_vars = null,
        $form_actions = [],
        $style = 'table',
        $tableName = 'tablename',
        $tableId = ''
    ) {
        $column = $sorting_options['column'] ?? 0;
        $default_items_per_page = $paging_options['per_page'] ?? 20;
        $table = new SortableTableFromArray($content, $column, $default_items_per_page, $tableName, null, $tableId);
        if (is_array($query_vars)) {
            $table->set_additional_parameters($query_vars);
        }
        if ('table' === $style) {
            if (is_array($header) && count($header) > 0) {
                foreach ($header as $index => $header_item) {
                    $table->set_header(
                        $index,
                        isset($header_item[0]) ? $header_item[0] : null,
                        isset($header_item[1]) ? $header_item[1] : null,
                        isset($header_item[2]) ? $header_item[2] : null,
                        isset($header_item[3]) ? $header_item[3] : null
                    );
                }
            }
            $table->set_form_actions($form_actions);
            $table->display();
        } else {
            $table->display_grid();
        }
    }

    /**
     * Returns an HTML table with sortable column (through complete page refresh).
     *
     * @param array  $header
     * @param array  $content         Array of row arrays
     * @param array  $sorting_options
     * @param array  $paging_options
     * @param array  $query_vars
     * @param array  $form_actions
     * @param string $style
     *
     * @return string HTML string for array
     */
    public static function return_sortable_table(
        $header,
        $content,
        $sorting_options = [],
        $paging_options = [],
        $query_vars = null,
        $form_actions = [],
        $style = 'table'
    ) {
        ob_start();
        self::display_sortable_table(
            $header,
            $content,
            $sorting_options,
            $paging_options,
            $query_vars,
            $form_actions,
            $style
        );
        $content = ob_get_contents();
        ob_end_clean();

        return $content;
    }

    /**
     * Shows a nice grid.
     *
     * @param string grid name (important to create css)
     * @param array header content
     * @param array array with the information to show
     * @param array $paging_options Keys are:
     *                              'per_page_default' = items per page when switching from
     *                              full-    list to per-page-view
     *                              'per_page' = number of items to show per page
     *                              'page_nr' = The page to display
     *                              'hide_navigation' =  true to hide the navigation
     * @param array $query_vars     Additional variables to add in the query-string
     * @param mixed An array with bool values to know which columns show.
     * i.e: $visibility_options= array(true, false) we will only show the first column
     *                Can be also only a bool value. TRUE: show all columns, FALSE: show nothing
     */
    public static function display_sortable_grid(
        $name,
        $header,
        $content,
        $paging_options = [],
        $query_vars = null,
        $form_actions = [],
        $visibility_options = true,
        $sort_data = true,
        $grid_class = []
    ) {
        echo self::return_sortable_grid(
            $name,
            $header,
            $content,
            $paging_options,
            $query_vars,
            $form_actions,
            $visibility_options,
            $sort_data,
            $grid_class
        );
    }

    /**
     * Gets a nice grid in html string.
     *
     * @param string grid name (important to create css)
     * @param array header content
     * @param array array with the information to show
     * @param array $paging_options Keys are:
     *                              'per_page_default' = items per page when switching from
     *                              full-    list to per-page-view
     *                              'per_page' = number of items to show per page
     *                              'page_nr' = The page to display
     *                              'hide_navigation' =  true to hide the navigation
     * @param array $query_vars     Additional variables to add in the query-string
     * @param mixed An array with bool values to know which columns show. i.e:
     *  $visibility_options= array(true, false) we will only show the first column
     *    Can be also only a bool value. TRUE: show all columns, FALSE: show nothing
     * @param bool  true for sorting data or false otherwise
     * @param array grid classes
     *
     * @return string html grid
     */
    public static function return_sortable_grid(
        $name,
        $header,
        $content,
        $paging_options = [],
        $query_vars = null,
        $form_actions = [],
        $visibility_options = true,
        $sort_data = true,
        $grid_class = [],
        $elementCount = 0
    ) {
        $column = 0;
        $default_items_per_page = $paging_options['per_page'] ?? 20;
        $table = new SortableTableFromArray($content, $column, $default_items_per_page, $name);
        $table->total_number_of_items = (int) $elementCount;
        if (is_array($query_vars)) {
            $table->set_additional_parameters($query_vars);
        }

        return $table->display_simple_grid(
            $visibility_options,
            $paging_options['hide_navigation'],
            $default_items_per_page,
            $sort_data,
            $grid_class
        );
    }

    /**
     * Displays a table with a special configuration.
     *
     * @param array $header          Titles for the table header
     *                               each item in this array can contain 3 values
     *                               - 1st element: the column title
     *                               - 2nd element: true or false (column sortable?)
     *                               - 3th element: additional attributes for th-tag (eg for column-width)
     *                               - 4the element: additional attributes for the td-tags
     * @param array $content         2D-array with the tables content
     * @param array $sorting_options Keys are:
     *                               'column' = The column to use as sort-key
     *                               'direction' = SORT_ASC or SORT_DESC
     * @param array $paging_options  Keys are:
     *                               'per_page_default' = items per page when switching from full list to per-page-view
     *                               'per_page' = number of items to show per page
     *                               'page_nr' = The page to display
     * @param array $query_vars      Additional variables to add in the query-string
     * @param array $column_show     Array of binaries 1= show columns 0. hide a column
     * @param array $column_order    An array of integers that let us decide how the columns are going to be sort.
     *                               i.e:  $column_order=array('1''4','3','4'); The 2nd column will be order like the 4th column
     * @param array $form_actions    Set optional forms actions
     *
     * @author Julio Montoya
     */
    public static function display_sortable_config_table(
        $table_name,
        $header,
        $content,
        $sorting_options = [],
        $paging_options = [],
        $query_vars = null,
        $column_show = [],
        $column_order = [],
        $form_actions = []
    ) {
        $column = isset($sorting_options['column']) ? $sorting_options['column'] : 0;
        $default_items_per_page = isset($paging_options['per_page']) ? $paging_options['per_page'] : 20;

        $table = new SortableTableFromArrayConfig(
            $content,
            $column,
            $default_items_per_page,
            $table_name,
            $column_show,
            $column_order
        );

        if (is_array($query_vars)) {
            $table->set_additional_parameters($query_vars);
        }
        // Show or hide the columns header
        if (is_array($column_show)) {
            for ($i = 0; $i < count($column_show); $i++) {

It seems like you are calling the size function count() as part of the test condition. You might want to compute the size beforehand, and not on each iteration.

                if (!empty($column_show[$i])) {
                    $val0 = isset($header[$i][0]) ? $header[$i][0] : null;
                    $val1 = isset($header[$i][1]) ? $header[$i][1] : null;
                    $val2 = isset($header[$i][2]) ? $header[$i][2] : null;
                    $val3 = isset($header[$i][3]) ? $header[$i][3] : null;
                    $table->set_header($i, $val0, $val1, $val2, $val3);
                }
            }
        }
        $table->set_form_actions($form_actions);
        $table->display();
    }

    /**
     * Returns a div html string with.
     *
     * @param string $message
     * @param string $type    Example: confirm, normal, warning, error
     * @param bool $filter  Whether to XSS-filter or not
     *
     * @return string Message wrapped into an HTML div
     */
    public static function return_message(string $message, string $type = 'normal', bool $filter = true): string
    {
        if (empty($message)) {
            return '';
        }

        if ($filter) {
            $message = api_htmlentities(
                $message,
                ENT_QUOTES
            );
        }

        $class = '';
        switch ($type) {
            case 'warning':
                $class .= 'alert alert-warning';
                break;
            case 'error':
                $class .= 'alert alert-danger';
                break;
            case 'confirmation':
            case 'confirm':
            case 'success':
                $class .= 'alert alert-success';
                break;
            case 'normal':
            case 'info':
            default:
                $class .= 'alert alert-info';
        }

        return self::div($message, ['class' => $class]);
    }

    /**
     * Returns an encrypted mailto hyperlink.
     *
     * @param string  e-mail

The doc comment e-mail at position 0 could not be parsed: Unknown type name 'e-mail' at position 0 in e-mail.

     * @param string  clickable text
     * @param string  optional, class from stylesheet
     * @param bool $addExtraContent
     *
     * @return string encrypted mailto hyperlink
     */
    public static function encrypted_mailto_link(
        $email,
        $clickable_text = null,
        $style_class = '',
        $addExtraContent = false
    ) {
        if (is_null($clickable_text)) {
            $clickable_text = $email;
        }

        // "mailto:" already present?
        if ('mailto:' !== substr($email, 0, 7)) {
            $email = 'mailto:'.$email;
        }

        // Class (stylesheet) defined?
        if ('' !== $style_class) {
            $style_class = ' class="'.$style_class.'"';
        }

        // Encrypt email
        $hmail = '';
        for ($i = 0; $i < strlen($email); $i++) {
            $hmail .= '&#'.ord($email[$i]).';';
        }

        $value = ('true' === api_get_setting('profile.add_user_course_information_in_mailto'));

        if ($value) {
            if ('false' === api_get_setting('allow_email_editor')) {
                $hmail .= '?';
            }

            if (!api_is_anonymous()) {
                $hmail .= '&subject='.Security::remove_XSS(api_get_setting('siteName'));
            }
            if ($addExtraContent) {
                $content = '';
                if (!api_is_anonymous()) {
                    $userInfo = api_get_user_info();
                    $content .= get_lang('User').': '.$userInfo['complete_name']."\n";

                    $courseInfo = api_get_course_info();
                    if (!empty($courseInfo)) {
                        $content .= get_lang('Course').': ';
                        $content .= $courseInfo['name'];
                        $sessionInfo = api_get_session_info(api_get_session_id());
                        if (!empty($sessionInfo)) {
                            $content .= ' '.$sessionInfo['name'].' <br />';
                        }
                    }
                }
                $hmail .= '&body='.rawurlencode($content);
            }
        }

        $hclickable_text = '';
        // Encrypt clickable text if @ is present
        if (strpos($clickable_text, '@')) {
            for ($i = 0; $i < strlen($clickable_text); $i++) {
                $hclickable_text .= '&#'.ord($clickable_text[$i]).';';
            }
        } else {
            $hclickable_text = @htmlspecialchars(
                $clickable_text,
                ENT_QUOTES,
                api_get_system_encoding()
            );
        }
        // Return encrypted mailto hyperlink
        return '<a href="'.$hmail.'"'.$style_class.' class="clickable_email_link">'.$hclickable_text.'</a>';
    }

    /**
     * Prints an <option>-list with all letters (A-Z).
     *
     * @todo This is English language specific implementation.
     * It should be adapted for the other languages.
     *
     * @return string
     */
    public static function get_alphabet_options($selectedLetter = '')
    {
        $result = '';
        for ($i = 65; $i <= 90; $i++) {
            $letter = chr($i);
            $result .= '<option value="'.$letter.'"';
            if ($selectedLetter == $letter) {
                $result .= ' selected="selected"';
            }
            $result .= '>'.$letter.'</option>';
        }

        return $result;
    }

    /**
     * Get the options withing a select box within the given values.
     *
     * @param int   Min value
     * @param int   Max value
     * @param int   Default value
     *
     * @return string HTML select options
     */
    public static function get_numeric_options($min, $max, $selected_num = 0)
    {
        $result = '';
        for ($i = $min; $i <= $max; $i++) {
            $result .= '<option value="'.$i.'"';
            if (is_int($selected_num)) {
                if ($selected_num == $i) {
                    $result .= ' selected="selected"';
                }
            }
            $result .= '>'.$i.'</option>';
        }

        return $result;
    }

    /**
     * Gets the path of an icon.
     *
     * @param string $icon
     * @param int    $size
     *
     * @return string
     */
    public static function returnIconPath($icon, $size = ICON_SIZE_SMALL)
    {
        return self::return_icon($icon, null, null, $size, null, true, false);
    }

    /**
     * This public function returns the htmlcode for an icon.
     *
     * @param string   The filename of the file (in the main/img/ folder
     * @param string   The alt text (probably a language variable)
     * @param array    Additional attributes (for instance height, width, onclick, ...)
     * @param int  The wanted width of the icon (to be looked for in the corresponding img/icons/ folder)
     *
     * @return string An HTML string of the right <img> tag
     *
     * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University 2006
     * @author Julio Montoya 2010 Function improved, adding image constants
     * @author Yannick Warnier 2011 Added size handler
     *
     * @version Feb 2011
     */
    public static function return_icon(
        string $image,
        ?string $alt_text = '',
        ?array $additional_attributes = [],
        ?int $size = ICON_SIZE_SMALL,
        ?bool $show_text = true,
        ?bool $return_only_path = false,
        ?bool $loadThemeIcon = true
    ) {
        $code_path = api_get_path(SYS_PUBLIC_PATH);
        $w_code_path = api_get_path(WEB_PUBLIC_PATH);
        // The following path is checked to see if the file exists. It's
        // important to use the public path (i.e. web/css/) rather than the
        // internal path (/app/Resource/public/css/) because the path used
        // in the end must be the public path
        $alternateCssPath = api_get_path(SYS_PUBLIC_PATH).'css/';
        $alternateWebCssPath = api_get_path(WEB_PUBLIC_PATH).'css/';

        // Avoid issues with illegal string offset for legacy calls to this
        // method with an empty string rather than null or an empty array
        if (empty($additional_attributes)) {
            $additional_attributes = [];
        }

        $image = trim($image);

        if (isset($size)) {
            $size = (int) $size;
        } else {
            $size = ICON_SIZE_SMALL;
        }

        $size_extra = $size.'/';
        $icon = $w_code_path.'img/'.$image;
        $theme = 'themes/chamilo/icons/';

        if ($loadThemeIcon) {
            // @todo with chamilo 2 code
            $theme = 'themes/'.api_get_visual_theme().'/icons/';
            if (is_file($alternateCssPath.$theme.$image)) {
                $icon = $alternateWebCssPath.$theme.$image;
            }
            // Checking the theme icons folder example: var/themes/chamilo/icons/XXX
            if (is_file($alternateCssPath.$theme.$size_extra.$image)) {
                $icon = $alternateWebCssPath.$theme.$size_extra.$image;
            } elseif (is_file($code_path.'img/icons/'.$size_extra.$image)) {
                //Checking the main/img/icons/XXX/ folder
                $icon = $w_code_path.'img/icons/'.$size_extra.$image;
            }
        } else {
            if (is_file($code_path.'img/icons/'.$size_extra.$image)) {
                // Checking the main/img/icons/XXX/ folder
                $icon = $w_code_path.'img/icons/'.$size_extra.$image;
            }
        }

        if ($return_only_path) {
            $svgImage = substr($image, 0, -3).'svg';
            if (is_file($code_path.$theme.'svg/'.$svgImage)) {
                $icon = $w_code_path.$theme.'svg/'.$svgImage;
            } elseif (is_file($code_path.'img/icons/svg/'.$svgImage)) {
                $icon = $w_code_path.'img/icons/svg/'.$svgImage;
            }

            if (empty($additional_attributes['height'])) {
                $additional_attributes['height'] = $size;
            }
            if (empty($additional_attributes['width'])) {
                $additional_attributes['width'] = $size;
            }
        }

        if ($return_only_path) {
            return $icon;
        }

        $img = self::img($icon, $alt_text, $additional_attributes);
        if (SHOW_TEXT_NEAR_ICONS && !empty($alt_text)) {
            if ($show_text) {
                $img = "$img $alt_text";
            }
        }

        return $img;
    }

    /**
     * Returns the HTML code for an image.
     *
     * @param string $image_path            the filename of the file (in the main/img/ folder
     * @param ?string $alt_text              the alt text (probably a language variable)
     * @param ?array  $additional_attributes (for instance, height, width, onclick, ...)
     * @param ?bool   $filterPath            Optional. Whether filter the image path. Default is true
     *
     * @return string
     *
     * @author Julio Montoya 2010
     */
    public static function img(
        string $image_path,
        ?string $alt_text = '',
        ?array $additional_attributes = null,
        ?bool $filterPath = true
    ): string {
        if (empty($image_path)) {
            return '';
        }
        // Sanitizing the parameter $image_path
        if ($filterPath) {
            $image_path = Security::filter_img_path($image_path);
        }

        // alt text = the image name if there is none provided (for XHTML compliance)
        if ('' == $alt_text) {
            $alt_text = basename($image_path);
        }

        if (empty($additional_attributes)) {
            $additional_attributes = [];
        }

        $additional_attributes['src'] = $image_path;

        if (empty($additional_attributes['alt'])) {
            $additional_attributes['alt'] = $alt_text;
        }
        if (empty($additional_attributes['title'])) {
            $additional_attributes['title'] = $alt_text;
        }

        return self::tag('img', '', $additional_attributes);
    }

    /**
     * Returns the HTML code for a tag (h3, h1, div, a, button), etc.
     *
     * @param string $tag                   the tag name
     * @param string $content               the tag's content
     * @param array  $additional_attributes (for instance, height, width, onclick, ...)
     *
     * @return string
     *
     * @author Julio Montoya 2010
     */
    public static function tag($tag, $content, $additional_attributes = [])
    {
        $attribute_list = '';
        // Managing the additional attributes
        if (!empty($additional_attributes) && is_array($additional_attributes)) {
            $attribute_list = '';
            foreach ($additional_attributes as $key => &$value) {
                $attribute_list .= $key.'="'.$value.'" ';
            }
        }
        //some tags don't have this </XXX>
        if (in_array($tag, ['img', 'input', 'br'])) {
            $return_value = '<'.$tag.' '.$attribute_list.' />';
        } else {
            $return_value = '<'.$tag.' '.$attribute_list.' >'.$content.'</'.$tag.'>';
        }

        return $return_value;
    }

    /**
     * Creates a URL anchor.
     *
     * @param string $name
     * @param ?string $url
     * @param ?array  $attributes
     *
     * @return string
     */
    public static function url(string $name, ?string $url, ?array $attributes = []): string
    {
        if (!empty($url)) {
            $url = preg_replace('#&amp;#', '&', $url);
            $url = htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
            $attributes['href'] = $url;
        }

        return self::tag('a', $name, $attributes);
    }

    /**
     * Creates a div tag.
     *
     * @param string $content
     * @param ?array  $attributes
     *
     * @return string
     */
    public static function div(string $content, ?array $attributes = []): string
    {
        return self::tag('div', $content, $attributes);
    }

    /**
     * Creates a span tag.
     */
    public static function span(string $content, ?array $attributes = []): string
    {
        return self::tag('span', $content, $attributes);
    }

    /**
     * Displays an HTML input tag.
     */
    public static function input($type, $name, $value, $attributes = [])
    {
        if (isset($type)) {
            $attributes['type'] = $type;
        }
        if (isset($name)) {
            $attributes['name'] = $name;
        }
        if (isset($value)) {
            $attributes['value'] = $value;
        }

        if ('checkbox' === $type) {
            $attributes['class'] ??= 'p-checkbox-input';
        }

        $inputBase = self::tag('input', '', $attributes);

        if ('checkbox' === $type) {
            $isChecked = isset($attributes['checked']) && 'checked' === $attributes['checked'];
            $compontentCheckedClass = $isChecked ? 'p-checkbox-checked' : '';

            return <<<HTML
                <div class="p-checkbox p-component $compontentCheckedClass">
                    $inputBase
                    <div class="p-checkbox-box">
                        <svg class="p-icon p-checkbox-icon" width="14" height="14" viewBox="0 0 14 14" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
                            <path d="M4.86199 11.5948C4.78717 11.5923 4.71366 11.5745 4.64596 11.5426C4.57826 11.5107 4.51779 11.4652 4.46827 11.4091L0.753985 7.69483C0.683167 7.64891 0.623706 7.58751 0.580092 7.51525C0.536478 7.44299 0.509851 7.36177 0.502221 7.27771C0.49459 7.19366 0.506156 7.10897 0.536046 7.03004C0.565935 6.95111 0.613367 6.88 0.674759 6.82208C0.736151 6.76416 0.8099 6.72095 0.890436 6.69571C0.970973 6.67046 1.05619 6.66385 1.13966 6.67635C1.22313 6.68886 1.30266 6.72017 1.37226 6.76792C1.44186 6.81567 1.4997 6.8786 1.54141 6.95197L4.86199 10.2503L12.6397 2.49483C12.7444 2.42694 12.8689 2.39617 12.9932 2.40745C13.1174 2.41873 13.2343 2.47141 13.3251 2.55705C13.4159 2.64268 13.4753 2.75632 13.4938 2.87973C13.5123 3.00315 13.4888 3.1292 13.4271 3.23768L5.2557 11.4091C5.20618 11.4652 5.14571 11.5107 5.07801 11.5426C5.01031 11.5745 4.9368 11.5923 4.86199 11.5948Z" fill="currentColor"></path>
                        </svg>
                    </div>
                </div>
HTML;
        }

        if ('text' === $type) {
            $attributes['class'] = isset($attributes['class'])
                ? $attributes['class'].' p-inputtext p-component '
                : 'p-inputtext p-component ';
        }

        return self::tag('input', '', $attributes);
    }

    /**
     * Displays an HTML select tag.
     */
    public static function select(
        string $name,
        array $values,
        mixed $default = -1,
        array $extra_attributes = [],
        bool $show_blank_item = true,
        string $blank_item_text = ''
    ): string {
        $html = '';
        $extra = '';
        $default_id = 'id="'.$name.'" ';
        $extra_attributes = array_merge(
            ['class' => 'p-select p-component p-inputwrapper p-inputwrapper-filled'],
            $extra_attributes
        );
        foreach ($extra_attributes as $key => $parameter) {
            if ('id' == $key) {
                $default_id = '';
            }
            $extra .= $key.'="'.$parameter.'" ';
        }
        $html .= '<select name="'.$name.'" '.$default_id.' '.$extra.'>';

        if ($show_blank_item) {
            if (empty($blank_item_text)) {
                $blank_item_text = get_lang('Select');
            } else {
                $blank_item_text = Security::remove_XSS($blank_item_text);
            }
            $html .= self::tag(
                'option',
                '-- '.$blank_item_text.' --',
                ['value' => '-1']
            );
        }
        if ($values) {

The expression $values of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            foreach ($values as $key => $value) {
                if (is_array($value) && isset($value['name'])) {
                    $value = $value['name'];
                }
                $html .= '<option value="'.$key.'"';

                if (is_array($default)) {
                    foreach ($default as $item) {
                        if ($item == $key) {
                            $html .= ' selected="selected"';
                            break;
                        }
                    }
                } else {
                    if ($default == $key) {
                        $html .= ' selected="selected"';
                    }
                }

                $html .= '>'.$value.'</option>';
            }
        }
        $html .= '</select>';

        return $html;
    }

    /**
     * @param $name
     * @param $value
     * @param array $attributes
     *
     * @return string
     */
    public static function button($name, $value, $attributes = [])
    {
        if (!empty($name)) {
            $attributes['name'] = $name;
        }

        return self::tag('button', $value, $attributes);
    }

    /**
     * Creates a tab menu
     * Requirements: declare the jquery, jquery-ui libraries + the jquery-ui.css
     * in the $htmlHeadXtra variable before the display_header
     * Add this script.
     *
     * @param array  $headers       list of the tab titles
     * @param array  $items
     * @param string $id            id of the container of the tab in the example "tabs"
     * @param array  $attributes    for the ul
     * @param array  $ul_attributes
     * @param string $selected
     *
     * @return string
     */
    public static function tabs(
        $headers,
        $items,
        $id = 'tabs',
        $attributes = [],
        $ul_attributes = [],
        $selected = ''
    ) {
        if (empty($headers) || 0 === count($headers)) {
            return '';
        }

        // ---------------------------------------------------------------------
        // Build tab headers
        // ---------------------------------------------------------------------
        $lis = '';
        $i = 1;
        foreach ($headers as $item) {
            $isActive = (empty($selected) && 1 === $i) || (!empty($selected) && (int) $selected === $i);
            $activeClass = $isActive ? ' active' : '';
            $ariaSelected = $isActive ? 'true' : 'false';

            $item = self::tag(
                'a',
                $item,
                [
                    'href' => 'javascript:void(0)',
                    'class' => 'nav-item nav-link text-primary'.$activeClass,
                    '@click' => "openTab = $i",
                    'id' => $id.$i.'-tab',
                    'data-toggle' => 'tab',
                    'role' => 'tab',
                    'aria-controls' => $id.'-'.$i,
                    'aria-selected' => $ariaSelected,
                ]
            );

            $lis .= $item;
            $i++;
        }

        $ul = self::tag(
            'nav',
            $lis,
            [
                'id' => 'nav_'.$id,
                'class' => 'nav nav-tabs bg-white px-3 pt-3 border-bottom-0',
                'role' => 'tablist',
            ]
        );

        // ---------------------------------------------------------------------
        // Build tab contents
        // ---------------------------------------------------------------------
        $i = 1;
        $divs = '';
        foreach ($items as $content) {
            $isActive = (empty($selected) && 1 === $i) || (!empty($selected) && (int) $selected === $i);
            $panelClass = 'tab-panel';
            if ($isActive) {
                $panelClass .= ' is-active';
            }

            $divs .= self::tag(
                'div',
                $content,
                [
                    'id' => $id.'-'.$i,
                    'x-show' => "openTab === $i",
                    'class' => $panelClass,
                ]
            );
            $i++;
        }

        // Wrapper for contents: white background, gray border, padding
        $contentWrapper = self::tag(
            'div',
            $divs,
            [
                'class' => 'tab-content bg-white border border-gray-25 rounded-bottom px-3 py-3 mt-2',
            ]
        );

        // ---------------------------------------------------------------------
        // Outer wrapper
        // ---------------------------------------------------------------------
        $attributes['id'] = (string) $id;
        if (empty($attributes['class'])) {
            $attributes['class'] = '';
        }
        // Shadow, rounded corners, small top margin
        $attributes['class'] .= ' tab_wrapper shadow-sm rounded mt-3';

        $initialTab = !empty($selected) ? (int) $selected : 1;
        $attributes['x-data'] = '{ openTab: '.$initialTab.' }';

        return self::tag(
            'div',
            $ul.$contentWrapper,
            $attributes
        );
    }

    /**
     * @param $headers
     * @param null $selected

Are you sure the doc-type for parameter $selected is correct as it would always require null to be passed?

     *
     * @return string
     */
    public static function tabsOnlyLink($headers, $selected = null, string $tabList = '')
    {
        $id = uniqid('tabs_');
        $list = '';

        if ('integer' === gettype($selected)) {
            $selected -= 1;
        }

        foreach ($headers as $key => $item) {
            $class = null;
            if ($key == $selected) {
                $class = 'active';
            }
            $item = self::tag(
                'a',
                $item['content'],
                [
                    'id' => $id.'-'.$key,
                    'href' => $item['url'],
                    'class' => 'nav-link '.$class,
                ]
            );
            $list .= '<li class="nav-item">'.$item.'</li>';
        }

        return self::div(
            self::tag(
                'ul',
                $list,
                ['class' => 'nav nav-tabs']
            ),
            ['class' => "ul-tablist $tabList"]
        );
    }

    /**
     * In order to display a grid using jqgrid you have to:.
     *
     * @example
     * After your Display::display_header function you have to add the nex javascript code:
     * <script>
     *   echo Display::grid_js('my_grid_name', $url,$columns, $column_model, $extra_params,[]);
     *   // for more information of this function check the grid_js() function
     * </script>
     * //Then you have to call the grid_html
     * echo Display::grid_html('my_grid_name');
     * As you can see both function use the same "my_grid_name" this is very important otherwise nothing will work
     *
     * @param   string  the div id, this value must be the same with the first parameter of Display::grid_js()
     *
     * @return string html
     */
    public static function grid_html($div_id)
    {
        $table = self::tag('table', '', ['id' => $div_id]);
        $table .= self::tag('div', '', ['id' => $div_id.'_pager']);

        return $table;
    }

    /**
     * This is a wrapper to use the jqgrid in Chamilo.
     * For the other jqgrid options visit http://www.trirand.com/jqgridwiki/doku.php?id=wiki:options
     * This function need to be in the ready jquery function
     * example --> $(function() { <?php echo Display::grid_js('grid' ...); ?> }
     * In order to work this function needs the Display::grid_html function with the same div id.
     *
     * @param string $div_id       div id
     * @param string $url          url where the jqgrid will ask for data (if datatype = json)
     * @param array  $column_names Visible columns (you should use get_lang).
     *                             An array in which we place the names of the columns.
     *                             This is the text that appears in the head of the grid (Header layer).
     *                             Example: colname   {name:'date',     index:'date',   width:120, align:'right'},
     * @param array  $column_model the column model :  Array which describes the parameters of the columns.
     *                             This is the most important part of the grid.
     *                             For a full description of all valid values see colModel API. See the url above.
     * @param array  $extra_params extra parameters
     * @param array  $data         data that will be loaded
     * @param string $formatter    A string that will be appended to the JSON returned
     * @param bool   $fixed_width  not implemented yet
     *
     * @return string the js code
     */
    public static function grid_js(
        $div_id,
        $url,
        $column_names,
        $column_model,
        $extra_params,
        $data = [],
        $formatter = '',
        $fixed_width = false
    ) {
        $obj = new stdClass();
        $obj->first = 'first';

        if (!empty($url)) {
            $obj->url = $url;
        }

        // Needed it in order to render the links/html in the grid
        foreach ($column_model as &$columnModel) {
            if (!isset($columnModel['formatter'])) {
                $columnModel['formatter'] = '';
            }
        }

        //This line should only be used/modified in case of having characters
        // encoding problems - see #6159
        //$column_names = array_map("utf8_encode", $column_names);
        $obj->colNames = $column_names;
        $obj->colModel = $column_model;
        $obj->pager = '#'.$div_id.'_pager';
        $obj->datatype = 'json';
        $obj->viewrecords = 'true';
        $obj->guiStyle = 'bootstrap4';
        $obj->iconSet = 'materialDesignIcons';
        $all_value = 10000000;

        // Sets how many records we want to view in the grid
        $obj->rowNum = 20;

        // Default row quantity
        if (!isset($extra_params['rowList'])) {
            $defaultRowList = [20, 50, 100, 500, 1000, $all_value];
            $rowList = api_get_setting('display.table_row_list', true);
            if (is_array($rowList) && isset($rowList['options']) && is_array($rowList['options'])) {
                $rowList = $rowList['options'];
                $rowList[] = $all_value;
            } else {
                $rowList = $defaultRowList;
            }
            $extra_params['rowList'] = $rowList;
        }

        $defaultRow = (int) api_get_setting('display.table_default_row');
        if ($defaultRow > 0) {
            $obj->rowNum = $defaultRow;
        }

        $json = '';
        if (!empty($extra_params['datatype'])) {
            $obj->datatype = $extra_params['datatype'];
        }

        // Row even odd style.
        $obj->altRows = true;
        if (!empty($extra_params['altRows'])) {
            $obj->altRows = $extra_params['altRows'];
        }

        if (!empty($extra_params['sortname'])) {
            $obj->sortname = $extra_params['sortname'];
        }

        if (!empty($extra_params['sortorder'])) {
            $obj->sortorder = $extra_params['sortorder'];
        }

        if (!empty($extra_params['rowList'])) {
            $obj->rowList = $extra_params['rowList'];
        }

        if (!empty($extra_params['rowNum'])) {
            $obj->rowNum = $extra_params['rowNum'];
        } else {
            // Try to load max rows from Session
            $urlInfo = parse_url($url);
            if (isset($urlInfo['query'])) {
                parse_str($urlInfo['query'], $query);
                if (isset($query['a'])) {
                    $action = $query['a'];
                    // This value is set in model.ajax.php
                    $savedRows = Session::read('max_rows_'.$action);
                    if (!empty($savedRows)) {
                        $obj->rowNum = $savedRows;
                    }
                }
            }
        }

        if (!empty($extra_params['viewrecords'])) {
            $obj->viewrecords = $extra_params['viewrecords'];
        }

        $beforeSelectRow = null;
        if (isset($extra_params['beforeSelectRow'])) {
            $beforeSelectRow = 'beforeSelectRow: '.$extra_params['beforeSelectRow'].', ';
            unset($extra_params['beforeSelectRow']);
        }

        $beforeProcessing = '';
        if (isset($extra_params['beforeProcessing'])) {
            $beforeProcessing = 'beforeProcessing : function() { '.$extra_params['beforeProcessing'].' },';
            unset($extra_params['beforeProcessing']);
        }

        $beforeRequest = '';
        if (isset($extra_params['beforeRequest'])) {
            $beforeRequest = 'beforeRequest : function() { '.$extra_params['beforeRequest'].' },';
            unset($extra_params['beforeRequest']);
        }

        $gridComplete = '';
        if (isset($extra_params['gridComplete'])) {
            $gridComplete = 'gridComplete : function() { '.$extra_params['gridComplete'].' },';
            unset($extra_params['gridComplete']);
        }

        // Adding extra params
        if (!empty($extra_params)) {
            foreach ($extra_params as $key => $element) {
                // the groupHeaders key gets a special treatment
                if ('groupHeaders' != $key) {
                    $obj->$key = $element;
                }
            }
        }

        // Adding static data.
        if (!empty($data)) {
            $data_var = $div_id.'_data';
            $json .= ' var '.$data_var.' = '.json_encode($data).';';
            $obj->data = $data_var;
            $obj->datatype = 'local';
            $json .= "\n";
        }

        $obj->end = 'end';

        $json_encode = json_encode($obj);

        if (!empty($data)) {
            //Converts the "data":"js_variable" to "data":js_variable,
            // otherwise it will not work
            $json_encode = str_replace('"data":"'.$data_var.'"', '"data":'.$data_var.'', $json_encode);

The variable $data_var does not seem to be defined for all execution paths leading up to this point.

        }

        // Fixing true/false js values that doesn't need the ""
        $json_encode = str_replace(':"true"', ':true', $json_encode);
        // wrap_cell is not a valid jqgrid attributes is a hack to wrap a text
        $json_encode = str_replace('"wrap_cell":true', 'cellattr : function(rowId, value, rowObject, colModel, arrData) { return \'class = "jqgrid_whitespace"\'; }', $json_encode);
        $json_encode = str_replace(':"false"', ':false', $json_encode);
        $json_encode = str_replace('"formatter":"action_formatter"', 'formatter:action_formatter', $json_encode);
        $json_encode = str_replace('"formatter":"extra_formatter"', 'formatter:extra_formatter', $json_encode);
        $json_encode = str_replace(['{"first":"first",', '"end":"end"}'], '', $json_encode);

        if (('true' === api_get_setting('work.allow_compilatio_tool')) &&
            (false !== strpos($_SERVER['REQUEST_URI'], 'work/work.php') ||
             false != strpos($_SERVER['REQUEST_URI'], 'work/work_list_all.php')

It seems like you are loosely comparing strpos($_SERVER['REQUEST_URI'], 'work/work_list_all.php') of type integer to the boolean false. If you are specifically checking for non-zero, consider using something more explicit like > 0 or !== 0 instead.

            )
        ) {
            $json_encode = str_replace('"function () { compilatioInit() }"',
                'function () { compilatioInit() }',
                $json_encode
            );
        }
        // Creating the jqgrid element.
        $json .= '$("#'.$div_id.'").jqGrid({';
        $json .= "autowidth: true,";
        //$json .= $beforeSelectRow;
        $json .= $gridComplete;
        $json .= $beforeProcessing;
        $json .= $beforeRequest;
        $json .= $json_encode;
        $json .= '});';

        // Grouping headers option
        if (isset($extra_params['groupHeaders'])) {
            $groups = '';
            foreach ($extra_params['groupHeaders'] as $group) {
                //{ "startColumnName" : "courses", "numberOfColumns" : 1, "titleText" : "Order Info" },
                $groups .= '{ "startColumnName" : "'.$group['startColumnName'].'", "numberOfColumns" : '.$group['numberOfColumns'].', "titleText" : "'.$group['titleText'].'" },';
            }
            $json .= '$("#'.$div_id.'").jqGrid("setGroupHeaders", {
                "useColSpanStyle" : false,
                "groupHeaders"    : [
                    '.$groups.'
                ]
            });';
        }

        $all_text = addslashes(get_lang('All'));
        $json .= '$("'.$obj->pager.' option[value='.$all_value.']").text("'.$all_text.'");';
        $json .= "\n";
        // Adding edit/delete icons.
        $json .= $formatter;

        return $json;
    }

    /**
     * @param array $headers
     * @param array $rows
     * @param array $attributes
     *
     * @return string
     */
    public static function table($headers, $rows, $attributes = [])
    {
        if (empty($attributes)) {
            $attributes['class'] = 'data_table';
        }
        $table = new HTML_Table($attributes);
        $row = 0;
        $column = 0;

        // Course headers
        if (!empty($headers)) {
            foreach ($headers as $item) {
                $table->setHeaderContents($row, $column, $item);
                $column++;
            }
            $row = 1;
            $column = 0;
        }

        if (!empty($rows)) {
            foreach ($rows as $content) {
                $table->setCellContents($row, $column, $content);
                $row++;
            }
        }

        return $table->toHtml();
    }

    /**
     * Get the session box details as an array.
     *
     * @todo check session visibility.
     *
     * @param int $session_id
     *
     * @return array Empty array or session array
     *               ['title'=>'...','category'=>'','dates'=>'...','coach'=>'...','active'=>true/false,'session_category_id'=>int]
     */
    public static function getSessionTitleBox($session_id)
    {
        $session_info = api_get_session_info($session_id);
        $generalCoachesNames = implode(
            ' - ',
            SessionManager::getGeneralCoachesNamesForSession($session_id)
        );

        $session = [];
        $session['category_id'] = $session_info['session_category_id'];
        $session['title'] = $session_info['name'];
        $session['dates'] = '';
        $session['coach'] = '';
        if ('true' === api_get_setting('show_session_coach') && $generalCoachesNames) {
            $session['coach'] = get_lang('General coach').': '.$generalCoachesNames;
        }
        $active = false;
        if (('0000-00-00 00:00:00' === $session_info['access_end_date'] &&
            '0000-00-00 00:00:00' === $session_info['access_start_date']) ||
            (empty($session_info['access_end_date']) && empty($session_info['access_start_date']))
        ) {
            if (isset($session_info['duration']) && !empty($session_info['duration'])) {
                $daysLeft = SessionManager::getDayLeftInSession($session_info, api_get_user_id());
                $session['duration'] = $daysLeft >= 0
                    ? sprintf(get_lang('This session has a maximum duration. Only %s days to go.'), $daysLeft)
                    : get_lang('You are already registered but your allowed access time has expired.');
            }
            $active = true;
        } else {
            $dates = SessionManager::parseSessionDates($session_info, true);
            $session['dates'] = $dates['access'];
            //$active = $date_start <= $now && $date_end >= $now;
        }
        $session['active'] = $active;
        $session['session_category_id'] = $session_info['session_category_id'];
        $session['visibility'] = $session_info['visibility'];
        $session['num_users'] = $session_info['nbr_users'];
        $session['num_courses'] = $session_info['nbr_courses'];
        $session['description'] = $session_info['description'];
        $session['show_description'] = $session_info['show_description'];
        //$session['image'] = SessionManager::getSessionImage($session_info['id']);
        $session['url'] = api_get_path(WEB_CODE_PATH).'session/index.php?session_id='.$session_info['id'];

        $entityManager = Database::getManager();
        $fieldValuesRepo = $entityManager->getRepository(ExtraFieldValues::class);
        $extraFieldValues = $fieldValuesRepo->getVisibleValues(
            ExtraField::SESSION_FIELD_TYPE,
            $session_id
        );

        $session['extra_fields'] = [];
        /** @var ExtraFieldValues $value */
        foreach ($extraFieldValues as $value) {
            if (empty($value)) {
                continue;
            }
            $session['extra_fields'][] = [
                'field' => [
                    'variable' => $value->getField()->getVariable(),
                    'display_text' => $value->getField()->getDisplayText(),
                ],
                'value' => $value->getFieldValue(),
            ];
        }

        return $session;
    }

    /**
     * Return the five star HTML.
     *
     * @param string $id              of the rating ul element
     * @param string $url             that will be added (for jquery see hot_courses.tpl)
     * @param array  $point_info      point info array see function CourseManager::get_course_ranking()
     * @param bool   $add_div_wrapper add a div wrapper
     *
     * @return string
     */
    public static function return_rating_system(
        $id,
        $url,
        $point_info = [],
        $add_div_wrapper = true
    ) {
        $number_of_users_who_voted = isset($point_info['users_who_voted']) ? $point_info['users_who_voted'] : null;
        $percentage = isset($point_info['point_average']) ? $point_info['point_average'] : 0;

        if (!empty($percentage)) {
            $percentage = $percentage * 125 / 100;
        }
        $accesses = isset($point_info['accesses']) ? $point_info['accesses'] : 0;
        $star_label = sprintf(get_lang('%s stars out of 5'), $point_info['point_average_star']);

        $html = '<section class="rating-widget">';
        $html .= '<div class="rating-stars"><ul id="stars">';
        $html .= '<li class="star" data-link="'.$url.'&amp;star=1" title="Poor" data-value="1"><i class="fa fa-star fa-fw"></i></li>
                 <li class="star" data-link="'.$url.'&amp;star=2" title="Fair" data-value="2"><i class="fa fa-star fa-fw"></i></li>
                 <li class="star" data-link="'.$url.'&amp;star=3" title="Good" data-value="3"><i class="fa fa-star fa-fw"></i></li>
                 <li class="star" data-link="'.$url.'&amp;star=4" title="Excellent" data-value="4"><i class="fa fa-star fa-fw"></i></li>
                 <li class="star" data-link="'.$url.'&amp;star=5" title="WOW!!!" data-value="5"><i class="fa fa-star fa-fw"></i></li>
        ';
        $html .= '</ul></div>';
        $html .= '</section>';
        $labels = [];

        $labels[] = 1 == $number_of_users_who_voted ? $number_of_users_who_voted.' '.get_lang('Vote') : $number_of_users_who_voted.' '.get_lang('Votes');
        $labels[] = 1 == $accesses ? $accesses.' '.get_lang('Visit') : $accesses.' '.get_lang('Visits');
        $labels[] = $point_info['user_vote'] ? get_lang('Your vote').' ['.$point_info['user_vote'].']' : get_lang('Your vote').' [?] ';

        if (!$add_div_wrapper && api_is_anonymous()) {
            $labels[] = self::tag('span', get_lang('Login to vote'), ['class' => 'error']);
        }

        $html .= self::div(implode(' | ', $labels), ['id' => 'vote_label_'.$id, 'class' => 'vote_label_info']);
        $html .= ' '.self::span(' ', ['id' => 'vote_label2_'.$id]);

        if ($add_div_wrapper) {
            $html = self::div($html, ['id' => 'rating_wrapper_'.$id]);
        }

        return $html;
    }

    /**
     * @param string $title
     * @param string $second_title
     * @param string $size
     * @param bool   $filter
     *
     * @return string
     */
    public static function page_header($title, $second_title = null, $size = 'h2', $filter = true)
    {
        if ($filter) {
            $title = Security::remove_XSS($title);
        }

        if (!empty($second_title)) {
            if ($filter) {
                $second_title = Security::remove_XSS($second_title);
            }
            $title .= "<small> $second_title</small>";
        }

        return '<div class="page-header section-header mb-6"><'.$size.' class="section-header__title">'.$title.'</'.$size.'></div>';
    }

    public static function page_header_and_translate($title, $second_title = null)
    {
        $title = get_lang($title);

        return self::page_header($title, $second_title);
    }

    public static function page_subheader($title, $second_title = null, $size = 'h3', $attributes = [])
    {
        if (!empty($second_title)) {
            $second_title = Security::remove_XSS($second_title);
            $title .= "<small> $second_title<small>";
        }
        $subTitle = self::tag($size, Security::remove_XSS($title), $attributes);

        return $subTitle;
    }

    public static function page_subheader2($title, $second_title = null)
    {
        return self::page_header($title, $second_title, 'h4');
    }

    public static function page_subheader3($title, $second_title = null)
    {
        return self::page_header($title, $second_title, 'h5');
    }

    public static function description(array $list): string
    {
        $html = '';
        if (!empty($list)) {
            $html = '<dl class="dl-horizontal">';
            foreach ($list as $item) {
                $html .= '<dt>'.$item['title'].'</dt>';
                $html .= '<dd>'.$item['content'].'</dd>';
            }
            $html .= '</dl>';
        }

        return $html;
    }

    /**
     * @param int    $percentage      int value between 0 and 100
     * @param bool   $show_percentage
     * @param string $extra_info
     * @param string $class           danger/success/infowarning
     *
     * @return string
     */
    public static function bar_progress($percentage, $show_percentage = true, $extra_info = '', $class = '')
    {
        $percentage = (int) $percentage;
        $class = empty($class) ? '' : "progress-bar-$class";

        $div = '<div class="progress">
                <div
                    class="progress-bar progress-bar-striped '.$class.'"
                    role="progressbar"
                    aria-valuenow="'.$percentage.'"
                    aria-valuemin="0"
                    aria-valuemax="100"
                    style="width: '.$percentage.'%;"
                >';
        if ($show_percentage) {
            $div .= $percentage.'%';
        } else {
            if (!empty($extra_info)) {
                $div .= $extra_info;
            }
        }
        $div .= '</div></div>';

        return $div;
    }

    /**
     * @param array $badge_list
     *
     * @return string
     */
    public static function badgeGroup($list)
    {
        $html = '<div class="badge-group">';
        foreach ($list as $badge) {
            $html .= $badge;
        }
        $html .= '</div>';

        return $html;
    }

    /**
     * Return an HTML span element with the badge class and an additional bg-$type class
     */
    public static function label(string $content, string $type = 'default'): string
    {
        $html = '';
        if (!empty($content)) {
            $class = match ($type) {
                'success' => 'success',
                'warning' => 'warning',
                'important', 'danger', 'error' => 'error',
                'info' => 'info',
                'primary' => 'primary',
                default => 'secondary',
            };

            $html = '<span class="badge badge--'.$class.'">';
            $html .= $content;
            $html .= '</span>';
        }

        return $html;
    }

    public static function actions(array $items): string
    {
        if (empty($items)) {
            return '';
        }

        $links = '';
        foreach ($items as $value) {
            $attributes = $value['url_attributes'] ?? [];
            $links .= self::url($value['content'], $value['url'], $attributes);
        }

        return self::toolbarAction(uniqid('toolbar', false), [$links]);
    }

    /**
     * Prints a tooltip.
     *
     * @param string $text
     * @param string $tip
     *
     * @return string
     */
    public static function tip($text, $tip)
    {
        if (empty($tip)) {
            return $text;
        }

        return self::span(
            $text,
            ['class' => 'boot-tooltip', 'title' => strip_tags($tip)]
        );
    }

    /**
     * @param array $buttons
     *
     * @return string
     */
    public static function groupButton($buttons)
    {
        $html = '<div class="btn-group" role="group">';
        foreach ($buttons as $button) {
            $html .= $button;
        }
        $html .= '</div>';

        return $html;
    }

    /**
     * @todo use twig
     *
     * @param string $title
     * @param array  $elements
     * @param bool   $alignToRight
     *
     * @return string
     */
    public static function groupButtonWithDropDown($title, $elements, $alignToRight = false)
    {
        $id = uniqid('dropdown', false);
        $html = '
        <div class="dropdown inline-block relative">
            <button
                id="'.$id.'"
                type="button"
                class="inline-flex justify-center w-full rounded-md border border-gray-300 shadow-sm px-4 py-2 bg-white text-sm font-medium text-gray-700 hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-offset-gray-100 focus:ring-indigo-500"
                aria-expanded="false"
                aria-haspopup="true"
                onclick="document.querySelector(\'#'.$id.'_menu\').classList.toggle(\'hidden\')"
            >
              '.$title.'
              <svg class="-mr-1 ml-2 h-5 w-5" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
                <path fill-rule="evenodd" d="M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z" clip-rule="evenodd" />
              </svg>
            </button>
            <div
                id="'.$id.'_menu"
                class=" dropdown-menu hidden origin-top-right absolute right-0 mt-2 w-56 rounded-md shadow-lg bg-white ring-1 ring-black ring-opacity-5 focus:outline-none"
                role="menu"
                aria-orientation="vertical"
                aria-labelledby="menu-button"
                tabindex="-1"
            >
            <div class="py-1" role="none">';
        foreach ($elements as $item) {
            $html .= self::url(
                    $item['title'],
                    $item['href'],
                    [
                        'class' => 'text-gray-700 block px-4 py-2 text-sm',
                        'role' => 'menuitem',
                        'onclick' => $item['onclick'] ?? '',
                        'data-action' => $item['data-action'] ?? '',
                        'data-confirm' => $item['data-confirm'] ?? '',
                    ]
                );
        }
        $html .= '
            </div>
            </div>
            </div>
        ';

        return $html;
    }

    /**
     * @param string $file
     * @param array  $params
     *
     * @return string|null
     */
    public static function getMediaPlayer($file, $params = [])
    {
        $fileInfo = pathinfo($file);

        $autoplay = isset($params['autoplay']) && 'true' === $params['autoplay'] ? 'autoplay' : '';
        $id = isset($params['id']) ? $params['id'] : $fileInfo['basename'];
        $width = isset($params['width']) ? 'width="'.$params['width'].'"' : null;
        $class = isset($params['class']) ? ' class="'.$params['class'].'"' : null;

        switch ($fileInfo['extension']) {
            case 'mp3':
            case 'webm':
                $html = '<audio id="'.$id.'" '.$class.' controls '.$autoplay.' '.$width.' src="'.$params['url'].'" >';
                $html .= '<object width="'.$width.'" height="50" type="application/x-shockwave-flash" data="'.api_get_path(WEB_LIBRARY_PATH).'javascript/mediaelement/flashmediaelement.swf">
                            <param name="movie" value="'.api_get_path(WEB_LIBRARY_PATH).'javascript/mediaelement/flashmediaelement.swf" />
                            <param name="flashvars" value="controls=true&file='.$params['url'].'" />
                          </object>';
                $html .= '</audio>';

                return $html;
                break;

break is not strictly necessary here and could be removed.

            case 'wav':
            case 'ogg':
                $html = '<audio width="300px" controls id="'.$id.'" '.$autoplay.' src="'.$params['url'].'" >';

                return $html;
                break;
        }

        return null;
    }

    /**
     * @param int    $nextValue
     * @param array  $list
     * @param int    $current
     * @param int    $fixedValue
     * @param array  $conditions
     * @param string $link
     * @param bool   $isMedia
     * @param bool   $addHeaders
     * @param array  $linkAttributes
     *
     * @return string
     */
    public static function progressPaginationBar(
        $nextValue,
        $list,
        $current,
        $fixedValue = null,
        $conditions = [],
        $link = null,
        $isMedia = false,
        $addHeaders = true,
        $linkAttributes = []
    ) {
        if ($addHeaders) {
            $pagination_size = 'pagination-mini';
            $html = '<div class="exercise_pagination pagination '.$pagination_size.'"><ul>';
        } else {
            $html = null;
        }
        $affectAllItems = false;
        if ($isMedia && isset($fixedValue) && ($nextValue + 1 == $current)) {
            $affectAllItems = true;
        }
        $localCounter = 0;
        foreach ($list as $itemId) {
            $isCurrent = false;
            if ($affectAllItems) {
                $isCurrent = true;
            } else {
                if (!$isMedia) {
                    $isCurrent = $current == ($localCounter + $nextValue + 1) ? true : false;
                }
            }
            $html .= self::parsePaginationItem(
                $itemId,
                $isCurrent,
                $conditions,
                $link,
                $nextValue,
                $isMedia,
                $localCounter,
                $fixedValue,
                $linkAttributes
            );
            $localCounter++;
        }
        if ($addHeaders) {
            $html .= '</ul></div>';
        }

        return $html;
    }

    /**
     * @param int    $itemId
     * @param bool   $isCurrent
     * @param array  $conditions
     * @param string $link
     * @param int    $nextValue
     * @param bool   $isMedia
     * @param int    $localCounter
     * @param int    $fixedValue
     * @param array  $linkAttributes
     *
     * @return string
     */
    public static function parsePaginationItem(
        $itemId,
        $isCurrent,
        $conditions,
        $link,
        $nextValue = 0,
        $isMedia = false,
        $localCounter = null,
        $fixedValue = null,
        $linkAttributes = []
    ) {
        $defaultClass = 'before';
        $class = $defaultClass;
        foreach ($conditions as $condition) {
            $array = isset($condition['items']) ? $condition['items'] : [];
            $class_to_applied = $condition['class'];
            $type = isset($condition['type']) ? $condition['type'] : 'positive';
            $mode = isset($condition['mode']) ? $condition['mode'] : 'add';
            switch ($type) {
                case 'positive':
                    if (in_array($itemId, $array)) {
                        if ('overwrite' == $mode) {
                            $class = " $defaultClass $class_to_applied";
                        } else {
                            $class .= " $class_to_applied";
                        }
                    }
                    break;
                case 'negative':
                    if (!in_array($itemId, $array)) {
                        if ('overwrite' == $mode) {
                            $class = " $defaultClass $class_to_applied";
                        } else {
                            $class .= " $class_to_applied";
                        }
                    }
                    break;
            }
        }
        if ($isCurrent) {
            $class = 'before current';
        }
        if ($isMedia && $isCurrent) {
            $class = 'before current';
        }
        if (empty($link)) {
            $link_to_show = '#';
        } else {
            $link_to_show = $link.($nextValue + $localCounter);
        }
        $label = $nextValue + $localCounter + 1;
        if ($isMedia) {
            $label = ($fixedValue + 1).' '.chr(97 + $localCounter);
            $link_to_show = $link.$fixedValue.'#questionanchor'.$itemId;
        }
        $link = self::url($label.' ', $link_to_show, $linkAttributes);

        return '<li class = "'.$class.'">'.$link.'</li>';
    }

    /**
     * @param int $current
     * @param int $total
     *
     * @return string
     */
    public static function paginationIndicator($current, $total)
    {
        $html = null;
        if (!empty($current) && !empty($total)) {
            $label = sprintf(get_lang('%s of %s'), $current, $total);
            $html = self::url($label, '#', ['class' => 'btn disabled']);
        }

        return $html;
    }

    /**
     * @param $url
     * @param $currentPage
     * @param $pagesCount
     * @param $totalItems
     *
     * @return string
     */
    public static function getPagination($url, $currentPage, $pagesCount, $totalItems)
    {
        $pagination = '';
        if ($totalItems > 1 && $pagesCount > 1) {
            $pagination .= '<ul class="pagination">';
            for ($i = 0; $i < $pagesCount; $i++) {
                $newPage = $i + 1;
                if ($currentPage == $newPage) {
                    $pagination .= '<li class="active"><a href="'.$url.'&page='.$newPage.'">'.$newPage.'</a></li>';
                } else {
                    $pagination .= '<li><a href="'.$url.'&page='.$newPage.'">'.$newPage.'</a></li>';
                }
            }
            $pagination .= '</ul>';
        }

        return $pagination;
    }

    /**
     * Adds a legacy message in the queue.
     *
     * @param string $message
     */
    public static function addFlash($message)
    {
        // Detect type of message.
        $parts = preg_match('/alert-([a-z]*)/', $message, $matches);
        $type = 'primary';
        if ($parts && isset($matches[1]) && $matches[1]) {
            $type = $matches[1];
        }
        // Detect legacy content of message.
        $result = preg_match('/<div(.*?)\>(.*?)\<\/div>/s', $message, $matches);
        if ($result && isset($matches[2])) {
            Container::getSession()->getFlashBag()->add($type, $matches[2]);
        }
    }

    /**
     * Get the profile edition link for a user.
     *
     * @param int  $userId  The user id
     * @param bool $asAdmin Optional. Whether get the URL for the platform admin
     *
     * @return string The link
     */
    public static function getProfileEditionLink($userId, $asAdmin = false)
    {
        $editProfileUrl = api_get_path(WEB_CODE_PATH).'auth/profile.php';
        if ($asAdmin) {
            $editProfileUrl = api_get_path(WEB_CODE_PATH)."admin/user_edit.php?user_id=".intval($userId);
        }

        return $editProfileUrl;
    }

    /**
     * Get the vCard for a user.
     *
     * @param int $userId The user id
     *
     * @return string *.*vcf file
     */
    public static function getVCardUserLink($userId)
    {
        return api_get_path(WEB_PATH).'main/social/vcard_export.php?userId='.intval($userId);
    }

    /**
     * @param string $content
     * @param string $title
     * @param string $footer
     * @param string $type        primary|success|info|warning|danger
     * @param string $extra
     * @param string $id
     * @param string $customColor
     * @param string $rightAction
     *
     * @return string
     */
    public static function panel(
        $content,
        $title = '',
        $footer = '',
        $type = 'default',
        $extra = '',
        $id = '',
        $customColor = '',
        $rightAction = ''
    ) {
        $headerStyle = '';
        if (!empty($customColor)) {
            $headerStyle = 'style = "color: white; background-color: '.$customColor.'" ';
        }

        $footer = !empty($footer) ? '<p class="card-text"><small class="text-muted">'.$footer.'</small></p>' : '';
        $typeList = ['primary', 'success', 'info', 'warning', 'danger'];
        $style = !in_array($type, $typeList) ? 'default' : $type;

        if (!empty($id)) {
            $id = " id='$id'";
        }
        $cardBody = $title.' '.self::contentPanel($content).' '.$footer;

        return "
            <div $id class=card>
                <div class='flex justify-between items-center py-2'>
                    <div class='relative mt-1 flex'>
                        $title
                    </div>
                    <div>
                        $rightAction
                    </div>
                </div>

                $content
                $footer
            </div>"
        ;
    }

    /**
     * @param string $content
     */
    public static function contentPanel($content): string
    {
        if (empty($content)) {
            return '';
        }

        return '<div class="card-text">'.$content.'</div>';
    }

    /**
     * Get the button HTML with an Awesome Font icon.
     *
     * @param string $text        The button content
     * @param string $url         The url to button
     * @param string $icon        The Awesome Font class for icon
     * @param string $type        Optional. The button Bootstrap class. Default 'default' class
     * @param array  $attributes  The additional attributes
     * @param bool   $includeText
     *
     * @return string The button HTML
     */
    public static function toolbarButton(
        $text,
        $url,
        $icon = 'check',
        $type = null,
        array $attributes = [],
        $includeText = true
    ) {
        $buttonClass = "btn btn--secondary-outline";
        if (!empty($type)) {
            $buttonClass = "btn btn--$type";
        }
        //$icon = self::tag('i', null, ['class' => "fa fa-$icon fa-fw", 'aria-hidden' => 'true']);
        $icon = self::getMdiIcon($icon);
        $attributes['class'] = isset($attributes['class']) ? "$buttonClass {$attributes['class']}" : $buttonClass;
        $attributes['title'] = $attributes['title'] ?? $text;

        if (!$includeText) {
            $text = '<span class="sr-only">'.$text.'</span>';
        }

        return self::url("$icon $text", $url, $attributes);
    }

    /**
     * Generate an HTML "p-toolbar" div element with the given id attribute.
     * @param string $id The HTML div's "id" attribute to set
     * @param array  $contentList Array of left-center-right elements for the toolbar. If only 2 elements are defined, this becomes left-right (no center)
     * @return string HTML div for the toolbar
     */
    public static function toolbarAction(string $id, array $contentList): string
    {
        $contentListPurged = array_filter($contentList);

        if (empty($contentListPurged)) {
            return '';
        }

        $count = count($contentList);

        $start = $contentList[0];
        $center = '';
        $end = '';

        if (2 === $count) {
            $end = $contentList[1];
        } elseif (3 === $count) {
            $center = $contentList[1];
            $end = $contentList[2];
        }

        return '<div id="'.$id.'" class="toolbar-action p-toolbar p-component flex items-center justify-between flex-wrap w-full" role="toolbar">
            <div class="p-toolbar-group-start p-toolbar-group-left">'.$start.'</div>
            <div class="p-toolbar-group-center">'.$center.'</div>
            <div class="p-toolbar-group-end p-toolbar-group-right">'.$end.'</div>
        </div>';
    }

    /**
     * @param array  $content
     * @param array  $colsWidth Optional. Columns width
     *
     * @return string
     */
    public static function toolbarGradeAction($content, $colsWidth = [])
    {
        $col = count($content);

        if (!$colsWidth) {

The expression $colsWidth of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using empty($expr) instead to make it clear that you intend to check for an array without elements.

            $width = 8 / $col;
            array_walk($content, function () use ($width, &$colsWidth) {
                $colsWidth[] = $width;
            });
        }

        $html = '<div id="grade" class="p-toolbar p-component flex items-center justify-between flex-wrap" role="toolbar">';
        for ($i = 0; $i < $col; $i++) {
            $class = 'col-sm-'.$colsWidth[$i];
            if ($col > 1) {
                if ($i > 0 && $i < count($content) - 1) {
                    $class .= ' text-center';
                } elseif ($i === count($content) - 1) {
                    $class .= ' text-right';
                }
            }
            $html .= '<div class="'.$class.'">'.$content[$i].'</div>';
        }
        $html .= '</div>';

        return $html;
    }

    /**
     * The auto-translated title version of getMdiIconSimple()
     * Shortcut method to getMdiIcon, to be used from Twig (see ChamiloExtension.php)
     * using acceptable default values
     * @param string $name The icon name or a string representing the icon in our *Icon Enums
     * @param int|null $size The icon size
     * @param string|null $additionalClass Additional CSS class to add to the icon
     * @param string|null $title A title for the icon
     * @return string
     * @throws InvalidArgumentException
     * @throws ReflectionException
     */
    public static function getMdiIconTranslate(
        string $name,
        ?int $size = ICON_SIZE_SMALL,
        ?string $additionalClass = 'ch-tool-icon',
        ?string $title = null
    ): string
    {
        if (!empty($title)) {
            $title = get_lang($title);
        }

        return self::getMdiIconSimple($name, $size, $additionalClass, $title);
    }
    /**
     * Shortcut method to getMdiIcon, to be used from Twig (see ChamiloExtension.php)
     * using acceptable default values
     * @param string $name The icon name or a string representing the icon in our *Icon Enums
     * @param int|null $size The icon size
     * @param string|null $additionalClass Additional CSS class to add to the icon
     * @param string|null $title A title for the icon
     * @return string
     * @throws InvalidArgumentException
     * @throws ReflectionException
     */
    public static function getMdiIconSimple(
        string $name,
        ?int $size = ICON_SIZE_SMALL,
        ?string $additionalClass = 'ch-tool-icon',
        ?string $title = null
    ): string
    {
        // If the string contains '::', we assume it is a reference to one of the icon Enum classes in src/CoreBundle/Enums/
        $matches = [];
        if (preg_match('/(\w*)::(\w*)/', $name, $matches)) {
            if (count($matches) != 3) {
                throw new InvalidArgumentException('Invalid enum case string format. Expected format is "EnumClass::CASE".');
            }
            $enum = $matches[1];
            $case = $matches[2];
            if (!class_exists('Chamilo\CoreBundle\Enums\\'.$enum)) {
                throw new InvalidArgumentException("Class {$enum} does not exist.");
            }
            $reflection = new ReflectionEnum('Chamilo\CoreBundle\Enums\\'.$enum);
            // Check if the case exists in the Enum class
            if (!$reflection->hasCase($case)) {
                throw new InvalidArgumentException("Case {$case} does not exist in enum class {$enum}.");
            }
            // Get the Enum case
            /* @var ReflectionEnumUnitCase $enumUnitCaseObject */
            $enumUnitCaseObject = $reflection->getCase($case);
            $enumValue = $enumUnitCaseObject->getValue();
            $name = $enumValue->value;

        }

        return self::getMdiIcon($name, $additionalClass, null, $size, $title);
    }

    /**
     * Get a full HTML <i> tag for an icon from the Material Design Icons set
     * @param string|ActionIcon|ToolIcon|ObjectIcon|StateIcon $name
     * @param string|null                                     $additionalClass
     * @param string|null                                     $style
     * @param int|null                                        $pixelSize
     * @param string|null                                     $title
     * @param array|null                                      $additionalAttributes
     * @return string
     */
    public static function getMdiIcon(string|ActionIcon|ToolIcon|ObjectIcon|StateIcon $name, string $additionalClass = null, string $style = null, int $pixelSize = null, string $title = null, array $additionalAttributes = null): string
    {
        $sizeString = '';
        if (!empty($pixelSize)) {
            $sizeString = 'font-size: '.$pixelSize.'px; width: '.$pixelSize.'px; height: '.$pixelSize.'px; ';
        }
        if (empty($style)) {
            $style = '';
        }

        $additionalAttributes['class'] = 'mdi mdi-';

        if ($name instanceof ActionIcon
            || $name instanceof ToolIcon
            || $name instanceof ObjectIcon
            || $name instanceof StateIcon
        ) {
            $additionalAttributes['class'] .= $name->value;
        } else {
            $additionalAttributes['class'] .= $name;
        }

        $additionalAttributes['class'] .= " $additionalClass";
        $additionalAttributes['style'] = $sizeString.$style;
        $additionalAttributes['aria-hidden'] = 'true';

        if (!empty($title)) {
            $additionalAttributes['title'] = htmlentities($title);
        }

        return self::tag(
            'i',
            '',
            $additionalAttributes
        );
    }

    /**
     * Get a HTML code for a icon by Font Awesome.
     *
     * @param string     $name            The icon name. Example: "mail-reply"
     * @param int|string $size            Optional. The size for the icon. (Example: lg, 2, 3, 4, 5)
     * @param bool       $fixWidth        Optional. Whether add the fw class
     * @param string     $additionalClass Optional. Additional class
     *
     * @return string
     * @deprecated Use getMdiIcon() instead
     */
    public static function returnFontAwesomeIcon(
        $name,
        $size = '',
        $fixWidth = false,
        $additionalClass = ''
    ) {
        $className = "mdi mdi-$name";

        if ($fixWidth) {
            $className .= ' fa-fw';
        }

        switch ($size) {
            case 'xs':
            case 'sm':
            case 'lg':
                $className .= " fa-{$size}";
                break;
            case 2:
            case 3:
            case 4:
            case 5:
                $className .= " fa-{$size}x";
                break;
        }

        if (!empty($additionalClass)) {
            $className .= " $additionalClass";
        }

        $icon = self::tag('em', null, ['class' => $className]);

        return "$icon ";
    }

    public static function returnPrimeIcon(
        $name,
        $size = '',
        $fixWidth = false,
        $additionalClass = ''
    ) {
        $className = "pi pi-$name";

        if ($fixWidth) {
            $className .= ' pi-fw';
        }

        if ($size) {
            $className .= " pi-$size";
        }

        if (!empty($additionalClass)) {
            $className .= " $additionalClass";
        }

        $icon = self::tag('i', null, ['class' => $className]);

        return "$icon ";
    }

    /**
     * @param string     $title
     * @param string     $content
     * @param null       $id

Are you sure the doc-type for parameter $id is correct as it would always require null to be passed?

     * @param array      $params
     * @param null       $idAccordion

Are you sure the doc-type for parameter $idAccordion is correct as it would always require null to be passed?

     * @param null       $idCollapse

Are you sure the doc-type for parameter $idCollapse is correct as it would always require null to be passed?

     * @param bool|true  $open
     * @param bool|false $fullClickable
     *
     * @return string
     *
     * @todo rework function to easy use
     */
    public static function panelCollapse(
        $title,
        $content,
        $id = null,
        $params = [],
        $idAccordion = null,
        $idCollapse = null,
        $open = true,
        $fullClickable = false
    ) {
        $javascript = '';
        if (!empty($idAccordion)) {
            $javascript = '
        <script>
            document.addEventListener("DOMContentLoaded", function() {
                const buttons = document.querySelectorAll("#card_'.$idAccordion.' a");
                const menus = document.querySelectorAll("#collapse_'.$idAccordion.'");
                buttons.forEach((button, index) => {
                    button.addEventListener("click", function() {
                        menus.forEach((menu, menuIndex) => {
                            if (index === menuIndex) {
                                button.setAttribute("aria-expanded", "true" === button.getAttribute("aria-expanded") ? "false" : "true")
                                button.classList.toggle("mdi-chevron-down")
                                button.classList.toggle("mdi-chevron-up")
                                menu.classList.toggle("active");
                            } else {
                                menu.classList.remove("active");
                            }
                        });
                    });
                });
            });
        </script>';
            $html = '
        <div class="display-panel-collapse mb-2">
            <div class="display-panel-collapse__header" id="card_'.$idAccordion.'">
                <a role="button"
                    class="mdi mdi-chevron-down"
                    data-toggle="collapse"
                    data-target="#collapse_'.$idAccordion.'"
                    aria-expanded="'.(($open) ? 'true' : 'false').'"
                    aria-controls="collapse_'.$idAccordion.'"
                >
                    '.$title.'
                </a>
            </div>
            <div
                id="collapse_'.$idAccordion.'"
                class="display-panel-collapse__collapsible '.(($open) ? 'active' : '').'"
            >
                <div id="collapse_contant_'.$idAccordion.'">';

            $html .= $content;
            $html .= '</div></div></div>';

        } else {
            if (!empty($id)) {
                $params['id'] = $id;
            }
            $params['class'] = 'v-card bg-white mx-2';
            $html = '';
            if (!empty($title)) {
                $html .= '<div class="v-card-header text-h5 my-2">'.$title.'</div>'.PHP_EOL;
            }
            $html .= '<div class="v-card-text">'.$content.'</div>'.PHP_EOL;
            $html = self::div($html, $params);
        }

        return $javascript.$html;
    }

    /**
     * Returns the string "1 day ago" with a link showing the exact date time.
     *
     * @param string|DateTime $dateTime in UTC or a DateTime in UTC
     *
     * @throws Exception
     *
     * @return string
     */
    public static function dateToStringAgoAndLongDate(string|DateTime $dateTime): string
    {
        if (empty($dateTime) || '0000-00-00 00:00:00' === $dateTime) {
            return '';
        }

        if (is_string($dateTime)) {
            $dateTime = new \DateTime($dateTime, new \DateTimeZone('UTC'));
        }

        return self::tip(
            date_to_str_ago($dateTime),
            api_convert_and_format_date($dateTime, DATE_TIME_FORMAT_LONG)
        );
    }

    /**
     * @param array  $userInfo
     * @param string $status
     * @param string $toolbar
     *
     * @return string
     */
    public static function getUserCard($userInfo, $status = '', $toolbar = '')
    {
        if (empty($userInfo)) {
            return '';
        }

        if (!empty($status)) {
            $status = '<div class="items-user-status">'.$status.'</div>';
        }

        if (!empty($toolbar)) {
            $toolbar = '<div class="btn-group pull-right">'.$toolbar.'</div>';
        }

        return '<div id="user_card_'.$userInfo['id'].'" class="card d-flex flex-row">
                    <img src="'.$userInfo['avatar'].'" class="rounded" />
                    <h3 class="card-title">'.$userInfo['complete_name'].'</h3>
                    <div class="card-body">
                       <div class="card-title">
                       '.$status.'
                       '.$toolbar.'
                       </div>
                    </div>
                    <hr />
              </div>';
    }

    /**
     * @param string $fileName
     * @param string $fileUrl
     *
     * @return string
     */
    public static function fileHtmlGuesser($fileName, $fileUrl)
    {
        $data = pathinfo($fileName);

        //$content = self::url($data['basename'], $fileUrl);
        $content = '';
        switch ($data['extension']) {
            case 'webm':
            case 'mp4':
            case 'ogg':
                $content = '<video style="width: 400px; height:100%;" src="'.$fileUrl.'"></video>';
                // Allows video to play when loading during an ajax call
                $content .= "<script>jQuery('video:not(.skip), audio:not(.skip)').mediaelementplayer();</script>";
                break;
            case 'jpg':
            case 'jpeg':
            case 'gif':
            case 'png':
                $content = '<img class="img-responsive" src="'.$fileUrl.'" />';
                break;
            default:
                //$html = self::url($data['basename'], $fileUrl);
                break;
        }
        //$html = self::url($content, $fileUrl, ['ajax']);

        return $content;
    }

    /**
     * @param string $image
     * @param int    $size
     *
     * @return string
     */
    public static function get_icon_path($image, $size = ICON_SIZE_SMALL)
    {
        return self::return_icon($image, '', [], $size, false, true);
    }

    /**
     * @param $id
     *
     * @return array|mixed
     */
    public static function randomColor($id)
    {
        static $colors = [];

        if (!empty($colors[$id])) {
            return $colors[$id];
        } else {
            $color = substr(md5(time() * $id), 0, 6);
            $c1 = hexdec(substr($color, 0, 2));
            $c2 = hexdec(substr($color, 2, 2));
            $c3 = hexdec(substr($color, 4, 2));
            $luminosity = $c1 + $c2 + $c3;

            $type = '#000000';
            if ($luminosity < (255 + 255 + 255) / 2) {
                $type = '#FFFFFF';
            }

            $result = [
                'color' => '#'.$color,
                'luminosity' => $type,
            ];
            $colors[$id] = $result;

            return $result; // example: #fc443a
        }
    }

    public static function noDataView(string $title, string $icon, string $buttonTitle, string $url): string
    {
        $content = '<div id="no-data-view">';
        $content .= '<h3>'.$title.'</h3>';
        $content .= $icon;
        $content .= '<div class="controls">';
        $content .= self::url(
            '<em class="fa fa-plus"></em> '.$buttonTitle,
            $url,
            ['class' => 'btn btn--primary']
        );
        $content .= '</div>';
        $content .= '</div>';

        return $content;
    }

    public static function prose(string $contents): string
    {
        return "
    <div class='w-full my-8'>
      <div class='prose prose-blue max-w-none px-6 py-4 bg-white rounded-lg shadow'>
        $contents
      </div>
    </div>
    ";
    }

    public static function getFrameReadyBlock(
        string $frameName,
        string $itemType = '',
        string $jsConditionalFunction = 'function () { return false; }'
    ): string {

        if (in_array($itemType, ['link', 'sco', 'xapi', 'quiz', 'h5p', 'forum'])) {
            return false;

The expression return false returns the type false which is incompatible with the type-hinted return string.

        }

        $themeHelper = Container::$container->get(ThemeHelper::class);

The method get() does not exist on null.

        $themeColorsUrl = $themeHelper->getThemeAssetUrl('colors.css');

        $colorThemeItem = $themeColorsUrl
            ? '{ type: "stylesheet", src: "'.$themeColorsUrl.'" },'
            : '';

        return '$.frameReady(function() {},
            "'.$frameName.'",
            [
                { type: "script", src: "/build/runtime.js" },
                { type: "script", src: "/build/legacy_framereadyloader.js" },
                { type: "stylesheet", src: "/build/legacy_framereadyloader.css" },
                '.$colorThemeItem.'
            ],
            '.$jsConditionalFunction
            .');';
    }

    /**
     * Renders and consumes messages stored with Display::addFlash().
     * Returns HTML ready to inject into the view (alert-*).
     *
     * @return html string with all Flash messages (or '' if none)
     */
    public static function getFlash(): string
    {
        $html = '';

        try {
            $flashBag = Container::getSession()->getFlashBag();
            $all = $flashBag->all();

            foreach ($all as $type => $messages) {
                switch ($type) {
                    case 'success':
                        $displayType = 'success';
                        break;
                    case 'warning':
                        $displayType = 'warning';
                        break;
                    case 'danger':
                    case 'error':
                        $displayType = 'error';
                        break;
                    case 'info':
                    case 'primary':
                    default:
                        $displayType = 'info';
                        break;
                }

                foreach ((array) $messages as $msg) {
                    if (is_string($msg) && $msg !== '') {
                        $html .= self::return_message($msg, $displayType, false);
                    }
                }
            }
        } catch (\Throwable $e) {
            error_log('Display::getFlash error: '.$e->getMessage());
        }

        return $html;
    }

    /**
     * Build the common MySpace / tracking menu (left part of the toolbar).
     *
     * $current can be:
     *  - overview
     *  - students
     *  - teachers
     *  - admin_view
     *  - exams
     *  - current_courses
     *  - courses
     *  - sessions
     *  - company_reports
     *  - company_reports_resumed
     */
    public static function mySpaceMenu(?string $current = 'overview'): string
    {
        $base = api_get_path(WEB_CODE_PATH).'my_space/';
        $items = [];

        $isPlatformAdmin = api_is_platform_admin();
        $isDrh = api_is_drh();
        if ('yourstudents' === $current) {
            $current = 'students';
        }

        if ($isDrh) {
            // DRH menu.
            $items = [
                'students' => [
                    'icon' => ObjectIcon::USER,
                    'title' => get_lang('Learners'),
                    'url' => $base.'student.php',
                ],
                'teachers' => [
                    'icon' => ObjectIcon::TEACHER,
                    'title' => get_lang('Teachers'),
                    'url' => $base.'teachers.php',
                ],
                'courses' => [
                    'icon' => ObjectIcon::COURSE,
                    'title' => get_lang('Courses'),
                    'url' => $base.'course.php',
                ],
                'sessions' => [
                    'icon' => ObjectIcon::SESSION,
                    'title' => get_lang('Course sessions'),
                    'url' => $base.'session.php',
                ],
                'company_reports' => [
                    'icon' => ObjectIcon::REPORT,
                    'title' => get_lang('Corporate report'),
                    'url' => $base.'company_reports.php',
                ],
                'company_reports_resumed' => [
                    'icon' => 'chart-box-outline',
                    'title' => get_lang('Corporate report, short version'),
                    'url' => $base.'company_reports_resumed.php',
                ],
            ];
        } else {
            // Teacher / platform admin menu.
            $items = [
                'overview' => [
                    'icon' => 'chart-bar',
                    'title' => get_lang('Global view'),
                    'url' => $base.'index.php',
                ],
                'students' => [
                    'icon' => 'account-star',
                    'title' => get_lang('Learners'),
                    'url' => $base.'student.php',
                ],
                'teachers' => [
                    'icon' => 'human-male-board',
                    'title' => get_lang('Teachers'),
                    'url' => $base.'teachers.php',
                ],
            ];

            if ($isPlatformAdmin) {
                $items['admin_view'] = [
                    'icon' => 'star-outline',
                    'title' => get_lang('Admin view'),
                    'url' => $base.'admin_view.php',
                ];
                $items['exams'] = [
                    'icon' => 'order-bool-ascending-variant',
                    'title' => get_lang('Exam tracking'),
                    'url' => api_get_path(WEB_CODE_PATH).'tracking/exams.php',
                ];
                $items['current_courses'] = [
                    'icon' => 'book-open-page-variant',
                    'title' => get_lang('Current courses report'),
                    'url' => $base.'current_courses.php',
                ];
                $items['certificate_report'] = [
                    'icon' => 'certificate',
                    'title' => get_lang('See list of learner certificates'),
                    'url' => api_get_path(WEB_CODE_PATH).'gradebook/certificate_report.php',
                ];
            }
        }

        $html = '';

        foreach ($items as $name => $item) {
            $iconClass = $name === $current ? 'ch-tool-icon-disabled' : 'ch-tool-icon';
            $url = $name === $current ? '' : $item['url'];

            $html .= self::url(
                self::getMdiIcon(
                    $item['icon'],
                    $iconClass,
                    null,
                    32,
                    $item['title']
                ),
                $url
            );
        }

        return $html;
    }

    /**
     * Reusable collapsible wrapper for "advanced parameters" sections.
     */
    public static function advancedPanelStart(
        string $id,
        string $title,
        bool $open = false,
        array $options = []
    ): string {
        $safeId = preg_replace('/[^a-zA-Z0-9\-_:.]/', '_', $id);
        $safeTitle = Security::remove_XSS($title);

        $openAttr = $open ? ' open' : '';

        $detailsClass = $options['details_class']
            ?? 'display-advanced-panel mb-4';

        // Button-like summary, fit to text (no full width)
        $summaryClass = $options['summary_class']
            ?? 'inline-flex w-fit items-center gap-2 cursor-pointer select-none whitespace-nowrap
            bg-primary text-white
            border border-primary rounded px-3 py-2 shadow-sm font-semibold
            hover:opacity-90 transition
            focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2';

        $contentClass = $options['content_class']
            ?? 'bg-white border border-gray-25 rounded mt-3 px-3 py-3';

        return '
            <details id="'.$safeId.'" class="'.$detailsClass.'"'.$openAttr.'>
              <summary class="'.$summaryClass.'">
                <span class="display-advanced-panel__chevron" aria-hidden="true">▸</span>
                <span>'.$safeTitle.'</span>
              </summary>
              <div class="'.$contentClass.'">
            ';
    }

    public static function advancedPanelEnd(): string
    {
        return '
          </div>
        </details>
        ';
    }

    /**
     * Render a consistent "Subscribe users to this session" header + tabs layout
     * reused across legacy admin pages (add users, usergroups, etc).
     *
     * $activeTab: users|classes|teachers|students
     * $options:
     *  - return_to: string (used to preserve the "Back" destination in the Classes tab)
     *  - header_title: string (defaults to get_lang('Subscribe users to this session'))
     *  - users_url/classes_url/teachers_url/students_url: override URLs if needed
     *  - wrapper_class: string
     *  - card_class: string
     *  - tabs_bar_class: string
     *  - content_class: string
     */
    public static function sessionSubscriptionPage(
        int $sessionId,
        string $sessionTitle,
        string $backUrl,
        string $activeTab,
        string $contentHtml,
        array $options = []
    ): string {
        $safeTitle = htmlspecialchars($sessionTitle, ENT_QUOTES, api_get_system_encoding());

        $headerTitle = $options['header_title'] ?? get_lang('Subscribe users to this session');

        $returnTo = (string) ($options['return_to'] ?? '');

        $usersUrl = $options['users_url']
            ?? api_get_path(WEB_CODE_PATH).'session/add_users_to_session.php?id_session='.$sessionId.'&add=true';

        $classesUrl = $options['classes_url']
            ?? api_get_path(WEB_CODE_PATH).'admin/usergroups.php?from_session='.$sessionId
            .(!empty($returnTo) ? '&return_to='.rawurlencode($returnTo) : '');

        $teachersUrl = $options['teachers_url']
            ?? api_get_path(WEB_CODE_PATH).'session/add_teachers_to_session.php?id='.$sessionId;

        $studentsUrl = $options['students_url']
            ?? api_get_path(WEB_CODE_PATH).'session/add_students_to_session.php?id='.$sessionId;

        $wrapperClass = $options['wrapper_class'] ?? 'mx-auto w-full p-4 space-y-4';
        $cardClass = $options['card_class'] ?? 'rounded-lg border border-gray-30 bg-white shadow-sm';
        $tabsBarClass = $options['tabs_bar_class'] ?? 'flex flex-wrap items-center gap-2 border-b border-gray-20 px-3 py-2';
        $contentClass = $options['content_class'] ?? 'p-4';

        $btnNeutral = 'inline-flex items-center gap-2 rounded-md border border-gray-30 bg-white px-3 py-1.5 text-sm font-medium text-gray-90 shadow-sm hover:bg-gray-10';

        $tabBase = 'inline-flex items-center gap-2 rounded-md px-3 py-2 text-sm';
        $tabActive = 'font-semibold bg-gray-10 text-gray-90';
        $tabIdle = 'font-medium text-gray-90 hover:bg-gray-10';

        $tabs = [
            'users' => [
                'url' => $usersUrl,
                'label' => get_lang('Users'),
                'icon' => \Chamilo\CoreBundle\Enums\ObjectIcon::USER,
            ],
            'classes' => [
                'url' => $classesUrl,
                'label' => get_lang('Enrolment by classes'),
                'icon' => \Chamilo\CoreBundle\Enums\ObjectIcon::MULTI_ELEMENT,
            ],
            'teachers' => [
                'url' => $teachersUrl,
                'label' => get_lang('Enroll trainers from existing sessions'),
                'icon' => \Chamilo\CoreBundle\Enums\ObjectIcon::TEACHER,
            ],
            'students' => [
                'url' => $studentsUrl,
                'label' => get_lang('Enroll students from existing sessions'),
                'icon' => \Chamilo\CoreBundle\Enums\ObjectIcon::USER,
            ],
        ];

        if (!isset($tabs[$activeTab])) {
            $activeTab = 'users';
        }

        $html = '';
        $html .= '<div class="'.$wrapperClass.'">';

        // Header card
        $html .= '  <div class="'.$cardClass.' p-4">';
        $html .= '    <div class="flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between">';
        $html .= '      <div class="min-w-0">';
        $html .= '        <h1 class="text-lg font-semibold text-gray-90">'.htmlspecialchars($headerTitle, ENT_QUOTES, api_get_system_encoding()).'</h1>';
        $html .= '        <p class="text-sm text-gray-50">'.$safeTitle.'</p>';
        $html .= '      </div>';
        $html .= '      <div class="flex items-center gap-2">';
        $html .= '        <a href="'.htmlspecialchars($backUrl, ENT_QUOTES, api_get_system_encoding()).'" class="'.$btnNeutral.'">'.get_lang('Back').'</a>';
        $html .= '      </div>';
        $html .= '    </div>';
        $html .= '  </div>';

        // Tabs + content in the SAME card (so it looks like real tabs)
        $html .= '  <div class="'.$cardClass.'">';
        $html .= '    <div class="'.$tabsBarClass.'">';

        foreach ($tabs as $key => $tab) {
            $cls = $tabBase.' '.($key === $activeTab ? $tabActive : $tabIdle);
            $ariaCurrent = $key === $activeTab ? ' aria-current="page"' : '';

            $html .= '      <a href="'.htmlspecialchars($tab['url'], ENT_QUOTES, api_get_system_encoding()).'" class="'.$cls.'"'.$ariaCurrent.'>';
            $html .=            self::getMdiIcon($tab['icon'], 'ch-tool-icon', null, ICON_SIZE_SMALL, $tab['label']);
            $html .= '        <span>'.$tab['label'].'</span>';
            $html .= '      </a>';
        }

        $html .= '    </div>';
        $html .= '    <div class="'.$contentClass.'">'.$contentHtml.'</div>';
        $html .= '  </div>';

        $html .= '</div>';

        return $html;
    }
}