Skip to main content

Return to TX Community

Liaison

Working with Multiple Communities

Previously, when you enabled Self-Registration across various communities, the setup relied on TargetX code to control the timing of the initial password creation email. This article outlines a new approach that confines the Self-Registration to a single Landing Community. In this setup, email management is handled through standard Salesforce functionality, and access to different communities is granted through the new Landing Page.

Note: If you are unsure which sections to make visible, contact TargetX to help discuss options. If you are a Premier client, work with your Premier team or, if you are not a Premier client, reach out to TargetX Support.

Option 1

This option will disable the Self-Reg and Welcome emails across all Community Sites, excluding the Online Application. Opt for this choice if your communities include only one of the following:

  • Online Application
  • Admitted Student
  • Appointments Communities 

And you do not need a Community to direct Users to multiple Community Sites. Proceed to Option 1 Configuration.

Option 2

This option confines the Self-Registration to a single Landing Community. In this setup, your email management is handled through standard Salesforce functionality, and access to different communities is granted through a new Landing Page. Proceed to Option 2 Configuration.

Note: If you are unsure which option to choose, contact TargetX to help discuss options. If you are a Premier client, work with your Premier team, or if you are not a Premier client, reach out to TargetX Support.

Option 1 Configuration

Step #

Action

Description

1

Update Existing Digital Experiences

In this step, you'll remove the ability for users to Self-Register in each of your existing Digital Experiences:

  1. Navigate to Setup and search for All Sites.
  2. Click Workspaces for the Digital Experience to update.
  3. Select the Administration tile.
  4. Uncheck “Send welcome email”
  5. Select Login & Registration
  6. In the Registration Page Configuration section, uncheck Allow customers and partners to self-register.

2

Configure Emails

You should create distinct email templates for Welcome, Forgot Password and Changed Password and update them accordingly in your Digital Experiences:

  • Create the Welcome Email as your initial contact’ when a student creates an application. This might be what you currently use for your Online Application community.
  • The Change Password Email is used when an internal person resets a user's password.
  • The Forgot Password Email is used when the student initiates the Forgot Password option from the landing page.

Once you've configured your email templates, select them in the Landing Page community/digital experience:

  1. Navigate to Setup and search for All Sites.
  2. Click Workspaces for the Landing Page Digital Experience.
  3. Select the Administration tile.
  4. Select the Emails option.
  5. Check the Send Welcome Email checkbox.
  6. Update the following with your updated Email Templates:
    • Welcome New Member
    • Forgot Password
    • Change Password

3

Update TX_CommunitiesSelfRegConfirm VF page

In this step, you need to remove code from the TX_CommunitiesSelfRegConfirm Visualforce page:

  1. Navigate to Setup and search for Visualforce Pages.
  2. Click on TX_CommunitiesSelfRegConfirm.
  3. Select the Edit button.
  4. Remove the extensions section (extensions="TX_CommunitiesSelfRegConfirmController") from the following line:     

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" expires="0" cache="false" docType="html" controller="TargetX_Base.TX_CommunitiesBase" extensions="TX_CommunitiesSelfRegConfirmController">

  1. Save your changes.

Option 2 Configuration

Step #

Action

Description

1

Create a Landing Page Digital Experience (Community)

This will be the Digital Experience that will be home to a new Portal page. The Portal will include links to your communities based on condition sets.

Item 1: Create New Digital Experience and Configure Site User Permissions 

  1. Navigate to Setup and search for Digital Experiences.
  2. Select All Sites.
  3. Select New.
  4. Choose ‘Salesforce Tabs + Visualforce Theme’ option.
  5. Select Get Started.
  6. Choose a Name for your experience and a URL.

Note: This will be the Name for your Digital Experience and it will be referenced in System Emails. The URL will be unique for each site. You may choose to define the experience site types here (e.g. portal, application, appointments) and even define a specific group (e.g. gradapply, admitportal).

  1. Select Create.

It may take several minutes for the Digital Experience to be created, please be patient.
 

