") { + $n++; + $ary[0] = trim($doc[$n]); + } + if (trim(strtolower($doc[$n])) == "<description>") { + $ary[1] = ""; + for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != "</description>"); $n++) { + $ary[1] .= $doc[$n]; + } + } + if (trim(strtolower($doc[$n])) == "<summary>") { + $ary[2] = ""; + for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != "</summary>"); $n++) { + $ary[2] .= $doc[$n]; + } + } + } + if (isset($ary)) { + $ary[3] = $n; + return $ary; + } else { + $ary[0] = "ERROR: Help files are not in the right format!"; + $ary[1] = "ERROR: Help files are not in the right format!"; + $ary[2] = "ERROR: Help files are not in the right format!"; + return $ary; + } + } + } + $ary[0] = "ERROR: Help files are not in the right format!"; + $ary[1] = "ERROR: Help files are not in the right format!"; + return $ary; } - if (file_exists("../help/$user_language/options.hlp")) { - include ("../help/$user_language/options.hlp"); - } else { - echo "<CENTER>Your preferred language is not yet translated. English will be substituted here.</CENTER> "; - include ("../help/en/options.hlp"); + + /**************[ END HELP FUNCTIONS ]******************/ + +?> + + +<table width=95% align=center cellpadding=2 cellspacing=2 border=0> +<tr><td bgcolor="<?php echo $color[0] ?>"> + <center><?php echo _("Help") ?></center> +</td></tr></table> + +<?php do_hook("help_top") ?> + +<table width=90% cellpadding=0 cellspacing=10 border=0 align=center><tr><td> +<?php + if ($HTTP_REFERER) { + $ref = strtolower($HTTP_REFERER); + if (strpos($ref, "src/compose")) + $context = "compose"; + else if (strpos($ref, "src/addr")) + $context = "address"; + else if (strpos($ref, "src/folders")) + $context = "folders"; + else if (strpos($ref, "src/options")) + $context = "options"; + else if (strpos($ref, "src/right_main")) + $context = "index"; + else if (strpos($ref, "src/read_body")) + $context = "read"; + else if (strpos($ref, "src/search")) + $context = "search"; } - if (file_exists("../help/$user_language/FAQ.hlp")) { - include ("../help/$user_language/FAQ.hlp"); + + if (!$squirrelmail_language) + $squirrelmail_language = "en"; + + if (file_exists("../help/$squirrelmail_language")) { + $help_exists = true; + $user_language = $squirrelmail_language; + } else if (file_exists("../help/en")) { + $help_exists = true; + echo "<center>"; + printf (_("The help has not been translated to %s. It will be displayed in English instead."), $languages[$squirrelmail_language]["NAME"]); + echo "</center> "; + $user_language = "en"; } else { - echo "<CENTER>Your preferred language is not yet translated. English will be substituted here.</CENTER> "; - include ("../help/en/FAQ.hlp"); + $help_exists = false; + echo " <center>"; + echo _("Some or all of the help documents are not present!"); + echo "</center>"; + echo "</td></tr></table>"; + exit; } + + if ($help_exists) { + if (! isset($context)) + $context = ''; + if ($context == "compose") + $chapter = 4; + else if ($context == "address") + $chapter = 5; + else if ($context == "folders") + $chapter = 6; + else if ($context == "options") + $chapter = 7; + else if ($context == "index") + $chapter = 2; + else if ($context == "read") + $chapter = 3; + else if ($context == "search") + $chapter = 8; + + if (!isset($chapter)) { + echo "<table cellpadding=0 cellspacing=0 border=0 align=center><tr><td>\n"; + echo "<center>" . _("Table of Contents") . "</center> "; + do_hook("help_chapter"); + echo "<ol>\n"; + for ($i=0; $i < count($helpdir); $i++) { + $doc = file("../help/$user_language/$helpdir[$i]"); + $help_info = get_info($doc, 0); + echo "<li><a href=\"../src/help.php?chapter=". ($i+1) ."\">$help_info[0]</a>\n"; + echo "<ul>$help_info[2]</ul>"; + } + echo "</ol>\n"; + echo "</td></tr></table>\n"; + } else { + $doc = file("../help/$user_language/".$helpdir[$chapter-1]); + $help_info = get_info($doc, 0); + + echo "<center>"; + + if ($chapter <= 1) echo ""._("Previous")." | "; + else echo "<a href=\"../src/help.php?chapter=".($chapter-1)."\">"._("Previous")."</a> | "; + echo "<a href=\"../src/help.php\">"._("Table of Contents")."</a>"; + if ($chapter >= count($helpdir)) echo " | "._("Next").""; + else echo " | <a href=\"../src/help.php?chapter=".($chapter+1)."\">"._("Next")."</a>\n"; + echo "</center> \n"; + echo "$chapter - $help_info[0] \n"; + if (isset($help_info[1])) + echo "$help_info[1]\n"; + else + echo "$help_info[2]\n"; + + $section = 0; + for ($n = $help_info[3]; $n < count($doc); $n++) { + $section++; + $help_info = get_info($doc, $n); + echo "$chapter.$section - $help_info[0]"; + echo "<ul>"; + echo "$help_info[1]"; + echo "</ul>"; + $n = $help_info[3]; + } + + echo " <center><a href=\"#pagetop\">" . _("Top") . "</a></center>\n"; + } + } + do_hook("help_bottom"); ?> - -</BODY> -</HTML> +<tr><td bgcolor="<?php echo $color[0] ?>"> </td></tr></table> +<td></tr></table> +</body></html>

