Tailoring default navigation and content

The navigation items for these top-level dashboards use default shortcuts to point to the dashboard content records. If you want to edit one of these dashboards, you can copy and modify the existing content record or create a new content record and edit the shortcut to use your version of the content. After an upgrade to a new version of iMIS, the dashboard navigation will continue to use your new content since shortcuts that you can edit are not overwritten.

Do the following to modify the out-of-the-box dashboard so that the Staff site navigation is using your dashboard instead:

1. From the Staff site, go to RiSE > Page Builder > Manage content.
2. Navigate to @/iCore/Staff_Dashboards.
3. Open the folder of the dashboard you wish to modify. Copy the dashboard content record, then paste it into a Shared Content folder. Copy and paste the remaining content records into the same Shared Content folder if you wish to modify the panel tab's source queries ($/Samples/Dashboards).

📘 Note

If you prefer, you can create a new content record instead of modifying the existing content.

4. After the content is in a Shared Content folder, begin making the desired changes.
5. Save & Publish the changes.
6. Next, you will need to modify the dashboard landing page shortcut. Go to RiSE > Site Builder > Manage shortcuts.
   1. Find and edit the dashboard shortcut for All Sites. See Staff site sitemap shortcuts for more information about the names of the dashboard shortcuts.
   2. Select your version of the dashboard content record as the URL or Content Record used by the shortcut.
   3. Save the shortcut.
7. Next, you must republish the dashboard sitemap:
   1. Navigate to RiSE > Site Builder > Manage sitemaps.
   2. Make sure Staff is the selected site.
   3. Click Publish.

Several areas of the out-of-the-box dashboards contain "Top" queries. For example, the Top Products or Top customers in the image above. These areas are limited to show a maximum result of ten, but can be easily modified to show a different top ten. For example, if you click Revenue in the image above, the list reorders to show the products with the lowest generated revenue. Query-generated information on each dashboard can be found in the appropriate folder at $/Samples/Dashboards.

Some tabs allow you to select an entirely different query to display. For example, the Top customers tab on the Commerce Dashboard. From the Select a query drop-down, choose a different list of Top customers to display. To add queries to this drop-down, do the following:

1. Copy the query you want to add to the drop-down.
2. Navigate to $/Samples/Dashboards and open the appropriate dashboard folder.
3. Locate the folder with the same title as the Select a query drop-down. For this example, the folder is Top customers ($/Samples/Dashboards/Commerce/Product Sales/Top customers).

📘 Note

If the Select a query drop-down is not on the out-of-the-box tab, no other queries can be added to that tab.

4. Paste the query into the folder.

🚧 Warning

Do not modify a system query. Make a copy of the query and apply the changes to the copy. Any system query that is modified will be overwritten on an upgrade.

iMIS shortcuts allow you to use short URLs to reference existing pages, and are also used by the iMIS system to navigate to well-known pages. It’s important to know where system shortcuts are being used, and to change the page the shortcuts are pointing to before going live with your website. For example, the Find products page uses the ~/ItemDetail shortcut to navigate to and display the product page. The product page uses the ~/Cart shortcut to display a View cart link when the item is added to the cart. You can change where system-defined links like these will go by updating shortcuts.

You will also need to update these shortcuts after you have copies or new content records to display. For example, the out-of-the-box event page is called EventDetail, and it has an Annual Conference banner on it. This means that each event will display this banner until the shortcut is redirected to display a different content record. You are going to want to make a copy of the Event Display content record, delete the banner, and apply your own customizations. After customizations are made, you will need to edit the Event Detail shortcut to point to your new page without the Annual Conference banner on it.

The following content records and associated shortcuts are areas of iMIS that you will need to configure before going live with your website:

Shortcuts that you can edit are not overwritten during an upgrade. Core content navigation items, however, are overwritten on upgrade. To tailor certain system content on your website, you can make a copy of the content and simply point existing shortcuts to the new content records. For example, several key Staff site navigation items use shortcuts, so you can point to tailored versions of Staff site pages by changing which content record the shortcuts use.

Before editing out-of-the box shortcuts, you should review the shortcut descriptions to identify system content which uses a shortcut. Examples include the account pages (including the staff account page), the staff event dashboard for a specific event, and the content used when adding a contact from various contexts. The majority of the shortcuts used in the Staff site are listed as All Sites shortcuts.

