Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Version 2.1.2 - Last update: December 15, 2021

...

General Overview

This College Portal MyPath Administration guide is intended for college administrators who want to:

...

The Tenant Admin tab (as shown below) is the landing page for the college MyPath Tenant Administrator portal administrator following login. 

...

Behind the scenes, the CCC MyPath Onboarding tool portal serves as the large container for each college's MyPath website portal. Within each MyPath instance, college portal the college MyPath Tenant Administrator administrator configures the look and feel and content on the Tenant Admin tab. Each of the panels in the Tenant Admin tab represent configuration "services" that are available to all colleges for this purpose. 

The college MyPath Onboarding tool portal's end user, currently only students, sees a different view of the college's MyPath Onboarding tool portal when they log in. The image below is an example of the college students' MyPath portal view. 

...


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 CCC Technology Center Identity Management system 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

CCC MyPath 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 Onboarding site portal contains individual and unique college or district portals (we cannot do this by district-each school has their own website and webpages) within it. Each individual college MyPath Onboarding site portal contains built-in portlets within it for managing their MyPath site portal. This includes the ability to create new portlets that display information or services to the college end- users.

...

  • Web applications that accept client requests and respond with information

  • Designed for uniformity • Displayed to appear as one web page in the context of MyPath the portal

Note: MyPath The portal supports custom portlets and/or connected web applications. One may be easier than the other to implement. The California Community Colleges Tech Center expects most colleges to begin using MyPath the portal with the built-in portlet features first.

An example of portlets includes the advisor cards (Explore Careers, Choose A College, Apply For College, Pay For College) that display within each unique college or district MyPath Onboarding site portal, as in the image above. The advisor cards are a built-in feature in the CCC MyPath Onboarding site portal that provide student-tailored information via links in each card.

College administrators and students both log in to their college/district MyPath Onboarding site 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 MyPath Onboarding site portal page. The required login credentials and authentication are explained in more detail in Authenticating With College IdP

Multi-Tenancy Features

Each college MyPath Onboarding site /district portal is contained by the larger CCC MyPath content repository portal. Administrative access to each MyPath Onboarding site portal is restricted to the college MyPath Tenant Administrator portal administrator for that college. From a software application point of view, the CCC MyPath Onboarding site 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 site portal. As such, the larger CCC MyPath content repository portal supports what is referred to as "multi-tenancy." 

Portal Mmultimulti-tenancy means the following universal features are available for each individual college MyPath Onboarding site or district portal

  • A dedicated portion of the CCC MyPath Onboarding site portal

  • Access to MyPath portal data (portlets) and basic functionality (login, searching, etc.)

  • MyPath Portal page configuration (controlling what displays and how it looks)

  • MyPath Portal page user management (i.e. which authenticated users see what)

  • Software updates to the MyPath Onboarding site portal are applied for all college/district portals MyPath sites at once.

Delegated Administration

Each college/district portal MyPath Onboarding site is contained by the larger CCC MyPath content repository portal. Administrative access to each college MyPath site /district portal is restricted to the collegeTenant Administratorportal administrator for that college. As a college Tenant Administrator portal administrator, you have access to the following functions: 

...

Supported Roles and Sources

Your "role" in the MyPath Onboarding site Portal is determined by your Identity Service Provider (IdP). Each college /district portal's administrator MyPath Tenant Administrator will define those roles as part of setting up their IdP. When first integrating with the CCC MyPath Onboarding site portal, your college/district will most likely include an IdP role for the college MyPath Tenant Administrator portal administrator and students. Later, your college/district may want to add one or more college staff IdP roles.  See Authenticating with College IdP.

...

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

...

  1. Navigate to Tenant Admin tab -> Tenant Portal Administration panel -> Manage This Skin link to open the College Skin configuration screen.

  2. 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. 

  3. Enter the optional file name and source information in the Filename and Source fields, if desired.

    Image RemovedImage Added

  4. 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.

  5. Click Upload to upload the image. The Attachments dialog box closes automatically once the file uploads successfully.

  6. 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.

    Image RemovedImage Added

Note: Due to caching, it make take up to 15 minutes for changes to header and background colors to be seen by students. 

...

Content Management

The college MyPath Tenant Administrator 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:

...

Content Management Overview

The college MyPath Tenant Administrator 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 MyPath is considered a portlet. A portlet is basically a "container" for the thing you are creating or configuring to display.

College portal MyPath Tenant Aadministrators 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. 

...

  1. Navigate to Tenant Admin tab-> Portal Administration panel-> Manage portlets link to display the Portlet Registry screen.

  2. When you click the Edit link for a portlet the Edit Portlet screen will be displayed.

  3. 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. 

  4. 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. 

  5. 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

...

Note: The life cycle of the portlet can be modified as defined in the Portlet Lifecycle section.

18. Click Save and Configure to save your content portlet and display the Edit Portlet Configuration content Editor screen. 

19. Enter and format the content you want to display in the portlet. If you are familiar with HTML, CSS, or Javascript, you may edit the portlet's code by clicking the Source button. To embed a video in your new content portlet, see:

  • Embed a Video into a Content Portlet

  • Embed a Video with the OzPlayer Interface 

Note: CKEditor won't always keep code entered into it from Source exact, so having a local copy is important. 

...

22. To add your new content portlet to a tab, see: Adding Content to a Tab

Embed a Video into a Content Portlet 

...

Note: The life cycle of the portlet can be modified as defined in the Portlet Lifecycle section.

18. Click Save and Configure to save your App Launcher portlet and display the Edit Portlet Configuration screen. 

...

22. To add your new App Launcher portlet to a tab, see Adding Content to a Tab.

...

Surveys

You can add surveys to the student portal to gather information from your student population. When you create and publish a survey it appears in the Student Portal below the Advisor Cards.

...

b. Follow the instructions for Adding Content to a Tab in the link below to add the survey portlet to the student layout. See the following next topics:

  • Adding Content to a Tab

  • Adding Static Content & Registering Portlets

  • Fragment Administration Vs. Personal Customization 

...

Advisor Cards

Advisor Cards are tasks that display to students in the college portal beneath the background image. Once a student has completed a task, a green circle with a check will display next to the task, indicating that they finished the task. Each task has a duration and as the tasks on a card are completed, a green status bar shows current state of completion. 

...

Note: As values are entered into the Link field, search results matching the entered values will be displayed for selection. 

[ screen shot ]

See Custom URLs on how to create customized links.

...

Note: The Edit Portlet Configuration page is displayed. See Adding Top Level Links and Adding Dropdown Links for information on configuring your navigation menu link. 

...