=== Fields ACF & SCF for Elementor and Divi ===
Contributors: linknacional
Donate link: https://www.linknacional.com.br/wordpress
Tags: gallery, elementor, divi, acf, scf
Requires at least: 5.7
Tested up to: 6.8
Stable tag: 2.1.3
Requires PHP: 7.2
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Translations: Portuguese (Brazil) / English

Fields ACF & SCF for Elementor and Divi.

== Short Description ==
A plugin that connects ACF (Advanced Custom Fields) or SCF (Secure Custom Fields) with Elementor and Divi, enabling dynamic fields, gallery components, and loop functionality.

== Description ==
Fields ACF & SCF for Elementor and Divi bridges the gap between **ACF/SCF** and popular page builders like **Elementor** and **Divi**. It allows users to create dynamic connections between custom fields and visual components, enhancing the flexibility of their WordPress websites.

### Key Features:
- **Elementor Integration**:
  - Dynamic fields powered by ACF or SCF.
  - Shortcodes for displaying galleries and custom fields.
- **Divi Integration**:
  - Gallery component with grid or slider styles.
  - Loop component for posts or pages, dynamically filtered by ACF or SCF fields.
- **Dynamic Fields**:
  - Seamless connection between ACF/SCF fields and visual components.
- **Shortcode Support**:
  - Flexible shortcodes for Gutenberg and other editors.

This plugin is ideal for users who want to extend the functionality of ACF or SCF and integrate it with Elementor and Divi for advanced customization.

== Frequently Asked Questions ==

= What is the plugin license? =

* This plugin is released under a GPL license.

= What is needed to use this plugin? =

* Secure Custom Fields (SCF) or Advanced Custom Fields (ACF) plugin installed and active.

= How to use it? =

== Usage Instructions ==
After the installation process, locate the **LKNSCF Settings** option in the WordPress admin bar and select the plugin(s) you want to work with.

Create the fields in SCF and define them on the Gutenberg editing page. After filling in the fields, proceed to the Plugin editing page (Elementor or Divi).

1. In the **Elementor** editor:
    - On the Elementor page, use the plugin's own components and insert the created fields through dynamic tags.

2. In the **Divi** theme editor, there are 2 components:
    - Performs the Loop and filters the posts inserted in it through the SCR Object component.
    - Creates a gallery in grid or slide style, allowing the user to customize the set of images coming from SCR.