Item 2: Configure Site User Permissions

  1. Select Administration > Pages > Go to Force.com.
  2. Select Public Access Settings.
  3. You will be taken to a new Profile for your Experience, named “<Your Digital Experience Name>+Profile”. This is the GUEST user for your Experience site (i.e. Site User).
  4. Scroll down to the Visualforce Page Access section and add the pages listed in the TargetX Permission Viewer; Online Application (Site User).

Note: ALL communities should use the Online Application (Site User) permission definition, regardless of community type.

  1. Enable the Apex Classes listed in the TargetX Permission Viewer; Online Application (Site User).
  2. Grant the Object Settings permissions listed in the TargetX Permission Viewer; Online Application (Site User). Following the additional guidance regarding record types below:
    • Account Object Settings: enable Administrative and Educational Institution record types.
    • Contact Object Settings: enable Recruitment Manager Student record type.
    • Test Object Settings: enable all Test record types.
    • Payment Connector Object Settings: enable all Payment Connector record types.
  3. To validate permissions, use the TargetX Permission Scanner.
  4. Enable API access by navigating to System Permissions and checking the API Enabled checkbox.
  5. Save all changes as you go.

Item 3: Configure Organization-Wide Defaults for External Users 

Note: If you have already configured a Community, this should already be configured.

  1. Navigate to Setup and search for Sharing Settings.
  2. Under Organization-Wide Defaults click Edit.
  3. Use the following article Recommended sharing settings for Default External Access (Organization-wide Defaults) to complete this step. Update the object access based on all products used.
  4. Navigate to the User Visibility Settings section.
  5. Uncheck: Portal User Visibility.
  6. Uncheck: Site User Visibility.
  7. Click Save.

Item 4: Configure Sharing Rules

  1. Please see the article Creating Sharing Rules to complete this step. Update each listed object based on the site type configured in your org.

Item 5: Create a Theme Template

  1. Navigate to Setup and search for Visualforce Pages.
  2. Click Edit next to the TX_CommunitiesTemplate.

Note: There are two pages with this name; choose the one that does not have a namespace prefix.

  1. Click Clone and name the cloned page, matching it to your Experience site.
  2. Edit the following lines to reflect your institution name:
    1. "header_school" value (e.g. TargetX University)
    2. "header_school_line_1" value ** (e.g. Image: Brown Hall)
    3. "header_school_line_2" value ** (e.g. Image: Students on Lawn)
    4. "header_program" value (e.g. Online Application)

**See below where these values will appear on your landing page. ALL values should be populated for ADA compliance. Consider adding image alt text to header_school_line_1 and 2.

Any values that you do not want to actually display can be hidden later by using css tags in the Community Theme record. See Hiding TX_CommunitiesTemplate Values for further guidance.

Landing Page elements

  1. Locate the following around line 75: 

<apex:outputLink rendered="{!ISPICKVAL($User.UserType,'Guest')}" value="{!$Page.TX_CommunitiesHome}" styleClass="targetx-header-user">

  1. Replace !$Page.TX_CommunitiesHome with the following:

For Experiences using Dynamic Portal:
{!$Site.Prefix}/TX_SiteLogin?startURL=%2FTargetX_Base__Portal

Note: You should maintain the curly brackets that were originally around the replaced text.

  1. Click Save.

Item 6: Create a Community Theme 

  1. From the App Launcher, search and select the Community Themes tab.
  2. Click New.
  3. Enter Theme Name of your choosing (e.g. Appointments, Online Application).
  4. Add the following values:
    1. Template Name: insert the custom TX_CommunitiesTemplate record you created in Step 6.  The format should include a “c__” at the beginning of the page name
      (e.g. “c__TX_CommunitiesTemplatePortal”)

