Campaign Portal: Expert Configurations

In the latest release, we’ve streamlined cAdmin’s Campaign Portal Configurations to enhance user-friendliness. Key features include customizing Campaign Portal navigation labels, meeting details, directions, links, images, and the visibility of activities tailored to specific user personas, allowing for quicker and more efficient administration aligned with your campaign needs.

In the latest release, we’ve streamlined cAdmin’s Campaign Portal Configurations to enhance user-friendliness. Key features include customizing Campaign Portal navigation labels, meeting details, directions, links, images, and the visibility of activities tailored to specific user personas, allowing for quicker and more efficient administration aligned with your campaign needs.

How to Configure Portal Campaigns and Tasks

1. In cAdmin, go to Configuration > Site Configuration, then click Campaigns. Only users with the roles of Association Administrator, Distributor Administrator, Association Team Leader, or Distributor Team Leader have access to the Configuration tab.

2. Scroll to DashBlockTemplate_Messages or DashBlockTemplate_Tasks and verify that at least one activity type is assigned. If these configurations are missing, click Add New Configuration, copy and paste one of the configurations mentioned above, and save it. This ensures that the Messages (Campaigns) or Tasks tabs are visible on the Portal for users with the assigned activity type.
Note: Qualifier 1 represents the Campaign’s “Internal name,” which is hidden by default on the Campaigns dashboard. To display it, click the gear icon and enable “Internal name.” Do not add extra qualifiers for Messages or Tasks, as Qualifier 1 alone is sufficient.

3. Navigate to Settings > Workflow Applications > cPortal, and choose either the Tasks or Messages (Campaigns) tab to modify. Here, you can update the tab’s Navigation label, Instructions text (with links and images), and Sidebar content.

4. To update the fields displayed on the Portal card, return to Configuration > Site Configuration > Campaigns and navigate back to DashBlockTemplate_Messages or DashBlockTemplate_Tasks, and select one of the assigned activity types.
• Note: As mentioned, no additional qualifiers other than Qualifier 1 are necessary for Messages or Tasks.

5. Add the fields in the order in which you’d like them to appear on the portal. Use the following formatting in the Option Value field to display the desired information:

Example Fields with Formatting:
The dollar signs ($$) represent cAdmin fields pulled into the Portal, and the text between <propertyTitle> tags are custom labels that will appear on the Portal.

Header Example:
<header>#$$SessionNumber$$ - $$SessionTitle$$</header>

Field Example:
<property><propertyTitle>Session Date: </propertyTitle><propertyValue>$$SessionDate$$</propertyValue></property>

Full Example:

<header>#$$ControlNumber$$ $$PublishingTitle$$</header>
<property>
<propertyTitle>Your Role: </propertyTitle>
<propertyValue>$$Role$$</propertyValue>
</property>
<property>
<propertyTitle>Activity Type: </propertyTitle>
<propertyValue>$$RecipientActivityTypeName$$</propertyValue>
</property>
<property>
<propertyTitle>Session: </propertyTitle>
<propertyValue>$$SessionNumber$$ - $$SessionTitle$$</propertyValue>
</property>
<property>
<propertyTitle>Session Date: </propertyTitle>
<propertyValue>$$SessionDate$$</propertyValue>
</property>
<property>
<propertyTitle>Session Time: </propertyTitle>
<propertyValue>$$SessionStart$$ - $$SessionEnd$$</propertyValue>
</property>
<property>
<propertyTitle>Session Location: </propertyTitle>
<propertyValue>$$SessionLocation$$</propertyValue>
</property>
<property>
<propertyTitle>Presentation Time: </propertyTitle>
<propertyValue>$$SessionRoleStart$$ - $$SessionRoleEnd$$</propertyValue>
</property>
<property>
<propertyTitle>Presentation Number: </propertyTitle>
<propertyValue>$$PresentationNumber$$</propertyValue>
</property>
<property>
<propertyTitle>Poster Board Number: </propertyTitle>
<propertyValue>$$PosterboardNumber$$</propertyValue>
</property>
<property>
<propertyTitle>Program Status: </propertyTitle>
<propertyValue>$$ProgramStatus$$</propertyValue>
</property>
<property>
<propertyTitle>Session Role Status: </propertyTitle>
<propertyValue>$$SessionRoleStatus$$</propertyValue>
</property>
<property>
<propertyTitle>Campaign Response Status: </propertyTitle>
<propertyValue>$$CompleteStatus$$</propertyValue>
</property>
<property>
<propertyTitle>Campaign Response Value: </propertyTitle>
<propertyValue>$$ResponseAction$$</propertyValue>
</property>
<property><propertyTitle>Author Block: </propertyTitle><propertyValue>$$PresentationBlock$$</propertyValue></property>
<property><propertyTitle>Disclosure Block: </propertyTitle><propertyValue>$$DisclosureBlock$$</propertyValue></property>
<property><propertyTitle>Primary Author Name: </propertyTitle><propertyValue>$$PresentingAuthor$$</propertyValue></property>
<property><propertyTitle>Role Duration: </propertyTitle><propertyValue>$$PresentationDuration$$</propertyValue> mins</property>
<property><propertyTitle>Submission Topic: </propertyTitle><propertyValue>$$ControlTopic$$</propertyValue></property>
<property><propertyTitle>Abstract Body: </propertyTitle><propertyValue>$$AbstractBody$$</propertyValue></property>

