February 2022 - Version 3.51
  • 27 Jul 2022
  • 11 Minutes to read
  • Dark
    Light

February 2022 - Version 3.51

  • Dark
    Light

Article Summary

If you have any questions about the release note, please don't hesitate to reach out to us through our support form.

Breaking Changes

The following updates will occur when adding Sessions during the checkout process.

  • If there are no Track values available, the Track filter will not be visible.
  • If there are no Topic values, the Topic filter will not be visible.
  • The Search Bar will be visible only if there are 20 or more Sessions to choose from.
  • The "Clear Filter" option will only be available when a value is selected for that filter.

Enhancements

Event (Admin) Permission Set Update

Permissions associated with the Blackthorn | Events (Admin) Permission Set’s Object Settings have been API enabled and updated to include:

  • Accounts: Read/View
  • Contacts: Read/View
  • Products: Read

Front End

  • Users will now receive an error message when they try to add a Session with a Start Date, End Date, Start Time, or End Time to an Event that is outside of the Event’s Event Start Date, Event End Date, Event Start Time, or Event Start Date.
  • When an Attendee registers for an Event that has the UI Experience set to “Simple”, they will now be able to see the remaining ticket count on the registration page.
  • The UI Experience picklist on the Event Group level now includes “Aspen” and “Maple” in addition to “List” and “Calendar.” When using the Update Picklist button, both the "Maple" UI and “Aspen” UI will be available on all existing customer orgs.
  • The following label and verbiage updates have been made to the Attendee details page.
    • The “Event Start Date” label has been changed to “Event Start Date & Time.”
    • The Check Out button has been changed to Undo Check In.
  • When the UI Experience is set to “Aspen”, the field Event Start Time will show for Ongoing Events when the Event Start Date or Event End Date field are blank.

Back End

Important Update

The Event Item Purchase object and its related fields have been deprecated.

  • A filter component has been added to the Aspen UI filter to allow users to sort Events by distance (geo-location) as well as by date.
  • Users with Event Admin permissions can now add a favicon URL to the new Favicon URL field on the Blackthorn | Events Admin page under the Settings tab. The added favicon URL will be stored in the Event Settings.
  • To prevent users without admin permissions from performing the authorization process, the Authorize button will no longer be visible on the Event page. Non-admin users will not be able to publish an Event until the app has been authorized. They will see the following message, “You need to have the Events Admin Permission Set to authorize the application.”
  • Users can now insert a media player (i.e. BLive, Vimeo) via an embedded iframe in an Event’s custom content (Custom tabs).

Bug Fixes

Front End

  • Extra number formatting has been removed to allow Event Items with a Price above $1000 to display correctly on all user interfaces.
  • To correct accessibility issues that were occurring while using JAWS screen reader, the following changes have been made to the Events landing and detail pages.
    • In the Pick a day filter option, the “End Date” label was added.
    • Instead of residing in an H1 tag, the Event Name, displayed below the date, now resides in a DIV container.
    • The title of a grid such as “Upcoming Events” or “Ongoing Events” now resides in an H2 tag instead of an H1 tag.
  • To improve the user experience when using an accessibility screen reader, a visual indicator will be shown in the “Order Complete“ message and on the “Overview“ tab on mobile navigation menu.
  • After an Attendee successfully registers for an Event, causing the Event to sell out, the Attendee will be redirected to the Event Landing page where a “Sold Out” banner will appear.
  • A Session’s start and end times will reflect the 24-hour clock when the Show 24 Hour Time Format field in Event Settings is set to “Yes”.
  • Sessions will now be sorted by Start Date and Start Time in ascending order. If the Start Date is not available or all the Sessions have the same Start Date and Start Time, the Sessions will be sorted alphabetically by Session Name.
  • Text in an Event’s Description that has been formatted with different font sizes will now display correctly when the Event is viewed from the Event Page URL.
  • Keyword filters, both with a comma and without a comma, that were added to an Event now work correctly when a user is viewing the related Event Group URL.
  • Custom text added to the Pay Later Label field within the Event Settings will now be visible on the Event Registration page instead of the pre-populated text, “Pay Later.”
  • The red border around the Labels component on an Event Group or Event Page will no longer appear when the Data Dictionary Entry Value is " “. This is true at both the Event Level and Event Group Level.
  • The Zoom integration has been updated. This will allow an Attendee to register for a Zoom Meeting or Webinar at the Session level from their AttendeeLink, resulting in a successful registration for both the Session and Zoom meeting.

