Communities
  • 27 Feb 2024
  • 6 Minutes to read
  • Dark
    Light

Communities

  • Dark
    Light

Article Summary

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

This guide assumes you have Salesforce Communities set up.

Unsupported Template(s)

Please note, at this time, the "Build Your Own (LWR)" template is not supported.


Sharing Settings

Please make sure Blackthorn Event and Event Group objects have Default External Access = "Public Read Only" or "Public Read/Write". If Sharing Settings are set to "Private", the Event page will not render in the Community.


Custom Community Domains

If you currently have a custom domain for a Community, you will need to allowlist the domain before the component will load. Please navigate to CSP Trusted Sites in Salesforce Setup to add your site name and URL (Trusted Site URL = Community URL).

Communities 1

Configure the Blackthorn Events Component

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

configure events component 1

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

Lightning Locker

If the Blackthorn Events community component is grayed out, it is because your lightning locker is not enabled. To enable lightning locker, please navigate to:

Community > Settings > Security > Switch on Lightning Locker.

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. The user will also be able to filter "My Events" on the community page when Show My Events is checked.

configure list or calendar view

Configure a Specific Event

Only define the Event field.

  1. Go to the Event page in Salesforce that you want to post in your Community. Click on 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 Community page that will dynamically load any Event.

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

  2. Click New Page.
    configure dynamic event url 1

  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"
      configure dynamic event url 2
  5. Click your page and you'll see the URL field. This is used as part of the dynamic URL.
    configure dynamic event url 3

  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 Community Users

There are several steps that need to be completed before Community users can register. External users need to be able to access your Community 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 a Community user! Community users that have log in credentials will be able to log in and register for Events.

Register Other Users

When logged into a community, 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.

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.
Important

This setting does not remove the restriction that the user must buy a “main event ticket” to buy a guest ticket. The change is that the “main event ticket” does not have to be for the logged-in user.

Register Non-Community Users

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

  1. From your Community builder, navigate to "Settings" and click on your Guest User Profile.
    register non community users 1

  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 have 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:
    register non community users 2

  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:
    register non community users 3

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

Allow Users to View Your Community

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

This can be found under Communities > Administration > Members > Available Profiles.
allow users to view your community 1

Please make sure Community 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 Community component, go to the Community user’s locale settings. This is found under User > Settings > My Personal Information > Language & Time.

When the Events app is embedded in another website (community 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, there is a language selector on the host and the Events app’s language will match the language of the host.

Testing

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

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

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

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

  2. Click Add Myself.Events_Communities_PROD1422

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

  4. If Show My Events is enabled from "Configure a List or Calendar View of Events" Step 6 for the Configuration in Community, 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.
testing 4

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

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 Community 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 communities) needs to be added to the frame-ancestor rule.

FAQ



What's Next