6. Test the configuration by selecting the Campaigns tab within cAdmin, choosing the configured campaign, and entering a test control number. Preview the changes in the Messages or Tasks tabs within the Portal by shadowing a test user. Refresh the Portal page after each cAdmin config update and adjust the fields to achieve the desired layout.

1 – New Portal Configurations

As a meeting organizer or configuration analyst, I frequently use cAdmin to adjust various settings within the Portal, including navigation labels, meeting details, directions, links, images, and the visibility of activities tailored to specific user personas. Previously, this task was more time-consuming due to the presence of many hidden options. However, with our latest release in May 2024, we’ve streamlined the process, significantly enhancing user-friendliness for administrators.

As a meeting organizer or configuration analyst, I frequently use cAdmin to adjust various settings within the Portal, including navigation labels, meeting details, directions, links, images, and the visibility of activities tailored to specific user personas. Previously, this task was more time-consuming due to the amount of options. However, with our latest release, we’ve streamlined the process, significantly enhancing user-friendliness for administrators.

New Portal Configurations Location in cAdmin

The configuration interface is organized under Settings > Workflow applications > cPortal, mirroring the layout of the Portal itself.

• The Meeting information tab serves as the homepage for the meeting Portal, with each field corresponding to a section on the Portal’s homepage. For instance, the Navigation label represents the tab name, and below are the Meeting information instructions, Meeting info page content, and Sidebar content for meeting info page.

New Listing Template Fields for Portal Presentations, Tasks and Messages in Portal (dashblocktemplate)

Header text format example for cAdmin:

<header>#$$SessionNumber$$ - $$SessionTitle$$</header>

Field text format example for cAdmin:

<property><propertyTitle>Session Date: </propertyTitle><propertyValue>$$SessionDate$$</propertyValue></property>

New fields:
• Session # and Title – $$SessionNumber$$ – $$SessionTitle$$
• Session Date – $$SessionDate$$
• Session Start – Session End Time – $$SessionStart$$ – $$SessionEnd$$
• Session Location – $$SessionLocation$$
• Session Role Start & End Times – $$SessionRoleStart$$ – $$SessionRoleEnd$$
• Presentation Duration – $$PresentationDuration$$
• Presentation Number – $$PresentationNumber$$
• Poster Board Number – $$PosterboardNumber$$
• Control-level Topic1 – $$ControlTopic$$
• Author Block – $$PresentationBlock$$
• Disclosure Block – $$DislcosureBlock$$
• Primary Author Name – $$PresentingAuthor$$
• Submission Topic – TBD