Note: There are 2 underscores after the 'c'' in the above examples. 

  1. Static Resource update the field to TargetX_App__NewResource
  1. Homepage is the name of the Visualforce page that loads after login. Update the field to TargetX_Base__Portal
  1. Header Logo is the logo that appears in the top left corner of the screen in Applicant Dashboard and Events. This is the name of the Static Resource that contains the logo. This should be set for all records, regardless of the TargetX product in use. The size of this image is 70 px x 60 px and is a good size for using a shield or institution mascot. See: Creating a Static Resource.
  2. Header Text Line 1 is the text that appears in the first line of the Header in Applicant Dashboard and Events. This should be set for all records, regardless of the TargetX product in use. We recommend using the School Name.
  3. Header Text Line 2 is the second line of text that appears under the Header. . This should be set for all records, regardless of the TargetX product in use.For example, Application for Admission.
  4. Hero Text is the text that displays over the Hero Image.This is not required and is rarely used.
  5. Hero Image is the name of the Static Resource that contains the hero image, which is a full width image that displays directly below the header. The size of this image is 1336 px x 260 px; this is a different size than that used on the Sign-In page.  This should be set for all records, regardless of the TargetX product in use.
  6. Save your changes.

Recommended Best Practice: Each Digital Experience should have a DISTINCT Community Theme.

Item 7: Configure 'Related Sites' 

Associate each Community Theme record to a Digital Experience site:

  1. Before configuring Related Sites you may need to update your Community Theme Page Layout. If you see the Related Sites tab already on the layout, you can skip to Item 2 below. If you do not see the Related Sites option, proceed here:
    1. Navigate to Setup.
    2. Locate and click the Community Theme object.
    3. Select the Page Layout section.
    4. Select to Edit the Community Theme Layout.
    5. From the page layout palette, select the Related Lists group and then drag the Related Sites item onto the page under the Related Lists section.
    6. Save your changes.
  2. Navigate to the Community Theme record for your new Digital Experience (that you created in Step 7).
  3. Click New Theme Site.
  4. Add a Site Name.
  5. Confirm the Community Theme is auto-populated with the previously created Community Theme record name.
  6. Add the URL of the related Digital Experience. This must be the secure (https) site URL.

To find the URL for your Digital Experience

  1. Navigate to Setup > Customize > Digital Experiences > All Sites.
  2. Locate the Digital Experience you created in the previous steps.
  3. Copy the URL for that record.

 

Item 8: Assign Custom TX_CommunitiesTemplate to Guest Site User

  1. Navigate to Setup and search for Sites.
  2. Click on the Site Label of the Digital Experience.
  3. Select Public Access Settings.
  4. Select Visualforce Page Access.
  5. Click Edit.
  6. Add the custom TX_CommunitiesTemplate (created in Step 6) to the Enabled Visualforce Pages.
  7. Click Save.

Item 9: Set up the Guest User Time Zone

  1. Navigate to Setup and search for Sites.
  2. Click on the Site Label of each Digital Experience.
  3. Select Public Access Settings.
  4. Select the Assigned Users button.
  5. Select edit on the Site Guest User.
  6. Set the timezone to the timezone of the school.
  7. Click Save.

Item 10: Restrict Standard Salesforce Access 

These steps will allow you to prevent a Community User from accessing their information from standard Salesforce pages (e.g., Contact) via the Digital Experience/Community. 

Salesforce states that it is common functionality to be able to reach standard Salesforce pages from the Community.  If you choose not to configure the settings below, your Organization’s security and sharing settings will continue to limit users as expected. TargetX considers it a best practice to follow these steps:

  1. Restrict access to Standard Pages.
    1. Navigate to Setup and search for Sites.
    2. Click on the Site Label of the Digital Experience.
    3. Click Edit.
    4. Uncheck “Allow Access to Standard Salesforce Pages”.
    5. Click Save.

Item 11: Digital Experience Administration Configuration

  1. Navigate to Setup and search for Digital Experiences and then All Sites.
  2. Click Manage or Workspaces next to the Experience to be configured.
  3. Click on the Administration tile.
    Make sure to Save at the bottom of each page.
    1. Preferences
      1. Uncheck “Show nicknames”
      2. Update the Default Owner to the client CRM Administrator
    2. Branding
      1. Header: TXStandardPageStopper (If you cannot locate this document, refer to Downloading the TXStandardPageStopper for instructions to create it.)
    3. Email

