Another type of Cascade document you can create is a profile. Here you will learn how to create, name, and edit profiles, as well as create profile listing pages. Here are two examples of profiles: 

 

Considerations to make before creating profiles: 

Profiles can be difficult to maintain as personnel and departmental changes often impact faculty/staff titles and responsiblities. An alternative to creating individual profile pages is to display faculty/staff lisitngs as a datatable. Read more about this alternative

Creation Methods

"Add Content" Method
  1. Navigate to and open your website's folder from the Site Content panel
    • Note: If you do not see your website in the "Add Content" menu, or if you do see your website yet don't see the particular document type you want to create, then you can ask ITWeb to set that up for you. If you do not want to have this set up for you, you may use the "Copy Existing Profile" method below.
  2. In the top-left corner of the page, select: Add Content > [your website] > Profile
  3. Name the file and choose a placement folder
    • Note: Remember, new files should NOT be placed in "_blocks" folders since those folders are reserved for blocks only.
  4. Click "Check Content & Submit" in the vertical ellipsis

When to use the "Add Content" method: You will tend to use this method because it is an easy and clean way to create a profile, as long as ITWeb has already configured these options.

"Copy Existing Profile" Method

Documents that already exist on a website can be copied to produce new documents for editing.

  1. Right-click on the profile
  2. Click "Copy"
  3. Name the file and choose the placement folder for the file
    • Make sure it remains in the same folder that the source profile you copied was in (this should be the case)
  4. Click "Copy"
copy-existing-profile.png

Naming Profiles

Profile file names should follow the format lastname-firstname. For example, James Madison's profile file name would be madison-james, which should be entered in both the Display Name and Title fields. 

Good profile names:

  • smith-john
  • doe-jane

Bad profile names:

  • John Smith (Do NOT use spaces, capital letters, or formats other than lastname-firstname)
  • Doe, Jane (Do NOT use spaces, capital letters, or special characters like commas)
Placement Folders for Profiles

Place all profiles in your main website folder under a folder named "people." If you do not already have a "people" folder, refer to creating folders.

Editing Profile Features

Editing Profile Images

Profile images have their own special class that formats them as circular images. This means that you must upload an image to the Thumbnail Image field that is 200 x 200 px for the image to display correctly. If you do not upload an image, we ask that you use the generic profile photo specified below.

Personalized Profile Image


If you are using a personalized profile image and want to upload it before creating the profile, select: "Add Content" button > _Responsive > Profile Image 200x200.

add-content-profile.png

This will create a profile image file that you can upload a 200x200 image into. Change the profile image file name and placement folderYou will need to save your profile images to your "_images/[your website]" folder.  You may want to create a folder inside your images folder for profiles.

profileimage.png

Follow these dimensions for profile images:

  • Must be 200x200
  • Resolution must be 72dpi
  • Recommended file format is .jpg with quality of 8

Feature/Profile Image Sizing Chart:

STANDARD width height
Feature 820 273
Profile 200 200

 

Generic Profile Image


If you do not have a personalized profile image to upload, you can use this generic profile image:

Image Not Available
To use this generic image, follow these steps:

  1. Navigate to the profile page you created and select edit in the top toolbar
  2. Scroll down to the "Thumbnail Image" field

    profile-thumbnail-image-field.png

  3. Click "Choose File" and browse to the generic profile photo by selecting: Browse > JMU > _images > _profile > generic-profile-photo-200x200.jpg

Editing Profile Content


Add desired content to the WYSIWYG content field. For profiles, this is usually text about the individual.

Editing Profile Tags


You must use a "Profile role" tag like: _tags/Profile/faculty or _tags/Profile/staff to specify if this is a faculty member versus a staff member in your department.

Example profiles with tags for faculty/staff:

Add your departmental tag like this one: _tags/source/college-of-business/economics. If the faculty member teaches in multiple areas or disciplines, add all relevant tags.

Creating Profile Listing Pages

Once you have created a profile, you will most likely need to create a profile listing page, where it lists the links to multiple profiles. 

profile-listing-page.png

Here is a link to an example of a profile listing page: https://www.jmu.edu/cascade-examples/people/index.shtml

