Experience Cloud (Communities)

Add the Blackthorn Events Lightning Component to your Experience Cloud to display a list or calendar of Events or a dynamic Event!

This guide assumes you have Experience Cloud set up.

Configure the Blackthorn Events Component

Drag and drop the "BT Events Listing" Lightning Component to a page.

You are now ready to configure any of the following three scenarios.

• List/Calendar View of Events (Event Group) 
• Specific Event
• Dynamic Event URL

Configure a List or Calendar View of Events

The instructions below are for setting up a list or calendar view of an Event Group. The Event Group shows a group of available Events.

1. Define the Event Group.
   Only Events associated to the Event Group will be displayed on the component. To display all Events, leave blank.

2. Set the Category Filter to display Events by type. Example: Conference, Virtual Event, Brunch, etc.

3. For View, select "Calendar" or "List".

4. Specify Height; the default is 500px.

5. The Click Behavior field defines how to open the Event details.

6. Enabling the Show My Events field will allow an Attendee to view the Events they are registered for. If the View = "List", then the user will also be able to filter "My Events" on the Experience Cloud page when Show My Events is checked.

Configure a Specific Event

Only define the Event field.

1. Go to the Event page in Salesforce that you want to post in your Experience Cloud. Click the Event URL link.

2. Grab the last portion of the URL to load a single Event: "test-5a148A1cNyB/overview"
   Here is the full link for reference: https://events.blackthorn.io/en/8AHDeK6/test-5a148A1cNyB/overview

3. Add the last portion (Ex. "test-5a148A1cNyB/overview") to the BT Events Listing on your site's component settings.

Configure a Dynamic Event URL

Use the Dynamic Event URL option to create a static Experience Cloud page that will dynamically load any Event.

1. Open your Experience Cloud in "Builder" mode and click the Settings icon at the top.

2. Click New Page.
   

3. Select a "Standard Page" in the pop-up menu.

4. Add the Blackthorn Events component to the page.

   • Set Event Group = "None"
   • Set View = "List"
     

5. Click your page, and you'll see the URL field. This is used as part of the dynamic URL.
   

6. Now, any Event you want to give to your Attendees is a simple copy and paste. Here is the formatting for the URL to provide:

   • <URL>?event=<event-id>
   • Here is an example URL: https://yourdomain.force.com/s/blackthorn-events?event=a0w3i00000054tW

Our suggestion would be to create the URL in a text formula field on the Event object.

1. Create a text formula field on the Event object.
2. The formula will be: https://yourdomain.force.com/s/blackthorn-events?event= & Id

Register Experience Cloud Users

There are several steps that need to be completed before Experience Cloud users can register. External users need to be able to access your Experience Cloud and have the ability to log in. Salesforce documentation to enable this can be found here.

Once the six steps in the Salesforce documentation have been completed, you are ready to log in as an Experience Cloud user! Experience Cloud users that have login credentials will be able to log in and register for Events.

Register Other Users

When logged into an Experience Cloud, users can now select a number of Tickets for an Event without having to add themselves as an Attendee. The user can then click Register to complete the registration process.

New Field

The Disable Requirement to Add Myself field (checkbox) was added to the BT Event Listing component. The default setting is “True” or checked.

• When Disable Requirement to Add Myself = “False” or unchecked, the user cannot register other Attendees without registering themselves. They must click the Add Myself button.
• When Disable Requirement to Add Myself = "True" or checked, the user does not have to add themselves to register other Attendees.

Note regarding authenticated iframes:

• When a user registers for an Event via the authenticated iframe, the pre-fill functionality only applies to the main Ticket. Guest Tickets will no longer be pre-filled with the logged-in Attendee's information and will not have access to the Add Myself button, regardless of the BT Event Listing’s Disable Requirement to Add Myself setting. 
• When using an authenticated iframe with the BT Event Listing Disable Requirement to Add Myself = "True" (checked), registrants must select a Ticket for themselves. 

Functionality

• If more than one Attendee is registered, they will be added to an Attendee Group.
• Clicking the Add Myself button will pre-fill the registration form for the logged-in user and add one to the quantity after the button is clicked.

