custom plugins

Custom CSS

With the Custom CSS Tool, Site Admins are able to write their own CSS to modify aspects of any template.

This tool is located within Appearance > Custom CSS.

For security purposes, all CSS is sanitized before being allowed onto the site. Once you hit update, you will notice that the formatting may change. That is the sanitizer CSSTidy at work.

You can revert to the previous version of your custom CSS by clicking the Revert to previous version link that appears underneath the editor.

Allowed CSS

The following CSS selectors, values, and properties will work in the Custom CSS plugin.

Default CSS

Additional CSS

Selectors

:before
:after
area
article
audio
section
aside
base
bdi
body
canvas
command
datalist
details
dialog
embed
footer
figure
figcaption
head
header
hgroup
html
keygen
link
main
map
mark
meta
meter
nav
output
progress
rp
rt
ruby
source
style
summary
time
title
track
video
wbr

Properties

align-content
align-items
align-self
background-clip
background-origin
bottom
border-radius
border-image
box-shadow
box-sizing
color
content
display
filter
flex-grow
flex
flex-direction
flex-flow
font-size-adjust
font-stretch
justify-content
left
min-height
min-width
opacity
order
overflow
overflow-x
overflow-y
position
right
tab-size
text-align-last
text-justify
text-overflow
text-shadow
top
visibility
word-break
word-wrap
z-index

Values

src
rgba()
!important

If your site needs to use CSS properties not listed here, look into custom theming.

UC People

UC People is a plugin developed by the ITS Web Development team. It registers a custom post type of People that appears in the left navigation of the WordPress dashboard.

In combination with new page templates available to Cornerstone-based themes, this plugin provides an easy way to organize and display people.

UC People is available to sites using Cornerstone-based themes, namely ShermanHale 2015 and Prudence 2018.

Examples:

Grid style:

Center for Academic Programs

Table style:

Department of Kinesiology
Department of Political Science

Creating People

To create a person, on the left side navigation on your dashboard go to People > New Person. All fields other than the person's name are optional.

If you used the University User Profiles plugin previously, we have a guide on how to migrate from UUP to UC People. If you have a large number of people to enter or update, you can also perform an import of users to UC People.

Groups and Tags

People can be organized in two ways, with groups and tags.  These can be managed in the dashboard by selecting 'People' and then choosing either the 'Groups' or 'Tags' options.

Groups

Groups act much like post categories, and can be nested hierarchically. For example, a group might be "Faculty" with nested subgroups of "Adjunct" and "Associate". Groups are useful when creating a page of people, as one feature there is to show people separated by their group assignments.

Tags

Tags are just like the tags used by blog posts. They can also be used to organize people, but do not have the option of being hierarchically nested. For example, a single person might be tagged with "Molecular Modeling", "Nanotechnology", and "Polymers". Later, it would then be possible to display all people in the site with the tag "Polymers".

Creating a “People Page”

One of the features of UC People is a new page template that becomes available. This page template has a lot of great tools to help filter and sort which people you want to display.

To begin, start by creating a new page. On the right, in a box labeled 'Page Attributes', set the 'Template' option to "People". You will notice that below the normal visual editor area for content, there will be a number of new form controls in a box labeled 'People Page'.

Layout

This controls the layout of how the people will be displayed. The Grid option makes a grid of people, with multiple people for each row. This is a great option if you have a lot of images, and want to focus on those.

The Table option has only one person per row, but has a lot more room for details like phone number or email address. This is a great option if you have no images, or want to focus the page more on being a resource to contact people.

Specific People

By default, a people page displays all people in the site. You can see them listed in the left column of this section. However, if you only want to display the information of a few people, you can click on those people in the left column, and they will appear in the right column. Then, the page will only display the people in the right column.

This collection of people can then be further filtered down by the Specific Groups and Specific Tags options.

To return a page to displaying all people, delete all the people in the right column.

Specific Groups & Tags

Choose one or more groups, and only people that belong to the selected group OR any other selected group will appear. This allows you to create one people page for faculty, and another for staff, for example.

Choose one or more tags, and only people that belong to the selected tag OR to any of the other selected tags will appear. This allows you to create a people page of only the people tagged with "Chemistry" for example.

If both Specific Groups and Specific Tags are in use, only people that belong to one of the groups AND have one of the specific tags will appear.

Break Into Groups

When selected, this option will display people broken out into groups ordered alphabetically on the group name. For instance, you could select "Chemistry" as the tag, enable this option, and then the people page would display a list for "Adjunct Faculty", and another for "Associate Faculty".

Information to Display

On each People page, you can choose just how much information you wish to display. Any fields left unchecked will simply be left out. Note: In order to display properly, the person's image should be cropped and resized outside Aurora into a square image between 300x300px and 360x360px.

