Annotation of loncom/html/adm/helper/course.initialization.helper, revision 1.2

1.2     ! bowersj2    1: <helper title="Course Initialization Helper" requiredpriv='opa'>
        !             2: 
        !             3:   <exec>
        !             4:     $helper->{DATA}->{DOM} = $ENV{'course.'.$ENV{'request.course.id'}.'.domain'};
        !             5:     $helper->{DATA}->{CRS} = $ENV{'course.'.$ENV{'request.course.id'}.'.num'};
        !             6: 
        !             7:     $helper->{DATA}->{GETVAL} = sub {
        !             8:         my @resultlist = &Apache::lonnet::get('environment', [shift()], 
        !             9:                                               $helper->{DATA}->{DOM},
        !            10:                                               $helper->{DATA}->{CRS}); 
        !            11:         return $resultlist[1]; };
        !            12:     $helper->{DATA}->{SETVAL} = sub {
        !            13:         my $name = shift;
        !            14:         my $val = shift;
        !            15:         if (&{$helper->{DATA}->{GETVAL}}($name) ne $val) {
        !            16:             &Apache::lonnet::put('environment', {$name=>$val}, 
        !            17:                                  $helper->{DATA}->{DOM},
        !            18:                                  $helper->{DATA}->{CRS}); 
        !            19:             return 1;
        !            20:         } else {
        !            21:             return 0;
        !            22:         }
        !            23:     }
        !            24:   </exec>
1.1       bowersj2   25: 
                     26:   <state name="START" title="Welcome to Your New LON-CAPA Course">
                     27:     <message nextstate="FORBID_DISCUSSION">
1.2     ! bowersj2   28:          This Helper will help you set up your new LON-CAPA course and choose
1.1       bowersj2   29:          which LON-CAPA features will be active in your course. You can 
1.2     ! bowersj2   30:          re-visit it later to change settings in your course.
1.1       bowersj2   31: 
                     32:       <p><b>FIXME:</b> Figure out some way to detect whether this has been
                     33:          run, and change that paragraph appropriatly.</p>
                     34: 
                     35:       <p>If you have previous experience with coordinating LON-CAPA courses and
1.2     ! bowersj2   36:          prefer not to use the Helper,
        !            37:          <a href="/adm/navmaps">click here</a> to leave this Helper.</p>
1.1       bowersj2   38: 
1.2     ! bowersj2   39:       <p>All settings which you can change with this Helper can also be changed while the
1.1       bowersj2   40:          course is running by going to the PARM screen and clicking on the &quot;Set
                     41:          course environment&quot; button.</p>
                     42: 
                     43:       <p>If you do not have experience coordinating LON-CAPA courses, or if you
1.2     ! bowersj2   44:          prefer the Helper interface, please click <nobr><b>Next -&gt;</b></nobr>.</p>
1.1       bowersj2   45:       </message>
                     46:     </state>
                     47: 
                     48:   <state name="FORBID_DISCUSSION" title="Discussion Participation">
                     49:     <message nextstate="DISCUSSION_HTML">
1.2     ! bowersj2   50:          LON-CAPA hosts discussions on all resources in a course. By default,
        !            51:          all users are allowed to participate in these discussions.
1.1       bowersj2   52: 
                     53:       <p>For more information about discussion and the abilities available
                     54:          to you as a course coordinator, such as banning abusive users or
                     55:          hiding discussion postings, please see <b>link</b>.</p>
                     56: 
                     57:       <p>If you do not wish certain classes of users to be able to use the 
1.2     ! bowersj2   58:          discussion features, select those classes below. Note your class
        !            59:          may not have all of these roles; you may safely ignore roles you
        !            60:          do not intend to use. (For instance, &quot;Exam Proctor&quot; is
        !            61:          generally useful only for large courses.)</p>
1.1       bowersj2   62: 
                     63:       <p><b>Question: Does inability to use discussion mean they simply can't
                     64:             post, or that they can't see the discussion at all?</b></p>
                     65:       </message>
1.2     ! bowersj2   66:     <choices variable="BANNED_DISCUSSION_ROLES" multichoice="1" allowempty='1'>
1.1       bowersj2   67:       <choice computer="st"><b>Students</b> - students will not be able to participate in discussions</choice>
                     68:       <choice computer="ta"><b>Teaching Assistants</b> - teaching assistants will not be able to participate in discussions</choice>
                     69:       <choice computer="in"><b>Instructor</b> - instructors will not be able to participate in discussions</choice>
1.2     ! bowersj2   70:       <choice computer="ep"><b>Exam Proctor</b> - exam proctors will not be able to participate in discussions</choice>
        !            71:       <defaultvalue>
        !            72:         my $denied = &{$helper->{DATA}->{GETVAL}}('pch.roles.denied');
        !            73:         $denied =~ s/,/\|\|\|/g;
        !            74:         return $denied;
        !            75:       </defaultvalue>
        !            76:       <finalcode>
        !            77:         my $denied = $element->getValue();
        !            78:         $denied =~ s/\|\|\|/,/g;
        !            79:         if (&{$helper->{DATA}->{SETVAL}}('pch.roles.denied', $denied)) {
        !            80:             $denied =~ s/st/ students/;
        !            81:             $denied =~ s/in/ instructors/;
        !            82:             $denied =~ s/ta/ teaching assistants/;
        !            83:             $denied =~ s/ep/ exam proctors/;
        !            84:             if ($denied =~ /^[^,]*,[^,]*$/) { # only one comma
        !            85:                 $denied =~ s/,/ and/g;
        !            86:             } else { # add "and" to last comma
        !            87:                 $denied =~ s/,([^,]*)$/, and\1/;
        !            88:             }
        !            89:             if ($denied) {
        !            90:                 $denied = substr($denied, 1) . ' not allowed to participate in discussion.';
        !            91:                 $denied = ucfirst($denied);
        !            92:             } else {
        !            93:                 $denied = 'Everyone can participate in discussion.';
        !            94:             }
        !            95:             return $denied;
        !            96:         } else {
        !            97:             return '';
        !            98:         }
        !            99:       </finalcode>
1.1       bowersj2  100:       </choices>
                    101:     </state>
                    102: 
                    103:   <state name="DISCUSSION_HTML" title="HTML in Discussions">
1.2     ! bowersj2  104:     <message nextstate="FINAL">
1.1       bowersj2  105:       <p>If you like, limited HTML can be allowed in the course discussions.</p>
                    106:       </message>
                    107:     <choices variable="HTML_ALLOWED">
                    108:       <choice computer=""><b>HTML banned</b>: HTML will not be allowed in discussion postings.</choice>
                    109:       <choice computer="yes"><b>HTML allowed</b>: Discussion participants can use limited HTML in their postings.</choice>
1.2     ! bowersj2  110:       <finalcode>return 'Choices finalcode.';</finalcode>
1.1       bowersj2  111:       </choices>
1.2     ! bowersj2  112:     </state>
        !           113: 
        !           114:   
        !           115: 
        !           116:   <state name="FINAL" title="Completed">
        !           117:     <message>Your course is now set up.</message>
        !           118:     <final />
1.1       bowersj2  119:     </state>
                    120:   </helper>

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