Course

With Princeton Site Builder you can import and add Princeton courses to your website.

Enable the Courses Module

The Courses module must be enabled before you can import courses.

Importing Courses

Unlike most other content types, courses are not manually added to your site. Instead, they are imported. This ensures that the course data displayed throughout the University remains consistent and accurate for each course.

    After enabling and configuring your course module, a new Courses tab will display under the Content tab in the Content Dashboard (Manage » Content). Visit this page and click the "Import courses" button.

    courses dashboard

    Importing Courses by Subject

    For departments that are associated with one or a few subjects, the easiest way to display them on your site is to use the "Import Courses by Subject" form to import all courses (including crosslistings) for each subject.

    After one or more subject has been imported, they will be automatically tracked for future updates. This means that:

    • Any new courses that the Registrar adds for the same term will be automatically imported (e.g. a late addition course).
    • When a new term of courses is released by the Registrar, they will be automatically imported.

    You can stop this process from occurring if you'd like by pressing the "Stop auto-import" button next to each subject.

    The automatic import process occurs once per day around midnight. If the Registrar releases a new term of courses, they will become available the following day.

    Importing Courses by Subject and Catalog Numbers

    For programs and centers that are made up of a manual curation of courses from many subject areas, it's typically more practical to import the list of courses you want to display using this form instead of importing all courses for each subject. Use the "Import Courses by Subject and Catalog Numbers" form for this purpose.

    Simply list out the subject and catalog numbers for the courses you want to import, and wait for processing to complete. NOTE: After clicking "Import courses", please be patient. The import can take several minutes.

    Note that you can use both methods described for importing courses if you wish.

    Syncing Updates from the Registrar

    For all courses that were previously imported for the most recent term (using either method described above):

    • Any changes made by the Registrar to the course will be reflected on your site automatically (processed once per day)
    • The course will be automatically deleted if for whatever reason it was removed by the Registrar (processed once per day)

    This ensures that your site does not display outdated or incorrect information.

    Changes you've made to previously imported courses (described below) will not be lost during this process.

    Adding Images, Categories, and an Additional Description

    After courses have been imported, you can edit them by visiting the main content dashboard or courses dashboard.

    Most fields cannot be modified because they are official course data from the Registrar and are automatically managed. However, you can control a few things:

    • Add an Additional Description to provide more details about the course. This is available at the bottom of the course form and will be displayed after the official description on the course detail page.
    • Add a Featured Image and control how it's displayed on the course detail page.
    • Add a Course Category or Sitewide Category for the course, which can be used to better control what courses are displayed in Course List blocks.

    Display List of Specific Courses on Landing Pages

    Refer to documentation for the Course Offerings List block.

    Displaying an Archive of Previous Courses

    Some websites may wish to display a list of past courses offered from previous terms.

    If you're just getting started with courses, you can import the past 4 years worth of courses for the subjects you're interested in displaying. Refer to the section above on Importing Courses. Note that while you cannot import courses older than that, older courses you've already imported will not be automatically deleted.

    To create an archive display, the recommended solution is to create a separate page for each academic year or each individual past term. On each of those pages, add a Course Offerings List block (as described above) and configure it to display courses only from the term you're interested in.

    If using a single page to represent both the Fall and Spring terms, create a block for each on the page.

    These pages can be added to the menu on your site so visitors can easily navigate to the previous course offerings.

    Configuring the Courses Module

    A site admin can visit the modules page to configure settings for the courses module. Here you can control a few options:

    • Indicate if newly imported courses should be published or not. This can be useful if you want a chance to categorize or enhance imported courses before making them available to view.
    • Control how instructors are displayed on the course detail page. Instructors are imported into the Course Instructor taxonomy vocabulary. After importing them, you can add a website or associate them with a Person on your site.
    • Control how the various taxonomy vocabularies are displayed on the event detail page.
    • Disable all course detail pages and prevent them from appearing in search results. Note that course list blocks may still be configured to link the detail pages, but visitors will see a 404 Not Found page when clicking them. You should configure these list blocks to not link. Available in version 2.8.