studioespresso / craft-easyaddressfield
The only address field you need
Installs: 16 286
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 4
Forks: 3
Type:craft-plugin
Requires
- craftcms/cms: ^5.0.0-alpha
- giggsey/locale: ^2.0.0
- league/iso3166: ^3.0
- maxh/php-nominatim: ^2.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
- craftcms/rector: dev-main
This package is auto-updated.
Last update: 2024-04-23 15:32:11 UTC
README
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".
Template variables
Printing address values
You can access the values from your address field in Twig through the following variables:
field.name field.street field.street2 field.postalCode field.state field.country // returns the country code field.getCountryName(craft.app.locale) // returns the coutry's full name, in the country's locale field.latitude field.longitude field.getDirectionsUrl() // get a directions link to the given address
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.