From 720cb448cec846ac8d42624fe49bad1e35c9999f Mon Sep 17 00:00:00 2001 From: Nate Date: Mon, 9 Dec 2019 11:34:28 -0700 Subject: [PATCH] Time Conditions: List view updates. --- .../resources/classes/time_conditions.php | 348 ++++++++++++++++++ app/time_conditions/time_conditions.php | 329 ++++++++--------- 2 files changed, 503 insertions(+), 174 deletions(-) create mode 100644 app/time_conditions/resources/classes/time_conditions.php diff --git a/app/time_conditions/resources/classes/time_conditions.php b/app/time_conditions/resources/classes/time_conditions.php new file mode 100644 index 0000000000..bbd441fa0d --- /dev/null +++ b/app/time_conditions/resources/classes/time_conditions.php @@ -0,0 +1,348 @@ + + Copyright (C) 2010-2019 + All Rights Reserved. + + Contributor(s): + Mark J Crane +*/ + +//define the time conditions class + if (!class_exists('time_conditions')) { + class time_conditions { + + /** + * declare public/private properties + */ + private $app_name; + private $app_uuid; + private $permission_prefix; + private $list_page; + private $table; + private $uuid_prefix; + private $toggle_field; + private $toggle_values; + + //class constructor + public function __construct() { + //set the default value + $this->dialplan_global = false; + + //assign property defaults + $this->app_name = 'time_conditions'; + $this->app_uuid = '4b821450-926b-175a-af93-a03c441818b1'; + $this->permission_prefix = 'time_condition_'; + $this->list_page = 'time_conditions.php'; + $this->table = 'dialplans'; + $this->uuid_prefix = 'dialplan_'; + $this->toggle_field = 'dialplan_enabled'; + $this->toggle_values = ['true','false']; + } + + /** + * delete records + */ + public function delete($records) { + if (permission_exists($this->permission_prefix.'delete')) { + + //add multi-lingual support + $language = new text; + $text = $language->get(); + + //validate the token + $token = new token; + if (!$token->validate($_SERVER['PHP_SELF'])) { + message::add($text['message-invalid_token'],'negative'); + header('Location: '.$this->list_page); + exit; + } + + //delete multiple records + if (is_array($records) && @sizeof($records) != 0) { + + //build the delete array + foreach ($records as $x => $record) { + if ($record['checked'] == 'true' && is_uuid($record['uuid'])) { + + //build delete array + $array[$this->table][$x][$this->uuid_prefix.'uuid'] = $record['uuid']; + $array['dialplan_details'][$x]['dialplan_uuid'] = $record['uuid']; + + //get the dialplan context + $sql = "select dialplan_context from v_dialplans "; + $sql .= "where dialplan_uuid = :dialplan_uuid "; + $parameters['dialplan_uuid'] = $record['uuid']; + $database = new database; + $dialplan_contexts[] = $database->select($sql, $parameters, 'column'); + unset($sql, $parameters); + + } + } + + //delete the checked rows + if (is_array($array) && @sizeof($array) != 0) { + + //grant temporary permissions + $p = new permissions; + $p->add('dialplan_delete', 'temp'); + $p->add('dialplan_detail_delete', 'temp'); + + //execute delete + $database = new database; + $database->app_name = $this->app_name; + $database->app_uuid = $this->app_uuid; + $database->delete($array); + + //revoke temporary permissions + $p->delete('dialplan_delete', 'temp'); + $p->delete('dialplan_detail_delete', 'temp'); + + //synchronize the xml config + save_dialplan_xml(); + + //clear the cache + if (is_array($dialplan_contexts) && @sizeof($dialplan_contexts) != 0) { + $dialplan_contexts = array_unique($dialplan_contexts, SORT_STRING); + $cache = new cache; + foreach ($dialplan_contexts as $dialplan_context) { + $cache->delete("dialplan:".$dialplan_context); + } + } + + //set message + message::add($text['message-delete'].': '.@sizeof($array[$this->table])); + + } + unset($records, $array); + + } + } + } + + /** + * toggle records + */ + public function toggle($records) { + if (permission_exists($this->permission_prefix.'edit')) { + + //add multi-lingual support + $language = new text; + $text = $language->get(); + + //validate the token + $token = new token; + if (!$token->validate($_SERVER['PHP_SELF'])) { + message::add($text['message-invalid_token'],'negative'); + header('Location: '.$this->list_page); + exit; + } + + //toggle the checked records + if (is_array($records) && @sizeof($records) != 0) { + + //get current toggle state + foreach($records as $x => $record) { + if ($record['checked'] == 'true' && is_uuid($record['uuid'])) { + $uuids[] = "'".$record['uuid']."'"; + } + } + if (is_array($uuids) && @sizeof($uuids) != 0) { + $sql = "select ".$this->uuid_prefix."uuid as uuid, ".$this->toggle_field." as toggle, dialplan_context from v_".$this->table." "; + $sql .= "where (domain_uuid = :domain_uuid or domain_uuid is null) "; + $sql .= "and ".$this->uuid_prefix."uuid in (".implode(', ', $uuids).") "; + $parameters['domain_uuid'] = $_SESSION['domain_uuid']; + $database = new database; + $rows = $database->select($sql, $parameters, 'all'); + if (is_array($rows) && @sizeof($rows) != 0) { + foreach ($rows as $row) { + $states[$row['uuid']] = $row['toggle']; + $dialplan_contexts[] = $row['dialplan_context']; + } + } + unset($sql, $parameters, $rows, $row); + } + + //build update array + $x = 0; + foreach($states as $uuid => $state) { + $array[$this->table][$x][$this->uuid_prefix.'uuid'] = $uuid; + $array[$this->table][$x][$this->toggle_field] = $state == $this->toggle_values[0] ? $this->toggle_values[1] : $this->toggle_values[0]; + $x++; + } + + //save the changes + if (is_array($array) && @sizeof($array) != 0) { + + //grant temporary permissions + $p = new permissions; + $p->add('dialplan_edit', 'temp'); + + //save the array + $database = new database; + $database->app_name = $this->app_name; + $database->app_uuid = $this->app_uuid; + $database->save($array); + unset($array); + + //revoke temporary permissions + $p->delete('dialplan_edit', 'temp'); + + //synchronize the xml config + save_dialplan_xml(); + + //clear the cache + if (is_array($dialplan_contexts) && @sizeof($dialplan_contexts) != 0) { + $dialplan_contexts = array_unique($dialplan_contexts, SORT_STRING); + $cache = new cache; + foreach ($dialplan_contexts as $dialplan_context) { + $cache->delete("dialplan:".$dialplan_context); + } + } + + //set message + message::add($text['message-toggle']); + } + unset($records, $states); + } + + } + } + + /** + * copy records + */ + public function copy($records) { + if (permission_exists($this->permission_prefix.'add')) { + + //add multi-lingual support + $language = new text; + $text = $language->get(); + + //validate the token + $token = new token; + if (!$token->validate($_SERVER['PHP_SELF'])) { + message::add($text['message-invalid_token'],'negative'); + header('Location: '.$this->list_page); + exit; + } + + //copy the checked records + if (is_array($records) && @sizeof($records) != 0) { + + //get checked records + foreach($records as $x => $record) { + if ($record['checked'] == 'true' && is_uuid($record['uuid'])) { + $uuids[] = "'".$record['uuid']."'"; + } + } + + //create insert array from existing data + if (is_array($uuids) && @sizeof($uuids) != 0) { + + //primary table + $sql = "select * from v_".$this->table." "; + $sql .= "where ".$this->uuid_prefix."uuid in (".implode(', ', $uuids).") "; + $database = new database; + $rows = $database->select($sql, $parameters, 'all'); + if (is_array($rows) && @sizeof($rows) != 0) { + $y = 0; + foreach ($rows as $x => $row) { + $primary_uuid = uuid(); + + //copy data + $array[$this->table][$x] = $row; + + //overwrite + $array[$this->table][$x][$this->uuid_prefix.'uuid'] = $primary_uuid; + $array[$this->table][$x]['dialplan_description'] = trim($row['dialplan_description'].' ('.$text['label-copy'].')'); + + //details sub table + $sql_2 = "select * from v_dialplan_details where dialplan_uuid = :dialplan_uuid"; + $parameters_2['dialplan_uuid'] = $row['dialplan_uuid']; + $database = new database; + $rows_2 = $database->select($sql_2, $parameters_2, 'all'); + if (is_array($rows_2) && @sizeof($rows_2) != 0) { + foreach ($rows_2 as $row_2) { + + //copy data + $array['dialplan_details'][$y] = $row_2; + + //overwrite + $array['dialplan_details'][$y]['dialplan_detail_uuid'] = uuid(); + $array['dialplan_details'][$y]['dialplan_uuid'] = $primary_uuid; + + //increment + $y++; + + } + } + unset($sql_2, $parameters_2, $rows_2, $row_2); + + //get dialplan contexts + $dialplan_contexts[] = $row['dialplan_context']; + } + } + unset($sql, $parameters, $rows, $row); + } + + //save the changes and set the message + if (is_array($array) && @sizeof($array) != 0) { + + //grant temporary permissions + $p = new permissions; + $p->add('dialplan_detail_add', 'temp'); + + //save the array + $database = new database; + $database->app_name = $this->app_name; + $database->app_uuid = $this->app_uuid; + $database->save($array); + unset($array); + + //revoke temporary permissions + $p->delete('dialplan_detail_add', 'temp'); + + //synchronize the xml config + save_dialplan_xml(); + + //clear the cache + if (is_array($dialplan_contexts) && @sizeof($dialplan_contexts) != 0) { + $dialplan_contexts = array_unique($dialplan_contexts, SORT_STRING); + $cache = new cache; + foreach ($dialplan_contexts as $dialplan_context) { + $cache->delete("dialplan:".$dialplan_context); + } + } + + //set message + message::add($text['message-copy']); + + } + unset($records); + } + + } + } //method + + + } //class + } + +?> \ No newline at end of file diff --git a/app/time_conditions/time_conditions.php b/app/time_conditions/time_conditions.php index ada4477da3..ce4ef689cd 100644 --- a/app/time_conditions/time_conditions.php +++ b/app/time_conditions/time_conditions.php @@ -25,9 +25,10 @@ */ //includes - include "root.php"; + require_once "root.php"; require_once "resources/require.php"; require_once "resources/check_auth.php"; + require_once "resources/paging.php"; //check permissions if (permission_exists('time_condition_view')) { @@ -42,223 +43,203 @@ $language = new text; $text = $language->get(); -//handle enable toggle - $dialplan_uuid = $_REQUEST['id']; - $dialplan_enabled = $_REQUEST['enabled']; - if (is_uuid($dialplan_uuid) && $dialplan_enabled != '') { - //build array - $array['dialplans'][0]['dialplan_uuid'] = $dialplan_uuid; - $array['dialplans'][0]['dialplan_enabled'] = $dialplan_enabled; - $array['dialplans'][0]['app_uuid'] = '4b821450-926b-175a-af93-a03c441818b1'; - //grant temporary permissions - $p = new permissions; - $p->add('dialplan_edit', 'temp'); - //execute update - $database = new database; - $database->app_name = 'time_conditions'; - $database->app_uuid = '4b821450-926b-175a-af93-a03c441818b1'; - $database->save($array); - unset($array); - //revoke temporary permissions - $p->delete('dialplan_edit', 'temp'); - //set message - message::add($text['message-update']); - //redirect - header('Location: time_conditions.php'); - exit; +//get the http post data + if (is_array($_POST['time_conditions'])) { + $action = $_POST['action']; + $search = $_POST['search']; + $time_conditions = $_POST['time_conditions']; } -//set the http values as php variables - $search = $_REQUEST["search"]; - $order_by = $_REQUEST["order_by"]; - $order = $_REQUEST["order"]; - $dialplan_context = $_REQUEST["dialplan_context"]; - $app_uuid = $_REQUEST["app_uuid"]; +//process the http post data by action + if ($action != '' && is_array($time_conditions) && @sizeof($time_conditions) != 0) { + switch ($action) { + case 'copy': + if (permission_exists('time_condition_add')) { + $obj = new time_conditions; + $obj->copy($time_conditions); + } + break; + case 'toggle': + if (permission_exists('time_condition_edit')) { + $obj = new time_conditions; + $obj->toggle($time_conditions); + } + break; + case 'delete': + if (permission_exists('time_condition_delete')) { + $obj = new time_conditions; + $obj->delete($time_conditions); + } + break; + } -//includes - require_once "resources/header.php"; - require_once "resources/paging.php"; - $document['title'] = $text['title-time_conditions']; + header('Location: time_conditions.php'.($search != '' ? '?search='.urlencode($search) : null)); + exit; + } -//set the alternating styles - $c = 0; - $row_style["0"] = "row_style0"; - $row_style["1"] = "row_style1"; +//get order and order by + $order_by = $_GET["order_by"]; + $order = $_GET["order"]; + +//add the search string + $search = strtolower($_GET["search"]); + if (strlen($search) > 0) { + $sql_search = "and ("; + $sql_search .= " lower(dialplan_context) like :search "; + $sql_search .= " or lower(dialplan_name) like :search "; + $sql_search .= " or lower(dialplan_number) like :search "; + $sql_search .= " or lower(dialplan_continue) like :search "; + if (is_numeric($search)) { + $sql_search .= " or dialplan_order = :search "; + } + $sql_search .= " or lower(dialplan_enabled) like :search "; + $sql_search .= " or lower(dialplan_description) like :search "; + $sql_search .= ") "; + $parameters['search'] = '%'.$search.'%'; + } //get the number of rows in the dialplan - $sql = "select count(*) from v_dialplans "; + $sql = "select count(dialplan_uuid) from v_dialplans "; $sql .= "where (domain_uuid = :domain_uuid or domain_uuid is null) "; $sql .= "and app_uuid = '4b821450-926b-175a-af93-a03c441818b1' "; - if (strlen($search) > 0) { - $sql .= "and ("; - $sql .= " lower(dialplan_context) like :search "; - $sql .= " or lower(dialplan_name) like :search "; - $sql .= " or lower(dialplan_number) like :search "; - $sql .= " or lower(dialplan_continue) like :search "; - if (is_numeric($search)) { - $sql .= " or dialplan_order = :search "; - } - $sql .= " or lower(dialplan_enabled) like :search "; - $sql .= " or lower(dialplan_description) like :search "; - $sql .= ") "; - $parameters['search'] = '%'.strtolower($search).'%'; - } + $sql .= $sql_search; $parameters['domain_uuid'] = $domain_uuid; $database = new database; $num_rows = $database->select($sql, $parameters, 'column'); //prepare to page data $rows_per_page = ($_SESSION['domain']['paging']['numeric'] != '') ? $_SESSION['domain']['paging']['numeric'] : 50; - $param = ""; - if (strlen($app_uuid) > 0) { $param = "&app_uuid=".$app_uuid; } - $page = $_GET['page']; - if (strlen($page) == 0) { $page = 0; $_GET['page'] = 0; } - list($paging_controls, $rows_per_page, $var_3) = paging($num_rows, $param, $rows_per_page); + $param = $search ? "&search=".$search : null; + $page = is_numeric($_GET['page']) ? $_GET['page'] : 0; + list($paging_controls, $rows_per_page) = paging($num_rows, $param, $rows_per_page); + list($paging_controls_mini, $rows_per_page) = paging($num_rows, $param, $rows_per_page, true); $offset = $rows_per_page * $page; //get the data - $sql = str_replace('count(*)', '*', $sql); + $sql = str_replace('count(dialplan_uuid)', '*', $sql); $sql .= $order_by != '' ? order_by($order_by, $order) : " order by dialplan_order asc, dialplan_name asc "; $sql .= limit_offset($rows_per_page, $offset); $database = new database; $dialplans = $database->select($sql, $parameters, 'all'); unset($sql, $parameters); -//show the content - echo "\n"; - echo "\n"; - echo " \n"; - echo " \n"; - echo "\n"; - echo "\n"; - echo " \n"; - echo "\n"; - echo "
\n"; - echo " \n"; - echo " ".$text['header-time_conditions']."\n"; - echo " \n"; - echo "

