File:  [LON-CAPA] / loncom / interface / lonhtmlcommon.pm
Revision 1.406: download - view: text, annotated - select for diffs
Tue Sep 13 12:22:14 2022 UTC (20 months, 3 weeks ago) by raeburn
Branches: MAIN
CVS tags: HEAD
- In course context, switch server to resource's home server opens new tab
  when editing published resource, and ca role is loaded,  when user's domain
  (by default) disallows session hosting of domain's users in resource's domain.
- New arg (skip_enc_check) in redirect args , used by loncommon::headtag()
  it true, omit application of check_encrypt().
- New seventh item ($shownsymb) in args for lonhtmlcommon::jump_to_editres()

    1: # The LearningOnline Network with CAPA
    2: # a pile of common html routines
    3: #
    4: # $Id: lonhtmlcommon.pm,v 1.406 2022/09/13 12:22:14 raeburn 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: ######################################################################
   30: 
   31: =pod
   32: 
   33: =head1 NAME
   34: 
   35: Apache::lonhtmlcommon - routines to do common html things
   36: 
   37: =head1 SYNOPSIS
   38: 
   39: Referenced by other mod_perl Apache modules.
   40: 
   41: =head1 INTRODUCTION
   42: 
   43: lonhtmlcommon is a collection of subroutines used to present information
   44: in a consistent html format, or provide other functionality related to
   45: html.
   46: 
   47: =head2 General Subroutines
   48: 
   49: =over 4
   50: 
   51: =cut 
   52: 
   53: ######################################################################
   54: ######################################################################
   55: 
   56: package Apache::lonhtmlcommon;
   57: 
   58: use strict;
   59: use Time::Local;
   60: use Time::HiRes;
   61: use Apache::lonlocal;
   62: use Apache::lonnet;
   63: use HTML::Entities();
   64: use LONCAPA qw(:DEFAULT :match);
   65: 
   66: sub java_not_enabled {
   67:     if (($env{'browser.mobile'}) && ($env{'browser.mobile'} =~ /^ipad|ipod|iphone$/i)) {
   68:         return "\n".'<span class="LC_error">'.
   69:                &mt('The required Java applet could not be started, because Java is not supported by your mobile device.').
   70:                "</span>\n";
   71:     } else {
   72:         return "\n".'<span class="LC_error">'.
   73:                &mt('The required Java applet could not be started. Please make sure to have Java installed and active in your browser.').
   74:                "</span>\n";
   75:     }
   76: }
   77: 
   78: sub coursepreflink {
   79:    my ($text,$category)=@_;
   80:    if (&Apache::lonnet::allowed('opa',$env{'request.course.id'})) {
   81:        my $target =' target="_top"';
   82:        if ((($env{'request.lti.login'}) && ($env{'request.lti.target'} eq 'iframe')) ||
   83:            (($env{'request.deeplink.login'}) && ($env{'request.deeplink.target'} eq '_self'))) {
   84:            $target ='';
   85:        }
   86:        return '<a'.$target.' href="'.&HTML::Entities::encode("/adm/courseprefs?phase=display&actions=$category",'<>&"').'"><span class="LC_setting">'.$text.'</span></a>';
   87:    } else {
   88:       return '';
   89:    }
   90: }
   91: 
   92: sub raw_href_to_link {
   93:    my ($message)=@_;
   94:    $message=~s/(https?\:\/\/[^\s\'\"\<]+)([\s\<]|$)/<a href="$1"><tt>$1<\/tt><\/a>$2/gi;
   95:    return $message;
   96: }
   97: 
   98: sub entity_encode {
   99:     my ($text)=@_;
  100:     return &HTML::Entities::encode($text, '\'<>&"');
  101: }
  102: 
  103: sub direct_parm_link {
  104:     my ($linktext,$symb,$filter,$part,$target)=@_;
  105:     $symb=&entity_encode($symb);
  106:     $filter=&entity_encode($filter);
  107:     $part=&entity_encode($part);
  108:     if (($symb) && (&Apache::lonnet::allowed('opa')) && ($target ne 'tex')) {
  109:         my $target=' target="_top"';
  110:         if ((($env{'request.lti.login'}) && ($env{'request.lti.target'} eq 'iframe')) ||
  111:             (($env{'request.deeplink.login'}) && ($env{'request.deeplink.target'} eq '_self'))) {
  112:             $target='';
  113:         }
  114:         return "<a".$target." href=\"/adm/parmset?symb=$symb&amp;filter=$filter&amp;part=$part\"><span class=\"LC_setting\">$linktext</span></a>";
  115:     } else {
  116:         return $linktext;
  117:     }
  118: }
  119: ##############################################
  120: ##############################################
  121: 
  122: =item &confirm_success()
  123: 
  124: Successful completion of an operation message
  125: 
  126: =cut
  127: 
  128: sub confirm_success {
  129:    my ($message,$failure)=@_;
  130:    if ($failure) {
  131:       return '<span class="LC_error" style="font-size: inherit;">'."\n"
  132:             .'<img src="/adm/lonIcons/navmap.wrong.gif" alt="'.&mt('Error').'" /> '."\n"
  133:             .$message."\n"
  134:             .'</span>'."\n";
  135:    } else {
  136:       return '<span class="LC_success">'."\n"
  137:             .'<img src="/adm/lonIcons/navmap.correct.gif" alt="'.&mt('OK').'" /> '."\n"
  138:             .$message."\n"
  139:             .'</span>'."\n";
  140:    }
  141: }
  142: 
  143: ##############################################
  144: ##############################################
  145: 
  146: =pod
  147: 
  148: =item &dragmath_button()
  149: 
  150: Creates a button that launches a dragmath popup-window, in which an 
  151: expression can be edited and pasted as LaTeX into a specified textarea. 
  152: 
  153:   textarea - Name of the textarea to edit.
  154:   helpicon - If true, show a help icon to the right of the button.
  155: 
  156: =cut
  157: 
  158: sub dragmath_button {
  159:     my ($textarea,$helpicon) = @_;
  160:     my $help_text; 
  161:     if ($helpicon) {
  162:         $help_text = &Apache::loncommon::help_open_topic('Authoring_Math_Editor',undef,undef,undef,undef,'mathhelpicon_'.$textarea);
  163:     }
  164:     my $buttontext=&mt('Edit Math');
  165:     return <<ENDDRAGMATH;
  166:                 <input type="button" value="$buttontext" onclick="javascript:mathedit('$textarea',document)" />$help_text
  167: ENDDRAGMATH
  168: }
  169: 
  170: ##############################################
  171: 
  172: =pod
  173: 
  174: =item &dragmath_js()
  175: 
  176: Javascript used to open pop-up window containing dragmath applet which 
  177: can be used to paste LaTeX into a textarea.
  178: 
  179: =cut
  180: 
  181: sub dragmath_js {
  182:     my ($popup) = @_;
  183:     return <<ENDDRAGMATHJS;
  184:                 <script type="text/javascript">
  185:                 // <![CDATA[
  186:                   function mathedit(textarea, doc) {
  187:                      targetEntry = textarea;
  188:                      targetDoc   = doc;
  189:                      newwin  = window.open("/adm/dragmath/$popup.html","","width=565,height=500,resizable");
  190:                   }
  191:                 // ]]>
  192:                 </script>
  193: 
  194: ENDDRAGMATHJS
  195: }
  196: 
  197: ##############################################
  198: ##############################################
  199: 
  200: =pod
  201: 
  202: =item &dependencies_button()
  203: 
  204: Creates a button that launches a popup-window, in which dependencies  
  205: for the web page in the main window can be added to, replaced or deleted.  
  206: 
  207: =cut
  208: 
  209: sub dependencies_button {
  210:     my $buttontext=&mt('Manage Dependencies');
  211:     return <<"END";
  212:                 <input type="button" value="$buttontext" onclick="javascript:dependencycheck();" />
  213: END
  214: }
  215: 
  216: ##############################################
  217: 
  218: =pod
  219: 
  220: =item &dependencycheck_js()
  221: 
  222: Javascript used to open pop-up window containing interface to manage 
  223: dependencies for a web page uploaded diretcly to a course.
  224: 
  225: =cut
  226: 
  227: sub dependencycheck_js {
  228:     my ($symb,$title,$url,$folderpath,$uri) = @_;
  229:     my $link;
  230:     if ($symb) {
  231:         $link = '/adm/dependencies?symb='.&HTML::Entities::encode($symb,'<>&"');
  232:     } elsif ($folderpath) {
  233:         $link = '/adm/dependencies?folderpath='.&HTML::Entities::encode($folderpath,'<>&"');
  234:          $url = $uri;
  235:     } elsif ($uri =~ m{^/public/$match_domain/$match_courseid/syllabus$}) {
  236:         $link = '/adm/dependencies';
  237:     }
  238:     $link .= (($link=~/\?/)?'&amp;':'?').'title='.
  239:              &HTML::Entities::encode($title,'<>&"');
  240:     if ($url) {
  241:         $link .= '&url='.&HTML::Entities::encode($url,'<>&"');
  242:     }
  243:     return <<ENDJS;
  244:                 <script type="text/javascript">
  245:                 // <![CDATA[
  246:                   function dependencycheck() {
  247:                      depwin  = window.open("$link","","width=750,height=500,resizable,scrollbars=yes");
  248:                   }
  249:                 // ]]>
  250:                 </script>
  251: ENDJS
  252: }
  253: 
  254: ##############################################
  255: ##############################################
  256: 
  257: =pod
  258: 
  259: =item &authorbombs()
  260: 
  261: =cut
  262: 
  263: ##############################################
  264: ##############################################
  265: 
  266: sub authorbombs {
  267:     my $url=shift;
  268:     $url=&Apache::lonnet::declutter($url);
  269:     my ($udom,$uname)=($url=~m{^($LONCAPA::domain_re)/($LONCAPA::username_re)/});
  270:     my %bombs=&Apache::lonmsg::all_url_author_res_msg($uname,$udom);
  271:     foreach my $bomb (keys(%bombs)) {
  272: 	if ($bomb =~ /^$udom\/$uname\//) {
  273: 	    return '<a href="/adm/bombs/'.$url.
  274: 		'"><img src="'.&Apache::loncommon::lonhttpdurl('/adm/lonMisc/bomb.gif').'" alt="'.&mt('Bomb').'" border="0" /></a>'.
  275: 		&Apache::loncommon::help_open_topic('About_Bombs');
  276: 	}
  277:     }
  278:     return '';
  279: }
  280: 
  281: ##############################################
  282: ##############################################
  283: 
  284: sub recent_filename {
  285:     my $area=shift;
  286:     return 'nohist_recent_'.&escape($area);
  287: }
  288: 
  289: sub store_recent {
  290:     my ($area,$name,$value,$freeze)=@_;
  291:     my $file=&recent_filename($area);
  292:     my %recent=&Apache::lonnet::dump($file);
  293:     if (scalar(keys(%recent))>20) {
  294: # remove oldest value
  295: 	my $oldest=time();
  296: 	my $delkey='';
  297: 	foreach my $item (keys(%recent)) {
  298: 	    my $thistime=(split(/\&/,$recent{$item}))[0];
  299: 	    if (($thistime ne "always_include") && ($thistime<$oldest)) {
  300: 		$oldest=$thistime;
  301: 		$delkey=$item;
  302: 	    }
  303: 	}
  304: 	&Apache::lonnet::del($file,[$delkey]);
  305:     }
  306: # store new value
  307:     my $timestamp;
  308:     if ($freeze) {
  309:         $timestamp = "always_include";
  310:     } else {
  311:         $timestamp = time();
  312:     }   
  313:     &Apache::lonnet::put($file,{ $name => 
  314: 				 $timestamp.'&'.&escape($value) });
  315: }
  316: 
  317: sub remove_recent {
  318:     my ($area,$names)=@_;
  319:     my $file=&recent_filename($area);
  320:     return &Apache::lonnet::del($file,$names);
  321: }
  322: 
  323: sub select_recent {
  324:     my ($area,$fieldname,$event)=@_;
  325:     my %recent=&Apache::lonnet::dump(&recent_filename($area));
  326:     my $return="\n<select name='$fieldname'".
  327: 	($event?" onchange='$event'":'').
  328: 	">\n<option value=''>--- ".&mt('Recent')." ---</option>";
  329:     foreach my $value (sort(keys(%recent))) {
  330: 	unless ($value =~/^error\:/) {
  331: 	    my $escaped = &Apache::loncommon::escape_url($value);
  332: 	    &Apache::loncommon::inhibit_menu_check(\$escaped);
  333:             if ($area eq 'residx') {
  334:                 next if ((!&Apache::lonnet::allowed('bre',$value)) && (!&Apache::lonnet::allowed('bro',$value)));
  335:             }
  336: 	    $return.="\n<option value='$escaped'>".
  337: 		&unescape((split(/\&/,$recent{$value}))[1]).
  338: 		'</option>';
  339: 	}
  340:     }
  341:     $return.="\n</select>\n";
  342:     return $return;
  343: }
  344: 
  345: sub get_recent {
  346:     my ($area, $n) = @_;
  347:     my %recent=&Apache::lonnet::dump(&recent_filename($area));
  348: 
  349: # Create hash with key as time and recent as value
  350: # Begin filling return_hash with any 'always_include' option
  351:     my %time_hash = ();
  352:     my %return_hash = ();
  353:     foreach my $item (keys(%recent)) {
  354:         my ($thistime,$thisvalue)=(split(/\&/,$recent{$item}));
  355:         if ($thistime eq 'always_include') {
  356:             $return_hash{$item} = &unescape($thisvalue);
  357:             $n--;
  358:         } else {
  359:             $time_hash{$thistime} = $item;
  360:         }
  361:     }
  362: 
  363: # Sort by decreasing time and return key value pairs
  364:     my $idx = 1;
  365:     foreach my $item (reverse(sort(keys(%time_hash)))) {
  366:        $return_hash{$time_hash{$item}} =
  367:                   &unescape((split(/\&/,$recent{$time_hash{$item}}))[1]);
  368:        if ($n && ($idx++ >= $n)) {last;}
  369:     }
  370: 
  371:     return %return_hash;
  372: }
  373: 
  374: sub get_recent_frozen {
  375:     my ($area) = @_;
  376:     my %recent=&Apache::lonnet::dump(&recent_filename($area));
  377: 
  378: # Create hash with all 'frozen' items
  379:     my %return_hash = ();
  380:     foreach my $item (keys(%recent)) {
  381:         my ($thistime,$thisvalue)=(split(/\&/,$recent{$item}));
  382:         if ($thistime eq 'always_include') {
  383:             $return_hash{$item} = &unescape($thisvalue);
  384:         }
  385:     }
  386:     return %return_hash;
  387: }
  388: 
  389: 
  390: 
  391: =pod
  392: 
  393: =item &textbox()
  394: 
  395: =cut
  396: 
  397: ##############################################
  398: ##############################################
  399: sub textbox {
  400:     my ($name,$value,$size,$special) = @_;
  401:     $size = 40 if (! defined($size));
  402:     $value = &HTML::Entities::encode($value,'<>&"');
  403:     my $Str = '<input type="text" name="'.$name.'" size="'.$size.'" '.
  404:         'value="'.$value.'" '.$special.' />';
  405:     return $Str;
  406: }
  407: 
  408: ##############################################
  409: ##############################################
  410: 
  411: =pod
  412: 
  413: =item &checkbox()
  414: 
  415: =cut
  416: 
  417: ##############################################
  418: ##############################################
  419: sub checkbox {
  420:     my ($name,$checked,$value,$special) = @_;
  421:     my $Str = '<input type="checkbox" name="'.$name.'" ';
  422:     if (defined($value)) {
  423:         $Str .= 'value="'.$value.'"';
  424:     } 
  425:     if ($checked) {
  426:         $Str .= ' checked="checked"';
  427:     }
  428:     $Str .= $special.' />';
  429:     return $Str;
  430: }
  431: 
  432: 
  433: =pod
  434: 
  435: =item &radiobutton()
  436: 
  437: =cut
  438: 
  439: ##############################################
  440: ##############################################
  441: sub radio {
  442:     my ($name,$checked,$value) = @_;
  443:     my $Str = '<input type="radio" name="'.$name.'" ';
  444:     if (defined($value)) {
  445:         $Str .= 'value="'.$value.'"';
  446:     } 
  447:     if ($checked eq $value) {
  448:         $Str .= ' checked="checked"';
  449:     }
  450:     $Str .= ' />';
  451:     return $Str;
  452: }
  453: 
  454: ##############################################
  455: ##############################################
  456: 
  457: =pod
  458: 
  459: =item &date_setter()
  460: 
  461: &date_setter returns html and javascript for a compact date-setting form.
  462: To retrieve values from it, use &get_date_from_form.
  463: 
  464: =over 4
  465: 
  466: =item Inputs
  467: 
  468: =over
  469: 
  470: =item $dname 
  471: 
  472: The name to prepend to the form elements.  
  473: The form elements defined will be dname_year, dname_month, dname_day,
  474: dname_hour, dname_min, and dname_sec.
  475: 
  476: =item $currentvalue
  477: 
  478: The current setting for this time parameter.  A unix format time
  479: (time in seconds since the beginning of Jan 1st, 1970, GMT.  
  480: An undefined value is taken to indicate the value is the current time
  481: unless it is requested to leave it empty. See $includeempty.
  482: Also, to be explicit, a value of 'now' also indicates the current time.
  483: 
  484: =item $special
  485: 
  486: Additional html/javascript to be associated with each element in
  487: the date_setter.  See lonparmset for example usage.
  488: 
  489: =item $includeempty 
  490: 
  491: If it is set (true) and no date/time value is provided,
  492: the date/time fields are left empty.
  493: 
  494: =item $state
  495: 
  496: Specifies the initial state of the form elements.  Either 'disabled' or empty.
  497: Defaults to empty, which indicates the form elements are not disabled.
  498: 
  499: =item $no_hh_mm_ss
  500: 
  501: If true, text boxes for hours, minutes and seconds are omitted.
  502: 
  503: =item $defhour
  504: 
  505: Default value for hours (a default of 0 is used otherwise).
  506: 
  507: =item $defmin
  508: 
  509: Default value for minutes (a default of 0 is used otherwise).
  510: 
  511: =item defsec
  512: 
  513: Default value for seconds (a default of 0 is used otherwise).
  514: 
  515: =item $nolink
  516: 
  517: If true, a "Select calendar" link (to pop-up a calendar) is not displayed
  518: to the right of the items.
  519: 
  520: =item $no_mm_ss
  521: 
  522: If true, text boxes for minutes and seconds are omitted.
  523: 
  524: =item $no_ss
  525: 
  526: If true, text boxes for seconds are omitted.
  527: 
  528: =back
  529: 
  530: =item Bugs
  531: 
  532: The method used to restrict user input will fail in the year 2400.
  533: 
  534: =back
  535: 
  536: =cut
  537: 
  538: ##############################################
  539: ##############################################
  540: sub date_setter {
  541:     my ($formname,$dname,$currentvalue,$special,$includeempty,$state,
  542:         $no_hh_mm_ss,$defhour,$defmin,$defsec,$nolink,$no_mm_ss,$no_ss) = @_;
  543:     my $now = time;
  544: 
  545:     my $tzname;
  546:     my ($sec,$min,$hour,$mday,$month,$year) = ('', '', undef,''.''.'');
  547:     #other potentially useful values:    wkday,yrday,is_daylight_savings
  548: 
  549:     if (! defined($state) || $state ne 'disabled') {
  550:         $state = '';
  551:     } else {
  552:         $state = 'disabled="disabled"';
  553:     }
  554:     if (! defined($no_hh_mm_ss)) {
  555:         $no_hh_mm_ss = 0;
  556:     }
  557:     if ($currentvalue eq 'now') {
  558:         $currentvalue = $now;
  559:     }
  560:     
  561:     # Default value: Set empty date field to current time
  562:     # unless empty inclusion is requested
  563:     if ((!$includeempty) && (!$currentvalue)) {
  564:         $currentvalue = $now;
  565:     }
  566:     # Do we have a date? Split it!
  567:     if ($currentvalue) {
  568: 	($tzname,$sec,$min,$hour,$mday,$month,$year) = &get_timedates($currentvalue);
  569: 
  570:         #No values provided for hour, min, sec? Use default 0
  571:         if (($defhour) || ($defmin) || ($defsec)) {
  572:             $sec  = ($defsec  ? $defsec  : 0);
  573:             $min  = ($defmin  ? $defmin  : 0);
  574:             $hour = ($defhour ? $defhour : 0);
  575:         }
  576:     }
  577:     my $result = "\n<!-- $dname date setting form -->\n";
  578:     $result .= <<ENDJS;
  579: <script type="text/javascript">
  580: // <![CDATA[
  581:     function $dname\_checkday() {
  582:         var day   = document.$formname.$dname\_day.value;
  583:         var month = document.$formname.$dname\_month.value;
  584:         var year  = document.$formname.$dname\_year.value;
  585:         var valid = true;
  586:         if (day < 1) {
  587:             document.$formname.$dname\_day.value = 1;
  588:         } 
  589:         if (day > 31) {
  590:             document.$formname.$dname\_day.value = 31;
  591:         }
  592:         if ((month == 1)  || (month == 3)  || (month == 5)  ||
  593:             (month == 7)  || (month == 8)  || (month == 10) ||
  594:             (month == 12)) {
  595:             if (day > 31) {
  596:                 document.$formname.$dname\_day.value = 31;
  597:                 day = 31;
  598:             }
  599:         } else if (month == 2 ) {
  600:             if ((year % 4 == 0) && (year % 100 != 0)) {
  601:                 if (day > 29) {
  602:                     document.$formname.$dname\_day.value = 29;
  603:                 }
  604:             } else if (day > 29) {
  605:                 document.$formname.$dname\_day.value = 28;
  606:             }
  607:         } else if (day > 30) {
  608:             document.$formname.$dname\_day.value = 30;
  609:         }
  610:     }
  611:     
  612:     function $dname\_disable() {
  613:         document.$formname.$dname\_month.disabled=true;
  614:         document.$formname.$dname\_day.disabled=true;
  615:         document.$formname.$dname\_year.disabled=true;
  616:         document.$formname.$dname\_hour.disabled=true;
  617:         document.$formname.$dname\_minute.disabled=true;
  618:         document.$formname.$dname\_second.disabled=true;
  619:     }
  620: 
  621:     function $dname\_enable() {
  622:         document.$formname.$dname\_month.disabled=false;
  623:         document.$formname.$dname\_day.disabled=false;
  624:         document.$formname.$dname\_year.disabled=false;
  625:         document.$formname.$dname\_hour.disabled=false;
  626:         document.$formname.$dname\_minute.disabled=false;
  627:         document.$formname.$dname\_second.disabled=false;        
  628:     }
  629: 
  630:     function $dname\_opencalendar() {
  631:         if (! document.$formname.$dname\_month.disabled) {
  632:             var calwin=window.open(
  633: "/adm/announcements?pickdate=yes&formname=$formname&element=$dname&month="+
  634: document.$formname.$dname\_month.value+"&year="+
  635: document.$formname.$dname\_year.value,
  636:              "LONCAPAcal",
  637:               "height=350,width=350,scrollbars=yes,resizable=yes,menubar=no");
  638:         }
  639: 
  640:     }
  641: // ]]>
  642: </script>
  643: ENDJS
  644:     $result .= '  <span class="LC_nobreak">';
  645:     my $monthselector = qq{<select name="$dname\_month" $special $state onchange="javascript:$dname\_checkday()" >};
  646:     # Month
  647:     my @Months = qw/January February  March     April   May      June 
  648:                     July    August    September October November December/;
  649:     # Pad @Months with a bogus value to make indexing easier
  650:     unshift(@Months,'If you can read this an error occurred');
  651:     if ($includeempty) { $monthselector.="<option value=''></option>"; }
  652:     for(my $m = 1;$m <=$#Months;$m++) {
  653:         $monthselector .= qq{      <option value="$m"};
  654:         $monthselector .= ' selected="selected"' if ($m-1 eq $month);
  655:         $monthselector .= '> '.&mt($Months[$m]).' </option>'."\n";
  656:     }
  657:     $monthselector.= '  </select>';
  658:     # Day
  659:     my $dayselector = qq{<input type="text" name="$dname\_day" $state value="$mday" size="3" $special onchange="javascript:$dname\_checkday()" />};
  660:     # Year
  661:     my $yearselector = qq{<input type="text" name="$dname\_year" $state value="$year" size="5" $special onchange="javascript:$dname\_checkday()" />};
  662:     #
  663:     my $hourselector = qq{<select name="$dname\_hour" $special $state >};
  664:     if ($includeempty) { 
  665:         $hourselector.=qq{<option value=''></option>};
  666:     }
  667:     for (my $h = 0;$h<24;$h++) {
  668:         $hourselector .= qq{<option value="$h"};
  669:         $hourselector .= ' selected="selected"' if (defined($hour) && $hour == $h);
  670:         $hourselector .= ">";
  671:         my $timest='';
  672:         if ($h == 0) {
  673:             $timest .= "12 am";
  674:         } elsif($h == 12) {
  675:             $timest .= "12 noon";
  676:         } elsif($h < 12) {
  677:             $timest .= "$h am";
  678:         } else {
  679:             $timest .= $h-12 ." pm";
  680:         }
  681:         $timest=&mt($timest);
  682:         $hourselector .= $timest." </option>\n";
  683:     }
  684:     $hourselector .= "  </select>\n";
  685:     my $minuteselector = qq{<input type="text" name="$dname\_minute" $special $state value="$min" size="3" />};
  686:     my $secondselector= qq{<input type="text" name="$dname\_second" $special $state value="$sec" size="3" />};
  687:     my $cal_link;
  688:     unless (($nolink) || ($state eq 'disabled')) {
  689:         $cal_link = qq{<a href="javascript:$dname\_opencalendar()">};
  690:     }
  691:     #
  692:     my $tzone = ' '.$tzname.' ';
  693:     if ($no_hh_mm_ss) {
  694:         $result .= &mt('[_1] [_2] [_3] ',
  695:                        $monthselector,$dayselector,$yearselector).
  696:                    $tzone;
  697:     } elsif ($no_mm_ss) {
  698:         $result .= &mt('[_1] [_2] [_3] [_4]',
  699:                       $monthselector,$dayselector,$yearselector,
  700:                       $hourselector).
  701:                    $tzone;
  702: 
  703:     } elsif ($no_ss) {
  704:         $result .= &mt('[_1] [_2] [_3] [_4] [_5]m',
  705:                       $monthselector,$dayselector,$yearselector,
  706:                       $hourselector,$minuteselector).
  707:                    $tzone;
  708: 
  709:     } else {
  710:         $result .= &mt('[_1] [_2] [_3] [_4] [_5]m [_6]s ',
  711:                       $monthselector,$dayselector,$yearselector,
  712:                       $hourselector,$minuteselector,$secondselector).
  713:                    $tzone;
  714:     }
  715:     unless (($nolink) || ($state eq 'disabled')) {
  716:         $result .= &mt('[_1]Select Date[_2]',$cal_link,'</a>');
  717:     }
  718:     $result .= "</span>\n<!-- end $dname date setting form -->\n";
  719:     return $result;
  720: }
  721: 
  722: sub get_timedates {
  723:     my ($epoch) = @_;
  724:     my $dt = DateTime->from_epoch(epoch => $epoch)
  725:                      ->set_time_zone(&Apache::lonlocal::gettimezone());
  726:     my $tzname = $dt->time_zone_short_name();
  727:     my $sec = $dt->second;
  728:     my $min = $dt->minute;
  729:     my $hour = $dt->hour;
  730:     my $mday = $dt->day;
  731:     my $month = $dt->month;
  732:     if ($month) {
  733:         $month --;
  734:     }
  735:     my $year = $dt->year;
  736:     return ($tzname,$sec,$min,$hour,$mday,$month,$year);
  737: }
  738: 
  739: sub build_url {
  740:     my ($base, $fields)=@_;
  741:     my $url;
  742:     $url = $base.'?';
  743:     foreach my $key (keys(%$fields)) {
  744:         $url.=&escape($key).'='.&escape($$fields{$key}).'&amp;';
  745:     }
  746:     $url =~ s/&amp;$//;
  747:     return $url;
  748: }
  749: 
  750: 
  751: ##############################################
  752: ##############################################
  753: 
  754: =pod
  755: 
  756: =item &get_date_from_form()
  757: 
  758: get_date_from_form retrieves the date specified in an &date_setter form.
  759: 
  760: =over
  761: 
  762: =item Inputs:
  763: 
  764: =over 4
  765: 
  766: =item $dname
  767: 
  768: The name passed to &date_setter, which prefixes the form elements.
  769: 
  770: =item $defaulttime
  771: 
  772: The unix time to use as the default in case of poor inputs.
  773: 
  774: =back
  775: 
  776: =back
  777: 
  778: Returns: Unix time represented in the form.
  779: 
  780: =cut
  781: 
  782: ##############################################
  783: ##############################################
  784: sub get_date_from_form {
  785:     my ($dname) = @_;
  786:     my ($sec,$min,$hour,$day,$month,$year);
  787:     #
  788:     if (defined($env{'form.'.$dname.'_second'})) {
  789:         my $tmpsec = $env{'form.'.$dname.'_second'};
  790:         if (($tmpsec =~ /^\d+$/) && ($tmpsec >= 0) && ($tmpsec < 60)) {
  791:             $sec = $tmpsec;
  792:         }
  793: 	if (!defined($tmpsec) || $tmpsec eq '') { $sec = 0; }
  794:     } else {
  795:         $sec = 0;
  796:     }
  797:     if (defined($env{'form.'.$dname.'_minute'})) {
  798:         my $tmpmin = $env{'form.'.$dname.'_minute'};
  799:         if (($tmpmin =~ /^\d+$/) && ($tmpmin >= 0) && ($tmpmin < 60)) {
  800:             $min = $tmpmin;
  801:         }
  802: 	if (!defined($tmpmin) || $tmpmin eq '') { $min = 0; }
  803:     } else {
  804:         $min = 0;
  805:     }
  806:     if (defined($env{'form.'.$dname.'_hour'})) {
  807:         my $tmphour = $env{'form.'.$dname.'_hour'};
  808:         if (($tmphour =~ /^\d+$/) && ($tmphour >= 0) && ($tmphour < 24)) {
  809:             $hour = $tmphour;
  810:         }
  811:     } else {
  812:         $hour = 0;
  813:     }
  814:     if (defined($env{'form.'.$dname.'_day'})) {
  815:         my $tmpday = $env{'form.'.$dname.'_day'};
  816:         if (($tmpday =~ /^\d+$/) && ($tmpday > 0) && ($tmpday < 32)) {
  817:             $day = $tmpday;
  818:         }
  819:     }
  820:     if (defined($env{'form.'.$dname.'_month'})) {
  821:         my $tmpmonth = $env{'form.'.$dname.'_month'};
  822:         if (($tmpmonth =~ /^\d+$/) && ($tmpmonth > 0) && ($tmpmonth < 13)) {
  823:             $month = $tmpmonth;
  824:         }
  825:     }
  826:     if (defined($env{'form.'.$dname.'_year'})) {
  827:         my $tmpyear = $env{'form.'.$dname.'_year'};
  828:         if (($tmpyear =~ /^\d+$/) && ($tmpyear >= 1970)) {
  829:             $year = $tmpyear;
  830:         }
  831:     }
  832:     if (($year<1970) || ($year>2037)) { return undef; }
  833:     if (defined($sec) && defined($min)   && defined($hour) &&
  834:         defined($day) && defined($month) && defined($year)) {
  835:         my $timezone = &Apache::lonlocal::gettimezone();
  836:         my $dt = DateTime->new( year   => $year,
  837:                                 month  => $month,
  838:                                 day    => $day,
  839:                                 hour   => $hour,
  840:                                 minute => $min,
  841:                                 second => $sec,
  842:                                 time_zone => $timezone,
  843:                               );
  844:         my $epoch_time  = $dt->epoch;
  845:         if ($epoch_time ne '') {
  846:             return $epoch_time;
  847:         } else {
  848:             return undef;
  849:         }
  850:     } else {
  851:         return undef;
  852:     }
  853: }
  854: 
  855: ##############################################
  856: ##############################################
  857: 
  858: =pod
  859: 
  860: =item &pjump_javascript_definition()
  861: 
  862: Returns javascript defining the 'pjump' function, which opens up a
  863: parameter setting wizard.
  864: 
  865: =cut
  866: 
  867: ##############################################
  868: ##############################################
  869: sub pjump_javascript_definition {
  870:     my $Str = <<END;
  871:     function pjump(type,dis,value,marker,ret,call,hour,min,sec,extra) {
  872:         openMyModal("/adm/rat/parameter.html?type="+escape(type)
  873:                  +"&value="+escape(value)+"&marker="+escape(marker)
  874:                  +"&return="+escape(ret)
  875:                  +"&call="+escape(call)+"&name="+escape(dis)
  876:                  +"&defhour="+escape(hour)+"&defmin="+escape(min)
  877:                  +"&defsec="+escape(sec)+"&extra="+escape(extra)
  878:                  +"&modal=1",350,350,'no');
  879:     }
  880: END
  881:     return $Str;
  882: }
  883: 
  884: ##############################################
  885: ##############################################
  886: 
  887: =pod
  888: 
  889: =item &javascript_nothing()
  890: 
  891: Return an appropriate null for the users browser.  This is used
  892: as the first arguement for window.open calls when you want a blank
  893: window that you can then write to.
  894: 
  895: =cut
  896: 
  897: ##############################################
  898: ##############################################
  899: sub javascript_nothing {
  900:     # mozilla and other browsers work with "''", but IE on mac does not.
  901:     my $nothing = "''";
  902:     my $user_browser;
  903:     my $user_os;
  904:     $user_browser = $env{'browser.type'} if (exists($env{'browser.type'}));
  905:     $user_os      = $env{'browser.os'}   if (exists($env{'browser.os'}));
  906:     if (! defined($user_browser) || ! defined($user_os)) {
  907:         (undef,$user_browser,undef,undef,undef,$user_os) = 
  908:                            &Apache::loncommon::decode_user_agent();
  909:     }
  910:     if ($user_browser eq 'explorer' && $user_os =~ 'mac') {
  911:         $nothing = "'javascript:void(0);'";
  912:     }
  913:     return $nothing;
  914: }
  915: 
  916: ##############################################
  917: ##############################################
  918: sub javascript_docopen {
  919:     my ($mimetype) = @_;
  920:     $mimetype ||= 'text/html';
  921:     # safari does not understand document.open() and loads "text/html"
  922:     my $nothing = "''";
  923:     my $user_browser;
  924:     my $user_os;
  925:     $user_browser = $env{'browser.type'} if (exists($env{'browser.type'}));
  926:     $user_os      = $env{'browser.os'}   if (exists($env{'browser.os'}));
  927:     if (! defined($user_browser) || ! defined($user_os)) {
  928:         (undef,$user_browser,undef,undef,undef,$user_os) = 
  929:                            &Apache::loncommon::decode_user_agent();
  930:     }
  931:     if ($user_browser eq 'safari' && $user_os =~ 'mac') {
  932:         $nothing = "document.clear()";
  933:     } else {
  934: 	$nothing = "document.open('$mimetype','replace')";
  935:     }
  936:     return $nothing;
  937: }
  938: 
  939: 
  940: ##############################################
  941: ##############################################
  942: 
  943: =pod
  944: 
  945: =item &StatusOptions()
  946: 
  947: Returns html for a selection box which allows the user to choose the
  948: enrollment status of students.  The selection box name is 'Status'.
  949: 
  950: =over
  951: 
  952: =item Inputs:
  953: 
  954: $status: the currently selected status.  If undefined the value of
  955: $env{'form.Status'} is taken.  If that is undefined, a value of 'Active'
  956: is used.
  957: 
  958: $formname: The name of the form.  If defined the onchange attribute of
  959: the selection box is set to document.$formname.submit().
  960: 
  961: $size: the size (number of lines) of the selection box.
  962: 
  963: $onchange: javascript to use when the value is changed.  Enclosed in 
  964: double quotes, ""s, not single quotes.
  965: 
  966: =back
  967: 
  968: Returns: a perl string as described.
  969: 
  970: =cut
  971: 
  972: ##############################################
  973: ##############################################
  974: sub StatusOptions {
  975:     my ($status, $formName,$size,$onchange,$mult)=@_;
  976:     $size = 1 if (!defined($size));
  977:     if (! defined($status)) {
  978:         $status = 'Active';
  979:         $status = $env{'form.Status'} if (exists($env{'form.Status'}));
  980:     }
  981: 
  982:     my $Str = '';
  983:     $Str .= '<select name="Status"';
  984:     if (defined($mult)){
  985:         $Str .= ' multiple="multiple" ';
  986:     }
  987:     if(defined($formName) && $formName ne '' && ! defined($onchange)) {
  988:         $Str .= ' onchange="document.'.$formName.'.submit()"';
  989:     }
  990:     if (defined($onchange)) {
  991:         $Str .= ' onchange="'.$onchange.'"';
  992:     }
  993:     $Str .= ' size="'.$size.'" ';
  994:     $Str .= '>'."\n";
  995:     foreach my $type (['Active',  &mt('Currently Has Access')],
  996: 		      ['Future',  &mt('Will Have Future Access')],
  997: 		      ['Expired', &mt('Previously Had Access')],
  998: 		      ['Any',     &mt('Any Access Status')]) {
  999: 	my ($name,$label) = @$type;
 1000: 	$Str .= '<option value="'.$name.'" ';
 1001: 	if ($status eq $name) {
 1002: 	    $Str .= 'selected="selected" ';
 1003: 	}
 1004: 	$Str .= '>'.$label.'</option>'."\n";
 1005:     }
 1006: 
 1007:     $Str .= '</select>'."\n";
 1008: }
 1009: 
 1010: ########################################################
 1011: ########################################################
 1012: 
 1013: =pod
 1014: 
 1015: =item Progress Window Handling Routines
 1016: 
 1017: These routines handle the creation, update, increment, and closure of 
 1018: progress windows.  The progress window reports to the user the number
 1019: of items completed and an estimate of the time required to complete the rest.
 1020: 
 1021: =over 4
 1022: 
 1023: 
 1024: =item &Create_PrgWin()
 1025: 
 1026: Writes javascript to the client to open a progress window and returns a
 1027: data structure used for bookkeeping.
 1028: 
 1029: =over
 1030: 
 1031: =item Inputs
 1032: 
 1033: =over
 1034: 
 1035: =item $r Apache request
 1036: 
 1037: =item $number_to_do The total number of items being processed.
 1038: 
 1039: =item $preamble Optional HTML to display before the progress bar.
 1040: 
 1041: =back
 1042: 
 1043: =back
 1044: 
 1045: Returns a hash containing the progress state data structure.
 1046: If $number_to_do is zero or null, an indeterminate progress bar will
 1047: be used.
 1048: 
 1049: =item &Update_PrgWin()
 1050: 
 1051: Updates the text in the progress indicator.  Does not increment the count.
 1052: See &Increment_PrgWin.
 1053: 
 1054: =over
 1055: 
 1056: =item Inputs:
 1057: 
 1058: =over 4
 1059: 
 1060: =item $r Apache request
 1061: 
 1062: =item $prog_state Pointer to the data structure returned by &Create_PrgWin
 1063: 
 1064: =item $displaystring The string to write to the status indicator
 1065: 
 1066: =back
 1067: 
 1068: =back
 1069: 
 1070: Returns: none
 1071: 
 1072: 
 1073: =item &Increment_PrgWin()
 1074: 
 1075: Increment the count of items completed for the progress window by $step or 1 if no step is provided.
 1076: 
 1077: =over
 1078: 
 1079: =item Inputs:
 1080: 
 1081: =over 4
 1082: 
 1083: =item $r 
 1084: 
 1085: Apache request
 1086: 
 1087: =item $prog_state
 1088: 
 1089: Pointer to the data structure returned by Create_PrgWin
 1090: 
 1091: =item $extraInfo
 1092: 
 1093: A description of the items being iterated over.  Typically 'student'.
 1094: 
 1095: =item $step
 1096: 
 1097: (optional) counter step. Will be set to default 1 if ommited. step must be greater than 0 or empty.
 1098: 
 1099: =back
 1100: 
 1101: =back
 1102: 
 1103: Returns: none
 1104: 
 1105: 
 1106: =item &Close_PrgWin()
 1107: 
 1108: Closes the progress window.
 1109: 
 1110: =over
 1111: 
 1112: =item Inputs:
 1113: 
 1114: =over 4 
 1115: 
 1116: =item $r Apache request
 1117: 
 1118: =item $prog_state Pointer to the data structure returned by Create_PrgWin
 1119: 
 1120: =back
 1121: 
 1122: =back
 1123: 
 1124: Returns: none
 1125: 
 1126: =back
 1127: 
 1128: =cut
 1129: 
 1130: ########################################################
 1131: ########################################################
 1132: 
 1133: 
 1134: # Create progress
 1135: sub Create_PrgWin {
 1136:     my ($r,$number_to_do,$preamble)=@_;
 1137:     my %prog_state;
 1138:     $prog_state{'done'}=0;
 1139:     $prog_state{'firststart'}=&Time::HiRes::time();
 1140:     $prog_state{'laststart'}=&Time::HiRes::time();
 1141:     $prog_state{'max'}=$number_to_do;
 1142:     &Apache::loncommon::LCprogressbar($r,$prog_state{'max'},$preamble); 
 1143:     return %prog_state;
 1144: }
 1145: 
 1146: # update progress
 1147: sub Update_PrgWin {
 1148:     my ($r,$prog_state,$displayString)=@_;
 1149:     &Apache::loncommon::LCprogressbarUpdate($r,undef,$displayString,$$prog_state{'max'});
 1150:     $$prog_state{'laststart'}=&Time::HiRes::time();
 1151: }
 1152: 
 1153: # increment progress state
 1154: sub Increment_PrgWin {
 1155:     my ($r,$prog_state,$extraInfo,$step)=@_;
 1156:     $step = $step > 0 ? $step : 1;
 1157:     $$prog_state{'done'} += $step;
 1158: 
 1159:     # Catch (max modulo step) <> 0
 1160:     my $current = $$prog_state{'done'};
 1161:     my $last = ($$prog_state{'max'} - $current);
 1162:     if ($last <= 0) {
 1163:         $last = 1;
 1164:         $current = $$prog_state{'max'};
 1165:     }
 1166: 
 1167:     my $time_est= (&Time::HiRes::time() - $$prog_state{'firststart'})/
 1168:         $current * $last;
 1169:     $time_est = int($time_est);
 1170:     #
 1171:     my $min = int($time_est/60);
 1172:     my $sec = $time_est % 60;
 1173: 
 1174:     my $lasttime = &Time::HiRes::time()-$$prog_state{'laststart'};
 1175:     if ($lasttime > 9) {
 1176:         $lasttime = int($lasttime);
 1177:     } elsif ($lasttime < 0.01) {
 1178:         $lasttime = 0;
 1179:     } else {
 1180:         $lasttime = sprintf("%3.2f",$lasttime);
 1181:     }
 1182: 
 1183:     $sec = 0 if ($min >= 10); # Don't show seconds if remaining time >= 10 min.
 1184:     $sec = 1 if ( ($min == 0) && ($sec == 0) ); # Little cheating: pretend to have 1 second remaining instead of 0 to have something to display
 1185: 
 1186:     my $timeinfo =
 1187:         &mt('[_1]/[_2]:'
 1188:            .' [quant,_3,minute,minutes,] [quant,_4,second ,seconds ,]remaining'
 1189:            .' ([quant,_5,second] for '.$extraInfo.')',
 1190:             $current,
 1191:             $$prog_state{'max'},
 1192:             $min,
 1193:             $sec,
 1194:             $lasttime);
 1195:     my $percent=0;
 1196:     if ($$prog_state{'max'}) {
 1197:        $percent=int(100.*$current/$$prog_state{'max'});
 1198:     }
 1199:     &Apache::loncommon::LCprogressbarUpdate($r,$percent,$timeinfo,$$prog_state{'max'});
 1200:     $$prog_state{'laststart'}=&Time::HiRes::time();
 1201: }
 1202: 
 1203: # close Progress Line
 1204: sub Close_PrgWin {
 1205:     my ($r,$prog_state)=@_;
 1206:     &Apache::loncommon::LCprogressbarClose($r);
 1207:     undef(%$prog_state);
 1208: }
 1209: 
 1210: 
 1211: # ------------------------------------------------------- Puts directory header
 1212: 
 1213: sub crumbs {
 1214:     my ($uri,$target,$prefix,$form,$skiplast,$onclick)=@_;
 1215: # You cannot crumbnify uploaded or adm resources
 1216:     if ($uri=~/^\/*(uploaded|adm)\//) { return &mt('(Internal Course/Community Content)'); }
 1217:     if ($target) {
 1218:         $target = ' target="'.
 1219:                   &Apache::loncommon::escape_single($target).'"';
 1220:     }
 1221:     my $output='<span class="LC_filename">';
 1222:     $output.=$prefix.'/';
 1223:     if (($env{'user.adv'}) || ($env{'user.author'})) {
 1224:         my $path=$prefix.'/';
 1225:         foreach my $dir (split('/',$uri)) {
 1226:             if (! $dir) { next; }
 1227:             $path .= $dir;
 1228:             if ($path eq $uri) {
 1229:                 if ($skiplast) {
 1230:                     $output.=$dir;
 1231:                     last;
 1232:                 } 
 1233:             } else {
 1234:                 $path.='/'; 
 1235:             }
 1236:             if ($path eq '/res/') {
 1237:                 unless (&Apache::lonnet::allowed('bre',$path)) {
 1238:                     $output.="$dir/";
 1239:                     next;
 1240:                 }
 1241:             }
 1242:             my $href_path = &HTML::Entities::encode($path,'<>&"');
 1243:             &Apache::loncommon::inhibit_menu_check(\$href_path);
 1244:             if ($form) {
 1245:                 my $href = 'javascript:'.$form.".action='".$href_path."';".$form.'.submit();';
 1246:                 $output.=qq{<a href="$href"$onclick$target>$dir</a>/};
 1247:             } else {
 1248:                 $output.=qq{<a href="$href_path"$onclick$target>$dir</a>/};
 1249:             }
 1250:         }
 1251:     } else {
 1252:         foreach my $dir (split('/',$uri)) {
 1253:             if (! $dir) { next; }
 1254:             $output.=$dir.'/';
 1255:         }
 1256:     }
 1257:     if ($uri !~ m|/$|) { $output=~s|/$||; }
 1258:     $output.='</span>';
 1259: 
 1260: 
 1261:     return $output;
 1262: }
 1263: 
 1264: # --------------------- A function that generates a window for the spellchecker
 1265: 
 1266: sub spellheader {
 1267:     my $start_page=
 1268: 	&Apache::loncommon::start_page('Speller Suggestions',undef,
 1269: 				       {'only_body'   => 1,
 1270: 					'js_ready'    => 1,
 1271: 					'bgcolor'     => '#DDDDDD',
 1272: 				        'add_entries' => {
 1273: 					    'onload' => 
 1274:                                                'document.forms.spellcheckform.submit()',
 1275:                                              }
 1276: 				        });
 1277:     my $end_page=
 1278: 	&Apache::loncommon::end_page({'js_ready'  => 1}); 
 1279: 
 1280:     my $nothing=&javascript_nothing();
 1281:     return (<<ENDCHECK);
 1282: <script type="text/javascript"> 
 1283: // <![CDATA[
 1284: //<!-- BEGIN LON-CAPA Internal
 1285: var checkwin;
 1286: 
 1287: function spellcheckerwindow(string) {
 1288:     var esc_string = string.replace(/\"/g,'&quot;');
 1289:     checkwin=window.open($nothing,'spellcheckwin','height=320,width=280,resizable=yes,scrollbars=yes,location=no,menubar=no,toolbar=no');
 1290:     checkwin.document.writeln('$start_page<form name="spellcheckform" action="/adm/spellcheck" method="post"><input type="hidden" name="text" value="'+esc_string+'" /><\\/form>$end_page');
 1291:     checkwin.document.close();
 1292: }
 1293: // END LON-CAPA Internal -->
 1294: // ]]>
 1295: </script>
 1296: ENDCHECK
 1297: }
 1298: 
 1299: # ---------------------------------- Generate link to spell checker for a field
 1300: 
 1301: sub spelllink {
 1302:     my ($form,$field)=@_;
 1303:     my $linktext=&mt('Check Spelling');
 1304:     return (<<ENDLINK);
 1305: <a href="javascript:if (typeof(document.$form.onsubmit)!='undefined') { if (document.$form.onsubmit!=null) { document.$form.onsubmit();}};spellcheckerwindow(this.document.forms.$form.$field.value);">$linktext</a>
 1306: ENDLINK
 1307: }
 1308: 
 1309: # ------------------------------------------------- Output headers for CKEditor
 1310: 
 1311: sub htmlareaheaders {
 1312: 	my $s="";
 1313: 	if (&htmlareabrowser()) {
 1314: 		$s.=(<<ENDEDITOR);
 1315: <script type="text/javascript" src="/ckeditor/ckeditor.js"></script>
 1316: ENDEDITOR
 1317: 	}
 1318:     $s.=(<<ENDJQUERY);
 1319: <script type="text/javascript" src="/adm/jQuery/js/jquery-3.2.1.min.js"></script>
 1320: <script type="text/javascript" src="/adm/jQuery/js/jquery-ui-1.12.1.custom.min.js"></script>
 1321: <link rel="stylesheet" type="text/css" href="/adm/jQuery/css/smoothness/jquery-ui-1.12.1.custom.min.css" />
 1322: <script type="text/javascript" src="/adm/jpicker/js/jpicker-1.1.6.min.js" >
 1323: </script>
 1324: <link rel="stylesheet" type="text/css" href="/adm/jpicker/css/jPicker-1.1.6.min.css" />
 1325: <script type="text/javascript" src="/adm/countdown/js/jquery.countdown.min.js"></script>
 1326: <link rel="stylesheet" type="text/css" href="/adm/countdown/css/jquery.countdown.css" />
 1327: 
 1328: <script type="text/javascript" src="/adm/spellchecker/js/jquery.spellchecker.min.js"></script>
 1329: <link rel="stylesheet" type="text/css" href="/adm/spellchecker/css/spellchecker.css" />
 1330: <script type="text/javascript" src="/adm/nicescroll/jquery.nicescroll.min.js"></script>
 1331: 
 1332: ENDJQUERY
 1333: 	return $s;
 1334: }
 1335: 
 1336: # ----------------------------------------------------------------- Preferences
 1337: 
 1338: # ------------------------------------------------- lang to use in html editor
 1339: sub htmlarea_lang {
 1340:     my $lang='en';
 1341:     if (&mt('htmlarea_lang') ne 'htmlarea_lang') {
 1342: 	$lang=&mt('htmlarea_lang');
 1343:     }
 1344:     return $lang;
 1345: }
 1346: 
 1347: # return javacsript to activate elements of .colorchooser with jpicker:
 1348: # Caller is responsible for enclosing this in <script> tags:
 1349: #
 1350: sub color_picker {
 1351:     return '
 1352: $(document).ready(function(){
 1353:     $.fn.jPicker.defaults.images.clientPath="/adm/jpicker/images/";
 1354:     $(".colorchooser").jPicker({window: { position: {x: "screenCenter", y: "bottom"}}});
 1355: });';
 1356: }
 1357: 
 1358: sub countdown {
 1359: 
 1360:     # Code to put a due date countdown in 'duedatecountdown' span.
 1361:     # This is currently located in the breadcrumb headers.
 1362:     # note that the dueDateLayout is internatinoalized below.
 1363:     # Here document is used to support the substitution into the javascript below.
 1364:     # ..which unforunately necessitates escaping the $'s in the javascript.
 1365:     # There are several times of importance
 1366:     #
 1367:     # serverDueDate -  The absolute time at which the problem expires.
 1368:     # serverTime    -  The server's time when the problem finished computing.
 1369:     # clientTime    -  The client's time...as close to serverTime as possible.
 1370:     #                  The clientTime will be slightly later due to
 1371:     #                  1. The latency between problem computation and
 1372:     #                     the first network action.
 1373:     #                  2. The time required between the page load-start and the actual
 1374:     #                     initial javascript execution that got clientTime.
 1375:     # These are used as follows:
 1376:     #   The difference between clientTime and serverTime are used to
 1377:     #   correct for differences in clock settings between the browser's system and the
 1378:     #   server's.
 1379:     #
 1380:     #   The difference between clientTime and the time at which the ready() method
 1381:     #   starts executing is used to estimate latencies for page load and submission.
 1382:     #   Since this is an estimate, it is doubled.  The latency estimate + one minute
 1383:     #   is used to determine when the countdown timer turns red to warn the user
 1384:     #   to think about submitting.
 1385: 
 1386: 
 1387:     my $dueDateLayout = &mt('Due in: {dn} {dl} {hnn}{sep}{mnn}{sep}{snn} [_1]',
 1388:                             "<span id='submitearly'></span>");
 1389:     my $early = '- <b>'.&mt('Submit Early').'</b>';
 1390:     my $pastdue = '- <b>'.&mt('Past Due').'</b>';
 1391:     return <<"JAVASCRIPT";
 1392: 
 1393:     var documentReadyTime;
 1394: 
 1395: \$(document).ready(function() {
 1396:    if (typeof(dueDate) != "undefined") {
 1397:        documentReadyTime = (new Date()).getTime();
 1398:       \$("#duedatecountdown").countdown({until: dueDate, compact: true,
 1399:          layout: "$dueDateLayout",
 1400:          onTick: function (periods) {
 1401:             var latencyEstimate = (documentReadyTime - clientTime) * 2;
 1402:             if(\$.countdown.periodsToSeconds(periods) < (300 + latencyEstimate)) {
 1403:                \$("#submitearly").html("$early");
 1404:                if (\$.countdown.periodsToSeconds(periods) < 1) {
 1405:                     \$("#submitearly").html("$pastdue");
 1406:                }
 1407:             }
 1408:             if(\$.countdown.periodsToSeconds(periods) < (60 + latencyEstimate)) {
 1409:                \$(this).css("color", "red");   //Highlight last minute.
 1410:             }
 1411:          }
 1412:       });
 1413:    }
 1414: });
 1415: 
 1416: JAVASCRIPT
 1417: 
 1418: }
 1419: 
 1420: # ----------------------------------------- Script to activate only some fields
 1421: 
 1422: sub htmlareaselectactive {
 1423:     my ($args) = @_; 
 1424:     unless (&htmlareabrowser()) { return ''; }
 1425:     my $output='<script type="text/javascript" defer="defer">'."\n"
 1426:               .'// <![CDATA['."\n"
 1427:               .'//<!-- BEGIN LON-CAPA Internal'."\n";
 1428:     my $lang = &htmlarea_lang();
 1429:     my $fullpage = 'false';
 1430:     my ($dragmath_prefix,$dragmath_helpicon,$dragmath_whitespace);
 1431:     if (ref($args) eq 'HASH') {
 1432:         if (exists($args->{'lang'})) {
 1433:             if ($args->{'lang'} ne '') {
 1434:                 $lang = $args->{'lang'};
 1435:             }
 1436:         }
 1437:         if (exists($args->{'fullpage'})) { 
 1438:             if ($args->{'fullpage'} eq 'true') {
 1439:                 $fullpage = $args->{'fullpage'};
 1440:             }
 1441:         }
 1442:         if (exists($args->{'dragmath'})) {
 1443:             if ($args->{'dragmath'} ne '') {
 1444:                 $dragmath_prefix = $args->{'dragmath'};
 1445:                 $dragmath_helpicon=&Apache::loncommon::lonhttpdurl("/adm/help/help.png");
 1446:                 $dragmath_whitespace=&Apache::loncommon::lonhttpdurl("/adm/lonIcons/transparent1x1.gif");
 1447:             }
 1448:         }
 1449:     }
 1450: 
 1451:     my %lt = &Apache::lonlocal::texthash(
 1452:               'plain'       => 'Plain text',
 1453:               'rich'        => 'Rich formatting',
 1454:               'plain_title' => 'Disable rich text formatting and edit in plain text',
 1455:               'rich_title'  => 'Enable rich text formatting (bold, italic, etc.)',
 1456:           );
 1457: 
 1458:     $output.='
 1459:     
 1460:     function containsBlockHtml(id) {
 1461: 		var re = $("#"+id).html().search(/(?:\&lt\;|\<)(br|h1|h2|h3|h4|h5|h6|p|ol|ul|table|pre|address|blockquote|center|div)[\s]*((?:[\/]*[\s]*(?:\&gt\;|\>)|(?:\&gt\;|\>)[\s\S]*(?:\&lt\;|\<)\/[\s]*\1[\s]*\(?:\&gt\;|\>))/im);
 1462:     	return (re >= 0);
 1463:     }
 1464:     
 1465:     function startRichEditor(id) {
 1466:         // fix character entities inside <m>
 1467:         // NOTE: this is not fixing characters inside <parse>
 1468:         // NOTE: < and > inside <chem> should fix automatically because there should not be a letter after <.
 1469:         var ta = document.getElementById(id);
 1470:         var value = ta.value;
 1471:         var in_m = false; // in the m element
 1472:         var in_text = false; // in the text inside the m element
 1473:         var im = -1; // position of <m>
 1474:         var it = -1; // position of the text inside
 1475:         for (var i=0; i<value.length; i++) {
 1476:             if (value.substr(i, 2) == "<m") {
 1477:                 // ignore previous <m> if found twice
 1478:                 in_m = true;
 1479:                 in_text = false;
 1480:                 im = i;
 1481:                 it = -1;
 1482:             } else if (in_m) {
 1483:                 if (!in_text) {
 1484:                     if (value.charAt(i) == ">") {
 1485:                         in_text = true;
 1486:                         it = i+1;
 1487:                     }
 1488:                 } else if (value.substr(i, 4) == "</m>") {
 1489:                     in_m = false;
 1490:                     var text = value.substr(it, i-it);
 1491:                     var l1 = text.length;
 1492:                     text = text.replace(/</g, "&lt;");
 1493:                     text = text.replace(/>/g, "&gt;");
 1494:                     var l2 = text.length;
 1495:                     value = value.substr(0, it) + text + "</m>" + value.substr(i+4);
 1496:                     i = i + (l2-l1);
 1497:                 }
 1498:             }
 1499:         }
 1500:         ta.value = value;
 1501:     	CKEDITOR.replace(id, 
 1502:     		{
 1503:     			customConfig: "/ckeditor/loncapaconfig.js",
 1504:                         language : "'.$lang.'",
 1505:                         fullPage : '.$fullpage.',
 1506:     		}
 1507:     	);
 1508:     }
 1509:     
 1510:     function destroyRichEditor(id) {
 1511:     	CKEDITOR.instances[id].destroy();
 1512:         // replace character entities &lt; and &gt; in <m> and <chem>
 1513:         // and "&amp;fctname(" by "&fctname("
 1514:         // and the quotes inside functions: "&fct(1, &quot;a&quot;)" -> "&fct(1, "a")"
 1515:         var ta = document.getElementById(id);
 1516:         var value = ta.value;
 1517:         var in_element = false; // in the m or chem element
 1518:         var tagname = ""; // m or chem
 1519:         var in_text = false; // in the text inside the element
 1520:         var im = -1; // position of start tag
 1521:         var it = -1; // position of the text inside
 1522:         for (var i=0; i<value.length; i++) {
 1523:             if (value.substr(i, 2) == "<m" || value.substr(i, 5) == "<chem") {
 1524:                 // ignore previous tags if found twice
 1525:                 in_element = true;
 1526:                 if (value.substr(i, 2) == "<m")
 1527:                     tagname = "m";
 1528:                 else
 1529:                     tagname = "chem";
 1530:                 in_text = false;
 1531:                 im = i;
 1532:                 it = -1;
 1533:             } else if (in_element) {
 1534:                 if (!in_text) {
 1535:                     if (value.charAt(i) == ">") {
 1536:                         in_text = true;
 1537:                         it = i+1;
 1538:                     }
 1539:                 } else if (value.substr(i, 3+tagname.length) == "</"+tagname+">") {
 1540:                     in_element = false;
 1541:                     var text = value.substr(it, i-it);
 1542:                     var l1 = text.length;
 1543:                     text = text.replace(/&lt;/g, "<");
 1544:                     text = text.replace(/&gt;/g, ">");
 1545:                     var l2 = text.length;
 1546:                     value = value.substr(0, it) + text + value.substr(i);
 1547:                     i = i + (l2-l1);
 1548:                 }
 1549:             }
 1550:         }
 1551:         // fix function names
 1552:         value = value.replace(/&amp;([a-zA-Z_]+)\(/g, "&$1(");
 1553:         // fix quotes in functions
 1554:         var pos_next_fct = value.search(/&[a-zA-Z_]+\(/);
 1555:         var depth = 0;
 1556:         for (var i=0; i<value.length; i++) {
 1557:             if (i == pos_next_fct) {
 1558:                 depth++;
 1559:                 var sub = value.substring(i+1);
 1560:                 var pos2 = sub.search(/&[a-zA-Z_]+\(/);
 1561:                 if (pos2 == -1)
 1562:                     pos_next_fct = -1;
 1563:                 else
 1564:                     pos_next_fct = i + 1 + pos2;
 1565:             } else if (depth > 0) {
 1566:                 if (value.charAt(i) == ")")
 1567:                     depth--;
 1568:                 else if (value.substr(i, 6) == "&quot;")
 1569:                     value = value.substr(0, i) + "\"" + value.substr(i+6);
 1570:             }
 1571:         }
 1572:         // replace the text value
 1573:         ta.value = value;
 1574:     }
 1575:     
 1576:     function editorHandler(event) {
 1577:     	var rawid = $(this).attr("id");
 1578:     	var id = new RegExp("LC_rt_(.*)").exec(rawid)[1];
 1579:     	event.preventDefault();
 1580:     	var rt_enabled  = $(this).hasClass("LC_enable_rt");
 1581:         if (rt_enabled) {
 1582:     		startRichEditor(id);
 1583: 			$("#LC_rt_"+id).html("<b>&laquo; '.$lt{'plain'}.'</b>");
 1584: 			$("#LC_rt_"+id).attr("title", "'.$lt{'plain_title'}.'");
 1585: 			$("#LC_rt_"+id).addClass("LC_disable_rt");
 1586: 			$("#LC_rt_"+id).removeClass("LC_enable_rt");
 1587:     	} else {
 1588: 			destroyRichEditor(id);
 1589: 			$("#LC_rt_"+id).html("<b>'.$lt{'rich'}.' &raquo;</b>");
 1590: 			$("#LC_rt_"+id).attr("title", "'.$lt{'rich_title'}.'");
 1591: 			$("#LC_rt_"+id).addClass("LC_enable_rt");
 1592: 			$("#LC_rt_"+id).removeClass("LC_disable_rt");
 1593: 	}';
 1594:     if ($dragmath_prefix ne '') {
 1595:         $output .= "\n                 var visible = '';
 1596:                                        if (rt_enabled) {
 1597:                                            visible = 'none';
 1598:                                        }
 1599:                                        editmath_visibility(id,visible);\n";
 1600:     }
 1601:     $output .= '
 1602:     }
 1603:     $(document).ready(function(){
 1604: 		$(".LC_richAlwaysOn").each(function() {
 1605: 			startRichEditor($(this).attr("id"));
 1606: 		});
 1607: 		$(".LC_richDetectHtml").each(function() {
 1608: 			var id = $(this).attr("id");
 1609:                         var rt_enabled = containsBlockHtml(id);
 1610: 			if(rt_enabled) {
 1611: 				$(this).before("<div><a href=\"#\" id=\"LC_rt_"+id+"\" title=\"'.$lt{'plain_title'}.'\" class=\"LC_disable_rt\"><b>&laquo; '.$lt{'plain'}.'</b></a></div>");				
 1612: 				startRichEditor(id);
 1613: 				$("#LC_rt_"+id).click(editorHandler);
 1614: 			}
 1615: 			else {
 1616: 				$(this).before("<div><a href=\"#\" id=\"LC_rt_"+id+"\" title=\"'.$lt{'rich_title'}.'\" class=\"LC_enable_rt\"><b>'.$lt{'rich'}.' &raquo;</b></a></div>");
 1617: 				$("#LC_rt_"+id).click(editorHandler);
 1618: 			}';
 1619:     if ($dragmath_prefix ne '') {
 1620:         $output .= "\n                 var visible = '';
 1621:                                        if (rt_enabled) {
 1622:                                            visible = 'none';
 1623:                                        }
 1624:                                        editmath_visibility(id,visible);\n";
 1625:     }
 1626:     $output .= '
 1627: 		});
 1628: 		$(".LC_richDefaultOn").each(function() {
 1629: 			var id = $(this).attr("id");
 1630: 			$(this).before("<div><a href=\"#\" id=\"LC_rt_"+id+"\" title=\"'.$lt{'plain_title'}.'\" class=\"LC_disable_rt\"><b>&laquo; '.$lt{'plain'}.'</b></a></div>");				
 1631: 			startRichEditor(id);
 1632: 			$("#LC_rt_"+id).click(editorHandler);
 1633: 		});
 1634: 		$(".LC_richDefaultOff").each(function() {
 1635: 			var id = $(this).attr("id");
 1636: 			$(this).before("<div><a href=\"#\" id=\"LC_rt_"+id+"\" title=\"'.$lt{'rich_title'}.'\" class=\"LC_enable_rt\"><b>'.$lt{'rich'}.' &raquo;</b></a></div>");
 1637: 			$("#LC_rt_"+id).click(editorHandler);
 1638: 		});
 1639: 
 1640: 
 1641: 	});
 1642: ';
 1643:     $output .= &color_picker();
 1644: 
 1645:     $output .= &countdown();
 1646: 
 1647:     $output .= <<"JAVASCRIPT";
 1648: 
 1649:     /* This code describes the spellcheck options that will be used for
 1650:        items with class 'spellchecked'.  It is necessary for those objects'
 1651:        to explicitly request checking (e.g. onblur is a nice event for that).
 1652:      */
 1653:      \$(document).ready(function() {
 1654: 	 \$(".spellchecked").spellchecker({
 1655: 	   url: "/ajax/spellcheck",
 1656: 	   lang: "en",                      
 1657: 	   engine: "pspell",
 1658: 	   suggestionBoxPosition: "below",
 1659: 	   innerDocument: true
 1660: 					  });
 1661: 	 \$("textarea.spellchecked").spellchecker({
 1662: 	   url: "/ajax/spellcheck",
 1663: 	   lang: "en",                      
 1664: 	   engine: "pspell",
 1665: 	   suggestionBoxPosition: "below",
 1666: 	   innerDocument: true
 1667: 					  });
 1668: 
 1669: 			});
 1670: 
 1671:     /* the muli colored editor can generate spellcheck with language 'none'
 1672:        to disable spellcheck as well
 1673:     */
 1674:     function doSpellcheck(element, lang) {
 1675: 	if (lang != 'none') {
 1676:  	    \$(element).spellchecker('option', {lang: lang});
 1677: 	    \$(element).spellchecker('check');
 1678:         }
 1679:     }
 1680: 
 1681: 
 1682: JAVASCRIPT
 1683:     if ($dragmath_prefix ne '') {
 1684:         $output .= '
 1685: 
 1686:      function editmath_visibility(id,value) {
 1687: 
 1688:          if ((id == "") || (id == null)) {
 1689:              return;
 1690:          }
 1691:          var mathid = "'.$dragmath_prefix.'_"+id;
 1692:          mathele = document.getElementById(mathid);
 1693:          if (mathele == null) {
 1694:              return;
 1695:          }
 1696:          mathele.style.display = value;
 1697:          var mathhelpicon = "'.$dragmath_prefix.'helpicon'.'_"+id;
 1698:          mathhelpiconele = document.getElementById(mathhelpicon);
 1699:          if (mathhelpiconele == null) {
 1700:              return;
 1701:          }
 1702:          if (value == "none") {
 1703:              mathhelpiconele.src = "'.$dragmath_whitespace.'";
 1704:          } else {
 1705:              mathhelpiconele.src = "'.$dragmath_helpicon.'";
 1706:          }
 1707:      }
 1708: ';
 1709: 
 1710:     }
 1711:     $output.="\nwindow.status='Activated Editfields';\n"
 1712:             .'// END LON-CAPA Internal -->'."\n"
 1713:             .'// ]]>'."\n"
 1714:             .'</script>';
 1715:     return $output;
 1716: }
 1717: 
 1718: # --------------------------------------------------------------------- Blocked
 1719: 
 1720: sub htmlareablocked {
 1721:     unless ($env{'environment.wysiwygeditor'} eq 'on') { return 1; }
 1722:     return 0;
 1723: }
 1724: 
 1725: # ---------------------------------------- Browser capable of running HTMLArea?
 1726: 
 1727: sub htmlareabrowser {
 1728:     return 1;
 1729: }
 1730: 
 1731: #
 1732: # Should the "return to content" link be shown?
 1733: #
 1734: 
 1735: sub show_return_link {
 1736: 
 1737:     unless ($env{'request.course.id'}) { return 0; }
 1738:     if ($env{'request.noversionuri'}=~m{^/priv/} ||
 1739:         $env{'request.uri'}=~m{^/priv/}) { return 1; }
 1740:     return if ($env{'request.noversionuri'} eq '/adm/supplemental');
 1741:     return if (($env{'course.'.$env{'request.course.id'}.'.type'} eq 'Placement') &&
 1742:                (!$env{'request.role.adv'}));
 1743:     if (($env{'request.noversionuri'} =~ m{^/adm/viewclasslist($|\?)})
 1744:         || ($env{'request.noversionuri'} =~ m{^/adm/.*/aboutme($|\?)})) {
 1745: 
 1746:         return if ($env{'form.register'});
 1747:     }
 1748:     return (($env{'request.noversionuri'}=~m{^/(res|public)/} &&
 1749:              $env{'request.symb'} eq '')
 1750:             ||
 1751:             ($env{'request.noversionuri'}=~ m{^/cgi-bin/printout.pl})
 1752:             ||
 1753:             (($env{'request.noversionuri'}=~/^\/adm\//) &&
 1754:              ($env{'request.noversionuri'}!~/^\/adm\/wrapper\//) &&
 1755:              ($env{'request.noversionuri'}!~
 1756:               m{^/adm/.*/(smppg|bulletinboard|ext\.tool)($|\?)})
 1757:            ));
 1758: }
 1759: 
 1760: 
 1761: ##
 1762: #   Set the dueDate variable...note this is done in the timezone
 1763: #   of the browser.
 1764: #
 1765: # @param epoch relative time at which the problem is due.
 1766: #
 1767: # @return the javascript fragment to set the date:
 1768: #
 1769: sub set_due_date {
 1770:     my $dueStamp = shift;
 1771:     my $duems    = $dueStamp * 1000; # Javascript Date object needs ms not seconds.
 1772: 
 1773:     my $now = time()*1000;
 1774: 
 1775:     # This slightly obscure bit of javascript sets the dueDate variable
 1776:     # to the time in the browser at which the problem was due.  
 1777:     # The code should correct for gross differences between the server
 1778:     # and client's time setting
 1779: 
 1780:      return <<"END";
 1781: 
 1782: <script type="text/javascript">
 1783:   //<![CDATA[
 1784: var serverDueDate = $duems;
 1785: var serverTime    = $now;
 1786: var clientTime    = (new Date()).getTime();
 1787: var dueDate       = new Date(serverDueDate + (clientTime - serverTime));
 1788: 
 1789:   //]]>
 1790: </script>
 1791: 
 1792: END
 1793: }
 1794: ##
 1795: # Sets the time at which the problem finished computing.
 1796: # This just updates the serverTime and clientTime variables above.
 1797: # Calling this in e.g. end_problem provides a better estimate of the
 1798: # difference beetween the server and client time setting as 
 1799: # the difference contains less of the latency/problem compute time.
 1800: #
 1801: sub set_compute_end_time {
 1802: 
 1803:     my $now = time()*1000;	# Javascript times are in ms.
 1804:     return <<"END";
 1805: 
 1806: <script type="text/javascript">
 1807: //<![CDATA[
 1808: serverTime = $now;
 1809: clientTime = (new Date()).getTime();
 1810: //]]>
 1811: </script>
 1812: 
 1813: END
 1814: }
 1815: 
 1816: ############################################################
 1817: ############################################################
 1818: 
 1819: =pod
 1820: 
 1821: =item &breadcrumbs()
 1822: 
 1823: Compiles the previously registered breadcrumbs into an series of links.
 1824: Additionally supports a 'component', which will be displayed on the
 1825: right side of the breadcrumbs enclosing div (without a link).
 1826: A link to help for the component will be included if one is specified.
 1827: 
 1828: All inputs can be undef without problems.
 1829: 
 1830: =over
 1831: 
 1832: =item Inputs:
 1833: 
 1834: =over
 1835: 
 1836: =item $component
 1837: 
 1838: the text on the right side of the breadcrumbs trail
 1839: 
 1840: =item $component_help
 1841: 
 1842: the help item filename (without .tex extension).
 1843: 
 1844: =item $menulink
 1845: 
 1846: boolean, controls whether to include a link to /adm/menu
 1847: 
 1848: =item $helplink
 1849: 
 1850: if 'nohelp' don't include the orange help link
 1851: 
 1852: =item $css_class
 1853: 
 1854: optional name for the class to apply to the table for CSS
 1855: 
 1856: =item $no_mt 
 1857: 
 1858: optional flag, 1 if &mt() is _not_ to be applied to $component when including the text on the right
 1859: 
 1860: =item $CourseBreadcrumbs
 1861: 
 1862: optional flag, 1 if &breadcrumbs called from &docs_breadcrumbs, because breadcrumbs are being
 1863: used to display hierarchy for current folder shown in the Course Editor. 
 1864: 
 1865: =item $topic_help
 1866: 
 1867: optional help item to be displayed on right side of the breadcrumbs row, using 
 1868: loncommon::help_open_topic() to generate the link. 
 1869: 
 1870: =item $topic_help_text
 1871: 
 1872: text to include in the link in the optional help item ($topic_help) on the right
 1873: side of the breadcrumbs row.
 1874: 
 1875: =item $links_target
 1876: 
 1877: optionally includes the target (_top, _parent or _self) for (i) initial
 1878: $menulink item in the breadcrumbs (if present), (ii) return to last location
 1879: (if present), and (iii) help item at the right side of breadcrumbs menu, 
 1880: created by loncommon::help_open_topic() or loncommon::help_open_menu().
 1881: 
 1882: =back
 1883: 
 1884: =back
 1885: 
 1886: Returns a string containing breadcrumbs for the current page.
 1887: 
 1888: =item &clear_breadcrumbs()
 1889: 
 1890: Clears the previously stored breadcrumbs.
 1891: 
 1892: =item &add_breadcrumb()
 1893: 
 1894: Pushes a breadcrumb on the stack of crumbs.
 1895: 
 1896: input: $breadcrumb, a hash reference.  The keys 'href','title', and 'text'
 1897: are required.  If present the keys 'faq' and 'bug' will be used to provide
 1898: links to the FAQ and bug sites. If the key 'no_mt' is present the 'title' 
 1899: and 'text' values won't be sent through &mt()
 1900: 
 1901: returns: nothing    
 1902: 
 1903: =cut
 1904: 
 1905: ############################################################
 1906: ############################################################
 1907: {
 1908:     my @Crumbs;
 1909:     my %tools = ();
 1910:     
 1911:     sub breadcrumbs {
 1912:         my ($component,$component_help,$menulink,$helplink,$css_class,$no_mt, 
 1913:             $CourseBreadcrumbs,$topic_help,$topic_help_text,$links_target) = @_;
 1914:         #
 1915:         $css_class ||= 'LC_breadcrumbs';
 1916: 
 1917:         # Make the faq and bug data cascade
 1918:         my $faq  = '';
 1919:         my $bug  = '';
 1920:         my $help = '';
 1921:         # Crumb Symbol
 1922:         my $crumbsymbol = '&raquo;';
 1923:         # The last breadcrumb does not have a link, so handle it separately.
 1924:         my $last = pop(@Crumbs);
 1925:         #
 1926:         # The first one should be the course or a menu link
 1927:         if (!defined($menulink)) { $menulink=1; }
 1928:         if ($menulink) {
 1929:             if ($env{'request.course.id'}) {
 1930:                 my ($menucoll,$deeplinkmenu,$menuref) = &Apache::loncommon::menucoll_in_effect();
 1931:                 if (($menucoll) && (ref($menuref) eq 'HASH')) {
 1932:                     if ($menuref->{'main'} eq 'n') {
 1933:                        undef($menulink);
 1934:                     }
 1935:                 }
 1936:             }
 1937:         }
 1938:         if ($menulink) {
 1939:             my $description = 'Menu';
 1940:             my $no_mt_descr = 0;
 1941:             if ((exists($env{'request.course.id'})) && 
 1942:                 ($env{'request.course.id'} ne '') && 
 1943:                 ($env{'course.'.$env{'request.course.id'}.'.description'} ne '')) {
 1944:                 $description = 
 1945:                     $env{'course.'.$env{'request.course.id'}.'.description'};
 1946:                 $no_mt_descr = 1;
 1947:                 if ($env{'request.noversionuri'} =~ 
 1948:                     m{^/?public/($match_domain)/($match_courseid)/syllabus$}) {
 1949:                     unless (($env{'course.'.$env{'request.course.id'}.'.domain'} eq $1) &&
 1950:                             ($env{'course.'.$env{'request.course.id'}.'.num'} eq $2)) {
 1951:                         $description = 'Menu';
 1952:                         $no_mt_descr = 0;
 1953:                     }
 1954:                 }
 1955:             }
 1956:             my $target = '_top';
 1957:             if ($links_target) {
 1958:                 $target = $links_target;
 1959:             } elsif ((($env{'request.lti.login'}) && ($env{'request.lti.target'} eq 'iframe')) ||
 1960:                 (($env{'request.deeplink.login'}) && ($env{'request.deeplink.target'} eq '_self'))) {
 1961:                 $target='';
 1962:             }
 1963:             $menulink =  {  href   =>'/adm/menu',
 1964:                             title  =>'Go to main menu',
 1965:                             target =>$target,
 1966:                             text   =>$description,
 1967:                             no_mt  =>$no_mt_descr, };
 1968:             if($last) {
 1969:                 #$last set, so we have some crumbs
 1970:                 unshift(@Crumbs,$menulink);
 1971:             } else {
 1972:                 #only menulink crumb present
 1973:                 $last = $menulink;
 1974:             }
 1975:         }
 1976:         my $links;
 1977:         if ((&show_return_link) && (!$CourseBreadcrumbs) && (ref($last) eq 'HASH')) {
 1978:             my $alttext = &mt('Go Back');
 1979:             my $hashref = { href => '/adm/flip?postdata=return:',
 1980:                             title => &mt('Back to most recent content resource'),
 1981:                             class => 'LC_menubuttons_link',
 1982:                           };
 1983:             if ($links_target) {
 1984:                 $hashref->{'target'} = $links_target;
 1985:             }
 1986:             $links=&htmltag( 'a','<img src="/res/adm/pages/tolastloc.png" alt="'.$alttext.'" class="LC_icon" />',
 1987:                              $hashref);
 1988:             $links=&htmltag('li',$links);
 1989:         }
 1990:         $links.= join "", 
 1991:              map {
 1992:                  $faq  = $_->{'faq'}  if (exists($_->{'faq'}));
 1993:                  $bug  = $_->{'bug'}  if (exists($_->{'bug'}));
 1994:                  $help = $_->{'help'} if (exists($_->{'help'}));
 1995: 
 1996:                  my $result = $_->{no_mt} ? $_->{text} : &mt($_->{text});
 1997: 
 1998:                  if ($_->{href}){
 1999:                      $result = &htmltag( 'a', $result, 
 2000:                        { href   => $_->{href},
 2001:                          title  => $_->{no_mt} ? $_->{title} : &mt($_->{title}),
 2002:                          target => $_->{target}, });
 2003:                  }
 2004: 
 2005:                  $result = &htmltag( 'li', "$result $crumbsymbol");
 2006:              } @Crumbs;
 2007: 
 2008:         #should the last Element be translated?
 2009: 
 2010:         my $lasttext = $last->{'no_mt'} ? $last->{'text'} 
 2011:                      : mt( $last->{'text'} );
 2012: 
 2013:         # last breadcrumb is the first order heading of a page
 2014:         # for course breadcrumbs it's just bold
 2015: 
 2016:         if ($lasttext ne '') {
 2017:             $links .= &htmltag( 'li', htmltag($CourseBreadcrumbs ? 'b' : 'h1',
 2018:                     $lasttext), {title => $lasttext});
 2019:         }
 2020: 
 2021:         my $icons = '';
 2022:         $faq  = $last->{'faq'}  if (exists($last->{'faq'}));
 2023:         $bug  = $last->{'bug'}  if (exists($last->{'bug'}));
 2024:         $help = $last->{'help'} if (exists($last->{'help'}));
 2025:         $component_help=($component_help?$component_help:$help);
 2026: #        if ($faq ne '') {
 2027: #            $icons .= &Apache::loncommon::help_open_faq($faq);
 2028: #        }
 2029: #        if ($bug ne '') {
 2030: #            $icons .= &Apache::loncommon::help_open_bug($bug);
 2031: #        }
 2032:         if ($faq ne '' || $component_help ne '' || $bug ne '') {
 2033:             $icons .= &Apache::loncommon::help_open_menu($component,
 2034:                                                          $component_help,
 2035:                                                          $faq,$bug,'','','','',
 2036:                                                          $links_target);
 2037:         }
 2038:         if ($topic_help && $topic_help_text) {
 2039:            $icons .= ' '.&Apache::loncommon::help_open_topic($topic_help,&mt($topic_help_text),'',
 2040:                                                              undef,600,'',$links_target);
 2041:         }
 2042:         #
 2043: 
 2044: 		
 2045:         if ($links ne '') {
 2046:             unless ($CourseBreadcrumbs) {
 2047:                 $links = &htmltag('ol',  $links, { id => "LC_MenuBreadcrumbs"   });
 2048:             } else {
 2049:                 $links = &htmltag('ul',  $links, { class => "LC_CourseBreadcrumbs" });
 2050:             }
 2051:         }
 2052: 
 2053: 
 2054:         if (($component) || ($topic_help && $topic_help_text)) {
 2055:             $links = &htmltag('span', 
 2056:                              ( $no_mt ? $component : mt($component) ).
 2057:                              ( $icons ? $icons : '' ),
 2058:                              { class => 'LC_breadcrumbs_component' } )
 2059:                              .$links 
 2060: ;
 2061:         }
 2062:         my $nav_and_tools = 0;
 2063:         foreach my $item ('navigation','tools') {
 2064:             if (ref($tools{$item}) eq 'ARRAY') {
 2065:                 $nav_and_tools += scalar(@{$tools{$item}})
 2066:             }
 2067:         }
 2068:         if (($links ne '') || ($nav_and_tools)) {
 2069:             &render_tools(\$links);
 2070:             $links = &htmltag('div', $links, 
 2071:                               { id => "LC_breadcrumbs" }) unless ($CourseBreadcrumbs) ;
 2072:         }
 2073:         my $adv_tools = 0;
 2074:         if (ref($tools{'advtools'}) eq 'ARRAY') {
 2075:             $adv_tools = scalar(@{$tools{'advtools'}});
 2076:         }
 2077:         if (($links ne '') || ($adv_tools)) {
 2078:             &render_advtools(\$links);
 2079:         }
 2080: 
 2081:         # Return the @Crumbs stack to what we started with
 2082:         push(@Crumbs,$last);
 2083:         shift(@Crumbs);
 2084: 
 2085: 
 2086:         # Return the breadcrumb's line
 2087: 
 2088:     
 2089: 
 2090:         return "$links";
 2091:     }
 2092: 
 2093:     sub clear_breadcrumbs {
 2094:         undef(@Crumbs);
 2095:         undef(%tools);
 2096:     }
 2097: 
 2098:     sub add_breadcrumb {
 2099:         push(@Crumbs,@_);
 2100:     }
 2101:     
 2102: =item &add_breadcrumb_tool($category, $html)
 2103: 
 2104: Adds $html to $category of the breadcrumb toolbar container.
 2105: 
 2106: $html is usually a link to a page that invokes a function on the currently 
 2107: displayed data (e.g. print when viewing a problem)
 2108: 
 2109: =over
 2110: 
 2111: =item Currently there are 3 possible values for $category: 
 2112: 
 2113: =over 
 2114: 
 2115: =item navigation 
 2116: left of breadcrumbs line
 2117: 
 2118: =item tools 
 2119: remaining items in right of breadcrumbs line
 2120: 
 2121: =item advtools 
 2122: advanced tools shown in a separate box below breadcrumbs line 
 2123: 
 2124: =back
 2125: 
 2126: =back
 2127: 
 2128: returns: nothing
 2129: 
 2130: =cut
 2131: 
 2132:     sub add_breadcrumb_tool {
 2133:         my ($category, @html) = @_;
 2134:         return unless @html;
 2135:         if (!keys(%tools)) { 
 2136:             %tools = ( navigation => [], tools => [], advtools => []);
 2137:         }
 2138: 
 2139:         #this cleans data received from lonmenu::innerregister
 2140:         @html = grep {defined $_ && $_ ne ''} @html;
 2141:         for (@html) { 
 2142:             s/align="(right|left)"//; 
 2143: #            s/<span.*?\/span>// if $category ne 'advtools'; 
 2144:         } 
 2145: 
 2146:         push @{$tools{$category}}, @html;
 2147:     }
 2148: 
 2149: =item &clear_breadcrumb_tools()
 2150: 
 2151: Clears the breadcrumb toolbar container.
 2152: 
 2153: returns: nothing
 2154: 
 2155: =cut
 2156: 
 2157:     sub clear_breadcrumb_tools {
 2158:         undef(%tools);
 2159:     }
 2160: 
 2161: =item &current_breadcrumb_tools()
 2162: 
 2163: returns: a hash containing the current breadcrumb tools.
 2164: 
 2165: =cut
 2166: 
 2167:     sub current_breadcrumb_tools {
 2168:         return %tools;
 2169:     }
 2170: 
 2171: =item &render_tools(\$breadcrumbs)
 2172: 
 2173: Creates html for breadcrumb tools (categories navigation and tools) and inserts 
 2174: \$breadcrumbs at the correct position.
 2175: 
 2176: =over
 2177: 
 2178: =item input: 
 2179: 
 2180: =over
 2181: 
 2182: =item \$breadcrumbs - a reference to the string containing prepared breadcrumbs.
 2183: 
 2184: =back
 2185: 
 2186: =back
 2187: 
 2188: returns: nothing
 2189: 
 2190: =cut
 2191: 
 2192: #TODO might split this in separate functions for each category
 2193:     sub render_tools {
 2194:         my ($breadcrumbs) = @_;
 2195:         return unless (keys(%tools));
 2196: 
 2197:         my $navigation = list_from_array($tools{navigation}, 
 2198:                    { listattr => { class=>"LC_breadcrumb_tools_navigation" } });
 2199:         my $tools = list_from_array($tools{tools}, 
 2200:                    { listattr => { class=>"LC_breadcrumb_tools_tools" } });
 2201:         $$breadcrumbs = list_from_array([$navigation, $tools, $$breadcrumbs], 
 2202:                    { listattr => { class=>'LC_breadcrumb_tools_outerlist' } });
 2203:     }
 2204: 
 2205: =pod
 2206: 
 2207: =item &render_advtools(\$breadcrumbs)
 2208: 
 2209: Creates html for advanced tools (category advtools) and inserts \$breadcrumbs 
 2210: at the correct position.
 2211: 
 2212: =over
 2213: 
 2214: =item input:
 2215: 
 2216: =over
 2217: 
 2218: =item \$breadcrumbs - a reference to the string containing prepared breadcrumbs (after render_tools call).
 2219: 
 2220: =back
 2221: 
 2222: =back
 2223: 
 2224: returns: nothing
 2225: 
 2226: =cut
 2227: 
 2228:     sub render_advtools {
 2229:         my ($breadcrumbs) = @_;
 2230:         return unless     (defined $tools{'advtools'}) 
 2231:                       and (scalar(@{$tools{'advtools'}}) > 0);
 2232: 
 2233:         $$breadcrumbs .= Apache::loncommon::head_subbox(
 2234:                             funclist_from_array($tools{'advtools'}) );
 2235:     }
 2236: 
 2237: } # End of scope for @Crumbs
 2238: 
 2239: sub docs_breadcrumbs {
 2240:     my ($allowed,$crstype,$contenteditor,$title,$precleared,$checklinkprot)=@_;
 2241:     my ($folderpath,@folders,$supplementalflag);
 2242:     @folders = split('&',$env{'form.folderpath'});
 2243:     if ($env{'form.folderpath'} =~ /^supplemental/) {
 2244:         $supplementalflag = 1;
 2245:     }
 2246:     my $plain='';
 2247:     my $container = 'sequence';
 2248:     my ($randompick,$isencrypted,$ishidden,$is_random_order) = (-1,0,0,0);
 2249:     my @docs_crumbs;
 2250:     while (@folders) {
 2251:         my $folder=shift(@folders);
 2252:         my $foldername=shift(@folders);
 2253:         if ($folderpath) {$folderpath.='&';}
 2254:         $folderpath.=$folder.'&'.$foldername;
 2255:         my $url = $env{'request.use_absolute'};
 2256:         if ($allowed) {
 2257:             $url .= '/adm/coursedocs?folderpath=';
 2258:         } else {
 2259:             $url .= '/adm/supplemental?folderpath=';
 2260:         }
 2261:         $url .= &escape($folderpath);
 2262:         my $name=&unescape($foldername);
 2263: # each of randompick number, hidden, encrypted, random order, is_page 
 2264: # are appended with ":"s to the foldername
 2265:         $name=~s/\:(\d*)\:(\w*)\:(\w*):(\d*)\:?(\d*)$//;
 2266:         unless ($supplementalflag) {
 2267:             if ($contenteditor) { 
 2268:                 if ($1 ne '') {
 2269:                     $randompick=$1;
 2270:                 } else {
 2271:                     $randompick=-1;
 2272:                 }
 2273:                 if ($2) { $ishidden=1; }
 2274:                 if ($3) { $isencrypted=1; }
 2275:                 if ($4 ne '') { $is_random_order = 1; }
 2276:                 if ($5 == 1) {$container = 'page'; }
 2277:             }
 2278:         }
 2279:         if ($folder eq 'supplemental') {
 2280:             $name = &mt('Supplemental Content');
 2281:         }
 2282:         if ($contenteditor) {
 2283:             $plain.=$name.' &gt; ';
 2284:         }
 2285:         push(@docs_crumbs,
 2286:                           {'href'  => $url,
 2287:                            'title' => $name,
 2288:                            'text'  => $name,
 2289:                            'no_mt' => 1,
 2290:                           });
 2291:     }
 2292:     if ($title) {
 2293:         push(@docs_crumbs,
 2294:                           {'title' => $title,
 2295:                            'text'  => $title,
 2296:                            'no_mt' => 1,}
 2297:                           );
 2298:     }
 2299:     if (wantarray) {
 2300:         unless ($precleared) {
 2301:             &clear_breadcrumbs();
 2302:         }
 2303:         &add_breadcrumb(@docs_crumbs);
 2304:         if ($contenteditor) {
 2305:             $plain=~s/\&gt\;\s*$//;
 2306:         }
 2307:         my $menulink = 0;
 2308:         if (!$allowed && !$contenteditor) {
 2309:             $menulink = 1;
 2310:         }
 2311:         if ($checklinkprot) {
 2312:             if ($env{'request.deeplink.login'}) {
 2313:                 my $linkprotout = &Apache::lonmenu::linkprot_exit();
 2314:                 if ($linkprotout) {
 2315:                     &Apache::lonhtmlcommon::add_breadcrumb_tool('tools',$linkprotout);
 2316:                 }
 2317:             }
 2318:         }
 2319:         return (&breadcrumbs(undef,undef,$menulink,'nohelp',undef,undef,
 2320:                              $contenteditor),
 2321:                              $randompick,$ishidden,$isencrypted,$plain,
 2322:                              $is_random_order,$container);
 2323:     } else {
 2324:         return \@docs_crumbs;
 2325:     }
 2326: }
 2327: 
 2328: ############################################################
 2329: ############################################################
 2330: 
 2331: # Nested table routines.
 2332: #
 2333: # Routines to display form items in a multi-row table with 2 columns.
 2334: # Uses nested tables to divide form elements into segments.
 2335: # For examples of use see loncom/interface/lonnotify.pm 
 2336: #
 2337: # Can be used in following order: ...
 2338: # &start_pick_box()
 2339: # row1
 2340: # row2
 2341: # row3   ... etc.
 2342: # &submit_row()
 2343: # &end_pick_box()
 2344: #
 2345: # where row1, row 2 etc. are chosen from &role_select_row,&course_select_row,
 2346: # &status_select_row and &email_default_row
 2347: #
 2348: # Can also be used in following order:
 2349: #
 2350: # &start_pick_box()
 2351: # &row_title()
 2352: # &row_closure()
 2353: # &row_title()
 2354: # &row_closure()  ... etc.
 2355: # &submit_row()
 2356: # &end_pick_box()
 2357: #
 2358: # In general a &submit_row() call should proceed the call to &end_pick_box(),
 2359: # as this routine adds a button for form submission.
 2360: # &submit_row() does not require a &row_closure after it.
 2361: #  
 2362: # &start_pick_box() creates a bounding table with 1-pixel wide black border.
 2363: # rows should be placed between calls to &start_pick_box() and &end_pick_box.
 2364: #
 2365: # &row_title() adds a title in the left column for each segment.
 2366: # &row_closure() closes a row with a 1-pixel wide black line.
 2367: #
 2368: # &role_select_row() provides a select box from which to choose 1 or more roles 
 2369: # &course_select_row provides ways of picking groups of courses
 2370: #    radio buttons: all, by category or by picking from a course picker pop-up
 2371: #      note: by category option is only displayed if a domain has implemented 
 2372: #                selection by year, semester, department, number etc.
 2373: #
 2374: # &status_select_row() provides a select box from which to choose 1 or more
 2375: #  access types (current access, prior access, and future access)  
 2376: #
 2377: # &email_default_row() provides text boxes for default e-mail suffixes for
 2378: #  different authentication types in a domain.
 2379: #
 2380: # &row_title() and &row_closure() are called internally by the &*_select_row
 2381: # routines, but can also be called directly to start and end rows which have 
 2382: # needs that are not accommodated by the *_select_row() routines.    
 2383: 
 2384: { # Start: row_count block for pick_box
 2385: my @row_count;
 2386: 
 2387: sub start_pick_box {
 2388:     my ($css_class,$id) = @_;
 2389:     if (defined($css_class)) {
 2390: 	$css_class = 'class="'.$css_class.'"';
 2391:     } else {
 2392: 	$css_class= 'class="LC_pick_box"';
 2393:     }
 2394:     my $table_id;
 2395:     if (defined($id)) {
 2396:         $table_id = ' id="'.$id.'"';
 2397:     }
 2398:     unshift(@row_count,0);
 2399:     my $output = <<"END";
 2400:  <table $css_class $table_id>
 2401: END
 2402:     return $output;
 2403: }
 2404: 
 2405: sub end_pick_box {
 2406:     shift(@row_count);
 2407:     my $output = <<"END";
 2408:        </table>
 2409: END
 2410:     return $output;
 2411: }
 2412: 
 2413: sub row_headline {
 2414:     my $output = <<"END";
 2415:            <tr><td colspan="2">
 2416: END
 2417:     return $output;
 2418: }
 2419: 
 2420: sub row_title {
 2421:     my ($title,$css_title_class,$css_value_class, $css_value_furtherAttributes) = @_;
 2422:     $row_count[0]++;
 2423:     my $css_class = ($row_count[0] % 2)?'LC_odd_row':'LC_even_row';
 2424:     $css_title_class ||= 'LC_pick_box_title';
 2425:     $css_title_class = 'class="'.$css_title_class.'"';
 2426: 
 2427:     $css_value_class ||= 'LC_pick_box_value';
 2428: 
 2429:     if ($title ne '') {
 2430:         $title .= ':';
 2431:     }
 2432:     my $output = <<"ENDONE";
 2433:            <tr class="LC_pick_box_row" $css_value_furtherAttributes> 
 2434:             <td $css_title_class>
 2435: 	       $title
 2436:             </td>
 2437:             <td class="$css_value_class $css_class">
 2438: ENDONE
 2439:     return $output;
 2440: }
 2441: 
 2442: sub row_closure {
 2443:     my ($no_separator) =@_;
 2444:     my $output = <<"ENDTWO";
 2445:             </td>
 2446:            </tr>
 2447: ENDTWO
 2448:     if (!$no_separator) {
 2449:         $output .= <<"ENDTWO";
 2450:            <tr>
 2451:             <td colspan="2" class="LC_pick_box_separator">
 2452:             </td>
 2453:            </tr>
 2454: ENDTWO
 2455:     }
 2456:     return $output;
 2457: }
 2458: 
 2459: } # End: row_count block for pick_box
 2460: 
 2461: sub role_select_row {
 2462:     my ($roles,$title,$css_class,$show_separate_custom,$cdom,$cnum) = @_;
 2463:     my $crstype = 'Course';
 2464:     if ($cdom ne '' && $cnum ne '') {
 2465:         $crstype = &Apache::loncommon::course_type($cdom.'_'.$cnum);
 2466:     }
 2467:     my $output;
 2468:     if (defined($title)) {
 2469:         $output = &row_title($title,$css_class);
 2470:     }
 2471:     $output .= qq|
 2472:                                   <select name="roles" multiple="multiple">\n|;
 2473:     foreach my $role (@$roles) {
 2474:         my $plrole;
 2475:         if ($role eq 'ow') {
 2476:             $plrole = &mt('Course Owner');
 2477:         } elsif ($role eq 'cr') {
 2478:             if ($show_separate_custom) {
 2479:                 if ($cdom ne '' && $cnum ne '') {
 2480:                     my %course_customroles = &course_custom_roles($cdom,$cnum);
 2481:                     foreach my $crrole (sort(keys(%course_customroles))) {
 2482:                         my ($plcrrole) = ($crrole =~ m|^cr/[^/]+/[^/]+/(.+)$|);
 2483:                         $output .= '  <option value="'.$crrole.'">'.$plcrrole.
 2484:                                    '</option>';
 2485:                     }
 2486:                 }
 2487:             } else {
 2488:                 $plrole = &mt('Custom Role');
 2489:             }
 2490:         } else {
 2491:             $plrole=&Apache::lonnet::plaintext($role,$crstype);
 2492:         }
 2493:         if (($role ne 'cr') || (!$show_separate_custom)) {
 2494:             $output .= '  <option value="'.$role.'">'.$plrole.'</option>';
 2495:         }
 2496:     }
 2497:     $output .= qq|                </select>\n|;
 2498:     if (defined($title)) {
 2499:         $output .= &row_closure();
 2500:     }
 2501:     return $output;
 2502: }
 2503: 
 2504: sub course_select_row {
 2505:     my ($title,$formname,$totcodes,$codetitles,$idlist,$idlist_titles,
 2506: 	$css_class,$crstype,$standardnames) = @_;
 2507:     my $output = &row_title($title,$css_class);
 2508:     $output .= &course_selection($formname,$totcodes,$codetitles,$idlist,$idlist_titles,$crstype,$standardnames);
 2509:     $output .= &row_closure();
 2510:     return $output;
 2511: }
 2512: 
 2513: sub course_selection {
 2514:     my ($formname,$totcodes,$codetitles,$idlist,$idlist_titles,$crstype,$standardnames) = @_;
 2515:     my $output = qq|
 2516: <script type="text/javascript">
 2517: // <![CDATA[
 2518:     function coursePick (formname) {
 2519:         for  (var i=0; i<formname.coursepick.length; i++) {
 2520:             if (formname.coursepick[i].value == 'category') {
 2521:                 courseSet('');
 2522:             }
 2523:             if (!formname.coursepick[i].checked) {
 2524:                 if (formname.coursepick[i].value == 'specific') {
 2525:                     formname.coursetotal.value = 0;
 2526:                     formname.courselist = '';
 2527:                 }
 2528:             }
 2529:         }
 2530:     }
 2531:     function setPick (formname) {
 2532:         for  (var i=0; i<formname.coursepick.length; i++) {
 2533:             if (formname.coursepick[i].value == 'category') {
 2534:                 formname.coursepick[i].checked = true;
 2535:             }
 2536:             formname.coursetotal.value = 0;
 2537:             formname.courselist = '';
 2538:         }
 2539:     }
 2540: // ]]>
 2541: </script>
 2542:     |;
 2543: 
 2544:     my ($allcrs,$pickspec);
 2545:     if ($crstype eq 'Community') {
 2546:         $allcrs = &mt('All communities');
 2547:         $pickspec = &mt('Pick specific communities:');
 2548:     } else {
 2549:         $allcrs = &mt('All courses');
 2550:         $pickspec = &mt('Pick specific course(s):');
 2551:     }
 2552: 
 2553:     my $courseform='<b>'.&Apache::loncommon::selectcourse_link
 2554:                      ($formname,'pickcourse','pickdomain','coursedesc','',1,$crstype).'</b>';
 2555:         $output .= '<label><input type="radio" name="coursepick" value="all" onclick="coursePick(this.form)" />'.$allcrs.'</label><br />';
 2556:     if ($totcodes > 0) {
 2557:         my $numtitles = @$codetitles;
 2558:         if ($numtitles > 0) {
 2559:             $output .= '<label><input type="radio" name="coursepick" value="category" onclick="coursePick(this.form);alert('."'".&html_escape(&mt('Choose categories, from left to right'))."'".')" />'.&mt('Pick courses by category:').'</label><br />';
 2560:             $output .= '<table><tr><td>'.$$codetitles[0].'<br />'."\n".
 2561:                '<select name="'.$standardnames->[0].
 2562:                '" onchange="setPick(this.form);courseSet('."'$$codetitles[0]'".')">'."\n".
 2563:                ' <option value="-1" />Select'."\n";
 2564:             my @items = ();
 2565:             my @longitems = ();
 2566:             if ($$idlist{$$codetitles[0]} =~ /","/) {
 2567:                 @items = split(/","/,$$idlist{$$codetitles[0]});
 2568:             } else {
 2569:                 $items[0] = $$idlist{$$codetitles[0]};
 2570:             }
 2571:             if (defined($$idlist_titles{$$codetitles[0]})) {
 2572:                 if ($$idlist_titles{$$codetitles[0]} =~ /","/) {
 2573:                     @longitems = split(/","/,$$idlist_titles{$$codetitles[0]});
 2574:                 } else {
 2575:                     $longitems[0] = $$idlist_titles{$$codetitles[0]};
 2576:                 }
 2577:                 for (my $i=0; $i<@longitems; $i++) {
 2578:                     if ($longitems[$i] eq '') {
 2579:                         $longitems[$i] = $items[$i];
 2580:                     }
 2581:                 }
 2582:             } else {
 2583:                 @longitems = @items;
 2584:             }
 2585:             for (my $i=0; $i<@items; $i++) {
 2586:                 $output .= ' <option value="'.$items[$i].'">'.$longitems[$i].'</option>';
 2587:             }
 2588:             $output .= '</select></td>';
 2589:             for (my $i=1; $i<$numtitles; $i++) {
 2590:                 $output .= '<td>'.$$codetitles[$i].'<br />'."\n".
 2591:                           '<select name="'.$standardnames->[$i].
 2592:                           '" onchange="courseSet('."'$$codetitles[$i]'".')">'."\n".
 2593:                           '<option value="-1">&lt;-Pick '.$$codetitles[$i-1].'</option>'."\n".
 2594:                           '</select>'."\n".
 2595:                           '</td>';
 2596:             }
 2597:             $output .= '</tr></table><br />';
 2598:         }
 2599:     }
 2600:     $output .=
 2601:         '<label><input type="radio" name="coursepick" value="specific"'
 2602:        .' onclick="coursePick(this.form);opencrsbrowser('."'".$formname."','dccourse','dcdomain','coursedesc','','1','$crstype'".')" />'
 2603:        .$pickspec.'</label>'
 2604:        .' '.$courseform.'&nbsp;&nbsp;'
 2605:        .&mt('[_1] selected.',
 2606:                 '<input type="text" value="0" size="4" name="coursetotal" readonly="readonly" />'
 2607:                .'<input type="hidden" name="courselist" value="" />')
 2608:        .'<br />'."\n";
 2609:     return $output;
 2610: }
 2611: 
 2612: sub status_select_row {
 2613:     my ($types,$title,$css_class) = @_;
 2614:     my $output; 
 2615:     if (defined($title)) {
 2616:         $output = &row_title($title,$css_class,'LC_pick_box_select');
 2617:     }
 2618:     $output .= qq|
 2619:                                     <select name="types" multiple="multiple">\n|;
 2620:     foreach my $status_type (sort(keys(%{$types}))) {
 2621:         $output .= '  <option value="'.$status_type.'">'.$$types{$status_type}.'</option>';
 2622:     }
 2623:     $output .= qq|                   </select>\n|; 
 2624:     if (defined($title)) {
 2625:         $output .= &row_closure();
 2626:     }
 2627:     return $output;
 2628: }
 2629: 
 2630: sub email_default_row {
 2631:     my ($authtypes,$title,$descrip,$css_class) = @_;
 2632:     my $output = &row_title($title,$css_class);
 2633:     $output .= $descrip.
 2634: 	&Apache::loncommon::start_data_table().
 2635: 	&Apache::loncommon::start_data_table_header_row().
 2636: 	'<th>'.&mt('Authentication Method').'</th>'.
 2637: 	'<th align="right">'.&mt('Username -> e-mail conversion').'</th>'."\n".
 2638: 	&Apache::loncommon::end_data_table_header_row();
 2639:     my $rownum = 0;
 2640:     foreach my $auth (sort(keys(%{$authtypes}))) {
 2641:         my ($userentry,$size);
 2642:         if ($auth =~ /^krb/) {
 2643:             $userentry = '';
 2644:             $size = 25;
 2645:         } else {
 2646:             $userentry = 'username@';
 2647:             $size = 15;
 2648:         }
 2649:         $output .= &Apache::loncommon::start_data_table_row().
 2650: 	    '<td>  '.$$authtypes{$auth}.'</td>'.
 2651: 	    '<td align="right">'.$userentry.
 2652: 	    '<input type="text" name="'.$auth.'" size="'.$size.'" /></td>'.
 2653: 	    &Apache::loncommon::end_data_table_row();
 2654:     }
 2655:     $output .= &Apache::loncommon::end_data_table();
 2656:     $output .= &row_closure();
 2657:     return $output;
 2658: }
 2659: 
 2660: 
 2661: sub submit_row {
 2662:     my ($title,$cmd,$submit_text,$css_class) = @_;
 2663:     my $output = &row_title($title,$css_class,'LC_pick_box_submit');
 2664:     $output .= qq|
 2665:              <br />
 2666:              <input type="hidden" name="command" value="$cmd" />
 2667:              <input type="submit" value="$submit_text"/> &nbsp;
 2668:              <br /><br />
 2669:             \n|;
 2670:     return $output;
 2671: }
 2672: 
 2673: sub course_custom_roles {
 2674:     my ($cdom,$cnum) = @_;
 2675:     my %returnhash=();
 2676:     my %coursepersonnel=&Apache::lonnet::dump('nohist_userroles',$cdom,$cnum);
 2677:     foreach my $person (sort(keys(%coursepersonnel))) {
 2678:         my ($role) = ($person =~ /^([^:]+):/);
 2679:         my ($end,$start) = split(/:/,$coursepersonnel{$person});
 2680:         if ($end == -1 && $start == -1) {
 2681:             next;
 2682:         }
 2683:         if ($role =~ m|^cr/[^/]+/[^/]+/[^/]|) {
 2684:             $returnhash{$role} ++;
 2685:         }
 2686:     }
 2687:     return %returnhash;
 2688: }
 2689: 
 2690: 
 2691: sub resource_info_box {
 2692:    my ($symb,$onlyfolderflag,$stuvcurrent,$stuvdisp,$divforres)=@_;
 2693:    my $return='';
 2694:    if (($stuvcurrent ne '') || ($divforres)) {
 2695:        $return = '<div class="LC_left_float">';
 2696:    }
 2697:    if ($symb) {
 2698:        $return.=&Apache::loncommon::start_data_table();
 2699:        my ($map,$id,$resource)=&Apache::lonnet::decode_symb($symb);
 2700:        my $folder=&Apache::lonnet::gettitle($map);
 2701:        $return.=&Apache::loncommon::start_data_table_row().
 2702:                     '<th align="left">'.&mt('Folder:').'</th><td>'.$folder.'</td>'.
 2703:                     &Apache::loncommon::end_data_table_row();
 2704:        unless ($onlyfolderflag) {
 2705:           $return.=&Apache::loncommon::start_data_table_row().
 2706:                     '<th align="left">'.&mt('Resource:').'</th><td>'.&Apache::lonnet::gettitle($symb).'</td>'.
 2707:                     &Apache::loncommon::end_data_table_row();
 2708:        }
 2709:        if ($stuvcurrent ne '') {
 2710:            $return .= &Apache::loncommon::start_data_table_row().
 2711:                     '<th align="left">'.&mt("Student's current version:").'</th><td>'.$stuvcurrent.'</td>'.
 2712:                     &Apache::loncommon::end_data_table_row();
 2713:        }
 2714:        if ($stuvdisp ne '') {
 2715:            $return .= &Apache::loncommon::start_data_table_row().
 2716:                     '<th align="left">'.&mt("Student's version displayed:").'</th><td>'.$stuvdisp.'</td>'.
 2717:                     &Apache::loncommon::end_data_table_row();
 2718:        }
 2719:        $return.=&Apache::loncommon::end_data_table();
 2720:     } else {
 2721:        $return='<p><span class="LC_error">'.&mt('No context provided.').'</span></p>';
 2722:     }
 2723:     if (($stuvcurrent ne '') || ($divforres)) {
 2724:         $return .= '</div>';
 2725:     }
 2726:     return $return;
 2727: }
 2728: 
 2729: # display_usage
 2730: # 
 2731: # Generates a div containing a block, filled to show percentage of current quota used
 2732: #
 2733: # Quotas available for user portfolios, group portfolios, authoring spaces, and course
 2734: # content stored directly within a course (i.e., excluding published content).
 2735: #
 2736: 
 2737: sub display_usage {
 2738:     my ($current_disk_usage,$disk_quota,$context) = @_;
 2739:     my $usage = $current_disk_usage/1024;
 2740:     my $quota = $disk_quota/1024;
 2741:     my $percent;
 2742:     if ($disk_quota == 0) {
 2743:         $percent = 100.0;
 2744:     } else {
 2745:         $percent = 100*($current_disk_usage/$disk_quota);
 2746:     }
 2747:     $usage = sprintf("%.2f",$usage);
 2748:     $quota = sprintf("%.2f",$quota);
 2749:     $percent = sprintf("%.0f",$percent);
 2750:     my ($color,$cssclass);
 2751:     if ($percent <= 60) {
 2752:         $color = '#00A000';
 2753:     } elsif ($percent > 60 && $percent < 90) {
 2754:         $color = '#FFD300';
 2755:         $cssclass = 'class="LC_warning"';
 2756:     } elsif( $percent >= 90) {
 2757:         $color = '#FF0000';
 2758:         $cssclass = 'class="LC_error"';
 2759:     }
 2760:     my $prog_width = $percent;
 2761:     if ($prog_width > 100) {
 2762:         $prog_width = 100;
 2763:     }
 2764:     my $display = 'block';
 2765:     if ($context eq 'authoring') {
 2766:         $display = 'inline';
 2767:     }
 2768:     return '
 2769:   <div id="meter1" align="left" style="display:'.$display.'" '.$cssclass.'>'.&mt('Currently using [_1] of the [_2] available.',$usage.' MB <span style="font-weight:bold;">('.$percent.'%)</span>',$quota.' MB')."\n".
 2770: '   <div id="meter2" style="display:block; margin-top:3px; margin-bottom:3px; margin-left:0px; margin-right:0px; width:400px; border:1px solid #000000; height:10px;">'."\n".
 2771: '    <div id="meter3" style="display:block; background-color:'.$color.'; width:'.$prog_width.'%; height:10px; color:#000000; margin:0px;"></div>'."\n".
 2772: '   </div>'."\n".
 2773: '  </div>';
 2774: }
 2775: 
 2776: ##############################################
 2777: ##############################################
 2778: 
 2779: # topic_bar
 2780: #
 2781: # Generates a div containing an (optional) number with a white background followed by a 
 2782: # title with a background color defined in the corresponding CSS: LC_topic_bar
 2783: # Inputs:
 2784: # 1. number to display.
 2785: #    If input for number is empty only the title will be displayed. 
 2786: # 2. title text to display.
 2787: # 3. optional id for the <div>
 2788: # Outputs - a scalar containing html mark-up for the div.
 2789: 
 2790: sub topic_bar {
 2791:     my ($num,$title,$id) = @_;
 2792:     my $number = '';
 2793:     if ($num ne '') {
 2794:         $number = '<span>'.$num.'</span>';
 2795:     }
 2796:     if ($id ne '') {
 2797:         $id = 'id="'.$id.'"';
 2798:     }
 2799:     return '<div class="LC_topic_bar" '.$id.'>'.$number.$title.'</div>';
 2800: }
 2801: 
 2802: ##############################################
 2803: ##############################################
 2804: # echo_form_input
 2805: #
 2806: # Generates html markup to add form elements from the referrer page
 2807: # as hidden form elements (values encoded) in the new page.
 2808: #
 2809: # Intended to support two types of use 
 2810: # (a) to allow backing up to earlier pages in a multi-page 
 2811: # form submission process using a breadcrumb trail.
 2812: #
 2813: # (b) to allow the current page to be reloaded with form elements
 2814: # set on previous page to remain unchanged.  An example would
 2815: # be where the a page containing a dynamically-built table of data is 
 2816: # is to be redisplayed, with only the sort order of the data changed. 
 2817: #  
 2818: # Inputs:
 2819: # 1. Reference to array of form elements in the submitted form on 
 2820: # the referrer page which are to be excluded from the echoed elements.
 2821: #
 2822: # 2. Reference to array of regular expressions, which if matched in the  
 2823: # name of the form element n the referrer page will be omitted from echo. 
 2824: #
 2825: # Outputs: A scalar containing the html markup for the echoed form
 2826: # elements (all as hidden elements, with values encoded). 
 2827: 
 2828: 
 2829: sub echo_form_input {
 2830:     my ($excluded,$regexps) = @_;
 2831:     my $output = '';
 2832:     foreach my $key (keys(%env)) {
 2833:         if ($key =~ /^form\.(.+)$/) {
 2834:             my $name = $1;
 2835:             my $match = 0;
 2836:             if (ref($excluded) eq 'ARRAY') {    
 2837:                 next if (grep(/^\Q$name\E$/,@{$excluded}));
 2838:             }
 2839:             if (ref($regexps) eq 'ARRAY') {
 2840:                 if (@{$regexps} > 0) {
 2841:                     foreach my $regexp (@{$regexps}) {
 2842:                         if ($name =~ /$regexp/) {
 2843:                             $match = 1;
 2844:                             last;
 2845:                         }
 2846:                     }
 2847:                 }
 2848:             }
 2849:             next if ($match);
 2850:             if (ref($env{$key}) eq 'ARRAY') {
 2851:                 foreach my $value (@{$env{$key}}) {
 2852:                     $value = &HTML::Entities::encode($value,'<>&"');
 2853:                     $output .= '<input type="hidden" name="'.$name.
 2854:                                '" value="'.$value.'" />'."\n";
 2855:                 }
 2856:             } else {
 2857:                 my $value = &HTML::Entities::encode($env{$key},'<>&"');
 2858:                 $output .= '<input type="hidden" name="'.$name.
 2859:                            '" value="'.$value.'" />'."\n";
 2860:             }
 2861:         }
 2862:     }
 2863:     return $output;
 2864: }
 2865: 
 2866: ##############################################
 2867: ##############################################
 2868: # set_form_elements
 2869: #
 2870: # Generates javascript to set form elements to values based on
 2871: # corresponding values for the same form elements when the page was
 2872: # previously submitted.
 2873: #     
 2874: # Last submission values are read from hidden form elements in referring 
 2875: # page which have the same name, i.e., generated by &echo_form_input(). 
 2876: #
 2877: # Intended to be called by onload event.
 2878: #
 2879: # Inputs:
 2880: # (a) Reference to hash of echoed form elements to be set.
 2881: #
 2882: # In the hash, keys are the form element names, and the values are the
 2883: # element type (selectbox, radio, checkbox or text -for textbox, textarea or
 2884: # hidden).
 2885: #
 2886: # (b) Optional reference to hash of stored elements to be set.
 2887: #
 2888: # If the page being displayed is a page which permits modification of
 2889: # previously stored data, e.g., the first page in a multi-page submission,
 2890: # then if stored is supplied, form elements will be set to the last stored
 2891: # values.  If user supplied values are also available for the same elements
 2892: # these will replace the stored values. 
 2893: #        
 2894: # Output:
 2895: #  
 2896: # javascript function - set_form_elements() which sets form elements,
 2897: # expects an argument: formname - the name of the form according to 
 2898: # the DOM, e.g., document.compose
 2899: 
 2900: sub set_form_elements {
 2901:     my ($elements,$stored) = @_;
 2902:     my %values;
 2903:     my $output .= 'function setFormElements(courseForm) {
 2904: ';
 2905:     if (defined($stored)) {
 2906:         foreach my $name (keys(%{$stored})) {
 2907:             if (exists($$elements{$name})) {
 2908:                 if (ref($$stored{$name}) eq 'ARRAY') {
 2909:                     $values{$name} = $$stored{$name};
 2910:                 } else {
 2911:                     @{$values{$name}} = ($$stored{$name});
 2912:                 }
 2913:             }
 2914:         }
 2915:     }
 2916: 
 2917:     foreach my $key (keys(%env)) {
 2918:         if ($key =~ /^form\.(.+)$/) {
 2919:             my $name = $1;
 2920:             if (exists($$elements{$name})) {
 2921:                 @{$values{$name}} = &Apache::loncommon::get_env_multiple($key);
 2922:             }
 2923:         }
 2924:     }
 2925: 
 2926:     foreach my $name (keys(%values)) {
 2927:         for (my $i=0; $i<@{$values{$name}}; $i++) {
 2928:             $values{$name}[$i] = &HTML::Entities::decode($values{$name}[$i],'<>&"');
 2929:             $values{$name}[$i] =~ s/([\r\n\f]+)/\\n/g;
 2930:             $values{$name}[$i] =~ s/"/\\"/g;
 2931:         }
 2932:         if (($$elements{$name} eq 'text') || ($$elements{$name} eq 'hidden')) {
 2933:             my $numvalues = @{$values{$name}};
 2934:             if ($numvalues > 1) {
 2935:                 my $valuestring = join('","',@{$values{$name}});
 2936:                 $output .= qq|
 2937:   var textvalues = new Array ("$valuestring");
 2938:   var total = courseForm.elements['$name'].length;
 2939:   if (total > $numvalues) {
 2940:       total = $numvalues;
 2941:   }    
 2942:   for (var i=0; i<total; i++) {
 2943:       courseForm.elements['$name']\[i].value = textvalues[i];
 2944:   }
 2945: |;
 2946:             } else {
 2947:                 $output .= qq|
 2948:   courseForm.elements['$name'].value = "$values{$name}[0]";
 2949: |;
 2950:             }
 2951:         } else {
 2952:             $output .=  qq|
 2953:   var elementLength = courseForm.elements['$name'].length;
 2954:   if (elementLength==undefined) {
 2955: |;
 2956:             foreach my $value (@{$values{$name}}) {
 2957:                 if ($$elements{$name} eq 'selectbox') {
 2958:                     $output .=  qq|
 2959:       if (courseForm.elements['$name'].options[0].value == "$value") {
 2960:           courseForm.elements['$name'].options[0].selected = true;
 2961:       }|;
 2962:                 } elsif (($$elements{$name} eq 'radio') ||
 2963:                          ($$elements{$name} eq 'checkbox')) {
 2964:                     $output .= qq|
 2965:       if (courseForm.elements['$name'].value == "$value") {
 2966:           courseForm.elements['$name'].checked = true;
 2967:       } else {
 2968:           courseForm.elements['$name'].checked = false;
 2969:       }|;
 2970:                 }
 2971:             }
 2972:             $output .= qq|
 2973:   }
 2974:   else {
 2975:       for (var i=0; i<courseForm.elements['$name'].length; i++) {
 2976: |;
 2977:             if ($$elements{$name} eq 'selectbox') {
 2978:                 $output .=  qq|
 2979:           courseForm.elements['$name'].options[i].selected = false;|;
 2980:             } elsif (($$elements{$name} eq 'radio') || 
 2981:                      ($$elements{$name} eq 'checkbox')) {
 2982:                 $output .= qq|
 2983:           courseForm.elements['$name']\[i].checked = false;|; 
 2984:             }
 2985:             $output .= qq|
 2986:       }
 2987:       for (var j=0; j<courseForm.elements['$name'].length; j++) {
 2988: |;
 2989:             foreach my $value (@{$values{$name}}) {
 2990:                 if ($$elements{$name} eq 'selectbox') {
 2991:                     $output .=  qq|
 2992:           if (courseForm.elements['$name'].options[j].value == "$value") {
 2993:               courseForm.elements['$name'].options[j].selected = true;
 2994:           }|;
 2995:                 } elsif (($$elements{$name} eq 'radio') ||
 2996:                          ($$elements{$name} eq 'checkbox')) { 
 2997:                       $output .= qq|
 2998:           if (courseForm.elements['$name']\[j].value == "$value") {
 2999:               courseForm.elements['$name']\[j].checked = true;
 3000:           }|;
 3001:                 }
 3002:             }
 3003:             $output .= qq|
 3004:       }
 3005:   }
 3006: |;
 3007:         }
 3008:     }
 3009:     $output .= "
 3010:     return;
 3011: }\n";
 3012:     return $output;
 3013: }
 3014: 
 3015: ##############################################
 3016: ##############################################
 3017: 
 3018: sub file_submissionchk_js {
 3019:     my ($turninpaths,$multiples) = @_;
 3020:     my $overwritewarn = &mt('File(s) you uploaded for your submission will overwrite existing file(s) submitted for this item')."\n".
 3021:                       &mt('Continue submission and overwrite the file(s)?');
 3022:     &js_escape(\$overwritewarn);
 3023:     my $delfilewarn = &mt('You have indicated you wish to remove some files previously included in your submission.')."\n".
 3024:                       &mt('Continue submission with these files removed?');
 3025:     &js_escape(\$delfilewarn);
 3026:     my ($turninpathtext,$multtext,$arrayindexofjs);
 3027:     if (ref($turninpaths) eq 'HASH') {
 3028:         foreach my $key (sort(keys(%{$turninpaths}))) {
 3029:             $turninpathtext .= "    if (prefix == '$key') {\n".
 3030:                                "        return '$turninpaths->{$key}';\n".
 3031:                                "    }\n";
 3032:         }
 3033:     }
 3034:     $turninpathtext .= "    return '';\n";
 3035:     if (ref($multiples) eq 'HASH') {
 3036:         foreach my $key (sort(keys(%{$multiples}))) {
 3037:             $multtext .= "    if (prefix == '$key') {\n".
 3038:                          "        return '$multiples->{$key}';\n".
 3039:                          "    }\n";
 3040:         }
 3041:     }
 3042:     $multtext .= "    return '';\n";
 3043: 
 3044:     $arrayindexofjs = &Apache::loncommon::javascript_array_indexof();
 3045:     return <<"ENDSCRIPT";
 3046: <script type="text/javascript">
 3047: // <![CDATA[
 3048: 
 3049: function file_submission_check(formname,path,multiresp) {
 3050:     var elemnum = formname.elements.length;
 3051:     if (elemnum == 0) {
 3052:         return true;
 3053:     }
 3054:     var alloverwrites = [];
 3055:     var alldelconfirm = [];
 3056:     var result = [];
 3057:     var submitter;
 3058:     var subprefix;
 3059:     var allsub = getIndexByName(formname,'all_submit');
 3060:     if (allsub == -1) {
 3061:         var idx = getIndexByName(formname,'submitted');
 3062:         if (idx != -1) {
 3063:             var subval = String(formname.elements[idx].value);
 3064:             submitter = subval.replace(/^part_/,'');
 3065:             result = overwritten_check(formname,path,multiresp,submitter);
 3066:             alloverwrites.push.apply(alloverwrites,result['overwrite']);
 3067:             alldelconfirm.push.apply(alldelconfirm,result['delete']);
 3068:         }
 3069:     } else {
 3070:         if (formname.elements[allsub].type == 'submit') {
 3071:             var partsub = /^\\d+\\.\\d+_submit_.+\$/;
 3072:             var allprefixes = [];
 3073:             var allparts = [];
 3074:             for (var i=0; i<formname.elements.length; i++) {
 3075:                 if (formname.elements[i].type == 'submit') {
 3076:                     var elemname = formname.elements[i].name;
 3077:                     var subname = String(elemname);
 3078:                     var savesub = String(elemname);
 3079:                     if (partsub.test(subname)) {
 3080:                         var prefix = subname.replace(/_submit_.+\$/,'');
 3081:                         if (allprefixes.indexOf(prefix) == -1) {
 3082:                             allprefixes.push(prefix);
 3083:                             allparts[prefix] = [];
 3084:                         }
 3085:                         var part = savesub.replace(/^\\d+\\.\\d+_submit_/,'');
 3086:                         allparts[prefix].push(part);
 3087:                     }
 3088:                 }
 3089:             }
 3090:             for (var k=0; k<allprefixes.length; k++) {
 3091:                 var idx = getIndexByName(formname,allprefixes[k]+'_submitted');
 3092:                 if (idx > -1) {
 3093:                     if (formname.elements[idx].value != 'yes') {
 3094:                         submitterval = formname.elements[idx].value;
 3095:                         submitter = submitterval.replace(/^part_/,'');
 3096:                         subprefix = allprefixes[k];
 3097:                         result = overwritten_check(formname,path,multiresp,submitter,subprefix);
 3098:                         alloverwrites.push.apply(alloverwrites,result['overwrite']);
 3099:                         alldelconfirm.push.apply(alldelconfirm,result['delete']);
 3100:                         break;
 3101:                     }
 3102:                 }
 3103:             }
 3104:             if (submitter == '' || submitter == undefined) {
 3105:                 for (var m=0; m<allprefixes.length; m++) {
 3106:                     for (var n=0; n<allparts[allprefixes[m]].length; n++) {
 3107:                         var result = overwritten_check(formname,path,multiresp,allparts[allprefixes[m]][n],allprefixes[m]);
 3108:                         alloverwrites.push.apply(alloverwrites,result['overwrite']);
 3109:                         alldelconfirm.push.apply(alldelconfirm,result['delete']);
 3110:                     }
 3111:                 }
 3112:             }
 3113:         }
 3114:     }
 3115:     if (alloverwrites.length > 0) {
 3116:         if (!confirm("$overwritewarn")) {
 3117:             for (var n=0; n<alloverwrites.length; n++) {
 3118:                 formname.elements[alloverwrites[n]].value = "";
 3119:             }
 3120:             return false;
 3121:         }
 3122:     }
 3123:     if (alldelconfirm.length > 0) {
 3124:         if (!confirm("$delfilewarn")) {
 3125:             for (var p=0; p<alldelconfirm.length; p++) {
 3126:                 formname.elements[alldelconfirm[p]].checked = false;
 3127:             }
 3128:             return false;
 3129:         }
 3130:     }
 3131:     return true;
 3132: }
 3133: 
 3134: function getIndexByName(formname,item) {
 3135:     for (var i=0;i<formname.elements.length;i++) {
 3136:         if (formname.elements[i].name == item) {
 3137:             return i;
 3138:         }
 3139:     }
 3140:     return -1;
 3141: }
 3142: 
 3143: function overwritten_check(formname,path,multiresp,part,prefix) {
 3144:     var result = [];
 3145:     result['overwrite'] = [];
 3146:     result['delete'] = [];
 3147:     var elemnum = formname.elements.length;
 3148:     if (elemnum == 0) {
 3149:         return result;
 3150:     }
 3151:     var uploadstr;
 3152:     var deletestr;
 3153:     if ((prefix != undefined) && (prefix != '')) {
 3154:         var prepend = prefix+'_';
 3155:         uploadstr = new RegExp("^"+prepend+"HWFILE"+part+".+\$");
 3156:         deletestr = new RegExp("^"+prepend+"HWFILE"+part+".+_\\\\d+_delete\$");
 3157:         multiresp = check_for_multiples(prepend);
 3158:         path = check_for_turninpath(prepend);
 3159:     } else {
 3160:         uploadstr = new RegExp("^HWFILE"+part+".+\$");
 3161:         deletestr = new RegExp("^HWFILE"+part+".+_\\\\d+_delete\$");
 3162:     }
 3163:     var alluploads = [];
 3164:     var allchecked = [];
 3165:     var allskipdel = [];
 3166:     var fnametrim = /[^\\/\\\\]+\$/;
 3167:     for (var i=0; i<formname.elements.length; i++) {
 3168:         var id = formname.elements[i].id;
 3169:         if (id != '') {
 3170:             if (uploadstr.test(id)) {
 3171:                 if (formname.elements[i].type == 'file') {
 3172:                     alluploads.push(id);
 3173:                 } else {
 3174:                     if (deletestr.test(id)) {
 3175:                         if (formname.elements[i].type == 'checkbox') {
 3176:                             if (formname.elements[i].checked) {
 3177:                                 allchecked.push(id);
 3178:                             }
 3179:                         }
 3180:                     }
 3181:                 }
 3182:             }
 3183:         }
 3184:     }
 3185:     for (var j=0; j<alluploads.length; j++) {
 3186:         var delstr = new RegExp("^"+alluploads[j]+"_\\\\d+_delete\$");
 3187:         var delboxes = [];
 3188:         for (var k=0; k<formname.elements.length; k++) {
 3189:             var id = formname.elements[k].id;
 3190:             if ((id != '') && (id != undefined)) {
 3191:                 if (delstr.test(id)) {
 3192:                     if (formname.elements[k].type == 'checkbox') {
 3193:                         delboxes.push(id);
 3194:                     }
 3195:                 }
 3196:             }
 3197:         }
 3198:         if (delboxes.length > 0) {
 3199:             if ((formname.elements[alluploads[j]].value != undefined) &&
 3200:                 (formname.elements[alluploads[j]].value != '')) {
 3201:                 var filepath = formname.elements[alluploads[j]].value;
 3202:                 var newfilename = fnametrim.exec(filepath);
 3203:                 if (newfilename != null) {
 3204:                     var filename = String(newfilename);
 3205:                     var nospaces = filename.replace(/\\s+/g,'_');
 3206:                     var nospecials = nospaces.replace(/[^\\/\\w\\.\\-]/g,'');
 3207:                     var cleanfilename = nospecials.replace(/\\.(\\d+\\.)/g,"_\$1");
 3208:                     if (cleanfilename != '') {
 3209:                         var fullpath = path+"/"+cleanfilename;
 3210:                         if (multiresp == 1) {
 3211:                             var partid = String(alluploads[i]);
 3212:                             var subdir = partid.replace(/^\\d*.?\\d*_?HWFILE/,'');
 3213:                             if (subdir != "" && subdir != undefined) {
 3214:                                 fullpath = path+"/"+subdir+"/"+cleanfilename;
 3215:                             }
 3216:                         }
 3217:                         for (var m=0; m<delboxes.length; m++) {
 3218:                             if (fullpath == formname.elements[delboxes[m]].value) {
 3219:                                 if (formname.elements[delboxes[m]].checked) {
 3220:                                     allskipdel.push(delboxes[m]);
 3221:                                 } else {
 3222:                                     result['overwrite'].push(alluploads[j]);
 3223:                                 }
 3224:                                 break;
 3225:                             }
 3226:                         }
 3227:                     }
 3228:                 }
 3229:             }
 3230:         }
 3231:     }
 3232:     if (allchecked.length > 0) {
 3233:         if (allskipdel.length > 0) {
 3234:             for (var n=0; n<allchecked.length; n++) {
 3235:                 if (allskipdel.indexOf(allchecked[n]) == -1) {
 3236:                     result['delete'].push(allchecked[n]);
 3237:                 }
 3238:             }
 3239:         } else {
 3240:             result['delete'].push.apply(result['delete'],allchecked);
 3241:         }
 3242:     }
 3243:     return result;
 3244: }
 3245: 
 3246: function check_for_multiples(prefix) {
 3247: $multtext
 3248: }
 3249: 
 3250: function check_for_turninpath(prefix) {
 3251: $turninpathtext
 3252: }
 3253: 
 3254: // ]]>
 3255: </script>
 3256: 
 3257: $arrayindexofjs
 3258: 
 3259: ENDSCRIPT
 3260: }
 3261: 
 3262: ##############################################
 3263: ##############################################
 3264: 
 3265: sub resize_scrollbox_js {
 3266:     my ($context,$tabidstr,$tid) = @_;
 3267:     my (%names,$paddingwfrac,$offsetwfrac,$offsetv,$minw,$minv);
 3268:     if ($context eq 'docs') {
 3269:         %names = (
 3270:                    boxw   => 'contenteditor',
 3271:                    item   => 'contentlist',
 3272:                    header => 'uploadfileresult',
 3273:                    scroll => 'contentscroll',
 3274:                    boxh   => 'contenteditor',
 3275:                  );
 3276:         $paddingwfrac = 0.09;
 3277:         $offsetwfrac = 0.015;
 3278:         $offsetv = 20;
 3279:         $minw = 250;
 3280:         $minv = 200;
 3281:     } elsif ($context eq 'params') {
 3282:         %names = (
 3283:                    boxw   => 'parameditor',
 3284:                    item   => 'mapmenuinner',
 3285:                    header => 'parmstep1',
 3286:                    scroll => 'mapmenuscroll',
 3287:                    boxh   => 'parmlevel',
 3288:                  );
 3289:         $paddingwfrac = 0.2;
 3290:         $offsetwfrac = 0.015;
 3291:         $offsetv = 80;
 3292:         $minw = 100;
 3293:         $minv = 100; 
 3294:     }
 3295:     my $viewport_js = &Apache::loncommon::viewport_geometry_js();
 3296:     my $output = '
 3297: 
 3298: window.onresize=callResize;
 3299: 
 3300: ';
 3301:     if ($context eq 'docs') {
 3302:         if ($env{'form.active'}) {
 3303:             $output .= "\nvar activeTab = '$env{'form.active'}$tid';\n";
 3304:         } else {
 3305:             $output .= "\nvar activeTab = '';\n";
 3306:         }
 3307:     }
 3308:     $output .=  <<"FIRST";
 3309: 
 3310: $viewport_js
 3311: 
 3312: function resize_scrollbox(scrollboxname,chkw,chkh) {
 3313:     var scrollboxid = 'div_'+scrollboxname;
 3314:     var scrolltableid = 'table_'+scrollboxname;
 3315:     var scrollbox;
 3316:     var scrolltable;
 3317:     var ismobile = '$env{'browser.mobile'}';
 3318: 
 3319:     if (document.getElementById("$names{'boxw'}") == null) {
 3320:         return;
 3321:     }
 3322: 
 3323:     if (document.getElementById(scrollboxid) == null) {
 3324:         return;
 3325:     } else {
 3326:         scrollbox = document.getElementById(scrollboxid);
 3327:     }
 3328: 
 3329: 
 3330:     if (document.getElementById(scrolltableid) == null) {
 3331:         return;
 3332:     } else {
 3333:         scrolltable = document.getElementById(scrolltableid);
 3334:     }
 3335: 
 3336:     init_geometry();
 3337:     var vph = Geometry.getViewportHeight();
 3338:     var vpw = Geometry.getViewportWidth();
 3339: 
 3340: FIRST
 3341:     if ($context eq 'docs') {
 3342:         $output .= "
 3343:     var alltabs = ['$tabidstr'];
 3344: ";
 3345:     } elsif ($context eq 'params') {
 3346:         $output .= "
 3347:     if (document.getElementById('$names{'boxh'}') == null) {
 3348:         return;
 3349:     }
 3350: ";
 3351:     }
 3352:     $output .= <<"SECOND";
 3353:     var listwchange;
 3354:     var scrollchange;
 3355:     if (chkw == 1) {
 3356:         var boxw = document.getElementById("$names{'boxw'}").offsetWidth;
 3357:         var itemw;
 3358:         var itemid = document.getElementById("$names{'item'}");
 3359:         if (itemid != null) {
 3360:             itemw = itemid.offsetWidth;
 3361:         }
 3362:         var itemwstart = itemw;
 3363: 
 3364:         var scrollboxw = scrollbox.offsetWidth;
 3365:         var scrollboxscrollw = scrollbox.scrollWidth;
 3366:         var scrollstart = scrollboxw;
 3367: 
 3368:         var offsetw = parseInt(vpw * $offsetwfrac);
 3369:         var paddingw = parseInt(vpw * $paddingwfrac);
 3370: 
 3371:         var minscrollboxw = $minw;
 3372:         var maxcolw = 0;
 3373: SECOND
 3374:     if ($context eq 'docs') {
 3375:         $output .= <<"DOCSONE";
 3376:         var actabw = 0;
 3377:         for (var i=0; i<alltabs.length; i++) {
 3378:             if (activeTab == alltabs[i]) {
 3379:                 actabw = document.getElementById(alltabs[i]).offsetWidth;
 3380:                 if (actabw > maxcolw) {
 3381:                     maxcolw = actabw;
 3382:                 }
 3383:             } else {
 3384:                 if (document.getElementById(alltabs[i]) != null) {
 3385:                     var thistab = document.getElementById(alltabs[i]);
 3386:                     thistab.style.visibility = 'hidden';
 3387:                     thistab.style.display = 'block';
 3388:                     var tabw = document.getElementById(alltabs[i]).offsetWidth;
 3389:                     thistab.style.display = 'none';
 3390:                     thistab.style.visibility = '';
 3391:                     if (tabw > maxcolw) {
 3392:                         maxcolw = tabw;
 3393:                     }
 3394:                 }
 3395:             }
 3396:         }
 3397: DOCSONE
 3398:     } elsif ($context eq 'params') {
 3399:         $output .= <<"PARAMSONE";
 3400:         var parmlevelrows = new Array();
 3401:         var mapmenucells = new Array();
 3402:         parmlevelrows = document.getElementById("$names{'boxh'}").rows;
 3403:         var numrows = parmlevelrows.length;
 3404:         if (numrows > 1) {
 3405:             mapmenucells = parmlevelrows[2].getElementsByTagName('td');
 3406:         }
 3407:         maxcolw = mapmenucells[0].offsetWidth;
 3408: PARAMSONE
 3409:     }
 3410:     $output .= <<"THIRD";
 3411:         if (maxcolw > 0) {
 3412:             var newscrollboxw;
 3413:             if (maxcolw+paddingw+scrollboxscrollw<boxw) {
 3414:                 newscrollboxw = boxw-paddingw-maxcolw;
 3415:                 if (newscrollboxw < minscrollboxw) {
 3416:                     newscrollboxw = minscrollboxw;
 3417:                 }
 3418:                 scrollbox.style.width = newscrollboxw+"px";
 3419:                 if (newscrollboxw != scrollboxw) {
 3420:                     var newitemw = newscrollboxw-offsetw;
 3421:                     itemid.style.width = newitemw+"px";
 3422:                 }
 3423:             } else {
 3424:                 newscrollboxw = boxw-paddingw-maxcolw;
 3425:                 if (newscrollboxw < minscrollboxw) {
 3426:                     newscrollboxw = minscrollboxw;
 3427:                 }
 3428:                 scrollbox.style.width = newscrollboxw+"px";
 3429:                 if (newscrollboxw != scrollboxw) {
 3430:                     var newitemw = newscrollboxw-offsetw;
 3431:                     itemid.style.width = newitemw+"px";
 3432:                 }
 3433:             }
 3434: 
 3435:             if (newscrollboxw != scrollboxw) {
 3436:                 var newscrolltablew = newscrollboxw+offsetw;
 3437:                 scrolltable.style.width = newscrolltablew+"px";
 3438:             }
 3439:         }
 3440: 
 3441:         if (newscrollboxw != scrollboxw) {
 3442:             scrollchange = 1;
 3443:         }
 3444: 
 3445:         if (itemid.offsetWidth != itemwstart) {
 3446:             listwchange = 1;
 3447:         }
 3448:     }
 3449:     if ((chkh == 1) || (listwchange)) {
 3450:         var itemid = document.getElementById("$names{'item'}");
 3451:         if (itemid != null) {
 3452:             itemh = itemid.offsetHeight;
 3453:         }
 3454:         var primaryheight = 0;
 3455:         if (document.getElementById('LC_nav_bar') != null) { 
 3456:             primaryheight = document.getElementById('LC_nav_bar').offsetHeight;
 3457:         }
 3458:         var secondaryheight = 0;
 3459:         if (document.getElementById('LC_secondary_menu') != null) { 
 3460:             secondaryheight = document.getElementById('LC_secondary_menu').offsetHeight;
 3461:         }
 3462:         var crumbsheight = 0;
 3463:         if (document.getElementById('LC_breadcrumbs') != null) {
 3464:             crumbsheight = document.getElementById('LC_breadcrumbs').offsetHeight;
 3465:         }
 3466:         var dccidheight = 0;
 3467:         if (document.getElementById('dccid') != null) {
 3468:             dccidheight = document.getElementById('dccid').offsetHeight;
 3469:         }
 3470:         var headerheight = 0;
 3471:         if (document.getElementById("$names{'header'}") != null) {
 3472:             headerheight = document.getElementById("$names{'header'}").offsetHeight;
 3473:         }
 3474:         var tabbedheight = document.getElementById("tabbededitor").offsetHeight;
 3475:         var boxheight = document.getElementById("$names{'boxh'}").offsetHeight;
 3476:         var freevspace = vph-(primaryheight+secondaryheight+crumbsheight+dccidheight+headerheight+tabbedheight+boxheight);
 3477: 
 3478:         var scrollboxheight = scrollbox.offsetHeight;
 3479:         var scrollboxscrollheight = scrollbox.scrollHeight;
 3480:         var scrollboxh = scrollboxheight;
 3481: 
 3482:         var minvscrollbox = $minv;
 3483:         var offsetv = $offsetv;
 3484:         var newscrollboxheight;
 3485:         if (freevspace < 0) {
 3486:             newscrollboxheight = scrollboxheight+freevspace-offsetv;
 3487:             if (newscrollboxheight < minvscrollbox) {
 3488:                 newscrollboxheight = minvscrollbox;
 3489:             }
 3490:             scrollbox.style.height = newscrollboxheight + "px";
 3491:         } else {
 3492:             if (scrollboxscrollheight > scrollboxheight) {
 3493:                 if (freevspace > offsetv) {
 3494:                     newscrollboxheight = scrollboxheight+freevspace-offsetv;
 3495:                     if (newscrollboxheight < minvscrollbox) {
 3496:                         newscrollboxheight = minvscrollbox;
 3497:                     }
 3498:                     scrollbox.style.height = newscrollboxheight+"px";
 3499:                 }
 3500:             }
 3501:         }
 3502:         scrollboxheight = scrollbox.offsetHeight;
 3503:         var itemh = document.getElementById("$names{'item'}").offsetHeight;
 3504: 
 3505:         if (scrollboxscrollheight <= scrollboxheight) {
 3506:             if ((itemh+offsetv)<scrollboxheight) {
 3507:                 newscrollheight = itemh+offsetv;
 3508:                 scrollbox.style.height = newscrollheight+"px";
 3509:             }
 3510:         }
 3511:         var newscrollboxh = scrollbox.offsetHeight;
 3512:         if (scrollboxh != newscrollboxh) {
 3513:             scrollchange = 1;
 3514:         }
 3515:     }
 3516:     if (ismobile && scrollchange) {
 3517:         \$("#div_$names{'scroll'}").getNiceScroll().onResize();
 3518:     }
 3519:     return;
 3520: }
 3521: 
 3522: function callResize() {
 3523:     var timer;
 3524:     clearTimeout(timer);
 3525:     timer=setTimeout('resize_scrollbox("$names{'scroll'}","1","1")',500);
 3526: }
 3527: 
 3528: THIRD
 3529:     return $output;
 3530: }
 3531: 
 3532: ##############################################
 3533: ##############################################
 3534: 
 3535: sub javascript_jumpto_resource {
 3536:     my $confirm_switch = &mt("Editing requires switching to the resource's home server.")."\n".
 3537:                          &mt('Switch server?');
 3538:     my $confirm_new_tab = &mt("Editing requires using the resource's home server.")."\n".
 3539:                           &mt('Open a new browser tab?');
 3540:     &js_escape(\$confirm_switch);
 3541:     &js_escape(\$confirm_new_tab);
 3542:     return (<<ENDUTILITY)
 3543: 
 3544: function go(url) {
 3545:    if (url!='' && url!= null) {
 3546:        currentURL = null;
 3547:        currentSymb= null;
 3548:        var lcHostname = setLCHost();
 3549:        if (lcHostname!='' && lcHostname!= null) {
 3550:            var RegExp = /^https?\:/;
 3551:            if (RegExp.test(url)) {
 3552:                window.location.href=url;
 3553:            } else {
 3554:                window.location.href=lcHostname+url;
 3555:            }
 3556:        } else {
 3557:            window.location.href=url;
 3558:        }
 3559:    }
 3560: }
 3561: 
 3562: function need_switchserver(url,target) {
 3563:     if (url!='' && url!= null) {
 3564:         if (target == '_blank') {
 3565:             if (confirm("$confirm_new_tab")) {
 3566:                 window.open(url,target);
 3567:             }
 3568:         } else if (confirm("$confirm_switch")) {
 3569:             go(url);
 3570:         }
 3571:     }
 3572:     return;
 3573: }
 3574: 
 3575: ENDUTILITY
 3576: 
 3577: }
 3578: 
 3579: sub jump_to_editres {
 3580:     my ($cfile,$home,$switchserver,$forceedit,$forcereg,$symb,$shownsymb,
 3581:         $folderpath,$title,$hostname,$idx,$suppurl,$todocs,$suppanchor) = @_;
 3582:     my ($jscall,$anchor,$usehttp,$usehttps,$is_ext,$target);
 3583:     if ($switchserver) {
 3584:         if ($home) {
 3585:             my $resedit;
 3586:             if ($cfile =~ m{^/priv/($match_domain)/($match_username)/}) {
 3587:                 my ($audom,$auname) = ($1,$2);
 3588:                 unless (&Apache::lonnet::is_course($audom,$auname)) {
 3589:                     unless ((&Apache::lonnet::will_trust('othcoau',$env{'user.domain'},$audom)) &&
 3590:                             (&Apache::lonnet::will_trust('coaurem',$audom,$env{'user.domain'}))) {
 3591:                        return;
 3592:                     }
 3593:                     if (($symb ne '') && ($env{'request.course.id'}) &&
 3594:                         (&Apache::lonnet::allowed('mdc',$env{'request.course.id'}))) {
 3595:                         unless (&Apache::lonnet::can_switchserver($env{'user.domain'},$home)) {
 3596:                             $target = '_blank';
 3597:                             $resedit = 1;
 3598:                         }
 3599:                     }
 3600:                 }
 3601:             }
 3602:             $cfile = '/adm/switchserver?otherserver='.$home.'&amp;role='.
 3603:                      &HTML::Entities::encode($env{'request.role'},'"<>&');
 3604:             if ($shownsymb) {
 3605:                 $cfile .= '&amp;symb='.&HTML::Entities::encode($shownsymb,'"<>&');
 3606:                 if ($resedit) {
 3607:                     $cfile .= '&amp;edit=1';
 3608:                 }
 3609:             } elsif ($folderpath) {
 3610:                 $cfile .= '&amp;folderpath='.&HTML::Entities::encode($folderpath,'"<>&');
 3611:             }
 3612:             if ($forceedit) {
 3613:                 $cfile .= '&amp;forceedit=1';
 3614:             }
 3615:             if ($forcereg) {
 3616:                 $cfile .= '&amp;register=1';
 3617:             }
 3618:             $jscall = "need_switchserver('".&Apache::loncommon::escape_single($cfile)."','$target')";
 3619:         }
 3620:     } else {
 3621:         unless ($cfile =~ m{^/priv/}) {
 3622:             if ($cfile =~ m{^(/adm/wrapper/ext/([^#]+))(?:|#([^#]+))$}) {
 3623:                 $cfile = $1;
 3624:                 my $extlink = $2;
 3625:                 $anchor = $3;
 3626:                 $is_ext = 1;
 3627:                 if (($extlink !~ /^https:/) && ($ENV{'SERVER_PORT'} == 443)) {
 3628:                     unless ((&Apache::lonnet::uses_sts()) || (&Apache::lonnet::waf_allssl($hostname))) {
 3629:                         $usehttp = 1;
 3630:                     }
 3631:                 } elsif ($env{'request.use_absolute'}) {
 3632:                     if ($env{'request.use_absolute'} =~ m{^https://}) {
 3633:                         $usehttps = 1;
 3634:                     }
 3635:                 } 
 3636:             } elsif ($cfile =~ m{^/?public/($match_domain)/($match_courseid)/syllabus}) {
 3637:                 if ($ENV{'SERVER_PORT'} == 443) {
 3638:                     my ($cdom,$cnum) = ($1,$2);
 3639:                     if (($env{'request.course.id'}) &&
 3640:                         ($env{'course.'.$env{'request.course.id'}.'.num'} eq $cnum) &&
 3641:                         ($env{'course.'.$env{'request.course.id'}.'.domain'} eq $cdom)) {
 3642:                         if ($env{'course.'.$env{'request.course.id'}.'.externalsyllabus'} =~ m{^http://}) {
 3643:                             unless ((&Apache::lonnet::uses_sts()) || (&Apache::lonnet::waf_allssl($hostname))) {
 3644:                                 $usehttp = 1;
 3645:                             }
 3646:                         }
 3647:                     }
 3648:                 } elsif ($env{'request.use_absolute'}) {
 3649:                     if ($env{'request.use_absolute'} =~ m{^https://}) {
 3650:                         $usehttps = 1;
 3651:                     }
 3652:                 }
 3653:             }
 3654:             if ($symb) {
 3655:                 if ($anchor ne '') {
 3656:                     if ($symb =~ m{^([^#]+)\Q#$anchor\E$}) {
 3657:                         $symb = $1.&escape(&escape('#')).$anchor;
 3658:                     }
 3659:                 }
 3660:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?')."symb=$symb";
 3661:             } elsif ($folderpath) {
 3662:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').
 3663:                           'folderpath='.&HTML::Entities::encode(&escape($folderpath),'"<>&');
 3664:                 if ($title) {
 3665:                     $cfile .= (($cfile=~/\?/)?'&amp;':'?').
 3666:                               'title='.&HTML::Entities::encode(&escape($title),'"<>&');
 3667:                 }
 3668:                 if ($idx) {
 3669:                     $cfile .= (($cfile=~/\?/)?'&amp;':'?').'idx='.$idx;
 3670:                 }
 3671:                 if ($suppurl) {
 3672:                     $cfile .= (($cfile=~/\?/)?'&amp;':'?').
 3673:                               'suppurl='.&HTML::Entities::encode(&escape($suppurl));
 3674:                 }
 3675:             }
 3676:             if ($forceedit) {
 3677:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').'forceedit=1';
 3678:                 if ($usehttps) {
 3679:                     $cfile = $env{'request.use_absolute'}.(($cfile =~ /^\//)? '':'/').$cfile;
 3680:                 }
 3681:             } elsif ($usehttp) {
 3682:                 if ($hostname ne '') {
 3683:                     $cfile = 'http://'.$hostname.(($cfile =~ /^\//)? '':'/').$cfile;
 3684:                 }
 3685:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').'usehttp=1';
 3686:             } elsif ($usehttps) {
 3687:                 $cfile = $env{'request.use_absolute'}.(($cfile =~ /^\//)? '':'/').$cfile;
 3688:             }
 3689:             if ($forcereg) {
 3690:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').'register=1';
 3691:             }
 3692:             if ($todocs) {
 3693:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').'todocs=1';
 3694:             }
 3695:             if ($suppanchor ne '') {
 3696:                 $cfile .= (($cfile=~/\?/)?'&amp;':'?').'anchor='.
 3697:                           &HTML::Entities::encode($suppanchor,'"<>&');
 3698:             }
 3699:         }
 3700:         if ($anchor ne '') {
 3701:             $cfile .= '#'.$anchor;
 3702:         }
 3703:         $jscall = "go('".&Apache::loncommon::escape_single($cfile)."')";
 3704:     }
 3705:     return $jscall;
 3706: }
 3707: 
 3708: ##############################################
 3709: ##############################################
 3710: 
 3711: # javascript_valid_email
 3712: #
 3713: # Generates javascript to validate an e-mail address.
 3714: # Returns a javascript function which accepts a form field as argument, and
 3715: # returns false if field.value does not satisfy two regular expression matches
 3716: # for a valid e-mail address.  Backwards compatible with old browsers without
 3717: # support for javascript RegExp (just checks for @ in field.value in this case). 
 3718: 
 3719: sub javascript_valid_email {
 3720:     my $scripttag .= <<'END';
 3721: function validmail(field,suffix) {
 3722:     var str = field.value;
 3723:     if (suffix != '' && suffix != undefined) {
 3724:         str += suffix;
 3725:     }
 3726:     if (window.RegExp) {
 3727:         var reg1str = "(@.*@)|(\\.\\.)|(@\\.)|(\\.@)|(^\\.)";
 3728:         var reg2str = "^.+\\@(\\[?)[a-zA-Z0-9\\-\\.]+\\.([a-zA-Z]{2,3}|[0-9]{1,3})(\\]?)$"; //"
 3729:         var reg1 = new RegExp(reg1str);
 3730:         var reg2 = new RegExp(reg2str);
 3731:         if (!reg1.test(str) && reg2.test(str)) {
 3732:             return true;
 3733:         }
 3734:         return false;
 3735:     }
 3736:     else
 3737:     {
 3738:         if(str.indexOf("@") >= 0) {
 3739:             return true;
 3740:         }
 3741:         return false;
 3742:     }
 3743: }
 3744: END
 3745:     return $scripttag;
 3746: }
 3747: 
 3748: 
 3749: # USAGE: htmltag(element, content, {attribute => value,...});
 3750: #
 3751: # EXAMPLES: 
 3752: #  - htmltag('a', 'this is an anchor', {href  => 'www.example.com', 
 3753: #                                       title => 'this is a title'})
 3754: #
 3755: #  - You might want to set up needed tags like: 
 3756: #
 3757: #     my $h3  = sub { return htmltag( "h3",  @_ ) };
 3758: #
 3759: #    ... and use them: $h3->("This is a headline")
 3760: #
 3761: #  - To set up a couple of tags, see sub inittags
 3762: #
 3763: # NOTES:
 3764: # - Empty elements, such as <br/> are correctly terminated, 
 3765: #   i.e. htmltag('br') returns <br/> 
 3766: # - Empty attributes (title="") are filtered out.
 3767: # - The function will not check for deprecated attributes.
 3768: #
 3769: # OUTPUT: content enclosed in xhtml conform tags
 3770: sub htmltag{
 3771:     return
 3772:         qq|<$_[0]|
 3773:         . join( '', map { qq| $_="${$_[2]}{$_}"| if ${$_[2]}{$_} } keys(%{ $_[2] }) )
 3774:         . ($_[1] ? qq|>$_[1]</$_[0]>| : qq|/>|). "\n";
 3775: };
 3776: 
 3777: 
 3778: # USAGE: inittags(@tags);
 3779: #
 3780: # EXAMPLES:
 3781: #  - my ($h1, $h2, $h3) = inittags( qw( h1 h2 h3 ) )
 3782: #    $h1->("This is a headline") #Returns: <h1>This is a headline</h1>
 3783: #
 3784: # NOTES: See sub htmltag for further information.
 3785: #
 3786: # OUTPUT: List of subroutines. 
 3787: sub inittags {
 3788:     my @tags = @_;
 3789:     return map { my $tag = $_;
 3790:                  sub { return htmltag( $tag, @_ ) }
 3791:                } @tags;
 3792: }
 3793: 
 3794: 
 3795: # USAGE: scripttag(scriptcode, [start|end|both]);
 3796: #
 3797: # EXAMPLES: 
 3798: #  - scripttag("alert('Hello World!')", 'both') 
 3799: #    returns:
 3800: #    <script type="text/javascript">
 3801: #    // BEGIN LON-CAPA Internal
 3802: #    alert(Hello World!')
 3803: #    // END LON-CAPA Internal
 3804: #    </script>
 3805: #
 3806: # NOTES:
 3807: # - works currently only for javascripts
 3808: #
 3809: # OUTPUT: 
 3810: # Scriptcode properly enclosed in <script> and CDATA tags (and LC
 3811: # Internal markers if 2nd argument is given)
 3812: sub scripttag {
 3813:     my ( $content, $marker ) = @_;
 3814:     return unless defined $content;
 3815: 
 3816:     my $begin = "\n// BEGIN LON-CAPA Internal\n";
 3817:     my $end   = "\n// END LON-CAPA Internal\n";
 3818: 
 3819:     if ($marker) {
 3820:         $content  = $begin . $content if $marker eq 'start' or $marker eq 'both';
 3821:         $content .= $end              if $marker eq 'end'   or $marker eq 'both';
 3822:     }
 3823: 
 3824:     $content = "\n// <![CDATA[\n$content\n// ]]>\n";
 3825: 
 3826:     return htmltag('script', $content, {type => 'text/javascript'});
 3827: };
 3828: 
 3829: =pod
 3830: 
 3831: =item &list_from_array( \@array, { listattr =>{}, itemattr =>{} } )
 3832: 
 3833: Constructs a XHTML list from \@array.
 3834: 
 3835: =over
 3836: 
 3837: =item input: 
 3838: 
 3839: =over
 3840: 
 3841: =item \@array 
 3842: 
 3843: A reference to the array containing text that will be wrapped in <li></li> tags.
 3844: 
 3845: =item { listattr => {}, itemattr =>{} } 
 3846: 
 3847: Attributes for <ul> and <li> passed in as hash references. 
 3848: See htmltag() for more details.
 3849: 
 3850: =back
 3851: 
 3852: =back
 3853: 
 3854: returns: XHTML list as String. 
 3855: 
 3856: =cut   
 3857: 
 3858: # \@items, {listattr => { class => 'abc', id => 'xyx' }, itemattr => {class => 'abc', id => 'xyx'}}
 3859: sub list_from_array {
 3860:     my ($items, $args) = @_;
 3861:     return unless (ref($items) eq 'ARRAY');
 3862:     return unless scalar @$items;
 3863:     my ($ul, $li) = inittags( qw(ul li) );
 3864:     my $listitems = join '', map { $li->($_, $args->{itemattr}) } @$items;
 3865:     return $ul->( $listitems, $args->{listattr} );
 3866: }
 3867: 
 3868: 
 3869: ##############################################
 3870: ##############################################
 3871: 
 3872: # generate_menu
 3873: #
 3874: # Generates html markup for a menu. 
 3875: #
 3876: # Inputs:
 3877: # An array of following structure:
 3878: #   ({	categorytitle => 'Categorytitle',
 3879: #	items => [
 3880: #		    {	
 3881: #           linktext    =>	'Text to be displayed',
 3882: #			url	        =>	'URL the link is pointing to, i.e. /adm/site?action=dosomething',
 3883: #			permission  =>	'Contains permissions as returned from lonnet::allowed(),
 3884: #					         must evaluate to true in order to activate the link',
 3885: #			icon        =>  'icon filename',
 3886: #			alttext	    =>	'alt text for the icon',
 3887: #			help	    =>	'Name of the corresponding helpfile',
 3888: #			linktitle   =>	'Description of the link (used for title tag)'
 3889: #		    },
 3890: #		    ...
 3891: #		]
 3892: #   }, 
 3893: #   ...
 3894: #   )
 3895: #
 3896: # Outputs: A scalar containing the html markup for the menu.
 3897: 
 3898: sub generate_menu {
 3899:     my @menu = @_;
 3900:     # subs for specific html elements
 3901:     my ($h3, $div, $ul, $li, $a, $img) = inittags( qw(h3 div ul li a img) ); 
 3902:     
 3903:     my @categories; # each element represents the entire markup for a category
 3904:    
 3905:     foreach my $category (@menu) {
 3906:         my @links;  # contains the links for the current $category
 3907:         foreach my $link (@{$$category{items}}) {
 3908:             next unless $$link{permission};
 3909:             
 3910:             # create the markup for the current $link and push it into @links.
 3911:             # each entry consists of an image and a text optionally followed 
 3912:             # by a help link.
 3913:             my $src;
 3914:             if ($$link{icon} ne '') {
 3915:                 $src = '/res/adm/pages/'.$$link{icon};
 3916:             }
 3917:             push(@links,$li->(
 3918:                         $a->(
 3919:                             $img->("", {
 3920:                                 class => "LC_noBorder LC_middle",
 3921:                                 src   => $src,
 3922:                                 alt   => mt(defined($$link{alttext}) ?
 3923:                                 $$link{alttext} : $$link{linktext})
 3924:                             }), {
 3925:                             href  => $$link{url},
 3926:                             title => mt($$link{linktitle}),
 3927:                             class => 'LC_menubuttons_link'
 3928:                             }).
 3929:                         $a->(mt($$link{linktext}), {
 3930:                             href  => $$link{url},
 3931:                             title => mt($$link{linktitle}),
 3932:                             class => "LC_menubuttons_link"
 3933:                             }).
 3934:                          (defined($$link{help}) ? 
 3935:                          Apache::loncommon::help_open_topic($$link{help}) : ''),
 3936:                          {class => "LC_menubuttons_inline_text"}));
 3937:         }
 3938: 
 3939:         # wrap categorytitle in <h3>, concatenate with 
 3940:         # joined and in <ul> tags wrapped @links
 3941:         # and wrap everything in an enclosing <div> and push it into
 3942:         # @categories
 3943:         # such that each element looks like:
 3944:         # <div><h3>title</h3><ul><li>...</li>...</ul></div>
 3945:         # the category won't be added if there aren't any links
 3946:         push(@categories, 
 3947:             $div->($h3->(mt($$category{categorytitle}), {class=>"LC_hcell"}).
 3948:             $ul->(join('' ,@links),  {class =>"LC_ListStyleNormal" }),
 3949:             {class=>"LC_Box LC_400Box"})) if scalar(@links);
 3950:     }
 3951: 
 3952:     # wrap the joined @categories in another <div> (column layout)
 3953:     return $div->(join('', @categories), {class => "LC_columnSection"});
 3954: }
 3955: 
 3956: ##############################################
 3957: ##############################################
 3958: 
 3959: =pod
 3960: 
 3961: =item &start_funclist()
 3962: 
 3963: Start list of available functions
 3964: 
 3965: Typically used to offer a simple list of available functions
 3966: at top or bottom of page.
 3967: All available functions/actions for the current page
 3968: should be included in this list.
 3969: 
 3970: If the optional headline text is not provided, a default text will be used.
 3971: 
 3972: =over
 3973: 
 3974: =item Related routines:
 3975: 
 3976: =over 4
 3977: 
 3978: =item add_item_funclist
 3979: 
 3980: =item end_funclist
 3981: 
 3982: =back
 3983: 
 3984: =back
 3985: 
 3986: Inputs: (optional) headline text
 3987: 
 3988: Returns: HTML code with function list start
 3989: 
 3990: =cut
 3991: 
 3992: ##############################################
 3993: ##############################################
 3994: 
 3995: sub start_funclist {
 3996:     my($legendtext)=@_;
 3997:     $legendtext=&mt('Functions') if !$legendtext;
 3998:     return '<ul class="LC_funclist"><li style="font-weight:bold; margin-left:0.8em;">'.$legendtext.'</li>'."\n";
 3999: }
 4000: 
 4001: 
 4002: ##############################################
 4003: ##############################################
 4004: 
 4005: =pod
 4006: 
 4007: =item &add_item_funclist()
 4008: 
 4009: Adds an item to the list of available functions
 4010: 
 4011: =over
 4012: 
 4013: =item Related routines:
 4014: 
 4015: =over 4
 4016: 
 4017: =item start_funclist
 4018: 
 4019: =item end_funclist
 4020: 
 4021: =back
 4022: 
 4023: =back
 4024: 
 4025: Inputs: content item with text and link to function
 4026: 
 4027: Returns: HTML code with list item for funclist
 4028: 
 4029: =cut
 4030: 
 4031: ##############################################
 4032: ##############################################
 4033: 
 4034: sub add_item_funclist {
 4035:     my($content) = @_;
 4036:     return '<li>'.$content.'</li>'."\n";
 4037: }
 4038: 
 4039: =pod
 4040: 
 4041: =item &end_funclist()
 4042: 
 4043: End list of available functions
 4044: 
 4045: =over
 4046: 
 4047: =item Related routines:
 4048: 
 4049:  start_funclist
 4050:  add_item_funclist
 4051: 
 4052: =back
 4053: 
 4054: Inputs: ./.
 4055: 
 4056: Returns: HTML code with function list end
 4057: 
 4058: =cut
 4059: 
 4060: sub end_funclist {
 4061:     return "</ul>\n";
 4062: }
 4063: 
 4064: =pod
 4065: 
 4066: =item &funclist_from_array( \@array, {legend => 'text for legend'} )
 4067: 
 4068: Constructs a XHTML list from \@array with the first item being visually
 4069: highlighted and set to the value of legend or 'Functions' if legend is
 4070: empty. 
 4071: 
 4072: =over
 4073: 
 4074: =item \@array
 4075: 
 4076: A reference to the array containing text that will be wrapped in <li></li> tags.
 4077: 
 4078: =item { legend => 'text' }
 4079: 
 4080: A string that's used as visually highlighted first item. 'Functions' is used if
 4081: it's value evaluates to false.
 4082: 
 4083: =back
 4084: 
 4085: returns: XHTML list as string. 
 4086: 
 4087: =back
 4088: 
 4089: =cut  
 4090: 
 4091: sub funclist_from_array {
 4092:     my ($items, $args) = @_;
 4093:     return unless(ref($items) eq 'ARRAY');
 4094:     $args->{legend} ||= mt('Functions');
 4095:     return list_from_array( [$args->{legend}, @$items], 
 4096:                { listattr => {class => 'LC_funclist'} });
 4097: }
 4098: 
 4099: =pod
 4100: 
 4101: =over
 4102: 
 4103: =item &actionbox( \@array )
 4104: 
 4105: Constructs a XHTML list from \@array with the first item being visually
 4106: highlighted and set to the value 'Actions'. The list is wrapped in a division.
 4107: 
 4108: The actionlist is used to offer contextual actions, mostly at the bottom
 4109: of a page, on which the outcome of an processed action is shown,
 4110: e.g. a file operation in Authoring Space.
 4111: 
 4112: =over
 4113: 
 4114: =item \@array
 4115: 
 4116: A reference to the array containing text. Details: sub funclist_from_array
 4117: 
 4118: =back
 4119: 
 4120: Returns: XHTML div as string. 
 4121: 
 4122: =back
 4123: 
 4124: =cut  
 4125: 
 4126: sub actionbox {
 4127:     my ($items) = @_;
 4128:     return unless(ref($items) eq 'ARRAY');
 4129:     return
 4130:         '<div class="LC_actionbox">'
 4131:        .&funclist_from_array($items, {legend => &mt('Actions')})
 4132:        .'</div>';
 4133: }
 4134: 
 4135: 1;
 4136: 
 4137: __END__

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>