Other currently available fields:
$$ControlNumber$$
$$FullControlNumber$$
$$PublishingTitle$$
$$CompleteStatus$$
$$ProgramStatus$$
$$ActivityName$$
$$SessionNumber$$
$$SessionTitle$$
$$SessionID$$
$$SessionRoleStatus$$
$$SessionLocation$$
$$SessionStart$$
$$SessionEnd$$
$$SessionRoleStart$$
$$SessionRoleEnd$$
$$PresentationDuration$$

Configuring Listing Template Portal Fields

1. Navigate to Settings > Workflow Applications > cPortal. Then, select the tab you wish to modify the display fields for, such as Presentations.

2. Locate the Listing template and input the desired Option Value:

<header>#$$ControlNumber$$ $$PublishingTitle$$</header>
<property>
<propertyTitle>Session: </propertyTitle><propertyValue>$$SessionNumber$$ - $$SessionTitle$$</propertyValue>
</property>
<property><propertyTitle>Location:</propertyTitle><propertyValue>$$SessionLocation$$</propertyValue></property>
<property><propertyTitle>Session Start/End: </propertyTitle><propertyValue>$$SessionStart$$ - $$SessionEnd$$</propertyValue></property>

Try It Yourself

For other cAdmin fields listed above, copy and paste one of the lines of code and replace the two field values with the appropriate placeholders, such as “Presenter:” for the label and “$$PresentingAuthor$$” to pull the cAdmin field:

<property><propertyTitle>Presenter: </propertyTitle><propertyValue>$$PresentingAuthor$$</propertyValue></property>

Old Site Config vs. New Portal Settings

For those familiar with the old configuration method, you’ll find all the updated Portal configurations listed in the table. If users try accessing the old Site Configurations from their prior location and click the Option Name link, they’ll be redirected to the new Portal Settings configuration page. However, it will only direct you to the first tab, irrespective of your original tab within Portal Settings, necessitating an additional click.

A configuration NOT listed in the table below is still accessible under Configurations > Site configurations.

Verify Staff Roles

To access the Site configurations page, cAdmin users must hold at least one of the specified staff roles:
• Association Administrator
• Association Team Leader
• Distributor Administrator
• Distributor Team Leader

Users with these roles in cAdmin can verify their own or others’ roles within their association by navigating to Settings > Association info & administration > Staff accounts.

Advanced Configuration Note

Starting May 2024, if you plan to apply an activity qualifier to any tab on the Portal, you must currently use the old configuration method in Site Configurations. This qualifier will overwrite the new field labels in the Portal Settings.

