Skip to content
Provides an visual interface for editing latitude and longitude coordinates.
Vue PHP JavaScript CSS
Branch: master
Clone or download
Latest commit 4970d3e Aug 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Jun 23, 2019
dist Fix validation and update process. Aug 25, 2019
docs WIP Jun 24, 2019
images Added initual functionality Jun 22, 2019
resources Fix validation and update process. Aug 25, 2019
src
.gitignore Added initual functionality Jun 22, 2019
CHANGELOG.md Fix validation and update process. Aug 25, 2019
CNAME Create CNAME Jun 23, 2019
CODE_OF_CONDUCT.md Add documentation, tile layer provider customization, search provider… Jun 23, 2019
CONTRIBUTING.md Add documentation, tile layer provider customization, search provider… Jun 23, 2019
LICENSE Add documentation, tile layer provider customization, search provider… Jun 23, 2019
README.md Fix validation and update process. Aug 25, 2019
_config.yml WIP Jun 24, 2019
composer.json Add documentation, tile layer provider customization, search provider… Jun 23, 2019
package.json Added initual functionality Jun 22, 2019
webpack.mix.js Added initual functionality Jun 22, 2019

README.md

Map Marker Field for Laravel Nova

GitHub (pre-)release Packagist GitHub license

laravel-nova-map-marker-field-header

Supporting This Package

This is an MIT-licensed open source project with its ongoing development made possible by the support of the community. If you'd like to support this, and our other packages, please consider becoming a backer or sponsor on Patreon.

Installation

  1. Install the package:
composer require genealabs/nova-map-marker-field
  1. Publish the marker icon assets (this is not necessary if you are specifying your own):
php artisan vendor:publish --provider="GeneaLabs\NovaMapMarkerField\Providers\Service"

Implementation

To create the map marker field, all that is necessary is the form label, and the remaining options will have defaults applied:

use GeneaLabs\NovaMapMarkerField\MapMarker;

MapMarker::make("Location"),

Coordinate Field Names

By default the field will look for latitude and longitude fields on the model. However, if your model uses different names, you may customize them with the ->latitude('lat') and ->longitude('long') methods:

MapMarker::make("Location")
    ->latitude('lat')
    ->longitude('long'),

Default Settings

You can specify default settings for zoom level, and initial map center coordinates. If not specified, the zoom level will default to 12; the coordinates will default to (0, 0).

MapMarker::make("Location")
    ->defaultZoom(8)
    ->defaultLatitude(41.823611)
    ->defaultLongitude(-71.422222),

Search Provider

The underlying search capabilities are provided by leaflet-geosearch. Please refer to their documentation for provider configuration. By default we use the ESRI search provider.

MapMarker::make("Location")
    ->searchProvider('google')
    ->searchProviderKey('xxxxxxxxxxxxxxxxxxxxxxxxxxx'),

Tile Layer

You are free to use any tile provider that is compatible with Leaflet. Please refer to their documentation on tile layer URLs. By default we use tiles provided by OpenStreetMap:

MapMarker::make("Location")
    ->tileProvider('http://{s}.somedomain.com/{foo}/{z}/{x}/{y}.png'),

Usage

When creating or editing you can search for an address or city to get the map to the general area you wish to get coordinates for. Then you can precisely position the marker by dragging the map -- the marker will always stay positioned in the middle, while you move the map under it.

When viewing the map in on the detail page, the map and marker are not interactive, and there is no search functionality. However, the user is free to zoom in and out.

Screenshots

Create / Edit Field

Screen Shot 2019-06-23 at 8 16 52 AM

Detail Field

Screen Shot 2019-06-23 at 8 17 43 AM

Index Field

Screen Shot 2019-06-23 at 8 32 01 AM

Commitment to Quality

During package development I try as best as possible to embrace good design and development practices, to help ensure that this package is as good as it can be. My checklist for package development includes:

  • Achieve as close to 100% code coverage as possible using unit tests.
  • Eliminate any issues identified by SensioLabs Insight and Scrutinizer.
  • Be fully PSR1, PSR2, and PSR4 compliant.
  • Include comprehensive documentation in README.md.
  • Provide an up-to-date CHANGELOG.md which adheres to the format outlined at http://keepachangelog.com.
  • Have no PHPMD or PHPCS warnings throughout all code.

Contributing

Please observe and respect all aspects of the included Code of Conduct https://github.com/GeneaLabs/nova-map-marker-field/blob/master/CODE_OF_CONDUCT.md.

Reporting Issues

When reporting issues, please fill out the included template as completely as possible. Incomplete issues may be ignored or closed if there is not enough information included to be actionable.

Submitting Pull Requests

Please review the Contribution Guidelines https://github.com/GeneaLabs/nova-map-marker-field/blob/master/CONTRIBUTING.md. Only PRs that meet all criterium will be accepted.

If you ❤️ open-source software, give the repos you use a ⭐️.

We have included the awesome symfony/thanks composer package as a dev dependency. Let your OS package maintainers know you appreciate them by starring the packages you use. Simply run composer thanks after installing this package. (And not to worry, since it's a dev-dependency it won't be installed in your live environment.)

You can’t perform that action at this time.