Using the Content Management System

Topics

Creating a Page

The Create Page dialog is visible on the CMS Admin home and the Pages screen. If you try to visit a page that does not exist (by typing in the URL bar), the CMS will prompt you to create a new page, if appropriate. A page title and a URL stub is required to create the page.

page not found; page creation prompt
If you try to visit a page that doesn't exist, the CMS will prompt you to create a new page using the URL stub you tried.
screenshot of page creation dialog
Create page dialog. Note the 'Publish this Page' checkbox (checked by default)
URL stub, showing the 'admissions/tranfer' URL stub
The URL stub becomes part of the page address.

The URL Stub is the part of the URL after hilo.hawaii.edu/, and before the trailing .php. For example, 'admissions/transfer' will be visible at hilo.hawaii.edu/admissions/transfer.php.

To create a directory, use a trailing '/' after the URL stub.

For example - 'admissions/inspired/', which will be visible at hilo.hawaii.edu/admissions/inspired/


Parent pages / hierarchy

Every page has a 'parent' page that above it in the navigation. The home page for your department or unit is a good choice for 'Parent Page'. For example, Student Affairs would be an appropriate parent page for hilo.hawaii.edu/studentaffairs/sssp/. To filter the list, just start typing the page name or URL stub of the office or department that houses your organizational unit.

screenshot of page hierarchy control
Page nesting is a reference to hierarchy.

Duplicating a page

The Duplicate page... button allows you to create a copy of an existing page, with a new URL stub and page title. To use the duplicate function, first save any changes to the page, then click the Duplicate page button. A dialog will come up, asking you to confirm the new page name and URL stub. Any styles or fragments included in the 'Additional Content' area will be copied to the new page, as well as the page template and any pre-page content. Duplicating a page is a convenient way to make sure your new page matches the others in your site.

Duplicate page / Delete page buttons
The Duplicate page and Delete page buttons are found on the 'Edit page' screen.
Duplicate Page dialog
Enter the new title and URL stub for your new page on the 'Duplicate page' dialog.

Unpublishing a page (or, why not to delete a page)

When you want a page to be removed from public view, you can 'unpublish' the page by going to the 'Meta' tab and unchecking 'Publish this page' checkbox. The advantage of doing this is that the page will still be available on https://cms.uhh.hawaii.edu/ (to logged-in users), but will not be available to the public on the live https://hilo.hawaii.edu/.

screenshot of page listings, showing the unpublished flag
Unpublished pages are shown in the Pages listing with the label 'Unpublished' against a red background

It is possible to delete a page in the CMS, however there are a few reasons why it is preferred to 'Unpublish' the page instead. Deleting a page removes the edit history, and may lead to broken links. Unpublishing the page allows for it to be recovered later.

If you want traffic from your deleted page to be directed elsewhere, consider using a Redirect instead.

Screenshot showing the 'Publish this Page' checkbox on the 'Meta' tab
To unpublish a page, uncheck the 'Publish this page' checkbox in the 'Meta' tab.

Redirecting pages

Sometimes, it is useful to have a page that forwards to another page. To establish a forwarding page, enter a URL in the 'redirect' field of the 'Meta' tab on the Create Page form. Creating forwarding pages allows legacy or shortend page URLs to still point to the current page. Redirects can be useful to correct broken links, by forwarding traffic to the correct page instead.

This example redirects traffic from the shorter 'tcbes-graduate-handbook' to a longer URL.
When viewing all pages, redirect pages will be marked with a light blue background and the word 'Redirect'.

Editing an existing page

To edit a page, first login to the CMS Admin, and then find the page you wish to edit. You can do so by browsing cms.uhh.hawaii.edu, and looking for the 'Edit this page' link in the lower left corner.

Screenshot showing 'Edit this Page' link on a CMS page
The 'Edit this Page' link shows up on the bottom of pages on cms.uhh.hawaii.edu, so long as you are signed in and have edit access
Search field
The search dialog is at the top of the navigation menu for the Admin panel.

You can also use the site search from the admin panel to search for the title or URL stub of the page you want to edit.

Search results screenshot
Results from a site search are shown with links to edit (page title) and view the page (URL stub)

Hawaiian Characters

Insert special character menu items
The 'Insert special character' button includes all of the hawaiian characters, plus hard-to-type characters such as apostrophes and quotes.

The UH Hilo CMS is designed to make it easy to spell Hawaiian words properly, using Hawaiian Characters such as the ╩╗okina and kahak┼Ź. Do not use the single quote ('), apostrophe (ÔÇÖ), or backtick (`) in place of the ╩╗okina.

Avoid using backticks (`) in place of ╩╗Okinas, because they will be interpreted incorrectly.

Adding images to a page

The insert asset button is located in the toolbar above the main content edit box

To add images or other assets to a page, you can use the button from the edit page screen.

Upon pressing this button, a dialog will come up, with a few tabs. The 'Select Asset' tab will show all of the images in the current folder. You can also browse to other folders on the website. Once you choose a photo, the code to show it on the webpage will be inserted into the page. If you have text selected when you press the 'Image' button, that text will become the Alternative text that screen readers will use to describe the image.

View images from the current folder in the 'Assets' tab.
Select the 'Upload' tab to reveal the uploader. Drag and drop files from your computer to upload them and place them on the current page. The files will be uploaded to the folder of the page you are editing.

Alternative Text on Images

Not all visitors to our website are the same. Some see differently, or not at all. If you rely on things like the contrast between different colors to convey different information on a chart, how will a coloblind person be able to interpret it? Similarly, if you publish an image of a flyer for an upcoming event, with the alternative text 'poster' or 'flyer', that is doing a disservice to those using a screen-reader to access the content.

Alternative text markdown rendering demo
The text within the square brackets becomes the alternative description of the associated image

Good alternative text should be descriptive and describe the image within the context of the contentÔÇöall within one sentence. Ask yourself: How would I describe this image to someone over the telephone?

For charts and graphs, the web office may be able to assist in making patterned charts accessible to the colorblind.

Using the Assets manager

Files and images stored on your website can be found in the 'Assets' section of the CMS. To view / add documents to your site, go to the Assets section of the CMS, then choose the appropriate folder. Files are kept in a folder that has the same name as the URL stub. For example: Documents uploaded from the /uhh/vcaa/ folder will be in the uhh > vcaa folder.

To upload files, drag and drop them onto the light blue upload area at the top of the Assets page.

Clicking on a file from the assets page will display a code to link to the file, or to diplay the image, in markdown syntax. You can also rename a file or move it to a new location by clicking the 'Rename' button.

Clicking on a file will display the code that can be used to include the file in a page.
Images will be previewed when they are selected from the Assets page.

Please note that all web content must be accessible. This includes images and documents that you link from a web page. See Accessibility of Web Content and contact the web office for more information.


Advanced file management

There are some powerful tools built into the asset manager. It is possible to find unused files and download an archive of selected files using the 'Actions on Selected button.

The 'Select...' button allows you to check all files in a folder with one click.
Once you have files selected, the 'Find File Usages' option will deselect any files or images that are linked from pages, meaning the remaining files are safe to delete or archive.
Actions on selected button
One of the available actions is to download an archive of the selected files