help logoLON-CAPA Help


The availability of a course/community catalog, as well as the type of catalog provided are both domain configurations. A choice of catalog can be set for two contexts: (a) public-facing web page (i.e., unauthenticated users), and (b) web page for authenticated users.

For each context the options are:

In the standard and domain-only catalogs, self-cataloging uses the institutional course code assigned to the course when it is first created, or when the course is modified by a Domain Coordinator via "Modify a course". If a course has no institutional code it will not appear in the category: Official courses (with institutional codes).

A hierarchy of categories and sub-categories can be defined which are independent of institutional course codes. These categories might be used to catalog courses in the domain to which the "official courses" designation does not apply, or they might be used to provide alternative ways of cataloging official courses.

Besides definition of the hierarchy of categories and sub-categories, the "cataloging of courses" screen provides two options to be set for the domain by a Domain Coordinator, which control:

In both cases, the choice is between a Domain Coordinator and a Course Coordinator. For the former, hiding of courses and assignment of categories will be via "Modify Course", while for the latter these operations will be via "Modify Parameters" ("Set Course Environment" option in sub-menu).

Definition of custom categories is by the Domain Coordinator. The "Cataloging of courses" interface allows custom categories and sub-categories to be defined and reordered. There is one category listed at the top level in the hierarchy which behaves differently to the others - the category: "Official courses (with institutional codes)". This is the category which is used for self-cataloged courses: the option is to either display or not display.

Although sub-categories can not be defined via this interface for this "system" category (unlike the other "custom" categories), customization of two routines in localenroll.pm - &instcode_defaults() and &instcode_format() are used to automatically generate linked select boxes which will be displayed when the course/community catalog is shown to allow users to include limits to their searches for official courses. If these routines have not been customized, the catalog for official courses will display all courses with institutional codes, which have not been specifically hidden.

When &instcode_format() has been customized it will populate perl structures (hashes and arrays) which LON-CAPA will use to generate the Javascript code embedded in the course/community catalog page which is used in the functioning of the linked select boxes. The contents of the hashes and arrays are determined from the complete list of institutional course codes used in the domain. For example at MSU, the following linked select boxes are displayed for the official course/community catalog: Year, Semester, Department, Number.

The course/community catalog is useful in domains where Course Coordinators have opted to allow self-enrollment in their courses. In such cases, students can include a flag to only display courses allowing self enrollment when they display courses from the catalog. Course Coordinators will be advised, when enabling self-enrollment, if a course is currently unlisted in the course/community catalog (and therefore difficult for students to locate), and the action to take to rectify the reason why there is no listing, which could be because: