Annotation of loncom/html/adm/help/tex/Domain_Configuration_Cataloging_Courses.tex, revision 1.4
1.1 raeburn 1: \label{Domain_Configuration_Cataloging_Courses}
1.4 ! raeburn 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.
1.1 raeburn 6:
1.4 ! raeburn 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:
! 22: In the standard and domain-only catalogs, self-cataloging uses the
! 23: institutional course code assigned to the course when it is first
! 24: created, or when the course is modified by a Domain Coordinator via
! 25: \char`\"{}Modify a course\char`\"{}. If a course has no institutional
! 26: code it will not appear in the category:
1.1 raeburn 27: Official courses (with institutional codes).
28:
29: A hierarchy of categories and sub-categories can be defined which
30: are independent of institutional course codes. These categories might
31: be used to catalog courses in the domain to which the \char`\"{}official
32: courses\char`\"{} designation does not apply, or they might be used
33: to provide alternative ways of cataloging official courses.
34:
35: Besides definition of the hierarchy of categories and sub-categories,
36: the \char`\"{}cataloging of courses\char`\"{} screen provides two
37: options to be set for the domain by a Domain Coordinator, which control:
38:
39: \begin{itemize}
1.2 bisitz 40: \item Who may hide a course from the course/community catalog, if the course would
1.1 raeburn 41: ordinarily appear by virtue of having an institutional course code,
42: or having been assigned to a custom category/sub-category.
43: \item Who may assign a custom category/subcategory to a course
44: \end{itemize}
45: In both cases, the choice is between a Domain Coordinator and a Course
46: Coordinator. For the former, hiding of courses and assignment of categories
47: will be via \char`\"{}Modify Course\char`\"{}, while for the latter
48: these operations will be via \char`\"{}Modify Parameters\char`\"{}
49: (\char`\"{}Set Course Environment\char`\"{} option in sub-menu).
50:
51: Definition of custom categories is by the Domain Coordinator. The
52: \char`\"{}Cataloging of courses\char`\"{} interface allows custom
53: categories and sub-categories to be defined and reordered. There is
54: one category listed at the top level in the hierarchy which behaves
55: differently to the others - the category: \char`\"{}Official courses
56: (with institutional codes)\char`\"{}. This is the category which is
57: used for self-cataloged courses: the option is to either display or
58: not display.
59:
60: Although sub-categories can not be defined via this interface for
61: this \char`\"{}system\char`\"{} category (unlike the other \char`\"{}custom\char`\"{}
62: categories), customization of two routines in localenroll.pm - \&instcode\_defaults()
63: and \&instcode\_format() are used to automatically generate linked
1.2 bisitz 64: select boxes which will be displayed when the course/community catalog is shown
1.1 raeburn 65: to allow users to include limits to their searches for official courses.
66: If these routines have not been customized, the catalog for official
67: courses will display all courses with institutional codes, which have
68: not been specifically hidden.
69:
70: When \&instcode\_format() has been customized it will populate perl
71: structures (hashes and arrays) which LON-CAPA will use to generate
1.2 bisitz 72: the Javascript code embedded in the course/community catalog page which is used
1.1 raeburn 73: in the functioning of the linked select boxes. The contents of the
74: hashes and arrays are determined from the complete list of institutional
75: course codes used in the domain. For example at MSU, the following
1.2 bisitz 76: linked select boxes are displayed for the official course/community catalog:
1.1 raeburn 77: Year, Semester, Department, Number.
78:
1.2 bisitz 79: The course/community catalog is useful in domains where Course Coordinators
1.1 raeburn 80: have opted to allow self-enrollment in their courses. In such cases,
81: students can include a flag to only display courses allowing self
82: enrollment when they display courses from the catalog. Course Coordinators
1.2 bisitz 83: will be advised, when enabling self-enrollment, if a course is currently
84: unlisted in the course/community catalog (and therefore difficult for students
1.1 raeburn 85: to locate), and the action to take to rectify the reason why there
86: is no listing, which could be because:
87:
88: \begin{itemize}
89: \item the course is hidden
90: \item the course has no institutional code
91: \item the course has not been assigned to any custom categories
1.3 raeburn 92: \item the course has an institutional code, but the
93: course/community catalog has been set to not display self-cataloged
94: courses.
1.1 raeburn 95: \end{itemize}
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>