, Ghent University * @param string $tool These are the constants that are used for indicating the tools * @return html code for adding an introduction */ public function display_introduction_section($tool) { $is_allowed_to_edit = api_is_allowed_to_edit(); $moduleId = $tool; if (api_get_setting('enable_tool_introduction') == 'true' || $tool==TOOL_COURSE_HOMEPAGE) { include (api_get_path(INCLUDE_PATH)."introductionSection.inc.php"); } } /* * 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 */ public 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); //default } } /** * Display simple html header of table. */ public function display_table_header() { $bgcolor = "bgcolor='white'"; echo ""; return $bgcolor; } /** * Display html header of table with several options. * * @param $properties, array with elements, all of which have defaults * "width" - the table width, e.g. "100%", default is 85% * "class" - the class to use for the table, e.g. "class=\"data_table\"" * "cellpadding" - the extra border in each cell, e.g. "8",default is 4 * "cellspacing" - the extra space between cells, default = 0 * * @param column_header, array with the header elements. * @author Roan Embrechts * @version 1.01 */ public function display_complex_table_header($properties, $column_header) { $width = $properties["width"]; if (!isset ($width)) $width = "85%"; $class = $properties["class"]; if (!isset ($class)) $class = "class=\"data_table\""; $cellpadding = $properties["cellpadding"]; if (!isset ($cellpadding)) $cellpadding = "4"; $cellspacing = $properties["cellspacing"]; if (!isset ($cellspacing)) $cellspacing = "0"; //... add more properties as you see fit //api_display_debug_info("Dokeos light grey is " . DOKEOSLIGHTGREY); $bgcolor = "bgcolor='".DOKEOSLIGHTGREY."'"; echo "
\n"; echo ""; foreach ($column_header as $table_element) { echo ""; } echo "\n"; echo "\n"; $bgcolor = "bgcolor='".HTML_WHITE."'"; return $bgcolor; } /** * Displays a table row. * * @param $bgcolor the background colour for the table * @param $table_row an array with the row elements * @param $is_alternating true: the row colours alternate, false otherwise */ public function display_table_row($bgcolor, $table_row, $is_alternating = true) { echo ""; foreach ($table_row as $table_element) { echo ""; } echo "\n"; if ($is_alternating) { if ($bgcolor == "bgcolor='".HTML_WHITE."'") { $bgcolor = "bgcolor='".DOKEOSLIGHTGREY."'"; } else { if ($bgcolor == "bgcolor='".DOKEOSLIGHTGREY."'") { $bgcolor = "bgcolor='".HTML_WHITE."'"; } } } return $bgcolor; } /** * Displays a table row. * This public function has more options and is easier to extend than display_table_row() * * @param $properties, array with properties: * ["bgcolor"] - the background colour for the table * ["is_alternating"] - true: the row colours alternate, false otherwise * ["align_row"] - an array with, per cell, left|center|right * @todo add valign property */ public function display_complex_table_row($properties, $table_row) { $bgcolor = $properties["bgcolor"]; $is_alternating = $properties["is_alternating"]; $align_row = $properties["align_row"]; echo ""; $number_cells = count($table_row); for ($i = 0; $i < $number_cells; $i ++) { $cell_data = $table_row[$i]; $cell_align = $align_row[$i]; echo ""; } echo "\n"; if ($is_alternating) { if ($bgcolor == "bgcolor='".HTML_WHITE."'") $bgcolor = "bgcolor='".DOKEOSLIGHTGREY."'"; else if ($bgcolor == "bgcolor='".DOKEOSLIGHTGREY."'") $bgcolor = "bgcolor='".HTML_WHITE."'"; } return $bgcolor; } /** * display html footer of table */ public function display_table_footer() { echo "
".$table_element."
".$table_element."
".$cell_data."
"; } /** * Display 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 * @author bart.mollet@hogent.be */ public function display_sortable_table($header, $content, $sorting_options = array (), $paging_options = array (), $query_vars = null, $form_actions=array()) { 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); } foreach ($header as $index => $header_item) { $table->set_header($index, $header_item[0], $header_item[1], $header_item[2], $header_item[3]); } $table->set_form_actions($form_actions); $table->display(); } /** * Display 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 function display_sortable_config_table($header, $content, $sorting_options = array (), $paging_options = array (), $query_vars = null, $column_show=array(),$column_order=array(),$form_actions=array()) { 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 SortableTableFromArrayConfig($content, $column, $default_items_per_page,'tablename',$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;$iset_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. * * @author Roan Embrechts * @param string $message - include any additional html * tags if you need them * @param bool Filter (true) or not (false) * @return void */ public function display_normal_message($message,$filter=true) { global $charset; if($filter) { //filter message $message = htmlentities($message,ENT_QUOTES,$charset); } if (!headers_sent()) { echo ' '; } echo '
'; //Display :: display_icon('message_normal.gif', get_lang('InfoMessage'), array ('style' => 'float:left; margin-right:10px;')); get_lang('InfoMessage', array ('style' => 'float:left; margin-right:10px;')); 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 * * @author Patrick Cool , Ghent University * @param string $message * @param bool Filter (true) or not (false) * @return void */ public function display_warning_message($message,$filter=true) { global $charset; if($filter){ //filter message $message = htmlentities($message,ENT_QUOTES,$charset); } if (!headers_sent()) { echo ' '; } echo '
'; //Display :: display_icon('message_warning.png', get_lang('WarningMessage'), array ('style' => 'float:left; margin-right:10px;')); get_lang('WarningMessage', array ('style' => 'float:left; margin-right:10px;')); echo $message.'
'; } /** * Displays an confirmation message. Use this if something has been done successfully * * @author Patrick Cool , Ghent University * @param string $message * @param bool Filter (true) or not (false) * @return void */ public function display_confirmation_message($message,$filter=true) { global $charset; if($filter){ //filter message $message = htmlentities($message,ENT_QUOTES,$charset); } if (!headers_sent()) { echo ' '; } echo '
'; //Display :: display_icon('message_confirmation.gif', get_lang('ConfirmationMessage'), array ('style' => 'float:left; margin-right:10px;margin-left:5px;')); get_lang('ConfirmationMessage', array ('style' => 'float:left; margin-right:10px;margin-left:5px;')); echo $message.'
'; } /** * Displays an error message. It is recommended to use this public function if an error occurs * * @author Hugues Peeters * @author Roan Embrechts * @author Patrick Cool , Ghent University * @param string $message - include any additional html * tags if you need them * @param bool Filter (true) or not (false) * @return void */ public function display_error_message($message,$filter=true) { global $charset; if($filter){ //filter message $message = htmlentities($message,ENT_QUOTES,$charset); } if (!headers_sent()) { echo ' '; } echo '
'; //Display :: display_icon('message_error.png', get_lang('ErrorMessage'), array ('style' => 'float:left; margin-right:10px;')); get_lang('ErrorMessage', array ('style' => 'float:left; margin-right:10px;')); echo $message.'
'; } /** * Return an encrypted mailto hyperlink * * @param - $email (string) - e-mail * @param - $text (string) - clickable text * @param - $style_class (string) - optional, class from stylesheet * @return - encrypted mailto hyperlink */ public function encrypted_mailto_link($email, $clickable_text = null, $style_class = '') { global $charset; 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 }).';'; } //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,$charset); } //return encrypted mailto hyperlink return ''.$hclickable_text.''; } /** * Create 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 function get_platform_home_link_html($name = '') { if ($name == '') { $name = api_get_setting('siteName'); } return "$name"; } /** * Display the page header * @param string The name of the page (will be showed in the page title) * @param string Optional help file name */ public function display_header($tool_name, $help = NULL) { $nameTools = $tool_name; global $_plugins,$lp_theme_css,$mycoursetheme,$user_theme,$platform_theme; global $httpHeadXtra, $htmlHeadXtra, $htmlIncHeadXtra, $_course, $_user, $clarolineRepositoryWeb, $text_dir, $plugins, $_user, $rootAdminWeb, $_cid, $interbreadcrumb, $charset, $language_file, $noPHP_SELF; global $menu_navigation; include (api_get_path(INCLUDE_PATH)."header.inc.php"); } /** * Display the page footer */ public function display_footer() { global $dokeos_version; //necessary to have the value accessible in the footer global $_plugins; include (api_get_path(INCLUDE_PATH)."footer.inc.php"); } /** * Print an