ACF OpenStreetMap Field

This is the official github repository of the ACF OpenStreetMap Field plugin.

About

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

Features

• Configurable Map-Tile Provider
• Selectable Map Overlays
• Multiple Markers
• Ready-to-use HTML-Output
• Custom map markers through WordPress filters and JS Events.
• Map Proxy to comply with privacy regulations and to hide API Credentials

Installation

In WP Admin

Just follow the Automatic Plugin Installation procedere.

WP-CLI

wp plugin install --activate acf-openstreetmap-field

Using composer

composer require mcguffin/acf-openstreetmap-field

Development

git clone [email protected]:mcguffin/acf-openstreetmap-field.git
cd acf-openstreetmap-field
npm install
npm run dev

Usage

There is some developer centric documentation in the wiki.

Development

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
• npm run uitest: create test fields in wp-admin

Testing

In WP-Admin

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

npm run dev-test

Unit Tests

Unit tests are run in wordpress/env, which is basically a docker container. Docker Desktop is required.

npm run test

Thanks

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

• Jan Pieter Waagmeester (Leaflet Providers)
• Per Liedman (Leaflet Control Geocode)
• The entire Leaflet Project