--- loncom/html/adm/helper/course.initialization.helper 2003/06/05 13:01:32 1.5 +++ loncom/html/adm/helper/course.initialization.helper 2009/02/25 16:39:59 1.25 @@ -1,17 +1,18 @@ - my $courseid = $ENV{'request.course.id'}; - my $crsdom = $ENV{'course.'.$courseid.'.domain'}; - my $crsnum = $ENV{'course.'.$courseid.'.num'}; + my $courseid = $env{'request.course.id'}; + my $crsdom = $env{'course.'.$courseid.'.domain'}; + my $crsnum = $env{'course.'.$courseid.'.num'}; $helper->{DATA}->{DOM} = $crsdom; $helper->{DATA}->{CRS} = $crsnum; - $helper->{DATA}->{FIRST_RUN} = $ENV{'course.'.$crsnum. + $helper->{DATA}->{FIRST_RUN} = $env{'course.'.$crsnum. '.course.intialization.not.run'}; # Delete the 'course.initialization.not.run' course environment Apache::lonnet::put('environment', {'course.helper.not.run' => 0}, $crsdom, $crsnum); + Apache::lonnet::coursedescription($env{'request.course.id'}); $helper->{DATA}->{GETVAL} = sub { my @resultlist = &Apache::lonnet::get('environment', [shift()], @@ -24,7 +25,9 @@ if (&{$helper->{DATA}->{GETVAL}}($name) ne $val) { &Apache::lonnet::put('environment', {$name=>$val}, $helper->{DATA}->{DOM}, - $helper->{DATA}->{CRS}); + $helper->{DATA}->{CRS}); + # Try to fix bug 1757 + Apache::lonnet::coursedescription($env{'request.course.id'}); return 1; } else { return 0; @@ -34,34 +37,31 @@ - return $helper->{DATA}->{FIRST_RUN} ? - 'This Helper will help you set up your new LON-CAPA course and choose '. - 'which LON-CAPA features will be active in your new course. You can '. + return $helper->{DATA}->{FIRST_RUN} ? + 'This Helper will set up your new LON-CAPA course and choose '. + 'which features will be active. You can '. 're-visit it later to change settings in your course.' . '

If you have previous experience with coordinating LON-CAPA courses and '. - 'prefer not to use the helper, click here to leave '. - 'this helper.' + 'prefer not to use the helper, click here to leave.' : - 'This helper will help you set up your LON-CAPA course and choose ' . - 'which LON-CAPA features will be active in your course.'; + &mt('This helper will set up your LON-CAPA course and choose which features will be active.');

All settings which you can change with this Helper can also be changed by going to the PARM screen and clicking on the "Set course environment" button.

-

If you do not have experience coordinating LON-CAPA courses, or if you +

If you do not have experience coordinating LON-CAPA courses or if you prefer the Helper interface, please click Next ->.

 - - - The "Course Description" is the name of the course that will be - seen by the students. This should have been set up correctly when the - course was created, but please confirm that it is correct, or change it - if neccessary. Hit a "Next ->" to continue.
+ + + The "Course Title" is the name of the course that will be + seen by the students. You may now modify the description and hit + "Next ->" to continue.
 @@ -76,29 +76,67 @@ + + +

LON-CAPA has chat room functionality. This course will receive + its own chat room. You may deny students, TAs, or instructors + the right to access the chat room.

+ + + Students - students will not be able to use or view the chat room. + Teaching Assistants - teaching assistants will not be able use or view the chat room + Instructor - instructors will not be able to use or view the chat room + + my $denied = &{$helper->{DATA}->{GETVAL}}('plc.roles.denied'); + $denied =~ s/,/\|\|\|/g; + return $denied; + + + my $denied = $element->getValue(); + $denied =~ s/\|\|\|/,/g; + if (&{$helper->{DATA}->{SETVAL}}('plc.roles.denied', $denied)) { + $denied =~ s/st/ students/; + $denied =~ s/in/ instructors/; + $denied =~ s/ta/ teaching assistants/; + $denied =~ s/ep/ exam proctors/; + if ($denied =~ /^[^,]*,[^,]*$/) { # only one comma + $denied =~ s/,/ and/g; + } else { # add "and" to last comma + $denied =~ s/,([^,]*)$/, and\1/; + } + if ($denied) { + $denied = substr($denied, 1) . ' not allowed to participate in chat room.'; + $denied = ucfirst($denied); + } else { + $denied = 'Everyone can participate in chat room.'; + } + return $denied; + } else { + return ''; + } + + + + LON-CAPA hosts discussions on all resources in a course. By default, all users are allowed to participate in these discussions. -

For more information about discussion and the abilities available - to you as a course coordinator, such as banning abusive users or - hiding discussion postings, please see link.

- -

If you do not wish certain classes of users to be able to use the - discussion features, select those classes below. Note your class +

If you do not wish certain types of users to be able to use the + discussion features, select those types below. Note your class may not have all of these roles; you may safely ignore roles you do not intend to use. (For instance, "Exam Proctor" is generally useful only for large courses.)

-

Question: Does inability to use discussion mean they simply can't - post, or that they can't see the discussion at all?

+

Types of users not allowed to participate in discussion can + still view any discussion that other users post.

+ Students - students will not be able to participate in discussions Teaching Assistants - teaching assistants will not be able to participate in discussions Instructor - instructors will not be able to participate in discussions - Exam Proctor - exam proctors will not be able to participate in discussions my $denied = &{$helper->{DATA}->{GETVAL}}('pch.roles.denied'); $denied =~ s/,/\|\|\|/g; @@ -133,7 +171,7 @@ -

If you like, limited HTML can be allowed in the course discussions.

+

HTML can be allowed or banned inside of course discussion.

 HTML banned: HTML will not be allowed in discussion postings. @@ -154,21 +192,15 @@ - - People in the course can provide feedback about the resources used in - the course by using the FDBK button while viewing a resource. If - the user labels the feedback as a "question about course content", - it is sent to the course coordinator of that course. - -

If you'd like that feedback to be sent to someone else, such as a - different instructor, please enter their LON-CAPA address below, in the + + Course members can provide feedback about the course. You can choose + who will receive the feedback, such as a different instructor or a + TA. Please enter their LON-CAPA address below, in the form user:domain, where "user" and "domain" - are both the LON-CAPA username and LON-CAPA domain, not an email + are both the LON-CAPA username and LON-CAPA domain, not an e-mail address.

 - return '

Your current LON-CAPA domain is "' - . $helper->{DATA}->{DOM} . - '".

'; + return &mt('

Your current LON-CAPA domain is "[_1]".

',"$helper->{DATA}->{DOM}"); @@ -182,12 +214,12 @@ -

Advanced Functionality: If you'd like to redirect different - section's feedback to different people, you can enter it as follows:

+

Advanced: You can send the feedback from different sections + to different people, by doing the following:

-
  • Seperate each entry with a comma.
    • +
    • Separate each entry with a comma.
    • To send feedback to a certain address for different sections, - append the section name or names (seperated by semi-colons) + append the section name or names (separated by semi-colons) in a parenthesized list after the user:domain.

    For example,

    @@ -201,14 +233,98 @@ + + + Existing courses can be cloned when creating new courses.
    Cloning will copy the course structure, contents, and most parameters (automatically advancing any date parameters by six months).

    + Names of owners of other courses permitted to clone this course:
    +     + + + return &{$helper->{DATA}->{GETVAL}}('cloners'); + + + my ($output,@cloners,%disallowed); + my $match_dom = $LONCAPA::match_domain; + my $match_uname = $LONCAPA::match_username; + if ($val =~ /,/) { + @cloners = split(/,/,$val); + } else { + $cloners[0] = $val; + } + foreach my $item (@cloners) { + next if ($item =~ /^\s*$/); + next if ($item eq '*'); + + my ($clname,$cldom) = split(/:/,$item); + if ($clname eq '*') { + if ($cldom =~ /^$match_dom$/) { + if (!&Apache::lonnet::domain($cldom)) { + $disallowed{'domain'} .= $item.','; + } + } else { + $disallowed{'format'} .= $item.','; + } + } elsif ($item !~/^($match_uname)\:($match_dom)$/) { + $disallowed{'format'} .= $item.','; + } else { + if (!&Apache::lonnet::domain($cldom)) { + $disallowed{'domain'} .= $item.','; + } elsif (&Apache::lonnet::homeserver($clname,$cldom) eq 'no_host') { + $disallowed{'newuser'} .= $item.','; + } + } + } + foreach my $key (keys(%disallowed)) { + $disallowed{$key} =~ s/,$//; + } + if (keys(%disallowed) > 0) { + $output.= 'Your input contained the following errors:
      '; + if (defined($disallowed{'format'})) { + $output .= '
    • Invalid format: '. + ''.$disallowed{'format'}.'
      • '; + } + if (defined($disallowed{'domain'})) { + $output .= '
    • Domain(s) do(es) not exist: '. + ''.$disallowed{'domain'}.'
      • '; + } + if (defined($disallowed{'newuser'})) { + $output .= '
    • LON-CAPA user(s) do(es) not exist: '. + ''.$disallowed{'newuser'}.'
      • '; + } + $output .= '
    '; + } + return $output; +     + + if (&{$helper->{DATA}->{SETVAL}}('cloners', $element->getValue())) { + + + return 'Users allowed to clone course updated to ' . $element->getValue() . + '.'; + } + +     + +
    (Course Coordinators automatically have the right to clone their own courses.) +
      +
    • Format: user:domain, where "user" and "domain" + are the LON-CAPA username and domain of the user.
    • Separate different users with a comma.
    • Use *:domain to allow course to be cloned by any course owner in the specified domain.
    • Use * to allow unrestricted cloning by all course owners in all domains.
    +     +     Your course is now set up. Please select the Finish Course Initialization button to re-intialize the course with your chosen - settings. You will be taken to the NAV screen for your course. + settings.

    Remember that all of these settings can be modified in the PARMS screen, by pushing the Course Environment button.

     + + $env{'course.'.$env{'request.course.id'}.'.clonedfrom'} + After you select Finish Course Initialization, + you will be taken to the Parameter Overview screen to + update the dates for this cloned course. +