The User Directory feature provides an easy way to search and chat with users. This topic explains how to add the user directory feature, which gives you the ability to:
- Search for user profiles
- Hold user contact information
- Initiate chats with users
- Provide a leaderboard with badges
- Add a sense of gamification to your app
Add the User Directory feature
Adding the User Directory feature involves locating and adding the plug-in, and then configuring the plug-in.
Follow these steps:
- In the main menu, click App Components > My Features, then click the Add a new feature button.
2. The Marketplace page will appear. On the plug-ins page, enter “user directory” in the search field at the top. Learn more about adding features in How to Create and Enable Features in Your Marketplace App.
3. Click the + button in the User Directory box.
4. The User Directory configuration page will appear.
Configuring the User Directory feature
The User Directory feature contains a number of tabs that you can configure, including:
To automatically provide users with access to this feature, click the Auto enlist all users toggle at the very top of the page.
If you’d rather restrict usage of this feature to users with specific tags, enter those tags in the Only allow users with the following tags field.
Add user actions here. For more information, see the article How to Create Action Items with the Action Builder.
You can configure the user directory to display badges that correspond to tags that you add to this section.
NOTE: To ensure that your badges appear properly in your app, submit 80 x 80 pixel images. The badges render at a minimum of 18 x 18 pixels.
Add a badge to the user directory by doing the following:
- Enter a Badge Name.
- Enter a Tag.
- Enter a Tag Count. Sorting by the tag count will sort the user directory on users according to the number of total tags (not the number of unique tags). It’s important to understand the difference, since a user can earn the same tag multiple times
- Click the + Add button to add the badge.
New Badge Push Notifications
Click the toggle to send a push notification to directory members when someone receives a new badge.
From the drop-down, choose the option that matches your preferences for the sorting of the user directory.
You can require that a user must login to use this feature. By requiring a login, a user must first create an account to access this feature. Optionally, you can restrict access only to users that have specific. See User Management and Tagging article for more information.
Follow these steps to restrict the use of this feature to a user that is logged in to your app:
- To require a user login, check the Require Login box.
- Check the Require Tags box. This will require that a user is logged in and has at least one tag that corresponds to the tags you enter in the Required Tags section.
- In the Give Access When drop-down, choose whether you want to enforce that Users Match Any Tag or Users Match All Tags.
- Specify the tags you want to enforce in the Required Tags section.
With tagging, a tag is applied to any user that opens this feature in your app. In the User Management page, you can see a list of each time a tag has been applied to each user. Tagging can be useful in hiding and showing content—or sending custom push notifications to various user segments. See the User Management article for more information.
To add a tag, enter the tag in the Tag Title field and click the Add Tag button.
NOTE: Before setting up your in app purchases, go to the Commerce page and setup your products and/or subscriptions. See the User Management article for more information, see the How To Apply An In-App Purchases & Subscriptions the article.
Follow these steps if you want to provide this feature only to users who make a purchase:
- Check the Require Purchase box.
- Choose either Single purchase or Subscriptions as the minimum requirement (that will apply to all users).
- You can add an image to the carousel, which will show preview of the functionality for this feature (a visual aid that indicates how to use this feature). To add an image, click the Add Image button to display the Add Media popup window. You can search for an image in the My Images library, or click on an image in the panel. To upload a new image, click the Browse Images to Add button and choose an image from your computer. Click the Insert Images button to commit your changes.
6. Enter the Promotional Text that invites the users to make a purchase.
7. Choose a Product Name. Products in this list are taken from the entries that have been made in the Commerce > Purchase page.
8. Enter the Success Message that will appear after the user makes a purchase.
9. Enter the Error Message that will appear if there is a problem during a purchase.
10. Other Actions: The Action Builder enables you to link to a variety of different actions such as linking to app content, websites, phone numbers, and more. Learn more in the article, How to Create Action Items with the Action Builder.
You’ll find analytics information on this tab. With Analytics, you can:
- See which plugins have the highest amount of visits
- See how much through traffic a plugin has had for the last 30 days
- See how much through traffic a plugin has had for the last 60 and 90 days
- See which users have used that plugin the most. NOTE: Use this knowledge to incentivize those users to bring more users to your app through rewards.
- See what time and date a user has accessed the plugin as well as if they’re using an Android phone or an iPhone
For more information, see Plug-in Analytics article.
In the Language tab, you can edit some of the phrases that have been hard-coded into the app. BuildFire does not automatically translate these phrases. If you are building your app in a language other than English, feel free to use this feature to manually translate these phrases. Learn more in the article, What is the Language Settings Tab?
This tab is a bit different for this plugin. These are the dialog categories that appear in this tab for the User Directory plugin:
- Join - Title, Message, Cancel Button, and Confirm Button
- Leave Dialog - Title, Message, Cancel Button, Confirm, and Button
- Information Messages - Added to favorites, and Removed from favorites
- Other - Message User, Open My Profile, Add to Favorites, Remove from favorites, Report User*, Leave User Directory, Search, and Favorites
NOTE: To enable the Abuse feature (next section), you must enter a value in the Report User field of the Other section.
A user can report abuse that s/he observes. As an administrator, you can view these reports to see who reported the user, which user was reported, the reported date along with the reason. Administrators can also Mark as Resolved to remove the abuse report.
If Report User is turned on in language settings. Users have the ability to report other users based on these items:
- Inappropriate Profile Image
If you have any questions, please reach out to Support@BuildFire.com and we would be happy to further assist you!