Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mattrothenberg/location

A Location Autocomplete Field for Statamic V3
https://github.com/mattrothenberg/location

algolia algolia-places statamic statamic-v3 vue

Last synced: about 1 month ago
JSON representation

A Location Autocomplete Field for Statamic V3

Awesome Lists containing this project

README

        

# Mattrothenberg\Location
A Location Autocomplete Field for Statamic V3

## Why?
The inspiration for publishing this addon came from writing the following blog post.

[https://dev.to/mattrothenberg/build-a-location-autocomplete-field-for-statamic-v3-49cp](https://dev.to/mattrothenberg/build-a-location-autocomplete-field-for-statamic-v3-49cp)

Co-locating a custom fieldtype within your Statamic app is one thing... Building an addon so that other folks can use it, too, is another. This is the fruit of my labor!

## Installation

(shamelessly cribbed from https://github.com/riasvdv/statamic-color-swatches)

Clone the Github repo somewhere, then add it to your composer.json's repositories array. (This is only necessary until the package is released.) Adjust the url to point to cloned directory.

```
"repositories": [
{
"type": "path",
"url": "addons/mattrothenberg/location"
}
]
```

Require it using Composer.

```
composer require mattrothenberg/location
```

Publish the assets

```
php artisan vendor:publish --provider="Mattrothenberg\Location\ServiceProvider"
```

Add two environment variables, since this library uses [Places.js](https://github.com/algolia/places) under the hood for location autocompletion.

```
PLACES_APP_ID=""
PLACES_API_KEY=""
```