== External Libraries ==
- [Slick-carousel](https://kenwheeler.github.io/slick/): Library that creates sliders or grids dynamically.

== Installation ==
1. Download the plugin.
2. In the WordPress admin panel, go to Plugins > Add New.
3. Click on "Upload Plugin" and select the ZIP file of the plugin you downloaded.
4. Click on "Install Now" and then "Activate Plugin".
5. Make sure the WP Crowdfunding plugin is also activated.

== Shortcode: [lknscf_field] ==
Use this shortcode to display a text field or a checkbox. Minimum required parameter: [lknscf_field name="SCF Field"].

Parameters for [lknscf_field]:

**name**: The name of the SCF field to retrieve the field value. This is a required parameter.

**type**: Optional. The type of field (e.g., "text" or "checkbox"). The default is "text".

**label**: Optional. The label to be displayed next to the field (e.g., "Name:").

**tag**: Optional. The HTML tag to wrap the field. Can be "h1", "h2", "h3", "p" or "span". The default is "p".

**font_size**: Optional. The font size for the field text. The default is 16px.

**color**: Optional. The color of the field text. The default is (#000000).

**background_color**: Optional. The background color for the field. The default is transparent.

**border_radius**: Optional. The border radius for the field. The default is 0px.

**checkbox_size**: Optional. The size (height and width) of the checkbox. The default is 16px.

== Shortcode: [lknscf_gallery] ==
Use this shortcode to display a gallery. Minimum required parameter: [lknscf_gallery name="SCF Field"].

Parameters for [lknscf_gallery]:

**name**: The name of the SCF field to retrieve the gallery items. This is a required parameter.

**gallery_style**: Optional. The style of the gallery, can be "grid" or "slider". The default is "grid".

**width**: Optional. The width of the images in the gallery. The default is 250px.

**height**: Optional. The height of the images in the gallery. The default is 250px.

**images_count**: Optional. The number of images per slider. The default is 1.

**dots**: Optional. Whether to display navigation dots in the slider. The default is "true".

**autoplay**: Optional. Whether to autoplay the slider. The default is "true".

**arrows**: Optional. Whether to display navigation arrows in the slider. The default is "true".

**delay**: Optional. The delay between slides in autoplay mode, in milliseconds. The default is 7000ms.

== Screenshots ==
1. Insert a custom module component into Divi Theme Builder.
2. Gallery component.
3. Settings page.
4. Dynamic field for Elementor.

== Upgrade Notice ==
= 2.1.3 - 25/11/2025 =
* Gallery adjustments.

= 2.1.2 - 20/06/2025 =
* Adjustment to the plugin name.

= 2.1.1 - 17/06/2025 =
* Fix React file.

= 2.1.0 - 23/05/2025 =
* Adjustments to the warning messages when the gallery component does not have the recommended minimum parameters.
* Fix documentation.

= 2.0.0 - 24/01/2025 =
* Breaking change: Changed the settings slug to enable WordPress launch;  
> You will need to reconfigure the plugin after updating.  
* Removed all translation loading functions;  
* Adjustments to texts as requested by the WordPress team.

= 1.1.4 - 16/01/2025 =
* New plugin name.

= 1.1.3 - 26/12/2024 =
* Documentation fix.
* Fix in the field type when generating available options in dynamic tags.
* Review of scripts and possible bugs (WordPress feedback).

= 1.1.2 =
* Fix in the gallery script.

= 1.1.1 =
* Fix in script loading: is_plugin_active.
* Fix for the arrow in the gallery component.

= 1.1.0 =
* Simplified component names.
* Added click (blur) event to close the modal in the Divi gallery component.
* Moved image counter to the bottom in the Divi gallery component.
* Adjusted image sizes to their natural (full) size.
* Bug fixes and compatibility updates for ACF and SCF.

== Changelog ==
= 2.1.3 - 25/11/2025 =
* Gallery adjustments.

= 2.1.2 - 20/06/2025 =
* Adjustment to the plugin name.

= 2.1.1 - 17/06/2025 =
* Fix React file.

= 2.1.0 - 23/05/2025 =
* Adjustments to the warning messages when the gallery component does not have the recommended minimum parameters.
* Fix documentation.

= 2.0.0 - 24/01/2025 =
* Breaking change: Changed the settings slug to enable WordPress launch;  
> You will need to reconfigure the plugin after updating.  
* Removed all translation loading functions;  
* Adjustments to texts as requested by the WordPress team.

= 1.1.4 - 16/01/2025 =
* New plugin name (Extend Security Custom Fields).

= 1.1.3 - 26/12/2024 =
* Documentation fix.
* Fix in the field type when generating available options in dynamic tags.
* Review of scripts and possible bugs (WordPress feedback).

= 1.1.2 - 23/12/2024 =
* Fix in the gallery script.

= 1.1.1 - 20/12/2024 =
* Fix in script loading: is_plugin_active.
* Fix for the arrow in the gallery component.

= 1.1.0 - 18/12/2024 =
* Component names have been changed to maintain a more simplified standard.
* Click (blur) event on the dark screen to close the modal in the Divi theme gallery component.
* The image counter in the Divi theme gallery component has been moved to the bottom.
* Adjusted the image sizes in the Divi theme gallery component to their natural (full) size.
* Bug fixes and compatibility with the new version of the ACF and SCF plugin.

= 1.0.1 - 14/12/2024 =
* Fixed direct file access.
* Updated function and attribute prefixes to be more unique.
* Removed reference to WordPress constants.
* Removed JS loading as HTML tag.

= 1.0.0 - 12/11/2024 =
* Gallery functionality
* Compatibility with Elementor
  * Dynamic tags (SCF)
* Compatibility with Divi theme
  * Loop filter component (SCF)
  * Gallery component (SCF)
* Gallery and text/checkbox shortcode