How do I present my courses in the OpenOlat catalog?
Objectives and content of this instruction
The following instruction explains to you, how you can insert a course into the catalog and offer it there.
Target group
[x] Authors [ ] Coaches [ ] Participants
[x] Beginners [x] Advanced users [ ] Experts
Expected previous knowledge
- You have already created a course.
- "How do I create my first OpenOlat course?"
Where do I find the OpenOlat catalog?
a) As a registered user
OpenOlat users mostly see "Courses" and "Groups" in the main navigation if they are participants. Authors additionally see "Authoring". But the sites in the main navigation can vary. Depending on the role or activated modules, more sites can be added to the main navigation, for example, the catalog. If administrators have activated the catalog (version 2.0), you will find the site "Catalog" in the main navigation. If no catalog is displayed in the main navigation, please contact the administrators of your OpenOlat instance.

b) Without registration (external Web catalog)
In OpenOlat, you can also store offers that are displayed in an external catalog. "External" means that the catalog is mirrored outside the "registration wall" and can be accessed there without registration. The initial version of the catalog (within the "registration wall"), which can only be accessed by registered users, must be a V2 catalog. A V1 catalog cannot be displayed as an external catalog.
Users can then select and book these courses. They will only be guided through the registration process after making a selection (in order to save their work).
For users already registered in OpenOlat, the booking order will be assigned to their existing account. The booking order will then be confirmed.
The external catalog can be offered on the login screen. However, the link can also be incorporated elsewhere, e.g., into a website, or sent by email. Direct links to a specific offer can also be sent.

Further information on the external catalog >
Important
In OpenOlat there are 2 versions of the catalog: catalog 1.0 and catalog 2.0. The following describes the procedure in catalog 2.0.
What can I show in the OpenOlat catalog?
The OpenOlat catalog lists short descriptions of courses and learning resources. Individual tiles can already be displayed on the start page. Under the categories are microsites, on which further individual descriptions (tiles) can be found.

The information in the short descriptions is taken from the information that authors provide when creating a course or learning resource in the settings (tab "Info" and tab "Metadata"). In most cases, it is the same information that participants find on the information page of the course.
The layout of the catalog is determined by the administrators. If, for example, it has been determined that an indication of the implementation format should be displayed in the catalog entries, OpenOlat retrieves this information from the authors' details under "Settings" and displays it in the designated place on the catalog tile.

Information that is not provided for in the catalog layout can therefore not be added completely freely by the authors in catalog 2.0. On the other hand, this guarantees a uniform, orderly appearance of the catalog. Please contact the administrators if you have any wishes regarding the layout of the catalog tiles.
How is it decided what to display in the catalog?
Not all existing courses and learning resources are automatically listed in the catalog. Whether a catalog entry is created is decided by the owners of the course, that is, the authors who are entered as owner in the member management of the course. Learning resource managers can do this for all courses of their organisation.
For this purpose, the owners must
a) share the course for the catalog and
b) create an offer that promotes the course or learning resource in the catalog.
You find the sharing in the administration of your course under:
Course > Administration > Settings > Tab "Share"

If the field "Access for participants" is set to the option "Private", the course does not appear anywhere in the catalog. So in the first step, select the option "Bookable and open offers - Bookable by user in the catalog" and thus enable the display of your course in the catalog.

Whether and where the course appears in the catalog is then determined in the second step by creating offers. In the lower area you can create one or more offers for the catalog.

Important
By default, an offer is available as soon as the course has the status "Published". If you select the option "Custom condition" under "Available if" in the offer, the offer can also be available in another course status or from a certain point in time, for example for a course that is still in preparation.
Create offers
Important
In catalog 1.0, the settings of a course contain the tab "Catalog", in which you assign the course to a catalog category. In catalog 2.0, you set the display in the catalog in the "Share" tab, in the form of offers.
If you click the "Add offer" button, you will get a pre-selection of possible offer types.

