﻿=== Siddik Layout Widgets for Elementor ===
Contributors: mdabubakkersiddik1
Tags: elementor, page builder, widgets, addons, woocommerce
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: elementor
Stable tag: 2.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

25+ free Elementor widgets for blogs, business pages, and landing sections. Pro add-on adds WooCommerce, portfolio, and advanced layouts.

== Description ==

**Siddik Layout Widgets for Elementor** adds a dedicated **Siddik Layout Widgets** category inside Elementor with ready-made blocks for homepages, blogs, and business sites — plus extra layout controls for sections, columns, and containers.

No coding required: install the plugin, open Elementor, drag a widget, customize content and style, and publish.

**Disclaimer:** Independent third-party add-on. Not affiliated with, endorsed by, or officially connected to Elementor or Elementor Ltd.

= Quick Start (5 Steps) =

1. Install and activate the free [Elementor](https://wordpress.org/plugins/elementor/) plugin.
2. Install and activate **Siddik Layout Widgets for Elementor**.
3. Go to **Pages → Add New** (or edit an existing page) and click **Edit with Elementor**.
4. In the left **Elements** panel, open the **Siddik Layout Widgets** category.
5. Drag any widget onto the canvas, adjust settings in **Content** and **Style**, then click **Publish**.

Tip: After activation, open **Siddik Layout Widgets → Getting Started** in your WordPress admin for a visual walkthrough.

= How to Use a Widget =

**Add a widget**
Search or scroll in the **Siddik Layout Widgets** panel, then drag the block onto your page or inside a section/column.

**Edit content**
Use the **Content** tab for text, images, icons, links, repeater items (services, team members, slides, and so on).

**Edit design**
Use the **Style** tab for colors, typography, spacing, borders, and responsive settings (desktop, tablet, mobile).

**Choose a layout**
Many blocks — including Blog List, Service Block, Team Block, and Testimonial Block — support **grid**, **masonry**, or **carousel** modes in the widget settings.

**Use Contact Form 7**
Install [Contact Form 7](https://wordpress.org/plugins/contact-form-7/), create a form, then select it inside the **Contact Form 7** widget.

= Layout Enhancements (Free) =

Open any Elementor **Section**, **Column**, or **Container** and look for the **Siddik Layout Widgets** panel:

* **Equal Height Columns** — match column heights in a row
* **Custom Section/Container Width** — precise boxed max-width
* **Stretched Background** — extend backgrounds edge-to-edge
* **Curved Background** — SVG curved section backgrounds
* **Column Flex Reverse** — reverse column order on mobile
* **GSAP Clip Path Effects** — when your theme provides compatible GSAP scripts

= Example: Free Homepage in Minutes =

1. **Hero Slider** — main banner with headline and button
2. **Features Block** — highlight key benefits
3. **Service Block** — 3-column services grid
4. **Testimonial Block** — reviews carousel
5. **Counter Block** — stats and milestones
6. **Contact Form 7** — lead capture at the bottom

= Free vs PRO — What You Get =

**FREE (this WordPress.org plugin)**

| Category | Included |
| Content blocks | Hero Slider, Blog List, Service Block, Team Block, Testimonial Block, Counter Block, Features Block, Theme Button |
| Core widgets | Section Title, Button, Accordion, Tabs, Icon Box, Info Box, Social Links, Text Editor, List, Clients Logo, Funfact Counter, Progress Bar, Video Popup, Contact Form 7, Contact List, Blog |
| Layout tools | Section, column, and container enhancements (equal height, custom width, curved background, and more) |
| Requirements | WordPress 6.0+, PHP 7.4+, free Elementor 3.0+ |

**PRO (separate add-on — not included here)**

| Category | Included |
| Marketing & media | Pricing Block, Pricing Plan, Countdown Timer, Image Gallery, Before/After Slider, Award Block, Working Block, Skill Block, Showcase Block, Moving Text, Interactive Tabs, and more |
| Header & navigation | Site Logo, Page Title, Header Primary Nav, Header Nav Side Icons, Header Top Info |
| Template parts | Reusable footer, mega menu, header top, page title, and side panel layouts with shortcodes |
| Content types | Portfolio and Projects custom post types with archive templates |
| WooCommerce shop | WC Products, Product Tabs, Product Category, Product List, Info Banner, Header Cart, Header Search, Wishlist, Vertical Menu, Account |
| Extra utilities | Newsletter, Navigation Menu, Pie Chart, Language Switcher, parallax and animated layer widgets, and 50+ advanced blocks total |

Install the free plugin first, then add **Siddik Layout Widgets PRO** to unlock premium widgets and template parts.

= Free Widgets (Complete List) =

**Marketing & content blocks**

* **Hero Slider** — full-width sliders with headings, buttons, and carousel effects
* **Blog List** — post grids, masonry, or carousel layouts
* **Service Block** — services in grid, masonry, or carousel with icons
* **Features Block** — feature highlights with multiple skins
* **Testimonial Block** — client reviews in slider or grid layouts
* **Team Block** — team profiles with photos, roles, and social links
* **Counter Block** — animated number counters for statistics
* **Theme Button** — styled call-to-action buttons

**Essential Elementor widgets**

* **Section Title**, **Button**, **Accordion**, **Tabs**, **Icon Box**, **Info Box**
* **Social Links**, **Text Editor**, **List**, **Clients Logo**, **Funfact Counter**
* **Progress Bar**, **Video Popup**, **Contact Form 7**, **Contact List**, **Blog**

= PRO Add-on Highlights =

The PRO plugin is sold separately and requires this free plugin. It is **not** bundled in the WordPress.org download.

**Marketing & creative blocks**

* Pricing Block, Pricing Plan, Pricing Plan Switcher
* Countdown Timer, Image Gallery, Before/After Slider
* Award Block, Working Block, Skill Block, Showcase Block
* Moving Text, Circle Text, Spin Text Around Logo
* Interactive Tabs, Interactive List, Vertical Image Slider

**Header, footer & templates**

* Site Logo, Page Title, Header Primary Nav, Header Nav Side Icons
* Footer, Mega Menu, Header Top, Page Title, Side Panel template parts
* Shortcodes: `[slwe_footer id="123"]`, `[slwe_megamenu id="456"]`, `[slwe_header_top id="789"]`, `[slwe_page_title id="101"]`, `[slwe_side_panel id="112"]`, `[slwe_template_part id="123"]`

**Portfolio & projects (PRO)**

* Portfolio and Projects custom post types
* Projects widget with filters and archive layouts
* Theme-independent single and archive fallback templates

**WooCommerce shop widgets (PRO + WooCommerce)**

* WC Products, Product List, Product Tabs, Product Category, Info Banner
* Header Cart, Header Search, Wishlist, Vertical Menu, Account

**How to use PRO template parts**

1. Activate **Siddik Layout Widgets PRO** alongside this plugin.
2. In WordPress admin, open **UAE Templates** (Footers, Mega Menus, and similar menus).
3. Click **Add New**, design with Elementor, publish, and note the post **ID**.
4. Place the shortcode on any page or inside Elementor's **Shortcode** widget.

= Who Is This Plugin For? =

* **Freelancers & agencies** building client sites with Elementor
* **Bloggers & publishers** who want post grids and archive layouts
* **Small businesses** that need landing pages, services, and testimonials
* **Beginners** who prefer drag-and-drop sections over custom code
* **Store owners (PRO)** who want WooCommerce-ready shop widgets
* **Creatives (PRO)** who showcase portfolio and project case studies

= Requirements =

* WordPress 6.0 or later
* PHP 7.4 or later
* Elementor 3.0 or later (free version works — Elementor Pro not required)
* WooCommerce — optional; required only for PRO shop widgets
* Contact Form 7 — optional; required only for the Contact Form 7 widget

= Third-Party Resources =

This plugin bundles the following GPL-compatible libraries and assets:

* [WordPress Post Like System](https://jonmasterson.com/post-like-demo/) by Jon Masterson (GPLv3)
* [Matthew Ruddy Image Resizer](http://easinglider.com) by Matthew Ruddy (GPLv2+)
* [Font Awesome Free](https://fontawesome.com) (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT)
* [Swiper](https://swiperjs.com) (MIT) — v11.2.10
* [Slick Carousel](https://kenwheeler.github.io/slick/) (MIT)
* [Isotope](https://isotope.metafizzy.co) (GPLv3 for Metafizzy commercial license / GPLv3 compatible bundled build)
* [Bootstrap SCSS](https://getbootstrap.com) (MIT) — source files excluded from release package
* [LightGallery](https://www.lightgalleryjs.com) (GPLv3)
* [jQuery Mousewheel](https://github.com/jquery/jquery-mousewheel) (MIT) — v3.2.2

GSAP animation options are supported only when a theme registers compatible `gsap` script handles. GSAP core libraries are not bundled because they are not GPL-compatible.

= Minified JavaScript and CSS Source Code =

This plugin ships minified or compressed JavaScript and CSS for production. Human-readable source code for each bundled library is available at the public repositories below. No build step is required to use the plugin; these links are provided for review and study.

* LightGallery — https://github.com/sachinchoolur/lightGallery
* Sticky Sidebar — https://github.com/abouolia/sticky-sidebar
* jQuery Match Height — https://github.com/liabru/jquery-match-height
* TwentyTwenty (before/after slider) — https://github.com/zurb/twentytwenty
* KineticJS — https://github.com/ericdrowell/KineticJS
* jQuery Tilt — https://github.com/gijsroge/Tilt.js
* jQuery Lazy — https://github.com/eislambey/jquery-lazy
* jQuery Mousewheel — https://github.com/jquery/jquery-mousewheel
* Swiper — https://github.com/nolimits4web/swiper
* Slick Carousel — https://github.com/kenwheeler/slick
* Isotope — https://github.com/metafizzy/isotope
* imagesLoaded — https://github.com/desandro/imagesloaded
* Vivus (SVG animation) — https://github.com/maxwellito/vivus
* Typed.js — https://github.com/mattboldt/typed.js
* Ion.RangeSlider — https://github.com/IonDen/ion.rangeSlider
* jQuery Paroller — https://github.com/tgomilar/paroller.js
* jQuery Final Countdown — https://github.com/hilios/jQuery.countdown
* jQuery Countdown — https://github.com/hilios/jQuery.countdown
* jQuery Easy Pie Chart — https://github.com/rendro/easy-pie-chart
* jQuery Animate Numbers — https://github.com/miraan/animateNumbers
* Sticky Kit — https://github.com/leafo/sticky-kit
* jQuery Parallax Scroll — https://github.com/alumbo/jquery.parallax-scroll

Plugin-specific frontend scripts in `assets/js/` and widget styles in `assets/css/` are maintained in this repository without a separate build step.

== Installation ==

= Automatic Installation (Recommended) =

1. Log in to your WordPress admin dashboard
2. Go to **Plugins → Add New**
3. Search for **Siddik Layout Widgets for Elementor**
4. Click **Install Now**, then **Activate**
5. Confirm that **Elementor** is also installed and active

= Manual Installation =

1. Download the plugin ZIP file from the WordPress.org plugin page
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Click **Activate Plugin**

= First Steps After Activation =

1. Open **Siddik Layout Widgets → Getting Started** in the admin menu
2. Create or edit any page and click **Edit with Elementor**
3. Find the **Siddik Layout Widgets** category in the Elements panel
4. Drag your first widget onto the page
5. Configure content and style, then click **Publish**

= Upgrading to PRO =

1. Keep this free plugin active
2. Install and activate **Siddik Layout Widgets PRO** (separate download)
3. New widgets appear in the same **Siddik Layout Widgets** category
4. Manage portfolio, projects, and template parts under **UAE Templates** in the admin menu

== Frequently Asked Questions ==

= Does this plugin work without Elementor? =

No. Elementor must be installed and activated. All widgets and layout options appear inside the Elementor editor.

= Where do I find the widgets? =

Edit any page with Elementor. In the left **Elements** panel, scroll to **Siddik Layout Widgets**. Free widgets are available immediately; PRO widgets appear after you install the PRO add-on.

= What is free and what requires PRO? =

**Free:** 25+ widgets (Hero Slider, Blog List, Team, Testimonial, Service, Features, Counter, Theme Button, Accordion, Tabs, Button, Icon Box, and more) plus section/column/container layout enhancements.

**PRO:** WooCommerce shop widgets, portfolio and project post types, pricing and countdown blocks, header/footer/mega menu template parts, image galleries, and 50+ advanced widgets. See the **Free vs PRO** section above for the full breakdown.

= Does this plugin work with any WordPress theme? =

Yes. It works with any theme that supports Elementor. PRO portfolio and project archives include built-in fallback templates.

= Is WooCommerce required? =

No for the free plugin. WooCommerce is only needed if you use PRO shop widgets such as WC Products, Header Cart, or Product Tabs.

= Is Elementor Pro required? =

No. This plugin works with the free version of Elementor.

= Can I use grid, masonry, and carousel layouts? =

Yes. Blog List, Service Block, Team Block, Testimonial Block, and similar widgets include layout mode options in the widget settings.

= How do I add a custom footer or mega menu? =

This requires **Siddik Layout Widgets PRO**. Create a template under **UAE Templates**, design it with Elementor, copy the post ID, and use a shortcode such as `[slwe_footer id="YOUR_ID"]` or `[slwe_megamenu id="YOUR_ID"]`.

= Does this plugin slow down my website? =

Scripts and styles load only for widgets used on each page. Unused widget assets are not loaded on the frontend.

= Is the plugin translation ready? =

Yes. All strings use the `siddik-layout-widgets-elementor` text domain. A `.pot` file is included in the `languages/` folder.

= Is this an official Elementor plugin? =

No. Siddik Layout Widgets for Elementor is developed independently by Md Abu Bakker Siddik and is not affiliated with Elementor or Elementor Ltd.

= How do I get support? =

Visit the [Support Forum](https://wordpress.org/support/plugin/siddik-layout-widgets-elementor/) on WordPress.org.

== Screenshots ==

1. Siddik Layout Widgets category in the Elementor Elements panel.
2. Blog List widget on the frontend with grid, masonry, or carousel layouts.
3. Hero Slider, Service Block, Team Block, and Testimonial Block on a business homepage.
4. Section, column, and container layout enhancements in Elementor settings.

== Changelog ==

= 2.0.6 =
* Split into Free (WordPress.org) and Pro (separate add-on) — 25+ widgets in the free plugin
* Pro add-on includes WooCommerce widgets, portfolio/project CPTs, and template parts
* Fixed Swiper script registration timing for WordPress 6.9.1 (Vertical Image Slider dependency notice)

= 2.0.5 =
* WordPress.org review compliance: documented minified library sources in readme
* Replaced inline admin-ajax script with wp_enqueue_script and wp_add_inline_script
* Fixed output escaping across carousel templates, cart widgets, and product category skins
* Replaced remote placeholder image URL with bundled local SVG asset
* Removed Flaticon demo HTML file with external image dependencies
* Added ABSPATH guards to remaining loader files
* Renamed shortcodes and globals to the `slwe_` prefix (template parts, post likes, options)
* Updated Tested up to WordPress 7.0

= 2.0.4 =
* Fixed remaining PHP syntax errors in theme-button and app-button templates (invalid PHP blocks around HTML class attributes)

= 2.0.3 =
* Fixed PHP syntax errors in button and info-banner templates
* Removed non-GPL GSAP core libraries; GSAP features now use theme-provided scripts when available
* Replaced unmaintained Magnific Popup with bundled LightGallery for video popups
* Updated Swiper to 11.2.10 and jQuery Mousewheel to 3.2.2
* Added ABSPATH guards to template files
* Fixed invalid gettext usage in header search placeholder output

= 2.0.2 =
* Bundled GSAP libraries for standalone theme-independent animation support
* Fixed GSAP script registration on proper WordPress enqueue hooks
* Removed UTF-8 BOM from PHP files that caused namespace fatal errors on activation

= 2.0.1 =
* Renamed plugin to Siddik Layout Widgets for Elementor with slug `siddik-layout-widgets-elementor`
* Updated text domain and plugin bootstrap filename for WordPress.org trademark guidelines
* Updated Tested up to WordPress 6.9
* Replaced broken third-party Post Like System source URL with the author's demo page

= 2.0.0 =
* Initial WordPress.org submission
* Renamed plugin bootstrap, text domain, prefixes, and Elementor widget category
* Refactored all custom post types with the `uae_` prefix for WordPress.org compliance
* Template parts (header, footer, mega menu, page title, side panel) use shortcodes — no theme auto-injection
* Added theme-independent single/archive fallback templates for portfolio and project CPTs
* Added template escaping helpers and sanitization across widget templates
* Secured post-like AJAX handler with nonce verification and input validation
* Removed bundled Redux Framework, ScssPhp, and legacy maintenance mode loader
* Removed unused development dependencies from the release package
* Hardened image resizer to use WordPress attachment APIs instead of server paths
* Added translation template at `languages/siddik-layout-widgets-elementor.pot`
* Added WordPress.org release packaging via `.distignore`

== Upgrade Notice ==

= 2.0.6 =
Fixes a WordPress 6.9.1 script dependency notice for Swiper-based widgets.

= 2.0.5 =
WordPress.org compliance release. Template part shortcodes now use the `slwe_` prefix (for example `[slwe_footer id="123"]`).

= 2.0.4 =
Fixes remaining PHP syntax errors in button templates.

= 2.0.3 =
Compliance and bug-fix release for WordPress.org review.

= 2.0.2 =
Bug-fix release. Safe to update if you are already on 2.0.1.

= 2.0.1 =
Renamed for WordPress.org compliance. Activate Elementor before upgrading or installing.

= 2.0.0 =
Initial public release. Activate Elementor before upgrading or installing.
