Installing

Simply install the plugin from the marketplace or clone the repository as mentioned in the Getting Started section.

You can then access the FormWidget in your model's fields.yaml file by including \LMBdev\GooglePlaces\FormWidgets\GooglePlaces as the field type.

googleplace:
    span: auto
    label: 'Google Place'
    type: \LMBdev\GooglePlaces\FormWidgets\GooglePlaces
    modelClass: \Author\Plugins\Models\ModelName
    selectFrom: googleplace
    pattern: text

Note: You may name your field whatever you wish so long as it represents a database column for your model.

Additional Information

You can access additional information on the place using any of the standard attributes offered by the Places Library.

For example:

place.place_id //Will return the place id
place.name //Will return the place name

The componentForm variable in js/googleplaces.js contains a list of accessible attributes.

var componentForm = {
    street_number: 'short_name',
    route: 'long_name', //street
    locality: 'long_name', //city
    administrative_area_level_1: 'short_name', //state
    country: 'long_name',
    postal_code: 'short_name'
};

If you wish to store these values in your model's form, you should add the respective columns to your model and add the fields to your model's fields.yaml file.

Built With

• OctoberCMS
• Google Maps Places Library API

Contributing

Please feel free to (message me)[mailto:lbarker@wwrfresource.com] with comments, questions, or concerns. You can also submit a pull request to the respository.

Versioning

I use use Github for versioning.

Authors

• Larry Barker - Initial work - LMBDEV

License

This project is licensed under the MIT License.

Acknowledgments

• Thanks to the October community.
• @axly For help with passing PHP variables to JS files.
• It was brought to my attention that RainLab has a Location Plugin that offers very similar features and may even be better as far as extensibility goes.