--- loncom/interface/lonhtmlcommon.pm	2004/02/18 08:07:16	1.52
+++ loncom/interface/lonhtmlcommon.pm	2004/04/16 15:06:56	1.65
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # a pile of common html routines
 #
-# $Id: lonhtmlcommon.pm,v 1.52 2004/02/18 08:07:16 www Exp $
+# $Id: lonhtmlcommon.pm,v 1.65 2004/04/16 15:06:56 albertel Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -60,7 +60,6 @@ use Time::HiRes;
 use Apache::lonlocal;
 use strict;
 
-
 ##############################################
 ##############################################
 
@@ -202,6 +201,13 @@ Also, to be explicit, a value of 'now' a
 Additional html/javascript to be associated with each element in
 the date_setter.  See lonparmset for example usage.
 
+=item $includeempty 
+
+=item $state
+
+Specifies the initial state of the form elements.  Either 'disabled' or empty.
+Defaults to empty, which indiciates the form elements are not disabled. 
+
 =back
 
 Bugs
@@ -213,7 +219,10 @@ The method used to restrict user input w
 ##############################################
 ##############################################
 sub date_setter {
-    my ($formname,$dname,$currentvalue,$special,$includeempty) = @_;
+    my ($formname,$dname,$currentvalue,$special,$includeempty,$state) = @_;
+    if (! defined($state) || $state ne 'disabled') {
+        $state = '';
+    }
     if (! defined($currentvalue) || $currentvalue eq 'now') {
 	unless ($includeempty) {
 	    $currentvalue = time;
@@ -222,7 +231,7 @@ sub date_setter {
 	}
     }
     # other potentially useful values:     wkday,yrday,is_daylight_savings
-    my ($sec,$min,$hour,$mday,$month,$year)=('','','','','','');
+    my ($sec,$min,$hour,$mday,$month,$year)=('','',undef,'','','');
     if ($currentvalue) {
 	($sec,$min,$hour,$mday,$month,$year,undef,undef,undef) = 
 	    localtime($currentvalue);
@@ -262,18 +271,39 @@ sub date_setter {
         }
     }
 
+    function $dname\_disable() {
+        document.$formname.$dname\_month.disabled=true;
+        document.$formname.$dname\_day.disabled=true;
+        document.$formname.$dname\_year.disabled=true;
+        document.$formname.$dname\_hour.disabled=true;
+        document.$formname.$dname\_minute.disabled=true;
+        document.$formname.$dname\_second.disabled=true;
+    }
+
+    function $dname\_enable() {
+        document.$formname.$dname\_month.disabled=false;
+        document.$formname.$dname\_day.disabled=false;
+        document.$formname.$dname\_year.disabled=false;
+        document.$formname.$dname\_hour.disabled=false;
+        document.$formname.$dname\_minute.disabled=false;
+        document.$formname.$dname\_second.disabled=false;        
+    }
+
     function $dname\_opencalendar() {
-       var calwin=window.open(
+        if (! document.$formname.$dname\_month.disabled) {
+            var calwin=window.open(
 "/adm/announcements?pickdate=yes&formname=$formname&element=$dname&month="+
 document.$formname.$dname\_month.value+"&year="+
 document.$formname.$dname\_year.value,
              "LONCAPAcal",
               "height=350,width=350,scrollbars=yes,resizable=yes,menubar=no");
+        }
 
     }
 </script>
 ENDJS
     $result .= "  <nobr><select name=\"$dname\_month\" ".$special.' '.
+        $state.' '.
         "onChange=\"javascript:$dname\_checkday()\" >\n";
     my @Months = qw/January February  March     April   May      June 
                     July    August    September October November December/;
@@ -286,18 +316,18 @@ ENDJS
         $result .= "> ".&mt($Months[$m])." </option>\n";
     }
     $result .= "  </select>\n";
-    $result .= "  <input type=\"text\" name=\"$dname\_day\" ".
+    $result .= "  <input type=\"text\" name=\"$dname\_day\" ".$state.' '.
             "value=\"$mday\" size=\"3\" ".$special.' '.
             "onChange=\"javascript:$dname\_checkday()\" />\n";
-    $result .= "  <input type=\"year\" name=\"$dname\_year\" ".
+    $result .= "  <input type=\"year\" name=\"$dname\_year\" ".$state.' '.
             "value=\"$year\" size=\"5\" ".$special.' '.
             "onChange=\"javascript:$dname\_checkday()\" />\n";
     $result .= "&nbsp;&nbsp;";
-    $result .= "  <select name=\"$dname\_hour\" ".$special." >\n";
+    $result .= "  <select name=\"$dname\_hour\" ".$special." ".$state.' '.">\n";
     if ($includeempty) { $result.="<option value=''></option>"; }
     for (my $h = 0;$h<24;$h++) {
         $result .= "      <option value=\"$h\" ";
-        $result .= "selected " if ($hour == $h);
+        $result .= "selected " if (defined($hour) && $hour == $h);
         $result .= "> ";
 	my $timest='';
         if ($h == 0) {
@@ -314,8 +344,10 @@ ENDJS
     } 
     $result .= "  </select>\n";
     $result .= "  <input type=\"text\" name=\"$dname\_minute\" ".$special.' '.
+        $state.' '.
         "value=\"$min\" size=\"3\" /> m\n";
     $result .= "  <input type=\"text\" name=\"$dname\_second\" ".$special.' '.
+        $state.' '.
         "value=\"$sec\" size=\"3\" /> s\n";
     $result .= "<a href=\"javascript:$dname\_opencalendar()\">".
     &mt('Select Date')."</a></nobr>\n<!-- end $dname date setting form -->\n";
@@ -360,12 +392,14 @@ sub get_date_from_form {
         if (($tmpsec =~ /^\d+$/) && ($tmpsec >= 0) && ($tmpsec < 60)) {
             $sec = $tmpsec;
         }
+	if (!defined($tmpsec) || $tmpsec eq '') { $sec = 0; }
     }
     if (defined($ENV{'form.'.$dname.'_minute'})) {
         my $tmpmin = $ENV{'form.'.$dname.'_minute'};
         if (($tmpmin =~ /^\d+$/) && ($tmpmin >= 0) && ($tmpmin < 60)) {
             $min = $tmpmin;
         }
+	if (!defined($tmpmin) || $tmpmin eq '') { $min = 0; }
     }
     if (defined($ENV{'form.'.$dname.'_hour'})) {
         my $tmphour = $ENV{'form.'.$dname.'_hour'};
@@ -677,7 +711,7 @@ sub Create_PrgWin {
 	}
 	if (!$inputname) {
 	    $prog_state{'inputname'}=&get_uniq_name();
-	    &r_print($r,'<input type="text" name="'.$prog_state{'inputname'}.
+	    &r_print($r,$heading.' <input type="text" name="'.$prog_state{'inputname'}.
 		     '" size="'.$width.'" />');
 	} else {
 	    $prog_state{'inputname'}=$inputname;
@@ -782,8 +816,11 @@ sub r_print {
 # ------------------------------------------------------- Puts directory header
 
 sub crumbs {
-    my ($uri,$target,$prefix,$form)=@_;
-    my $output='<br /><tt><b><font size="+2">'.$prefix.'/';
+    my ($uri,$target,$prefix,$form,$size)=@_;
+    if (! defined($size)) {
+        $size = '+2';
+    }
+    my $output='<br /><tt><b><font size="'.$size.'">'.$prefix.'/';
     if ($ENV{'user.adv'}) {
 	my $path=$prefix.'/';
 	foreach (split('/',$uri)) {
@@ -806,9 +843,12 @@ sub crumbs {
 # ------------------------------------------------- Output headers for HTMLArea
 
 sub htmlareaheaders {
-    unless (&htmlareabrowser()) { return ''; }
+    unless (&htmlareablocked()) { return ''; }
     my $lang='en';
     return (<<ENDHEADERS);
+<script type="text/javascript">
+    _editor_url="/htmlarea/";
+</script>
 <script type="text/javascript" src="/htmlarea/htmlarea.js"></script>
 <script type="text/javascript" src="/htmlarea/lang/$lang.js"></script>
 <script type="text/javascript" src="/htmlarea/dialog.js"></script>
@@ -821,7 +861,7 @@ ENDHEADERS
 # ---------------------------------------------------------- Script to activate
 
 sub htmlareaactive {
-    unless (&htmlareabrowser()) { return ''; }
+    unless (&htmlareablocked()) { return ''; }
     return (<<ENDSCRIPT);
 <script type="text/javascript" defer="1">
     HTMLArea.replaceAll();
@@ -829,12 +869,156 @@ sub htmlareaactive {
 ENDSCRIPT
 }
 
+# --------------------------------------------------------------------- Blocked
+
+sub htmlareablocked {
+    unless (&htmlareabrowser()) { return ''; }
+    return 1;
+}
+
 # ---------------------------------------- Browser capable of running HTMLArea?
 
 sub htmlareabrowser {
     return 1;
 }
 
+############################################################
+############################################################
+
+=pod
+
+=item breadcrumbs
+
+Compiles the previously registered breadcrumbs into an series of links.
+FAQ and BUG links will be placed on the left side of the table if they
+are defined for the last registered breadcrumb.  
+Additionally supports a 'component', which will be displayed on the
+right side of the table (without a link).
+A link to help for the component will be included if one is specified.
+
+All inputs can be undef without problems.
+
+Inputs: $color (the background color of the table returned),
+        $component (the large text on the right side of the table),
+        $component_help
+        $function (role to get colors from)
+        $domain   (domian of role)
+        $menulink (boolean, controls whether to include a link to /adm/menu)
+
+Returns a string containing breadcrumbs for the current page.
+
+=item clear_breadcrumbs
+
+Clears the previously stored breadcrumbs.
+
+=item add_breadcrumb
+
+Pushes a breadcrumb on the stack of crumbs.
+
+input: $breadcrumb, a hash reference.  The keys 'href','title', and 'text'
+are required.  If present the keys 'faq' and 'bug' will be used to provide
+links to the FAQ and bug sites.
+
+returns: nothing    
+
+=cut
+
+############################################################
+############################################################
+{
+    my @Crumbs;
+    
+    sub breadcrumbs {
+        my ($color,$component,$component_help,$function,$domain,$menulink) =
+	    @_;
+        if (! defined($color)) {
+            if (! defined($function)) {
+                $function = &Apache::loncommon::get_users_function();
+            }
+            $color = &Apache::loncommon::designparm($function.'.tabbg',
+                                                    $domain);
+        }
+        #
+        my $Str = "\n".
+            '<table width="100%" border="0" cellpadding="0" cellspacing="0">'.
+            '<tr><td bgcolor="'.$color.'">'.
+            '<font size="-1">';
+        #
+        # Make the faq and bug data cascade
+        my $faq = '';
+        my $bug = '';
+        # The last breadcrumb does not have a link, so handle it separately.
+        my $last = pop(@Crumbs);
+        #
+        # The first one should be the course, I guess.
+	if (!defined($menulink)) { $menulink=1; }
+        if ($menulink && exists($ENV{'request.course.id'})) {
+            my $cid = $ENV{'request.course.id'};
+            unshift(@Crumbs,{
+                             href=>'/adm/menu',
+                             title=>'Go to main menu',
+                             text=>$ENV{'course.'.$cid.'.description'},
+                            });
+        }
+        my $links .= 
+            join('-&gt;',
+                 map {
+                     $faq = $_->{'faq'} if (exists($_->{'faq'}));
+                     $bug = $_->{'bug'} if (exists($_->{'bug'}));
+                     '<a href="'.$_->{'href'}.'" title="'.&mt($_->{'title'}).'">'.
+                         &mt($_->{'text'}).'</a>' 
+                     } @Crumbs
+                 );
+        $links .= '-&gt;' if ($links ne '');
+        $links .= '<b>'.$last->{'text'}.'</b>';
+        #
+        my $icons = '';
+        $faq = $last->{'faq'} if (exists($last->{'faq'}));
+        $bug = $last->{'bug'} if (exists($last->{'bug'}));
+        if ($faq ne '') {
+            $icons .= &Apache::loncommon::help_open_faq($faq);
+        }
+        if ($bug ne '') {
+            $icons .= &Apache::loncommon::help_open_bug($bug);
+        }
+        if ($icons ne '') {
+            $Str .= $icons.'&nbsp;';
+        }
+        #
+        $Str .= $links.'</font></td>';
+        #
+        if (defined($component)) {
+            $Str .= '<td align="right" bgcolor="'.$color.'">'.
+                '<font size="+1">'.&mt($component).'</font>';
+            if (defined($component_help)) {
+                $Str .= 
+                    &Apache::loncommon::help_open_topic($component_help);
+            }
+            $Str.= '</td>';
+        }
+        $Str .= '</tr></table>'."\n";
+        #
+        # Return the @Crumbs stack to what we started with
+        push(@Crumbs,$last);
+        shift(@Crumbs);
+        #
+        return $Str;
+    }
+
+    sub clear_breadcrumbs {
+        undef(@Crumbs);
+    }
+
+    sub add_breadcrumb {
+        push (@Crumbs,@_);
+    }
+
+} # End of scope for @Crumbs
+
+############################################################
+############################################################
+
+
 1;
 
 __END__