12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297 |
- <?php
- /* For licensing terms, see /license.txt */
- use ChamiloSession as Session;
- /**
- * 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::display_normal_message($message)
- *
- * @package chamilo.library
- *
- */
- class Display
- {
- /** @var Template */
- public static $global_template;
- public static $preview_style = null;
- /**
- * Constructor
- */
- public function __construct()
- {
- }
- /**
- * @return array
- */
- public static function toolList()
- {
- return array(
- '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)
- {
- $origin = api_get_origin();
- $showHeader = true;
- if (isset($origin) && $origin == 'learnpath') {
- $showHeader = false;
- }
- self::$global_template = new Template($tool_name, $showHeader, $showHeader);
- // Fixing tools with any help it takes xxx part of main/xxx/index.php
- if (empty($help)) {
- $currentURL = api_get_self();
- preg_match('/main\/([^*\/]+)/', $currentURL, $matches);
- $toolList = self::toolList();
- if (!empty($matches)) {
- foreach ($matches as $match) {
- if (in_array($match, $toolList)) {
- $help = explode('_', $match);
- $help = array_map('ucfirst', $help);
- $help = implode('', $help);
- break;
- }
- }
- }
- }
- self::$global_template->setHelp($help);
- if (!empty(self::$preview_style)) {
- self::$global_template->preview_theme = self::$preview_style;
- self::$global_template->setCssFiles();
- self::$global_template->set_js_files();
- self::$global_template->setCssCustomFiles();
- }
- if (!empty($page_header)) {
- self::$global_template->assign('header', $page_header);
- }
- echo self::$global_template->show_header_template();
- }
- /**
- * Displays the reduced page header (without banner)
- */
- public static function display_reduced_header()
- {
- global $show_learnpath, $tool_name;
- self::$global_template = new Template($tool_name, false, false, $show_learnpath);
- echo self::$global_template->show_header_template();
- }
- /**
- * Display no header
- */
- public static function display_no_header()
- {
- global $tool_name, $show_learnpath;
- $disable_js_and_css_files = true;
- self::$global_template = new Template($tool_name, false, false, $show_learnpath);
- }
- /**
- * Displays the reduced page header (without banner)
- */
- public static function set_header()
- {
- global $show_learnpath, $tool_name;
- self::$global_template = new Template($tool_name, false, false, $show_learnpath);
- }
- /**
- * Display the page footer
- */
- public static function display_footer()
- {
- echo self::$global_template->show_footer_template();
- }
- public static function page()
- {
- return new Page();
- }
- /**
- * 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 html code for adding an introduction
- */
- public static function display_introduction_section($tool, $editor_config = null)
- {
- echo self::return_introduction_section($tool, $editor_config);
- }
- /**
- * @param string $tool
- * @param array $editor_config
- * @return null
- */
- public static function return_introduction_section($tool, $editor_config = null)
- {
- $is_allowed_to_edit = api_is_allowed_to_edit();
- $moduleId = $tool;
- if (api_get_setting('enable_tool_introduction') == 'true' || $tool == TOOL_COURSE_HOMEPAGE) {
- $introduction_section = null;
- require api_get_path(INCLUDE_PATH).'introductionSection.inc.php';
- return $introduction_section;
- }
- }
- /**
- * Displays a localised html file
- * tries to show the file "$full_file_name"."_".$language_interface.".html"
- * and if this does not exist, shows the file "$full_file_name".".html"
- * warning this public function defines a global
- * @param $full_file_name, the (path) name of the file, without .html
- * @return return a string with the path
- */
- public static function display_localised_html_file($full_file_name)
- {
- global $language_interface;
- $localised_file_name = $full_file_name.'_'.$language_interface.'.html';
- $default_file_name = $full_file_name.'.html';
- if (file_exists($localised_file_name)) {
- include $localised_file_name;
- } else {
- include $default_file_name;
- }
- }
- /**
- * 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 string The style that the table will show. You can set 'table' or 'grid'
- * @author bart.mollet@hogent.be
- */
- public static function display_sortable_table(
- $header,
- $content,
- $sorting_options = array(),
- $paging_options = array(),
- $query_vars = null,
- $form_actions = array(),
- $style = 'table'
- ) {
- global $origin;
- $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 SortableTableFromArray($content, $column, $default_items_per_page);
- if (is_array($query_vars)) {
- $table->set_additional_parameters($query_vars);
- }
- if ($style == 'table') {
- 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();
- }
- }
- public static function return_sortable_table(
- $header,
- $content,
- $sorting_options = array(),
- $paging_options = array(),
- $query_vars = null,
- $form_actions = array(),
- $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 array $form actions 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 = array(),
- $query_vars = null,
- $form_actions = array(),
- $visibility_options = true,
- $sort_data = true,
- $grid_class = array()
- ) {
- 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 array $form actions 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 = array(),
- $query_vars = null,
- $form_actions = array(),
- $visibility_options = true,
- $sort_data = true,
- $grid_class = array(),
- $elementCount = 0
- ) {
- $column = 0;
- $default_items_per_page = isset($paging_options['per_page']) ? $paging_options['per_page'] : 20;
- $table = new SortableTableFromArray($content, $column, $default_items_per_page, $name);
- $table->total_number_of_items = intval($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 = array(),
- $paging_options = array(),
- $query_vars = null,
- $column_show = array(),
- $column_order = array(),
- $form_actions = array()
- ) {
- $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++) {
- 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();
- }
- /**
- * Displays a normal message. It is recommended to use this public function
- * to display any normal information messages.
- * @param string $message
- * @param bool $filter (true) or not (false)
- * @param bool $returnValue
- *
- * @return void
- */
- public static function display_normal_message($message, $filter = true, $returnValue = false)
- {
- $message = self::return_message($message, 'normal', $filter);
- if ($returnValue) {
- return $message;
- } else {
- echo $message;
- }
- }
- /**
- * Displays an warning message. Use this if you want to draw attention to something
- * This can also be used for instance with the hint in the exercises
- *
- */
- public static function display_warning_message($message, $filter = true, $returnValue = false)
- {
- $message = self::return_message($message, 'warning', $filter);
- if ($returnValue) {
- return $message;
- } else {
- echo $message;
- }
- }
- /**
- * Displays an confirmation message. Use this if something has been done successfully
- * @param bool Filter (true) or not (false)
- * @return void
- */
- public static function display_confirmation_message ($message, $filter = true, $returnValue = false)
- {
- $message = self::return_message($message, 'confirm', $filter);
- if ($returnValue) {
- return $message;
- } else {
- echo $message;
- }
- }
- /**
- * Displays an error message. It is recommended to use this public function if an error occurs
- * @param string $message - include any additional html
- * tags if you need them
- * @param bool Filter (true) or not (false)
- * @return void
- */
- public static function display_error_message ($message, $filter = true, $returnValue = false)
- {
- $message = self::return_message($message, 'error', $filter);
- if ($returnValue) {
- return $message;
- } else {
- echo $message;
- }
- }
- /**
- * @param string $message
- * @param string $type
- * @param bool $filter
- */
- public static function return_message_and_translate($message, $type='normal', $filter = true)
- {
- $message = get_lang($message);
- echo self::return_message($message, $type, $filter);
- }
- /**
- * Returns a div html string with
- * @param string The message
- * @param string The message type (confirm,normal,warning,error)
- * @param bool Whether to XSS-filter or not
- * @return string Message wrapped into an HTML div
- */
- public static function return_message($message, $type = 'normal', $filter = true)
- {
- if ($filter) {
- $message = api_htmlentities($message, ENT_QUOTES, api_is_xml_http_request() ? 'UTF-8' : api_get_system_encoding());
- }
- $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':
- default:
- $class .= 'alert alert-info';
- }
- return self::div($message, array('class'=> $class));
- }
- /**
- * Returns an encrypted mailto hyperlink
- *
- * @param string e-mail
- * @param string clickable text
- * @param string optional, class from stylesheet
- * @return string encrypted mailto hyperlink
- */
- public static function encrypted_mailto_link ($email, $clickable_text = null, $style_class = '')
- {
- if (is_null($clickable_text)) {
- $clickable_text = $email;
- }
- // "mailto:" already present?
- if (substr($email, 0, 7) != 'mailto:') {
- $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 }).';';
- }
- $hclickable_text = null;
- // 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>';
- }
- /**
- * Returns an mailto icon hyperlink
- *
- * @param string e-mail
- * @param string icon source file from the icon lib
- * @param integer icon size from icon lib
- * @param string optional, class from stylesheet
- * @return string encrypted mailto hyperlink
- */
- public static function icon_mailto_link($email, $icon_file = "mail.png", $icon_size = 22, $style_class = '')
- {
- // "mailto:" already present?
- if (substr($email, 0, 7) != 'mailto:') {
- $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 }).';';
- }
- // icon html code
- $icon_html_source = self::return_icon($icon_file, $hmail, '', $icon_size);
- // Return encrypted mailto hyperlink
- return '<a href="'.$hmail.'"'.$style_class.' class="clickable_email_link">'.$icon_html_source.'</a>';
- }
- /**
- * Creates a hyperlink to the platform homepage.
- * @param string $name, the visible name of the hyperlink, default is sitename
- * @return string with html code for hyperlink
- */
- public static function get_platform_home_link_html($name = '')
- {
- if ($name == '') {
- $name = api_get_setting('siteName');
- }
- return '<a href="'.api_get_path(WEB_PATH).'index.php">'.$name.'</a>';
- }
- /**
- * Prints an <option>-list with all letters (A-Z).
- * @param char $selected_letter The letter that should be selected
- * @todo This is English language specific implementation.
- * It should be adapted for the other languages.
- */
- public static function get_alphabet_options($selected_letter = '')
- {
- $result = '';
- for ($i = 65; $i <= 90; $i ++) {
- $letter = chr($i);
- $result .= '<option value="'.$letter.'"';
- if ($selected_letter == $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;
- }
- /**
- * This public function displays 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 integer The wanted width of the icon (to be looked for in the corresponding img/icons/ folder)
- * @return void
- */
- public static function display_icon(
- $image,
- $alt_text = '',
- $additional_attributes = array(),
- $size = null
- ) {
- echo self::return_icon($image, $alt_text, $additional_attributes, $size);
- }
- /**
- * 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 integer 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(
- $image,
- $alt_text = '',
- $additional_attributes = array(),
- $size = ICON_SIZE_SMALL,
- $show_text = true,
- $return_only_path = false
- ) {
- $code_path = api_get_path(SYS_CODE_PATH);
- $w_code_path = api_get_path(WEB_CODE_PATH);
- $alternateCssPath = api_get_path(SYS_CSS_PATH);
- $alternateWebCssPath = api_get_path(WEB_CSS_PATH);
- $image = trim($image);
- $theme = 'themes/' . api_get_visual_theme() . '/icons/';
- $size_extra = '';
- if (isset($size)) {
- $size = intval($size);
- $size_extra = $size . '/';
- } else {
- $size = ICON_SIZE_SMALL;
- }
- //Checking the theme icons folder example: app/Resources/public/css/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 {
- //Checking the img/ folder
- $icon = $w_code_path . 'img/' . $image;
- }
- // Special code to enable SVG - refs #7359 - Needs more work
- // The code below does something else to "test out" SVG: for each icon,
- // it checks if there is an SVG version. If so, it uses it.
- // When moving this to production, the return_icon() calls should
- // ask for the SVG version directly
- $testServer = api_get_setting('server_type');
- if ($testServer == 'test' && $return_only_path == false) {
- $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;
- }
- }
- $icon = api_get_cdn_path($icon);
- if ($return_only_path) {
- return $icon;
- }
- $img = self::img($icon, $alt_text, $additional_attributes);
- if (SHOW_TEXT_NEAR_ICONS == true and !empty($alt_text)) {
- if ($show_text) {
- $img = "$img $alt_text";
- }
- }
- return $img;
- }
- /**
- * Returns the htmlcode 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 boolean $filterPath Optional. Whether filter the image path. Default is true
- * @author Julio Montoya 2010
- */
- public static function img($image_path, $alt_text = '', $additional_attributes = array(), $filterPath = true)
- {
- // 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);
- }
- $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 htmlcode 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, ...)
- * @author Julio Montoya 2010
- */
- public static function tag($tag, $content, $additional_attributes = array())
- {
- $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, array('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($name, $url, $attributes = array())
- {
- if (!empty($url)) {
- $url = preg_replace('#&#', '&', $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($content, $attributes = array())
- {
- return self::tag('div', $content, $attributes);
- }
- /**
- * Creates a span tag
- */
- public static function span($content, $attributes = array())
- {
- return self::tag('span', $content, $attributes);
- }
- /**
- * Displays an HTML input tag
- *
- */
- public static function input($type, $name, $value, $attributes = array())
- {
- if (isset($type)) {
- $attributes['type']= $type;
- }
- if (isset($name)) {
- $attributes['name']= $name;
- }
- if (isset($value)) {
- $attributes['value']= $value;
- }
- return self::tag('input', '', $attributes);
- }
- /**
- * @param $name
- * @param $value
- * @param array $attributes
- * @return string
- */
- public static function button($name, $value, $attributes = array())
- {
- if (!empty($name)) {
- $attributes['name'] = $name;
- }
- return self::tag('button', $value, $attributes);
- }
- /**
- * Displays an HTML select tag
- *
- */
- public static function select(
- $name,
- $values,
- $default = -1,
- $extra_attributes = array(),
- $show_blank_item = true,
- $blank_item_text = null
- ) {
- $html = '';
- $extra = '';
- $default_id = 'id="' . $name . '" ';
- foreach ($extra_attributes as $key => $parameter) {
- if ($key == 'id') {
- $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 . ' --', array('value' => '-1'));
- }
- if ($values) {
- 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;
- }
- /**
- * 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
- * @example
- * <script>
- $(function() {
- $( "#tabs" ).tabs();
- });
- </script>
- * @param array list of the tab titles
- * @param array content that will be showed
- * @param string the id of the container of the tab in the example "tabs"
- * @param array attributes for the ul
- *
- */
- public static function tabs($header_list, $content_list, $id = 'tabs', $attributes = array(), $ul_attributes = array())
- {
- if (empty($header_list) || count($header_list) == 0 ) {
- return '';
- }
- $lis = '';
- $i = 1;
- foreach ($header_list as $item) {
- $active = '';
- if ($i == 1) {
- $active = ' active';
- }
- $item = self::tag('a', $item, array('href'=>'#'.$id.'-'.$i, 'role'=> 'tab'));
- $ul_attributes['data-toggle'] = 'tab';
- $ul_attributes['role'] = 'presentation';
- $ul_attributes['class'] = $active;
- $lis .= self::tag('li', $item, $ul_attributes);
- $i++;
- }
- $ul = self::tag('ul', $lis, ['class' => 'nav nav-tabs', 'role'=> 'tablist']);
- $i = 1;
- $divs = '';
- foreach ($content_list as $content) {
- $active = '';
- if ($i == 1) {
- $active = ' active';
- }
- $divs .= self::tag('div', $content, array('id'=> $id.'-'.$i, 'class' => 'tab-pane '.$active, 'role' => 'tabpanel'));
- $i++;
- }
- $attributes['id'] = $id;
- $attributes['role'] = 'tabpanel';
- $attributes['class'] = 'tab-wrapper';
- $main_div = self::tag('div', $ul.self::tag('div', $divs, ['class' => 'tab-content']), $attributes);
- return $main_div ;
- }
- /**
- * @param $headers
- * @param null $selected
- *
- * @return string
- */
- public static function tabsOnlyLink($headers, $selected = null)
- {
- $id = uniqid();
- $i = 1;
- $lis = null;
- foreach ($headers as $item) {
- $class = null;
- if ($i == $selected) {
- $class = 'active';
- }
- $item = self::tag(
- 'a',
- $item['content'],
- array('id' => $id.'-'.$i, 'href' => $item['url'])
- );
- $lis .= self::tag('li', $item, array('class' => $class));
- $i++;
- }
- return self::tag('ul', $lis, array('class' => 'nav nav-tabs tabs-margin'));
- }
- /**
- * 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,array());
- * // 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','', array('id' => $div_id));
- $table .= self::tag('div','', array('id' => $div_id.'_pager'));
- return $table;
- }
- /**
- * @param string $label
- * @param string $form_item
- * @return string
- */
- public static function form_row($label, $form_item)
- {
- $label = self::span($label, array('class' =>'control-label'));
- $form_item = self::div($form_item, array('class' =>'controls'));
- return self::div($label.$form_item, array('class'=>'control-group'));
- }
- /**
- * 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 = array(),
- $formatter = '',
- $fixed_width = false
- ) {
- $obj = new stdClass();
- $obj->first = 'first';
- if (!empty($url)) {
- $obj->url = $url;
- }
- //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';
- $all_value = 10000000;
- // Default row quantity
- if (!isset($extra_params['rowList'])) {
- $extra_params['rowList'] = array(20, 50, 100, 500, 1000, $all_value);
- }
- $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'];
- }
- //Sets how many records we want to view in the grid
- $obj->rowNum = 20;
- if (!empty($extra_params['rowNum'])) {
- $obj->rowNum = $extra_params['rowNum'];
- }
- 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']);
- }
- // Adding extra params
- if (!empty($extra_params)) {
- foreach ($extra_params as $key => $element) {
- // the groupHeaders key gets a special treatment
- if ($key != 'groupHeaders') {
- $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);
- }
- // 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(array('{"first":"first",','"end":"end"}'), '', $json_encode);
- // Creating the jqgrid element.
- $json .= '$("#'.$div_id.'").jqGrid({';
- //$json .= $beforeSelectRow;
- $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 = array())
- {
- 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();
- }
- /**
- * Returns the "what's new" icon notifications
- *
- * The general logic of this function is to track the last time the user
- * entered the course and compare to what has changed inside this course
- * since then, based on the item_property table inside this course. Note that,
- * if the user never entered the course before, he will not see notification
- * icons. This function takes session ID into account (if any) and only shows
- * the corresponding notifications.
- * @param array Course information array, containing at least elements 'db' and 'k'
- * @return string The HTML link to be shown next to the course
- */
- public static function show_notification($course_info)
- {
- if (empty($course_info)) {
- return '';
- }
- $t_track_e_access = Database::get_main_table(TABLE_STATISTIC_TRACK_E_LASTACCESS);
- $course_tool_table = Database::get_course_table(TABLE_TOOL_LIST);
- $tool_edit_table = Database::get_course_table(TABLE_ITEM_PROPERTY);
- $course_code = Database::escape_string($course_info['code']);
- $user_id = api_get_user_id();
- $course_id = intval($course_info['real_id']);
- $sessionId = intval($course_info['id_session']);
- // Get the user's last access dates to all tools of this course
- $sql = "SELECT *
- FROM $t_track_e_access
- WHERE
- c_id = $course_id AND
- access_user_id = '$user_id' AND
- access_session_id ='".$sessionId."'";
- $resLastTrackInCourse = Database::query($sql);
- $oldestTrackDate = $oldestTrackDateOrig = '3000-01-01 00:00:00';
- while ($lastTrackInCourse = Database::fetch_array($resLastTrackInCourse)) {
- $lastTrackInCourseDate[$lastTrackInCourse['access_tool']] = $lastTrackInCourse['access_date'];
- if ($oldestTrackDate > $lastTrackInCourse['access_date']) {
- $oldestTrackDate = $lastTrackInCourse['access_date'];
- }
- }
- if ($oldestTrackDate == $oldestTrackDateOrig) {
- //if there was no connexion to the course ever, then take the
- // course creation date as a reference
- $oldestTrackDate = $course_info['creation_date'];
- }
- $sessionCondition = api_get_session_condition(
- $sessionId,
- true,
- false,
- 'tet.session_id'
- );
- // Get the last edits of all tools of this course.
- $sql = "SELECT
- tet.*,
- tet.lastedit_date last_date,
- tet.tool tool,
- tet.ref ref,
- tet.lastedit_type type,
- tet.to_group_id group_id,
- ctt.image image,
- ctt.link link
- FROM $tool_edit_table tet
- INNER JOIN $course_tool_table ctt
- ON tet.c_id = ctt.c_id
- WHERE
- tet.c_id = $course_id AND
- tet.lastedit_date > '$oldestTrackDate' ".
- // Special hack for work tool, which is called student_publication in c_tool and work in c_item_property :-/ BT#7104
- " AND (ctt.name = tet.tool OR (ctt.name = 'student_publication' AND tet.tool = 'work'))
- AND ctt.visibility = '1'
- AND tet.lastedit_user_id != $user_id $sessionCondition
- ORDER BY tet.lastedit_date";
- $res = Database::query($sql);
- // Get the group_id's with user membership.
- $group_ids = GroupManager :: get_group_ids($course_info['real_id'], $user_id);
- $group_ids[] = 0; //add group 'everyone'
- $notifications = array();
- // Filter all last edits of all tools of the course
- while ($res && ($item_property = Database::fetch_array($res, 'ASSOC'))) {
- // First thing to check is if the user never entered the tool
- // or if his last visit was earlier than the last modification.
- if ((!isset($lastTrackInCourseDate[$item_property['tool']])
- || $lastTrackInCourseDate[$item_property['tool']] < $item_property['lastedit_date'])
- // Drop the tool elements that are part of a group that the
- // user is not part of.
- && ((in_array($item_property['to_group_id'], $group_ids)
- // Drop the dropbox, notebook and chat tools (we don't care)
- && (
- //$item_property['tool'] != TOOL_DROPBOX &&
- $item_property['tool'] != TOOL_NOTEBOOK &&
- $item_property['tool'] != TOOL_CHAT)
- )
- )
- // Take only what's visible or "invisible but where the user is a teacher" or where the visibility is unset.
- && ($item_property['visibility'] == '1'
- || ($course_info['status'] == '1' && $item_property['visibility'] == '0')
- || !isset($item_property['visibility']))
- ) {
- // Also drop announcements and events that are not for the user or his group.
- if ((
- $item_property['tool'] == TOOL_ANNOUNCEMENT ||
- $item_property['tool'] == TOOL_CALENDAR_EVENT
- ) &&
- (
- ($item_property['to_user_id'] != $user_id) &&
- (!isset($item_property['to_group_id']) || !in_array($item_property['to_group_id'], $group_ids)))
- ) {
- continue;
- }
- // If it's a survey, make sure the user's invited. Otherwise drop it.
- if ($item_property['tool'] == TOOL_SURVEY) {
- $survey_info = SurveyManager::get_survey($item_property['ref'], 0, $course_code);
- if (!empty($survey_info)) {
- $invited_users = SurveyUtil::get_invited_users(
- $survey_info['code'],
- $course_code
- );
- if (!in_array($user_id, $invited_users['course_users'])) {
- continue;
- }
- }
- }
- // If it's a learning path, ensure it is currently visible to the user
- if ($item_property['tool'] == TOOL_LEARNPATH) {
- if (!learnpath::is_lp_visible_for_student($item_property['ref'], $user_id, $course_code)) {
- continue;
- }
- }
- if ($item_property['tool'] == TOOL_DROPBOX) {
- $item_property['link'] = 'dropbox/dropbox_download.php?id='.$item_property['ref'];
- }
- if ($item_property['tool'] == 'work' &&
- $item_property['type'] == 'DirectoryCreated'
- ) {
- $item_property['lastedit_type'] = 'WorkAdded';
- }
- $notifications[$item_property['tool']] = $item_property;
- }
- }
- // Show all tool icons where there is something new.
- $return = ' ';
- foreach($notifications as $notification) {
- $lastDate = date('d/m/Y H:i', convert_sql_date($notification['lastedit_date']));
- $type = $notification['lastedit_type'];
- $label = get_lang('TitleNotification').": ".get_lang($type)." ($lastDate)";
- if (strpos($notification['link'], '?') === false) {
- $notification['link'] = $notification['link'].'?notification=1';
- } else {
- $notification['link'] = $notification['link'].'¬ification=1';
- }
- $return .= Display::url(
- Display::return_icon($notification['image'], $label),
- api_get_path(WEB_CODE_PATH).
- $notification['link'].'&cidReq='.$course_code.
- '&ref='.$notification['ref'].
- '&gidReq='.$notification['to_group_id'].
- '&id_session='.$sessionId
- ).' ';
- }
- return $return;
- }
- /**
- * Get the session box details as an array
- * @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 get_session_title_box($session_id)
- {
- global $nosession;
- if (!$nosession) {
- global $now, $date_start, $date_end;
- }
- $output = array();
- if (!$nosession) {
- $main_user_table = Database :: get_main_table(TABLE_MAIN_USER);
- $tbl_session = Database :: get_main_table(TABLE_MAIN_SESSION);
- $active = false;
- // Request for the name of the general coach
- $sql ='SELECT tu.lastname, tu.firstname, ts.*
- FROM '.$tbl_session.' ts
- LEFT JOIN '.$main_user_table .' tu
- ON ts.id_coach = tu.user_id
- WHERE ts.id = '.intval($session_id);
- $rs = Database::query($sql);
- $session_info = Database::store_result($rs, 'ASSOC');
- $session_info = $session_info[0];
- $session = array();
- $session['title'] = $session_info['name'];
- $session['coach'] = '';
- $session['dates'] = '';
- if (
- (
- $session_info['access_end_date'] == '0000-00-00' &&
- $session_info['access_start_date'] == '0000-00-00'
- ) ||
- (
- empty($session_info['access_end_date']) && empty($session_info['access_start_date'])
- )
- ) {
- if (api_get_setting('show_session_coach') === 'true') {
- $session['coach'] = get_lang('GeneralCoach').': '.api_get_person_name($session_info['firstname'], $session_info['lastname']);
- }
- if (isset($session_info['duration']) && !empty($session_info['duration'])) {
- $userDurationData = SessionManager::getUserSession(
- api_get_user_id(),
- $session_id
- );
- $userDuration = 0;
- if (isset($userDurationData['duration'])) {
- $userDuration = intval($userDurationData['duration']);
- }
- $totalDuration = $session_info['duration'] + $userDuration;
- $daysLeft = SessionManager::getDayLeftInSession(
- $session_id,
- api_get_user_id(),
- $totalDuration
- );
- $session['duration'] = sprintf(get_lang('SessionDurationXDaysLeft'), $daysLeft);
- }
- $active = true;
- } else {
- $start = $stop = false;
- $start_buffer = $stop_buffer = '';
- if ($session_info['access_start_date'] == '0000-00-00' || empty($session_info['access_start_date'])) {
- $session_info['access_start_date'] = '';
- } else {
- $start = true;
- $start_buffer = $session_info['access_start_date'];
- $session_info['access_start_date'] = $session_info['access_start_date'];
- }
- if ($session_info['access_end_date'] == '0000-00-00' || empty($session_info['access_end_date'])) {
- $session_info['access_end_date'] = '';
- } else {
- $stop = true;
- $stop_buffer = $session_info['access_end_date'];
- $session_info['access_end_date'] = $session_info['access_end_date'];
- }
- if ($start && $stop) {
- $session['dates'] = Display::tag(
- 'em',
- sprintf(
- get_lang('FromDateXToDateY'),
- api_format_date($start_buffer),
- api_format_date($stop_buffer)
- )
- );
- } else {
- $start_buffer = $stop_buffer = null;
- if (!empty($session_info['access_start_date'])) {
- $start_buffer = sprintf(
- get_lang('FromDateX'),
- api_format_date($session_info['access_start_date'])
- );
- }
- if (!empty($session_info['access_end_date'])) {
- $stop_buffer = sprintf(
- get_lang('UntilDateX'),
- api_format_date($session_info['access_end_date'])
- );
- }
- $session['dates'] = Display::tag(
- 'em',
- "$start_buffer $stop_buffer"
- );
- }
- if ( api_get_setting('show_session_coach') === 'true' ) {
- $session['coach'] = get_lang('GeneralCoach') . ': ' . api_get_person_name(
- $session_info['firstname'],
- $session_info['lastname']
- );
- }
- $active = ($date_start <= $now && $date_end >= $now);
- }
- $session['active'] = $active;
- $session['session_category_id'] = $session_info['session_category_id'];
- $session['description'] = $session_info['description'];
- $session['show_description'] = $session_info['show_description'];
- $entityManager = Database::getManager();
- $fieldValuesRepo = $entityManager->getRepository('ChamiloCoreBundle:ExtraFieldValues');
- $extraFieldValues = $fieldValuesRepo->getVisibleValues(
- Chamilo\CoreBundle\Entity\ExtraField::SESSION_FIELD_TYPE,
- $session_id
- );
- $session['extra_fields'] = [];
- foreach ($extraFieldValues as $value) {
- $session['extra_fields'][] = [
- 'field' => [
- 'variable' => $value->getField()->getVariable(),
- 'display_text' => $value->getField()->getDisplayText()
- ],
- 'value' => $value->getValue()
- ];
- }
- $output = $session;
- }
- return $output;
- }
- /**
- * 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 string point info array see function CourseManager::get_course_ranking()
- * @param bool add a div wrapper
- * @todo use templates
- **/
- public static function return_rating_system($id, $url, $point_info = array(), $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('XStarsOutOf5'), $point_info['point_average_star']);
- $html = '<ul id="'.$id.'" class="star-rating">
- <li class="current-rating" style="width:'.$percentage.'px;"></li>
- <li><a href="javascript:void(0);" data-link="'.$url.'&star=1" title="'.$star_label.'" class="one-star">1</a></li>
- <li><a href="javascript:void(0);" data-link="'.$url.'&star=2" title="'.$star_label.'" class="two-stars">2</a></li>
- <li><a href="javascript:void(0);" data-link="'.$url.'&star=3" title="'.$star_label.'" class="three-stars">3</a></li>
- <li><a href="javascript:void(0);" data-link="'.$url.'&star=4" title="'.$star_label.'" class="four-stars">4</a></li>
- <li><a href="javascript:void(0);" data-link="'.$url.'&star=5" title="'.$star_label.'" class="five-stars">5</a></li>
- </ul>';
- $labels = array();
- $labels[]= $number_of_users_who_voted == 1 ? $number_of_users_who_voted.' '.get_lang('Vote') : $number_of_users_who_voted.' '.get_lang('Votes');
- $labels[]= $accesses == 1 ? $accesses.' '.get_lang('Visit') : $accesses.' '.get_lang('Visits');
- if (!empty($number_of_users_who_voted)) {
- $labels[]= get_lang('Average').' '.$point_info['point_average_star'].'/5';
- }
- $labels[]= $point_info['user_vote'] ? get_lang('YourVote').' ['.$point_info['user_vote'].']' : get_lang('YourVote'). ' [?] ';
- if (!$add_div_wrapper && api_is_anonymous()) {
- $labels[]= Display::tag('span', get_lang('LoginToVote'), array('class' => 'error'));
- }
- $html .= Display::div(implode(' | ', $labels) , array('id' => 'vote_label_'.$id, 'class' => 'vote_label_info'));
- $html .= ' '.Display::span(' ', array('id' => 'vote_label2_'.$id));
- if ($add_div_wrapper) {
- $html = Display::div($html, array('id' => 'rating_wrapper_'.$id));
- }
- return $html;
- }
- public static function return_default_table_class()
- {
- return 'table table-bordered';
- }
- /**
- * @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"><'.$size.'>'.$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_and_translate($title, $second_title = null)
- {
- $title = get_lang($title);
- return self::page_subheader($title, $second_title);
- }
- public static function page_subheader($title, $second_title = null, $size = 'h3')
- {
- if (!empty($second_title)) {
- $second_title = Security::remove_XSS($second_title);
- $title .= "<small> $second_title<small>";
- }
- return '<'.$size.'>'.Security::remove_XSS($title).'</'.$size.'>';
- }
- 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');
- }
- /**
- * @param array $list
- * @return null|string
- */
- public static function description($list)
- {
- $html = null;
- 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 $percentage
- * @param bool $show_percentage
- * @param null $extra_info
- * @return string
- */
- public static function bar_progress($percentage, $show_percentage = true, $extra_info = null)
- {
- $percentage = intval($percentage);
- $div = '<div class="progress">
- <div
- class="progress-bar progress-bar-striped"
- 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>';
- return $div;
- }
- /**
- * @param string $count
- * @param string $type
- * @return null|string
- */
- public static function badge($count, $type ="warning")
- {
- $class = '';
- switch ($type) {
- case 'success':
- $class = 'badge-success';
- break;
- case 'warning':
- $class = 'badge-warning';
- break;
- case 'important':
- $class = 'badge-important';
- break;
- case 'info':
- $class = 'badge-info';
- break;
- case 'inverse':
- $class = 'badge-inverse';
- break;
- }
- if (!empty($count)) {
- return ' <span class="badge '.$class.'">'.$count.'</span>';
- }
- return null;
- }
- /**
- * @param array $badge_list
- * @return string
- */
- public static function badge_group($badge_list)
- {
- $html = '<div class="badge-group">';
- foreach ($badge_list as $badge) {
- $html .= $badge;
- }
- $html .= '</div>';
- return $html;
- }
- /**
- * @param string $content
- * @param string $type
- * @return string
- */
- public static function label($content, $type = 'default')
- {
- switch ($type) {
- case 'success':
- $class = 'label-success';
- break;
- case 'warning':
- $class = 'label-warning';
- break;
- case 'important':
- //no break
- case 'danger':
- $class = 'label-danger';
- break;
- case 'info':
- $class = 'label-info';
- break;
- case 'primary':
- $class = 'label-primary';
- break;
- default:
- $class = 'label-default';
- break;
- }
- $html = '';
- if (!empty($content)) {
- $html = '<span class="label '.$class.'">';
- $html .= $content;
- $html .='</span>';
- }
- return $html;
- }
- /**
- * @param array $items
- * @return null|string
- */
- public static function actions($items, $class = 'new_actions')
- {
- $html = null;
- if (!empty($items)) {
- $html = '<div class="'.$class.'"><ul class="nav nav-pills">';
- foreach ($items as $value) {
- $class = null;
- if (isset($value['active']) && $value['active']) {
- $class = 'class ="active"';
- }
- if (basename($_SERVER['REQUEST_URI']) == basename($value['url']) ) {
- $class = 'class ="active"';
- }
- $html .= "<li $class >";
- $attributes = isset($value['url_attributes']) ? $value['url_attributes'] : array();
- $html .= self::url($value['content'], $value['url'], $attributes);
- $html .= '</li>';
- }
- $html .= '</ul></div>';
- }
- return $html;
- }
- /**
- * 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, array('class' => 'boot-tooltip', 'title' => strip_tags($tip)));
- }
- /**
- * @param array $items
- * @param string $type
- * @param null $id
- * @return null|string
- */
- public static function generate_accordion($items, $type = 'jquery', $id = null)
- {
- $html = null;
- if (!empty($items)) {
- if (empty($id)) {
- $id = api_get_unique_id();
- }
- if ($type == 'jquery') {
- $html = '<div class="accordion_jquery" id="'.$id.'">'; //using jquery
- } else {
- $html = '<div class="accordion" id="'.$id.'">'; //using bootstrap
- }
- $count = 1;
- foreach ($items as $item) {
- $html .= '<div class="accordion-my-group">';
- $html .= '<div class="accordion-heading">
- <a class="accordion-toggle" data-toggle="collapse" data-parent="#'.$id.'" href="#collapse'.$count.'">
- '.$item['title'].'
- </a>
- </div>';
- $html .= '<div id="collapse'.$count.'" class="accordion-body">';
- $html .= '<div class="accordion-my-inner">
- '.$item['content'].'
- </div>
- </div>';
- }
- $html .= '</div>';
- }
- return $html;
- }
- /**
- * @todo use twig
- */
- public static function group_button($title, $elements)
- {
- $html = '<div class="btn-group">
- <button class="btn btn-default dropdown-toggle" data-toggle="dropdown">
- '.$title.'
- <span class="caret"></span></button>
- <ul class="dropdown-menu">';
- foreach ($elements as $item) {
- $html .= Display::tag('li', Display::url($item['title'], $item['href']));
- }
- $html .= '</ul>
- </div>';
- return $html;
- }
- /**
- * @param string $file
- * @param array $params
- * @return null|string
- */
- public static function getMediaPlayer($file, $params = array())
- {
- $fileInfo = pathinfo($file);
- switch ($fileInfo['extension']) {
- case 'wav':
- if (isset($params['url'])) {
- $url = DocumentManager::generateAudioTempFile(basename($file), $file);
- return DocumentManager::readNanogongFile($url);
- }
- break;
- case 'mp3':
- case 'webm':
- $autoplay = null;
- if (isset($params['autoplay']) && $params['autoplay'] == 'true') {
- $autoplay = 'autoplay';
- }
- $width = isset($params['width']) ? 'width="'.$params['width'].'"' : null;
- $id = isset($params['id']) ? $params['id'] : $fileInfo['basename'];
- $class = isset($params['class']) ? ' class="'.$params['class'].'"' : null;
- $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;
- }
- return null;
- }
- /**
- * Adds a message in the queue
- * @param string $message
- */
- public static function addFlash($message)
- {
- $messages = Session::read('flash_messages');
- if (empty($messages)) {
- $messages[] = $message;
- } else {
- array_push($messages, $message);
- }
- Session::write('flash_messages', $messages);
- }
- /**
- * @return string
- */
- public static function getFlashToString()
- {
- $messages = Session::read('flash_messages');
- $messageToString = '';
- if (!empty($messages)) {
- foreach ($messages as $message) {
- $messageToString .= $message;
- }
- }
- return $messageToString;
- }
- /**
- * Shows the message from the session
- */
- public static function showFlash()
- {
- echo self::getFlashToString();
- }
- /**
- * Destroys the message session
- */
- public static function cleanFlashMessages()
- {
- Session::erase('flash_messages');
- }
- /**
- * Get the profile edition link for a user
- * @param int $userId The user id
- * @param boolean $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);
- }
- if (api_get_setting('sso_authentication') === 'true') {
- $subSSOClass = api_get_setting('sso_authentication_subclass');
- $objSSO = null;
- if (!empty($subSSOClass)) {
- require_once api_get_path(SYS_CODE_PATH)."auth/sso/sso.$subSSOClass.class.php";
- $subSSOClass = 'sso'.$subSSOClass;
- $objSSO = new $subSSOClass();
- } else {
- $objSSO = new sso();
- }
- $editProfileUrl = $objSSO->generateProfileEditingURL(
- $userId,
- $asAdmin
- );
- }
- return $editProfileUrl;
- }
- /**
- * Get the vCard for a user
- * @param int $userId The user id
- * @return string *.*vcf file
- */
- public static function getVCardUserLink($userId)
- {
- $vCardUrl = api_get_path(WEB_PATH).'main/social/vcard_export.php?userId='.intval($userId);;
- return $vCardUrl;
- }
- /**
- * @param string $content
- * @param string $title
- * @param string $footer
- * @param string $style primary|success|info|warning|danger
- * @param string $extra
- *
- * @return string
- */
- public static function panel($content, $title = '', $footer = '', $style = '', $extra = '')
- {
- $title = !empty($title) ? '<div class="panel-heading"><h3 class="panel-title">'.$title.'</h3>'.$extra.'</div>' : '';
- $footer = !empty($footer) ? '<div class="panel-footer ">'.$footer.'</div>' : '';
- $styles = ['primary','success','info','warning','danger'];
- $style = !in_array($style, $styles) ? 'default' : $style;
- return '
- <div class="panel panel-'.$style.'">
- '.$title.'
- '.self::contentPanel($content).'
- '.$footer.'
- </div>'
- ;
- }
- /**
- * @param string $content
- * @return string
- */
- public static function contentPanel($content)
- {
- return '<div class="panel-body">
- '.$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
- * @return string The button HTML
- */
- public static function toolbarButton(
- $text,
- $url,
- $icon = 'check',
- $type = 'default',
- array $attributes = [],
- $includeText = true
- ) {
- $buttonClass = "btn btn-$type";
- $icon = self::tag('i', null, ['class' => "fa fa-$icon fa-fw", 'aria-hidden' => 'true']);
- $attributes['class'] = isset($attributes['class']) ? "$buttonClass {$attributes['class']}" : $buttonClass;
- if (!$includeText) {
- $text = '<span class="sr-only">' . $text . '</span>';
- }
- return self::url("$icon $text", $url, $attributes);
- }
- /**
- * @param int $id
- * @param array $content
- * @param int $col
- * @param bool|true $right
- * @return string
- */
- public static function toolbarAction($id, $content = array(), $col = 2, $right = true)
- {
- $columns = 12/$col;
- $html = '';
- $html .= '<div id="' . $id . '" class="actions">';
- $html .= '<div class="row">';
- if ($col > 4) {
- $html = '<div class="alert alert-warning" role="alert">Action toolbar design does not work when exceeding four columns - check Display::toolbarAction()</div>';
- } else {
- for ( $i = 0; $i < $col; $i++ ) {
- $html .= '<div class="col-md-' . $columns . '">';
- if ( $col == 2 && $i == 1 ) {
- if ($right === true) {
- $html .= '<div class="pull-right">';
- $html .= (isset($content[$i])?$content[$i]:'');
- $html .= '</div>';
- } else {
- $html .= $content[$i];
- }
- } else {
- $html .= $content[$i];
- }
- $html .= '</div>';
- }
- }
- $html .= '</div>';
- $html .= '</div>';
- return $html;
- }
- /**
- * Get a HTML code for a icon by Font Awesome
- * @param string $name The icon name
- * @param boolean $fixWidth Optional. Whether add the fw class
- * @param int|string $size Optional. The size for the icon.
- * @param string $additionalClass Optional. Additional class
- *
- * @return string
- */
- public static function returnFontAwesomeIcon(
- $name,
- $fixWidth = false,
- $size = null,
- $additionalClass = null
- ) {
- $className = "fa fa-$name";
- if ($fixWidth) {
- $className .= ' fa-fw';
- }
- switch ($size) {
- case 'lg':
- $className .= ' fa-lg';
- break;
- case 2:
- //no break
- case 3:
- //no break
- case 4:
- //no break
- case 5:
- $className .= " fa-{$size}x";
- break;
- }
- if (!empty($additionalClass)) {
- $className .= " $additionalClass";
- }
- $icon = self::tag('em', null, ['class' => $className]);
- return "$icon ";
- }
- /**
- * @param string $title
- * @param string $content
- * @param null $id
- * @param array $params
- * @param null $idAccordion
- * @param null $idCollapse
- * @param bool|true $open
- * @param bool|false $arrow
- * @return null|string
- */
- public static function panelCollapse(
- $title,
- $content,
- $id = null,
- $params = array(),
- $idAccordion = null,
- $idCollapse = null,
- $open = true,
- $arrow = false
- ) {
- if (!empty($idAccordion)) {
- $headerClass = '';
- $headerClass .= $arrow ? 'arrow ' : '';
- $headerClass .= $open ? '' : 'collapsed';
- $contentClass = 'panel-collapse collapse ';
- $contentClass .= $open ? 'in' : '';
- $ariaExpanded = $open ? 'true' : 'false';
- $html = <<<HTML
- <div class="panel-group" id="$idAccordion" role="tablist" aria-multiselectable="true">
- <div class="panel panel-default" id="$id">
- <div class="panel-heading" role="tab">
- <h4 class="panel-title">
- <a class="$headerClass" role="button" data-toggle="collapse" data-parent="#$idAccordion" href="#$idCollapse" aria-expanded="$ariaExpanded" aria-controls="$idCollapse">$title</a>
- </h4>
- </div>
- <div id="$idCollapse" class="$contentClass" role="tabpanel">
- <div class="panel-body">$content</div>
- </div>
- </div>
- </div>
- HTML;
- } else {
- if (!empty($id)) {
- $params['id'] = $id;
- }
- $params['class'] = 'panel panel-default';
- $html = null;
- if (!empty($title)) {
- $html .= '<div class="panel-heading">'.$title.'</div>' . PHP_EOL;
- }
- $html.= '<div class="panel-body">'.$content.'</div>' . PHP_EOL;
- $html = Display::div($html, $params);
- }
- return $html;
- }
- }
|