Title: ACF Options For Polylang
Author: Amaury Balmer
Published: <strong>7 mai 2019</strong>
Last modified: 4 mars 2026

---

Recherche d’extensions

![](https://ps.w.org/acf-options-for-polylang/assets/banner-772x250.png?rev=2504391)

![](https://ps.w.org/acf-options-for-polylang/assets/icon-256x256.png?rev=2504391)

# ACF Options For Polylang

 Par [Amaury Balmer](https://profiles.wordpress.org/momo360modena/)

[Télécharger](https://downloads.wordpress.org/plugin/acf-options-for-polylang.2.0.0.zip)

 * [Détails](https://fr.wordpress.org/plugins/acf-options-for-polylang/#description)
 * [Avis](https://fr.wordpress.org/plugins/acf-options-for-polylang/#reviews)
 *  [Installation](https://fr.wordpress.org/plugins/acf-options-for-polylang/#installation)
 * [Développement](https://fr.wordpress.org/plugins/acf-options-for-polylang/#developers)

 [Support](https://wordpress.org/support/plugin/acf-options-for-polylang/)

## Description

Are you using Advanced Custom Fields for option pages and Polylang for your multilingual
site?

Polylang does not natively support ACF Option Pages, so option values are shared
across all languages. This plugin improves that: once activated, you can set different
values per language. Values are stored per language in the database and the correct
one is loaded according to the current Polylang language. If a value isn’t set for
a language, the « All languages » value is used by default.

**Note:** On activation, existing option values become temporarily unavailable (
but remain in the database); you can recover them by deactivating the plugin. To
edit options for a language, use the Polylang language switcher in the admin bar
before opening the options page.

Requirements: WordPress 6.0+, PHP 7.4–8.4, [Advanced Custom Fields](https://www.advancedcustomfields.com/pro)
5.6.0+, [Polylang](https://polylang.pro/) (tested up to 3.7.7).

For full documentation (usage, filters, API, excluding pages, default fallback, 
loading untranslated values), see the [project README on GitHub](https://github.com/BeAPI/acf-options-for-polylang#readme).

## Captures d’écrans

 * [[
 * Use the Polylang language switcher in the admin bar to choose the language before
   editing ACF options.

## Installation

Activate and configure Polylang, then activate ACF Options For Polylang.

#### WordPress

 * Install via the built-in plugin installer, then activate in the « Plugins » screen.
 * Or place the `acf-options-for-polylang` folder in `wp-content/mu-plugins`.

#### Composer

 * `composer require wpackagist-plugin/acf-options-for-polylang`

## FAQ

### Do I need to change my theme code to use this plugin?

No. Use ACF’s get_field() and the_field() as before with the options page ID (e.
g. ‘options’). The plugin handles language automatically.

### What happens to my existing option values when I activate the plugin?

They become temporarily unavailable but remain in the database. You can recover 
them by deactivating the plugin. After activation, set or copy your values per language
using the Polylang language switcher in the admin bar.

### Where is the full documentation (filters, API, excluding pages)?

See the [README on GitHub](https://github.com/BeAPI/acf-options-for-polylang#readme).

## Avis

![](https://secure.gravatar.com/avatar/9df11b38b5679a99660e29369e583d120bb3bca0c445fcfe02fb8443765c9df3?
s=60&d=retro&r=g)

### 󠀁[Дуже допоміг, дякую!](https://wordpress.org/support/topic/%d0%b4%d1%83%d0%b6%d0%b5-%d0%b4%d0%be%d0%bf%d0%be%d0%bc%d1%96%d0%b3-%d0%b4%d1%8f%d0%ba%d1%83%d1%8e/)󠁿

 [kuh2101](https://profiles.wordpress.org/kuh2101/) 1 février 2024

Гарна робота, так тримати!

![](https://secure.gravatar.com/avatar/3c5b88e98e0e2fddbe61bedd90cc29444c6b222031574dd6b30dcd38c09061a0?
s=60&d=retro&r=g)

### 󠀁[Just thubsup](https://wordpress.org/support/topic/just-thubsup/)󠁿

 [Ruman](https://profiles.wordpress.org/rumaneee/) 10 mars 2023

Great

![](https://secure.gravatar.com/avatar/4d6647b8f0e191f2fca130872de1c1078eba26907979c250f31fee91ba9e54ee?
s=60&d=retro&r=g)

### 󠀁[Very very great job](https://wordpress.org/support/topic/very-very-great-job/)󠁿

 [starcoding](https://profiles.wordpress.org/starcoding/) 21 octobre 2022

I am never leaving a review to a WP plugins, but I am here to express my huge gratitude
for your work, its excellent!

![](https://secure.gravatar.com/avatar/2225189e8044df879b3326c1371fcd0b2ce35b545f212ee06d580bab8c273539?
s=60&d=retro&r=g)

### 󠀁[Confirmed: works perfectly!](https://wordpress.org/support/topic/confirmed-works-perfectly/)󠁿

 [cvladan](https://profiles.wordpress.org/cvladan/) 17 juillet 2022

Thank you for this amazing plugin!

![](https://secure.gravatar.com/avatar/822f6208b4d73ee725401e843820dee466442982b99cb41c33b6e9c10e242cb6?
s=60&d=retro&r=g)

### 󠀁[Saved my life!](https://wordpress.org/support/topic/saved-my-life-74/)󠁿

 [hexcross](https://profiles.wordpress.org/hexcross/) 16 février 2022

What a great plugin!

![](https://secure.gravatar.com/avatar/89b43d8d32b1049c31184d69670160c3bb02d1f74506aaf427b2f921278eb5a1?
s=60&d=retro&r=g)

### 󠀁[Awesome](https://wordpress.org/support/topic/awesome-9282/)󠁿

 [hilmon](https://profiles.wordpress.org/hilmon/) 14 février 2022

Just what I needed …. You really did just save my life 🙂

 [ Lire les 17 avis ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/)

## Contributeurs/contributrices & développeurs/développeuses

« ACF Options For Polylang » est un logiciel libre. Les personnes suivantes ont 
contribué à cette extension.

Contributeurs

 *   [ Amaury Balmer ](https://profiles.wordpress.org/momo360modena/)
 *   [ BE API ](https://profiles.wordpress.org/beapi/)
 *   [ Maxime Culea ](https://profiles.wordpress.org/maximeculea/)
 *   [ NicolasKulka ](https://profiles.wordpress.org/nicolaskulka/)

“ACF Options For Polylang” a été traduit dans 5 locales. Remerciez [l’équipe de traduction](https://translate.wordpress.org/projects/wp-plugins/acf-options-for-polylang/contributors)
pour ses contributions.

[Traduisez « ACF Options For Polylang » dans votre langue.](https://translate.wordpress.org/projects/wp-plugins/acf-options-for-polylang)

### Le développement vous intéresse ?

[Parcourir le code](https://plugins.trac.wordpress.org/browser/acf-options-for-polylang/),
consulter le [SVN dépôt](https://plugins.svn.wordpress.org/acf-options-for-polylang/),
ou s’inscrire au [journal de développement](https://plugins.trac.wordpress.org/log/acf-options-for-polylang/)
par [RSS](https://plugins.trac.wordpress.org/log/acf-options-for-polylang/?limit=100&mode=stop_on_copy&format=rss).

## Journal des modifications

#### 2.0.0 – 16 February 2025

**Breaking Changes**
 * Minimum PHP version raised from 5.6 to 7.4 * Minimum WordPress
version raised from 4.7 to 6.0

**New Features**
 * Configurable Polylang language attribute for option key suffix:
constant BEA_ACF_OPTIONS_FOR_POLYLANG_LANG_ATTRIBUTE, helper Helpers::get_lang_attribute(),
and filter bea.aofp.lang_attribute allow using slug (or other Polylang fields) instead
of default locale * Added comprehensive unit testing suite with PHPUnit (41 test
methods) * Added wp-env configuration for Docker-based testing environment * Added
GitHub Actions CI/CD workflows for automated testing * Test coverage across PHP 
7.4-8.4 and WordPress 6.0-6.9 * Added TESTING.md documentation for developers

**Improvements**
 * Updated all development dependencies to latest versions * WordPress
Coding Standards 3.1 (WP 6.0+ support) * PHPUnit 9.6/10.0/11.0 multi-version support*
Enforced modern short array syntax [] * Updated plugin header with all standard 
WordPress fields * Updated copyright to 2025 * Removed custom PHP version check 
and compat.php; PHP requirement is now enforced by WordPress Requires PHP header

**Documentation**
 * Documented language attribute override (constant and filter)
in README

**Code Quality**
 * 100% compliance with WordPress Coding Standards * Automated 
testing on 66 PHP/WordPress combinations * Code coverage reporting with Codecov *
Automated code quality checks

#### 1.1.12 – 26 March 2025

– FIX: Resolved an issue where the plugin would sometimes deactivate randomly on
multisite installations when visiting a site.

= 1.1.11 – 27 July 2023
 – Tested up on WP 6.2

= 1.1.10 – 1 Sept 2021
 – FIX: WordPress.org version generation

= 1.1.9 – 1 Sept 2021
 – FIX: ACF 5.6.0 version check – FEATURE: Add new filter 
bea.aofp.excluded_post_ids to skip page ids

= 1.1.8 – 27 March 2021
 – FIX : Rest API returns now the right value – FIX : Ajax
requests where not localized – FIX : Compatibility with new versions of ACF

#### 1.1.7 – 07 May 2019

– Feature: Add a context-sensitive help to the user on ACF options page (tired of
updating the generic options …)
 – Improve: object detection from ACF with get_field()–
Feature: Add translation POT and french translation – FEATURE [#31](https://github.com/BeAPI/acf-options-for-polylang/issues/31):
Brand for wp.org – Test: Test up on WP 5.2 – FIX [#41](https://github.com/BeAPI/acf-options-for-polylang/issues/41):
fix bug with all language failback and repeater

#### 1.1.6 – 19 Mar 2019

– FIX [#32](https://github.com/BeAPI/acf-options-for-polylang/issues/32) & [#40](https://github.com/BeAPI/acf-options-for-polylang/issues/40):
fix `get_field()` if an object is provided (WP Term, WP Post, WP Comment)

#### 1.1.5 – 11 Dec 2018

– FIX wrong constant

#### 1.1.4 – 13 Nov 2018

– Refactor by adding the Helpers class
 – FEATURE [#26](https://github.com/BeAPI/acf-options-for-polylang/issues/26):
allow to precise to show or hide default values for a specific option page – FEATURE
[#21](https://github.com/BeAPI/acf-options-for-polylang/pull/21) : handle custom
option id

#### 1.1.3 – 2 Aug 2018

– FEATURE [#23](https://github.com/BeAPI/acf-options-for-polylang/pull/23) : requirement
to php5.6 whereas namespace are 5.3

#### 1.1.2 – 31 Jul 2018

– FIX [#22](https://github.com/BeAPI/acf-options-for-polylang/pull/22) : error with
repeater fields default values

#### 1.1.1 – 9 Mai 2018

– FIX [#15](https://github.com/BeAPI/acf-options-for-polylang/issues/15) : way requirements
are checked to trigger on front / admin

#### 1.1.0 – Mar 2018

– True (complet) plugin.
 – Add check for ACF 5.6.

#### 1.0.2 – 23 Dec 2017

– Refactor and reformat.
 – Handle all options page and custom post_id. – Now load
only if ACF & Polylang are activated. – Load later at plugins loaded.

#### 1.0.1 – 19 Sep 2016

– Plugin update.

#### 1.0.0 – 8 Mar 2016

– Init plugin.

## Méta

 *  Version **2.0.0**
 *  Dernière mise à jour **il y a 1 mois**
 *  Installations actives **10 000+**
 *  Version de WordPress ** 6.0 ou plus **
 *  Testé jusqu’à **6.9.4**
 *  Version de PHP ** 7.4 ou plus **
 *  Langues
 * [English (US)](https://wordpress.org/plugins/acf-options-for-polylang/), [French (France)](https://fr.wordpress.org/plugins/acf-options-for-polylang/),
   [German](https://de.wordpress.org/plugins/acf-options-for-polylang/), [Persian](https://fa.wordpress.org/plugins/acf-options-for-polylang/),
   [Russian](https://ru.wordpress.org/plugins/acf-options-for-polylang/), et [Swedish](https://sv.wordpress.org/plugins/acf-options-for-polylang/).
 *  [Traduisez la dans votre langue](https://translate.wordpress.org/projects/wp-plugins/acf-options-for-polylang)
 * Étiquettes
 * [acf](https://fr.wordpress.org/plugins/tags/acf/)[option](https://fr.wordpress.org/plugins/tags/option/)
   [options](https://fr.wordpress.org/plugins/tags/options/)[options page](https://fr.wordpress.org/plugins/tags/options-page/)
   [polylang](https://fr.wordpress.org/plugins/tags/polylang/)
 *  [Vue avancée](https://fr.wordpress.org/plugins/acf-options-for-polylang/advanced/)

## Évaluations

 4.4 sur 5 étoiles.

 *  [  14 avis à 5 étoiles     ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/?filter=5)
 *  [  0 avis à 4 étoile     ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/?filter=4)
 *  [  0 avis à 3 étoile     ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/?filter=3)
 *  [  1 avis à 2 étoile     ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/?filter=2)
 *  [  2 avis à 1 étoiles     ](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/#new-post)

[Voir tous les avis](https://wordpress.org/support/plugin/acf-options-for-polylang/reviews/)

## Contributeurs

 *   [ Amaury Balmer ](https://profiles.wordpress.org/momo360modena/)
 *   [ BE API ](https://profiles.wordpress.org/beapi/)
 *   [ Maxime Culea ](https://profiles.wordpress.org/maximeculea/)
 *   [ NicolasKulka ](https://profiles.wordpress.org/nicolaskulka/)

## Support

Quelque chose à dire ? Besoin d’aide ?

 [Voir le forum de support](https://wordpress.org/support/plugin/acf-options-for-polylang/)

## Faire un don

Souhaitez-vous soutenir l’avancement de cette extension ?

 [ Faire un don à cette extension ](https://www.paypal.me/BeAPI)