Adds OpenStreetMap support, marker coordinates and icons, map controls, and multilingual shortcode options.<\/p>","1.2.1":"
Bundles map libraries locally and updates plugin compatibility metadata.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3765171,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3765171,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["v.1.2.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3765171,"resolution":"1","location":"assets","locale":"","width":1268,"height":858},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3765171,"resolution":"2","location":"assets","locale":"","width":1675,"height":860},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3765171,"resolution":"3","location":"assets","locale":"","width":1408,"height":803},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3765171,"resolution":"4","location":"assets","locale":"","width":1627,"height":810}},"screenshots":[]},"plugin_section":[],"plugin_tags":[154986,351,2909,2660,16164],"plugin_category":[49],"plugin_contributors":[288520],"plugin_business_model":[],"class_list":["post-390993","plugin","type-plugin","status-publish","hentry","plugin_tags-branch-locator","plugin_tags-locations","plugin_tags-map","plugin_tags-maps","plugin_tags-openstreetmap","plugin_category-maps-and-location","plugin_contributors-shebaskhan","plugin_committers-shebaskhan"],"banners":{"banner":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/banner-772x250.png?rev=3765171","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/icon-256x256.png?rev=3765171","icon_2x":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/icon-256x256.png?rev=3765171","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/screenshot-1.png?rev=3765171","caption":""},{"src":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/screenshot-2.png?rev=3765171","caption":""},{"src":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/screenshot-3.png?rev=3765171","caption":""},{"src":"https:\/\/ps.w.org\/mema-multi-branch-locator-map\/assets\/screenshot-4.png?rev=3765171","caption":""}],"raw_content":"\n
Mema Multi Branch Locator Map lets site administrators manage map locations without editing plugin code. Add as many marker locations as your site needs, provide translated names and addresses, and display them in an interactive map. It is an independent plugin and is not affiliated with OpenStreetMap or Google.<\/p>\n\n
Map providers:<\/p>\n\n
Features:<\/p>\n\n
en<\/code>, fr<\/code>, ar<\/code>, or zh-CN<\/code>.<\/li>\n- Choose a map provider globally or override it per shortcode.<\/li>\n
- Configure the initial map center and zoom globally or per shortcode.<\/li>\n
- Apply custom JSON styles to Google Maps.<\/li>\n
- Choose a custom marker image from the WordPress Media Library.<\/li>\n
- Draw, edit, and save a polygon service area; display it with either provider.<\/li>\n
- Let visitors request their current location and add a temporary marker (with their permission).<\/li>\n
- Display each marker's title, address, optional phone, and directions link.<\/li>\n
- Provide map reset and marker visibility controls.<\/li>\n
- Embed maps on pages, posts, and custom post types with
[branch_locator]<\/code>.<\/li>\n- Use WordPress translation functions for the plugin interface and translated marker content for any configured language.<\/li>\n<\/ul>\n\n
Locations and map configuration are stored in WordPress options. No business locations are bundled with the plugin.<\/p>\n\n
Usage<\/h3>\n\n
Basic shortcode:<\/p>\n\n
[branch_locator]\n<\/code><\/pre>\n\nOptional shortcode attributes:<\/p>\n\n
\nlang<\/code> \u2014 marker translation to display. Accepts a language code such as fr<\/code> or zh-CN<\/code>. Defaults to the current WordPress locale.<\/li>\nprovider<\/code> \u2014 osm<\/code> or google<\/code>. Defaults to the provider selected in plugin settings.<\/li>\nzoom<\/code> \u2014 initial zoom level from 1 to 20. When omitted, the map fits the saved markers when possible.<\/li>\ncenter_lat<\/code> and center_lng<\/code> \u2014 initial map center. Both must be provided.<\/li>\nheight<\/code> \u2014 map height in pixels, for example 600px<\/code> or 600<\/code>.<\/li>\n<\/ul>\n\nExample:<\/p>\n\n
[branch_locator lang=\"fr\" provider=\"osm\" zoom=\"12\" center_lat=\"48.8566\" center_lng=\"2.3522\" height=\"600px\"]\n<\/code><\/pre>\n\nThe shortcode can be added to standard posts and pages, or to the content of a custom post type that supports shortcodes. The plugin does not automatically create or inject maps into every custom post type.<\/p>\n\n
For OpenStreetMap, the coordinates entered for a marker determine its position. For Google Maps, coordinates are preferred when present; otherwise, the address from the selected translation is geocoded. If a requested translation is not available, the plugin uses that branch's base-language translation or its first available translation.<\/p>\n\n
The service-area drawing tool creates a polygon. It does not calculate delivery eligibility or restrict markers and map interactions.<\/p>\n\n
Map providers and third-party services<\/h3>\n\n
The plugin uses the following external services when the corresponding map provider or feature is used. These services receive requests directly from the site visitor's browser (or, for the service-area editor, the administrator's browser).<\/p>\n\n
OpenStreetMap tile service<\/strong><\/p>\n\nOpenStreetMap tiles are loaded to display the map whenever an OpenStreetMap map is displayed. The service receives the browser's IP address, requested tile URLs (which disclose the map areas viewed, including the area around a visitor's location if they use the location control), and normal request headers such as the referrer. The service-area editor also requests tiles from the administrator's browser when the settings page is opened. Map tiles are provided by the OpenStreetMap Foundation's community service and are subject to its usage policy; the service is not guaranteed for high-volume use.<\/p>\n\n
\n- OpenStreetMap tile usage policy<\/a><\/li>\n
- OpenStreetMap Foundation privacy policy<\/a><\/li>\n<\/ul>\n\n
Google Maps Platform<\/strong><\/p>\n\nWhen Google Maps is selected and a map shortcode is displayed, the plugin loads the Google Maps JavaScript API from Google and includes the configured API key in that request. Google receives the visitor's IP address, site referrer, map\/API request data, and normal browser request headers. If a branch has no saved coordinates, its configured address is sent to Google's Geocoding service to place the marker. If a visitor chooses the location control, their coordinates are passed to Google Maps to center the map and place the temporary marker. If a visitor clicks the directions link, they are sent to Google Maps with the branch destination in the URL. Google Maps use is governed by Google's terms and privacy policy.<\/p>\n\n
\n- Google Maps Platform Terms of Service<\/a><\/li>\n
- Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n
The plugin's service-area editor uses the locally bundled Leaflet and Leaflet Draw libraries; it does not contact an additional library CDN.<\/p>\n\n
Privacy<\/h3>\n\n
When a visitor opens a map, the selected map provider and its tile or API services receive requests from the visitor's browser as described above. The Google Maps API key is sent to Google only when Google Maps is selected and its map is displayed. OpenStreetMap tiles are used for the service-area editor on the settings page.<\/p>\n\n
The Use my location<\/strong> control requests the visitor's location only after they choose the control. The browser may ask for permission. If granted, the coordinates are used to center the map and place a temporary marker. When Google Maps is selected, the coordinates are sent to Google Maps as part of those map interactions; with OpenStreetMap, the tile requests disclose the approximate area being viewed. This plugin does not send or save the visitor's location to WordPress.<\/p>\n\nBranch names, addresses, phone numbers, marker coordinates, icon URLs, and map settings entered by an administrator are stored in the site's WordPress options table.<\/p>\n\n\n
\n- Upload the
mema-multi-branch-locator-map<\/code> folder to \/wp-content\/plugins\/<\/code>, or install the plugin ZIP through Plugins > Add New > Upload Plugin<\/strong>.<\/li>\n- Activate Mema Multi Branch Locator Map<\/strong> from the Plugins<\/strong> screen.<\/li>\n
- Open Settings > Branch Locator<\/strong>.<\/li>\n
- Select OpenStreetMap or Google Maps.<\/li>\n
- Add at least one location. For OpenStreetMap, provide latitude and longitude. For Google Maps, enter a Google Maps API key and enable the Maps JavaScript API and Geocoding API in Google Cloud.<\/li>\n
- Optionally configure the map center, zoom, custom Google Maps styles, custom marker icons, and a drawn service area.<\/li>\n
- Add
[branch_locator]<\/code> to a page, post, or custom post type.<\/li>\n<\/ol>\n\nThe Google Maps API key can be entered in plugin settings or defined in wp-config.php<\/code>:<\/p>\n\ndefine( 'BRANCH_LOCATOR_GOOGLE_MAPS_API_KEY', 'YOUR_API_KEY_HERE' );\n<\/code><\/pre>\n\nThe wp-config.php<\/code> constant takes priority over the key saved in plugin settings. Restrict a Google API key to the appropriate APIs and website referrers.<\/p>\n\n\n\nDo I need a Google Maps API key?<\/h3><\/dt>\nNo, not when using OpenStreetMap. A Google Maps API key is required only when Google Maps is selected.<\/p><\/dd>\n
How do I get markers to appear on OpenStreetMap?<\/h3><\/dt>\nEdit each location in Settings > Branch Locator<\/strong> and enter valid latitude and longitude coordinates. OpenStreetMap mode does not geocode addresses.<\/p><\/dd>\nCan I translate a location into more than two languages?<\/h3><\/dt>\nYes. Add a translation for each language and enter its language code, name, and address. The shortcode's lang<\/code> attribute selects the displayed translation.<\/p><\/dd>\nCan I use the shortcode on a custom post type?<\/h3><\/dt>\nYes, in the content of any custom post type that processes WordPress shortcodes. Add [branch_locator]<\/code> to the post content or a shortcode-capable page builder block.<\/p><\/dd>\nDoes the service-area polygon restrict where visitors can get directions?<\/h3><\/dt>\nNo. The polygon is a visual highlight only. It does not validate whether an address is inside the area or change directions behavior.<\/p><\/dd>\n