Portal Settings TabOld Site Configuration Category and NameNew field label
Meeting informationADMIN / DashModuleDisplayName_MeetinginfoNavigation label
ADMIN / MeetingHeaderBackgroundColorPortal header background color (meeting level)
ADMIN / DashHideDisclosureLinkHide the centralized disclosure link in the portal homepage
ADMIN / DashSiteHeaderImagePortal header image URL (meeting level)
ADMIN / DashMsgText_MeetingInfoMeeting information instructions
ADMIN / DashMeetingInfoMainContentTextMeeting info page content
ADMIN / DashRightNavText_MeetingInfoSidebar content for meeting info page
SubmissionSUBMIT / DashModuleDisplayNameNavigation label
SUBMIT / DashHideGraphsHide summary graphs
SUBMIT / DashChartEntityNameTop-chart- label of completion status
SUBMIT / DashHideDisclosureLinkHide the centralized disclosure link in the submissions page
SUBMIT / DashExcludeDisclosureCheckForActivitiesCentralized disclosure NOT mandatory for these activities
SUBMIT / BlockActivityDisplayHide activities
SUBMIT / DashMsgTextInstructions text
SUBMIT / DashRightNavTextSidebar content
SUBMIT / DashBlockTemplateListing template
Abstract ReviewREVIEW / DashModuleDisplayNameNavigation label
REVIEW / DashHideGraphsHide summary graphs
REVIEW / DashChartEntityNameTop-chart- label of completion status
REVIEW / DashHideDisclosureLinkHide the centralized disclosure link in the review page
REVIEW / DashExcludeDisclosureCheckForActivitiesCentralized disclosure NOT mandatory for these activities
REVIEW / DashMsgTextInstructions text
REVIEW / DashRightNavTextSidebar content
REVIEW / DashBlockTemplateListing template
Session builderSESSIONS / DashModuleDisplayNameNavigation label
SESSIONS / DashHideGraphsHide summary graphs
SESSIONS / DashChartEntityNameTop-chart- label of completion status
SESSIONS / DashHideDisclosureLinkHide the centralized disclosure link in the sessions submissions page
SESSIONS / DashExcludeDisclosureCheckForSessionTypesCentralized disclosure NOT mandatory for these session types
SESSIONS / DashMsgTextInstructions text
SESSIONS / DashRightNavTextSidebar content
SESSIONS / DashBlockTemplateListing template
Session submissionSUGGESTEDSESSIONS / DashModuleDisplayNameNavigation label
SUGGESTEDSESSIONS / DashHideGraphsHide summary graphs
SUGGESTEDSESSIONS / DashChartEntityNameTop-chart- label of completion status
SUGGESTEDSESSIONS / DashHideDisclosureLinkHide the centralized disclosure link in the sessions submissions page
SUGGESTEDSESSIONS / DashExcludeDisclosureCheckForSessionTypesCentralized disclosure NOT mandatory for these session types
SUGGESTEDSESSIONS / DashMsgTextInstructions text
SUGGESTEDSESSIONS / DashRightNavTextSidebar content
SUGGESTEDSESSIONS / DashBlockTemplateListing template
Session leadersPortal setting for session leaders remains unchanged. Previously configurable here.
PresentationSUBMIT / DashModuleDisplayName_PresentationNavigation label
SUBMIT / BlockActivityDisplay_PresentationHide activities
SUBMIT / DashMsgText_PresentationInstructions text
SUBMIT / DashRightNavText_PresentationSidebar content
SUBMIT / DashBlockTemplate_PresentationListing template
CME reviewPortal setting for CME review remains unchanged. Previously configurable here.
BoothBooth remains unchanged. Previously configurable here.
Notification – TasksNOTIFICATION / DashModuleDisplayName_TasksNavigation label
NOTIFICATIONS / DashChartEntityName_TasksTop-chart-label of completion status
NOTIFICATION / DashHideGraphsHide summary graphs (shared with Messages)
NOTIFICATION / DashHideDisclosureLink_TasksHide the centralized disclosure link in the tasks page
NOTIFICATION / DashMsgText_TasksInstructions text (top of page)
NOTIFICATION / DashRightNavText_TasksSidebar content
NOTIFICATION / DashBlockTemplate_TasksListing template
Notification – MessagesNOTIFICATION / DashModuleDisplayName_MessagesNavigation label
NOTIFICATIONS / DashChartEntityName_MessagesTop-chart-label of completion status
NOTIFICATION / DashHideGraphsHide summary graphs (shared with Tasks)
NOTIFICATION / DashHideDisclosureLink_MessagesHide the centralized disclosure link in the messages page
NOTIFICATION / DashMsgText_MessagesInstructions text
NOTIFICATION / DashRightNavText_MessagesSidebar content
NOTIFICATION / DashBlockTemplate_MessagesListing template

Field labels such as “Allow QR code access key login” can be found in the Glossary on the left side of the Portal Settings page.

Save Configurations in the Library for Later Use

To save configurations for future use, especially around meeting deadlines or future meetings, follow these steps:

1. Copy the appropriate old configuration name from the chart above that matches the new Portal name.
2. Navigate to Configuration -> Site configuration.
3. Select the correct tab (e.g., SUBMIT). Click on ADD NEW CONFIGURATION.
4. Paste the old configuration name (e.g., DashMsgText_Presentation_DeadlineSOON).
5. In this example, the suffix “_DeadlineSOON” will save this configuration in the library, allowing you to copy and paste it later during the meeting.