=== Moonstack Ultimate Elementor Kit ===
Contributors: msuekdeveloper
Tags: elementor, widgets, post elements, slider, custom fields
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A comprehensive Elementor widgets collection for enhanced post display, sliders, and custom content elements.

== Description ==

Moonstack Ultimate Elementor Kit is a powerful plugin that extends Elementor Page Builder with a comprehensive set of professional widgets for displaying posts, custom fields, sliders, and various content elements.

In the WordPress admin dashboard, the plugin settings and tools are available under the **MU Elementor Kit** menu.

== Features ==

* **Post Display Widgets** - Show post titles, content, excerpts, featured images, and meta data
* **Advanced Sliders** - Banner slider, card slider, and logo slider with multiple effects
* **Custom Fields Display** - Display ACF and custom post meta fields with various formats
* **Interactive Buttons** - Custom buttons with icons, animations, and advanced linking
* **Fully Customizable** - Extensive styling options and hook system for developers

= Widgets Included =

**Post Widgets**

* Post Title - Display post titles with word limit and linking options
* Post Content - Show full content or excerpts with formatting control
* Post Excerpt - Custom excerpt display with fallback options
* Post Meta - Display post metadata (date, author, categories, tags)
* Post Featured Image - Featured image display with linking and effects
* Post Custom Fields - Show custom fields and ACF fields with various formats

**Slider Widgets**

* Banner Slider - Full-width banner slider with content overlays
* Card Slider - Card-based slider for posts, products, or custom content
* Logo Slider - Customer logo slider with hover effects and linking

**Form Widgets**

* Form - Advanced form builder with AJAX submission, email notifications, and Google reCAPTCHA (v2/v3) integration

== External Services ==

This plugin supports embedding videos from third-party video platforms such as YouTube, Vimeo, and Dailymotion.

These services are used only when the site administrator explicitly selects a video field type and provides a corresponding video URL.

When embedding a video:
- The video ID is used to generate an iframe embed URL.
- No personal user data is collected or stored by the plugin.
- No data is transmitted automatically without user action.

External services used:

Dailymotion  
Service: Video embedding  
Website: https://www.dailymotion.com  
Privacy Policy: https://www.dailymotion.com/legal/privacy  
Terms of Service: https://www.dailymotion.com/legal/terms  

Vimeo  
Service: Video embedding  
Website: https://vimeo.com  
Privacy Policy: https://vimeo.com/privacy  
Terms of Service: https://vimeo.com/terms  

YouTube  
Service: Video embedding  
Website: https://www.youtube.com  
Privacy Policy: https://policies.google.com/privacy  
Terms of Service: https://www.youtube.com/t/terms  

Google reCAPTCHA  
Service: Spam protection and security  
Website: https://www.google.com/recaptcha/about/  
Privacy Policy: https://policies.google.com/privacy  
Terms of Service: https://policies.google.com/terms  

**Basic Widgets**

* Custom Button - Advanced buttons with icons, animations, and links

= Developer Friendly =

All widgets include extensive hook systems for customization:

* moonulel_after_post_title_single_render
* moonulel_post_content_single_before_html_output
* moonulel_post_excerpt_single_before_render
* moonulel_before_post_meta_single_render
* moonulel_post_featured_image_single_before_render
* moonulel_post_custom_field_single_before_field_output
* moonulel_post_button_content
* moonulel_banner_slider_slide_background
* moonulel_card_slider_slides
* moonulel_logo_slider_logos
* moonulel_form_submitted_data 
* moonulel_form_before_send_emails 
* moonulel_form_after_save_db 

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/moonstack-ultimate-elementor-kit` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Open Elementor Page Builder and configure widgets from the **MU Elementor Kit** section in the WordPress admin.

== Frequently Asked Questions ==

= What Elementor version is required? =
Elementor 3.0.0 or higher is recommended.

= Does this work with ACF? =
Yes. The Post Custom Fields widget includes built-in support for Advanced Custom Fields (ACF).

= Can I customize the widgets with code? =
Yes. All widgets include multiple action and filter hooks for developer-level customization.

= Are the sliders mobile responsive? =
Yes. All sliders are fully responsive and include breakpoint controls.

== Changelog ==

= 1.1.0 =
* Added powerful Form Widget with multiple field types and AJAX submission handling
* Integrated Google reCAPTCHA v2 and v3 APIs for form spam protection
* Added global plugin dashboard settings panel for handling external API integrations
* Fixed RTL (Right-to-Left) behavior in the Customer Logo Slider widget
* Fixed responsive layout and behavior in the Card Slider widget

= 1.0.2 =
* Removed Custom CSS option from widgets to improve security
* Improved output escaping and sanitization across all widgets
* Improved wp_add_inline_style() usage for widget CSS variables
* Strengthened validation for dynamic links, attributes, and user-defined values
* General code quality improvements for WordPress.org review compliance

= 1.0.1 =
* Security hardening for dynamic hooks and inline scripts
* Fixed PHPCS warnings related to dynamic hook naming
* Improved wp_add_inline_script() usage for widget JavaScript variables
* Code quality and sanitization improvements

= 1.0.0 =
* Initial release
* 12 comprehensive Elementor widgets
* Full hook system for developers
* Responsive design throughout

== Upgrade Notice ==

= 1.1.0 =
This update introduces a new Form Widget with Google reCAPTCHA v2 & v3 support, along with a new global settings dashboard.

= 1.0.2 =
This update removes the Custom CSS feature and improves security, sanitization, and data handling. Updating is strongly recommended.

= 1.0.1 =
This update improves security, coding standards compliance, and overall stability. Updating is recommended.

= 1.0.0 =
Initial release of Moonstack Ultimate Elementor Kit.

== Customization ==

All widgets can be customized using WordPress hooks. Example:

<pre>
// Modify post title output
add_filter('moonulel_post_title_single_before_output', function($title, $post, $settings) {
    return strtoupper($title);
}, 10, 3);

// Add custom content after banner slider
add_action('moonulel_banner_slider_after_container', function($settings, $unique_id, $widget) {
    echo '&lt;div class="custom-slider-navigation"&gt;Custom Nav&lt;/div&gt;';
}, 10, 3);

// Filter form widget submitted data before sending email or saving
add_filter('moonulel_form_submitted_data', function($submitted_data, $form_id, $post_id, $settings) {
    // Add custom hidden data 
    $submitted_data['Source'] = 'Facebook Ads';
    return $submitted_data;
}, 10, 4);
</pre>