Important
If the "Add offer" button is inactive, the field "Access for participants" is still set to "Private".
Choose the type of offer you want.
You can create multiple offers. For example, you can make a course freely available to a particular organizational unit, while offering it to others for a fee with a second offer.

The catalog structure
The design of the catalog is determined on the one hand by the offers of the owners and on the other hand by the specifications of the administrators.
Owners of the course:
- Create the course or learning resource in the authoring area.
- Assign subjects to the course in the metadata:
Course > Administration > Settings > Tab "Metadata" > Field "Subjects / Catalog" - Create offers:
Course > Administration > Settings > Tab "Share" > Button "Add offer" - If necessary, select the organisations for which the offer applies under "Released for" in the offer.
Administrators in the system administration:
- Create the taxonomy:
Administration > Modules > Taxonomy - If necessary, create organisations:
Administration > Modules > Organisations - Switch on the catalog and select the taxonomy of the catalog:
Administration > Modules > Catalog > Tab "Settings" - Create launchers and design the catalog:
Administration > Modules > Catalog > Tab "Launch page"
In catalog V2, sections with catalog entries (tiles, cards) are called launchers.

Within the launchers (these sections in the catalog), the catalog entries can be compiled according to certain criteria (depending on the launcher type and launcher configuration). They are called launchers (German: Starter, Startrampe) because the catalog entries (tiles, cards) are usually dynamically compiled in them.
Launcher with subfolders/categories:
In a launcher of the type "Taxonomy level", courses and learning resources are not displayed directly; rather, the taxonomy levels shown correspond to folders in which the courses and learning resources can be found. They are listed on a microsite that opens when you click on one of the taxonomy levels in a taxonomy launcher.
(Example: the launcher "Categories" in the image above.)
As an author, how do I influence in which launcher my course is displayed?
All offers that meet the criteria for a particular launcher are displayed in that launcher. So, as an owner of the course, you influence the display by
- specifying the appropriate display criteria in your course:
Course > Administration > Settings - and creating appropriate offers.
Example 1:
A launcher is intended (by the administrators) only for members of a specific organizational unit and is displayed only to them. If you as author create an offer that is only valid for this specific organizational unit, it will appear in this launcher.
Example 2:
In a launcher, only offers that contain a specific taxonomy keyword are displayed (set this way by the administrators). As an author, you enter the taxonomy term in the metadata of your course. When you create an offer, you will see that this taxonomy term is assigned. Thus, the offer automatically appears in launchers that are intended for courses with this taxonomy term.
Checklist
- Are internal and/or external catalogs generally activated system-wide by the administrators?
- Have launchers been set up in which offers are shown?
- Has at least 1 offer been created in each course?
- Have taxonomy terms been assigned to the courses?
- Are the courses displayed in the correct launcher?
- Do the courses for the catalog already have the status "Published"?
- Should some courses deliberately remain in the status "Preparation" for the time being?
- Has the order of the launchers in the catalog been set correctly?
- Have execution periods been set for the courses?
- Should the offers be displayed in both catalogs (internal and external)?
- Is it specified in the offers that they should only be visible to members of certain organizational units?
- Has the display in the catalog been checked with different roles (e.g., membership in a specific organizational unit)?
- Should offers only be visible in the catalog during a specific time period?
- Has the sharing in the course settings been set to "Bookable and open offers" in all courses that are to be displayed in the catalog?
- Should implementations from the Course Planner also be offered in the catalog?
- Are courses already included in the implementations? (Implementations can initially also be offered without an included course.)
- Should some courses in the catalog be offered for a fee? If so, is the payment module activated?
Further information
Mentioned on this page
How do I create my first OpenOlat course? >
Catalog 2.0: Overview >
Externally available catalog >
Catalog 1.0 >
Course Settings >
Module Catalog >
Access configuration >
Module Taxonomy >
Module Organisations >
Further reading
Catalog 2.0 - Offers >
Catalog 2.0 - Design >
Course Settings - Tab Metadata >
Offer concepts >