To create your own profile listing page:

Step 1: Create a new page

Create a new page (if your page currently does not exist)

Step 2: Copy and rename profile feed template

Copy the profile-feed-template folder to your website’s appropriate "_blocks" folder

  • Rename both files (department-folder-index and department-profile-config) within the profile-feed-template folder. Replace the word department with the title of your department and remove the capitalized section. For example, if your department is Economics, rename department-folder-index-PLEASE-RENAME-TO-YOUR-DEPARTMENT to economics-folder-index.
copy-profile-feed-template-file.png
Step 3: Edit the file

Click on the "folder-index" file (which you just renamed to something like "economics-folder-index"), and then click "Edit" in the top bar. You can also right-click on the file and select "Edit" in the dropdown menu.

  • Click the dropdown menu for "Index Type" and select "Index Folder." In the "Index Folder" field, select the folder containing the profiles. In this example, the folder is named "all-faculty".
profilelist1.png
Step 4: Specify the departmental tag

Return to the "profile-feed-template" and select "Edit" on the "profile-config" file. Specify your department’s tag for the "Departmental Tag" field (such as "/_tags/source/college-of-business/economics").

  • To specify your department's tag, select: Choose Block > Browse > JMU >_tags > source > [your department] > [your departmental tag]
profilelist2.png

If your website contains multiple departments, contact itweb@jmu.edu for assistance.

Note: The tag’s "tag" value assigns names to headings. If the tag says "Economics," then your section headings will read "Economics Faculty" and "Economics Staff." If the tag says "Economics Faculty," your headings would be "Economics Faculty Faculty" and "Economics Faculty Staff."

Wiring the Profile Feed Files to the Profile Listing Page


Step 1: Add tags

On your profile listing page, add the departmental tag and one or more "Profile role" tags

  • On the page, select "Edit" in the top toolbar
  • Under the "Content" tab, scroll down to "Tags" within the "RWD Page" section (not the "Tags" section at the bottom of the page_)
  • Add departmental tagSelect "Choose Block" and navigate to your departmental tag (Browse > _tags > source > [your department file] > [your departmental tag] > "Choose" button)
  • Add "Profile Role" tagClick the "Add new field" green plus icon under "Tags", select "Choose Block", and navigate to the "Profile Role" tag (Browse > JMU > _tags > profile >faculty OR Browse > JMU > _tags > profile > staff)
    • Note: Add the faculty and staff "Profile Role" tags in the order that you want the sections to appear on the page
Step 2: Wire profile-config to the page

Wire the profile-config file to a region (such as "REGION-02")

  • On your profile listing page, select "Edit" in the top toolbar
  • Under the "Configure" tab, scroll down to the REGION
    • For Choose Blockselect: Browse > JMU > [your website] > _blocks > profile-feed-template folder > profile-config
Step 3: Choose a format

Editing Profile Display Order


If your profile listing page is formatted to list profiles in folder order, a new faculty/staff profile may not appear where you want it to on the listing page; instead, it may appear at the bottom of the section.  This is controlled by the format for the profile listing page. The format will either list profiles alphabetically, or in folder order.