User Interface

  • When an Event is created without an image, the following will occur:
    • Simple UI: The image placeholder will be hidden.
    • Tabbed UI: The image placeholder background color will be white.
  • After creating several Events and an Event Group with the UI Experience set to “List”, the Date selector on the Event Group landing page will now respond appropriately regardless of the screen size. The Calendar selector will also now cover its own container.
  • When the UI Experience is set to “Aspen” and the Date filter is set to “All dates”, the user will see the Events with current dates in the Ongoing Events section.
  • When the UI Experience is set to “Aspen” and the Date filter is set to “Pick a day”, the user can now filter the Events by any date.
  • After creating an Event with the UI Experience set to “Full-Width” and a Sponsor with Status set to “Declined”, the Sponsor will not be visible on the Event page.
  • In the Full-Width UI, the Country Phone Code and Country fields will be pre-populated correctly based on the user’s location.
  • When viewing an Event overview page in the Tabbed UI via Jaws, the user will now be able to access the “Languages” option on the menu.
  • When the UI Experience is set to “Full-Width” for an Event, and an Event’s organizer’s contact information is included, the user will now be able to contact the organizer via the Contact Us tab.

Checkout

  • If a user performs the checkout process and displays a filter’s values while scrolling, the filter’s values will now move behind the checkout bar.
  • The Event preview now accurately shows what an Event with Sessions will look like. After selecting the correct number of Tickets and checking out, the Review Sessions button will be visible.
  • When the UI Experience is set to “Tabbed”, a fixed Discount Amount will only be applied once at the Event Item level. The discount cannot be applied toward Sessions.
  • In order to add a Guest ticket to an Event during checkout, a Main ticket must be added first. The Guest ticket will remained grayed out until the Main ticket has been added.
  • The following update applies to TouchNet only. If 100% of a discount code is applied to the cost of a paid Event, bringing the total amount due to zero, the remainder of the checkout process will proceed as if the ticket were a free ticket.

Back End

  • The Title field on a Speaker record will now be populated with the information provided on an associated Contact record.
  • When using the new checkout to register for an Event’s waitlist, the default fields, custom fields, and form questions will now populate the fields on the Attendee record correctly.
  • The conditional default value defined in a child Form Element will now populate correctly when a user registers for an Event from the Event Page URL. The conditional values include the Big List Group, Checkbox, Date, Email, Multi-Select Picklist, Number, Picklist, Text, Text (30,000), and URL fields.
  • The Record Type field has been changed to a dropdown to allow users to select the Record Type from a dropdown after the field has been cleared while cloning the Event.
  • To prevent Failed ERS records with the error message “Attendees first name and last name is required.” from occurring, the Event Registration Submission will now process correctly after registering an Attendee via an Event URL, and the Status will be “Completed”.
  • A custom schema for Stripe was added to ensure checkout would be successful when Cashnet and Touchnet are not configured. This update will allow the the Event Registration Submission (ERS) record to be created and processed at checkout correctly.
  • We’ve optimized performance to accommodate larger Big List Group data sizes without issue.
  • The display setting for the Sessions tab was updated to make sure embedded Sessions lists on an iframes display all Sessions available.
  • The Data Dictionary key-value entry search algorithm for Dietary Preferences has been updated to be case insensitive. This change will allow an Attendee’ Dietary Preference values to translate automatically into the configured Event Settings' language selections regardless of capitalization.

Event Wizard

  • Users can now enter a Price with decimals when adding or editing Tickets and Sessions in the Event Wizard.
  • When editing an existing Event using the Event Wizard, only the selected picklist values for a specified record type will now be available to choose from in the picklist.

