Return to Domain_Configuration_Cataloging_Courses.tex CVS log

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

- Missing end item.

    1: \label{Domain_Configuration_Cataloging_Courses}
    2: The availability of a course/community catalog, as well as the type of 
    3: catalog provided are both domain configurations.  A choice of catalog can be set  
    4: for two contexts: (a) public-facing web page (i.e., unauthenticated users),
    5: and (b) web page for authenticated users.
    6: 
    7: For each context the options are:
    8: \begin{itemize}
    9: \item Standard catalog (the only type available pre-LON-CAPA 2.11), which
   10: contains both self-cataloging courses, and manually cataloged courses. 
   11: 
   12: \item Domain-only catalog, which is the same as the standard catalog, 
   13: except no domain selector is available to switch to display course
   14: listings in other domains.
   15: 
   16: \item Code-search form, which provides a web form to search for a 
   17: course by the unique six character code, which can be set to be
   18: assigned at course creation.
   19: 
   20: \item No catalog
   21: \end{itemize}
   22: 
   23: In the standard and domain-only catalogs, self-cataloging uses the 
   24: institutional course code assigned to the course when it is first
   25: created, or when the course is modified by a Domain Coordinator via
   26: \char`\"{}Modify a course\char`\"{}. If a course has no institutional 
   27: code it will not appear in the category:
   28: Official courses (with institutional codes).
   29: 
   30: A hierarchy of categories and sub-categories can be defined which
   31: are independent of institutional course codes. These categories might
   32: be used to catalog courses in the domain to which the \char`\"{}official
   33: courses\char`\"{} designation does not apply, or they might be used
   34: to provide alternative ways of cataloging official courses.
   35: 
   36: Besides definition of the hierarchy of categories and sub-categories,
   37: the \char`\"{}cataloging of courses\char`\"{} screen provides two
   38: options to be set for the domain by a Domain Coordinator, which control:
   39: 
   40: \begin{itemize}
   41: \item Who may hide a course from the course/community catalog, if the course would
   42: ordinarily appear by virtue of having an institutional course code,
   43: or having been assigned to a custom category/sub-category.
   44: \item Who may assign a custom category/subcategory to a course
   45: \end{itemize}
   46: In both cases, the choice is between a Domain Coordinator and a Course
   47: Coordinator. For the former, hiding of courses and assignment of categories
   48: will be via \char`\"{}Modify Course\char`\"{}, while for the latter
   49: these operations will be via \char`\"{}Modify Parameters\char`\"{}
   50: (\char`\"{}Set Course Environment\char`\"{} option in sub-menu).
   51: 
   52: Definition of custom categories is by the Domain Coordinator. The
   53: \char`\"{}Cataloging of courses\char`\"{} interface allows custom
   54: categories and sub-categories to be defined and reordered. There is
   55: one category listed at the top level in the hierarchy which behaves
   56: differently to the others - the category: \char`\"{}Official courses
   57: (with institutional codes)\char`\"{}. This is the category which is
   58: used for self-cataloged courses: the option is to either display or
   59: not display.
   60: 
   61: Although sub-categories can not be defined via this interface for
   62: this \char`\"{}system\char`\"{} category (unlike the other \char`\"{}custom\char`\"{}
   63: categories), customization of two routines in localenroll.pm - \&instcode\_defaults()
   64: and \&instcode\_format() are used to automatically generate linked
   65: select boxes which will be displayed when the course/community catalog is shown
   66: to allow users to include limits to their searches for official courses.
   67: If these routines have not been customized, the catalog for official
   68: courses will display all courses with institutional codes, which have
   69: not been specifically hidden.
   70: 
   71: When \&instcode\_format() has been customized it will populate perl
   72: structures (hashes and arrays) which LON-CAPA will use to generate
   73: the Javascript code embedded in the course/community catalog page which is used
   74: in the functioning of the linked select boxes. The contents of the
   75: hashes and arrays are determined from the complete list of institutional
   76: course codes used in the domain. For example at MSU, the following
   77: linked select boxes are displayed for the official course/community catalog:
   78: Year, Semester, Department, Number.
   79: 
   80: The course/community catalog is useful in domains where Course Coordinators
   81: have opted to allow self-enrollment in their courses. In such cases,
   82: students can include a flag to only display courses allowing self
   83: enrollment when they display courses from the catalog. Course Coordinators
   84: will be advised, when enabling self-enrollment, if a course is currently
   85: unlisted in the course/community catalog (and therefore difficult for students
   86: to locate), and the action to take to rectify the reason why there
   87: is no listing, which could be because: 
   88: 
   89: \begin{itemize}
   90: \item the course is hidden 
   91: \item the course has no institutional code 
   92: \item the course has not been assigned to any custom categories 
   93: \item the course has an institutional code, but the 
   94: course/community catalog has been set to not display self-cataloged 
   95: courses.
   96: \end{itemize}