Pre-Install
- Ensure your Campaign object has at least one record type
Install
- Click the following link and go through the standard Salesforce installation process: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t6e000000opcS
Post-Install
- Ensure that you have an object that represents a "ticket", and includes at least the following fields
- first name custom field (text)
- last name custom field (text)
- email address custom field (email)
- lookup field to the Campaign object (lookup)
- attended custom field (checkbox)
- Go to Setup, in the Quick Find box in the upper-left, type "Lightning App Builder" to go to the Lightning App Builder
- On the Lightning App Builder page, click the New button
- For the first step of the "Create a New Lightning Page" process, choose "App Page" and click the Next button
- For the second step of the "Create a New Lightning Page" process, enter for the Label field "Soapbox Engage Check-in" and click the Next button
- For the third step of the "Create a New Lightning Page" process, choose "One Region" and click the Finish button
- On the Lightning App Builder layout page, under the "Custom-Managed" section on the bottom left of the page, drag the "Soapbox Engage Check-in" Lightning component to the "Add Component(s) Here" section of the page layout
- After adding the Soapbox Engage Check-in Lightning component to the new Lightning page, update the parameters on the right side of the Lightning Page Builder screen with the fields you have created for the object in Salesforce that represents tickets for your organization, using the field name that ends with “__c”. Note, if you're using Soapbox Engage's Events app, you won't need to change any of these parameters.
-
To configure the QR Code scanner, in the Scanner Matching Field option, enter the field name that you want the scanner to match on the decoded QR code. For instance, if your QR codes translate to a Soapbox Engage Events App Ticket ID, enter "sbxe1__sbx_SoapboxTicketId__c" in this field. Note: for most organizations using Soapbox Engage's own digital wallet tickets, we recommend using "sbxe1__sbx_SoapboxTicketId__c" as the matching field.
- On the Lightning App Builder page, click the Save button when you've finished making your customizations
- In Setup, in the Quick Find box in the upper-left, type "Tabs" to go to the Tab manager
- On the Tab page, scroll down to the Lightning Page Tabs section, and click the New button
- On the first step of the New Lightning Page Tab page, for the Lightning Page dropdown, select the Soapbox Engage Check-in; for the Tab Label, enter "Soapbox Engage Check-in", and for the Tab Name, use "Soapbox_Engage_Check_in", and click the Next button
- On the second step of the New Lightning Page Tab page, choose the tab visibility you'd like, and click the Finish button.
- In Setup, in the Quick Find box in the upper-left, type "Salesforce Navigation" to go to the Mobile Navigation page.
- On the Mobile Navigation page, move "Soapbox Engage Check-in" from the Available to the Selected column, and make sure to move up the "Soapbox Engage Check-in" tab to be anywhere above the "Smart Search Items" to ensure it appears at the top of the Salesforce mobile app's navigation, and click the Save button.
- For testing purposes, if you don't already have a Campaign that represents an event you'd like to have viewable in the app, create a few Campaign records using the record type(s) you created earlier to represent the Campaigns that you'd want to see in a list of viewable Campaigns in the Soapbox Engage Check-in app
- For testing purposes, if you don't already have a Campaign that represents an event you'd like to have viewable in the app, add a few "ticket” object records, ensuring that each record has at least a first name, last name, email address, and lookup to a Campaign record
- Test on your mobile device by opening the Salesforce mobile app on your mobile device, and click the hamburger (the three horizontal lines in the upper-left) to view your apps, including the Soapbox Engage Check-in app.
- When on the Soapbox Engage Check-in app page, confirm you can view the Campaign(s)
- Click on one of the Campaigns you see in the initial view of the Soapbox Engage Check-in page, and confirm you can see the list of the “ticket” records you’ve created, with first name, last name, and email address displayed
- Try swiping left on one of the ticket records to checkmark the attended checkbox field and having the UX note this by the left side of the ticket now displayed with a green vertical mark
- Try swiping left on the ticket you just checked-in to remove the check-in for that ticket
- Click on one of the tickets to be taken to a detail view of the ticket
- Dance!