X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=src%2Fhelp.php;h=f689c6d946df88eac5c77239eaf3ac93f4ee35ab;hb=e0495695509e5d8a0d9a37df24539483678d9e3c;hp=f3b06ca6342993483ed0bc0dad6df5902cebbe0d;hpb=e222c29037ef0a6207d42c6a30cc06bbdfb1770c;p=squirrelmail.git diff --git a/src/help.php b/src/help.php index f3b06ca6..f689c6d9 100644 --- a/src/help.php +++ b/src/help.php @@ -1,79 +1,196 @@ - - - \n"; + displayPageHeader($color, "None"); -/** - ** Check to see if the help files have been translated into the users language - ** If so, include them, if not, give them english. The po file should really have - ** The echo line put in it. - **/ + $helpdir[0] = "basic.hlp"; + $helpdir[1] = "main_folder.hlp"; + $helpdir[2] = "read_mail.hlp"; + $helpdir[3] = "compose.hlp"; + $helpdir[4] = "addresses.hlp"; + $helpdir[5] = "folders.hlp"; + $helpdir[6] = "options.hlp"; + $helpdir[7] = "search.hlp"; + $helpdir[8] = "FAQ.hlp"; - if (file_exists("../help/$user_language/basic.hlp")) { - include ("../help/$user_language/basic.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/basic.hlp"); - } - if (file_exists("../help/$user_language/main_folder.hlp")) { - include ("../help/$user_language/main_folder.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/main_folder.hlp"); - } - if (file_exists("../help/$user_language/read_mail.hlp")) { - include ("../help/$user_language/read_mail.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/read_mail.hlp"); - } - if (file_exists("../help/$user_language/compose.hlp")) { - include ("../help/$user_language/compose.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/compose.hlp"); - } - if (file_exists("../help/$user_language/addresses.hlp")) { - include ("../help/$user_language/addresses.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/addresses.hlp"); - } - if (file_exists("../help/$user_language/folders.hlp")) { - include ("../help/$user_language/folders.hlp"); - } else { - echo "Your preferred language is not yet translated. English will be substituted here.
"; - include ("../help/en/folders.hlp"); + /****************[ HELP FUNCTIONS ]********************/ + // parses through and gets the information from the different documents. + // this returns one section at a time. You must keep track of the position + // so that it knows where to start to look for the next section. + + function get_info($doc, $pos) { + for ($n=$pos; $n < count($doc); $n++) { + if (trim(strtolower($doc[$n])) == "" || trim(strtolower($doc[$n])) == "

") { + for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != "

