Download the PHP package studioespresso/craft-easyaddressfield without Composer
On this page you can find all versions of the php package studioespresso/craft-easyaddressfield. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-easyaddressfield
Easy Address Field plugin for Craft CMS 3.x
The only address field you need
Requirements
This plugin requires Craft CMS 3.0.0-RC1 or later.
Installation
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project -
Then tell Composer to load the plugin:
composer require studioespresso/craft-easyaddressfield - In the Control Panel, go to Settings → Plugins and click the “Install” button for "Easy Address Field".
Settings
You can choose which geocoding API the plugin will use when you have geocoding enabled for your fields. Options are:
- OpenStreetMap's Nominatim (default, no configuration, but very strict rate limits)
- Google Maps (requires an API key, see below)
Google Maps API
To enable geolocating and custom marker placement, you need to provide a Google Maps API key.
1) Sign in to Google's developers console
2) Create a new project
3) Enable the Google Maps Geocoding API and the Google Static Maps API
🚨 Important 🚨:
Google's Geocoding API does not support HTTP referrer restrictions. Make sure the API key you are using does not have these set.
API Errors
When devMode is enabled, any errors returned by Google's API will show an exception so you can clearly see what's going wrong. With devMode disabled, any errors will be logged to Craft's web.log.
GeoCoding for Craft Address elements
Since Craft 5, Craft has a built-in element for Addresses, but no way to get coordinates for addresses out of the box.
When you install Easy Address Field, you can enable GeoCoding for Craft Address elements. This will add a latitude and longitude values to each Address element.
You can enable this feature in the plugin settings.
Template variables
Printing address values
You can access the values from your address field in Twig through the following variables: `
Custom GeoCoding services
Out of the box, the plugin comes with support for geocoding with OpenStreetMap's Nominatim service and Google.
If you'd like to use a different service, you can create a custom service by creating a new class that implements the studioespresso\easyaddressfield\services\geocoders\BaseGeoCoder interface.
Once you created your geocoder, register it with the following event:
``
Upgrading from Craft 4 to Craft 5
getDirectionsUrl()
If you're using the getDirectionsUrl() function on craft.address, you'll now need to call the function on the field itself instead of the on the plugin's Twig variable.
getStaticMap() & getStaticMapRaw()
These functions have been removed from the plugin, you'll need to replace these yourself.
Brought to you by Studio Espresso
All versions of craft-easyaddressfield with dependencies
league/iso3166 Version ^3.0
giggsey/locale Version ^2.0.0
maxh/php-nominatim Version ^2.0