Easy G Maps
Google maps & markers for WordPress, supporting Gutenburg Blocks AND classic shortocdes. Hookable.
Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/headwalluk/easy-g-maps/releases/download/v1.0.0/easy-g-maps.zipAdd Google Maps to WordPress content with a shortcode or a Gutenberg block — one settings page, one API key. It works the same across Elementor, GeneratePress, the classic editor, and full block themes, loads Google Maps only on pages that actually contain a map, and needs no build step.
Built and maintained by Headwall Hosting.
Who it's for
- Site owners who want a map on a page without wrestling with Google's API or a heavyweight plugin — paste a key, drop in
[egm_map address="…"], done. - Developers who want a single, predictable renderer they can hook: add markers in code, reshape the map config, or override the container template.
[egm_map address="Trafalgar Square, London" zoom="15" marker_title="We are here"]Documentation
Full guides live in docs/:
| Topic | |
|---|---|
| Installation | Requirements, install, update, uninstall |
| Google API key | Create, enable, and secure your key (referrer restriction) |
| Shortcode reference | [egm_map] and every attribute |
| Block guide | The Easy G Map block and its sidebar controls |
| Hooks & filters | Multi-marker filter, map-config filter, template override |
| Troubleshooting | Blank maps, key-test failures, quota errors |
Contributing & internals
- CLAUDE.md — architecture, conventions, and key technical decisions.
- dev-notes/ — milestones, roadmap, and working notes.
- CHANGELOG.md — per-version release notes.
This project has no Composer or npm — phpcs/phpcbf are installed globally on the host. Run phpcs before committing (config in phpcs.xml).
Pushing a v* tag runs .github/workflows/release.yml, which builds a clean distribution zip (easy-g-maps.zip, honouring .distignore) and attaches it to the GitHub Release. Installed copies pick that release up automatically via the built-in GitHub updater (includes/class-github-updater.php); set the easy_g_maps_updater_enabled filter to false to pin a site to its current version.
License
Releases
1 release. Each count is every asset in that release; expand a row for the breakdown.