CM Maps Route Manager (CMMRM) + Locations (CMML) + PeepSo / BuddyPress - Use Case
Building a Community for Trail Routes and Locations
- Pro version of CM Map Locations + PeepSo Integration (BuddyPress Integration not available). This document uses version 2.5.7 of Map Locations
- Pro version of CM Routes Manager + PeepSo Integration or BuddyPress Integration. This document uses version 4.5.2 of Routes Manager
Introduction
CM Map Locations allows you and your users to create and showcase locations in Google Maps, including images and notes for each. CM Map Routes, in turn, allows you and your users to create and showcase routes in Google Maps, including images and notes for each location.
Both plugins can receive social features by integrating with social platforms. Map Locations can combine with PeepSo and Routes Manager can combine with either PeepSo or BuddyPress.
Use Case Front-End
PeepSo
User Dashboard Locations Tab
Stream With Automatic Update
BuddyPress
User Dashboard
Use Case Assumptions
In this example use case guide, we'll cover how to create social media platforms where users can post and share maps.
We consider that you have already bought and configured the plugins, but not installed the add-ons.
TIP: Still New to Map Locations and Map Routes?
This article focuses on the social platform integrations. If you haven't already created your site with maps, check these guides:
It follows:
- Installing the plugins and add-ons
- Locations and Routes recap
- Initial setup - PeepSo and BuddyPress
- Showing Locations and Routes on PeepSo
- Showing Routes on BuddyPress
Installing The Plugin and Add-on
The process is the same for all CM plugins and add-ons.
- Download the plugin from your customer dashboard
- Log in to WordPress and navigate to the WordPress Admin → Plugins settings
- Click on Add New
- Activate it and add the license
TIP: Automatic Index and Dashboard
Upon installation, the plugin automatically creates a page for the location index and another for the dashboard. Head to Settings → General tab to:
- Find shortcuts to these pages
- Enable or disable them (useful if you want to create your own)
Quick Recap
If you need help with these::
- Perform initial setup (Google Maps API and OpenWeather)
- Adding locations and drawing routes
- Changing visual options
- Configuring user interaction: submit form, who has access, and moderation
- User dashboard
- Custom fields and taxonomies
- Plugin shortcodes
- Translating the plugin interface
Then check the relevant articles:
Initial Setup - PeepSo / BuddyPress
How
What are PeepSo and BuddyPress
Both are free WordPress plugins that allow you to create a social platform similar to Facebook. They are free and provide paid add-ons.
Which Should I Choose?
That depends on your needs. Check their resources:
What Can I Do With The Integrations?
Each WordPress user can be a PeepSo/BuddyPress user. As such, when a user creates a location or route, that content can also be shown on the social platform.
Both platforms have two core features relevant to our plugins:
- User Dashboard - CM Locations and CM Routes add new tabs the user's locations or routes
- Activity Stream - You can enable automatic updates each time a user adds a location/route
How Do I Install Them?
Both BuddyPress and PeepSo can be downloaded from the WordPress back-end. 
Once installed, follow their documentation for the initial setup.
Showing Locations and Routes on PeepSo
1) User Profile: Main Locations / Routes Tabs
These tabs will show all the user's published Locations and Maps.
These tabs can be configured from the first box in the options screen. Inside each, you can enable/disable, set specific settings, and show or hide the "Manage" button.
Tip: Manage Button is Private
The Manage button changes the tab content from the location/routes public list to the action shortcuts.
The button only appears to the currently logged-in user.
2) User Profile: Manage Locations/ Routes Tab
The Admin has the option to add the Manage Locations tab to users' navigation menus as well or instead.
This is done using the following settings:
TIP: Tabs Are Also Private
Similar to the Manage button,The button only appears to the currently logged-in user.
3) Activity Feed
It's possible to have status updates automatically post to a user's profile page and to the activity feed when they create a new Maps Location.
The Settings for the automatic updates for new locations and routes allow for this feature to be simply toggled on or off and also allow for some customization of the template that is used to generate the posts.
4) Profile Widget
PeepSo offers the ability to include a profile widget on any or all posts. With the integrations, it's possible to add a link to the Locations and Route page, or the Manage Locations and Routes pages within this widget
The options also allow to change the icons. In the case of Location, the links depend on the previous options.
Showing Routes on BuddyPress
1) User profile: User's Maps Tab
Show "Maps" tab in the user's profile: Yes or No
If enabled users will see the "Maps" tab in each user's profile that displays the maps created by the specific user.
Show routes parameters: Yes or No
If enabled the routes parameters such as distance, max elevation etc. will be visible on the routes snippets.
Routes snippets layout: List or Tiles
Choose route snippets layout.
Routes featured image: First Route Image or Map Thumbnail
Choose what kind of the routes featured image to display in the user's profile page.
Manage routes under "My Maps" tab: Yes or No
If enabled, the user will see "Manage Maps" tab in his own profile and will be able to manage his routes.
Example
2) User profile: Manage Maps Tab
Show separate "Manage Maps" tab in the user's profile: Yes or No
If enabled, the user will see "Manage Maps" tab in his own profile and will be able to manage his routes.
3) Activity Feed
Create BuddyPress activity when a user created a map: Yes or No
Chose Yes, if you want the add-on to automatically post a new activity when the user adds a new map.
TIP: You Can Use HTML And Placeholders
Example:<strong>[fullname] - user's display name [title] - routes title [permalink] - permalink to the route page [excerpt] - excerpt of the routes description </strong>
4) Groups
It's possible to associate BuddyPress groups with routes.
The settings are:
- Associate group with route - Enable or disable this feature.
- Group privacy - Define who will have access.
Requirement
Note that the group features require the User Groups component to be enabled. This can be configured in Admin Dashboard → Settings → BuddyPress, as shown 
If the settings are proper, you will be able to set the groups when editing the route.
End Result
Following instructions found in the plugin and guides, you and your users should be able to add multiple locations to your site.
Use Case Front-End
PeepSo
User Dashboard Locations Tab
Stream With Automatic Update
BuddyPress
User Dashboard
 |
More information about the CM Map Locations WordPress Plugin Other WordPress products can be found at CreativeMinds WordPress Store |
 |
Let us know how we can Improve this Product Documentation Page To open a Support Ticket visit our support center |