\n"; - echo "
\n"; - echo "
\n"; - echo " "; - if (is_uuid($app_uuid)) { - echo " "; - } - if (strlen($order_by) > 0) { - echo " "; - echo " "; - } - echo " "; - echo "
\n"; - echo "
\n"; - echo " \n"; - echo $text['description-time_conditions']; - echo " \n"; - echo "
"; - echo "
"; +//create token + $object = new token; + $token = $object->create($_SERVER['PHP_SELF']); + +//includes + $document['title'] = $text['title-time_conditions']; + require_once "resources/header.php"; //show the content - echo "
\n"; - echo "\n"; - echo "\n"; - echo "\n"; - if (permission_exists('time_condition_delete') && is_array($dialplans)) { - echo ""; - } - echo th_order_by('dialplan_name', $text['label-name'], $order_by, $order, $app_uuid, null, (($search != '') ? "search=".$search : null)); - echo th_order_by('dialplan_number', $text['label-number'], $order_by, $order, $app_uuid, null, (($search != '') ? "search=".$search : null)); - if (permission_exists('time_condition_context')) { - echo th_order_by('dialplan_context', $text['label-context'], $order_by, $order, $app_uuid, null, (($search != '') ? "search=".$search : null)); - } - echo th_order_by('dialplan_order', $text['label-order'], $order_by, $order, $app_uuid, "style='text-align: center;'", (($search != '') ? "search=".$search : null)); - echo th_order_by('dialplan_enabled', $text['label-enabled'], $order_by, $order, $app_uuid, "style='text-align: center;'", (($search != '') ? "search=".$search : null)); - echo th_order_by('dialplan_description', $text['label-description'], $order_by, $order, $app_uuid, null, (($search != '') ? "search=".$search : null)); - echo "
"; + echo "
\n"; + echo "
".$text['header-time_conditions']." (".$num_rows.")
\n"; + echo "
\n"; if (permission_exists('time_condition_add')) { - echo "$v_link_label_add"; + echo button::create(['type'=>'button','label'=>$text['button-add'],'icon'=>$_SESSION['theme']['button_icon_add'],'link'=>'time_condition_edit.php']); } - if (permission_exists('time_condition_delete') && $result_count > 0) { - echo "".$v_link_label_delete.""; + if (permission_exists('time_condition_add') && $dialplans) { + echo button::create(['type'=>'button','label'=>$text['button-copy'],'icon'=>$_SESSION['theme']['button_icon_copy'],'onclick'=>"if (confirm('".$text['confirm-copy']."')) { list_action_set('copy'); list_form_submit('form_list'); } else { this.blur(); return false; }"]); + } + if (permission_exists('time_condition_edit') && $dialplans) { + echo button::create(['type'=>'button','label'=>$text['button-toggle'],'icon'=>$_SESSION['theme']['button_icon_toggle'],'onclick'=>"if (confirm('".$text['confirm-toggle']."')) { list_action_set('toggle'); list_form_submit('form_list'); } else { this.blur(); return false; }"]); + } + if (permission_exists('time_condition_delete') && $dialplans) { + echo button::create(['type'=>'button','label'=>$text['button-delete'],'icon'=>$_SESSION['theme']['button_icon_delete'],'onclick'=>"if (confirm('".$text['confirm-delete']."')) { list_action_set('delete'); list_form_submit('form_list'); } else { this.blur(); return false; }"]); + } + echo "\n"; + echo ""; + echo button::create(['label'=>$text['button-search'],'icon'=>$_SESSION['theme']['button_icon_search'],'type'=>'submit','id'=>'btn_search','style'=>($search != '' ? 'display: none;' : null)]); + echo button::create(['label'=>$text['button-reset'],'icon'=>$_SESSION['theme']['button_icon_reset'],'type'=>'button','id'=>'btn_reset','link'=>'time_conditions.php','style'=>($search == '' ? 'display: none;' : null)]); + if ($paging_controls_mini != '') { + echo "".$paging_controls_mini."\n"; + } + echo " \n"; + echo "
\n"; + echo "
\n"; + echo "
\n"; + + echo $text['description-time_conditions']."\n"; + echo "

