Learn how to configure the Adopt-A-Stop solution to meet specific needs in your organization.
Publish the Adopt-A-Stop app
The Adopt-A-Stop solution includes an ArcGIS Pro project used to publish the Adopt-A-Stop app. When you are ready to publish the app, a series of tasks are included to help you get started.
Get started
Use the ArcGIS Pro project to familiarize yourself with Adopt-A-Stop.
- Sign in to your ArcGIS organization and browse to the Adopt-A-Stop Project Package.
- Open the item page and click Download.
- Browse to and open the Adopt-A-Stop project.
- On the View tab, in the Windows group, click Catalog Pane.
- In the Catalog pane, expand the Tasks folder, and double-click the Adopt-A-Stop task.
- In the Tasks pane, expand the Getting to Know Adopt-A-Stop task group.
- Double-click Understanding Adopt-A-Stop task to review it.
Configure Adopt-A-Stop
Use the ArcGIS Pro project to set up Adopt-A-Stop.
- In the Tasks pane, expand the Configure Adopt-A-Stop task group.
- Use the Configure Adopt-A-Stop task group to access several tasks that guide you through:
- Load your transit stops into the AdoptAStops feature layer deployed with the solution.
- Set up a user table in ArcGIS Enterprise to store program participants.
- Publish the authentication geoprocessing webtool.
- Configure the Adopt-A-Stop app.
Contact participants
Use the ArcGIS Pro project to configure tools necessary for contacting participants in the Adopt-A-Stop program.
- In the Tasks pane, expand the Contact participants task group.
The Contact participants task group contains tasks to help you contact program participants by sending bulk emails or contacting a selection of participants by local or attribute.
- Follow the task instructions to configure the bulk email model with your SMTP server and contact participants.
Configure the Adopt-A-Stop site
The Adopt-A-Stop solution includes the Adopt-A-Stop ArcGIS Hub site that your organization can configure with your branding and can use to share information about participating in the adopt-a-stop program with the public.
Update with organizational information
After deploying the Adopt-A-Stop solution, the Adopt-A-Stop site layout only requires a few updates to fit your local context. Consider what information you already have and what you can most easily find. This information can include the following:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop site.
- Open the item page and click Configure App.
- Click the edit button
to open the site editor. - Scroll to the Statistics section listed under the title of the website.
The Stops Adopted and Cleaned This Month statistics cards are already linked to the Adopt-A-Stop solution’s AdoptAStops_public feature layer. These stats automatically update as participants adopt stops and report cleanings using the Adopt-A-Stop app.
The Volunteers stat is provided in a text card but styled to resemble the Summary Statistics card; this allows you the option to manually enter a statistic of your choice, independent of the solution data. Update the Volunteers stat card with the number of program participants, a metric of your choice, or replace the text card with a Summary Statistics card and connect it to the AdoptAStops_public feature layer in a similar fashion to the other dynamic stat cards.
- Update the Volunteers card, hover over the card, click the edit pencil
, and then update the text. To add a Summary Statistics card onto the existing row, see Display key metrics section in the Insert charts, tables, and metrics topic. Once the card has been added to the row, hover over the existing Volunteers card and click the delete button 
. - Scroll to the Adopt a Stop section, hover over the card and click the edit pencil.
- Click the Adopt Stop button and click Edit.
- Enter the Adopt-A-Stop app URL published using the Adopt-A-Stop ArcGIS Pro project into the Link Destination text box and click Add Link.
Tip:
Browse to the Adopt-A-Stop app. Open the item page, click View Application, and copy the app URL.
- Scroll to the Frequently Asked Questions section, hover over the card and click the edit pencil, and update the questions and answers.
- On the side panel, click Footer.
A custom footer is already provided, and in most cases, it needs to be updated with your organization's branding, contact information, and social media references.
- Click the HTML text box.
The HTML window appears.
- Make the necessary changes and click Apply.
- Click Save.
Share items with the public
Several layer views, maps and apps included in the Adopt-A-Stop solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Stop site. To share your adopt-a-stop items with everyone, use the guide below and complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop folder.
- Check the check box next to each of the items below:
Item Name Feature Layer (hosted, view)
AdoptAStops_public
Web Map
Adopt-A-Stop
Web Mapping Application
Adopt-A-Stop
Site Application
Adopt-A-Stop
- Click Share.
- In the Share window, click Everyone (public) and click Save.
The Warning: Sharing editable layers publicly message appears notifying you that you are sharing editable layers publicly.
- Click Update.
Deploy related solutions
This site references content from the Transit Outreach solution. To deploy the Transit Outreach solution, follow the steps in the Deploy an ArcGIS Solutions section.
Update solution references
This site references a solution deployed in the previous section. To update your site, complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop site.
- Open the item page and click Configure App.
- Click the edit button to open the site editor.
- Scroll to the Report a Problem section, hover over the card, and click the edit pencil .
- Click the Submit Report button and click Edit.
- Enter the Transit Rider Reporter app URL deployed in the Transit Outreach solution in the Link Destination text box and click Add Link.
Tip:
Browse to the Transit Rider Reporter app. Open the item page, click View Application, and copy the app URL.
- Edit the phone numbers in the Contact Call Center section or remove if not applicable.
- Click Save.
Share items with the public
Several layer views, maps and apps included in the Transit Outreach solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Stop site. To share your transit outreach items with everyone, use the guide below and complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Transit Outreach folder.
- Check the check box next to each of the items below:
Item Name Feature Layer (hosted, view)
TransitRiderReports_public
Form
Transit Rider Reporter
- Click Share.
- In the Share window, click Everyone (public) and click Save.
The Warning: Sharing editable layers publicly message appears notifying you that you are sharing editable layers publicly.
- Click Update.
Adopta widget settings
The Adopt-A-Stop app uses the Adopta widget with preconfigured settings and actions. Optionally, you can modify and expand the Adopta widget’s settings to meet your organization's needs. Use the tables below to understand the Adopta widget's configuration settings and capabilities.
Layer and Authentication settings
The Layer and Authentication settings allow you to configure behaviors as well as the look and feel of the user interface.
| Setting | Description |
|---|---|
Asset nickname field | Field that stores the stop's nickname. |
Login screen message | Message that appears when signing in to the application. |
Additional signup field | Fields in the UserTable to be displayed in the sign up form in addition to email—for example, add first and last name, address, and phone number. |
Show asset address | Display the reverse geocoded address of a stop in the details view. |
Asset highlight color | Color of selection symbol displayed around the stop symbol when it is selected on the map. |
Tolerance setting | New stops are created if no asset is found within the tolerance. |
My asset symbol | Choose a symbol and set the size of user-adopted stops. |
Actions
The primary actions used for the Adopt-A-Stop app are assign (Adopt) and unassign (Opt out). You can configure additional actions as needed.
| Setting | Description |
|---|---|
Assign status settings | Allows you to label the button (Adopt) in the asset detail view and specify additional actions that occur after clicking the assign status button. |
Unassigned status settings | Allows you to configure the unassigned label (Abandoned) in the asset detail view and specify additional actions that occur after clicking the unassigned label. |
Additional status settings | Allows you add additional actions you want adopters to report on—for example, damaged stops. |
Primary Status | Displays text and status buttons in the Adopta application—for example, Is the stop cleaned? |
Before action image | Image that is displayed before performing an action. |
After action image | Image that is displayed after performing an action. |
Messages
The Adopt-A-Stop app displays messages based on user interaction—for example, Thank you for adopting stop name. You can modify the messages or create additional messages according to your organization’s needs.
| Setting | Description |
|---|---|
Assign | Message displayed when an asset is successfully assigned. Use '${assetTitle}', for example, to display the title of asset in message. |
Unassign | Message displayed when an asset is successfully unassigned. |
Action | Message displayed when action is successfully completed. Use '${actionName}', for example, to display the name of action in message. |
Asset not found | Message displayed when asset is not found. |
Asset already assigned | Message displayed when asset is already assigned. Use '${assetTitle}', for example, to display the title of asset in message. |
Unable to perform action | Message displayed when action is not successful. Use ${actionName}, for example, to display the name of the action message. |
Asset creation | Message displayed when creating an asset. Use ${layerName}, for example, to display the name of the layer in message. |
Create asset failed | Message displayed when asset creating fails. |
User token expired | Message displayed when user token is expired and generated. |
Signup/Login success | Message displayed after successful sign up or log in. |
Home screen (when logged in) | Message displayed in widgets home screen after user logs into the application. |
Cursor tooltip before login | Message displayed when the user hovers over the map with their pointer before logging in to the application. |
Cursor tooltip after login | Message displayed when the user hovers over the map with their pointer after logging in to the application. |
Nickname hint | The text displayed in the nickname hint text box. |