Annotation of loncom/html/adm/help/tex/Domain_Configuration_Course_Defaults.tex, revision 1.17

1.1       raeburn     1: \label{Domain_Configuration_Course_Defaults}
1.2       raeburn     2: Starting with LON-CAPA 2.10, a Domain Coordinator can configure default 
                      3: settings for courses in the domain. Defaults are of two types:
1.1       raeburn     4: \begin{itemize}
1.6       raeburn     5: \item \textbf{Defaults that can be overridden in an individual course by a Course Coordinator} 
1.4       raeburn     6: 
1.16      raeburn     7: Currently, there are six domain defaults of this type (the majority of which can be overridden
1.6       raeburn     8: using Settings $>$ Course Settings $>$ Display with ``Display of resources'' checked).
1.4       raeburn     9: 
                     10: \begin{itemize}
1.8       raeburn    11: \item Default method to display mathematics expressions included between $<$m$>$ and $<$/m$>$ tags.
                     12: 
1.9       raeburn    13: Starting with LON-CAPA 2.11.3 the default renderer used to display math can be set to one of: 
1.8       raeburn    14: \textit{MathJax}, \textit{Convert to Images (mimetex)}, or \textit{TeX to HTML (tth)}.
                     15: The domain default in effect for a user will be for the domain of the user's current role.
                     16: However, if a user has selected a renderer from the \textit{Math display settings} in 
                     17: User Preferences that will take precedence over the domain default.
                     18: Furthermore, if the course setting: \textit{Force use of a specific math rendering engine}
                     19: has been set, that will take precedence (in course context) over both the user preference 
                     20: and the domain default.  If no default renderer has been set, MathJax is used in 
1.10      raeburn    21: LON-CAPA 2.12 and later, whereas TeX to HTML (tth) is used in LON-CAPA 2.11 and earlier.
1.8       raeburn    22:   
1.16      raeburn    23: \item Course/Community users can create/upload PDF forms
                     24: 
                     25: Starting with LON-CAPA 2.12 the ``Grading and Statistics'' panel in the Main Menu displayed 
                     26: to students can include ``Upload a PDF Form with filled Form Fields'' to support 
                     27: automated grading of completed PDF forms. Each PDF form itself will have been generated 
                     28: by a student using LON-CAPA's print utility -- with the ``with Form Fields'' selected in 
                     29: the ``PDF Form Fields'' drop-down list in the Layout Options box on the first page of the 
                     30: printout generation dialog.
                     31: 
                     32: Setting ``Yes'' in the domain configuration for ``users can create/upload PDF forms''
                     33: sets use of PDF forms as the default for all courses and communities in the domain.
                     34: This can be overriden in specific courses by a Course Coordinator using 
                     35: Settings $>$ Course Settings $>$ Display with ``Printout generation'' checked,
                     36: and selecting an option for ``Users can print problems as PDF forms and upload later 
                     37: for grading'' other than ``use domain default''.
                     38: 
1.4       raeburn    39: \item Student formula entry uses inline preview, not DragMath pop-up
                     40: 
                     41: For problems that require a formula input via a textbox, the default is to
                     42: show the math expression in a previewer below the textbox, as the student types.
                     43: The alternative is to use the older (Java-based) DragMath pop-up which allows 
                     44: the student to compose the expression in a WYSIWYG-style editor in a pop-up window
                     45: and then save it to the textbox in the main window using a ``Save and Close'' button.
                     46: 
                     47: \item Molecule editor uses JSME (HTML5) in place of JME (Java)
                     48: 
                     49: For problems that require the student to ``draw'' an organic structure using a
                     50: molecule editor, the default is to use the HTML5 version (JSME).  The alternative
                     51: is to use the older (Java-based) JME editor.
                     52: 
1.11      raeburn    53: \item Chemical reaction response uses inline previewer in place of pop-up
                     54: 
                     55: For problems that require the student to submit a chemical reaction, the default is to
                     56: use an inline previewer which displays preview of the reaction with appropriately
                     57: formatted stoichiometry and subscripts and superscripts as the answer is typed in
                     58: a standard textbox.  The alternative is to use the older pop-up window to type the
                     59: answer and then to use separate buttons to preview a formatted version, and to save it
                     60: to the main window.
                     61: 
