breadcrum = $str; } /** * Getter for breadcrum * * @return array Breadcrum. */ public function getBreadcrum() { return $this->breadcrum; } /** * Add an element to breadcrum array. * * @param array $breads Elements to add to breadcrum. * * @return void */ protected function addBreadcrum($breads) { if (empty($breads)) { return; } $this->breadcrum = array_merge($this->breadcrum, $breads); } /** * Setter for label * * @param string $str Label. * * @return void */ public function setLabel(string $str) { $this->label = $str; } /** * Getter for label * * @return array Breadcrum. */ public function getLabel() { return $this->label; } /** * Return units associated to target interval (in seconds). * * @param integer $interval Target interval. * * @return integer Unit. */ public function getTimeUnit($interval) { $units = [ 1, 60, 3600, 86400, 604800, 2592000, 31104000, ]; $size = count($units); for ($i = 0; $i < $size; $i++) { if ($interval < $units[$i]) { if (($i - 1) < 0) { return 1; } return $units[($i - 1)]; } } return $units[-1]; } /** * Builder for breadcrum * * @param array $urls Array of urls to be stored in breadcrum. * @param boolean $add True if breadcrum should be added * instead of overwrite it. * * @return void */ public function prepareBreadcrum( array $urls, bool $add=false ) { $bc = []; $i = 0; foreach ($urls as $url) { if ($url['selected'] == 1) { $class = 'selected'; } else { $class = ''; } $bc[$i] = ''; $bc[$i] .= ''; $bc[$i] .= $url['label']; $bc[$i] .= ''; $bc[$i] .= ''; $i++; } if ($add === true) { $this->addBreadcrum($bc); } else { $this->setBreadcrum($bc); } } /** * To be overwritten. * * @return void */ public function run() { ui_require_css_file('wizard'); // Check access. check_login(); if (! $this->aclMulticheck()) { return; } } /** * Check multiple acl perms. * * @param string $access Access in PM|AR|RR format. Optional. * * @return boolean Alowed or not. */ public function aclMulticheck($access=null) { global $config; if (isset($access)) { $perms = explode('|', $access); } else { $perms = explode('|', $this->access); } $allowed = false; foreach ($perms as $perm) { $allowed = $allowed || (bool) check_acl( $config['id_user'], 0, $perm ); } return $allowed; } /** * Checks if environment is ready, * returns array * icon: icon to be displayed * label: label to be displayed * * @return array With data. **/ public function load() { global $config; // Check access. check_login(); if (! $this->aclMulticheck()) { return false; } return [ 'icon' => $this->icon, 'label' => $this->label, 'url' => $this->url, ]; } /** * Print breadcrum to follow flow. * * @return string Breadcrum HTML code. */ public function printBreadcrum() { return implode( ' ', $this->breadcrum ); } /** * Prints a header for current wizard. * * @param boolean $return Return HTML or print it. * * @return string HTML code for header. */ public function printHeader(bool $return=false) { $output = $this->printBreadcrum(); if ($return === false) { echo $output; } return $output; } /** * Return formatted html for error handler. * * @param string $message Error mesage. * * @return string */ public static function error($message) { if (is_ajax()) { echo json_encode( [ 'error' => ui_print_error_message($message, '', true), ] ); } else { return ui_print_error_message($message, '', true); } } /** * Print input using functions html lib. * * @param array $data Input definition. * * @return string HTML code for desired input. */ public static function printInput($data) { global $config; include_once $config['homedir'].'/include/functions_html.php'; if (is_array($data) === false) { return ''; } $input_only = true; if (isset($data['input_only']) === true) { $input_only = $data['input_only']; } $input = html_print_input( ($data + ['return' => true]), 'div', $input_only ); if ($input === false) { return ''; } return $input; } /** * Prints a go back button redirecting to main page. * * @param string $url Optional target url. * * @return void */ public static function printGoBackButton($url=null) { if (isset($url) === false) { $url = ui_get_full_url( 'index.php?sec=gservers&sec2=godmode/servers/discovery' ); } $form = [ 'form' => [ 'method' => 'POST', 'action' => $url, ], 'inputs' => [ [ 'class' => 'w100p', 'arguments' => [ 'name' => 'submit', 'label' => __('Go back'), 'type' => 'submit', 'attributes' => 'class="sub cancel"', 'return' => true, ], ], ], ]; self::printForm($form); } /** * Print a block of inputs. * Example, using direct to 'anidate' inputs directly to wrapper: * [ * 'wrapper' => 'div', * 'block_id' => 'example_id', * 'class' => 'your class', * 'direct' => 1, * 'block_content' => [ * [ * 'arguments' => [ * 'label' => __('Sugesstion'), * 'type' => 'button', * 'attributes' => 'class="sub ok btn_sug"', * 'name' => 'option_1', * 'id' => 'option_1', * 'script' => 'change_option1()', * ], * ], * [ * 'arguments' => [ * 'label' => __('Something is not quite right'), * 'type' => 'button', * 'attributes' => 'class="sub ok btn_something"', * 'name' => 'option_2', * 'id' => 'option_2', * 'script' => 'change_option2()', * ], * ], * ], * ]. * * @param array $input Definition of target block to be printed. * @param boolean $return Return as string or direct output. * @param boolean $direct Avoid encapsulation if input print is direct. * * @return string HTML content. */ public static function printBlock( array $input, bool $return=false, bool $direct=false ) { $output = ''; if ($input['hidden'] == 1) { $class = ' hidden'; } else { $class = ''; } if (isset($input['class']) === true) { $class = $input['class'].$class; } if (is_array($input['block_content']) === true) { $direct = (bool) $input['direct']; $toggle = (bool) $input['toggle']; if (isset($input['label']) === true) { $output .= ''.$input['label'].''; } // Print independent block of inputs. $output .= '