Broadfence Locations

Broadfence Locations is a WordPress plugin for managing location-based BroadFence content, delivery pages, visitor location detection, maps, and location-specific product/testimonial displays.

Features

• Registers custom post types for countries, states/provinces, cities, testimonials, and projects.
• Groups location post types under a Locations admin menu.
• Adds meta boxes for country, state, city, project, banner, and testimonial data.
• Provides plugin-backed single templates for country, state, and city location pages.
• Adds a Broadfence Locations page template.
• Tracks visitor location by IP and stores/update location data in custom database tables.
• Captures missing /locations/... city URLs as requested cities for admin review.
• Creates approved requested cities from a configured template city.
• Displays HERE Maps-based location, project, and route maps.
• Supports WooCommerce product selections for United States and Canada location pages.

Shortcodes

• [bf_header_location] - Displays the location/shipping selector.
• [bf_location_metadata] - Displays location metadata.
• [bf_location_map] - Displays the location map.
• [bf_location_listings] - Displays location listings.
• [bf_location_testimonial] - Displays a selected location testimonial.
• [bf_project_map] - Displays project map data.
• [bf_location_products] - Displays location-specific WooCommerce products.
• [bf_route_map] - Displays a regional delivery route map.
• [bf_city_availability] - Displays city availability messaging.
• [bf_header_text] - Displays dynamic location header text.
• [american_notice] - Displays the Made in America notice for United States visitors or URLs.
• [bf_location_cities] - Displays related location cities.

Requirements

• WordPress.
• WooCommerce for product selection/display features.
• HERE Maps API key for maps and postal-code geocoding.
• Outbound HTTP access for HERE Maps scripts/API calls and IP lookup.

Installation

1. Upload the broadfence-locations folder to wp-content/plugins/.
2. Activate Broadfence Locations from the WordPress Plugins screen.
3. Save permalinks once after activation so custom location rewrite rules are flushed.
4. Configure countries, states/provinces, cities, projects, testimonials, and product settings from the Locations admin menu.

Data Created On Activation

The plugin creates two custom database tables:

• wp_broadfence_locations - Stores visitor IP/location lookup data.
• wp_broadfence_req_cities - Stores requested city URLs captured from missing location pages.

Notes

• The plugin loads HERE Maps from https://js.api.here.com/v3/3.1/.
• The current template city ID is defined by the CITY_ID constant in broadfence-locations.php.
• The HERE API key is defined by the HERE_API_KEY constant in broadfence-locations.php.