Skip to main content

Dealer Locator

The Dealers Site includes a Dealer Locator feature that allows customers on the Retail site (and the Dealers portal itself) to find authorised dealers by location.

Theme Implementation​

The DealerLocator module (inc/class-dealer-locator.php) customises the label display of the dealer locator taxonomy:

add_filter('suma_dealer_locator_change_term', 'change_terms', 10, 1);

The change_terms() method replaces generic taxonomy labels with dealer-specific text (e.g., "Any Category" → "All Dealers").

Dealer Data​

Dealers are stored as a custom post type or taxonomy term with location metadata:

  • Business name
  • Address (street, city, state, zip, country)
  • Phone and website
  • Dealer category / type

Map Display​

The dealer locator page uses a map widget (integrated via Elementor) that:

  • Queries dealer posts within a specified radius of the user's entered location
  • Pins each dealer on an interactive map (Google Maps integration)
  • Lists dealers in a sidebar with contact details

Adding a New Dealer to the Locator​

  1. Log in to WP Admin.
  2. Navigate to the Dealers custom post type (or the Elementor-managed page for the locator).
  3. Create a new dealer post with name, address, and category.
  4. Publish — the dealer appears on the locator map immediately.

Managing Dealer Categories​

Dealer categories (taxonomy terms) can be managed in WP Admin → Dealers → Categories. The theme's change_terms filter automatically adjusts displayed labels for improved UX.