{"id":198973,"date":"2024-09-10T08:54:01","date_gmt":"2024-09-10T08:54:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/store-locator-widget-block\/"},"modified":"2024-11-26T14:22:42","modified_gmt":"2024-11-26T14:22:42","slug":"store-locator-widget-block","status":"publish","type":"plugin","link":"https:\/\/ve.wordpress.org\/plugins\/store-locator-widget-block\/","author":23085497,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.2","stable_tag":"1.0.2","tested":"6.7.5","requires":"6.1","requires_php":"7.0","requires_plugins":null,"header_name":"Store Locator Widget Block","header_author":"@woosmap","header_description":"Easily display your stores on a Map using Woosmap platform","assets_banners_color":"415e74","last_updated":"2024-11-26 14:22:42","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1117,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"woosmap","date":"2024-11-25 15:39:21"},"1.0.2":{"tag":"1.0.2","author":"woosmap","date":"2024-11-26 14:22:42"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3149082,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3149082,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3149082,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3149082,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3197502,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/wp-admin\\\/post.php?post=9&action=edit\",\"preferredVersions\":{\"php\":\"8.0\",\"wp\":\"latest\"},\"phpExtensionBundles\":[\"kitchen-sink\"],\"steps\":[{\"step\":\"login\",\"username\":\"admin\",\"password\":\"password\"},{\"step\":\"installPlugin\",\"pluginZipFile\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"store-locator-widget-block\"},\"options\":{\"activate\":true}},{\"step\":\"importFile\",\"file\":{\"resource\":\"url\",\"url\":\"https:\\\/\\\/raw.githubusercontent.com\\\/Woosmap\\\/store-locator-widget-block\\\/master\\\/.wordpress-org\\\/blueprints\\\/demo-data.xml\"}}]}"}},"all_blocks":{"woosmap\/store-locator-widget-block":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"woosmap\/store-locator-widget-block","version":"1.0.2","title":"Woosmap Store Locator Widget Block","category":"widgets","keywords":["Woosmap","Store Locator","Store Finder","Map"],"description":"Easily display your stores on a Map using Woosmap platform","supports":{"align":["wide","full"],"spacing":{"margin":true},"html":false,"multiple":false},"attributes":{"height":{"type":"string","default":"500"},"apiKey":{"type":"string"},"theme":{"type":"object","properties":{"primary_color":{"type":"string","default":"#000"}},"default":{"primary_color":"#000"}},"internationalization":{"type":"object","default":{"lang":"en","unitSystem":0}},"woosmapView":{"type":"object","default":{"breakPoint":10,"tileStyle":{"color":"#000","size":11,"minSize":5},"initialCenter":{"lat":50,"lng":0},"initialZoom":6}},"maps":{"type":"object","default":{"provider":"woosmap","localities":{"types":["locality","postal_code","address","admin_level","country"]}}},"filters":{"type":"object"},"initialSearch":{"type":"object"},"datasource":{"type":"object"}},"textdomain":"store-locator-widget-block","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","viewScript":"file:.\/view.js"}},"tagged_versions":["1.0.1","1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3149082,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3149082,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3149082,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Store Locator Widget Block preview","2":"Editable JSON Configuration","3":"Block Configuration API Key"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1220,161025,2660,6102],"plugin_category":[49],"plugin_contributors":[231518],"plugin_business_model":[],"class_list":["post-198973","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-map-block","plugin_tags-maps","plugin_tags-store-locator","plugin_category-maps-and-location","plugin_contributors-woosmap","plugin_committers-woosmap"],"banners":{"banner":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/banner-772x250.png?rev=3149082","banner_2x":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/banner-1544x500.png?rev=3149082","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/icon-128x128.png?rev=3149082","icon_2x":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/icon-256x256.png?rev=3149082","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/screenshot-1.png?rev=3149082","caption":"Store Locator Widget Block preview"},{"src":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/screenshot-2.png?rev=3149082","caption":"Editable JSON Configuration"},{"src":"https:\/\/ps.w.org\/store-locator-widget-block\/assets\/screenshot-3.png?rev=3149082","caption":"Block Configuration API Key"}],"raw_content":"<!--section=description-->\n<p>The Woosmap Store Locator Widget Block for WordPress allows you to add a store locator to your WordPress site using the\nGutenberg editor. This plugin leverages\nthe <a href=\"https:\/\/developers.woosmap.com\/products\/widgets\/store-locator-widget\/quick-start\/\">Woosmap Store Locator Widget JS<\/a>\nto provide a rich and interactive experience for users looking for your store locations.\nWith easy customization and setup, you can enhance your site's user experience in minutes.<\/p>\n\n<p>To use this plugin, you will need a Woosmap account and an API key. The Woosmap Store Locator Widget connects to the\nWoosmap API to fetch and display store locations on your site. Note that Woosmap offers various pricing plans, including\na free tier with limited usage and paid plans for higher usage and additional features. For detailed pricing\ninformation, please refer to the <a href=\"https:\/\/www.woosmap.com\/pricing\/\">Woosmap pricing page<\/a>.<\/p>\n\n<p>The widget supports a broad array of languages, including French, English, Spanish, German, and many more, catering to a\nglobal audience and is designed for fast and advanced display capabilities, ensuring a seamless user experience.<\/p>\n\n<p><a href=\"https:\/\/developers.woosmap.com\/products\/widgets\/store-locator-widget\/quick-start\/\">Check official documentation<\/a> for\nmore details.<\/p>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li><strong>Multilingual Support<\/strong>: Available in over 15 languages, such as English, Chinese, and French, catering to\ninternational brands.<\/li>\n<li><strong>Customizable Display<\/strong>: Users can set a primary color that applies to labels and backgrounds, aligning the\nlocator's\nappearance with their brand identity.<\/li>\n<li><strong>Flexible Search<\/strong>: Adapt the search features to include autocomplete worldwide or for specific countries and\nspecific types (address, postal code, etc.), ensuring the functionality best fits your needs.<\/li>\n<li><strong>Advanced Display Options<\/strong>: Offers simplified and markers views for displaying assets, allowing for a clean view or\ndetailed markers based on zoom level.<\/li>\n<li><strong>Configurable Search Parameters<\/strong>: Set the number of assets fetched from a user search and bound searches within a\nset radius to accommodate store density.<\/li>\n<\/ul>\n\n<h3>Display Customization<\/h3>\n\n<ul>\n<li><strong>Simplified View<\/strong>: Ideal for rendering a large number of assets or high store density, displaying assets as colored\ndots for faster map loading and a cleaner view.<\/li>\n<li><strong>Markers View<\/strong>: Displays assets as pictograms with customizable images, sizes, and hotspots, suitable for detailed\nbranding after a specified zoom level.<\/li>\n<\/ul>\n\n<h3>Integration and Customization<\/h3>\n\n<p>The widget's properties offer versatile customization options: use Form controls for swift adjustments of attributes\nlike theme color, or dive into an editable JSON Configuration for granular control over the store locator's\nfunctionality and appearance. This adaptability guarantees seamless integration into any website, equipping businesses\nwith a robust tool to enhance their online presence and engage customers more effectively.<\/p>\n\n<h3>External Dependencies<\/h3>\n\n<p>This plugin will load the Woosmap Store Locator Widget JavaScript asynchronously, which will then load the\n<a href=\"https:\/\/developers.woosmap.com\/products\/map-api\/get-started\/\">Woosmap Map JavaScript<\/a> asynchronously and execute\nrequests to Woosmap services for various functionalities:<\/p>\n\n<ul>\n<li><strong>Searching for Stores<\/strong>: The widget will query the Woosmap API to fetch store locations, ensuring accurate and\nup-to-date results.<\/li>\n<li><strong>Autocompleting Addresses<\/strong>: The widget will use Woosmap's autocomplete service to suggest addresses as users type,\nenhancing the user experience with quick and relevant suggestions.<\/li>\n<li><strong>Displaying Maps<\/strong>: The widget will render maps using Woosmap's mapping service to visually display store locations\nand other relevant data, providing an interactive and user-friendly interface.<\/li>\n<\/ul>\n\n<p>The URLs involved are:\n- <a href=\"https:\/\/webapp.woosmap.com\/webapp.js\">https:\/\/webapp.woosmap.com\/webapp.js<\/a>\n- <a href=\"https:\/\/sdk.woosmap.com\/map.js\">https:\/\/sdk.woosmap.com\/map.js<\/a>\n- <a href=\"https:\/\/api.woosmap.com\/*\">https:\/\/api.woosmap.com\/*<\/a><\/p>\n\n<h3>Source Code<\/h3>\n\n<p>This plugin's source code is accessible in the <code>src<\/code> directory of our <a href=\"https:\/\/github.com\/woosmap\/store-locator-widget-block\">GitHub repository<\/a>.<\/p>\n\n<h3>Configuration<\/h3>\n\n<p>To begin using the Woosmap Store Locator Widget Block, follow these steps to configure your environment and gain access\nto the Woosmap API\nfor enhancing your site with location services.<\/p>\n\n<h3>Woosmap Account Requirements<\/h3>\n\n<ol>\n<li>If you haven't already, <a href=\"https:\/\/www.woosmap.com\/sign_up\/\">sign up for a Woosmap account<\/a> as it's necessary to access\nthe Woosmap Console and API keys.<\/li>\n<li><a href=\"https:\/\/console.woosmap.com\/\">Log in to the Woosmap Console<\/a>. If you're new to Woosmap, you might need to\ncreate a project to generate API keys.<\/li>\n<li>Navigate to the API keys section and generate a new Public API key for your project. This key will be used to\nauthenticate your requests to the Woosmap services.<\/li>\n<\/ol>\n\n<h3>Configure the Woosmap Store Locator Widget Block<\/h3>\n\n<p>When you create a new Woosmap block, the initial settings screen prompts you to enter the public API Key. If an API Key\nhas already been configured, this field will be pre-populated with the existing key stored in the Woosmap settings.\nAfter validation, proceed to the Map View to access various editor settings, or edit the JSON Configuration as desired.<\/p>\n\n<!--section=installation-->\n<p>Follow these steps to install and activate the Woosmap Store Locator Widget Block:<\/p>\n\n<ol>\n<li><p>Via WordPress Plugin Directory:<\/p>\n\n<ul>\n<li>Navigate to <em>Plugins &gt; Add New<\/em> in your WordPress dashboard.<\/li>\n<li>Search for <em>Store Locator Widget Block<\/em>.<\/li>\n<li>Click <em>Install Now<\/em> and then <em>Activate<\/em>.<\/li>\n<\/ul><\/li>\n<li><p>Manual Installation:<\/p>\n\n<ul>\n<li>Download the plugin as a .ZIP file from the WordPress plugin directory.<\/li>\n<li>Navigate to <em>Plugins &gt; Add New &gt; Upload Plugin<\/em> in your WordPress dashboard.<\/li>\n<li>Upload the .ZIP file and click <em>Install Now<\/em>, then <em>Activate<\/em>.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='are%20there%20any%20usage%20limits%20for%20the%20woosmap%20api%3F'><h3>Are there any usage limits for the Woosmap API?<\/h3><\/dt>\n<dd><p>Woosmap offers different plans with varying usage limits. The free tier includes a generous allowance suitable for small\nto medium projects. For higher usage limits or specific needs, consider upgrading to a paid plan. Check\nthe <a href=\"https:\/\/www.woosmap.com\/pricing\/\">Woosmap pricing page<\/a> for more details.<\/p><\/dd>\n<dt id='can%20i%20track%20my%20api%20usage%20and%20see%20analytics%3F'><h3>Can I track my API usage and see analytics?<\/h3><\/dt>\n<dd><p>Yes, the Woosmap Console provides detailed analytics and usage reports for your API keys. You can monitor your\nusage to ensure you stay within your plan's limits and analyze the data to gain insights into your users' behavior.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2 - 2024-26-11<\/h4>\n\n<ul>\n<li>Tested up to WP 6.7<\/li>\n<\/ul>\n\n<h4>1.0.1 - 2024-27-08<\/h4>\n\n<ul>\n<li>Added Support for local map markers.<\/li>\n<li>Updated Readme to clarify Woosmap requirements and dependencies.<\/li>\n<\/ul>\n\n<h4>1.0.0 - 2024-07-05<\/h4>\n\n<p>Initial Release<\/p>","raw_excerpt":"Easily integrate the Woosmap Store Locator Widget into your WordPress site with this Gutenberg block plugin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/198973","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=198973"}],"author":[{"embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/woosmap"}],"wp:attachment":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=198973"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=198973"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=198973"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=198973"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=198973"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=198973"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}