\n"; + + echo "
\n"; + echo "\n"; + echo "\n"; + + echo "\n"; + echo "\n"; + if (permission_exists('time_condition_edit') || permission_exists('time_condition_delete')) { + echo " \n"; + } + echo th_order_by('dialplan_name', $text['label-name'], $order_by, $order, null, null, ($search != '' ? "search=".$search : null)); + echo th_order_by('dialplan_number', $text['label-number'], $order_by, $order, null, null, ($search != '' ? "search=".$search : null)); + if (permission_exists('time_condition_context')) { + echo th_order_by('dialplan_context', $text['label-context'], $order_by, $order, null, null, ($search != '' ? "search=".$search : null)); + } + echo th_order_by('dialplan_order', $text['label-order'], $order_by, $order, null, "class='center'", ($search != '' ? "search=".$search : null)); + echo th_order_by('dialplan_enabled', $text['label-enabled'], $order_by, $order, null, "class='center'", ($search != '' ? "search=".$search : null)); + echo th_order_by('dialplan_description', $text['label-description'], $order_by, $order, null, "class='hide-sm-dn'", ($search != '' ? "search=".$search : null)); + if (permission_exists('time_condition_edit') && $_SESSION['theme']['list_row_edit_button']['boolean'] == 'true') { + echo " \n"; } - echo "\n"; echo "\n"; - if (is_array($dialplans)) { - foreach($dialplans as $row) { - $app_uuid = $row['app_uuid']; - - $tr_link = "href='".PROJECT_PATH."/app/time_conditions/time_condition_edit.php?id=".escape($row['dialplan_uuid']).(($app_uuid != '') ? "&app_uuid=".escape($app_uuid) : null)."'"; - - echo "\n"; - if (permission_exists("time_condition_delete")) { - echo " \n"; - $dialplan_ids[] = 'checkbox_'.escape($row['dialplan_uuid']); - } - echo " \n"; + if (permission_exists('time_condition_add') || permission_exists('time_condition_edit') || permission_exists('time_condition_delete')) { + echo " \n"; + } + echo " \n"; - echo " \n"; + echo " \n"; if (permission_exists('time_condition_context')) { - echo " \n"; + echo " \n"; } - echo " \n"; - echo " \n"; - echo " \n"; - echo " \n"; + if (permission_exists('time_condition_edit')) { + echo " \n"; + echo " \n"; + if (permission_exists('time_condition_edit') && $_SESSION['theme']['list_row_edit_button']['boolean'] == 'true') { + echo " \n"; + } echo "\n"; - $c = $c ? 0 : 1; + $x++; } } - unset($dialplans, $row); + unset($dialplans); - echo "\n"; - echo "\n"; - echo "\n"; - - echo "
\n"; + echo " \n"; + echo "  
"; + if (is_array($dialplans) && @sizeof($dialplans) != 0) { + $x = 0; + foreach ($dialplans as $row) { if (permission_exists('time_condition_edit')) { - echo "".escape($row['dialplan_name']).""; + $list_row_url = "time_condition_edit.php?id=".urlencode($row['dialplan_uuid']); + } + echo "
\n"; + echo " \n"; + echo " \n"; + echo " "; + if (permission_exists('time_condition_edit')) { + echo " ".escape($row['dialplan_name'])."\n"; } else { - echo escape($row['dialplan_name']); + echo " ".escape($row['dialplan_name']); } echo " ".((strlen($row['dialplan_number']) > 0) ? $row['dialplan_number'] : " ")."".($row['dialplan_number'] != '' ? $row['dialplan_number'] : " ")."".escape($row['dialplan_context'])."".escape($row['dialplan_context'])."".escape($row['dialplan_order'])."".((strlen($row['dialplan_description']) > 0) ? $row['dialplan_description'] : " ")."\n"; - if (permission_exists('time_condition_edit')) { - echo "$v_link_label_edit"; - } - if (permission_exists('time_condition_delete')) { - echo "$v_link_label_delete"; + echo " ".escape($row['dialplan_order'])."\n"; + echo $text['label-'.$row['dialplan_enabled']]; } echo " ".$row['dialplan_description']." \n"; + echo button::create(['type'=>'button','title'=>$text['button-edit'],'icon'=>$_SESSION['theme']['button_icon_edit'],'link'=>$list_row_url]); + echo "
\n"; - echo " \n"; - echo " \n"; - echo " \n"; - echo " \n"; - echo " \n"; - echo " \n"; - echo "
 ".$paging_controls.""; - if (permission_exists('time_condition_add')) { - echo "$v_link_label_add"; - } - if (permission_exists('time_condition_delete') && $result_count > 0) { - echo "".$v_link_label_delete.""; - } - echo "
\n"; - echo "
"; - echo "

"; - echo "
"; - - if (is_array($dialplan_ids) && sizeof($dialplan_ids) > 0) { - echo "\n"; - } + echo "
\n"; + echo "
\n"; + echo "
".$paging_controls."
\n"; + echo "\n"; + echo "\n"; //include the footer require_once "resources/footer.php"; -?> +?> \ No newline at end of file