{"id":370231,"date":"2026-09-22T09:18:19","date_gmt":"2026-09-22T09:18:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/panmap\/"},"modified":"2026-09-22T09:18:09","modified_gmt":"2026-09-22T09:18:09","slug":"panmap","status":"publish","type":"plugin","link":"https:\/\/az.wordpress.org\/plugins\/panmap\/","author":23316375,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.2","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"PanMap","header_author":"Sanchit Pandey","header_description":"Lazy-loaded Google Maps embeds: a lightweight placeholder that loads the real map only once it scrolls into view. No API key required.","assets_banners_color":"6ba1ff","last_updated":"2026-09-22 09:18:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/panmap\/","header_author_uri":"https:\/\/profiles.wordpress.org\/sanchitpandeyyy\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"sanchitpandeyyy","date":"2026-09-22 09:18:09","revision":3706960}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3706960,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3706960,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3706960,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3706960,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"The map builder: find a location, preview it, and copy the shortcode.","2":"A map placeholder on the front end, before it scrolls into view.","3":"The interactive Google Map, loaded once the placeholder scrolls into view."}},"plugin_section":[],"plugin_tags":[230,1571,4884,2909,247],"plugin_category":[49,54,56],"plugin_contributors":[250692],"plugin_business_model":[],"class_list":["post-370231","plugin","type-plugin","status-publish","hentry","plugin_tags-embed","plugin_tags-google-maps","plugin_tags-lazy-load","plugin_tags-map","plugin_tags-performance","plugin_category-maps-and-location","plugin_category-security-and-spam-protection","plugin_category-social-and-sharing","plugin_contributors-sanchitpandeyyy","plugin_committers-sanchitpandeyyy"],"banners":{"banner":"https:\/\/ps.w.org\/panmap\/assets\/banner-772x250.png?rev=3706960","banner_2x":"https:\/\/ps.w.org\/panmap\/assets\/banner-1544x500.png?rev=3706960","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/panmap\/assets\/icon-128x128.png?rev=3706960","icon_2x":"https:\/\/ps.w.org\/panmap\/assets\/icon-256x256.png?rev=3706960","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>A standard embedded Google Map starts downloading Google's entire map application - scripts, styles, fonts and map tiles - the moment your page loads, whether or not anyone ever looks at it. That work competes with your own content and drags down your Core Web Vitals.<\/p>\n\n<p>PanMap takes that cost off the initial page load. It shows a clean, lightweight placeholder where the map will be, and only loads the real, interactive Google Map once it scrolls into a visitor's view.<\/p>\n\n<p><strong>Built for performance<\/strong><\/p>\n\n<ul>\n<li><strong>Zero requests to Google on page load.<\/strong> The placeholder is drawn with inline SVG and CSS served from your own site. Nothing is fetched from Google until the map scrolls into view.<\/li>\n<li><strong>Tiny footprint.<\/strong> About 4 KB of CSS and 2 KB of JavaScript, and neither file loads on pages that don't contain a map.<\/li>\n<li><strong>No flash of empty space.<\/strong> The placeholder stays in view until the real map has finished loading, then cross-fades smoothly into it.<\/li>\n<\/ul>\n\n<p><strong>No API key, no billing<\/strong><\/p>\n\n<p>PanMap uses Google's keyless map embeds, so there is no Google Cloud project, API key or billing account to set up.<\/p>\n\n<p><strong>Easy to set up<\/strong><\/p>\n\n<ul>\n<li><strong>Find any location.<\/strong> Type a place name or address, enter coordinates, or paste a link copied from Google Maps - including \"Share\" links.<\/li>\n<li><strong>Or use the exact map you made in Google Maps.<\/strong> Paste the code from Google Maps' <strong>Share &gt; Embed a map<\/strong>, and PanMap lazy-loads that same map.<\/li>\n<li><strong>See it before you publish.<\/strong> Preview the placeholder and the real, interactive map exactly as your visitors will see them.<\/li>\n<li><strong>Copy and paste.<\/strong> PanMap writes the shortcode for you.<\/li>\n<\/ul>\n\n<p><strong>Thoughtfully built<\/strong><\/p>\n\n<ul>\n<li><strong>Accessible.<\/strong> There is nothing to click or tab to - the map loads on its own as it scrolls into view, and the cross-fade respects the \"reduce motion\" system setting.<\/li>\n<li><strong>Works without JavaScript.<\/strong> Visitors with JavaScript disabled still get a working map.<\/li>\n<li><strong>Works with page builders.<\/strong> Maps added to the page after it loads, for example by Ajax or a page builder's live preview, work without extra setup.<\/li>\n<li><strong>Translation-ready.<\/strong><\/li>\n<\/ul>\n\n<p>Every feature described here is included in this plugin. Nothing is locked.<\/p>\n\n<h4>Usage<\/h4>\n\n<p>Go to <strong>PanMap<\/strong> in your admin menu, add a map, then click <strong>Copy shortcode<\/strong> and paste it into any post, page or widget that supports shortcodes. The shortcode it copies points at the saved map, so editing that map later updates every place the shortcode is already pasted:<\/p>\n\n<pre><code>[panmap slug=\"our-office\"]\n<\/code><\/pre>\n\n<p>You can also write a map out by hand, without saving it first:<\/p>\n\n<pre><code>[panmap address=\"India Gate, New Delhi\" title=\"Our Office\"]\n\n[panmap lat=\"28.6129\" lng=\"77.2295\" zoom=\"17\"]\n<\/code><\/pre>\n\n<h4>Shortcode attributes<\/h4>\n\n<ul>\n<li><code>slug<\/code> - The name of a map saved on the PanMap screen. Takes over completely: every other attribute is ignored. This is what <strong>Copy shortcode<\/strong> writes.<\/li>\n<li><code>embed<\/code> - The map details from Google Maps' \"Embed a map\" code. The PanMap screen fills this in when you paste that code. Takes priority over everything below.<\/li>\n<li><code>lat<\/code> - Latitude, from -90 to 90. Use with <code>lng<\/code>. Takes priority over <code>address<\/code>.<\/li>\n<li><code>lng<\/code> - Longitude, from -180 to 180. Use with <code>lat<\/code>.<\/li>\n<li><code>address<\/code> - Any place name or address Google Maps can find.<\/li>\n<li><code>zoom<\/code> - Zoom level, from 1 (whole world) to 21 (individual buildings). Defaults to the value on the settings screen, or 15. Not used with <code>embed<\/code>, which keeps its own zoom.<\/li>\n<li><code>title<\/code> - The location's name, used as the map's accessible title once it loads. Optional.<\/li>\n<li><code>height<\/code> - Map height in pixels, from 120 to 1200. Defaults to the value on the settings screen, or 400.<\/li>\n<\/ul>\n\n<p>Out-of-range <code>zoom<\/code> and <code>height<\/code> values are clamped to the nearest allowed value. If there is no usable location, the shortcode outputs nothing rather than a broken map.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin uses <strong>Google Maps<\/strong>, a service provided by Google LLC, to show interactive maps of the locations you choose.<\/p>\n\n<p><strong>On your site's front end:<\/strong> only once a map placeholder scrolls into a visitor's view, their browser loads the map from Google Maps (<code>maps.google.com<\/code> or <code>www.google.com<\/code>). That request includes the map's location - its address, its latitude and longitude, or the embed details copied from Google Maps - and its zoom level. Like any request to a third-party website, it also sends Google the visitor's IP address and browser information, and Google may set or read cookies. No request is made to Google before that. If a visitor has JavaScript disabled, the map is embedded directly instead, using the browser's own native lazy-loading, and the same request is made when it scrolls into view.<\/p>\n\n<p><strong>On the PanMap admin screen:<\/strong> when an administrator previews a map, their browser loads it from Google Maps in the same way. When an administrator pastes a Google Maps \"Share\" link (<code>maps.app.goo.gl<\/code>) and presses <strong>Find<\/strong>, your web server sends that link to Google to look up the location it points to. Only the link itself is sent.<\/p>\n\n<p>This service is subject to Google's terms and privacy policy:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/maps.google.com\/help\/terms_maps\/\">Google Maps\/Google Earth Additional Terms of Service<\/a><\/li>\n<li><a href=\"https:\/\/policies.google.com\/terms\">Google Terms of Service<\/a><\/li>\n<li><a href=\"https:\/\/policies.google.com\/privacy\">Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p>This plugin also uses <strong>OpenStreetMap<\/strong>, a service of the OpenStreetMap Foundation, on the PanMap admin screen only. When an administrator opens \"Pin it on a map instead\" to set a location by hand, their browser loads map tile images from OpenStreetMap's tile servers (<code>tile.openstreetmap.org<\/code>) so they can click to place a pin. This sends OpenStreetMap the administrator's IP address and browser information, the same as any request to a third-party website. No account, API key or payment is required, and this never happens on the site's front end or without the admin screen being open.<\/p>\n\n<p>This service is subject to OpenStreetMap's terms and privacy policy:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/wiki.osmfoundation.org\/wiki\/Privacy_Policy\">OpenStreetMap Foundation Privacy Policy<\/a><\/li>\n<li><a href=\"https:\/\/operations.osmfoundation.org\/policies\/tiles\/\">Tile Usage Policy<\/a><\/li>\n<\/ul>\n\n<h3>Source code<\/h3>\n\n<p>Nothing in this plugin is obfuscated, and no compiled file ships without the source it was built from. The download contains its own complete source:<\/p>\n\n<ul>\n<li><code>src\/index.js<\/code> and <code>src\/index.scss<\/code> build the admin screen - <code>build\/index.js<\/code> and <code>build\/index.css<\/code>.<\/li>\n<li><code>src\/frontend.js<\/code> and <code>src\/frontend.scss<\/code> build the front end - <code>build\/frontend.js<\/code> and <code>build\/frontend.css<\/code>.<\/li>\n<li><code>src\/components\/<\/code> and <code>src\/shared\/<\/code> hold the rest of the admin screen's code.<\/li>\n<li>Everything in <code>includes\/<\/code> is plain, readable PHP that runs as-is.<\/li>\n<\/ul>\n\n<p>To rebuild the compiled files, you need Node.js 20 or newer. From the plugin folder:<\/p>\n\n<pre><code>npm install\nnpm run build\n<\/code><\/pre>\n\n<p>That runs <a href=\"https:\/\/www.npmjs.com\/package\/@wordpress\/scripts\">@wordpress\/scripts<\/a> 35 (webpack), which writes <code>build\/<\/code>. <code>npm run dist<\/code> additionally runs <code>gulpfile.js<\/code> to assemble a release copy of the plugin in <code>dist\/<\/code>.<\/p>\n\n<p><strong>Third-party libraries<\/strong><\/p>\n\n<ul>\n<li><a href=\"https:\/\/leafletjs.com\/\">Leaflet<\/a> 1.9.4, by Volodymyr Agafonkin, BSD-2-Clause licensed - source at <a href=\"https:\/\/github.com\/Leaflet\/Leaflet\">github.com\/Leaflet\/Leaflet<\/a>. It is compiled into <code>build\/index.js<\/code>, its stylesheet into <code>build\/index.css<\/code>, and its default marker images are the files in <code>build\/images\/<\/code>. Leaflet draws the \"Pin it on a map instead\" picker on the admin screen only; it never loads on the front end.<\/li>\n<\/ul>\n\n<p>Leaflet's copyright notice and license text are reproduced in <code>LICENSE.txt<\/code>, alongside PanMap's own GPLv2 license.<\/p>\n\n<p>No other third-party library is bundled. Everything else the admin screen uses - React, the components, the data layer - comes from the copies WordPress itself ships.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In your WordPress admin, go to <strong>Plugins &gt; Add New Plugin<\/strong> and search for \"PanMap\".<\/li>\n<li>Click <strong>Install Now<\/strong>, then <strong>Activate<\/strong>.<\/li>\n<li>Go to <strong>PanMap<\/strong> in the admin menu, find your location, and copy the shortcode.<\/li>\n<li>Paste the shortcode wherever you want the map to appear.<\/li>\n<\/ol>\n\n<p>To install manually instead, upload the <code>panmap<\/code> folder to <code>\/wp-content\/plugins\/<\/code> and activate it on the <strong>Plugins<\/strong> screen.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20google%20maps%20api%20key%3F\"><h3>Do I need a Google Maps API key?<\/h3><\/dt>\n<dd><p>No. PanMap uses Google's keyless map embeds rather than the Maps Embed API, so there is nothing to sign up for and no billing account to configure.<\/p><\/dd>\n<dt id=\"how%20do%20i%20choose%20a%20location%3F\"><h3>How do I choose a location?<\/h3><\/dt>\n<dd><p>On the <strong>PanMap<\/strong> screen, you can:<\/p>\n\n<ul>\n<li>type a place name or address,<\/li>\n<li>enter coordinates such as <code>28.6129, 77.2295<\/code>,<\/li>\n<li>paste a link from Google Maps - either the full link from your browser's address bar or a \"Share\" link, or<\/li>\n<li>paste the code from Google Maps' <strong>Share &gt; Embed a map<\/strong> to use that exact map.<\/li>\n<\/ul>\n\n<p>Press <strong>Find<\/strong> to preview it, then copy the shortcode.<\/p><\/dd>\n<dt id=\"does%20panmap%20contact%20google%20before%20a%20visitor%20sees%20the%20map%3F\"><h3>Does PanMap contact Google before a visitor sees the map?<\/h3><\/dt>\n<dd><p>No. Until the map scrolls into view, the placeholder is drawn entirely with files served from your own site. A visitor whose browser has JavaScript disabled gets the same behavior: the map is embedded directly, using the browser's native lazy-loading, so it still only loads once it scrolls into view. See <strong>External services<\/strong> below.<\/p><\/dd>\n<dt id=\"will%20it%20work%20with%20my%20page%20builder%20or%20theme%3F\"><h3>Will it work with my page builder or theme?<\/h3><\/dt>\n<dd><p>PanMap works anywhere WordPress shortcodes are supported, including maps that a page builder or Ajax adds to the page after it first loads.<\/p><\/dd>\n<dt id=\"where%20is%20the%20plugin%27s%20source%20code%3F\"><h3>Where is the plugin's source code?<\/h3><\/dt>\n<dd><p>Inside the plugin. The <code>src<\/code> folder holds the uncompiled JavaScript and Sass that <code>build\/index.js<\/code> and <code>build\/frontend.js<\/code> are compiled from, and <code>package.json<\/code> and <code>gulpfile.js<\/code> hold the build steps. See <strong>Source code<\/strong> below.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20my%20data%20if%20i%20delete%20the%20plugin%3F\"><h3>What happens to my data if I delete the plugin?<\/h3><\/dt>\n<dd><p>PanMap stores two settings in your database: your site-wide defaults and your saved maps. Deleting the plugin from the <strong>Plugins<\/strong> screen removes both, and nothing else is left behind. It never creates custom database tables.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Lazy-loaded Google Maps embeds: a lightweight placeholder that loads the real map only once it scrolls into view. No API key.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/370231","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=370231"}],"author":[{"embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sanchitpandeyyy"}],"wp:attachment":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=370231"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=370231"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=370231"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=370231"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=370231"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=370231"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}