| Note |
|---|
Version 2.1 - Draft In-Progress - September 01, 2021 |
College Portal Administration
...
...
General Overview
This College Portal Administration guide is intended for college portal administrators who want to:
Configure their college's theme (logo, name, background image and colors)
Configure their college's portal communication and messaging
Getting There
Tenant Admin Tab
The Tenant Admin tab (as shown below) is the landing page for the college portal administrator following login.
...
[ screen shot of student end-user home page ]
Authenticating with College IdP
In order to be included in the California Community College Portal, your college or district needs to have an Identity Provider (IdP) set up. Your individual account must be associated as a Tenant Admin in the portal. If your college/district does not have an IdP, please contact the California Community Colleges Technology Center to discuss your options.
Portal Basics
A portal is a web site that acts as a container for consolidating information and/or services from a variety of sources so that they appear as one cohesive site. The CCC MyPath portal contains individual and unique college or district portals within it. Each individual college portal contains built-in portlets within it for managing their portal. This includes the ability to create new portlets that display information or services to the college end- users.
...
College administrators and students both log in to their college/district portal via single sign on (SSO). Only the college administrator and its students (to whom it gives access via IdP authentication credentials) can access the college/district portal page. The required login credentials and authentication are explained in more detail in Authenticating With College IdP.
Multi-Tenancy Features
Each college/district portal is contained by the larger CCC MyPath portal. Administrative access to each portal is restricted to the college portal administrator for that college. From a software application point of view, the CCC MyPath portal is one application that serves every college/district. In technical terms, each college or district portal is called a "tenant" of the CCC MyPath portal. As such, the larger portal supports what is referred to as "multi-tenancy."
...
A dedicated portion of the CCC MyPath portal
Access to portal data (portlets) and basic functionality (login, searching, etc.)
Portal page configuration (controlling what displays and how it looks)
Portal page user management (i.e. which authenticated users see what)
Software updates to the portal are applied for all college/district portals at once
Delegated Administration
Each college/district portal is contained by the larger CCC MyPath portal. Administrative access to each college/district portal is restricted to the college portal administrator for that college. As a college portal administrator, you have access to the following functions:
Administration
Tenant Portal Administration
Manage Portlets
Manage this Skin
Manage Content Header Images
Manage Public Documents
Fragment Administration
Advisor Card Administration
Admin Messaging Log
Survey Administration
Additional portlet access
App Launchers
Content Portlets
Navigation Menu
Supported Roles and Source
Your "role" in the Portal is determined by your Identity Service Provider (IdP). Each college/district portal's administrator will define those roles as part of setting up their IdP. When first integrating with the CCC MyPath portal, your college/district will most likely include an IdP role for the college portal administrator and students. Later, your college/district may want to add one or more college staff IdP roles. See Authenticating with College IdP.
Basic Portal User Experience
The basic portal user experience depends on your role when you log into the college portal. The common portal experience includes searching, navigation, and linking to content. The college administrators customize the look and feel and content of their portal and configure which portlets display to students.
College students log in to a college portal and interact with each of the portlets.
General Portal Navigation
These portal navigation items are the same no matter if you're the college portal admin or a student:
Log into the portal. A header bar displays that includes the CCC MyPath logo next to a search bar.
Enter a search term in the Search bar and click the Search icon retrieve search results. An auto-suggest feature displays common search options beneath the search window as you type. See Searching the Portal for details.
Click the CCC MyPath logo in the upper left corner from anywhere in the portal to return focus to the home screen.
Scroll down the page to see more items.
College Students
The portal acts as a "one-stop shop" for college students in terms of a hub for their college information. College students log in to the college's portal to:
Get information they need for college success.
Interact with recommended topics based on specific needs and interests, such a college directory, course catalog, or information on salaries for different graduates of specific programs. These topics may display as:
Static content portlets
App Launcher portlets
Advisor Card portlets
Surveys o Messaging via portal messaging, email or SMS
College Portal Administrators
The college portal administrator is the initial college user of the college portal. The portal administrator configures the look and feel and the content. The college portal administrator logs in and sees the same header bar and search bar as a student user.
...
Note: You can use portlets to link to specific content. Some examples include a link to a third-party web site or application from an App Launcher portlet.
Searching the Portal
The Portal includes a universal Search bar at the top of the screen. Searches include auto-complete functionality so that suggested search options appear beneath the Search bar as you type.
...
[ screen shot of Search input page ]
Configuring Your College Theme
You can configure your college portal's display by:
...
Use one of the anchor links below to go through the steps of configuring your college theme.
Updating the College Header Background/Text Colors and Nav Menu Color
Updating the College Portal Background Image
Updating the College Logo Image and Content
Updating the College Header Background/Text Colors and Nav Menu Color
Use the following steps to configure your college colors and background image.
...
Note: Due to caching, it make take up to 15 minutes for changes to header and background colors to be seen by students.
Updating the College Portal Background Image
Navigate to Tenant Admin tab -> Tenant Portal Administration panel -> Manage This Skin link to open the College Skin configuration screen.
To update your college portal's background image, click the Upload Image link next to the Tenant Background Image URL field to open the Attachments dialog box.
Enter the optional file name and source information in the Filename and Source fields, if desired.
Click Select File to open your operating system's file browser, and navigate to and select the image file you want to use as your college portal's background. The selected file name displays beneath the Select File button (collegeBackground.png in the example image above). Suggested image size is 350px high and a minimum of 1170px wide.
Click Upload to upload the image. The Attachments dialog box closes automatically once the file uploads successfully.
Click Save to save all your changes, close the Manage This Skin screen, and return to the Tenant Admin tab with your new background image displayed.
...
[ screen shot of Tenant Background Image URL ] < placed between number 3 and number 4 above.
Editing the College Portal Background Image Transparency Level
Colleges can add a mask to their Background Image and control the transparency level percentage.
...
[ screen shot of the mask opacity level indicator with highlight box ]
Updating the College Logo Image and Content
Changing the college logo image and content can be done through a content editor. Use the following steps to add or update the college logo in your college portal:
...
[ see all screen shots in this section and add where required ]
...
Content Management
The college portal administrator manages the content of their college's portal by creating portlets using a variety of built-in portlet tools. The portlets you can create include:
Static content portlets
App Launchers
Surveys (with smart forms)
Advisor cards (with notifications)
Content Management Overview
The college portal administrator manages content by creating specific portlets and then adding or removing them for specified user groups, applying portlet expiration dates, etc. The steps to do all of this are included within the instructions for creating each of the different portlets currently available, including:
Static Content & Registering Portlets
App Launchers
Surveys
Advisor Cards
Portlet Basics
Anything that you create or configure to display inside your college portal is considered a portlet. A portlet is basically a "container" for the thing you are creating or configuring to display.
College portal administrators determine which groups can have access to any given portlet as well as configuring active and inactive date ranges for portlets, also known as the portlet lifecycle.
[ Suggest adding a graphical element here (generic) to help visualize a “portlet” ]
Portlet Lifecycle
The lifecycle for any portlet can be defined by the college administrator by selecting the options in the Lifecycle Management and optional Automatic Expiration sections. You control the status and display of any and all portlets for your college.
...
Navigate to Tenant Admin tab-> Portal Administration panel-> Manage portlets link to display the Portlet Registry screen.
When you click the Edit link for a portlet the Edit Portlet screen will be displayed.
Scroll down to the Lifecycle Management section and click the Option radio button that corresponds to the portlet state of Created, Approved, Published, Expired or Maintenance as needed.
If you want to set an optional expiration date for the portlet (only available when Approved or Published is selected), scroll down to the Automatic Expiration (optional) section and click in the Setting field to display a pop-up calendar where you can choose an expiration date.
After selecting the expiration date, drop-down list will be displayed so you can select the time (hour, minutes, and period of the day (AM or PM)) the portlet will expire.
[ add all the screen shots in this section as needed ]
Note: When the selected date and time are reached, the portlet will no longer display in the Portal and its state will automatically revert to the Option of Expired.
See:
Adding Static Content & Registering Portlets
Adding App Launchers
Adding Surveys
Adding Advisor Cards
Adding Static Content & Registering Portlets
Static content portlets contain simple content. Use the following steps to create a content portlet that you can add to your portal:
...
[ add the two screen shots for this section ]