Viewing a Single Person

Once a person has been published, they are available to be linked to through menus, manual links, or a People Page.

In the Menus section, you will see a new box appear along site pages called 'People'. You will need to select this box, but can then add people into navigation menus the same way you would pages.

Ordering People

By default, people will be ordered alphabetically by first name.

This default ordering can be manipulated by altering the Order attribute of each person.

Order of a person
The Order Attribute

For example, if Abdul, Bogdan, and Carol are all set at order 0, they appear in alphabetical order by last name.

  • Carol Gordon
  • Abdul Kazeem
  • Bogdan Stanek

What's really happening behind the scenes though, is more like this:

  1. Order=0
    1. Carol Gordon
    2. Abdul Kazeem
    3. Bogdan Stanek
  2. Order=1
    1. None.

So, if Bogdan's order number changes to "1", then first the list will display all of the 0's, and then all of the 1's, each in alphabetical order.

  1. Carol Gordon [0]
  2. Abdul Kazeem [0]
  3. Bogdan Stanek [1]

If we then change Abdul to a "1", we'll get this...

  1. Carol Gordon [0]
  2. Abdul Kazeem [1]
  3. Bogdan Stanek [1]

Using this field, it's possible to alter the default ordering of people in lists.

It is important to note that altering the order for a person will effect the order in which they are displayed in any list. If you're using more than one People page, this might be an issue.

Widgets & Sidebars

WordPress widgets add content and features to your sidebars. Examples are the default widgets that come with WordPress for post categories, tag clouds, navigation, search, etc. Plugins will often add their own widgets.

Sidebars

You can create a sidebar by going to Appearance > Manage Sidebars. Under Add New Sidebar, type a name for your sidebar and click 'Add'.

Once a sidebar has been created, add widgets to it by going to Appearance > Widgets. You will see available widgets on the left side of the page and sidebars on the right. Simply drag and drop a widget onto the sidebar in which you want it to appear. Note that the Default sidebar automatically appears with Archives, Search Results, and when viewing single posts.

To get a sidebar you've created to appear on a specific page, go to edit the page. On the right side there will be a box titled 'Page Settings', under which you can choose to display one of your sidebars. There is also a checkbox to apply this same sidebar to all child pages. If you want to apply the same sidebar to an entire section of a site, this option will be useful.

Template Support

Most pages support this feature.

Theme May Assign Sidebar Uses Default Sidebar
Sherman, Hale 2015 Default Page,
A-Z Index,
Blank,
Blog,
Homepage,
User Profile
Archives,
Search Results,
Posts
Hale & Prudence Default Page,
A-Z Index,
User List,
User Profile,
User Table
Archives,
Default w/Sidebar,
Posts,
Search Results

In-Page Menus

in-page-menus screenshot

This feature allows users to add a menu to a page. On the edit screen for any given page you will see a menu on the right entitled 'In-Page Menus'. Simply choose which menu you would like to have displayed and choose a style (Tabs on top of the page or List on the right). In page menus do not support nested menu items; they are only one level deep. Note that you can also have a menu displayed on the side of the page by adding a sidebar to it and configuring the sidebar to display the specific menu.

Navigation Options

Cornerstone-based sites have options for different navigation styles. These options are:

  • Dropdowns
  • Multi-level Dropdown
  • Tabs
  • MaxMegaMenu

Support

These menu options are only applicable if you are using one of the following themes:

  • Sherman
  • Hale 2015

Changing Your Navigation Style

On the dashboard go to Appearance > Customize. On the left, there will be an option for Navigation Options. Within that space, you will see a dropdown menu with the options listed.

If you do not see this option, you either are not using a supported theme or you have enabled the Max Mega Menu plugin. You will need to disable MaxMegaMenu before other options are available because that plugin overrides all other options.

Dropdown

This option begins with a simple dropdown for the first to level of navigation, with additional pages being displayed in a left navigation bar. This was the default navigation for all Sherman sites from Summer 2014 – Aug 2015.

Multi-Level Dropdown

This option expands the dropdown menu, and removes the left navigation. Dropdowns will expand to the side forever. We recommend not using this option for navigation that has more than 3 levels of depth, as it can be difficult for users to navigate the options. Large sites should consider using the Tabbed option.

Tabs

In this option, the first two levels of the navigation are exposed in horizontal bars and all other levels are available through dropdown menus.

Sticky Navigation

When set to be On, the top navigation will always sticks to the top of the screen as visitors scroll down pages.

Breadcrumbs

Breadcrumbs are based off of Parent/Child page heirarchy. When set to be On, breadcrumbs navigation will show up on child(ren) pages. For more information view our breadcrumb guide.