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
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 acf-country
ACF Country field
Adds a 'Country' field type for the Advanced Custom Fields WordPress plugin (free or PRO).
Overview
Display a select list of all countries in your language.
Country names are available in every language (see available list, generated from Unicode CLDR via symfony/intl). By default, country names are localized in your current WordPress language.
Select a single value:
Or multiple ones:
Requirements
- WordPress 6.0+
- PHP 8.2+
- ACF 6.0+ (free or PRO)
Field options
| Option | Default | Description |
|---|---|---|
| Default value | empty | Default country, as a country code (e.g. FR) |
| Allow null | false |
Allow an empty value |
| Select multiple values | false |
Allow selecting several countries |
| Stylized UI | false |
Use an enhanced select field (Select2) |
| Return format | array |
See below |
Return formats
Values are stored as ISO 3166-1 alpha-2 codes. get_field() returns, for France:
| Return format | Value |
|---|---|
Country code and name (array) |
['value' => 'FR', 'label' => 'France'] |
Country code (value) |
'FR' |
Country name (name) |
'France' |
Country emoji flag (emoji) |
'🇫🇷' |
With multiple values, you get an array of those. Country names use the site language.
Since codes are stored, you can query posts by country:
For a multiple field, values are serialized: compare with 'LIKE' and '"FR"'.
Public functions
Classes and methods marked @internal are not part of the public API and may change in minor versions.
Filters
You can remove (or add) some countries with the acf/country/countries filter, example:
The filter also receives the locale of the list as a second argument. Admin screens use the language of the logged-in user, while values returned by get_field() use the site language.
Integrations
- REST API: the field schema lists the country codes, and invalid codes are rejected.
- Admin Columns 7+ (free or Pro): custom field columns show flags and country names.
- WPGraphQL for ACF 2+: country fields are exposed as an
AcfCountryobject (code,name,emoji), or a list of them for multiple fields.
Installation
Zip
Download acf-country.zip from the latest release and extract it to your plugins folder. The "Source code" archives GitHub adds to each release are not installable: they lack the autoloader.
Composer
Composer installs use your project's autoloader: the site must load Composer's vendor/autoload.php, as Bedrock does. Without an autoloader, the plugin shows an admin notice and stays inactive.
Upgrading
From 3.x, see UPGRADE-4.0.
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 supporting it on Open Collective.
