Editing custom account pages

Training course

Out-of-the-box, iMIS comes with pre-built account pages that users are encouraged to make copies of, so they can customize the account pages. See Understanding and modifying account pages .

Once you begin working with custom account pages, you can continue to edit aspects of the account pages.

Finding custom account page content records

If you are not sure where in the Document System your custom account page tabs are located, do the following to find their location:

  1. Go to your account page.
  2. Enable Easy Edit.
  3. Select Open in Content Designer.

  4. Make note of the content record location noted in the editor:

  5. Close the page.
  6. Go to RiSE > Page Builder > Manage content.
  7. Navigate through the noted folder path. The account page tabs are there and can be opened for editing.

Editing panels on account pages

When editing panels, you can add or remove properties or change property labels.

Adding and removing properties

  1. Go to the account page you want to edit.
  2. Enable Easy Edit. Content items available for customization are highlighted in blue and have the Configure button available when hovering over the content item.
  3. Hover over the Panel Editor content item, then click Configure.

  4. Next to the Panel option, click Edit.

  5. Click and drag additional properties to the layout area to add new properties.

    6. Drag properies to panel window

  6. Click the X on each property in the layout area to delete unwanted properties.
  7. Click Save & Close.
  8. Click Save & Publish.

Changing property labels

Do the following to change a property label:

  1. Go to the account page you want to edit.
  2. Enable Easy Edit. Content items available for customization are highlighted in blue and have the Configure button available when hovering over the content item.
  3. Hover over the Panel Editor content item, then click Configure.

  4. Next to the Panel option, click Edit.

  5. Scroll down to find the property Label you wish to change, delete the current label, and type the new one.

    6. Panel Designer window with emphasis on where to edit a property label

  6. Click Save & Close.
  7. Click Save & Publish.

If you wish to add a new panel to an account page, see Creating a panel and adding it to account pages.

Editing the layout of an account page tab

Do the following to edit the layout of an account page tab:

  1. Go to RiSE > Page Builder > Manage content.
  2. Navigate to @/Shared_Content/Staff/Tabs.

    3. Note: Your custom account pages may be in a different folder. If your account page tabs are not located in the Shared Content folder, locate the account page tabs.

  1. Double click on the tab you want to rearrange.
  2. Click and drag the various content items to their new locations you want them to display at. Available areas to move the content item to highlight in gray.
  3. Click Save & Publish.
Editing the name and order of account page tabs

Do the following to edit the name or change the order of account page tabs:

  1. Go to RiSE > Page Builder > Manage content.
  2. Navigate to the folder location of the custom account page tabs. The out-of-the-box location is @/Shared_Content/Staff/Tabs.
  3. Open the content record for edit.
  4. (optional) Update the Title if you want to change what is displayed in the title of a browser window or browser tab.

  5. Update the Publish file name:
    • Changing the name of the tab: Enter the new name in the Publish file name field to change the name of the tab.
    • Changing the tab order: Entering a number as the first character of the Publish file name will specify the order the tab appears on an account page, beginning with zero.

      • Important! You will want to change the number of the other tabs as well to ensure the tabs are in the correct order after you begin modifying the numbers.

  6. Click Save & Publish.

Deleting a tab from an account page

To delete a tab you do not want or need to use, simply delete the related content record from the @/Shared_Content/Staff/Tabs folder:

  1. Select the content records, for example, Volunteering and Giving.

    2. Note: To select multiple content records at once, hold down Ctrl on your keyboard, then click each content record.

  3. Go to Organize > Delete.

    4. Delete button

Editing queries on account pages

Even after copying the out-of-the-box account pages, you are still using out-of-the-box queries on the copied pages. If you need to edit a query on one of the account page tabs, you will need to do the following:

  • Make a copy of the query - On each iMIS upgrade, the out-of-the-box content, including queries, is overwritten. Any changes made to out-of-the-box content are not preserved on upgrades, so it is best practice to make a copy of the content, then make changes to the copy.
  • Make changes to the copied query
  • Update the custom account page to point to the updated query

Example: You need to display the Product Codes associated with orders in the Recent transactions query on the Transaction tab of account pages.

