PHPackages log1x/modern-acf-options - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. log1x/modern-acf-options ActiveWordpress-muplugin log1x/modern-acf-options ======================== A modern take on ACF Theme Options v1.0.3(5y ago)3431.3k↓32.4%22MITCSSPHP >=7.1.3 Since Dec 15Pushed 5y ago4 watchersCompare [ Source](https://github.com/Log1x/modern-acf-options)[ Packagist](https://packagist.org/packages/log1x/modern-acf-options)[ GitHub Sponsors](https://github.com/Log1x)[ RSS](/packages/log1x-modern-acf-options/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)Dependencies (1)Versions (5)Used By (2) Modern ACF Options ================== [](#modern-acf-options) [![Latest Stable Version](https://camo.githubusercontent.com/c295ebc78ded890c9bd9c9be2b1b1dfda9f0aabd7228b5d1e3f5d0e388fc6c54/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6f6731782f6d6f6465726e2d6163662d6f7074696f6e733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/c295ebc78ded890c9bd9c9be2b1b1dfda9f0aabd7228b5d1e3f5d0e388fc6c54/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6f6731782f6d6f6465726e2d6163662d6f7074696f6e733f7374796c653d666c61742d737175617265)[![Total Downloads](https://camo.githubusercontent.com/0c022c2664ca7930e38247c585fdf81ec2b3340df0b1c60ce2373831e6724429/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6f6731782f6d6f6465726e2d6163662d6f7074696f6e733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/0c022c2664ca7930e38247c585fdf81ec2b3340df0b1c60ce2373831e6724429/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6f6731782f6d6f6465726e2d6163662d6f7074696f6e733f7374796c653d666c61742d737175617265) Here lives a simple `mu-plugin` to modernize and brand theme options created with ACF. No admin panels, no bloat – just a simple filter to optionally customize the CSS properties with your color palette. [![Screenshot](https://camo.githubusercontent.com/dd7d4126905ded57c66f4e032d0a96a2dfad576e5100106aadef11d480aa4cc5/68747470733a2f2f692e696d6775722e636f6d2f32554c6b6939482e706e67)](https://camo.githubusercontent.com/dd7d4126905ded57c66f4e032d0a96a2dfad576e5100106aadef11d480aa4cc5/68747470733a2f2f692e696d6775722e636f6d2f32554c6b6939482e706e67) Requirements ------------ [](#requirements) - [PHP](https://secure.php.net/manual/en/install.php) >= 7.1.3 - [Composer](https://getcomposer.org/download/) Installation ------------ [](#installation) ### Bedrock [](#bedrock) Install via Composer: ``` $ composer require log1x/modern-acf-options ``` ### Manual [](#manual) Download the release `.zip` and install into `wp-content/plugins`. Usage ----- [](#usage) The styling for Modern ACF Options requires the usage of `seamless` mode and tabs with their placement set to `left`. ### Example using ACF Builder [](#example-using-acf-builder) ``` use StoutLogic\AcfBuilder\FieldsBuilder; acf_add_options_page([ 'page_title' => get_bloginfo('name'), 'menu_title' => 'Theme Options', 'menu_slug' => 'theme-options', 'update_button' => 'Update Options', 'capability' => 'edit_theme_options', 'position' => '999', 'autoload' => true, ]); $options = new FieldsBuilder('theme_options', [ 'style' => 'seamless', ]); $options ->setLocation('options_page', '==', 'theme-options'); $options ->addTab('general') ->setConfig('placement', 'left') ->addAccordion('customization') ->addImage('logo') ->addAccordion('tracking') ->addText('gtm') ->setConfig('label', 'Google Tag Manager') ->addAccordion('tracking_end')->endpoint() ->addTab('advanced') ->setConfig('placement', 'left') ->addTrueFalse('debug') ->setConfig('ui', '1'); acf_add_local_field_group($options->build()); ``` Customization ------------- [](#customization) To customize the color palette, simply pass an array containing one or more of the colors you would like to change to the `acf_color_palette` filter: ``` add_filter('acf_color_palette', function () { return [ 'brand' => '#0073aa', 'trim' => '#181818', ]; }); ``` ### Disabling Screen Options Tab [](#disabling-screen-options-tab) ``` use Illuminate\Support\Str; /** * Disable Screen Options on the theme options page. * * @param bool $show * @param \WP_Screen $screen * @return bool */ add_filter('screen_options_show_screen', function ($show, $screen) { if (is_a($screen, 'WP_Screen') && Str::contains($screen->base, 'theme-options')) { return false; } }, 1, 2); ``` ### Remove Admin Footer Text [](#remove-admin-footer-text) ``` /** * Remove admin footer text. * * @return bool */ add_filter('admin_footer_text', '__return_false', 100); ``` Development ----------- [](#development) Modern ACF Options is built using TailwindCSS and compiled with Laravel Mix. ``` $ yarn install $ yarn run start ``` ### Todo [](#todo) - Continue optimizing/cleaning up existing styles. - Add styles for ACF switches, input fields (focus, hover), buttons, etc. Bug Reports ----------- [](#bug-reports) If you discover a bug in Modern ACF Options, please [open an issue](https://github.com/log1x/modern-acf-options/issues). Contributing ------------ [](#contributing) Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated. License ------- [](#license) Modern ACF Options is provided under the [MIT License](https://github.com/log1x/modern-acf-options/blob/master/LICENSE.md). ### Health Score 35 — LowBetter than 80% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity37 Limited adoption so far Community14 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~85 days Total 4 Last Release 2091d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5745907?v=4)[Brandon](/maintainers/Log1x)[@Log1x](https://github.com/Log1x) --- Top Contributors [![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (5 commits)") --- Tags acfacf-addonmu-pluginwordpresswp-pluginwordpressacfwp-admintheme-options ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/log1x-modern-acf-options/health.svg) ``` [![Health](https://phpackages.com/badges/log1x-modern-acf-options/health.svg)](https://phpackages.com/packages/log1x-modern-acf-options) ``` ### Alternatives [airesvsg/acf-to-rest-api Exposes Advanced Custom Fields Endpoints in the WordPress REST API 1.4k75.0k](/packages/airesvsg-acf-to-rest-api)[vinkla/extended-acf Register advanced custom fields with object-oriented PHP 503264.8k11](/packages/vinkla-extended-acf)[samrap/acf-fluent A fluent interface for the Advanced Custom Fields WordPress plugin 28656.0k4](/packages/samrap-acf-fluent)[devgeniem/acf-codifier ACF Codifier 133215.1k19](/packages/devgeniem-acf-codifier)[php-stubs/acf-pro-stubs Advanced Custom Fields PRO stubs for static analysis. 73692.8k50](/packages/php-stubs-acf-pro-stubs)[log1x/acf-editor-palette A replica Gutenberg color picker field for Advanced Custom Fields. 100284.1k](/packages/log1x-acf-editor-palette) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)