I'm getting 404 errors when I use the navigation!
This could be caused by a few different things:
- You have a Scope > Catalog mismatch. Check your scopes in the navigation tab and ensure that it is in proper alignment with the appropriate catalog. Similarly, ensure that in the "Catalogs" tab of the website settings, that you've also selected the appropriate top and sidebar navigation.
- You have not connected pages to the navigation links in the nav-builder. Ensure that navigation links are connected with pages, slugs have been added, and all warnings have been addressed so the navigation isn't red and indicating a broken link anywhere:
- If it's a course, program, or department page, you've used (not updated) "courses," "programs," or "departments" as your base slug [our pre-built pages use these slugs, so you're mismatching the query when you continue to use these slugs]. Change the slug to anything other than those specific terms - it can be similar it just needs to be unique. For example, you are free to use "program" instead of "programs":
- You have repeated your slugs. Double-check all of your navigation links and ensure that there aren't any duplicate slugs that are placed in the same position in the navigational hierarchy.
The catalog says "page not available" but I see that it's a Coursedog page! The Favicon is the Coursedog logo.
In this case, you have not set up the home link type yet. If this setting is not configured, the catalog will not display— even if everything else is set up properly. Ensure you've selected an option from the drop-down menu below:
I don't see my catalog when I click "view public catalogs," even though I've built it and configured my navigations correctly.
This is an issue that has to do with URL settings. When you build a new catalog(s), Coursedog supplies and links a relevant URL(s) to your staging environment. If your catalogs are not attached to the appropriate URL in the URL tab within settings, it will not be viewable. Ensure that your catalog is attached to the appropriate URL:
All of my internal links lead to 404 errors in production even though they worked in staging.
All hyperlinks should be built and structured as internal relative links— meaning they don't have the base url (eg. https://staging.coursedog.com) attached to them, rather they're just the slugs (ex. /programs/business/ba/accounting). Ensure that all hyperlinks are structured as relative links before the clone to production, otherwise, when SSL is set up and the base URL becomes https://catalog.<institution_name>.edu, your internal links will not work:
The columns on my tables don't align when there are multiple tables on the same custom page.
Currently the alignment of tables is dynamically determined based on the content, which also allows for a responsive design, as the table will change shape to accommodate smaller screen sizes. The downside is there is no current way to enforce alignment of table columns.
Public Catalog Default Term Logic
The public catalog supports the Course Schedule card, which will default to display the "Current Term" as it is defined in scheduling.
However, if that term is not set as
public in the Catalog → Settings → Terms page, then there will be no default term in the public catalog course schedule card.
This is an example of the Terms setting page in Catalog settings.
My changes to settings are not taking effect.
There are now catalog-specific website settings. If a user is trying to change global catalog settings, and they see the changes are not taking effect, the first thing they should check is if they have catalog-specific settings set up, because those will override all global website settings.
Catalog Tips and Tricks
- Theme Color: Coursedog's Catalog product now has the ability to change the color of the text on the Topbar-navigation. As such, ensure that the "Theme Dark Color" (used for the Topbar) is a contrasting color to the "Navigation Link color" so as to ensure readability:
- Slugs: When selecting slugs, choose intuitive, simple, and short labels, as this will help with the accessibility of your site.
- Navigation Image: Ensure that your navigation image's background is transparent and that the image is cropped to solely include the navigation image and no negative space. This allows the Catalog builder to properly size the navigation image to the header.
- Headers and Org Structure: Be intentional with your use of H1 headers and subsequent organizational structures for your pages as your header structure, paired with how your Sidebar-navigation is set up. This will guide how your auto-generated PDF catalog will organize its Table of Contents.
- Default Catalog: Setting your primary catalog as your default catalog in the "Catalogs" tab of your website settings will let you not have to worry about setting the catalog scope every time you edit your navigation or pages as it will be automatically selected:
- Images: When using the WYSIWYG editor with images ensure you use the preview function to see how it will appear on a webpage. The editor's size is based on the size of the screen and how zoomed in one is; it's not helpful when considering fit. As a rule of thumb, use images that are at least 1000px wide:
- Email link: If you would like to include an email link in a WYSIWYG field / Page editor, use the mailto: prefix in the inserted link