If profiles are listed by folder order, you can control the order of profiles:

  1. Locate the folder containing profiles in your website
  2. Right-click the folder and select "View"
  3. In the folder view, use the arrow to the right of "Order" to sort profiles by position
  4. Select a profile and use the up and down arrows at the top of the list to move it to a new position (you must click Order first for these arrows to appear once you've selected a profile)
  5. Publish the profile listing page (index page) to view changes

For more information, see Reordering Assets.


Some faculty and staff profiles are separated by section folders, like this example with the sections: adjunct faculty, emeritus faculty, and faculty.

NOTE: Never use this to move profiles across different departments, but you can move files to a "z-archive" folder this way.

profile-folder.png

If a profile in faculty needs to be moved to the adjunct faculty folder:

  1. Right-click on the page in the "Site Content" panel and select "Move"
  2. Specify the new folder destination
  3. The checkbox for the live site [ www.jmu.edu ] should be checked by default under "Unpublish Content"
  4. Click "Submit" 
    You should see a pop-up message: "Move and Rename successful"
  5. Republish the profile page and profile listing page

Creating Profile Listing Pages (Manual)

Manually creating profile listing pages is useful if you have a small number of profiles (20 or less).

Follow these steps to manually create profile listing pages:

Step 1: If needed, create a "people" and "_blocks" folder

Note: If you already have a folder for your profiles you can skip this step.

  1. Create a folder by selecting: Add Content > _ALL > Folder
  2. Name the folder "people"; this folder is where you will place your staff and faculty profiles
  3. Within the "people" folder, create a "_blocks" folder; this folder is where you will place the Profile Listing - Manual block
Step 2: Add Profile Listing - Manual Block
  1. In the _blocks Folder inside the folder where your profiles reside, add the Profile Listing - Manual block by selecting:
    Add Content > _Responsive > Profile Listing - Manual Block
  2. In the “Profile Group” grid cell, fill in the Heading field (example group names are “Faculty” or “Staff”, but you can name them whatever you wish).  Click the green + to add another Profile Group and fill in its Heading accordingly.
  3. Within a Profile Group grid cell, click on the “Choose File, Page, or Link” field and browse to a profile in the folder where your profiles reside; select the appropriate profile and click "Choose"
adding-profile-manual-block.gif
Step 3: Wire the profile listing block to a page
  1. In the top toolbar of the page you created in the previous step, select: Edit > Configure tab
  2. Scroll down to a Region and click "Choose Block"
    1. Select: Browse > JMU > [your-website] > [your profiles folder] > _blocks > Profile Listing - Manual Block
  3. In the same Region, click "Choose Format"
    1. Select: Browse > JMU > _shared-formats > Profiles > profile-listing-manual
  4. Click "Check Content & Submit" in the vertical ellipsis

Moving Profiles on Listing Page

Choose a format to display the profile listing in either alphabetical order or folder order 

  • For alphabetical order, select: Browse > JMU > _shared formats > profiles > profile-listing-from-tags-alpha-edi-order (this will list your profile pages in alphabetical order)
  • For folder order, select: Browse > JMU > _shared-formats > profiles > profile-listing-from-tags-folder-order 

If you wanted to have another pair of sections, like "Accounting Faculty" and "Accounting Staff" to appear below the Economics folks, just follow these directions again but with "Accounting" settings instead of "Economics" settings, and wire up the profile-config to REGION-03.

Deleting Profiles

It is permissible to delete an individual's profile page because faculty/staff occassionally change positions or leave JMU and there is no practical place for a profile to redirect. To avoid broken links, make sure to:

  1. Ensure there are no existing relationships to the profile.
  2. Republish the profile listing page where the profile appeared.

To see if the profile has relationships:

  1. In the page's top toolbar, click "More", and in the dropdown menu, click "Relationships":
relationships.png
  1. A window will open showing all the pages that have a relationship to the profile. If any relationships exist, you should edit these pages to remove links to the profile before deleting the profile page.
  2. When there are no relationships, you can proceed with deleting the profile.

To delete a profile:

  1. Select the profile you want to delete
  2. On the page toolbar, select More > Delete. Note: when you delete a page, it will also be unpublished by default.
  3. If the page still has relationships to other pages, you will see a warning message display. 
  4. Click "Delete"
  5. Republish the profile listing page

Alternative to Profiles: Using a Datatable

Profiles in Cascade are often difficult to manage as personnel changes. A simple alternative is to use a datatable that displays the desired information.

Advantages of using a Datatable instead of Profiles:

  1. No need to create individual pages for each person or maintain the content on each.
  2. No need to get a picture for each person
  3. Only need to publish the page where the table is placed.
  4. No need to configure a listing page.
  5. No need to worry when an employee leaves - just remove their row from the table.
  6. Finding employees by name or title is easier in a searchable table.

Example of a searchable datatable:

Last Name First Name Title Department Contact Info
Ayers Leigh Digital Experience Engineer Digital Marketing Contact
Budnikas Randy Director of Digital Marketing Digital Marketing Contact
Khalil Garriot Director of Branded Content Branded Content Contact

 

To create a datatable, please refer to these instructions.

Back to Top