{"id":15651691,"url":"https://github.com/log1x/modern-acf-options","last_synced_at":"2025-04-30T13:53:21.281Z","repository":{"id":62518649,"uuid":"228269211","full_name":"Log1x/modern-acf-options","owner":"Log1x","description":"A modern approach to ACF Theme Options","archived":false,"fork":false,"pushed_at":"2020-08-26T21:59:59.000Z","size":130,"stargazers_count":32,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-17T01:25:36.163Z","etag":null,"topics":["acf","acf-addon","mu-plugin","wordpress","wp-plugin"],"latest_commit_sha":null,"homepage":"https://github.com/Log1x/modern-acf-options","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Log1x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"Log1x"}},"created_at":"2019-12-15T23:46:27.000Z","updated_at":"2024-04-12T11:11:25.000Z","dependencies_parsed_at":"2022-11-02T13:46:08.099Z","dependency_job_id":null,"html_url":"https://github.com/Log1x/modern-acf-options","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fmodern-acf-options","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fmodern-acf-options/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fmodern-acf-options/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fmodern-acf-options/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Log1x","download_url":"https://codeload.github.com/Log1x/modern-acf-options/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251715101,"owners_count":21631834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acf","acf-addon","mu-plugin","wordpress","wp-plugin"],"created_at":"2024-10-03T12:39:43.819Z","updated_at":"2025-04-30T13:53:21.256Z","avatar_url":"https://github.com/Log1x.png","language":"CSS","funding_links":["https://github.com/sponsors/Log1x"],"categories":[],"sub_categories":[],"readme":"# Modern ACF Options\n\n![Latest Stable Version](https://img.shields.io/packagist/v/log1x/modern-acf-options?style=flat-square)\n![Total Downloads](https://img.shields.io/packagist/dt/log1x/modern-acf-options?style=flat-square)\n\nHere 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.\n\n![Screenshot](https://i.imgur.com/2ULki9H.png)\n\n## Requirements\n\n- [PHP](https://secure.php.net/manual/en/install.php) \u003e= 7.1.3\n- [Composer](https://getcomposer.org/download/)\n\n## Installation\n\n### Bedrock\n\nInstall via Composer:\n\n```bash\n$ composer require log1x/modern-acf-options\n```\n\n### Manual\n\nDownload the release `.zip` and install into `wp-content/plugins`.\n\n## Usage\n\nThe styling for Modern ACF Options requires the usage of `seamless` mode and tabs with their placement set to `left`.\n\n### Example using ACF Builder\n\n```php\nuse StoutLogic\\AcfBuilder\\FieldsBuilder;\n\nacf_add_options_page([\n    'page_title' =\u003e get_bloginfo('name'),\n    'menu_title' =\u003e 'Theme Options',\n    'menu_slug' =\u003e 'theme-options',\n    'update_button' =\u003e 'Update Options',\n    'capability' =\u003e 'edit_theme_options',\n    'position' =\u003e '999',\n    'autoload' =\u003e true,\n]);\n\n$options = new FieldsBuilder('theme_options', [\n    'style' =\u003e 'seamless',\n]);\n\n$options\n    -\u003esetLocation('options_page', '==', 'theme-options');\n\n$options\n    -\u003eaddTab('general')\n        -\u003esetConfig('placement', 'left')\n\n        -\u003eaddAccordion('customization')\n          -\u003eaddImage('logo')\n\n        -\u003eaddAccordion('tracking')\n            -\u003eaddText('gtm')\n                -\u003esetConfig('label', 'Google Tag Manager')\n        -\u003eaddAccordion('tracking_end')-\u003eendpoint()\n\n    -\u003eaddTab('advanced')\n        -\u003esetConfig('placement', 'left')\n\n        -\u003eaddTrueFalse('debug')\n          -\u003esetConfig('ui', '1');\n\nacf_add_local_field_group($options-\u003ebuild());\n```\n\n## Customization\n\nTo 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:\n\n```php\nadd_filter('acf_color_palette', function () {\n    return [\n        'brand' =\u003e '#0073aa',\n        'trim' =\u003e '#181818',\n    ];\n});\n```\n\n### Disabling Screen Options Tab\n\n```php\nuse Illuminate\\Support\\Str;\n\n/**\n * Disable Screen Options on the theme options page.\n *\n * @param  bool       $show\n * @param  \\WP_Screen $screen\n * @return bool\n */\nadd_filter('screen_options_show_screen', function ($show, $screen) {\n    if (is_a($screen, 'WP_Screen') \u0026\u0026 Str::contains($screen-\u003ebase, 'theme-options')) {\n        return false;\n    }\n}, 1, 2);\n```\n\n### Remove Admin Footer Text\n\n```php\n/**\n * Remove admin footer text.\n *\n * @return bool\n */\nadd_filter('admin_footer_text', '__return_false', 100);\n```\n\n## Development\n\nModern ACF Options is built using TailwindCSS and compiled with Laravel Mix.\n\n```bash\n$ yarn install\n$ yarn run start\n```\n\n### Todo\n\n- Continue optimizing/cleaning up existing styles.\n- Add styles for ACF switches, input fields (focus, hover), buttons, etc.\n\n## Bug Reports\n\nIf you discover a bug in Modern ACF Options, please [open an issue](https://github.com/log1x/modern-acf-options/issues).\n\n## Contributing\n\nContributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.\n\n## License\n\nModern ACF Options is provided under the [MIT License](https://github.com/log1x/modern-acf-options/blob/master/LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flog1x%2Fmodern-acf-options","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flog1x%2Fmodern-acf-options","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flog1x%2Fmodern-acf-options/lists"}