You can edit the following Staff site shortcuts which are used by system navigation items:

New shortcuts that you create are also preserved during an upgrade.

📘 Note

Non-editable shortcuts, such as the ones used for the Member site, might be overwritten on upgrade.

Redirector pages can be used to dynamically redirect a user to the correct page based on certain criteria. iMIS offers three redirector pages out-of-the-box to help you easily create links in HTML or in IQA queries:

Group landing pages (Group.aspx)

Group.aspx resolves the correct URL for a group depending on the group type’s defined landing page.

If the group passed in the URL is a committee, it will use the CommitteeDetail shortcut. Any other groups will use the GroupDetail shortcut.

The link on the group name in this IQA query will direct to the correct landing page for each group.

1. From the Staff site, go to RiSE > Site Builder > Manage shortcuts.
2. Click Add new.
3. Provide values for the shortcut URL:
1. Select the website you are creating a shortcut for in the For Websites drop-down list. The All Sites option applies the shortcut to all websites in the system. Select a specific site to only apply the shortcut to a single website. If you enter an iMIS URL for the shortcut, it's important to ensure that all of your sites have the specified relative navigation item path in their respective sitemaps.
2. Select the shortcut you want to use in the Shortcut drop-down list, or enter a new Shortcut name. The Shortcut name should not be the same as the name of a website or a top-level folder in Page Builder.

📘 Note

Do not name a new shortcut Admin.

3. Enter the URL or content record in the URL or Content Record field. If you enter a URL, replace the site’s root URL with ~, for example ~/Events/Conferences/ConferenceList.aspx.
4. Enter a URL Parameter. You can tell the URL to open on a specific section of the page. For example, say you want event dashboards to open on the Showcase tab by default. In the URL Parameters field, enter Event_Dashboard=1.
5. Enter a description of the shortcut in the Description field.
4. Click Save.
5. You can click the Shortcut to test the link.

For example, create an Events shortcut that points to the Conference List page. You can do this either by entering the URL to the page (~/Events/Conferences/ConferenceList.aspx) or by selecting the content record (@/Events/Conferences/ConferenceList). After inserting the shortcut, the link www.yourwebsite/Events automatically displays www.yourwebsite/Events/Conferences/ConferenceList.aspx.

By default, shortcuts apply to all of your websites. For example, if you define an Events shortcut for all sites, the shortcut always displays the same content record, regardless of which website the user is visiting, www.yourwebsite/events or www.otherwebsite/events. But you can also define shortcuts for a specific site. For example, you might want your mobile website to display a different content record for www.mobilesite/events. In that case, select your mobile site from the ForWebsite drop-down list and point the Events shortcut to the content record you prefer.

To begin creating custom content that will display on a staff person's profile page, do the following:

1. From the Staff site, go to RiSE > Page Builder > Manage content.
2. Navigate to @/iCore/Contacts/ContactLayouts/Staff/Tabs, and copy the content records you want to edit.

📘 Note

To copy all content records at once, hold down Shift on your keyboard, then click each content record. Then from iMIS, go to Organize > Copy.

3. Navigate to @/Shared_Content/Staff/Tabs.
4. Paste the content records in this folder (Organize > Paste).
5. Make any changes to the content, then Save & Publish.

Now, when you navigate to staff-facing profile pages, you will be able to edit all content on the tabs without worry that the information will be overwritten on an upgrade.

The same process can be done for organization profile pages. There are also two different organization profile page views. One is the view a staff user sees, and the other is the organization's company administrator view. A member of the company will always only see the Profile tab of the company administrator's view.

The label for each tab is the Title for each content record. The display order of tabs is sorted in alphabetical or numerical order by the content record Publish file name. Numerical items have precedence for display order. For example, if you have two content records and the Publish file names are 2Creator and 1Record, 1Record will be displayed in the first tab before 2Creator.

Alternate method for tailoring the staff account page