Scheduled Batch Jobs

  • When the “Batch Event Registration Submission Job” is enabled, and an Attendee is registered via the Attendee Registration Lightning Component, the Registered field on the Event record will automatically update.
  • When Event Auto-Sync is set to “Yes” on a Campaign, and the “EventRegistrationBatchProcess” is scheduled, registered Attendees will correctly sync to the related Campaign as Campaign Members.
  • The EventRevenueRollup batch has been updated to prevent an org from reaching the upper limit and stalling during an Event’s registration process. Attendee registration will now process without any errors, and the ERS will be completed successfully.

Webinar/Zoom Meetings

  • To prevent the Zoom feature on a Mobile iOS device from causing usability issues when making a selection from a Big List Group field, the zoom feature has been removed. This change is only applicable when using the Safari browser on Mobile iOS devices.
  • To require Attendees to enter their name/information before joining a Webinar/Zoom Meeting, the Webinar Registration Failed field (Checkbox) was added and all permission sets were updated. Attendees will now be logged in as a guest attendee, not a co-host.

Field, Object, and Layout Changes

New Fields, Objects, and Layouts

  • The Favicon URL field was added to the Blackthorn | Events Admin page under the Settings tab.
  • The Webinar Registration Failed field (Checkbox) was added, and all permission sets were updated.

Mobile Check-In App

  • After clicking on the Attendee name on the Attendee Listing screen, the user will be taken to the Attendee Details screen. The Attendee Details screen will include the following information: Attendee name, Attendee email, the Event name and start date/time that the Attendee registered for, and an action button for checking in or removing an Attendee.

General Updates

We’ve added a new Apex class to avoid a common cause of confusion around Event authorization in a newly refreshed partial or full sandbox. This class will reset the authorization components in the newly refreshed sandbox so users are aware that authorization has not yet been completed. Users will need to add the BTEventsPostSandboxRefresh class to the sandbox refresh process for this reset capability.

  • The component logos and labels in the Lightning App Builder have been updated to include the new Blackthorn logo and labeling convention.
  • The objects/tabs in Blackthorn's apps have been updated so a unique icon represents each app.
  • A Refer A Friend button has been added to the following admin pages/wizards.
    • Blackthorn | Payments Admin tab
    • Blackthorn | Events Admin tab
    • Blackthorn | Donations Admin tab
    • Blackthorn | Compliance Admin tab
    • Blackthorn | Payments Setup Wizard tab
      The respective admin can click the Refer A Friend button to share a friend's name and email address with Blackthorn.
  • A new user’s license will automatically be applied when the license is authenticated through OAuth during the installation of Payments and Events. This step will streamline the installation process.

Admin Upgrade Instructions

To upgrade Events to the newest version, go to the Blackthorn Candy Shop.

Blackthorn has adopted Salesforce’s managed package installer to simplify the installation process.

Since Payments is already installed, the installer will install Base Package and make sure the correct version of Payments is installed before installing Events.

For step-by-step instructions, click here.

Testing

From now until 02/22/22, the directions below will teach you how to test the new front-end features, enhancements, and bug fixes until they are automatically pushed.

To Do
You will need to replace the Event Page and AttendeeLink URLs 'events.blackthorn.io' domain to a test domain.

TEST DOMAIN: https://preview.events.blackthorn.io/

For example, when you create your attendee, an AttendeeLink URL is generated with the "events.blackthorn.io" domain like this one:

https://events.blackthorn.io/2E12oua7/attendee/ty2W6t9awokrDMaLWi8Mf4sLMedhdrWSBHw6HS7kqVnJ0kKmCK63yl0IxWpbAUBo

You'll then click on the attendee URL so it opens up in a new page. Remove "events.blackthorn.io" and replace it with "preview.events.blackthorn.io" so it looks like this:

https://preview.events.blackthorn.io/2E12oua7/attendee/ty2W6t9awokrDMaLWi8Mf4sLMedhdrWSBHw6HS7kqVnJ0kKmCK63yl0IxWpbAUBo

If you have any questions about this or need help with testing, please don't hesitate to reach out to Blackthorn Support.