Introduction to CP Locations

Last updated

CP Locations is a WordPress plugin that helps multi-campus churches manage and display their locations with interactive maps, service times, and location-specific content.

What CP Locations Does

CP Locations provides everything you need to showcase your church’s campuses:

  • Interactive Location Finder — A map and list view powered by Leaflet and React that visitors can use to browse locations, search by zip code, or use their current location to find the nearest campus
  • Service Time Management — Add multiple service times per location with day, time, and special service designations
  • Location Details — Store and display address, phone, email, pastor, and custom subtitle for each campus
  • Automatic Geocoding — Addresses are automatically converted to map coordinates via MapBox
  • Shortcodes — Embed the location finder or display individual location details anywhere on your site

Key Concepts

  • Location — A custom post type representing a physical campus. Each location stores an address, contact information, service times, and a featured image.

  • Location Finder — The interactive frontend display (map + list) that visitors use to browse and search locations. Powered by a React app with Leaflet maps.

  • Geocoding — The automatic conversion of a street address into map coordinates (latitude and longitude). CP Locations uses MapBox for geocoding.

  • Service Times — Repeatable entries on each location for day, time, and description. Grouped by day for display (e.g., “Sundays at 9:00am and 11:00am”).

    How It Works

Each location is a custom post type with fields for address, contact information, and service times. The plugin automatically geocodes addresses using MapBox and serves location data through a REST API that powers the frontend map and list display.

Visitors interact with the location finder through the [cp-locations] shortcode, which renders a responsive map on desktop (with a sidebar list) and a mobile-optimized view with a sliding panel.

Integration with Other Plugins

CP Locations works with:

  • The Events Calendar — Add a location filter to the calendar filter bar

Next Steps

Continue to Installation to get started with CP Locations.

Using CP Locations?

Back to CP Locations Still stuck? Contact support