Download the PHP package hellonico/acf-country without Composer
On this page you can find all versions of the php package hellonico/acf-country. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hellonico/acf-country
More information about hellonico/acf-country
Files in hellonico/acf-country
Informations about the package acf-country
ACF Country field
Adds a 'Country' field type for the Advanced Custom Fields WordPress plugin.
⚠️ WARNING ⚠️
From version 2.0.0, ACF Country introduced some important breaking changes:
- Dropped support for older PHP & ACF versions, new requirements are:
- ACF 5.7+
- PHP 5.4+
- Return format has changed. To better stick to ACF and make use of ACF functions, ACF Country will now return values the same way select field do.
['FR' => 'France']
will now look like['label' => 'France', 'value' => 'FR']
Looking for a ACF pre 5.7 support? Check the 1.0 branch.
Overview
Display a select list of all countries in your language.
Country names are available in every language (see available list). By default, country names are localized in your current WordPress language.
Select a single value:
Or multiple ones:
Compatibility
- ACF 5.7+
- PHP 5.4+
Field options
Option | Default | Description |
---|---|---|
Default value | emtpy | Set a default value for the country field (as country code) |
Allow null | false |
Enable/disable null value |
Allow multiple | false |
Enable/disable multiple countries selection |
Stylised UI | true |
Enable/disable enhanced select field thanks to Select2 |
Return format | value |
See ACF Select field |
Filters
You can remove (or add) some countries with the acf/country/countries
filter, example:
Note: PHP5.6+ example
Installation
Zip
Download the plugin and extract the archive to your plugins folder.
Composer
Contributing
See CONTRIBUTING.
Support
This ACF field was originally developed for a personal project I don't use anymore. I still decided to maintain it anyway. If you use it in a commercial project, please consider buying me a beer.