File:
[LON-CAPA] /
loncom /
interface /
lonhelpmenu.pm
Revision
1.39:
download - view:
text,
annotated -
select for diffs
Tue Nov 10 19:13:00 2009 UTC (14 years, 10 months ago) by
jms
Branches:
MAIN
CVS tags:
version_2_9_99_0,
version_2_10_X,
version_2_10_1,
version_2_10_0_RC2,
version_2_10_0_RC1,
version_2_10_0,
loncapaMITrelate_1,
language_hyphenation_merge,
language_hyphenation,
bz6209-base,
bz6209,
PRINT_INCOMPLETE_base,
PRINT_INCOMPLETE,
HEAD,
GCI_3,
BZ4492-merge,
BZ4492-feature_horizontal_radioresponse
New "Help Settings" page added to Domain Settings, with ability to turn the "Submit a bug" link on or off in the help menu
1: # The LearningOnline Network with CAPA
2: # generate frame-based help system
3: #
4: # $Id: lonhelpmenu.pm,v 1.39 2009/11/10 19:13:00 jms Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28:
29: package Apache::lonhelpmenu;
30:
31: use strict;
32: use lib qw(/home/httpd/lib/perl);
33: use Apache::Constants qw(:common);
34: use Apache::loncommon();
35: use Apache::lonlocal;
36: use Apache::lonnet;
37: use lib '/home/httpd/lib/perl/';
38: use LONCAPA;
39:
40: sub handler {
41: my ($r) = @_;
42: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['page','faq','bug','topic','component_help','origurl','stayonpage']);
43: &Apache::loncommon::content_type($r,'text/html');
44: $r->send_http_header;
45:
46: if ($r->header_only) {
47: return OK;
48: }
49: my $faq = $env{'form.faq'};
50: my $bug = $env{'form.bug'};
51: my $topic = $env{'form.topic'};
52: my $component_help = $env{'form.component_help'};
53: my $origurl = $env{'form.origurl'};
54: my $stayOnPage = $env{'form.stayonpage'};
55: my $component_url = $component_help;
56: if ($component_url) {
57: $component_url = '/adm/help/'.$component_url.'.hlp';
58: }
59: my $bugurl = $Apache::lonnet::perlvar{'BugzillaHost'};
60: $bugurl .= 'enter_bug.cgi?product=LON-CAPA&bug_file_loc='.$origurl;
61: if ($bug) {
62: $bugurl .= '&component='.$bug;
63: }
64: my $faqbaseurl = $Apache::lonnet::perlvar{'FAQHost'};
65: my $requestmail = $Apache::lonnet::perlvar{'lonSupportEMail'};
66: if ($env{'form.page'} eq 'banner') {
67: &display_help_banner($r,$faq,$bug,$topic,$component_url,$origurl,$bugurl,$faqbaseurl,$requestmail,$stayOnPage);
68: } elsif ($env{'form.page'} eq 'body') {
69: &display_help_mainpage($r,$faq,$bug,$topic,$component_url,$origurl,$bugurl,$faqbaseurl,$requestmail);
70: }
71: return OK;
72: }
73:
74: sub display_help_banner {
75: my ($r,$faq,$bug,$topic,$component_url,$origurl,$bugurl,$faqbaseurl,$requestmail,$stayOnPage) = @_;
76: my $location=&Apache::loncommon::lonhttpdurl("/adm");
77: my $dom = $env{'request.role.domain'};
78: my %helpconfig = &Apache::lonnet::get_dom('configuration',['helpsettings'],$dom);
79: my $scripttag = '';
80: if ($requestmail =~ m/^[^\@]+\@[^\@]+$/) {
81: my $displayurl = &escape($origurl);
82: $scripttag = (<<"SCRIPT_ONE");
83: <script>
84: function gohelpdesk() {
85: var actiontype = null;
86: try {
87: actiontype = parent.bodyframe.document.logproblem.action.value;
88: }
89: catch(error) {
90: parent.bodyframe.location = "/adm/support?origurl=$displayurl";
91: return;
92: }
93: if (actiontype) {
94: var loc = parent.bodyframe.location.href;
95: if (loc.indexOf("/adm/support") > -1) {
96: if (parent.bodyframe.document.logproblem.action.value == "process") {
97: if (validmail(parent.bodyframe.document.logproblem.email) == false) {
98: alert("The e-mail address you entered: "+parent.bodyframe.document.logproblem.email.value+" is not a valid e-mail address.");
99: return;
100: }
101: parent.bodyframe.document.logproblem.submit();
102: return;
103: }
104: }
105: parent.bodyframe.location = "/adm/support?origurl=$displayurl";
106: return;
107: }
108: }
109: SCRIPT_ONE
110: $scripttag .= (<<'SCRIPT_TWO');
111: function validmail(field) {
112: var str = field.value;
113: if (window.RegExp) {
114: var reg1str = "(@.*@)|(\\.\\.)|(@\\.)|(\\.@)|(^\\.)";
115: var reg2str = "^.+\\@(\\[?)[a-zA-Z0-9\\-\\.]+\\.([a-zA-Z]{2,3}|[0-9]{1,3})(\\]?)$"; //"
116: var reg1 = new RegExp(reg1str);
117: var reg2 = new RegExp(reg2str);
118: if (!reg1.test(str) && reg2.test(str)) {
119: return true;
120: }
121: return false;
122: }
123: else
124: {
125:
126: if(str.indexOf("@") >= 0) {
127: return true;
128: }
129: return false;
130: }
131: }
132: </script>
133: SCRIPT_TWO
134: }
135:
136: my %body_layout =
137: ('rightmargin' => "0",
138: 'leftmargin' => "0",
139: 'marginwidth' => "0",
140: 'topmargin' => "1",
141: 'marginheight' => "1");
142: my $start_page =
143: &Apache::loncommon::start_page('',$scripttag,
144: {'add_entries' => \%body_layout,
145: 'only_body' => 1,});
146: $r->print($start_page);
147:
148: my $width = ($stayOnPage) ? '95%' : '600';
149: $r->print('<table id="LC_helpmenu" width="'.$width.'">');
150:
151: my $general_help = &Apache::loncommon::general_help();
152: $r->print(<<END);
153: <tr height="50">
154: <td width='5'> </td>
155: <td>
156: <fieldset><legend><img src="$location/lonIcons/minilogo.gif" height='20' width='29' valign='bottom' /> LON-CAPA help/support</legend>
157: <table id="LC_helpmenu_links">
158: <tr>
159: <td><span class="LC_nobreak"><a href="/adm/help/$general_help.hlp" target="bodyframe">
160: <img src="$location/help/help.png" border="0" alt="(General help)" valign="middle" /> General Help</a> </span></td>
161: END
162: if ($component_url) {
163: $r->print("<td><span class=\"LC_nobreak\"><a href=\"$component_url\" target=\"bodyframe\">".
164: '<img src="'.$location.'/help/help.png" border="0" alt="(Topic help)" valign="middle" /> '.$topic.'</a> </span></td>');
165: }
166: if ($requestmail =~ m/^[^\@]+\@[^\@]+$/) {
167: $r->print('
168: <td><span class="LC_nobreak"> <a href="javascript:gohelpdesk()"><img src="'.$location.'/lonIcons/helpdesk.gif" border="0" alt="(Ask helpdesk)" valign="middle" /> Ask helpdesk</a> </span></td>');
169: }
170: if ($faq && $env{'user.adv'}) {
171: $r->print(<<END);
172: <td><span class="LC_nobreak"> <a href="$faqbaseurl/fom/cache/$faq.html" target="bodyframe"><img src="$location/lonMisc/smallFAQ.gif" border="0" alt="(FAQ)" valign="middle" /> FAQ</a> </span>
173: </td>
174: END
175: }
176: if ($env{'user.adv'}) {
177: if ($helpconfig{'helpsettings'}{'submitbugs'} eq '1' ||
178: $helpconfig{'helpsettings'}{'submitbugs'} eq '' ) {
179: $r->print(<<END);
180: <td><span class="LC_nobreak" <b><a href="$bugurl" target="bodyframe"><img src="$location/lonMisc/smallBug.gif" border="0" alt="(Report a bug)" valign="middle" /> Report a bug</a> </b></span></td>
181: END
182: }
183: }
184: if ($stayOnPage) {
185: $r->print(<<END);
186: <td><span class="LC_nobreak"> <a href="$origurl" target="_top"><img src="$location/lonIcons/move_up.gif" border="0" alt="(Return to last location)" valign="middle" /> Return to last location</a> </span></td>
187: END
188: } else {
189: $r->print(<<END);
190: <td><span class="LC_nobreak" <a href="javascript:window.close()" target="_top"><img src="$location/lonIcons/closepage.gif" border="0" alt="(Close window)" valign="bottom" /> Close</a> </span></td>
191: END
192: }
193: $r->print(<<END);
194: </tr>
195: </table>
196: </fieldset>
197: </td>
198: <td width='100%'> </td>
199: </tr>
200: <tr height='5'>
201: <td colspan='3' height='5'> </td>
202: </tr>
203: </table>
204: END
205: $r->print(&Apache::loncommon::end_page());
206: }
207:
208: sub display_help_mainpage {
209: my ($r,$faq,$bug,$topic,$component_url,$origurl,$bugurl,$faqbaseurl,$requestmail) = @_;
210:
211: my %lt =&Apache::lonlocal::texthash(
212: 'topp' => 'Topic Page',
213: 'chen' => 'Choose an entry below to go directly to a relevant help page',
214: 'orto' => 'or to submit a help request to the LON-CAPA support staff at your institution.',
215: 'vthp' => 'Visit the help page for ',
216: 'disp' => 'Display the page in the inline help system that covers this topic.',
217: 'crac' => 'Create an account for yourself in the LON-CAPA Bugzilla tracking system, if you wish to report bugs you have encountered in the LON-CAPA software, or if you have suggestions for improvements in LON-CAPA.',
218: 'inhs' => 'Topical help system for',
219: 'cont' => 'Contact the LON-CAPA support team',
220: 'suhr' => 'Submit a help request to the team responsible for LON-CAPA support at this institution.',
221: 'stuq' => 'Questions about course content should not be directed to the support team, but instead should be sent to the course instructor',
222: 'faqo' => 'FAQ-O-Matic Help system',
223: 'tfaq' => 'The FAQ-O-Matic is a compendium of answers provided to common questions asked by users of LON-CAPA over the past couple of years.',
224: 'lbug' => 'LON-CAPA Bugzilla bug/feature request tracking system',
225: 'crea' => 'Create an account for yourself in the LON-CAPA Bugzilla tracking system, if you wish to report bugs you have encountered in the LON-CAPA software,or if you have suggestions for improvements in LON-CAPA.',
226: 'suim' => ' Suggested improvements may include additional functionality, improved usability, or changes to wording used in LON-CAPA pages, including the embedded help system.'
227: );
228:
229: my %body_layout =
230: ('topmargin' => "0",
231: 'marginheight' => "0");
232: my $start_page =
233: &Apache::loncommon::start_page('Help Content',undef,
234: {'add_entries' => \%body_layout,
235: 'only_body' => 1,});
236: $r->print($start_page);
237: $r->print('<b>'.$lt{'chen'});
238: if ($requestmail =~ m/^[^\@]+\@[^\@]+$/) {
239: $r->print(', '.$lt{'orto'});
240: } else {
241: $r->print(".");
242: }
243: $r->print('</b>');
244: if ($topic) {
245: if ( ($component_url) || ($env{'user.adv'}) ) {
246: if ($component_url) {
247: $r->print("
248: <ul>
249: <li><a href=\"$component_url\">$lt{'vthp'} $topic</a></li>
250: </ul>
251: <p>$lt{'disp'}</p>
252: ");
253: }
254: }
255: }
256: if ($requestmail =~ m/^[^\@]+\@[^\@]+$/) {
257: $r->print("
258: <ul>
259: <li><a href=\"/adm/support?origurl=".&escape($origurl)."\">$lt{'cont'}</a></li>
260: </ul>
261: <p>$lt{'suhr'}");
262: unless ($env{'user.adv'}) {
263: $r->print('<br /><b>'.&mt('Note').'</b>: '.$lt{'stuq'}.'. '.&mt('This can be done using the').' <a href="/adm/communicate" target="_top">'.&mt('COM').'</a> '.&mt('button, or the FDBK button when viewing a content page.'));
264: }
265: $r->print("</p>");
266: }
267: if ($faqbaseurl && $env{'user.adv'}) {
268: if (!defined($faq) ||$faq eq '') {
269: $faq = '1';
270: }
271: $r->print("
272: <ul>
273: <li><a href=\"$faqbaseurl/fom/cache/$faq.html\">$lt{'faqo'}</a></li>
274: </ul>
275: <p>$lt{'tfaq'}</p>
276: ");
277: }
278: if ($bugurl && $env{'user.adv'}) {
279: $bugurl .= '?'.$bug;
280: $r->print("
281: <ul>
282: <li><a href=\"$bugurl\">$lt{'lbug'}</a></li>
283: </ul>
284: <p>$lt{'crea'} $lt{'suim'}</p>
285: ");
286: }
287: $r->print(&Apache::loncommon::end_page());
288: }
289:
290: 1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>