Determining the query's location

Do the following to determine where the query exists in the Document System:

  1. Go to an account page.
  2. Enable Easy Edit.
  3. Locate the query you need to edit. For this example, it is the Recent Transactions query.
  4. Hover over the Recent transactions query, then click Configure.

  5. Make note of the query path in the Source query or folder field.

    6. Highlighting the path in the "Source query or folder" field

Editing the query

Do the following to edit the query:

  1. Go to RiSE > Intelligent Query Architect.
  2. Navigate through the query path. For this example, the path is the following:$/ContactManagement/DefaultSystem/Queries/Recent Activities/Transactions.
  3. Make a copy of the query and paste it into the same folder or any folder you want. If pasting the query in the same folder, the name of the query is prepended with "Copy_of".
  5. Open the query and edit as needed. For this example, click the Display tab.
  6. Enable the Display checkbox for the [CsOrderLines] Product Code property.

    7. Query properties with an emphasis on the Product Code property

  7. Continue editing the query as needed, then click Save.

Updating the account page to use the edited query

Do the following to update the account page to use the edited query:

  1. Navigate back to the account page and locate the query.
  2. Hover over the Recent transactions query, then click Configure.

  3. Scroll down to the Source query or folder field, and select the new query.

    4. Selecting the new query from the pop up window

  4. Click OK, then click Save & Publish.

The account pages now display the newly updated query.

Expanded view of updated query on account page

Updating the account page banner

The following options allow you to change the account page banner:

  • CSS classes - Enable users to change the banner color on account pages.
  • Layout - Enable users to use the out-of-the-box banner on account pages.

Note: Only one class can be used at a time.

Using CSS classes to change the banner color

The following table outlines the available CSS classes and the associated hex code color.

Table 1: Class names and related colors
Class to enter in the 'Page contain CSS class' field Hex code
account-banner-bg-color-1 #ffffff
account-banner-bg-color-2 #413d6b
account-banner-bg-color-3 #6b458f
account-banner-bg-color-4 #9b4c81
account-banner-bg-color-5 #ca4d48
account-banner-bg-color-red #d03528
account-banner-bg-color-orange #e98300
account-banner-bg-color-yellow #e8d92d
account-banner-bg-color-green #68bd49
account-banner-bg-color-blue #00a9e0
account-banner-bg-color-purple #413d6b
account-banner-bg-color-mps-1 #007fa8

Do the following to update the account page banner to use a color:

  1. Navigate to a contact account page and enable Easy Edit.
  2. Select Open in Content Designer.
  3. Click the Properties tab.
  4. From the Page contain CSS class field, add the desired class.

  5. Click Save & Publish.

Updating the Layout to use the out-of-the-box banner

The out-of-the-box account pages use a banner that is controlled by a page layout.

Do the following to update the account page to use the out-of-the-box banner:

  1. Go to RiSE > Page Builder > Manage content.
  2. Open the custom account page.
  3. From the Layout drop-down, choose AccountPageBannerOverContent.

  4. Click Save & Publish.
Adding out-of-the-box content to custom account pages

After you start using custom account pages, any new content added to the out-of-the-box account page tabs is not automatically added to your custom account pages.

To add the new content on out-of-the-box account pages to your custom account pages, do the following:

  1. Go to RiSE > Page Builder > Manage content.
  2. Navigate to the out-of-the-box account page tabs:
    • Individuals: @/iCore/Contacts/ContactLayouts/Staff/Tabs
    • Organizations: @/iCore/Contacts/OrganizationLayouts/Staff/Tabs
  3. Open the content record that contains the new content you want to use. For example, if there is content on the Membership tab that you want to use on your Membership account page tab, open the Membership content record.

    4. Note: If you would like to use all content on a tab, copy the entire content record, then paste it in the same location as the other account page tabs.

  4. Find the content item, then click Copy To.

  5. From the Document Browser, navigate to the page you want to move the content to.
  6. Click OK.
  7. Continue that process for each content item you want to use, then close the content record.
  8. Navigate to the page you moved the content to, then open it for edit.
  9. Move the content item around to the desired location, then click Save & Publish.