/acf-beautiful-flexible

Transform ACF's flexible layouts list into a beautiful popup.

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

ACF Beautiful Flexible

Transform ACF's flexible layouts list into a beautiful popup.

Screenshot Before/After Beautiful Flexible

To use ACF Beautiful Flexible, simply activate the plugin to improve the ACF flexible UI. By default, it uses random images, but the idea is to customize them by adding your own.

Image convention

  • The size of the image should be 366x150 or bigger, into 732x300.
  • They should be named based on the flexible key (push_2_light) with no underscores but dashes (push-2-light.[extension]).
  • The following extensions will be resolved in that order: .jpg, .jpeg, .png and .gif.

Where images should be situated

They should more likely be situated into your theme wp-content\themes\my-theme\assets\acf-beautiful-flexible\. But if you have a child-theme and added images into it, these will overwrite those from parent-theme. The following directories will be solved according to order: plugin's folder, child theme's folder, theme's folder.

Also note that you can filter this path to gather all your images into a same folder:

add_filter( 'acf_beautiful_flexible.images_path', $path );

Finally, you could filter all images like this:

add_filter( 'acf_beautiful_flexible.images', $images );

Requirements

Installation

WordPress

  • Download and install using the built-in WordPress plugin installer.
  • Site activate in the "Plugins" area of the admin.
  • Then add your awesome layouts images.
  • Alternatively add the source.
  • Include "wpackagist-plugin/acf-beautiful-flexible":"dev-trunk" in your composer file for last commits.
  • Then add your awesome layouts images.

Contributing

Please refer to the contributing guidelines to increase the chance of your pull request being merged and/or receiving the best support for your issue.

If you identify any errors or have an idea for improving the plugin, feel free to open an issue or create a pull request. Please provide as much info as needed in order to help me resolve/approve your request.

Credits

I, Maxime Culea, have created this plugin which I only maintain. I do not guarantee some free support. Also, thank others listed in the credits.

Finally, if you really like what I do or want to thank me for my work, feel free to donate, even 1€ is a great gift for buying some coffee :)