Register Non-Experience Cloud Users

You may want to share your Experience Cloud with guests as well as verified users. To do this is simple! Follow these easy steps.

1. From your Experience Cloud builder, navigate to "Settings," and click your Guest User Profile.
   

2. Give the guest user access to the Blackthorn | Events (Community Guest User) permission set.

3. Make sure "Sharing Settings" are defined properly. To do this, navigate to Setup and search for "Sharing Settings". Set all Blackthorn Events Objects to Default External Access = "Public Read Only" or "Public Read/Write".

4. Navigate to "Event Sharing Rules" and click New.

5. Recreate the settings below to allow access to view all Events by default:
   

6. Navigate to "Event Group Sharing Rules" and click New.

7. Recreate the settings below to allow access to view all Event Groups by default:
   

Now all guest users will be able to access the Blackthorn Events Experience Cloud component!

Allow Users to View Your Experience Cloud

The user you assign must have a profile that you assigned to access the Experience Cloud. This will allow them to view the Blackthorn | Events Lightning Component.

This can be found under Communities > Administration > Members > Available Profiles.

Please make sure Experience Cloud users have the following permission sets assigned to them:

For authorized users:

• Blackthorn | Events (Community/Platform User)
• Blackthorn | Payments (Community/Platform User)

or

For guest users:

• Blackthorn | Events (Community Guest User)

Multilingual Events

To control which language is displayed in the Experience Cloud component, go to the Experience Cloud user’s locale settings. This is found under User > Settings > My Personal Information > Language & Time.

When the Events app is embedded in another website (Experience Cloud etc.), the host website is responsible for setting the correct language code for the app. (The language code is in the Events app URL)

This ensures the host can maintain the same language between the host and the Events app. If the host doesn’t set a language for the Events app, the language will match the source language, and there will be no translation.

Use Cases:

• A specific language will load in the Events app. 
• The Events app’s language will follow the language of the host. In this case, the host has a language selector, and the Events app’s language will match the language of the host.

Testing

There are two ways to test the Experience Cloud component for users. You can log in via the Contact, or sign in directly to the Experience Cloud with the user's login credentials.

Option 1: Navigate to the Contact record and click Log in to Experience as User.

Option 2: Log in to your Experience Cloud using the user's login credentials.

1. Click on the Event you want to register for.

2. Click Add Myself.

3. You will see all contact information pre-filled into the Attendee Form!
   

4. If Show My Events is enabled from "Configure a List or Calendar View of Events" Step 6 for the Configuration in Experience Cloud, an Attendee will be able to view all the Events they are registered for by clicking the "Heart" icon in the categories section.

In this example, the Attendee has registered for "SDO - Blackthorn Conference," notice the heart icon is full.

The following image shows all the Events the Attendee is eligible to register for. Notice the heart icon is empty.

FAQ:
Q: My Events aren't showing the changes I make in Salesforce; what gives?
A: Salesforce Communities + Blackthorn takes some time to clear the cache and update the Event. Please wait approximately 15 minutes for this to happen. Please note, that using the Publish button in this scenario will not manually refresh the cache.

Q: My Redirect URL is not working in the Experience Cloud component.
A: To fix this, add the redirection domain to CSP Trusted Sites on Salesforce (Setup > Security > CSP Trusted Sites). The redirection domain should have relaxed CSP rules or the parent domain (in this case https://*.force.com - for Experience Cloud) needs to be added to the frame-ancestor rule.

FAQ

Q: Can I use a discount Code in the Experience Cloud?

A: Yes, you can use discount Codes in the Experience Cloud if the following criteria are met.

• A user logged into an Experience Cloud site as a Contact related to an Account can apply a discount Code if... 

  • The Account is related to a discount Code.

  • The Code’s Restrict To Account field is set to “True.”

• A user logged into an Experience Cloud site as a Contact related to an Account cannot apply the discount Code if... 

  • The Account is NOT connected to a discount Code.

  • The Code’s Restrict To Account field is set to “True.”