, Ghent University
* @param string $tool These are the constants that are used for indicating the tools
* @return html code for adding an introduction
*/
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 function defines a global
*
* @param $full_file_name, the (path) name of the file, without .html
*/
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.
*/
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
*/
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 "
".$table_element."
";
}
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
*/
function display_table_row($bgcolor, $table_row, $is_alternating = true)
{
echo "
";
foreach ($table_row as $table_element)
{
echo "
".$table_element."
";
}
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 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
*/
function display_complex_table_row($properties, $table_row)
{
$bgcolor = $properties["bgcolor"];
$is_alternating = $properties["is_alternating"];
$align_row = $properties["align_row"];
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
*/
function display_table_footer()
{
echo "
";
}
/**
* 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
*/
function display_sortable_table($header, $content, $sorting_options = array (), $paging_options = array (), $query_vars = null)
{
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->display();
}
/**
* Displays a normal message. It is recommended to use this function
* to display any normal information messages.
*
* @author Roan Embrechts
* @param string $message - include any additional html
* tags if you need them
* @return void
*/
function display_normal_message($message)
{
if (!headers_sent())
{
echo '
';
}
echo '
';
}
/**
* 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
* @return void
*/
function display_warning_message($message)
{
if (!headers_sent())
{
echo '
';
}
echo '
';
}
/**
* Displays an confirmation message. Use this if something has been done successfully
*
* @author Patrick Cool , Ghent University
* @param string $message
* @return void
*/
function display_confirmation_message($message)
{
if (!headers_sent())
{
echo '
';
}
echo '
';
}
/**
* Displays an error message. It is recommended to use this 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
* @return void
*/
function display_error_message($message)
{
if (!headers_sent())
{
echo '
';
}
echo '