<?php
namespace LAM\HELP;
/*

  This code is part of LDAP Account Manager (http://www.ldap-account-manager.org/)
  Copyright (C) 2003 - 2006  Michael Duergner
                2008 - 2018  Roland Gruber

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


  LDAP Account Manager display help pages.
*/

/**
 * LDAP Account Manager help page.
 *
 * @author Michael Duergner
 * @author Roland Gruber
 * @package Help
 */

/** LDAP connection */
include_once(__DIR__ . "/../lib/ldap.inc");

/** configuration */
include_once(__DIR__ . "/../lib/config.inc");

/** self service functions */
include_once(__DIR__ . "/../lib/selfService.inc");
if (!empty($_GET['selfService']) && ($_GET['selfService'] === '1')) {
	session_name('SELFSERVICE');
}

if (strtolower(session_module_name()) == 'files') {
	session_save_path("../sess");
}
lam_start_session();

/** status messages */
include_once(__DIR__ . "/../lib/status.inc");

setlanguage();

/** help data */
include_once(__DIR__ . "/../help/help.inc"); // Include help/help.inc which provides $helpArray where the help pages are stored


/**
 * Print HTML header of the help page.
 */
function echoHTMLHead() {
	echo $_SESSION['header'];
	$title = "LDAP Account Manager Help";
	printHeaderContents($title, '..');
	?>
		</head>
		<body class="admin">
	<?php
	// include all JavaScript files
	printJsIncludes('..');
}

/**
 * Print HTML footer of the help page.
 */
function echoHTMLFoot() {
	?>
		</body>
	</html>
	<?php
}

/**
 * Print help site for a specific help number.
 *
 * @param array The help entry that is to be displayed.
 */
function displayHelp($helpEntry) {
	echoHTMLHead();
	echo "<h1 class=\"help\">" . $helpEntry['Headline'] . "</h1>\n";
	$format = "<p class=\"help\">" . $helpEntry['Text'] . "</p>\n";
	if (isset($helpEntry['attr'])) {
		$format .= '<br><hr>' . _('Technical name') . ': <i>' . $helpEntry['attr'] . '</i>';
	}
	echo $format;
	if(isset($helpEntry['SeeAlso']) && is_array($helpEntry['SeeAlso'])) {
		echo '<p class="help">' . _('See also') . ': <a class="helpSeeAlso" href="' . $helpEntry['SeeAlso']['link'] . '">' . $helpEntry['SeeAlso']['text'] . '</a></p>';
	}
	echoHTMLFoot();
}

/* If no help number was submitted print error message */
if (!isset($_GET['HelpNumber'])) {
	$errorMessage = "Sorry no help number submitted.";
	echoHTMLHead();
	statusMessage("ERROR", "", $errorMessage);
	echoHTMLFoot();
	exit;
}

$helpEntry = array();

// module help
if(isset($_GET['module']) && !($_GET['module'] == 'main') && !($_GET['module'] == '')) {
	include_once(__DIR__ . "/../lib/modules.inc");
	if (isset($_GET['scope'])) {
		$helpEntry = getHelp($_GET['module'],$_GET['HelpNumber'],$_GET['scope']);
	}
	else {
		$helpEntry = getHelp($_GET['module'],$_GET['HelpNumber']);
	}
	if (!$helpEntry) {
		$variables = array(htmlspecialchars($_GET['HelpNumber']), htmlspecialchars($_GET['module']));
		$errorMessage = _("Sorry this help id ({bold}%s{endbold}) is not available for this module ({bold}%s{endbold}).");
		echoHTMLHead();
		statusMessage("ERROR", "", $errorMessage, $variables);
		echoHTMLFoot();
		exit;
	}
}
// help entry in help.inc
else {
	/* If submitted help number is not in help/help.inc print error message */
	if (!array_key_exists($_GET['HelpNumber'],$helpArray)) {
		$variables = array(htmlspecialchars($_GET['HelpNumber']));
		$errorMessage = _("Sorry this help number ({bold}%s{endbold}) is not available.");
		echoHTMLHead();
		statusMessage("ERROR", "", $errorMessage, $variables);
		echoHTMLFoot();
		exit;
	}
	else {
		$helpEntry = $helpArray[$_GET['HelpNumber']];
	}
}

displayHelp($helpEntry);

?>
