read()) if ((substr($entry, strlen($entry) - 4, 4) == '.inc') && is_file($modulesINC_dirname . '/'.$entry)) { include_once($modulesINC_dirname . '/'.$entry); } /** * Returns the alias name of a module * * @param string $name the module name * @param string $scope the account type ("user", "group", "host") * @return string alias name */ function getModuleAlias($name, $scope) { $module = new $name($scope); return $module->get_alias(); } /** * Returns true if the module is a base module * * @param string $name the module name * @param string $scope the account type ("user", "group", "host") * @return boolean true if base module */ function is_base_module($name, $scope) { $module = new $name($scope); return $module->is_base_module(); } /** * Returns the LDAP filter used by the account lists * * @param string $scope the account type ("user", "group", "host") * @return string LDAP filter */ function get_ldap_filter($scope) { $mods = $_SESSION['config']->get_AccountModules($scope); $filters = array(); $orFilter = ''; for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $modinfo = $module->get_ldap_filter(); if (isset($modinfo['or'])) $filters['or'][] = $modinfo['or']; if (isset($modinfo['and'])) $filters['and'][] = $modinfo['and']; } // build OR filter if (sizeof($filters['or']) == 1) { $orFilter = $filters['or'][0]; } elseif (sizeof($filters['or']) > 1) { $orFilter = "(|" . implode("", $filters['or']) . ")"; } // add built OR filter to AND filters if ($orFilter != '') $filters['and'][] = $orFilter; // collapse AND filters if (sizeof($filters['and']) < 2) return $filters['and'][0]; else return "(&" . implode("", $filters['and']) . ")"; } /** * Returns a list of LDAP attributes which can be used to form the RDN. * * The list is already sorted by the priority given by the nodules. * * @param string $scope account type (user, group, host) * @return array list of LDAP attributes */ function getRDNAttributes($scope) { $mods = $_SESSION['config']->get_AccountModules($scope); $return = array(); $attrs_low = array(); $attrs_normal = array(); $attrs_high = array(); for ($i = 0; $i < sizeof($mods); $i++) { // get list of attributes $module = new $mods[$i]($scope); $attrs = $module->get_RDNAttributes(); $keys = array_keys($attrs); // sort attributes for ($k = 0; $k < sizeof($keys); $k++) { switch ($attrs[$keys[$k]]) { case "low": $attrs_low[] = $keys[$k]; break; case "normal": $attrs_normal[] = $keys[$k]; break; case "high": $attrs_high[] = $keys[$k]; break; default: $attrs_low[] = $keys[$k]; break; } } } // merge arrays $return = array_values(array_unique($attrs_high)); for ($i = 0; $i < sizeof($attrs_normal); $i++) { if (!in_array($attrs_normal[$i], $return)) $return[] = $attrs_normal[$i]; } for ($i = 0; $i < sizeof($attrs_low); $i++) { if (!in_array($attrs_low[$i], $return)) $return[] = $attrs_low[$i]; } return $return; } /** * Returns a hash array (module name => dependencies) of all module dependencies * * "dependencies" contains an array with two sub arrays: depends, conflicts *
The elements of "depends" are either module names or an array of module names (OR-case). *
The elements of conflicts are module names. * * @param string $scope the account type (user, group, host) * @return array dependencies */ function getModulesDependencies($scope) { $mods = getAvailableModules($scope); for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $return[$mods[$i]] = $module->get_dependencies(); } return $return; } /** * Checks if there are missing dependencies between modules. * * @param array $selected selected module names * @param array $deps module dependencies * @return mixed false if no misssing dependency was found, * otherwise an array of array(selected module, depending module) if missing dependencies were found */ function check_module_depends($selected, $deps) { $ret = array(); for ($m = 0; $m < sizeof($selected); $m++) { // check selected modules for ($i = 0; $i < sizeof($deps[$selected[$m]]['depends']); $i++) { // check dependencies of module // check if we have OR-combined modules if (is_array($deps[$selected[$m]]['depends'][$i])) { // one of the elements is needed $found = false; $depends = $deps[$selected[$m]]['depends'][$i]; for ($d = 0; $d < sizeof($depends); $d++) { if (in_array($depends[$d], $selected)) { $found = true; break; } } if (! $found) { // missing dependency, add to return value $ret[] = array($selected[$m], implode(" || ", $depends)); } } else { // single dependency if (! in_array($deps[$selected[$m]]['depends'][$i], $selected)) { // missing dependency, add to return value $ret[] = array($selected[$m], $deps[$selected[$m]]['depends'][$i]); } } } } if (sizeof($ret) > 0) return $ret; else return false; } /** * Checks if there are conflicts between modules * * @param array $selected selected module names * @param array $deps module dependencies * @return boolean false if no conflict was found, * otherwise an array of array(selected module, conflicting module) if conflicts were found */ function check_module_conflicts($selected, $deps) { $ret = array(); for ($m = 0; $m < sizeof($selected); $m++) { for ($i = 0; $i < sizeof($deps[$selected[$m]]['conflicts']); $i++) { if (in_array($deps[$selected[$m]]['conflicts'][$i], $selected)) { $ret[] = array($selected[$m], $deps[$selected[$m]]['conflicts'][$i]); } } } if (sizeof($ret) > 0) return $ret; else return false; } /** * Returns an array with all available user module names * * @param string $scope account type (user, group, host) * @return array list of possible modules */ function getAvailableModules($scope) { $dirname = substr(__FILE__, 0, strlen(__FILE__) - 12) . "/modules"; $dir = dir($dirname); $return = array(); // get module names. while ($entry = $dir->read()) if ((substr($entry, strlen($entry) - 4, 4) == '.inc') && is_file($dirname . '/'.$entry)) { $entry = substr($entry, 0, strpos($entry, '.')); $temp = new $entry($scope); if ($temp->can_manage()) $return[] = $entry; } return $return; } /** * Returns the elements for the profile page. * * @param string $scope account type (user, group, host) * @return array profile elements */ function getProfileOptions($scope) { $mods = $_SESSION['config']->get_AccountModules($scope); $return = array(); for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $return[$mods[$i]] = $module->get_profileOptions(); } return $return; } /** * Checks if the profile options are valid * * @param string $scope account type (user, group, host) * @param array $options hash array containing all options (name => array(...)) * @return array list of error messages */ function checkProfileOptions($scope, $options) { $mods = $_SESSION['config']->get_AccountModules($scope); $return = array(); for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $temp = $module->check_profileOptions($options); $return = array_merge($return, $temp); } return $return; } /** * Returns a hash array (module name => elements) of all module options for the configuration page. * * @param array $scopes hash array (module name => array(account types)) * @return array configuration options */ function getConfigOptions($scopes) { $return = array(); $modules = array_keys($scopes); for ($i = 0; $i < sizeof($modules); $i++) { $m = new $modules[$i]('none'); $return[$modules[$i]] = $m->get_configOptions($scopes[$modules[$i]]); } return $return; } /** * Returns a hash array (module name => descriptions) containing descriptions shown on configuration pages. * * The returned array has the format array('legend' => array('posixAccount' => '...', ...), descriptions => array('option1' => '...', ...)). *
The "legend" value is used as text for the fieldset, the descriptions are used when the configuration is printed. * * @return array configuration descriptions */ function getConfigDescriptions() { $return = array('legend' => array(), 'descriptions' => array()); $modules = array_merge(getAvailableModules('user'), getAvailableModules('group'), getAvailableModules('host')); $modules = array_values(array_unique($modules)); for ($i = 0; $i < sizeof($modules); $i++) { $m = new $modules[$i]('none'); $desc = $m->get_configDescriptions(); $return['legend'][$modules[$i]] = $desc['legend']; $return['descriptions'] = array_merge($return['descriptions'], $desc['descriptions']); } return $return; } /** * Checks if the configuration options are valid * * @param array $scopes hash array (module name => array(account types)) * @param array $options hash array containing all options (name => array(...)) * @return array list of error messages */ function checkConfigOptions($scopes, $options) { $return = array(); $modules = array_keys($scopes); for ($i = 0; $i < sizeof($modules); $i++) { $m = new $modules[$i]('none'); $errors = $m->check_configOptions($scopes[$modules[$i]], $options); $return = array_merge($return, $errors); } return $return; } /** * Returns a help entry from an account module. * * @param string $helpID help identifier * @param string $module module name * @return array help entry */ function getHelp($module,$helpID,$scope='') { $moduleObject = new $module((($scope != '') ? $scope : 'none')); return $moduleObject->get_help($helpID); } /** * Returns a list of available PDF entries. * * @param string $scope account type (user, group, host) * @return array PDF entries */ function getAvailablePDFFields($scope) { $mods = $_SESSION['config']->get_AccountModules($scope); $return = array(); for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $return[$mods[$i]] = $module->get_pdfFields(); } $return['main'] = array('dn'); return $return; } /** * Return a list of current available scopes * * @return array Available scopes */ function getAvailableScopes() { return array('user','group','host', 'domain'); } /** * Returns an array containing all input columns for the file upload. * * Syntax: *
array( *
string: name, // fixed non-translated name which is used as column name (should be of format: _) *
string: description, // short descriptive name *
string: help, // help ID *
string: example, // example value *
boolean: required // true, if user must set a value for this column *
) * * @param string $scope account type * @return array column list */ function getUploadColumns($scope) { $mods = $_SESSION['config']->get_AccountModules($scope); $return = array(); for ($i = 0; $i < sizeof($mods); $i++) { $module = new $mods[$i]($scope); $return[$mods[$i]] = $module->get_uploadColumns(); } return $return; } /** * This function builds the LDAP accounts for the file upload. * * If there are problems status messages will be printed automatically. * * @param string $scope account type * @param array $data array containing one account in each element * @param array $ids array( => ) * @return mixed array including accounts or false if there were errors */ function buildUploadAccounts($scope, $data, $ids) { // build module order $unOrdered = $_SESSION['config']->get_AccountModules($scope); $ordered = array(); $predepends = array(); // get dependencies for ($i = 0; $i < sizeof($unOrdered); $i++) { $mod = new $unOrdered[$i]($scope); $predepends[$unOrdered[$i]] = $mod->get_uploadPreDepends(); } // first all modules without predepends can be ordered for ($i = 0; $i < sizeof($unOrdered); $i++) { if (sizeof($predepends[$unOrdered[$i]]) == 0) { $ordered[] = $unOrdered[$i]; unset($unOrdered[$i]); $unOrdered = array_values($unOrdered); $i--; } } $unOrdered = array_values($unOrdered); // fix indexes // now add all modules with fulfilled dependencies until all are in order while (sizeof($unOrdered) > 0) { $newRound = false; for ($i = 0; $i < sizeof($unOrdered); $i++) { $deps = $predepends[$unOrdered[$i]]; $depends = false; for ($d = 0; $d < sizeof($deps); $d++) { if (in_array($deps[$d], $unOrdered)) { $depends = true; break; } } if (!$depends) { // add to order if dependencies are fulfilled $ordered[] = $unOrdered[$i]; unset($unOrdered[$i]); $unOrdered = array_values($unOrdered); $newRound = true; break; } } if ($newRound) continue; // this point should never be reached, LAM was unable to find a correct module order StatusMessage("ERROR", "Internal Error: Unable to find correct module order.", ""); return false; } // give raw data to modules $errors = array(); $partialAccounts = array(); for ($i = 0; $i < sizeof($data); $i++) $partialAccounts[$i]['objectClass'] = array(); for ($i = 0; $i < sizeof($ordered); $i++) { $module = new $ordered[$i]($scope); $errors = $module->build_uploadAccounts($data, $ids, $partialAccounts); if (sizeof($errors) > 0) { array_unshift($errors, array("INFO", _("Displayed account numbers start at \"0\". Add 2 to get the row in your spreadsheet."), "")); $errors[] = array("ERROR", _("Upload was stopped after errors in %s module!"), "", array($module->get_alias())); break; } } if (sizeof($errors) > 0) { for ($i = 0; (($i < sizeof($errors)) || ($i > 49)); $i++) call_user_func_array("StatusMessage", $errors[$i]); return false; } else return $partialAccounts; } /** * This function executes one post upload action. * * @param string $scope account type * @param array $data array containing one account in each element * @param array $ids array( => ) * @param array $failed list of accounts which were not created successfully * @return array current status *
array ( *
'status' => 'finished' | 'inProgress' *
'module' => *
'progress' => 0..100 *
'errors' => array () *
) */ function doUploadPostActions($scope, $data, $ids, $failed) { // check if function is called the first time if (! isset($_SESSION['mass_postActions']['remainingModules'])) { // make list of remaining modules $moduleList = $_SESSION['config']->get_AccountModules($scope); $_SESSION['mass_postActions']['remainingModules'] = $moduleList; } $activeModule = $_SESSION['mass_postActions']['remainingModules'][0]; // initialize temporary variable if (!isset($_SESSION['mass_postActions'][$activeModule])) { $_SESSION['mass_postActions'][$activeModule] = array(); } // let first module do one post action $module = new $activeModule($scope); $return = $module->doUploadPostActions($data, $ids, $failed, $_SESSION['mass_postActions'][$activeModule]); // remove active module from list if already finished if ($return['status'] == 'finished') { unset($_SESSION['mass_postActions']['remainingModules'][0]); $_SESSION['mass_postActions']['remainingModules'] = array_values($_SESSION['mass_postActions']['remainingModules']); } // update status and return back to upload page $return['module'] = $activeModule; if (sizeof($_SESSION['mass_postActions']['remainingModules']) > 0) { $return['status'] = 'inProgress'; } else { $return['status'] = 'finished'; } return $return; } /** * Takes a list of meta-HTML elements and prints the equivalent HTML output. * * @param string $module Name of account module * @param array $input List of meta-HTML elements * @param array $values List of values which override the defaults in $input (name => value) * @param boolean $restricted If true then no buttons will be displayed * @param integer $tabindex Start value of tabulator index for input fields * @param integer $tabindexLink Start value of tabulator index for links * @param string $scope Account type * @return array List of input field names and their type (name => type) */ function parseHtml($module, $input, $values, $restricted, &$tabindex, &$tabindexLink, $scope) { $ret = array(); if (is_array($input)) { echo "\n"; for ($i=0; $i\n"; for ($j=0; $j\n"; switch ($input[$i][$j]['kind']) { // plain text case 'text': echo $input[$i][$j]['text']; break; // input fields case 'input': $type = $input[$i][$j]['type']; if ($restricted && (($type == "submit") || ($type == "reset") || ($type == "file"))) break; // no buttons in restricted mode $output = "\n"; if ($input[$i][$j]['legend']!='') echo "" . $input[$i][$j]['legend'] . "\n"; parseHtml($module, $input[$i][$j]['value'], $values, $restricted, $tabindex, $tabindexLink, $scope); echo "\n"; break; // selection case 'select': if (! is_numeric($input[$i][$j]['size'])) $input[$i][$j]['size'] = 1; // correct size if needed if (isset($input[$i][$j]['multiple'])) { echo "\n"; break; // sub table case 'table': $retTemp = parseHtml($module, $input[$i][$j]['value'], $values, $restricted, $tabindex, $tabindexLink, $scope); $ret = array_merge($ret, $retTemp); break; // help link case 'help': $helpPath = "../"; if (is_file("./help.php")) $helpPath = ""; echo ""; echo "\"""; echo "\n"; $tabindexLink++; break; // status message case 'message': StatusMessage($input[$i][$j]['type'], $input[$i][$j]['headline'], $input[$i][$j]['text']); break; // image case 'image': echo "\n"; break; // error, unknown type default: echo "Unrecognized type: " . $input[$i][$j]['kind'] . "\n"; break; } echo "\n"; } echo "\n"; } } echo "
\n"; return $ret; } /** * This class includes all modules and attributes of an account. * * @package modules */ class accountContainer { /** * Constructor * * @param string $type account type * @param string $base key in $_SESSION where this object is saved */ function accountContainer($type, $base) { /* Set the type of account. Valid * types are: user, group, host */ // Check input variable if (!is_string($type)) trigger_error('Argument of accountContainer must be string.', E_USER_ERROR); if (!is_string($base)) trigger_error('Argument of accountContainer must be string.', E_USER_ERROR); // *** fixme use global variable to determine allowed types if (!in_array($type, getAvailableScopes())) trigger_error('Account type not recognized.', E_USER_ERROR); $this->type = $type; $this->base = $base; // Set startpage $this->current_page=0; $this->subpage='attributes'; $this->isNewAccount = false; return 0; } /** * Array of all used attributes * Syntax is attribute => array ( objectClass => MUST or MAY, ...) */ var $attributes; /** * This variale stores the account type. * Currently "user", "group" and "host" are supported. */ var $type; /** This is an array with all module objects */ var $module; /** DN suffix of the account */ var $dn; /** DN suffix of account when it was loaded */ var $dn_orig; /** RDN attribute of this account */ var $rdn; /** original LDAP attributes when account was loaded from LDAP */ var $attributes_orig; /** Module order */ var $order; /** Name of accountContainer variable in session */ var $base; /** This variable stores the name of the currently displayed page */ var $current_page; /** This variable is set to the pagename of a subpage if it should be displayed */ var $subpage; /** True if this is a newly created account */ var $isNewAccount; /** * Returns the accout type of this object (e.g. user, group, host). * * @return string account type */ function get_type() { return $this->type; } /** * This function is called when the user clicks on any button on the account pages. * It prints the HTML code of each account page. * * @param array $post HTTP POST variables */ function continue_main($post) { if ($this->subpage=='') $this->subpage='attributes'; if ($post['form_main_reset']) { $this->load_account($this->dn_orig); } else { if ($this->current_page==0) { if ($this->subpage=='attributes') { $result = 0; // change dn if ($post['suffix']!='') $this->dn = $post['suffix']; // change RDN if (isset($post['rdn'])) $this->rdn = $post['rdn']; // load profile if ($post['selectLoadProfile'] && $post['loadProfile']) { $profile = loadAccountProfile($post['selectLoadProfile'], $this->type); // pass profile to each module $modules = array_keys($this->module); foreach ($modules as $module) $this->module[$module]->load_profile($profile); if (isset($profile['ldap_rdn'][0])) { if (in_array($profile['ldap_rdn'][0], getRDNAttributes($this->type))) { $this->rdn = $profile['ldap_rdn'][0]; } } if (isset($profile['ldap_suffix'][0])) { $this->dn = $profile['ldap_suffix'][0]; } $result = 0; } // save account if ($post['create']) { $errors = $this->save_account(); if (is_array($errors)) { $result = array($errors); $stopProcessing = true; } else $this->subpage = 'finish'; } } if ($this->subpage=='finish') { if ($post['createagain']) { // Reset objects $modules = array_keys($this->module); foreach ($modules as $module) unset($this->module[$module]); // Reset accountContainer $this->dn = ''; $this->dn_orig = ''; $this->attributes = array(); $this->order = array(); $this->current_page = 0; $this->subpage = ''; // Add all required objects etc. $this->new_account(); $result = 0; } if ($post['backmain']) { // Return to *-list // *** fixme unset accountContainer in session metaRefresh("../lists/list".$this->type."s.php"); exit; } if ($post['outputpdf']) { // Create / display PDf-file createModulePDF(array($_SESSION[$this->base]), $post['pdfStructure']); exit; } } } else $result = call_user_func(array(&$this->module[$this->order[$this->current_page]], 'process_'.$this->subpage), $post); } // change to next page $errorsOccured = false; if (is_array($result)) { // messages were returned, check for errors $errorKeys = array_keys($result); for ($i = 0; $i < sizeof($errorKeys); $i++) { for ($m = 0; $m < sizeof($result[$errorKeys[$i]]); $m++) { if (($result[$errorKeys[$i]][$m][0] == 'ERROR') || ($result[$errorKeys[$i]][$m][0] == 'WARN')) { $errorsOccured = true; break; } } } } if (!$errorsOccured) { // go to subpage of current module $postKeys = array_keys($post); for ($p = 0; $p < sizeof($postKeys); $p++) { if (is_string($postKeys[$p]) && (strpos($postKeys[$p], 'form_subpage_' . $this->order[$this->current_page]) === 0)) { $temp = substr($postKeys[$p], strlen($this->order[$this->current_page]) + 14); $temp = explode('_', $temp); if (sizeof($temp) == 2) { $this->subpage = $temp[0]; } } } // change module page if requested if ($post['form_main_main']) { $this->current_page = 0; $this->subpage='attributes'; } else { for ($i=1; $iorder); $i++ ) { if (isset($post['form_main_'.$this->order[$i]])) { if ($this->module[$this->order[$i]]->module_ready()) { $this->current_page = $i; $this->subpage='attributes'; } else { StatusMessage('ERROR', _('The module %s is not yet ready.'), _('Please enter the account information on the other pages first.'), array($this->module[$this->order[$i]]->get_alias())); } } } } } // Write HTML-Code echo $_SESSION['header']; echo ""; if ($this->dn_orig!='') echo _("Modify Account"); else echo _("Create new Account"); echo "\n"; echo "\n"; echo "\n"; echo "
\n"; // Display error-messages if (is_array($result)) { foreach ($result as $result2) { if (is_array($result2)) { for ($i=0; $i\n"; echo "\n"; return 0; } } if ($this->current_page==0) { if ($this->subpage=='attributes') { $modules = array_keys($this->module); $disabled = false; $incompleteModules = array(); foreach ($modules as $module) { if (!$this->module[$module]->module_complete()) { $disabled = true; $incompleteModules[] = $this->module[$module]->get_alias(); } } if (sizeof($incompleteModules) > 0) { StatusMessage('INFO', _('Some required information is missing'), sprintf(_('Please set up all required attributes on page: %s'), implode(", ", $incompleteModules))); } } } // Create left module-menu echo "\n\n
"; echo "
type."edit\">"; echo _('Please select page:'); echo "\n"; // calculate button width $buttonWidth = round(0.8 * strlen(utf8_decode(_("Reset changes")))); for ($b = 0; $b < sizeof($this->order); $b++) { $tempWidth = round(0.8 * strlen(utf8_decode($this->order[$b]))); if ($buttonWidth < $tempWidth) $buttonWidth = $tempWidth; } $x=0; // print "main" button echo "subpage == 'finish') echo " disabled"; echo ">\n
"; $x++; // Loop for module // $x is used to count up tabindex for ($i=1; $iorder); $i++ ) { $buttonStatus = $this->module[$this->order[$i]]->getButtonStatus(); // skip hidden buttons if ($buttonStatus == 'hidden') continue; // print normal button echo "order[$i]."\" type=\"submit\" value=\""; echo $this->module[$this->order[$i]]->get_alias(); echo "\" tabindex=$x"; if (($buttonStatus == 'disabled') || $this->subpage == 'finish') echo " disabled"; echo ">\n
"; $x++; } if ($this->dn_orig!='') { echo "
subpage == 'finish') echo " disabled"; echo ">
\n"; } echo "
\n"; echo "
"; if ($this->current_page==0) { echo "
type."edit\">"; echo _('Main'); echo "\n"; } else { echo "
type."edit\">"; echo $this->module[$this->order[$this->current_page]]->get_alias(); echo "\n"; } // display html-code from mdule $return = array(); if ($this->current_page == 0) { if ($this->subpage == 'finish') { // Show success message if ($this->dn_orig == '') { $text = _("Account was created successfully."); } else { $text = _("Account was modified successfully."); } $return[] = array( 0 => array('kind' => 'message', 'type' => 'INFO', 'headline' => _('LDAP operation successful.'), 'text' => $text, 'td' => array('colspan' => 3))); $return[] = array( 0 => array('kind' => 'text', 'text' => '', 'td' => array('colspan' => 3))); $return[] = array( 0 => array('kind' => 'input', 'type' => 'submit', 'name' => 'createagain', 'value' => _('Create another account')), 1 => array('kind' => 'input', 'type' => 'submit', 'name' => 'backmain', 'value' => _('Back to account list'))); $return[] = array(0 => array('kind' => 'text', 'text' => ' ')); // empty line $return[] = array(0 => array('kind' => 'text', 'text' => ' ')); // empty line $pdfStructures = getPDFStructureDefinitions($this->type); $return[] = array( 0 => array('kind' => 'fieldset', 'legend' => 'PDF', 'td' => array('colspan' => 2), 'value' => array(array( 0 => array('kind' => 'select', 'name' => 'pdfStructure', 'options' => $pdfStructures), 1 => array('kind' => 'input', 'type' => 'submit', 'name' => 'outputpdf', 'value' => _('Create PDF file')), 2 => array('kind' => 'help', 'value' => '403')) ))); } else { // loop through all suffixes $rootsuffix = $_SESSION['config']->get_Suffix($this->type); foreach ($_SESSION['ldap']->search_units($rootsuffix) as $suffix) { if ($this->dn == $suffix) $options_selected = $suffix; $suffixes[] = $suffix; } $return[] = array( 0 => array('kind' => 'text', 'text' => _('Suffix')), 1 => array('kind' => 'select', 'name' => 'suffix', 'options' => $suffixes, 'options_selected' => array($options_selected), 'noSorting' => true), 2 => array ('kind' => 'help', 'value' => '361')); // RDN selection $rdnlist = getRDNAttributes($this->type); $rdnSelected = array(); if ($this->rdn != '') { $rdnSelected[] = $this->rdn; } else { $rdnSelected[] = $rdnlist[0]; } $return[] = array( 0 => array('kind' => 'text', 'text' => _('RDN identifier')), 1 => array('kind' => 'select', 'name' => 'rdn', 'options' => $rdnlist, 'options_selected' => $rdnSelected, 'noSorting' => true), 2 => array ('kind' => 'help', 'value' => '301')); // Get list of profiles $profilelist = getAccountProfiles($this->type); if (count($profilelist)!=0) { $return[] = array( 0 => array('kind' => 'text', 'text' => _("Load profile")), 1 => array('kind' => 'table', 'value' => array(0 => array( 0 => array('kind' => 'select', 'name' => 'selectLoadProfile', 'options' => $profilelist), 1 => array('kind' => 'input', 'type' => 'submit', 'name' => 'loadProfile', 'value' => _('Load profile')) ))), 2 => array('kind' => 'help', 'value' => '401') ); } $return[] = array(0 => array('kind' => 'text', 'text' => ' ')); // empty line if ($this->dn_orig!='') $text = _('Modify Account'); else $text = _('Create Account'); $return[] = array ( 0 => array ( 'kind' => 'text', 'text' => $text ), 1 => array ( 'kind' => 'input', 'type' => 'submit', 'name' => 'create', 'value' => $text, 'disabled' => $disabled), 2 => array ('kind' => 'help', 'value' => '402')); } } else $return = call_user_func(array($this->module[$this->order[$this->current_page]], 'display_html_'.$this->subpage), $post); $y = 5000; $z = 10000; parseHtml($this->order[$this->current_page], $return, array(), false, $y, $z, $this->type); // Display rest of html-page echo "
\n
*" . _('required'); echo "
\n"; echo "\n"; echo "\n"; echo "\n"; return 0; } /** * Add attributes to variable. Syntax is array( attribute = array ( objectClass1 => MUST|MAX, objectClass2 => MUST|MAY ), ... ) * @todo document this function */ function add_attributes($objectClass) { // loop through every existing objectlass and select current objectClass $line=-1; for ($i=0; $iobjectClasses) || $i==-1; $i++) { if (strpos(strtolower($_SESSION['ldap']->objectClasses[$i]), strtolower("NAME '$objectClass'"))) $line = $i; } // Return error if objectClass isn't found if ($line==-1) trigger_error (sprintf(_("ObjectClass %s required but not defined in LDAP."), $objectClass), E_USER_WARNING); // create array with must-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')+6); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); $must = explode(" $ ", $string); // Ad must foreach ($must as $attribute) { if (!isset($this->attributes[$attribute])) $this->attributes[$attribute][$objectClass] = 'MUST'; else $this->attributes[$attribute][$objectClass] = 'MUST'; } } // create array with may-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')+5); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); $may = explode(" $ ", $string); // Ad may foreach ($may as $attribute) { if (!isset($this->attributes[$attribute])) $this->attributes[$attribute][$objectClass] = 'MAY'; else $this->attributes[$attribute][$objectClass] = 'MAY'; } } // Get attributes of subclasses while (strpos($_SESSION['ldap']->objectClasses[$line], "SUP ")) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'SUP ')+4); $subclass = substr($string_withtail, 0, strpos($string_withtail, ' ')); // Add account type to object for ($i=0; $iobjectClasses) || $i==-1; $i++) { if (strpos($_SESSION['ldap']->objectClasses[$i], "NAME '$subclass'")) $line = $i; } // Return error if objectClass isn't found if ($line==-1) trigger_error (sprintf(_("ObjectClass %s required but not defined in LDAP."), $objectClass), E_USER_WARNING); // create array with must-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')+6); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); $must = explode(" $ ", $string); // Ad must foreach ($must as $attribute) { if (!isset($this->attributes[$attribute])) $this->attributes[$attribute][$objectClass] = 'MUST'; else $this->attributes[$attribute][$objectClass] = 'MUST'; } } // create array with may-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')+5); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); $may = explode(" $ ", $string); // Ad may foreach ($may as $attribute) { if (!isset($this->attributes[$attribute])) $this->attributes[$attribute][$objectClass] = 'MAY'; else $this->attributes[$attribute][$objectClass] = 'MAY'; } } } } /** * This function return ldap attributes * Syntax is get_attributes($value, $scope) * $scope = 'objectClass', $value = objectClass return value are all attributes of objectClass * $scope = 'attribute', $value = attribute returns alle objectClasses which are using the attribute * * @todo Obsolete function??? */ function get_attributes($value, $scope) { if ($scope=='attribute' && isset($this->attributes[$value])) return $this->attributes[$value]; if ($scope=='objectClass') { $keys = array_keys($this->attributes); foreach ($keys as $attribute) { if (isset($this->attributes[$attribute][$value])) $return[$attribute] = $this->attributes[$attribute][$value]; } return $return; } return 0; } /** * This function returns all LDAP attributes which are used by the given object class. * LDAP attributs which are already in use by another object class are passed as reference. *
Therefore this function must be called as reference: $result =& ..get_module_attributes * * @param string $objectClass object class name * @param boolean $original If original is true references will be set to original attributes. This are the original attributes * when an LDAP entry is loaded. * @return array list of attributes */ function get_module_attributes($objectClass, $original=false) { // Add account type to object $line=-1; for ($i=0; $iobjectClasses) || $i==-1; $i++) { if (strpos(strtolower($_SESSION['ldap']->objectClasses[$i]), strtolower("NAME '$objectClass'"))) $line = $i; } // Return empty array if no objectClass wasn't found if ($line==-1) return array(); if (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')+6); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); // Add must foreach (explode(" $ ", $string) as $attribute) { $return[$attribute] = array(''); } } elseif (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST ')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST ')+5); // Now we have a string with the must-attribute $string = substr($string_withtail, 0, strpos($string_withtail, ' ')); $string = trim($string); // Add must $return[$string] = array(''); } // create array with may-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')+5); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); // Add may foreach (explode(" $ ", $string) as $attribute) { $return[$attribute] = array(''); } } elseif (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY ')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY ')+4); // Now we have a string with the may-attribute $string = substr($string_withtail, 0, strpos($string_withtail, ' ')); $string = trim($string); // Add must $return[$string] = array(''); } // Get attributes of subclasses while (strpos($_SESSION['ldap']->objectClasses[$line], "SUP ")) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'SUP ')+4); $subclass = substr($string_withtail, 0, strpos($string_withtail, ' ')); // Add account type to object for ($i=0; $iobjectClasses) || $i==-1; $i++) { if (strpos($_SESSION['ldap']->objectClasses[$i], "NAME '$subclass'")) $line = $i; } // Return error if objectClass isn't found if ($line==-1) trigger_error (sprintf(_("ObjectClass %s required but not defined in LDAP."), $subclass), E_USER_WARNING); // create array with must-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST (')+6); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); // Add must foreach (explode(" $ ", $string) as $attribute) { $return[$attribute] = array(''); } } elseif (strpos($_SESSION['ldap']->objectClasses[$line], 'MUST ')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MUST ')+5); // Now we have a string with the must-attribute $string = substr($string_withtail, 0, strpos($string_withtail, ' ')); $string = trim($string); // Add must $return[$string] = array(''); } // create array with may-attributes // Get startposition in string if (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY (')+5); // Now we have a string with all must-attributes $string = substr($string_withtail, 0, strpos($string_withtail, ')')); $string = trim($string); // Add may foreach (explode(" $ ", $string) as $attribute) { $return[$attribute] = array(''); } } elseif (strpos($_SESSION['ldap']->objectClasses[$line], 'MAY ')) { $string_withtail = substr($_SESSION['ldap']->objectClasses[$line], strpos($_SESSION['ldap']->objectClasses[$line], 'MAY ')+4); // Now we have a string with the may-attribute $string = substr($string_withtail, 0, strpos($string_withtail, ' ')); $string = trim($string); // Add must $return[$string] = array(''); } } // make references with attibutes which are used by more than one module $newattributes = array_keys($return); $module = array_keys($this->module); if (!$original) { // Only add attributes when original is false. We don't want to add them twice $this->add_attributes($objectClass); for ($i=0; $imodule[$module[$i]]->attributes[$attribute]) && ($attribute!='objectClass')) $return[$attribute] =& $this->module[$module[$i]]->attributes[$attribute]; } } else { for ($i=0; $imodule[$module[$i]]->orig[$attribute]) && ($attribute!='objectClass')) $return[$attribute] =& $this->module[$module[$i]]->orig[$attribute]; } } $return['objectClass'] = array(); return $return; } /** * This function checks which LDAP attributes have changed while the account was edited. * * @param array $attributes list of current LDAP attributes * @param array $orig list of old attributes when account was loaded * @return array an array which can be passed to $this->saveAccount() */ function save_module_attributes($attributes, $orig) { // Get list of all "easy" attributes $attr_names = array_keys($attributes); // Get attributes which should be added for ($i=0; $idn]['add'] = $toadd; if (count($torem)!=0) $return[$this->dn]['remove'] = $torem; if (count($tomodify)!=0) $return[$this->dn]['modify'] = $tomodify; if (count($notchanged)!=0) $return[$this->dn]['notchanged'] = $notchanged; return $return; } /** * Loads an LDAP account with the given DN. * * @param string $dn the DN of the account */ function load_account($dn) { $modules = $_SESSION['config']->get_AccountModules($this->type); $search = substr($dn, 0, strpos($dn, ',')); $result = ldap_search($_SESSION['ldap']->server(), $dn, $search); $entry = ldap_first_entry($_SESSION['ldap']->server(), $result); $this->dn = substr($dn, strpos($dn, ',')+1); $this->dn_orig = $dn; // extract RDN $this->rdn = split("=", substr($dn, 0, strpos($dn, ','))); $this->rdn = $this->rdn[0]; $attr = ldap_get_attributes($_SESSION['ldap']->server(), $entry); $attrNames = array_keys($attr); // remove 'count' entries and numerical entries for ($i = 0; $i < count($attr); $i++) { if (isset($attr[$i])) unset($attr[$i]); } for ($i = 0; $i < sizeof($attrNames); $i++) unset($attr[$attrNames[$i]]['count']); unset($attr['count']); // save original attributes $this->attributes_orig = $attr; foreach ($modules as $module) { if (!isset($this->module[$module])) { $this->module[$module] = new $module($this->type); $this->module[$module]->init($this->base); } $this->module[$module]->load_attributes($attr); } // sort module buttons $this->sortModules(); return 0; } /** * This function will prepare the object for a new account. */ function new_account() { $this->isNewAccount = true; $modules = $_SESSION['config']->get_AccountModules($this->type); foreach ($modules as $module) { $this->module[$module] = new $module($this->type); $this->module[$module]->init($this->base); } // sort module buttons $this->sortModules(); $profile = loadAccountProfile('default', $this->type); // pass profile to each module $modules = array_keys($this->module); foreach ($modules as $module) $this->module[$module]->load_profile($profile); if (isset($profile['ldap_rdn'][0])) { if (in_array($profile['ldap_rdn'][0], getRDNAttributes($this->type))) { $this->rdn = $profile['ldap_rdn'][0]; } } if (isset($profile['ldap_suffix'][0])) { $this->dn = $profile['ldap_suffix'][0]; } return 0; } /** * This function will save an account to the LDAP database. * * @return array list of status messages if any errors occured */ function save_account() { $module = array_keys ($this->module); $attributes = array(); // load attributes foreach ($module as $singlemodule) { // load changes $temp = $this->module[$singlemodule]->save_attributes(); // merge changes $DNs = array_keys($temp); // *** fixme don't include references if (is_array($temp)) $attributes = array_merge_recursive($temp, $attributes); for ($i=0; $irdn; $added = false; foreach ($attributes as $DN) { if (isset($DN['modify'][$search][0]) && !$added) { $attributes[$search.'='.$DN['modify'][$search][0].','.$this->dn] = $attributes[$this->dn]; unset ($attributes[$this->dn]); $this->dn = $search.'='.$DN['modify'][$search][0].','.$this->dn; $added = true; } if (isset($DN['add'][$search][0]) && !$added) { $attributes[$search.'='.$DN['add'][$search][0].','.$this->dn] = $attributes[$this->dn]; unset ($attributes[$this->dn]); $this->dn = $search.'='.$DN['add'][$search][0].','.$this->dn; $added = true; } if (isset($DN['notchanged'][$search][0]) && !$added) { $attributes[$search.'='.$DN['notchanged'][$search][0].','.$this->dn] = $attributes[$this->dn]; unset ($attributes[$this->dn]); $this->dn = $search.'='.$DN['notchanged'][$search][0].','.$this->dn; $added = true; } } // Add old dn if dn hasn't changed if (!$added) { $attributes[$this->dn_orig] = $attributes[$this->dn]; unset ($attributes[$this->dn]); $this->dn = $this->dn_orig; } // Set to true if an real error has happened $stopprocessing = false; // Add new DN if (isset($attributes[$DNs[$i]]['errors'])) { foreach ($attributes[$DNs[$i]]['errors'] as $singleerror) { $errors[] = $singleerror; if ($singleerror[0] == 'ERROR') $stopprocessing = true; } } // fixme *** ad update_cache after every ldap-change if (!$stopprocessing) { if ($this->dn != $this->dn_orig) { // move existing DN if ($this->dn_orig!='') { // merge attributes together $attr = array(); if (is_array($attributes[$this->dn]['add'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['add']); if (is_array($attributes[$this->dn]['notchanged'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['notchanged']); if (is_array($attributes[$this->dn]['modify'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['modify']); // add attributes which are not controlled by modules from original account $attrNames = array_keys($this->attributes_orig); for ($i = 0; $i < sizeof($attrNames); $i++) { if (!isset($attr[$attrNames[$i]])) $attr[$attrNames[$i]] = $this->attributes_orig[$attrNames[$i]]; } $success = ldap_add($_SESSION['ldap']->server(), $this->dn, $attr); if ($success) { //$_SESSION['cache']->update_cache($this->dn, 'add', $attr); TODO: reactivate $success = ldap_delete($_SESSION['ldap']->server(), $this->dn_orig); if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to delete DN: %s.'), $this->dn_orig), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } //if ($success) TODO: reactivate //$_SESSION['cache']->update_cache($this->dn, 'delete_dn'); TODO: reactivate } if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to create DN: %s.'), $this->dn), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } } // create complete new dn else { $attr = array(); if (is_array($attributes[$this->dn]['add'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['add']); if (is_array($attributes[$this->dn]['notchanged'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['notchanged']); if (is_array($attributes[$this->dn]['modify'])) $attr = array_merge_recursive($attr, $attributes[$this->dn]['modify']); $success = ldap_add($_SESSION['ldap']->server(), $this->dn, $attr); if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to create DN: %s.'), $this->dn), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } //else TODO: reactivate //$_SESSION['cache']->update_cache($this->dn, 'add', $attr); TODO: reactivate } unset($attributes[$this->dn]); } } $DNs = array_keys($attributes); for ($i=0; $iserver(), $DNs[$i], $attributes[$DNs[$i]]['modify']); if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to modify attribtues from DN: %s.'), $DNs[$i]), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } //else TODO: reactivate //$_SESSION['cache']->update_cache($this->dn, 'modify', $attributes[$this->dn]['modify']); TODO: reactivate } // add attributes if (isset($attributes[$DNs[$i]]['add']) && !$stopprocessing) { $success = @ldap_mod_add($_SESSION['ldap']->server(), $DNs[$i], $attributes[$DNs[$i]]['add']); if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to add attribtues to DN: %s.'), $DNs[$i]), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } //else TODO: reactivate //$_SESSION['cache']->update_cache($this->dn, 'add', $attributes[$this->dn]['add']); TODO: reactivate } // removce attributes if (isset($attributes[$DNs[$i]]['remove']) && !$stopprocessing) { $success = @ldap_mod_del($_SESSION['ldap']->server(), $DNs[$i], $attributes[$DNs[$i]]['remove']); if (!$success) { $errors[] = array('ERROR', sprintf(_('Was unable to remove attribtues from DN: %s.'), $DNs[$i]), ldap_error($_SESSION['ldap']->server())); $stopprocessing = true; } //else TODO: reactivate //$_SESSION['cache']->update_cache($this->dn, 'remove', $attributes[$this->dn]['remove']); TODO: reactivate } } } if (!$stopprocessing) { foreach ($attributes as $DN) { if (is_array($DN['lamdaemon']['command'])) $result = lamdaemon($DN['lamdaemon']['command']); // Error somewhere in lamdaemon if (is_array($result)) foreach ($result as $singleresult) { if (is_array($singleresult)) { if ($singleresult[0] == 'ERROR') $stopprocessing = true; $temparray[0] = $singleresult[0]; $temparray[1] = _($singleresult[1]); $temparray[2] = _($singleresult[2]); $errors[] = $temparray; } } } } $_SESSION['cache']->refresh_cache(true); // TODO: remove when update_cache is fixed if (count($errors)!=0) return $errors; return 0; } /** * Returns a list of possible PDF entries for this account. * * @return list of PDF entries (array( => )) */ function get_pdfEntries() { $return = array(); while(($current = current($this->module)) != null) { $return = array_merge($return,$current->get_pdfEntries($this->type)); next($this->module); } $return = array_merge($return,array('main_dn' => array('' . _('DN') . '' . $this->dn . ''))); return $return; } /** * Sorts the module buttons for the account page. */ function sortModules() { $order = array(); $modules = array_keys($this->module); $depModules = array(); for ($i = 0; $i < sizeof($modules); $i++) { // insert waiting modules for ($w = 0; $w < sizeof($depModules); $w++) { $dependencies = $this->module[$depModules[$w]]->get_dependencies($this->type); $dependencies = $dependencies['depends']; $everything_found = true; for ($d = 0; $d < sizeof($dependencies); $d++) { if (!in_array($dependencies[$d], $order)) { $everything_found = false; break; } } // inser after depending module if ($everything_found) { $order[] = $depModules[$w]; unset($depModules[$w]); $depModules = array_values($depModules); $w--; } } // check next module $dependencies = $this->module[$modules[$i]]->get_dependencies($this->type); if (is_array($dependencies['depends'])) { $everything_found = true; $dependencies = $dependencies['depends']; for ($d = 0; $d < sizeof($dependencies); $d++) { if (!in_array($dependencies[$d], $order)) { $everything_found = false; break; } } // remove module if dependencies are not satisfied if (!$everything_found) { $depModules[] = $modules[$i]; unset($modules[$i]); $modules = array_values($modules); $i--; } else { $order[] = $modules[$i]; } } else { $order[] = $modules[$i]; } } // add modules which could not be sorted (e.g. because of cyclic dependencies) if (sizeof($depModules) > 0) { for ($i = 0; $i < sizeof($depModules); $i++) $order[] = $depModules[$i]; } array_unshift($order, 'main'); $this->order = $order; } /** * Encrypts sensitive data before storing in session. * * @return array list of attributes which are serialized */ function __sleep() { // encrypt data $this->attributes = $_SESSION['ldap']->encrypt(serialize($this->attributes)); $this->attributes_orig = $_SESSION['ldap']->encrypt(serialize($this->attributes_orig)); $this->module = $_SESSION['ldap']->encrypt(serialize($this->module)); // save all attributes return array_keys(get_object_vars($this)); } /** * Decrypts sensitive data after accountContainer was loaded from session. */ function __wakeup() { // decrypt data $this->attributes = unserialize($_SESSION['ldap']->decrypt($this->attributes)); $this->attributes_orig = unserialize($_SESSION['ldap']->decrypt($this->attributes_orig)); $this->module = unserialize($_SESSION['ldap']->decrypt($this->module)); } } ?>