Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Status | ||||
---|---|---|---|---|
|
The academic calendar for the School of Law is managed entirely within Cascade CMS. It feeds to the following public-facing pages:
Linked from:
Processes
There are two main reasons to make updates to the academic calendar. We’ll call these process 1 and process 2. You can click on any of the screenshots on this page to enlarge them.
Process 1: Updating a Calendar’s Data
The first process is to make minor edits to an already existing calendar. It’s the easiest, so that’s where this documentation will start.
Process 2: Yearly Calendar Shuffle
The second process is usually performed once a year when the “previous” year’s calendar is removed, making the “current” year become the previous year, the “next” year then takes the spot for the current year, and a new calendar year is added into the next year position.
Location of Files to Edit
All of the academic calendar files you will need to work with are located in Cascade CMS within the following directory. You can navigate to this folder if you’re already in Cascade, or simply click the following link. Note, you may need to log in before the system will let you access the page.
Process 1: Updating a Calendar’s Data
Step 1: Selecting the Correct Block Asset
Each of the academic calendars (previous year, current year, and next year) are controlled by “blocks” in Cascade. So there are two separate assets involved; the page which displays the calendar, and the blocks that control the data. For updating a calendar, you will only need to edit the block, and not the display page itself. Below are three screenshots detailing which display page (in blue) is controlled by which block (in red).
For instance, if you want to edit the data on the page named “2023-24” (which, at the moment, is the “next year” page), you would start by selecting the block asset named “items-2023-24.”
Notice that the current year’s display page is always named “index.” That’s because it’s the landing page. Because of this, the current year is the only display page whose name won’t align with the block that controls it. To edit the current year’s data, look for the year range that the current calendar spans, in this case, “items-2022-23,” and select that block. This is outlined in red in the screenshot to the right.
You will know you have a block page selected because the content does not look like it does on the live site. Instead, you will see several collapsed containers labeled, “Calendar Item,” as in the screenshot to the right.
The links in the titles below should take you to the correct corresponding blocks for each of the respective display pages.
Current Year “Index” Block
Step 2: Edit the Block
With the correct block selected, click the edit button.
Step 3: Expand the Correct Container
Find the entry you need to edit and click to expand its container.
Step 4: Make Edits
Change any necessary text, or click into the Date Field and select a new date to change it. Don’t forget that if the new date would alter the date sequence, you will also have to use the container arrows to move the container up or down the list so that it appears in the correct order.
Alternatively, you can click the red X to delete the container. Warning: There is no pop-up asking to confirm your decision. Once a container is deleted, it instantly disappears. You will have to discard your draft and start over if you want to recover it.
Step 5: Preview Draft and Submit
Once all of your edits are complete, click Preview Draft, and continue with the workflow submission process as normal.
Process 2: Yearly Calendar Shuffle
This process is usually done only once a year.
Creating a New Academic Year
Every page in the above referenced folder represents one academic yearThis process is usually performed once a year when the “previous” year’s calendar is removed, making the “current” year become the previous year, the “next” year then takes the spot for the current year, and a new calendar year is added into the next year position.
No pages are actually moved to accomplish this. Instead, pages are renamed and any dates and entries are modified on the individual pages.
Because the School of Law only shows three active academic calendar years (previous, current, next) you can easily repurpose the oldest calendar page for the new year you need to createolder calendars for newer years. This will allow you to retain all the items in the calendar, requiring you to only change dates.
Example:
Image RemovedRename the Oldest Page
Locate the oldest year page in the folder you navigated to previously.
The steps below will walk you through the process. In short, you will start by modifying the “previous” year to mirror the data on the “current” year. Then you will modify the “current year” to have the data on the “next year.” Then, the “next year” data is updated with the dates and information for the “new” information for the “new next year.”
Finally, all the of pages and blocks are renamed to reflect their new updated year spans.
Note on This Documentation’s Examples
This documentation will be using the following year ranges for references and screenshots:
2021-22: Previous Year
2022-23: Current Year (Default “index” page)
2023-24: Next Year
Step 1: Edit the Previous Year
Select the previous year’s block and edit it.
Step 2: Update Data
Expand each of the entries and proceed through them to update text, change the date, move, or delete the entry.
At this stage, you will be replicating all of the entries as they currently exist on the “current year” page.
Changing the Date
To modify the date, click on the small “up arrow” next to the year, then select the correct date.
Step 3: Preview Draft
Once all of your edits to the block are complete, click the Preview Draft button. This will save all of your changes. Do not submit the changes yet. All of the changes will be submitted together, so that the calendar updates on the live sites simultaneously.
Step 4: Repeat Steps 1 - 3 for the Current Year Block
Once you have finished updating the previous year block so that it contains all of the current year’s data, then follow steps 1 to 3 above to update all of the current year’s data to contain all of next year’s.
Step 5: Repeat Steps 1 - 3 for the Next Year Block
Once you have finished updating the current year block so that it contains all of the next year’s data, then follow steps 1 to 3 above to update all of the next year’s data to contain all of the new year’s.
Once all of the data is update on all of the blocks, the next phase will be to update the names of the pages and blocks.
Step 6: Submit Workflows
When your pages are ready to go live, and you have time to finish the following steps, select the previous year block then click the submit button.
Repeat this for the current and next year’s blocks as well.
Step 6: Rename Pages
Locate the previous year page. Pages are denoted with the following icon:
Image Removed- Image Added
Right click on the
oldestprevious year page and choose More → Rename.
Please keep the same naming convention when you rename the page, then click the blue
RenameStart Workflow button.
Step 2:
[SCREENSHOT]
Step 3
Image RemovedRepeat this for the current and next year pages as well.
Step 7: Rename Blocks
Every page has a respective “block” that contains all of that year’s events. It will be named the same as the page, but with “items-” prepended.
Once the proper block has been identified, you can rename it to match the academic year you are adding.
Right click on the block and choose More → Rename. Remember, blocks are associated with the following icon:
Image Removed- Image Added
Please keep the same naming convention when you rename the page, i.e. only change the year and leave
items“items-” intact, then click the blue
RenameStart Workflow button.
Example:
Image RemovedStep 2
Image RemovedEdit the Renamed Page with New Dates
Repeat this for the current and next year blocks as well.
Step 8: Wait for Workflows to Be Completed
Once the web team completes all of the workflows, all of your changes will be live.
If you require any assistance, create a ticket for the web team by going to sandiego.edu/work-quests