X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=src%2Fhelp.php;h=f689c6d946df88eac5c77239eaf3ac93f4ee35ab;hb=e0495695509e5d8a0d9a37df24539483678d9e3c;hp=2b3d85dc95b1d46aaa51ecebedaa007a04453995;hpb=ca1a555ec28ffb361c1bf9f9843fa0fdb24db2e1;p=squirrelmail.git
diff --git a/src/help.php b/src/help.php
index 2b3d85dc..f689c6d9 100644
--- a/src/help.php
+++ b/src/help.php
@@ -1,118 +1,196 @@
-
-
\n";
-
-/**
- ** 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.
- **/
-
- if (file_exists("../help/$user_language/basic.hlp")) {
- include ("../help/$user_language/basic.hlp");
- } elseif(file_exists("../help/en/basic.hlp")) {
- echo "
";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/basic.hlp");
- } else {
- $nohelp = true;
- }
- if (file_exists("../help/$user_language/main_folder.hlp")) {
- include ("../help/$user_language/main_folder.hlp");
- } elseif(file_exists("../help/en/main_folder.hlp")) {
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/main_folder.hlp");
- } else {
- $nohelp = true;
- }
- if (file_exists("../help/$user_language/read_mail.hlp")) {
- include ("../help/$user_language/read_mail.hlp");
- } elseif(file_exists("../help/en/read_mail.hlp")) {
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/read_mail.hlp");
- } else {
- $nohelp = true;
- }
- if (file_exists("../help/$user_language/compose.hlp")) {
- include ("../help/$user_language/compose.hlp");
- } elseif(file_exists("../help/en/compose.hlp")) {
- echo "Your preferred language is not yet translated. English will be substituted here.
";
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/compose.hlp");
- } else {
- $nohelp = true;
- }
- if (file_exists("../help/$user_language/addresses.hlp")) {
- include ("../help/$user_language/addresses.hlp");
- } elseif(file_exists("../help/en/addresses.hlp")) {
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/addresses.hlp");
- } else {
- $nohelp = true;
- }
- if (file_exists("../help/$user_language/folders.hlp")) {
- include ("../help/$user_language/folders.hlp");
- } elseif(file_exists("../help/en/folders.hlp")) {
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/folders.hlp");
- } else {
- $nohelp = true;
+
+
+ displayPageHeader($color, "None");
+
+ $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";
+
+ /****************[ 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])) == "") {
+ $ary[1] = "";
+ for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != ""); $n++) {
+ $ary[1] .= $doc[$n];
+ }
+ }
+ if (trim(strtolower($doc[$n])) == "") {
+ $ary[2] = "";
+ for ($n++;$n < count($doc) && (trim(strtolower($doc[$n])) != ""); $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");
- } elseif(file_exists("../help/en/options.hlp")) {
- echo "";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo "
";
- include ("../help/en/options.hlp");
- } else {
- $nohelp = true;
+
+ /**************[ END HELP FUNCTIONS ]******************/
+
+?>
+
+
+
+
+
+
+
+";
- echo _("Your preferred language is not yet translated. English will be substituted here.");
- echo " ";
- include ("../help/en/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 "";
+ printf (_("The help has not been translated to %s. It will be displayed in English instead."), $languages[$squirrelmail_language]["NAME"]);
+ echo " ";
+ $user_language = "en";
} else {
- $nohelp = true;
+ $help_exists = false;
+ echo " ";
+ echo _("Some or all of the help documents are not present!");
+ echo "";
+ echo " |
";
+ exit;
}
-// If any of the standard help files aren't there, tell them.
+
+ 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($nohelp) {
- echo "
",_("ERROR: Some or all of the standard English help files ar missing."), "
";
- }
+ if (!isset($chapter)) {
+ echo "\n";
+ echo "" . _("Table of Contents") . " ";
+ do_hook("help_chapter");
+ echo "\n";
+ for ($i=0; $i < count($helpdir); $i++) {
+ $doc = file("../help/$user_language/$helpdir[$i]");
+ $help_info = get_info($doc, 0);
+ echo "- $help_info[0]\n";
+ echo "";
+ }
+ echo "
\n";
+ echo " |
\n";
+ } else {
+ $doc = file("../help/$user_language/".$helpdir[$chapter-1]);
+ $help_info = get_info($doc, 0);
+
+ echo "";
+ if ($chapter <= 1) echo ""._("Previous")." | ";
+ else echo ""._("Previous")." | ";
+ echo ""._("Table of Contents")."";
+ if ($chapter >= count($helpdir)) echo " | "._("Next")."";
+ else echo " | "._("Next")."\n";
+ echo "
\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 "";
+ echo "$help_info[1]";
+ echo "
";
+ $n = $help_info[3];
+ }
+
+ echo "
" . _("Top") . "\n";
+ }
+ }
+ do_hook("help_bottom");
?>
-
-