flexible-layout-preview-image-for-acf
Last commit date
assets
1 year ago
CHANGELOG.md
1 year ago
LICENSE.md
1 year ago
README.md
1 year ago
flexible-layout-preview-image-for-acf.php
1 year ago
readme.txt
1 year ago
README.md
113 lines
| 1 | # Flexible Layout Preview Image for ACF |
| 2 | |
| 3 | **Contributors:** galaxyweblinks, gwlwp |
| 4 | **Donate link:** [https://galaxyweblinks.com/] |
| 5 | **Tags:** acf, advanced custom fields, flexible content, layout preview, admin |
| 6 | **Requires at least:** 5.0 |
| 7 | **Tested up to:** 6.8 |
| 8 | **Requires PHP:** 7.4 |
| 9 | **Requires Plugins:** advanced-custom-fields (>= 5.0) |
| 10 | **Stable tag:** 1.3 |
| 11 | **License:** GPLv2 or later |
| 12 | **License URI:** [](https://www.gnu.org/licenses/gpl-2.0.htmlhttps://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) |
| 13 | |
| 14 | Adds flexible layout preview images for Advanced Custom Fields (ACF) in the WordPress admin. |
| 15 | |
| 16 | ## Description |
| 17 | |
| 18 | **Flexible Layout Preview Image for ACF** is a WordPress plugin that enhances the admin experience by adding custom images to the previews of flexible layouts created using Advanced Custom Fields (ACF). This visual aid helps administrators quickly identify and manage various layout blocks within ACF flexible content fields. |
| 19 | |
| 20 | Here’s a link to the documentation for the plugin. This will help you learn more about its features and how to use it. |
| 21 | <strong>[Documentation](https://wp-plugins.galaxyweblinks.com/wp-plugins/flexible-layout-preview-image-for-acf/)</strong> |
| 22 | For any feedback or queries regarding this plugin, please contact our [Support team](https://wp-plugins.galaxyweblinks.com/contact/). |
| 23 | |
| 24 | |
| 25 | ### Features |
| 26 | |
| 27 | - Adds preview images for ACF flexible content layouts in the WordPress admin. |
| 28 | - Automatically detects and applies images stored in your theme directory. |
| 29 | - Allows developers to customize image paths via filters. |
| 30 | - Works seamlessly with the ACF plugin. |
| 31 | |
| 32 | ### How It Works |
| 33 | |
| 34 | Place your custom preview images in your theme directory at `/lib/admin/images/flexible-layout-preview-image-for-acf/` with filenames matching the ACF layout names (e.g., `layout-name.jpg`). The plugin will automatically display these images in the ACF layout preview popups. |
| 35 | |
| 36 | ## Installation |
| 37 | |
| 38 | 1. **Upload the Plugin Files:** Upload the `flexible-layout-preview-image-for-acf` folder to the `/wp-content/plugins/` directory. |
| 39 | 2. **Activate the Plugin:** Activate the plugin through the 'Plugins' screen in WordPress. |
| 40 | 3. **Add Preview Images:** Place your layout preview images in your active theme's directory at `/lib/admin/images/flexible-layout-preview-image-for-acf/` with filenames corresponding to the layout names. |
| 41 | 4. **View in Admin:** Go to any page or post editor where you have ACF flexible content fields. You'll see the preview images in the ACF layout selection popup. |
| 42 | |
| 43 | ## Frequently Asked Questions |
| 44 | |
| 45 | **What is required for this plugin to work?** |
| 46 | |
| 47 | You need to have the Advanced Custom Fields (ACF) plugin installed and active on your WordPress site. |
| 48 | |
| 49 | **Where do I place my custom layout preview images?** |
| 50 | |
| 51 | Place your images in your active theme's directory at `/lib/admin/images/flexible-layout-preview-image-for-acf/`. The images should be named according to your ACF layout names (e.g., `layout-name.jpg`). |
| 52 | |
| 53 | **What if an image is not found?** |
| 54 | |
| 55 | If an image for a specific layout is not found in the specified directory, the plugin will display a default image. |
| 56 | |
| 57 | **Can I customize the path where images are loaded from?** |
| 58 | |
| 59 | Yes, developers can use the `flexible_layout_preview-image_for_acf_images_path` filter to customize the path where images are loaded from. |
| 60 | |
| 61 | ## Screenshots |
| 62 | |
| 63 | 1. **Flexible Layout Preview in Admin:** Screenshot showing the preview images in the ACF flexible layout popup. |
| 64 | 2. **Custom Layout Image Path:** Example of the folder structure and custom images in the theme directory. |
| 65 | |
| 66 | ## Changelog |
| 67 | |
| 68 | **1.3** |
| 69 | * Stable release. |
| 70 | |
| 71 | **1.2** |
| 72 | * Stable release. |
| 73 | |
| 74 | **1.1** |
| 75 | * Stable release. |
| 76 | |
| 77 | **1.0.0** |
| 78 | * Initial release of the plugin. |
| 79 | * Added functionality to display custom layout preview images in ACF flexible content fields. |
| 80 | * Supports image customization via filters. |
| 81 | |
| 82 | ## Upgrade Notice |
| 83 | |
| 84 | **1.3** |
| 85 | * Stable release. |
| 86 | |
| 87 | **1.2** |
| 88 | * Stable release. |
| 89 | |
| 90 | **1.1** |
| 91 | * Stable release. |
| 92 | |
| 93 | **1.0.0** |
| 94 | * Initial release. |
| 95 | |
| 96 | ## Frequently Asked Questions |
| 97 | |
| 98 | **Can I use this plugin without ACF?** |
| 99 | |
| 100 | No, this plugin requires Advanced Custom Fields (ACF) to function properly. |
| 101 | |
| 102 | ## Filters |
| 103 | |
| 104 | The following filters are available for customization: |
| 105 | |
| 106 | - **`flexible_layout_preview-image_for_acf_images_path`**: Customize the path to load images from. |
| 107 | - **`flexible_layout_preview-image_for_acf_images`**: Modify the array of layout keys and image URLs. |
| 108 | |
| 109 | |
| 110 | ## License |
| 111 | |
| 112 | This plugin is licensed under the GPLv2 or later. See the [](https://www.gnu.org/licenses/gpl-2.0.htmlLICENSE](https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) file for more details. |
| 113 |