https://github.com/beapi/acf-options-for-polylang
A WordPress plugin for adding ACF options page support for Polylang.
https://github.com/beapi/acf-options-for-polylang
acf acf-options options polylang wordpress-plugin
Last synced: 6 months ago
JSON representation
A WordPress plugin for adding ACF options page support for Polylang.
- Host: GitHub
- URL: https://github.com/beapi/acf-options-for-polylang
- Owner: BeAPI
- License: other
- Created: 2016-03-08T15:19:25.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-03-27T08:08:09.000Z (6 months ago)
- Last Synced: 2025-04-03T02:48:39.602Z (6 months ago)
- Topics: acf, acf-options, options, polylang, wordpress-plugin
- Language: PHP
- Homepage: https://wordpress.org/plugins/acf-options-for-polylang/
- Size: 500 KB
- Stars: 172
- Watchers: 11
- Forks: 29
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# BEA - ACF Options For Polylang
[](https://www.codefactor.io/repository/github/beapi/acf-options-for-polylang)
You are using Advanced Custom Fields for creating option pages and you have Polylang installed for awsome multilingual site ?
Sadly, Polylang is not handling ACF's Option Pages. Which means values will be the same for all languages you have set.
We are here to save your life ! Once this plugin is activated, you will be able to set a different value for each language, and if none is set, the "All languages" value will be used as default one.
# How ?
This plugin will store a value for each language into database. Then Polylang's languages are used to get the values from the DB. That means at activation, all existing data will not be anymore available, but still in database. You will retrieve it ad plugin deactivation.
Then to set and contribute your option page, simply use the Polylang's language admin flags ui.
# Requirements
- Require [WordPress](https://wordpress.org/) 4.7+ / Tested up to 5.2
- Require PHP 5.6
- [Advanced Custom Fields](https://www.advancedcustomfields.com/pro) 5.6.0+
- [Polylang](https://polylang.pro/)
# Installation
First activate and configure Polylang in you site.
Then activate ACF Options For Polylang to handle ACF Options in setted Polylang's languages.
## WordPress
- Download and install using the built-in WordPress plugin installer.
- Site activate in the "Plugins" area of the admin.
- Optionally drop the entire `acf-options-for-polylang` directory into mu-plugins.
- Nothing more, this plugin is ready to use !
## [Composer](http://composer.rarst.net/)
- `composer require wpackagist-plugin/acf-options-for-polylang`
- Nothing more, this plugin is ready to use !
# What ?
## Features
- Almost simple fields (text, textarea, links, etc)
- Repeater fields (with simple fields)
## More features to come
As you can see, some [issues](../../issues?q=is%3Aissue+is%3Aopen+label%3Aquestion) are feature requests :
- Migration of data for using plugin : at activation, all data will not be anymore available, but still in database.
- Migration of data for not using plugin anymore
## Next Roadmap
- Fixing [#41] : repeater issue when need to get all languages one.
## Contributing
Please refer to the [contributing guidelines](.github/CONTRIBUTING.md) to increase the chance of your pull request to be merged and/or receive the best support for your issue.
### Issues & features request / proposal
If you identify any errors or have an idea for improving the plugin, feel free to open an [issue](../../issues/new). Please provide as much info as needed in order to help us resolving / approve your request.
## For developers
## Using fields
Nothing change, we have made all the hooks for you, so no need to prefix your fields with a lang or something else.
Only use ACF's helpers to get and show the fields as you did before with [get_field()](https://www.advancedcustomfields.com/resources/get_field/) or the_field() :
`get_field( 'footer_disclaimer', 'options' );`
## Excluding options pages
If you don't want this functionality on a certain options page, add the `post_id` to the list of excluded options pages.
```
add_filter( 'bea.aofp.excluded_post_ids', function($ids) {
$ids[] = 'custom_options_page_post_id';
return $ids;
}, 10, 1 );
```
## Default values (with "All languages")
The plugin is designed to get the Polylang "All languages" value if the current lang one is empty. But if you are not interested about this behaviour, you can programmatically deactivate it using the following filter by setting to false.
### For all ACF Options pages
```