X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=html%2Fhelpviewer.php;h=4cbc459abf94bd630ae888d5c414469b832aef5e;hb=4b0ae24d1609910eaaa03f2b5cd2fc0057c5f020;hp=e84e9e595ef87fa47a70161b99f1d8096c42406c;hpb=2d266e02f70cadc9489435639d390e15a593c684;p=gosa.git
diff --git a/html/helpviewer.php b/html/helpviewer.php
index e84e9e595..4cbc459ab 100644
--- a/html/helpviewer.php
+++ b/html/helpviewer.php
@@ -18,260 +18,254 @@
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
+/* Include classes and configs */
+@require_once ("../include/php_setup.inc");
+@require_once ("functions.inc");
+@require_once ("functions_helpviewer.inc");
-/* Basic setup, remove eventually registered sessions */
-require_once ("../include/php_setup.inc");
-require_once ("functions.inc");
-require_once ("functions_helpviewer.inc");
+error_reporting(E_ALL | E_STRICT);
+restore_error_handler();
+header("Content-type: text/html; charset=UTF-8");
-session_start ();
-error_reporting(E_ALL);
+session_start();
+$ui= $_SESSION["ui"];
+$config= $_SESSION['config'];
-/* Logged in? Simple security check */
-if (!isset($_SESSION['ui'])){
- gosa_log ("Error: helpviewer.php called without session");
- echo ""._("Help is not available if you are not logged in.")."";
+/* If no config object is found in the session, abort help */
+if (!isset($_SESSION['config'])){
+ new log("security","all/all","",array(),"Help viewer called without session") ;
+ header ("Location: index.php");
exit;
}
-/* Set template compile directory */
-$config= $_SESSION['config'];
-if (isset ($config->data['MAIN']['COMPILE'])){
- $smarty->compile_dir= $config->data['MAIN']['COMPILE'];
-} else {
- $smarty->compile_dir= '/var/spool/gosa/';
-}
-
/* Language setup */
if ($config->data['MAIN']['LANG'] == ""){
$lang= get_browser_language();
} else {
$lang= $config->data['MAIN']['LANG'];
}
+
$lang.=".UTF-8";
+
putenv("LANGUAGE=");
putenv("LANG=$lang");
setlocale(LC_ALL, $lang);
$GLOBALS['t_language']= $lang;
$GLOBALS['t_gettext_message_dir'] = $BASE_DIR.'/locale/';
-/* Set the text domain as 'messages' */
$domain = 'messages';
bindtextdomain($domain, "$BASE_DIR/locale");
textdomain($domain);
@DEBUG (DEBUG_TRACE, __LINE__, __FUNCTION__, __FILE__, $lang, "Setting language to");
-/* Get plugin list */
-$plist= $_SESSION['plist'];
+$config= $_SESSION['config'];
+if (isset ($config->data['MAIN']['COMPILE'])){
+ $smarty->compile_dir= $config->data['MAIN']['COMPILE'];
+} else {
+ $smarty->compile_dir= '/var/spool/gosa/';
+}
+$smarty->assign("title", "GOsa - "._("Help browser"));
-/*
-##################
-My PART ^^
-##################
+/* HELP management starts here ...
*/
-$helpdir = HELP_BASEDIR."/en/manual_gosa_en/"; // Folder to use for help files
+/* Generate helpobject */
+if(isset($_SESSION['helpobject'])){
+ $helpobject = $_SESSION['helpobject'];
+}else{
+ $helpobject['lang'] = $lang;
+ $helpobject['helpconf'] = array();
+ $helpobject['currentplug'] = "";
+ $helpobject['file'] = "index.html";
+ $helpobject['helpconf'] = $_SESSION['plist']->gen_headlines();
+}
+
+$lang = $lang[0].$lang[1];
+
+$helpobject['lang'] = $lang;
$defaultpage = "index.html"; // alternative file, shown on error, or on first call
$prefix = "node"; // Prefix of the generated help files
$suffix = ".html"; // Suffix of the generated helpfiles
$maxresults = 10; // max number of results shown in result list
$minwordlength = 3; // Word less than 3 chars will be dropped in search
$allowed_chars_in_searchword = "'[^a-z0-9 %_-]'i"; // Remove all chars that would disturb our search like < or > ...
-$pre_mark = "" ; // Sign words with this
-$suf_mark = ""; // and this
-$backwardlink = "
-
- ";
-
-$forwardlink = "
-
- ";
-
-$error_collector= "";
-set_error_handler('gosaRaiseError');
-
-/* Define which tags musst be delete, header, navigation, banner */
-$replacements=array();
-$replacements['from']=array("@@si",
- "@
]*?>.*?DIV>@si",
- "'
'",
- "/
/",
- "@]*?>.*?ADDRESS>@si",
- "@<\/BODY[^>]*?>.*?HTML>@si",
- "''",
- "/src.*icons/i",
- "//");
-$replacements['to']=array("",
- "",
- "",
- "",
- "",
- "",
- "
",
- "src=\"images",
- "");
-
/* Default pages */
$backward =$defaultpage;
$index =$defaultpage;
$forward ="node1.html";
-/*
- Here it begins, the real function, above only definitions
+$helpdir ="";
+/* Every class which is called within a tab, stores its name in the Session.
+ * If $_SESSION['current_class_for_help'] isset,
+ * get the helpfile specified in the xml file and display it.
+ * Unset this Session entry, to avoid displaying it again.
*/
+if(isset($_SESSION['current_class_for_help'])){
-if(!file_exists(HELP_BASEDIR."/en/manual_gosa_en/")){
- /* prevent php warning missing value ... or so*/
- $smarty->assign("backward","");
- $smarty->assign("index" ,"");
- $smarty->assign("forward" ,"");
- $smarty->assign("search_string","");
- $smarty->assign("help_contents","
".sprintf(_("Can't read any helpfiles from ' %s ', possibly there is no help available."),HELP_BASEDIR."/en/manual_gosa_en/"));
-
- /* Output html ...*/
- $header= "".$smarty->fetch(get_template_path('headers.tpl'));
- $display= $header.$smarty->fetch(get_template_path('help.tpl'));
- echo $display;
-
-}else{
-
- /* We prepare to search, all Document for the given keyword */
- if(isset($_POST['search'])){
-
- /* Get Keyword */
- $keyword = $_POST['search_string'];
-
- /* Save Keyword to be able to show last searched word in template */
- $_SESSION['search_string']= $keyword;
-
- /* Read all files with contents*/
- /* |Folder="/var/ww...",
- | |Fileprefix="node"
- | | |Filesuffix=".html"
- | | | |WithoutContent=false(This means : read content)
- | | | | |Singlepage=false(Means read all, if w want to read single, specify its filename)"*/
- $arr = readfiles($helpdir,$prefix,$suffix,false,$singlepage=false);
-
- /* Create Searchresult for our Keyword(s) */
- $res = search($arr,$keyword);
-
- /* Tell smarty which pages to use for backward forwa.. */
- $smarty->assign("backward","");
- $smarty->assign("index" ,$index);
- $smarty->assign("forward" ,"");
-
- /* Tell smarty the Keyword, to show it in the input field again */
- $smarty->assign("search_string",$keyword);
-
- /* Create result list */
- $smarty->assign("help_contents",searchlist($arr,$res,$maxresults));
+ /* Create new XML parser with the path to the Xml file */
+ $xml = new parseXml("../doc/guide.xml");
+
+ /* Generate help array */
+ $str = $xml->parse();
- /* show some errors */
- if (isset($_SESSION['errors'])){
- $smarty->assign("errors", $_SESSION['errors']);
- }
- if ($error_collector != ""){
- $smarty->assign("php_errors", $error_collector."");
- } else {
- $smarty->assign("php_errors", "");
- }
+ /* __LANG__ is used as placeholder for the used language*/
+ $helpdir= @preg_replace("/__LANG__/i",$lang,$str[($_SESSION['current_class_for_help'])]['PATH']);
- /* Output html ...*/
+ /* If there is no entry in the xml file for this class, display an error message */
+ if($helpdir == ""){
+
+ $smarty->assign("help_contents","
"._("There is no helpfile specified for this class"))."
";
$header= "".$smarty->fetch(get_template_path('headers.tpl'));
- $display= $header.$smarty->fetch(get_template_path('help.tpl'));
+ $display= ( $header.$smarty->fetch(get_template_path('help.tpl')));
echo $display;
+ unset($_SESSION['current_class_for_help']);
+ exit();
+ }
+
+ /* Save filename */
+ $helpobject['file']= $str[($_SESSION['current_class_for_help'])]['FILE'];
+
+ /* Save path to the file */
+ $helpobject['currentplug'] = $helpdir;
+
+ /* Avoid displaying the same help every time */
+ if(isset($_GET['pg'])){
+ unset($_SESSION['current_class_for_help']);
+ }
- /*
- Don't search, only show selected page
- */
+}elseif(isset($_GET['plug'])){
+ /* This displays helpfiles depending on the current $_GET[plug] */
+ $tmp = new pluglist($_SESSION['config'],NULL);
+ $path = $tmp->get_path($_GET['plug']);
+ $helpobject['currentplug'] = $path;
+ $helpobject['file'] = "index.html";
+ $helpdir = "../doc/guide/user/".$helpobject['lang']."/html/".preg_replace("/^.*\//i","",$helpobject['currentplug']);
+ if(empty($helpobject['currentplug'])){
+ $helpdir= "";
+ }
+}
+/* this Post var is set if another page is requested */
+if(isset($_GET['pg'])){
+
+ if(preg_match("/\//",$_GET['pg'])){
+ $arr = split("\/",$_GET['pg']);
+ $helpobject['currentplug'] = "../doc/guide/user/".$helpobject['lang']."/html/".$arr[0];
+ $helpdir = $helpobject['currentplug'];
+ $helpobject['file']= $arr[1];
}else{
+ /* PG should contain a filename */
+ $helpobject['file'] = $_GET['pg'];
- /* present last searched word(s)*/
- if(!isset($_SESSION['search_string'])){
- $_SESSION['search_string']="";
- }
-
-
- $smarty->assign("search_string",$_SESSION['search_string']);
-
- /* Read all files, prepare to serach */
- $helppages = readfiles($helpdir,$prefix,$suffix,true);
- /* Get transmitted page */
- if(isset($_GET['pg'])){
- $page = $_GET['pg'];
- }else{
- $page = $defaultpage;
+ /* If empty, force displaying the index */
+ if(empty($_GET['pg'])){
+ $helpobject['currentplug'] = "";
+ $helpobject['file'] = "index.html";
}
-
- /* test if this page exists, in our array of files */
- if((!isset($helppages[$page]))&&($page!=$defaultpage))
- {
- //print "Requested helppage is unknown, redirekted to index"; // For debugging only
- $page = $defaultpage;
+ /* Create new helpdir (The path where the requested page is located)*/
+ $helpdir = "../doc/guide/user/".$helpobject['lang']."/html/".preg_replace("/^.*\//i","",$helpobject['currentplug']);
+
+ /* If helpdir is empty, force index */
+ if(empty($helpobject['currentplug'])){
+ $helpdir= "";
}
+ }
+}
+$helpdir.="/";
- /* Check forward backward, funtionality*/
- if($page != $defaultpage)
- {
- /* Extract Number of node page */
- $number = str_replace($prefix,"",str_replace($suffix,"",$page));
+/* Save current settings */
+$_SESSION['helpobject'] = $helpobject;
- /* Check if we can switch forward and/or backward*/
- $bck = $prefix.($number-1).$suffix;
- $fck = $prefix.($number+1).$suffix;
+/*
+ * Display management
+ */
- /* backward page exists ?, so allow it*/
- if((isset($helppages[$bck]))) {
- $backward = $bck;
- }
+$files = array();
+$f = opendir($helpdir);
+while($file = readdir($f)){
+ $files[$file]=$file;
+}
- $forward = $fck;
- }
+/* Some replacements */
+$backwardlink = "
+
+ ";
+
+$forwardlink = "
+
+ ";
+
+
+$back = $for ="";
+if($helpobject['file'] == "index.html"){
+ $back = " ";
+ $for = sprintf($forwardlink, $prefix."1".$suffix);
+}else{
+ $current = preg_replace("/^".$prefix."/","",$helpobject['file']);
+ $current = preg_replace("/\.html$/","",$current);
+
+ if(isset($files[$prefix.($current+1).$suffix])) {
+ $for = sprintf($forwardlink, $prefix.($current+1).$suffix);
+ }
+ if(isset($files[$prefix.($current-1).$suffix])) {
+ $back = sprintf($backwardlink, $prefix.($current-1).$suffix);
+ }
+ if(($current-1) == 0){
+ $back = sprintf($backwardlink, "index.html");
+ }
+}
- $help_contents=readfiles($helpdir,$prefix,$suffix,false,$page);
- /* Mark last searched words */
- if(isset($_GET['mark'])){
- $marks = ($_SESSION['lastresults']) ;
- $help_contents = markup_page($help_contents[$page]['content'],$marks[$page]);
- $help_contents=remove_unwanted_tags($help_contents,$replacements);
- }else{
- $help_contents=remove_unwanted_tags($help_contents[$page]['content'],$replacements);
- }
+/* If there is no helpdir or file defined, display the index */
+if(isset($_POST['search'])){
+ $helpdir = "../doc/guide/user/".$helpobject['lang']."/html/";
+ /* read all available directories */
+ $index = readfiles($helpdir,$prefix,$suffix,false,false);
+ $smarty->assign("help_contents",((searchlist($index,search($index,$_POST['search_string']),10))));
+ $header= "".$smarty->fetch(get_template_path('headers.tpl'));
- $smarty->assign("help_contents",$help_contents);
+ /* I don't know why, but we must use utf8_encode to avoid dispplay errors */
+ $display= ( $header.$smarty->fetch(get_template_path('help.tpl')));
+ echo $display;
+}elseif(((empty($helpdir)))||($helpdir=="/")){
+ /* Generate Index and display it */
+ $smarty->assign("help_contents",genIndex());
+ $header= "".$smarty->fetch(get_template_path('headers.tpl'));
- /* Define our own navigation pages */
- if($page == $defaultpage){
- $smarty->assign("backward","");
- }else{
- $smarty->assign("backward",sprintf($backwardlink,$backward));
- }
- $smarty->assign("index" ,$index);
+ /* I don't know why, but we must use utf8_encode to avoid dispplay errors */
+ $display= utf8_encode( $header.$smarty->fetch(get_template_path('help.tpl')));
+ echo $display;
+
+}elseif((is_dir($helpdir))&&($fp = opendir($helpdir))){
- if(!(isset($helppages[$forward]))){
- $smarty->assign("forward","");
- }else{
- $smarty->assign("forward",sprintf($forwardlink,$forward));
- }
+ /* Readfile gets the content of the requested file,
+ * parse it, rework links images and so on */
+ $index = readfiles($helpdir,$prefix,$suffix,false,$helpobject['file']);
+
+ /* if this page is result from a search, mark the search strings */
+ if(isset($_GET['mark'])){
+ $matches = $_SESSION['lastresults'][preg_replace("/^.*\//i","",$helpobject['currentplug'])][$helpobject['file']];
+ $index[$helpobject['file']]['content'] = markup_page($index[$helpobject['file']]['content'],$matches);
+ }
- /* show some errors */
- if (isset($_SESSION['errors'])){
- $smarty->assign("errors", $_SESSION['errors']);
- }
- if ($error_collector != ""){
- $smarty->assign("php_errors", $error_collector."");
- } else {
- $smarty->assign("php_errors", "");
- }
+ /* Display the help contents */
+ $smarty->assign("help_contents",$index[$helpobject['file']]['content']);
+ $header= "".$smarty->fetch(get_template_path('headers.tpl'));
+
+ /* I don't know why, but we must use utf8_encode to avoid dispplay errors */
+ $smarty->assign("backward",$back);
+ $smarty->assign("forward" ,$for);
+ $display= utf8_encode( $header.$smarty->fetch(get_template_path('help.tpl')));
+ echo $display;
- /* Fill page */
- $header= "".$smarty->fetch(get_template_path('headers.tpl'));
- $display= $header.$smarty->fetch(get_template_path('help.tpl'));
- echo $display;
- }
+}else{
+
+ /* There was a file requested which actually doesn't exists */
+ $smarty->assign("help_contents","".sprintf(_("Helpdir '%s' is not accessible, can't read any helpfiles."),$helpdir))."
";
+ $header= "".$smarty->fetch(get_template_path('headers.tpl'));
+ $display= ( $header.$smarty->fetch(get_template_path('help.tpl')));
+ echo $display;
}
// vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
?>