Return to Domain_Configuration_Course_Defaults.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

- Available editors in Course Authoring Space, or when editing an html file
  created in a course folder using the Course Editor is a domain default,
  which can be overridden in specific course(s) by a Domain Coordinator.

\label{Domain_Configuration_Course_Defaults}
Starting with LON-CAPA 2.10, a Domain Coordinator can configure default 
settings for courses in the domain. Defaults are of two types:
\begin{itemize}
\item \textbf{Defaults that can be overridden in an individual course by a Course Coordinator} 

Currently, there are six domain defaults of this type (the majority of which can be overridden
using Settings $>$ Course Settings $>$ Display with ``Display of resources'' checked).

\begin{itemize}
\item Default method to display mathematics expressions included between $<$m$>$ and $<$/m$>$ tags.

Starting with LON-CAPA 2.11.3 the default renderer used to display math can be set to one of: 
\textit{MathJax}, \textit{Convert to Images (mimetex)}, or \textit{TeX to HTML (tth)}.
The domain default in effect for a user will be for the domain of the user's current role.
However, if a user has selected a renderer from the \textit{Math display settings} in 
User Preferences that will take precedence over the domain default.
Furthermore, if the course setting: \textit{Force use of a specific math rendering engine}
has been set, that will take precedence (in course context) over both the user preference 
and the domain default.  If no default renderer has been set, MathJax is used in 
LON-CAPA 2.12 and later, whereas TeX to HTML (tth) is used in LON-CAPA 2.11 and earlier.
  
\item Course/Community users can create/upload PDF forms

Starting with LON-CAPA 2.12 the ``Grading and Statistics'' panel in the Main Menu displayed 
to students can include ``Upload a PDF Form with filled Form Fields'' to support 
automated grading of completed PDF forms. Each PDF form itself will have been generated 
by a student using LON-CAPA's print utility -- with the ``with Form Fields'' selected in 
the ``PDF Form Fields'' drop-down list in the Layout Options box on the first page of the 
printout generation dialog.

Setting ``Yes'' in the domain configuration for ``users can create/upload PDF forms''
sets use of PDF forms as the default for all courses and communities in the domain.
This can be overriden in specific courses by a Course Coordinator using 
Settings $>$ Course Settings $>$ Display with ``Printout generation'' checked,
and selecting an option for ``Users can print problems as PDF forms and upload later 
for grading'' other than ``use domain default''.

\item Student formula entry uses inline preview, not DragMath pop-up

For problems that require a formula input via a textbox, the default is to
show the math expression in a previewer below the textbox, as the student types.
The alternative is to use the older (Java-based) DragMath pop-up which allows 
the student to compose the expression in a WYSIWYG-style editor in a pop-up window
and then save it to the textbox in the main window using a ``Save and Close'' button.

\item Molecule editor uses JSME (HTML5) in place of JME (Java)

For problems that require the student to ``draw'' an organic structure using a
molecule editor, the default is to use the HTML5 version (JSME).  The alternative
is to use the older (Java-based) JME editor.

\item Chemical reaction response uses inline previewer in place of pop-up

For problems that require the student to submit a chemical reaction, the default is to
use an inline previewer which displays preview of the reaction with appropriately
formatted stoichiometry and subscripts and superscripts as the answer is typed in
a standard textbox.  The alternative is to use the older pop-up window to type the
answer and then to use separate buttons to preview a formatted version, and to save it
to the main window.

\item Course requesters who may clone a course (besides course's owner and coordinators)

This can be set to no additional requesters, or to any course requester in the domain, or
if categories have been defined in the domain for institutional codes for official courses
(in localenroll::instcode\_defaults), to categories which must match in new and cloned 
courses (e.g., department and number).

\end{itemize}

\item \textbf{Defaults that can be overridden in an individual course by a Domain
Coordinator}

Currently, there are eleven domain defaults of this type (which can be overridden
via the ``View or modify a course or community'' interface). 

\begin{itemize}
\item responder count - number of responses needed before submissions made to 
anonymous surveys (with no identifying information) are viewable by Course personnel.
\item default course quotas - domain default for quotas (MB) for official, unofficial,
community, and textbook course types for:
\begin{enumerate}
\item content uploaded directly to the course
\item content uploaded to portfolio space(s) for all group(s) in the course
\end{enumerate}
\item default course credits - whether credits may be specified for courses (Yes/No),
 if yes: default values for number of credits for official, unofficial and textbook courses.
\item submit button behavior post-submission

The default is for the ``Submit Answer'' button in the current page to be disabled for 60s following
answer submission.  After processing a student's answer a new page is displayed. The setting 
to disable a  button, (with or without a timeout), applies to the button in the old page in
the time period before the new page is loaded by the browser.

\item lifetime of temporary tables (course's homeserver)

The default lifetime (since last update) for ``temporary'' MySQL tables 
containing student performance data is 172800s (i.e., 2 days). A different default
lifetime can be set by course type, which will apply to MySQL tables on the course's 
homeserver only.

A reason to do this might be where a domain has created a custom script to export
a course's grade data, by running SQL queries against the temporary tables.

Note: student performance data are stored permanently in GDBM files; the temporary MySQL
tables are simply used to speed up display when a Course Coordinator uses the 
Assessment Chart or Statistics functions in a course.

\item Username from LTI-mediated launch accepted without re-authentication

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.

\item External Tool definition and configuration in domain and/or course

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''.

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.

\item Create standard LON-CAPA problems within a course/community

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.

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.

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.

\item Available editors for course/community resources

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.

\end{itemize}

\end{itemize}