![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/html/helpviewer.php b/html/helpviewer.php
index 8c024a9699b65429e9c93ac0d9e295d635e3510b..d515328546dc2d6156f9bf35b8506f45daffc8af 100644 (file)
--- a/html/helpviewer.php
+++ b/html/helpviewer.php
<?php
/*
This code is part of GOsa (https://gosa.gonicus.de)
- Copyright (C) 2003 Cajus Pollmeier
+ Copyright (C) 2003 Cajus Pollmeier, Fabian Hickert
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
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
-/* Basic setup, remove eventually registered sessions */
-require_once ("../include/php_setup.inc");
-require_once ("../include/functions.inc");
-session_start ();
-error_reporting(E_ALL);
-/* Logged in? Simple security check */
-if (!isset($_SESSION['ui'])){
- gosa_log ("Error: helpviewer.php called without session");
- echo "<b>"._("Help is not available if you are not logged in.")."</b>";
- exit;
-}
+/* Include classes and configs */
+@require_once ("../include/php_setup.inc");
+@require_once ("functions.inc");
+@require_once ("functions_helpviewer.inc");
-
-/* Set template compile directory */
+error_reporting(0);
+header("Content-type: text/html; charset=UTF-8");
+session_start();
$config= $_SESSION['config'];
-if (isset ($config->data['MAIN']['COMPILE'])){
- $smarty->compile_dir= $config->data['MAIN']['COMPILE'];
-} else {
- $smarty->compile_dir= '/var/spool/gosa/';
+
+/* If no config object is found in the session, abort help */
+if (!isset($_SESSION['config'])){
+ gosa_log ("main.php called without session");
+ header ("Location: index.php");
+ exit;
}
/* Language setup */
} else {
$lang= $config->data['MAIN']['LANG'];
}
+
+if(isset($_SESSION['ui']->language)){
+ $lang = $_SESSION['ui']->language;
+}
+
$lang.=".UTF-8";
putenv("LANGUAGE=");
putenv("LANG=$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'];
-
-/*
-##################
-My PART ^^
-##################
-
- */
-//set_error_handler("myone");
-$helpdir = "../doc/guide/admin/en/manual_gosa_en/";
-$defaultpage = "index.html";
-$prefix = "node";
-$suffix = ".html";
-$maxresults = 10;
-
-function myone($par1,$par2,$par3,$par3)
-{
- print "<br>Seite : ".$par1."<br>Name : ".$par2."<br>Seite : ".$par3."<br>Zeile : ".$par3;
+$config= $_SESSION['config'];
+if (isset ($config->data['MAIN']['COMPILE'])){
+ $smarty->compile_dir= $config->data['MAIN']['COMPILE'];
+} else {
+ $smarty->compile_dir= '/var/spool/gosa/';
}
-/* Define which tags musst be delete, header, navigation, banner */
-$i=0;
-$replacements=array();
-$replacements['range'][$i]['from'] = "/<!DOC.*<BODY >/";
-$replacements['range'][$i]['to'] = "";
-$i++;
-$replacements['range'][$i]['from'] = "@<DIV[^>]*?>.*?DIV>@si";
-$replacements['range'][$i]['to'] = "";
-$i++;
-$replacements['range'][$i]['from'] = "/<HR>/";
-$replacements['range'][$i]['to'] = "";
-$i++;
-$replacements['range'][$i]['from'] = "@<ADDRESS[^>]*?>.*?ADDRESS>@si";
-$replacements['range'][$i]['to'] = "";
-$i++;
-$replacements['range'][$i]['from'] = "/<\/BODY.*>/";
-$replacements['range'][$i]['to'] = "";
-$i++;
-
-/* Bsp . : Replace Table Head to specified tableheader */
-$replacements['range'][$i]['from'] = "@<TABLE[^>]*?>.*?>@si";
-$replacements['range'][$i]['to'] = "<table border=0 cellspacing=1 bgcolor=\"#999999\" width=\"95%\" align=\"center\" >" ;
-
-/* Default pages */
-$backward ="index.html";
-$index ="index.html";
-$forward ="node1.html";
-
-/*
- Here it begins, the real function, above only definitions
+/* HELP management starts here ...
*/
-$smarty->assign("search_string","");
-
-
-if(isset($_POST['search'])){
-
- $keyword = $_POST['search_string'];
-
- $arr = readfiles($helpdir,$prefix,$suffix,false,$singlepage=false);
-
- $res = search($arr,$keyword);
-
- $smarty->assign("backward",$backward);
- $smarty->assign("index" ,$index);
- $smarty->assign("forward" ,$forward);
-
-
- $smarty->assign("search_string",$keyword);
-
- $smarty->assign("help_contents",searchlist($arr,$res,$maxresults));
-
- $header= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
- $display= $header.$smarty->fetch(get_template_path('help.tpl'));
- echo $display;
-
-
+/* Generate helpobject */
+if(isset($_SESSION['helpobject'])){
+ $helpobject = $_SESSION['helpobject'];
}else{
-
- /* Read all files, prepare to serach */
- $helppages = readfiles("../doc/guide/admin/en/manual_gosa_en/",$prefix,true,$suffix);
-
- if(isset($_GET['pg'])){
- $page = $_GET['pg'];
- }
-
- if((!isset($helppages[$page]))&&($page!="index.html"))
- {
- print "Requested helppage is unknown, redirekted to index";
- $page = $defaultpage;
- }
-
- /* Check forward backward, funtionality*/
- if($page != $defaultpage)
- {
- /* Extract Number of node page */
- $number = str_replace($prefix,"",str_replace($suffix,"",$page));
-
- /* Check if we can switch forward and/or backward*/
- $bck = $prefix.($number-1).$suffix;
- $fck = $prefix.($number+1).$suffix;
-
- /* backward page exists ?, so allow it*/
- if((isset($helppages[$bck]))) {
- $backward = $bck;
- }
-
- /* forward exists ?*/
- if((isset($helppages[$fck]))) {
- $forward = $fck;
- }
- }
-
- $help_contents=readfiles($helpdir,$prefix,$suffix,false,$page);
-
- /* Mark last searched words */
- if($_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);
- }
-
-
- $smarty->assign("help_contents",$help_contents);
-
- /* Define our own navigation pages */
- $smarty->assign("backward",$backward);
- $smarty->assign("index" ,$index);
- $smarty->assign("forward" ,$forward);
-
- /* Fill page */
- $header= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
- $display= $header.$smarty->fetch(get_template_path('help.tpl'));
- echo $display;
+ $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 > ...
-/*
- Only function definition will follow here
-/*
-
-
-
-/* Reads all files in specified directory with contents an some inforations about the file */
-function readfiles($basedir,$prefix,$suffix,$onlyIndex,$singlepage=false)
-{
- global $replacements;
-
- $str = array(); // Temporary variable
- $cnt = 0; // Array index creation
- $file = ""; // Contains Filename
-
- $dir = opendir($basedir);
-
- $str['global']['start'] = $cnt; // collect basic informations - Startpage
- $str['global']['basedir'] = $basedir; // collect basic informations - Basedirectory
+/* Default pages */
+$backward =$defaultpage;
+$index =$defaultpage;
+$forward ="node1.html";
- /* Startime for Benchmark */
- $start = (time()+microtime());
- if(!$singlepage) {
- while (($file = readdir($dir)) !== false) {
- if((strstr($file,".html"))&&($file!=".")&&($file!="..")&&(strstr($file,$prefix))){
- $str[$file]=array();
- $str[$file]['name'] = $file;
- $str[$file]['size'] = filesize($basedir.$file);
- if(!$onlyIndex){
- $str[$file]['content']= remove_unwanted_tags(linkwrapper(getcontents($basedir.$file),""),$replacements);
- }
- $str[$file]['stat'] = stat($basedir.$file);
- $cnt++;
- }
- }
- }else{
- $file = $singlepage;
- $str[$file]=array();
- $str[$file]['name'] = $file;
- $str[$file]['size'] = filesize($basedir.$file);
- if(!$onlyIndex){
- $str[$file]['content']= remove_unwanted_tags(linkwrapper(getcontents($basedir.$file),""),$replacements);
- }
- $str[$file]['stat'] = stat($basedir.$file);
+/* 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'])){
+
+ /* Create new XML parser with the path to the Xml file */
+ $xml = new parseXml("../doc/guide.xml");
+
+ /* Generate help array */
+ $str = $xml->parse();
+
+ /* __LANG__ is used as placeholder for the used language*/
+ $helpdir= preg_replace("/__LANG__/i",$lang,$str[($_SESSION['current_class_for_help'])]['PATH']);
+
+ /* If there is no entry in the xml file for this class, display an error message */
+ if($helpdir == ""){
+
+ $smarty->assign("help_contents","<br><h2>"._("There is no helpfile specified for this class."))."</h2>";
+ $header= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
+ $display= ( $header.$smarty->fetch(get_template_path('help.tpl')));
+ echo $display;
+ unset($_SESSION['current_class_for_help']);
+ exit();
}
-
- /* Create right order */
- asort($str);
- /* Endtime for Benchmark*/
- $end = (time()+microtime());
- $str['global']['cmptime'] = $end-$start;
- $str['global']['numpages']= $cnt;
- closedir($dir);
- return($str);
-}
-
-/* Read filecontent */
-function getcontents($file)
-{
- $str = "" ; // Temporary variable for file contents
- $tmp = "" ; // Temporary varibale for partitial file contents
- $fp = fopen($file,"r");
- if($fp) {
- while($tmp = fread($fp,512))
- {
- $str.= $tmp;
- }
- }else{
- return(false);
+
+ /* 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']);
}
- return($str);
-}
-function remove_unwanted_tags($str,$replacements)
-{
- $str=str_replace("\n","||WasBr||",$str);
- foreach($replacements['range'] as $var)
- {
- $str=preg_replace($var['from'],$var['to'],$str);
+}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= "";
}
-
- $str=str_replace("||WasBr||","\n",$str);
- return($str);
}
+/* 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'];
-/*Converts the all links to specified path, is needed to get simple navigation */
-function linkwrapper($str,$link)
-{
- $str=str_replace("HREF=\"","href=\"".$link."?pg=",$str);
- return($str);
-}
-
-
-
-function search($arr,$word)
-{
- /* Prepare Vars */
- $result =array(); // Search result, filename, + hits + hits per word + matches
- $words =array(); // Temporary searchword handling
- $useablewords =array(); // Temporary searchword handling
- $tryword = ""; // Temporary searchword handling
- $result['global']['maxhit'] = 0;
- unset($_SESSION['lastresults']);
-
- /* prepare searchwords */
- $word = trim($word);
-
- /* Filter all unusable chars */
- $word = preg_replace("[^a-z0-9_+% ]","",$word);
- $words = split(" ",str_replace("+"," ",$word));
-
- /* Check all wordlengths */
- foreach($words as $tryword){
- $tryword = trim($tryword);
- if(strlen($tryword)>=3) {
- $useablewords[]=$tryword;
+ /* If empty, force displaying the index */
+ if(empty($_GET['pg'])){
+ $helpobject['currentplug'] = "";
+ $helpobject['file'] = "index.html";
}
- }
+ /* Create new helpdir (The path where the requested page is located)*/
+ $helpdir = "../doc/guide/user/".$helpobject['lang']."/html/".preg_replace("/^.*\//i","",$helpobject['currentplug']);
- /* Use words to search the content */
- foreach($arr as $key=>$val)
- {
- $overallhits=0;
- foreach($useablewords as $word)
- {
- if($key!="global")
- {
- preg_match_all("/".$word."/i",$arr[$key]['content'], $matches,PREG_OFFSET_CAPTURE);
- $overallhits=$overallhits + count($matches[0]);
-
- $result[$key]['hits'][$word] = count($matches[0]);
- $result[$key]['hits']['overall']= $overallhits;
-
- if($overallhits > $result['global']['maxhit']){
- $result['global']['maxhit']=$overallhits;
- }
-
- $result[$key]['match'][$word]=array();
- $result[$key]['match'][$word]=$matches[0];
- }
+ /* If helpdir is empty, force index */
+ if(empty($helpobject['currentplug'])){
+ $helpdir= "";
}
}
- $_SESSION['lastresults'] = $result;
- return($result);
}
-/* Detect 10 Best result entries, sort and call createResultEntry to create HTML output for complete list */
-function searchlist($arr,$res,$maxresults)
-{
- $global = $res['global'];
- $topten = array(); // To detect 10 best solutions
- $ret = ""; // return value
- unset($res['global']);
-
- /* Detect 10 best Sites */
- foreach($res as $key=>$val){
- $topten[$key] = $val['hits']['overall'];
- }
-
- asort($topten);
- $topten = array_reverse($topten);
- $topten = (array_slice($topten,0,$maxresults));
+$helpdir.="/";
- /* We have a result, an array with all content, an array with hits and position of hits and we have the 10 best hits */
+/* Save current settings */
+$_SESSION['helpobject'] = $helpobject;
- /* Foreach */
- foreach($topten as $name => $hits)
- {
- $ret.= createResultEntry($arr[$name],$res[$name],$name,$global['maxhit']);
- }
- return($ret);
-}
-
-/* This function marks a string with the given search result for this string*/
-function markup_page($arr,$res)
-{
- $ret = ""; // return value
- $pre = "<b><u><i>" ;
- $suf = "</i></u></b>";
- $repl = array();
- $posadd = 0;
-
- foreach($res['match'] as $word => $matches) {
- foreach($matches as $matchnr=>$match) {
- $repl[$match[1]]=$match[0];
- }
- }
-
- ksort($repl);
-
- foreach($repl as $position=>$word) {
- $pos1 = strlen($arr);
- $arr= markword($arr,($position+$posadd),$word,$pre,$suf);
- $pos2 = strlen($arr);
- $posadd =$posadd + ($pos2 - $pos1);
- }
- return($arr);
-}
-
-/* This function marks a single word with the specified prefix and suffix */
-function markword($string,$position,$word,$prefix,$suffix)
-{
- $wordlength = strlen($word);
- $wholelength = strlen($string);
+/*
+ * Display management
+ */
- $first = substr($string,0,$position);
- $last = substr($string,($position+$wordlength),$wholelength);
+/* 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= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
- return($first.$prefix.$word.$suffix.$last);
-}
+ /* 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= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
+ /* 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;
-/* Creates HTML output for a single search result entry */
-function createResultEntry($entry,$res,$name,$max)
-{
+}elseif((is_dir($helpdir))&&($fp = opendir($helpdir))){
+
+ /* Readfile gets the content of the requested file,
+ * parse it, rework links images and so on */
+ $index = readfiles($helpdir,$prefix,$suffix,false,$helpobject['file']);
- $percentage = (int)(($res['hits']['overall'] / $max) * 100) ;
+ /* 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);
+ }
- $str = "<b><a href=\"?pg=".$name."&mark=1\">With ".$percentage."% hit in file ".$name."</a></b><br>" ;
- $str.= substr(strip_tags($entry['content']),0,200);
- $str.= "<hr>";
+ /* Display the help contents */
+ $smarty->assign("help_contents",$index[$helpobject['file']]['content']);
+ $header= "<!-- headers.tpl-->".$smarty->fetch(get_template_path('headers.tpl'));
+
+ /* 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;
- return($str);
+}else{
+
+ /* There was a file requested which actually doesn't exists */
+ $smarty->assign("help_contents","<h2>".sprintf(_("Helpdir '%s' is not accessible, can't read any helpfiles."),$helpdir))."</h2><br>";
+ $header= "<!-- headers.tpl-->".$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:
?>