PHPackages microman/kirby-map - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. microman/kirby-map ActiveKirby-plugin microman/kirby-map ================== Geolocation field & map block: All you need for a map on your website 2.1.5(8mo ago)289422GPL-3.0-onlyPHPCI passing Since Oct 5Pushed 8mo ago3 watchersCompare [ Source](https://github.com/plain-solutions-gmbh/kirby-map)[ Packagist](https://packagist.org/packages/microman/kirby-map)[ Docs](https://plain-solutions.net/906071)[ RSS](/packages/microman-kirby-map/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (19)Used By (0) Kirby Map Suite =============== [](#kirby-map-suite) Overview -------- [](#overview) **2-in-1-Plugin**: All you need to set up a map on your website. This plugin includes two rich feature sets: - πŸ”Ž **Geolocation field:** - Search for your location and get results (name, lat, long) into fields - πŸ—Ί **Map block:** - Built-in Mapbox instance - Set the following values for… - design - (center) location - zoom - Insert unlimited numbers of πŸ“ markers - location - icon - anchor of the icon (`top left`, `center center`, `bottom right`, etc.) - size of the Icon (100% = original size) - popup: text and horizontal offset to the location > Since version 2.1.0 introduces many new features, this plugin is now subject to GPL-3.0-only license. To use the MIT license, please refer to the last free version, 1.1.1. Installation ------------ [](#installation) **Manually** [Download](https://github.com/plain-solutions-gmbh/kirby-map) and copy the plugin into your plugin folder: `/site/plugins/` **With Composer** `composer require plain/kirby-map` Configuration ------------- [](#configuration) > DEPRECATION-WARNING: Option prefix changed since version 2.0.1 (old: micorman.\* | new: plain.\*) Kirby Map uses [Mapbox](https://www.mapbox.com/) for geolocation and map view. To use this Plugin, create your very own [access token](https://docs.mapbox.com/help/getting-started/access-tokens) and set it in your config file: `/site/config/config.php` ``` return [ 'plain.map.token' => 'YOUR-TOKEN' ]; ``` Geolocation field ----------------- [](#geolocation-field) [![Geolocation field](./.github/screenshot-geolocation.png)](./.github/screenshot-geolocation.png) Here's an example how to use the geolocationg field in your blueprint: ``` myGeoLocation: label: My Geolocation type: geolocation default: name: "Berlin" lat: 13.38333 lng: 52.51667 ``` ### How to use the geolocation field in your template [](#how-to-use-the-geolocation-field-in-your-template) ``` Name: Latitude: Longitude: ``` Map block --------- [](#map-block) [![Map block](./.github/screenshot-maps.png)](./.github/screenshot-maps.png) With the Map block, you can set up your map with a live preview. To add this block to your blueprint, simply add a `blocks` field: ``` myContent: type: blocks fieldsets: - maps ``` To customize the default block blueprints, copy the two files located in `/site/plugins/kirby-map/blueprints/blocks/` to your blocks blueprint folder: `/site/blueprints/blocks` ### Markers [](#markers) You can add as many markers as you want right from within your map block. Try to place your marker in the visible preview. [![Map block marker](./.github/screenshot-marker.png)](./.github/screenshot-marker.png) ### How to use the map block in your template [](#how-to-use-the-map-block-in-your-template) The map will be rendered inside your block field. By default, the Block outputs an open source Mapbox instance. If you want to use the [Google Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/overview) copy and rename `/site/plugins/kirby-map/lib/examples/google-maps.php` to `site/snippets/blocks/maps.php` > Don't forget to replace `[YOUR-API]` with your [Google-API](https://developers.google.com/maps/documentation/javascript/get-api-key) in the last line. Credits ------- [](#credits) Powered by [Mapbox](https://www.mapbox.com/). Inspired by [Sylvain's Kirby-Locator](https://github.com/sylvainjule/kirby-locator) License ======= [](#license) By using this project, you agree to the terms and conditions outlined in our [Terms of Service](https://plain-solutions.net/terms). To acquire a license for this project, please visit our [Licensing Page](https://plain-solutions.net/906071). ### Health Score 43 β€” FairBetter than 90% of packages Maintenance62 Regular maintenance activity Popularity26 Limited adoption so far Community12 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 76.3% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~83 days Recently: every ~37 days Total 18 Last Release 264d ago Major Versions 1.1.1 β†’ 2.0.02025-02-05 ### Community Maintainers ![](https://www.gravatar.com/avatar/2ce34d22100c42ac040481da5ed0d1dc1a858e775500bb290bc8ec956c66bab0?d=identicon)[microman](/maintainers/microman) --- Top Contributors [![johannschopplich](https://avatars.githubusercontent.com/u/27850750?v=4)](https://github.com/johannschopplich "johannschopplich (45 commits)")[![plain-solutions-gmbh](https://avatars.githubusercontent.com/u/4754476?v=4)](https://github.com/plain-solutions-gmbh "plain-solutions-gmbh (14 commits)") --- Tags kirby-cmskirby-pluginkirby4kirby5maps ### Embed Badge ![Health badge](/badges/microman-kirby-map/health.svg) ``` [![Health](https://phpackages.com/badges/microman-kirby-map/health.svg)](https://phpackages.com/packages/microman-kirby-map) ``` ### Alternatives [getkirby/cms The Kirby core 1.5k535.5k350](/packages/getkirby-cms)[distantnative/retour-for-kirby Manage redirects and track 404s right from the Kirby CMS Panel 14689.4k1](/packages/distantnative-retour-for-kirby)[arnoson/kirby-vite Vite helper for Kirby CMS 9759.2k3](/packages/arnoson-kirby-vite)[getkirby/staticache Static site performance on demand 9615.4k](/packages/getkirby-staticache)[fabianmichael/kirby-meta Your all-in-one powerhouse for any SEO and metadata needs imaginable. 6910.7k1](/packages/fabianmichael-kirby-meta)[thathoff/kirby-oauth Kirby OAuth 2 Plugin 3823.9k](/packages/thathoff-kirby-oauth) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)