PHPackages                             mcguffin/acf-openstreetmap-field - 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. [Utility & Helpers](/categories/utility)
4. /
5. mcguffin/acf-openstreetmap-field

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

mcguffin/acf-openstreetmap-field
================================

WordPress ACF Field for OpenStreetMap

1.6.1(1y ago)1093.7k24[11 issues](https://github.com/mcguffin/acf-openstreetmap-field/issues)[3 PRs](https://github.com/mcguffin/acf-openstreetmap-field/pulls)GPL-3.0-or-laterPHPPHP >=5.6.0

Since Sep 11Pushed 6mo ago8 watchersCompare

[ Source](https://github.com/mcguffin/acf-openstreetmap-field)[ Packagist](https://packagist.org/packages/mcguffin/acf-openstreetmap-field)[ Docs](https://github.com/mcguffin/acf-openstreetmap-field)[ RSS](/packages/mcguffin-acf-openstreetmap-field/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (34)Used By (0)

ACF OpenStreetMap Field
=======================

[](#acf-openstreetmap-field)

This is the official github repository of the [ACF OpenStreetMap Field](https://wordpress.org/plugins/acf-openstreetmap-field/) plugin.

About
-----

[](#about)

Configurable OpenStreetMap or Leaflet Field in ACF.
Requires ACF 5.7+

Features
--------

[](#features)

- Configurable Map-Tile Provider
- Selectable Map Overlays
- Multiple Markers
- Ready-to-use HTML-Output
- Custom map markers [through WordPress filters](../../wiki/HTML-Marker-Icon) and JS Events.
- Map Proxy to comply with privacy regulations and to hide API Credentials

Installation
------------

[](#installation)

#### In WP Admin

[](#in-wp-admin)

Just follow the [Automatic Plugin Installation](https://wordpress.org/support/article/managing-plugins/#automatic-plugin-installation) procedere.

#### WP-CLI

[](#wp-cli)

```
wp plugin install --activate acf-openstreetmap-field
```

#### Using composer

[](#using-composer)

```
composer require mcguffin/acf-openstreetmap-field

```

### Development

[](#development)

```
git clone git@github.com:mcguffin/acf-openstreetmap-field.git
cd acf-openstreetmap-field
npm install
npm run dev
```

Usage
-----

[](#usage)

There is some developer centric documentation in the [wiki](../../wiki).

Development
-----------

[](#development-1)

npm scripts:

- `npm run audit`: Run phpcs audit
- `npm run build`: Build css and js from sources
- `npm run dev`: Watch css and js source dirs
- `npm run dev-test`: create test fields in wp-admin and watch css and js source dirs
- `npm run dashicons`: Generate dashicons scss variables from source
- `npm run i18n`: generate `.pot` file
- `npm run rollback`: remove last commit (local and remote – use with caution!)
- `npm run test`: run unit tests against PHP 7.4 and 8.3
- `npm run test:edge`: run unit tests against PHP 8.3 only
- `npm run test:legacy`: run unit tests against PHP 7.4 only
- `npm run uitest`: create test fields in wp-admin

Testing
-------

[](#testing)

### In WP-Admin

[](#in-wp-admin-1)

Add some ACF Fields to several places for manual testing in wp-admin.

```
npm run dev-test
```

### Unit Tests

[](#unit-tests)

Unit tests are run in [wordpress/env](https://www.npmjs.com/package/@wordpress/env/v/2.0.0), which is basically a docker container. [Docker Desktop](https://docs.docker.com/desktop/) is required.

Unit tests are run against PHP 7.4 (legacy) and 8.3 (edge).

**Run them all:**

```
npm run test
```

**Run edge tests only:**

```
npm run test:edge
```

**Configure edge test and run something in wp-cli in the docker container:**

```
npm run test:set-edge
npm run test:reset-env
wp-env run cli wp core version
> 6.7.1
```

**I could use a little help:**:

- Unit tests covering all PHP code
- Unit-testing JS

Thanks
------

[](#thanks)

This plugin wouldn't have been possible without these awesome people and Projects:

- Jan Pieter Waagmeester ([Leaflet Providers](https://github.com/leaflet-extras/leaflet-providers))
- Per Liedman ([Leaflet Control Geocode](https://github.com/perliedman/leaflet-control-geocoder))
- The entire [Leaflet](https://leafletjs.com/) Project

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance54

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 96.9% 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 ~64 days

Recently: every ~98 days

Total

31

Last Release

512d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e32281e1b5f0cbc598ece29eae06589fc9ed6aeb4529f5dd927bf0641e42fa4?d=identicon)[mcguffin](/maintainers/mcguffin)

---

Top Contributors

[![mcguffin](https://avatars.githubusercontent.com/u/402988?v=4)](https://github.com/mcguffin "mcguffin (526 commits)")[![Cyrille37](https://avatars.githubusercontent.com/u/368965?v=4)](https://github.com/Cyrille37 "Cyrille37 (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![adesignl](https://avatars.githubusercontent.com/u/765914?v=4)](https://github.com/adesignl "adesignl (1 commits)")[![jesseihatsu](https://avatars.githubusercontent.com/u/3142644?v=4)](https://github.com/jesseihatsu "jesseihatsu (1 commits)")

---

Tags

acfleafletopenstreetmapwordpressmapacfacf-fieldOpenStreetMapLealet

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/mcguffin-acf-openstreetmap-field/health.svg)

```
[![Health](https://phpackages.com/badges/mcguffin-acf-openstreetmap-field/health.svg)](https://phpackages.com/packages/mcguffin-acf-openstreetmap-field)
```

###  Alternatives

[log1x/acf-editor-palette

A replica Gutenberg color picker field for Advanced Custom Fields.

100284.1k](/packages/log1x-acf-editor-palette)[hellonico/acf-country

A country field for ACF.

12193.2k](/packages/hellonico-acf-country)[log1x/acf-phone-number

A real ACF phone number field.

12072.5k](/packages/log1x-acf-phone-number)[mediawiki/maps

Adds various mapping features to MediaWiki

84145.0k3](/packages/mediawiki-maps)[kolirt/laravel-openstreetmap

Package for openstreetmap.org

2332.5k](/packages/kolirt-laravel-openstreetmap)[mcguffin/acf-customizer

Use ACF Fields in customizer.

7611.3k](/packages/mcguffin-acf-customizer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)