Note: Sender Email Address will default to the email of the user who created the community. Work with the client during implementation to update the email address to the appropriate value such as an org wide email address for admissions, advising, etc.

  1. Uncheck “Send welcome email”
  2. Update Forgot Password: TargetX Communities: New Member Welcome Email
  3. Update Change Password: TargetX Communities: Change Password Email
  4. Members (only complete this after you have unchecked the welcome email above)
    1. In Select Profiles, update the Search value to Customer
    2. Move the Customer Community User (TargetX) profile to the Selected Profiles box DO NOT REMOVE THE SYSTEM ADMINISTRATOR PROFILE
  1. Login & Registration
    1. Branding Options
      1. Update the Salesforce logo with your institution’s logo (Administration > Login & Registration > Logo Type/Logo File)
      2. Update the background and login button colors (Administration > Login & Registration > Background/Login Button)

branding options-community

  1. Login Page Setup
    1. Login Page Type: Visualforce Page | TX_CommunitiesLogin
  2. Password Pages
    1. Forgot Password: Visualforce Page | TX_ForgotPassword
    2. Reset Password: Visualforce Page | TX_ChangePassword
  3. Registration Page Configuration
    1. Check “Allow customers and partners to self-register” if this community can create new Contact records. 
    2. Registration Page Type: Visualforce Page | TX_CommunitiesSelfReg
    3. Profile: Customer Community User (TargetX)
    4. Account: Community User Account (If you cannot locate this account, refer to Creating the Community User Account for instructions to create it.)
  4. Pages
    1. Home Page: Visualforce Page | TX_CommunitiesLanding

2

Create a new Portal for the Landing Page 

In this step, you'll create a Portal that will function as the 'Landing Page' for your Digital Experiences. You can make this as simple or as detailed as you wish. Include links to each community and define various sections for your other digital experiences. For details on creating the Portal, see Creating a Portal.

In the example below, each section has a defined Condition Set that determines what a user will see:

  • No Decision Yet displays for any user whose Application Decision does not equal Accepted. The Online Application link directs the user to the Online Application community.
  • Admitted Student Portal displays for any user where Application Decision equals Accepted. The Online Application link directs the user to the Online Application community, where they can review their application or decision information. The Admitted Student Portal links to a Portal with new student information, links to necessary forms, etc.
  • Default has no condition sets defined and will display to any users that don't meet the other criteria. These links direct the user to different Applications your institution offers.TargetX Portal landing page example

3

Update Existing Digital Experiences

In this step, you'll remove the ability for users to Self Register in each of your existing Digital Experiences:

  1. Navigate to Setup and search for All Sites.
  2. Click Workspaces for the Digital Experience to update.
  3. Select the Administration tile.
  4. Uncheck “Send welcome email”
  5. Select Login & Registration
  6. In the Registration Page Configuration section, uncheck Allow customers and partners to self-register:

TargetX Self Register checkbox

4

Configure Emails

You should create distinct email templates for Welcome, Forgot Password and Changed Password and update them accordingly in your Digital Experiences:

5

Update TX_CommunitiesSelfRegConfirm VF page

In this step, you need to remove code from the TX_CommunitiesSelfRegConfirm Visualforce page:

  1. Navigate to Setup and search for Visualforce Pages.
  2. Click on TX_CommunitiesSelfRegConfirm.
  3. Select the Edit button.
  4. Remove the extensions section (extensions="TX_CommunitiesSelfRegConfirmController") from the following line:     
<apex:page showHeader="false" standardStylesheets="false" sidebar="false" expires="0" cache="false" docType="html" controller="TargetX_Base.TX_CommunitiesBase" extensions="TX_CommunitiesSelfRegConfirmController">
  1. Save your changes.

6

Activate the Landing Page Digital Experience

  1. Navigate to Setup and search for All Sites.
  2. Click Workspaces for the Landing Page Digital Experience.
  3. Select the Administration tile.
  4. Select Settings and click the Activate button.

7

Test the Landing Page

  • Log in as a student based on the various condition sets you configured and verify access to the Landing page and available Digital Experiences.
  • Create a new user from the landing page and verify emails are received as expected.

 

 

  • Was this article helpful?