1.5       raeburn    62: \item Course requesters who may clone a course (besides course's owner and coordinators)
                     63: 
                     64: This can be set to no additional requesters, or to any course requester in the domain, or
                     65: if categories have been defined in the domain for institutional codes for official courses
1.6       raeburn    66: (in localenroll::instcode\_defaults), to categories which must match in new and cloned 
1.5       raeburn    67: courses (e.g., department and number).
                     68: 
1.4       raeburn    69: \end{itemize}
                     70: 
1.5       raeburn    71: \item \textbf{Defaults that can be overridden in an individual course by a Domain
1.6       raeburn    72: Coordinator}
1.1       raeburn    73: 
1.17    ! raeburn    74: Currently, there are eleven domain defaults of this type (which can be overridden
1.6       raeburn    75: via the ``View or modify a course or community'' interface). 
1.2       raeburn    76: 
                     77: \begin{itemize}
                     78: \item responder count - number of responses needed before submissions made to 
                     79: anonymous surveys (with no identifying information) are viewable by Course personnel.
                     80: \item default course quotas - domain default for quotas (MB) for official, unofficial,
1.13      raeburn    81: community, and textbook course types for:
1.14      raeburn    82: \begin{enumerate}
1.13      raeburn    83: \item content uploaded directly to the course
                     84: \item content uploaded to portfolio space(s) for all group(s) in the course
1.14      raeburn    85: \end{enumerate}
1.2       raeburn    86: \item default course credits - whether credits may be specified for courses (Yes/No),
1.3       raeburn    87:  if yes: default values for number of credits for official, unofficial and textbook courses.
1.4       raeburn    88: \item submit button behavior post-submission
                     89: 
                     90: The default is for the ``Submit Answer'' button in the current page to be disabled for 60s following
                     91: answer submission.  After processing a student's answer a new page is displayed. The setting 
                     92: to disable a  button, (with or without a timeout), applies to the button in the old page in
                     93: the time period before the new page is loaded by the browser.
1.7       raeburn    94: 
                     95: \item lifetime of temporary tables (course's homeserver)
                     96: 
                     97: The default lifetime (since last update) for ``temporary'' MySQL tables 
                     98: containing student performance data is 172800s (i.e., 2 days). A different default
                     99: lifetime can be set by course type, which will apply to MySQL tables on the course's 
                    100: homeserver only.
                    101: 
                    102: A reason to do this might be where a domain has created a custom script to export
                    103: a course's grade data, by running SQL queries against the temporary tables.
                    104: 
                    105: Note: student performance data are stored permanently in GDBM files; the temporary MySQL
                    106: tables are simply used to speed up display when a Course Coordinator uses the 
                    107: Assessment Chart or Statistics functions in a course.
                    108: 
1.15      raeburn   109: \item Username from LTI-mediated launch accepted without re-authentication
1.12      raeburn   110: 
                    111: For deep-link access to a specific folder (or resource) in LON-CAPA, mediated by LTI launch from a different system, the signed payload included on launch can include the username of the authenticated user who followed a link in another system.  Whether such a username will be accepted, and a session launched for that username in LON-CAPA, or whether the user will be prompted to log-in to LON-CAPA in order to access the deep-linked resource(s) depends on the ``Use identity'' setting in effect for the current course.  If the domain default is set to ``No'', then a Course Coordinator will not be given the option to set ``Use identity'' when configuring Link Protector(s) in a course, and all users will need to log-in to LON-CAPA to complete the launch process.
                    112: 
1.13      raeburn   113: \item External Tool definition and configuration in domain and/or course
                    114: 
                    115: External Tools can be created in a domain by adding definitions to the ``Provider panel'' in the domain configuration for ``External Tools (LTI)'' available via ``Main Menu'' $>$ ``Set domain configuration''.
                    116: 
                    117: The Course/Community default settings in a domain's configuration will determine whether external tools defined in the domain are available by default, for use in each of the available types of course container. A second default setting determines whether, by default, external tool definitions may be created by Course Coordinators in each of the course container types.
                    118: 
                    119: \item Create standard LON-CAPA problems within a course/community
                    120: 
                    121: The small tabs on the right side of the Course Editor for the Main Content area include an ``Assessment'' tab.  One of the functions which may be available within ``Assessments'' is ``Standard Problem'', which allows creation of a new LON-CAPA problem for incorporation in a course.  Unlike the ``Simple Problem'' also available from the same tab, a ``standard'' problem can feature the full functionality of the LON-CAPA Assessment engine.  The Standard Problem link/icon will be listed if the current user has a current author or co-author role, or if the user has neither, will still be listed if the current course is permitted to access its own Course Authoring Space.
                    122: 
                    123: The Course/Community defaults in the domain include checkboxes for each of the different course container types, which when checked set the ability to select ``Course Resource'' as the location for a new standard problem being created. Resources created in that location are not listed when browsing or searching the shared content repository, and may only be imported into the course in which they were created, by using the ``Import from Course Resources'' icon/link.
                    124: 
1.17    ! raeburn   125: Neither the ``Import from Course Resources'' icon/link nor the ``Course Resource'' as destination for ``Standard Problem'' will be available if the Course/Community default for the course's/community's container type has been left unchecked, and there is no course-specific override of the domain default.
        !           126: 
        !           127: \item Available editors for course/community resources
        !           128: 
        !           129: For standard LON-CAPA problems created within Course Authoring Space the possible editors are: Standard editor (Edit), Text editor (EditXML), and the Daxe editor (Daxe). For web pages created within a Course Authoring Space, or created within a course folder using the Course Editor, the standard editor (Edit) will always be available, but the Daxe editor will only be available if that editor is also available for standard LON-CAPA problems.
1.13      raeburn   130: 
1.4       raeburn   131: \end{itemize}
                    132: 
1.3       raeburn   133: \end{itemize}
1.4       raeburn   134: 

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