=== Kirki – Freeform Page Builder, Website Builder & Customizer ===
Contributors: themeum
Tags: page builder, website builder, drag and drop, form builder, freeform canvas
Requires at least: 5.9
Tested up to: 7.0
Stable tag: 6.2.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Freeform page builder & website builder for WordPress. Infinite canvas for complex, interactive websites. Built-in forms, animations & Customizer.

== Description ==

[Kirki](https://kirki.com/) is a **freeform visual builder for WordPress and an advanced theme customizer** that lets you design and build complete websites visually — without coding.

Unlike traditional page builders, Kirki uses an **infinite freeform canvas**, giving you full creative freedom without rigid grids or layout restrictions.

Build landing pages, business websites, blogs, and full websites with responsive controls, dynamic content, and powerful design tools — all inside WordPress.

**Watch Kirki in action:**

https://www.youtube.com/watch?v=ofDMD1j4A2Y

---

### 🔥 Why Choose Kirki?

Kirki combines a modern visual builder with WordPress's powerful customization system — so you can design freely without sacrificing flexibility.

✔ Freeform canvas — no rigid layouts or constraints
✔ Drag-and-drop visual editor with precise control
✔ Responsive editing for desktop, tablet, and mobile
✔ Built-in tools (forms, popups, dynamic content)
✔ Clean, performance-focused output
✔ Works with any WordPress theme
✔ Built for designers, developers, and teams

---

## 🧱 Core Features

### Visual Website Builder

Design your website visually with full control.

- Freeform drag-and-drop editor
- Infinite canvas — no grid or column restrictions
- Real-time responsive editing (desktop, tablet, mobile)
- Pre-built components and layout blocks
- Global styles (colors, fonts, spacing)
- Version history and rollback
- Media manager for assets
- Light & dark mode interface

---

### ⚡ Dynamic Content & Smart Features

Build scalable, data-driven websites.

- Dynamic content system (collections & templates)
- Conditional visibility controls
- Custom attributes for advanced control
- Developer-friendly extensibility
- Reusable design systems and components

---

### 🎨 Templates & Design Assets

Start fast and customize everything.

- Ready-made website templates
- Pre-built sections and layout blocks
- Reusable design assets
- Import / export projects easily

---

### 🧩 Built-in Tools

Everything you need — without extra plugins.

- Form builder with submission management
- Popup builder with visual controls
- Interaction and animation builder
- Icon library and media tools

---

### 🎬 Interactions & Animations

Create engaging, modern experiences.

- Visual animation builder
- Interaction timeline editor
- Custom transitions and effects
- Text animation tools

---

### ⚙️ Advanced WordPress Customizer

Extend WordPress customization with powerful controls.

- 35+ customizer controls
- Real-time preview
- Automatic CSS generation
- Conditional logic support
- Developer-friendly API
- Performance optimized

---

## 👥 Who Is Kirki For?

- Designers who want full creative freedom
- Freelancers building client websites
- Agencies managing multiple projects
- Developers extending WordPress functionality
- Anyone looking for a **no-code visual builder for WordPress**

---

## 🚀 What Makes Kirki Different?

Kirki is not just another page builder.

Instead of forcing layouts into rows and columns, Kirki gives you a **freeform design experience** — similar to modern design tools — while keeping the full power of WordPress.

**Design freely. Build with WordPress.**

---

== Installation ==

1. Go to **Plugins → Add New**
2. Search for **Kirki**
3. Click **Install Now** and **Activate**

Or manually:

1. Upload the plugin to `/wp-content/plugins/kirki/`
2. Activate via WordPress dashboard
3. Open Kirki and start building

---

== FAQ ==

= Is Kirki free? =
Yes, Kirki is free to use. Additional advanced features are available in Kirki Pro.

= What's included in the free version? =
The free version includes the full Customizer framework with 35+ controls, and the core visual builder. Kirki Pro unlocks advanced capabilities including dynamic content, the full interaction timeline, popup builder, and premium templates.

= Do I need coding knowledge? =
No. Kirki is designed for visual, no-code website building.

= Can I use Kirki with any theme? =
Yes, Kirki works with any WordPress theme.

= Is Kirki responsive? =
Yes. You can design for desktop, tablet, and mobile.

= Can I export my designs? =
Yes, import and export features are available.

= Does Kirki support dynamic content? =
Yes, you can create dynamic templates and data-driven designs.

= Where can I get support? =
Free users can get help from the Kirki community on Facebook: https://facebook.com/groups/kirkicommunity — thousands of designers and developers ready to help. Priority ticket support is available for Pro and Agency plan users at https://kirki.com/support

= I was using Kirki as a Customizer framework. Has anything changed? =
Nothing. All existing Customizer controls are fully preserved. Your current setup will not be affected by the update. The visual builder is simply a new addition on top of the framework you already rely on.

---

== Screenshots ==

1. Design on an freeform infinite canvas, with real-time editing across all responsive views.
2. Build faster with ready sections you can save, reuse, and customize across any project.
3. Create custom animations using a visual interaction builder and timeline editor.
4. Bring your content to life with built-in text animation effects.
5. Design forms visually, and manage all form submissions natively inside Kirki.
6. Choose from a huge library of professionally designed WordPress themes to jumpstart your project.

---

== Changelog ==

= 6.2.1 =
* New: Added a Flex Child option to the Sizing panel for finer control over flex layouts.
* Update: Automatically removes matching styles from an element when a text style is applied.
* Update: Improved rich text selection handling with better root selection context management.
* Update: Enhanced external text paste behavior, preserving formatting and eliminating trailing whitespace issues.
* Update: Enhanced the Color Picker to support mixed color values.
* Update: Videos now automatically pause when they move out of the viewport.
* Update: Improved CSS generation for text styles and variables to ensure better specificity.
* Fix: Addressed multiple security vulnerabilities, including XSS, arbitrary shortcode execution, path traversal, SSRF, and email relay issues.
* Fix: Resolved text overflow and ellipsis issues in Input Number, Tabs, and Select controls.
* Fix: Resolved dropdown target visibility issues when controlled by dropdown state settings.

= 6.2.0 =
* New: Introduced the Interaction Library.
* New: Introduced predefined design presets for new dynamic template pages.
* New: Added current state design support for Tabs and Slider elements.
* Update: Redesigned Connect to Field and Connect to CMS.
* Update: Improved the Add New Page experience.
* Update: Added a sticky, scrollable Layers panel.
* Update: Added contextual icons to the Layers panel for visibility conditions, interactions, and more.
* Update: Improved WordPress post slug validation.
* Update: Improved Symbols save and delete operations.
* Update: Added an image alt text popover to the Image element.
* Update: Refined the Typography Font Options popover.
* Update: Added support for combining search queries with collection filters using AND conditions.
* Fix: Changed canvas multi-select from Cmd + Click to Shift + Click.
* Fix: Fixed the preview URL on the Collection Details page.
* Fix: Resolved a deprecated warning in the form submission class.
* Fix: Resolved legacy style block merging issues.
* Fix: Fixed the page rename issue.
* Fix: Fixed the SVG element class generation issue.

= 6.1.1 =
* Fix: Resolved php 7.4 compatibility issue.

= 6.1.0 =
* New: Introduced a centralized Class Manager.
* New: Added Mix Blend Mode support to the Style Panel.
* Fix: Fixed filter and backdrop-filter properties being removed when deleting styles.
* Fix: Applied !important to the Liquid Glass backdrop filter for proper rendering.
* Fix: Fixed video audio playback for hover and autoplay when the audio toggle is enabled.
* Fix: Fixed an issue where color changes from the Selection Color Panel affected multiple elements.
* Fix: Resolved a double-click issue with legacy Rich Text content.
* Fix: Fixed cloned elements not syncing newly created style blocks with the server.
* Fix: Improved API security by validating editor preview tokens.
* Fix: Added validation for ZIP file uploads.
* Fix: Fixed frontend REST API validation for password-protected posts.
* Update: A curated set of Google Fonts now loads by default. A Google API key is needed to access the full library.
* Update: Redesigned range sliders to numerical input fields, so values can be set by dragging.
* Update: Updated the App Settings route middleware for preview tokens.
* Update: Implemented paginated loading for Kirki editor comments.

= 6.0.14 =
* Fix: Fixed CSRF vulnerability in admin POST AJAX requests (kirki_wp_admin_post_apis).
* Fix: Sanitized redirect URLs and replaced wp_redirect with wp_safe_redirect in TemplateRedirection utility pages.
* Fix: Improved file path protection to prevent unauthorized access.
* Fix: Fixed datetime handling in the comment resource after Carbon removal.
* Fix: Fixed double-quote handling in font family variables.
* Fix: Fixed text style tag application for non-text elements.
* Update: Enhanced permission checks for AJAX endpoints and enabled SSL certificate verification for ZIP downloads.
* Update: Improved collaboration performance by running collaboration tasks in a separate thread.

= 6.0.13 =
* New: Added support for dragging and dropping local media files directly into Grid cells.
* Update: Refactored the REST API backend for improved stability and maintainability.
* Fix: Implemented security improvements and resolved known security issues.
* Fix: Resolved device-specific interaction preview issues in the canvas.
* Fix: Added support for dynamic video fields from the Content Manager in the Video element.

= 6.0.12 =
* Update: Added real-time canvas controls when focusing on Padding, Margin, and Gap inputs.
* Update: Improved Grid Controller functionality.
* Update: Automatically open the Element Settings panel when dropping Image, Icon, Video, Lottie, or SVG elements.
* Update: Context menu functionality improvements.
* Fix: Unauthenticated arbitrary comment modification and moderation bypass.
* Fix: Unauthenticated Server-Side Request Forgery vulnerability.
* Fix: Resolved the reset password email body issue by implementing hash validation.
* Fix: Addressed multiple random issues to improve overall stability.

= 6.0.11 =
* New: Added multi-select support in the canvas
* Update: Improved grid controller functionality
* Update: Design enhancements
* Update: Hide non-active outlines while dragging controllers
* Update: Refined component edit top bar
* Update: Support wrapping elements across different parents
* Update: Improved sibling element outline behavior
* Update: Fixed Safari copy-paste issues when importing from Figma or copying elements within Kirki

= 6.0.10 =
* New: Added timeline scrubbing support for previewing custom animations.
* New: Added variable support for Padding and Margin controls.
* New: Introduced breakpoint virtualization for better performance and scalability.
* Update: Improved Collection API call performance and optimizations.
* Update: Collection reference and multi-reference search functionality improvements.
* Update: Improved background color shade generation during color selection.
* Update: Added variable support for conic gradient color stops.
* Update: Improved variables, font-family support, and HTML generation for the Figma to Kirki plugin.
* Fix: Fixed permission and rewrite rule issues affecting Utility Pages.
* Fix: Figma to Kirki variable, font-family, image paste issue.
* Fix: Resolved pinch-to-zoom and zoom-out issues affecting Safari browsers.

= 6.0.9 =
* New: Added support for custom timing editing in slider animations.
* Update: Updated the custom interaction timeline behavior for smoother editing and playback.
* Update: Improved color picker performance and responsiveness.
* Update: Improved comment behavior and shortcut handling.
* Update: Updated the Kirki Apps settings design.
* Fix: Fixed drawing issues caused by excessively large canvas sizes.
* Fix: Fixed inconsistencies with dragging cursor and controller interactions.
* Fix: Fixed device selection behavior when clicking outside elements.
* Fix: Fixed fill and gradient controller positioning issues.
* Fix: Fixed layer panel icon reset and undo behavior issues.
* Fix: Fixed nested rich text editing and selection behavior.
* Fix: Fixed symbol editing freeze issues after style synchronization.
* Fix: Fixed issues caused by deleting elements during active color picking.
* Fix: Fixed textarea height styling issues in form blocks.

= 6.0.8 =
* Fix: Resolved css variable enqueue issue on the custom template pages.
* Fix: Fixed collection pagination issue for filtered data.
* Fix: Solved random issues.

= 6.0.7 =
* Update: Centralized symbol edit canvas positioning across all symbols.
* Update: Added viewport-aware symbol editing for tablet and mobile.
* Update: Improved typography controls and CSS unit handling.
* Update: Added support for special max-width values and clamp() parsing.
* Update: Added CSS variable duplication support.
* Update: Refactored SVG rendering with dedicated InlineSvg handling.
* Update: Improved Liquid Glass rendering and viewport isolation.
* Fix: Unauthenticated Limited Arbitrary File Read and Deletion via downloadZIP
* Fix: Missing Authorization to Authenticated (Subscriber+) Sensitive Form Submission Data Exposure via 'kirki_wp_admin_get_apis' Action Description
* Fix: Unauthenticated Privilege Escalation via 'handle_forgot_password'
* Fix: Fixed auto-scroll for unmounted selected elements in the Layers panel.
* Fix: Rich text editing no longer blocks canvas zoom and scroll across viewports.
* Fix: Improved overlay behavior during typing and dragging interactions.
* Fix: Prevented tall symbol content from being clipped in symbol edit mode.
* Fix: Resolved forgot password content and reset URL issues.
* Fix: Corrected margin and padding value normalization.
* Fix: Improved border width and mixed unit handling.
* Fix: Fixed viewport activation and device delete flow issues.
* Fix: Improved Form submission data array serialization and multiple select handling.
* Fix: Interaction ScrollHeight and ScrollWidth property set issue.

= 6.0.6 =
* Update: Enhanced the inline text editing and styling experience.
* Update: Added support for variable mode selection in components.
* Fix: Fixed a security vulnerability in media search.
* Fix: Improved code preview and code editor functionality.

= 6.0.5 =
* Update: Improved element comment coordinate positioning
* Update: Enhanced island toolbar functionality
* Update: Improved grid inline control area settings and track unit selection
* Update: Improved navigation element functionality
* Update: Enhanced code element functionality
* Update: Improved variable and text addition workflow
* Update: Collection item post_data and modified_data are not updating correctly for scheduled posts
* Fix: Fixed handling of multi-select values when styleBlockId is missing
* Fix: Resolved component name overflow in component list items
* Fix: Fixed canvas repositioning issue during component editing
* Fix: Fixed collaboration endpoint unauthorized access
* Fix: Fixed grid x,y alignment property update issue

= 6.0.4 =
* Fix: Resolved an Uncaught SyntaxError in webfontloader.min.js
* Fix: Broken woocommerce catalog product title
* Update: Updated frontend script enqueue handling for Kirki-based designs.
* Improvement: Enhanced text element tag selection; now supports span, p, and h1–h6

= 6.0.3 =
* Fix: WebFontLoader JavaScript file not found issue resolved.
* Fix: WebFont is not defined error fixed in the Konte theme.
* Fix: Added backward compatibility for all Kirki modules (CSS, Tooltips, Postmessage, Field_Dependencies, Selective_Refresh, Preset, Webfonts, Editor_Styles) to prevent fatal errors.
* Fix: Added class alias existence checks to prevent redeclaration warnings when themes/plugins have bundled Kirki.
* Fix: Added type safety check in Field constructor to handle legacy argument formats.
* Fix: Added missing property declarations ($name, $data_tags, $dynamic) to prevent PHP 8.2+ dynamic property deprecation warnings.
* Improvement: Stability improvements.
* Improvement: Fixed DesiIcons alignment issue.

= 6.0.2 =
* Fix: Resolved a fatal error that occurred when the wp_insert_post hook was triggered after the plugin finished loading.

= 6.0.1 =
* Update: Theme header and footer display logic updated.

= 6.0.0 =
* New: Kirki is now a fully freeform visual website builder — design on an infinite canvas with no layout restrictions.
* New: Rebranded from Droip to Kirki — the Customizer framework and the visual builder are now unified under one product.
* New: Atomic design approach — compose from primitives, no pre-decided widgets, no component ceilings.
* New: Responsive editing, full interaction timeline, form builder, popup builder, and dynamic CMS — all built in.
* New: Real-time collaboration — design together on the same canvas simultaneously.
* New: Staging mode, publish history, and rollback.
* New: Figma to Kirki importer — import designs directly into the canvas.
* New: Dev mode — full CSS visibility and clean markup for developer handoff.
* New: 100+ premium template kits for faster launches.
* New: White label support for agencies.
* Update: Unified builder and Customizer experience.
* Note: All existing Customizer controls are fully preserved. No changes to your current setup.

= 5.2.2 =
* Fix: Color palette not displaying in the Customizer in certain cases.
* Fix: Select field inside Repeater control not retaining the selected value.

= 5.2.1 =
* Fix: Fixed an issue where the file path was used incorrectly.

= 5.2.0 =
* Update: Performance optimizations across the platform.
* Update: Added compatibility with WordPress 6.9.

= 5.1.0 =
* Fix: Resolved the issue with fonts not loading properly.
* Fix: Addressed deprecated errors to boost compatibility.
* Update: Compatibility with WordPress 6.4 and PHP 8.2.

= 5.0.0 =
* Update: Free and Pro merged.

---

== Support ==

- Community support: https://facebook.com/groups/kirkicommunity
- Documentation: https://kirki.com/docs
- Website: https://kirki.com

---

== Upgrade Notice ==

= 6.0.0 =
Kirki 6.0.0 is a major release — the builder has been fully rebuilt as a freeform visual canvas and rebranded from Droip to Kirki. All existing Customizer controls are fully preserved — no changes to your current setup. We strongly recommend backing up your site before updating.