") && (trim(strtolower($doc[$n])) != ""); $n++) { + if (trim(strtolower($doc[$n])) == "") { + $n++; + $ary[0] = trim($doc[$n]); + } + if (trim(strtolower($doc[$n])) == "<description>") { + $ary[1] = ""; + for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != "</description>"); $n++) { + $ary[1] .= $doc[$n]; + } + } + if (trim(strtolower($doc[$n])) == "<summary>") { + $ary[2] = ""; + for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != "</summary>"); $n++) { + $ary[2] .= $doc[$n]; + } + } + } + if (isset($ary)) { + $ary[3] = $n; + return $ary; + } else { + $ary[0] = "ERROR: Help files are not in the right format!"; + $ary[1] = "ERROR: Help files are not in the right format!"; + $ary[2] = "ERROR: Help files are not in the right format!"; + return $ary; + } + } + } + $ary[0] = "ERROR: Help files are not in the right format!"; + $ary[1] = "ERROR: Help files are not in the right format!"; + return $ary; } - if (file_exists("../help/$user_language/options.hlp")) { - include ("../help/$user_language/options.hlp"); - } else { - echo "<CENTER>Your preferred language is not yet translated. English will be substituted here.</CENTER> "; - include ("../help/en/options.hlp"); + + /**************[ END HELP FUNCTIONS ]******************/ + +?> + + +<table width=95% align=center cellpadding=2 cellspacing=2 border=0> +<tr><td bgcolor="<?php echo $color[0] ?>"> + <center><?php echo _("Help") ?></center> +</td></tr></table> + +<?php do_hook("help_top") ?> + +<table width=90% cellpadding=0 cellspacing=10 border=0 align=center><tr><td> +<?php + if ($HTTP_REFERER) { + $ref = strtolower($HTTP_REFERER); + if (strpos($ref, "src/compose")) + $context = "compose"; + else if (strpos($ref, "src/addr")) + $context = "address"; + else if (strpos($ref, "src/folders")) + $context = "folders"; + else if (strpos($ref, "src/options")) + $context = "options"; + else if (strpos($ref, "src/right_main")) + $context = "index"; + else if (strpos($ref, "src/read_body")) + $context = "read"; + else if (strpos($ref, "src/search")) + $context = "search"; } - if (file_exists("../help/$user_language/FAQ.hlp")) { - include ("../help/$user_language/FAQ.hlp"); + + if (!$squirrelmail_language) + $squirrelmail_language = "en"; + + if (file_exists("../help/$squirrelmail_language")) { + $help_exists = true; + $user_language = $squirrelmail_language; + } else if (file_exists("../help/en")) { + $help_exists = true; + echo "<center>"; + printf (_("The help has not been translated to %s. It will be displayed in English instead."), $languages[$squirrelmail_language]["NAME"]); + echo "</center> "; + $user_language = "en"; } else { - echo "<CENTER>Your preferred language is not yet translated. English will be substituted here.</CENTER> "; - include ("../help/en/FAQ.hlp"); + $help_exists = false; + echo " <center>"; + echo _("Some or all of the help documents are not present!"); + echo "</center>"; + echo "</td></tr></table>"; + exit; } + + if ($help_exists) { + if (! isset($context)) + $context = ''; + if ($context == "compose") + $chapter = 4; + else if ($context == "address") + $chapter = 5; + else if ($context == "folders") + $chapter = 6; + else if ($context == "options") + $chapter = 7; + else if ($context == "index") + $chapter = 2; + else if ($context == "read") + $chapter = 3; + else if ($context == "search") + $chapter = 8; + + if (!isset($chapter)) { + echo "<table cellpadding=0 cellspacing=0 border=0 align=center><tr><td>\n"; + echo "<center>" . _("Table of Contents") . "</center> "; + do_hook("help_chapter"); + echo "<ol>\n"; + for ($i=0; $i < count($helpdir); $i++) { + $doc = file("../help/$user_language/$helpdir[$i]"); + $help_info = get_info($doc, 0); + echo "<li><a href=\"../src/help.php?chapter=". ($i+1) ."\">$help_info[0]</a>\n"; + echo "<ul>$help_info[2]</ul>"; + } + echo "</ol>\n"; + echo "</td></tr></table>\n"; + } else { + $doc = file("../help/$user_language/".$helpdir[$chapter-1]); + $help_info = get_info($doc, 0); + + echo "<center>"; + + if ($chapter <= 1) echo ""._("Previous")." | "; + else echo "<a href=\"../src/help.php?chapter=".($chapter-1)."\">"._("Previous")."</a> | "; + echo "<a href=\"../src/help.php\">"._("Table of Contents")."</a>"; + if ($chapter >= count($helpdir)) echo " | "._("Next").""; + else echo " | <a href=\"../src/help.php?chapter=".($chapter+1)."\">"._("Next")."</a>\n"; + echo "</center> \n"; + echo "$chapter - $help_info[0] \n"; + if (isset($help_info[1])) + echo "$help_info[1]\n"; + else + echo "$help_info[2]\n"; + + $section = 0; + for ($n = $help_info[3]; $n < count($doc); $n++) { + $section++; + $help_info = get_info($doc, $n); + echo "$chapter.$section - $help_info[0]"; + echo "<ul>"; + echo "$help_info[1]"; + echo "</ul>"; + $n = $help_info[3]; + } + + echo " <center><a href=\"#pagetop\">" . _("Top") . "</a></center>\n"; + } + } + do_hook("help_bottom"); ?> - -</BODY> -</HTML> +<tr><td bgcolor="<?php echo $color[0] ?>"> </td></tr></table> +<td></tr></table> +</body></html>