An alternate method for tailoring an account page is to copy the page and modify its system shortcut. First, copy the page (Account Page Staff at @/iCore/Contacts/ContactLayouts), and save the new content record in a Shared Content folder. Make any desired changes in your version of the content record. Then, edit the FullAccount shortcut (used for All Sites) to point to your modified content record. If you use this method, you should check the system Staff Account Page after upgrades for new features that you might want to include on your version of the page.

To begin creating custom content that will display on a member's profile page, do the following:

1. From the Staff site, go to RiSE > Page Builder > Manage content.
2. In the search bar, enter @/iCore/Contacts/ContactLayouts, then click Go.
3. Copy the About Me, Account Page, My Participation, and Preferences content records (Organize > Copy).
4. Paste the content records into a Shared Content folder (Organize > Paste). For example, the @/SharedContent/Membership folder.
5. If you need to display additional tabs on member profile pages, continue adding content records to the @/SharedContent/Membership folder.

Next, you need to update the Account Page content record to point to the other content records you just pasted in the Membership folder:

1. Open the Account Page content record for edit.
2. From the My Account content item, select Configure.

3. From here you have two options: Update each tab individually, or point to an entire folder:
   • Individually update each tab:

     On each tab there is a Content to display field. You will need to select the appropriate content record for each of these tabs. For example, the About me tab will need to be updated to point to @/SharedContent/Membership/AboutMe.

   • Pointing to an entire folder:

     Enable the Use content folder to define tabs option. From the Source folder field, select the @/SharedContent/Membership folder.

   📘 Note

   The Account Page content record must be in a different folder than the other content records in order to use this option.

4. Save & Publish the content record.

Next you must update the MyAccount shortcut:

1. Go to RiSE > Site Builder > Manage shortcuts.
2. Click the MyAccount shortcut row, then select Edit selected.
3. From the URL or Content Record field, select the @/SharedContent/Membership/AccountPage content record.
4. Click Save.

As a staff person viewing a user's profile page, you will see the content pointing to the FullAccount shortcut. To view a member's profile page as a member would see it, you must view the page directly from the MyAccount shortcut. To do this, go to RiSE > Site Builder > Manage shortcuts, locate the MyAccount shortcut, then select the MyAccount link.

Staff users can define what type of user can see certain content on an individual's public profile.

There are three different types of users that you can define security queries for:

• All website visitors
• Authenticated users
• Members

If you are experiencing issues with certain users not being able to see specific content on public profiles that they should have access to see, there could be a problem with how the security queries are set up. See Contact security for more information.

When a staff user views an event in iMIS, they see an event-specific console that includes Showcase, Dashboard, Registrants, and Questions tabs. You might want to configure these tabs to use tailored content or to add or remove tabs. By default the event-specific console uses the Event Dashboard content record (located at @/iCore/Staff_Dashboards/Specific_Event). This content record contains a Content Collection Organizer content item that controls the four default tabs.

Any changes you make to the Event Dashboard content record will affect every event page; the content is not specific to a certain event. After you copy and modify the content record, you must also update the EventDashboard shortcut to point to your version of the content.

1. From the Staff site, go to RiSE > Page Builder > Manage content.
2. If you want to modify the content that displays in one or more of the tabs in the event-specific console, create new content records for the tabs. You might want to copy and modify the default content records for the tab. Save the copied content records in the Shared Content folder.
   • Default content records located at @/iCore/Events:
     • The Showcase tab uses the Event Display content record
   • Default content records located at @/iCore/Staff_Dashboards/Specific_Event:
     • The Dashboard tab uses the Event Detail content record
     • The Registrants tab uses the Event Roster content record
     • The Questions tab uses the Event Questions content record
3. Navigate to @/iCore/Staff_Dashboards/Specific_Event and open the Event Dashboard content record.
4. Configure the Content Collection Organizer content item (titled Event Dashboard by default).
5. For each tab, you can select your content as the Content to display.
6. If needed, add new tabs and select your content as the Content to display.
7. Click Save As and select a location in the Shared Content folder. You can rename the content if desired.
8. Save and publish the new content.
9. To edit the EventDashboard shortcut, go to Rise > Site Builder > Manage shortcuts.
   1. Find and edit the EventDashboard shortcut for All Sites.
   2. Select your version of the content record as the URL or Content Record pointed to by the shortcut.
   3. Save the shortcut.