kirki
Last commit date
ComponentLibrary
2 days ago
app
1 day ago
assets
1 day ago
bootstrap
2 weeks ago
config
2 weeks ago
customizer
2 weeks ago
database
2 weeks ago
includes
1 day ago
languages
1 day ago
libraries
1 week ago
routes
2 days ago
vendor
1 week ago
config.php
2 weeks ago
kirki.php
1 day ago
readme.txt
1 day ago
readme.txt
395 lines
| 1 | === Kirki – Freeform Page Builder, Website Builder & Customizer === |
| 2 | Contributors: themeum |
| 3 | Tags: page builder, website builder, drag and drop, form builder, freeform canvas |
| 4 | Requires at least: 5.9 |
| 5 | Tested up to: 7.0 |
| 6 | Stable tag: 6.1.1 |
| 7 | Requires PHP: 7.4 |
| 8 | License: GPLv2 or later |
| 9 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Freeform page builder & website builder for WordPress. Infinite canvas for complex, interactive websites. Built-in forms, animations & Customizer. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | [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. |
| 16 | |
| 17 | Unlike traditional page builders, Kirki uses an **infinite freeform canvas**, giving you full creative freedom without rigid grids or layout restrictions. |
| 18 | |
| 19 | Build landing pages, business websites, blogs, and full websites with responsive controls, dynamic content, and powerful design tools — all inside WordPress. |
| 20 | |
| 21 | **Watch Kirki in action:** |
| 22 | |
| 23 | https://www.youtube.com/watch?v=ofDMD1j4A2Y |
| 24 | |
| 25 | --- |
| 26 | |
| 27 | ### 🔥 Why Choose Kirki? |
| 28 | |
| 29 | Kirki combines a modern visual builder with WordPress's powerful customization system — so you can design freely without sacrificing flexibility. |
| 30 | |
| 31 | ✔ Freeform canvas — no rigid layouts or constraints |
| 32 | ✔ Drag-and-drop visual editor with precise control |
| 33 | ✔ Responsive editing for desktop, tablet, and mobile |
| 34 | ✔ Built-in tools (forms, popups, dynamic content) |
| 35 | ✔ Clean, performance-focused output |
| 36 | ✔ Works with any WordPress theme |
| 37 | ✔ Built for designers, developers, and teams |
| 38 | |
| 39 | --- |
| 40 | |
| 41 | ## 🧱 Core Features |
| 42 | |
| 43 | ### Visual Website Builder |
| 44 | |
| 45 | Design your website visually with full control. |
| 46 | |
| 47 | - Freeform drag-and-drop editor |
| 48 | - Infinite canvas — no grid or column restrictions |
| 49 | - Real-time responsive editing (desktop, tablet, mobile) |
| 50 | - Pre-built components and layout blocks |
| 51 | - Global styles (colors, fonts, spacing) |
| 52 | - Version history and rollback |
| 53 | - Media manager for assets |
| 54 | - Light & dark mode interface |
| 55 | |
| 56 | --- |
| 57 | |
| 58 | ### ⚡ Dynamic Content & Smart Features |
| 59 | |
| 60 | Build scalable, data-driven websites. |
| 61 | |
| 62 | - Dynamic content system (collections & templates) |
| 63 | - Conditional visibility controls |
| 64 | - Custom attributes for advanced control |
| 65 | - Developer-friendly extensibility |
| 66 | - Reusable design systems and components |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ### 🎨 Templates & Design Assets |
| 71 | |
| 72 | Start fast and customize everything. |
| 73 | |
| 74 | - Ready-made website templates |
| 75 | - Pre-built sections and layout blocks |
| 76 | - Reusable design assets |
| 77 | - Import / export projects easily |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ### 🧩 Built-in Tools |
| 82 | |
| 83 | Everything you need — without extra plugins. |
| 84 | |
| 85 | - Form builder with submission management |
| 86 | - Popup builder with visual controls |
| 87 | - Interaction and animation builder |
| 88 | - Icon library and media tools |
| 89 | |
| 90 | --- |
| 91 | |
| 92 | ### 🎬 Interactions & Animations |
| 93 | |
| 94 | Create engaging, modern experiences. |
| 95 | |
| 96 | - Visual animation builder |
| 97 | - Interaction timeline editor |
| 98 | - Custom transitions and effects |
| 99 | - Text animation tools |
| 100 | |
| 101 | --- |
| 102 | |
| 103 | ### ⚙️ Advanced WordPress Customizer |
| 104 | |
| 105 | Extend WordPress customization with powerful controls. |
| 106 | |
| 107 | - 35+ customizer controls |
| 108 | - Real-time preview |
| 109 | - Automatic CSS generation |
| 110 | - Conditional logic support |
| 111 | - Developer-friendly API |
| 112 | - Performance optimized |
| 113 | |
| 114 | --- |
| 115 | |
| 116 | ## 👥 Who Is Kirki For? |
| 117 | |
| 118 | - Designers who want full creative freedom |
| 119 | - Freelancers building client websites |
| 120 | - Agencies managing multiple projects |
| 121 | - Developers extending WordPress functionality |
| 122 | - Anyone looking for a **no-code visual builder for WordPress** |
| 123 | |
| 124 | --- |
| 125 | |
| 126 | ## 🚀 What Makes Kirki Different? |
| 127 | |
| 128 | Kirki is not just another page builder. |
| 129 | |
| 130 | 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. |
| 131 | |
| 132 | **Design freely. Build with WordPress.** |
| 133 | |
| 134 | --- |
| 135 | |
| 136 | == Installation == |
| 137 | |
| 138 | 1. Go to **Plugins → Add New** |
| 139 | 2. Search for **Kirki** |
| 140 | 3. Click **Install Now** and **Activate** |
| 141 | |
| 142 | Or manually: |
| 143 | |
| 144 | 1. Upload the plugin to `/wp-content/plugins/kirki/` |
| 145 | 2. Activate via WordPress dashboard |
| 146 | 3. Open Kirki and start building |
| 147 | |
| 148 | --- |
| 149 | |
| 150 | == FAQ == |
| 151 | |
| 152 | = Is Kirki free? = |
| 153 | Yes, Kirki is free to use. Additional advanced features are available in Kirki Pro. |
| 154 | |
| 155 | = What's included in the free version? = |
| 156 | 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. |
| 157 | |
| 158 | = Do I need coding knowledge? = |
| 159 | No. Kirki is designed for visual, no-code website building. |
| 160 | |
| 161 | = Can I use Kirki with any theme? = |
| 162 | Yes, Kirki works with any WordPress theme. |
| 163 | |
| 164 | = Is Kirki responsive? = |
| 165 | Yes. You can design for desktop, tablet, and mobile. |
| 166 | |
| 167 | = Can I export my designs? = |
| 168 | Yes, import and export features are available. |
| 169 | |
| 170 | = Does Kirki support dynamic content? = |
| 171 | Yes, you can create dynamic templates and data-driven designs. |
| 172 | |
| 173 | = Where can I get support? = |
| 174 | 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 |
| 175 | |
| 176 | = I was using Kirki as a Customizer framework. Has anything changed? = |
| 177 | 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. |
| 178 | |
| 179 | --- |
| 180 | |
| 181 | == Screenshots == |
| 182 | |
| 183 | 1. Design on an freeform infinite canvas, with real-time editing across all responsive views. |
| 184 | 2. Build faster with ready sections you can save, reuse, and customize across any project. |
| 185 | 3. Create custom animations using a visual interaction builder and timeline editor. |
| 186 | 4. Bring your content to life with built-in text animation effects. |
| 187 | 5. Design forms visually, and manage all form submissions natively inside Kirki. |
| 188 | 6. Choose from a huge library of professionally designed WordPress themes to jumpstart your project. |
| 189 | |
| 190 | --- |
| 191 | |
| 192 | == Changelog == |
| 193 | |
| 194 | = 6.1.1 = |
| 195 | * Fix: Resolved php 7.4 compatibility issue. |
| 196 | |
| 197 | = 6.1.0 = |
| 198 | * New: Introduced a centralized Class Manager. |
| 199 | * New: Added Mix Blend Mode support to the Style Panel. |
| 200 | * Fix: Fixed filter and backdrop-filter properties being removed when deleting styles. |
| 201 | * Fix: Applied !important to the Liquid Glass backdrop filter for proper rendering. |
| 202 | * Fix: Fixed video audio playback for hover and autoplay when the audio toggle is enabled. |
| 203 | * Fix: Fixed an issue where color changes from the Selection Color Panel affected multiple elements. |
| 204 | * Fix: Resolved a double-click issue with legacy Rich Text content. |
| 205 | * Fix: Fixed cloned elements not syncing newly created style blocks with the server. |
| 206 | * Fix: Improved API security by validating editor preview tokens. |
| 207 | * Fix: Added validation for ZIP file uploads. |
| 208 | * Fix: Fixed frontend REST API validation for password-protected posts. |
| 209 | * Update: A curated set of Google Fonts now loads by default. A Google API key is needed to access the full library. |
| 210 | * Update: Redesigned range sliders to numerical input fields, so values can be set by dragging. |
| 211 | * Update: Updated the App Settings route middleware for preview tokens. |
| 212 | * Update: Implemented paginated loading for Kirki editor comments. |
| 213 | |
| 214 | = 6.0.14 = |
| 215 | * Fix: Fixed CSRF vulnerability in admin POST AJAX requests (kirki_wp_admin_post_apis). |
| 216 | * Fix: Sanitized redirect URLs and replaced wp_redirect with wp_safe_redirect in TemplateRedirection utility pages. |
| 217 | * Fix: Improved file path protection to prevent unauthorized access. |
| 218 | * Fix: Fixed datetime handling in the comment resource after Carbon removal. |
| 219 | * Fix: Fixed double-quote handling in font family variables. |
| 220 | * Fix: Fixed text style tag application for non-text elements. |
| 221 | * Update: Enhanced permission checks for AJAX endpoints and enabled SSL certificate verification for ZIP downloads. |
| 222 | * Update: Improved collaboration performance by running collaboration tasks in a separate thread. |
| 223 | |
| 224 | = 6.0.13 = |
| 225 | * New: Added support for dragging and dropping local media files directly into Grid cells. |
| 226 | * Update: Refactored the REST API backend for improved stability and maintainability. |
| 227 | * Fix: Implemented security improvements and resolved known security issues. |
| 228 | * Fix: Resolved device-specific interaction preview issues in the canvas. |
| 229 | * Fix: Added support for dynamic video fields from the Content Manager in the Video element. |
| 230 | |
| 231 | = 6.0.12 = |
| 232 | * Update: Added real-time canvas controls when focusing on Padding, Margin, and Gap inputs. |
| 233 | * Update: Improved Grid Controller functionality. |
| 234 | * Update: Automatically open the Element Settings panel when dropping Image, Icon, Video, Lottie, or SVG elements. |
| 235 | * Update: Context menu functionality improvements. |
| 236 | * Fix: Unauthenticated arbitrary comment modification and moderation bypass. |
| 237 | * Fix: Unauthenticated Server-Side Request Forgery vulnerability. |
| 238 | * Fix: Resolved the reset password email body issue by implementing hash validation. |
| 239 | * Fix: Addressed multiple random issues to improve overall stability. |
| 240 | |
| 241 | = 6.0.11 = |
| 242 | * New: Added multi-select support in the canvas |
| 243 | * Update: Improved grid controller functionality |
| 244 | * Update: Design enhancements |
| 245 | * Update: Hide non-active outlines while dragging controllers |
| 246 | * Update: Refined component edit top bar |
| 247 | * Update: Support wrapping elements across different parents |
| 248 | * Update: Improved sibling element outline behavior |
| 249 | * Update: Fixed Safari copy-paste issues when importing from Figma or copying elements within Kirki |
| 250 | |
| 251 | = 6.0.10 = |
| 252 | * New: Added timeline scrubbing support for previewing custom animations. |
| 253 | * New: Added variable support for Padding and Margin controls. |
| 254 | * New: Introduced breakpoint virtualization for better performance and scalability. |
| 255 | * Update: Improved Collection API call performance and optimizations. |
| 256 | * Update: Collection reference and multi-reference search functionality improvements. |
| 257 | * Update: Improved background color shade generation during color selection. |
| 258 | * Update: Added variable support for conic gradient color stops. |
| 259 | * Update: Improved variables, font-family support, and HTML generation for the Figma to Kirki plugin. |
| 260 | * Fix: Fixed permission and rewrite rule issues affecting Utility Pages. |
| 261 | * Fix: Figma to Kirki variable, font-family, image paste issue. |
| 262 | * Fix: Resolved pinch-to-zoom and zoom-out issues affecting Safari browsers. |
| 263 | |
| 264 | = 6.0.9 = |
| 265 | * New: Added support for custom timing editing in slider animations. |
| 266 | * Update: Updated the custom interaction timeline behavior for smoother editing and playback. |
| 267 | * Update: Improved color picker performance and responsiveness. |
| 268 | * Update: Improved comment behavior and shortcut handling. |
| 269 | * Update: Updated the Kirki Apps settings design. |
| 270 | * Fix: Fixed drawing issues caused by excessively large canvas sizes. |
| 271 | * Fix: Fixed inconsistencies with dragging cursor and controller interactions. |
| 272 | * Fix: Fixed device selection behavior when clicking outside elements. |
| 273 | * Fix: Fixed fill and gradient controller positioning issues. |
| 274 | * Fix: Fixed layer panel icon reset and undo behavior issues. |
| 275 | * Fix: Fixed nested rich text editing and selection behavior. |
| 276 | * Fix: Fixed symbol editing freeze issues after style synchronization. |
| 277 | * Fix: Fixed issues caused by deleting elements during active color picking. |
| 278 | * Fix: Fixed textarea height styling issues in form blocks. |
| 279 | |
| 280 | = 6.0.8 = |
| 281 | * Fix: Resolved css variable enqueue issue on the custom template pages. |
| 282 | * Fix: Fixed collection pagination issue for filtered data. |
| 283 | * Fix: Solved random issues. |
| 284 | |
| 285 | = 6.0.7 = |
| 286 | * Update: Centralized symbol edit canvas positioning across all symbols. |
| 287 | * Update: Added viewport-aware symbol editing for tablet and mobile. |
| 288 | * Update: Improved typography controls and CSS unit handling. |
| 289 | * Update: Added support for special max-width values and clamp() parsing. |
| 290 | * Update: Added CSS variable duplication support. |
| 291 | * Update: Refactored SVG rendering with dedicated InlineSvg handling. |
| 292 | * Update: Improved Liquid Glass rendering and viewport isolation. |
| 293 | * Fix: Unauthenticated Limited Arbitrary File Read and Deletion via downloadZIP |
| 294 | * Fix: Missing Authorization to Authenticated (Subscriber+) Sensitive Form Submission Data Exposure via 'kirki_wp_admin_get_apis' Action Description |
| 295 | * Fix: Unauthenticated Privilege Escalation via 'handle_forgot_password' |
| 296 | * Fix: Fixed auto-scroll for unmounted selected elements in the Layers panel. |
| 297 | * Fix: Rich text editing no longer blocks canvas zoom and scroll across viewports. |
| 298 | * Fix: Improved overlay behavior during typing and dragging interactions. |
| 299 | * Fix: Prevented tall symbol content from being clipped in symbol edit mode. |
| 300 | * Fix: Resolved forgot password content and reset URL issues. |
| 301 | * Fix: Corrected margin and padding value normalization. |
| 302 | * Fix: Improved border width and mixed unit handling. |
| 303 | * Fix: Fixed viewport activation and device delete flow issues. |
| 304 | * Fix: Improved Form submission data array serialization and multiple select handling. |
| 305 | * Fix: Interaction ScrollHeight and ScrollWidth property set issue. |
| 306 | |
| 307 | = 6.0.6 = |
| 308 | * Update: Enhanced the inline text editing and styling experience. |
| 309 | * Update: Added support for variable mode selection in components. |
| 310 | * Fix: Fixed a security vulnerability in media search. |
| 311 | * Fix: Improved code preview and code editor functionality. |
| 312 | |
| 313 | = 6.0.5 = |
| 314 | * Update: Improved element comment coordinate positioning |
| 315 | * Update: Enhanced island toolbar functionality |
| 316 | * Update: Improved grid inline control area settings and track unit selection |
| 317 | * Update: Improved navigation element functionality |
| 318 | * Update: Enhanced code element functionality |
| 319 | * Update: Improved variable and text addition workflow |
| 320 | * Update: Collection item post_data and modified_data are not updating correctly for scheduled posts |
| 321 | * Fix: Fixed handling of multi-select values when styleBlockId is missing |
| 322 | * Fix: Resolved component name overflow in component list items |
| 323 | * Fix: Fixed canvas repositioning issue during component editing |
| 324 | * Fix: Fixed collaboration endpoint unauthorized access |
| 325 | * Fix: Fixed grid x,y alignment property update issue |
| 326 | |
| 327 | = 6.0.4 = |
| 328 | * Fix: Resolved an Uncaught SyntaxError in webfontloader.min.js |
| 329 | * Fix: Broken woocommerce catalog product title |
| 330 | * Update: Updated frontend script enqueue handling for Kirki-based designs. |
| 331 | * Improvement: Enhanced text element tag selection; now supports span, p, and h1–h6 |
| 332 | |
| 333 | = 6.0.3 = |
| 334 | * Fix: WebFontLoader JavaScript file not found issue resolved. |
| 335 | * Fix: WebFont is not defined error fixed in the Konte theme. |
| 336 | * Fix: Added backward compatibility for all Kirki modules (CSS, Tooltips, Postmessage, Field_Dependencies, Selective_Refresh, Preset, Webfonts, Editor_Styles) to prevent fatal errors. |
| 337 | * Fix: Added class alias existence checks to prevent redeclaration warnings when themes/plugins have bundled Kirki. |
| 338 | * Fix: Added type safety check in Field constructor to handle legacy argument formats. |
| 339 | * Fix: Added missing property declarations ($name, $data_tags, $dynamic) to prevent PHP 8.2+ dynamic property deprecation warnings. |
| 340 | * Improvement: Stability improvements. |
| 341 | * Improvement: Fixed DesiIcons alignment issue. |
| 342 | |
| 343 | = 6.0.2 = |
| 344 | * Fix: Resolved a fatal error that occurred when the wp_insert_post hook was triggered after the plugin finished loading. |
| 345 | |
| 346 | = 6.0.1 = |
| 347 | * Update: Theme header and footer display logic updated. |
| 348 | |
| 349 | = 6.0.0 = |
| 350 | * New: Kirki is now a fully freeform visual website builder — design on an infinite canvas with no layout restrictions. |
| 351 | * New: Rebranded from Droip to Kirki — the Customizer framework and the visual builder are now unified under one product. |
| 352 | * New: Atomic design approach — compose from primitives, no pre-decided widgets, no component ceilings. |
| 353 | * New: Responsive editing, full interaction timeline, form builder, popup builder, and dynamic CMS — all built in. |
| 354 | * New: Real-time collaboration — design together on the same canvas simultaneously. |
| 355 | * New: Staging mode, publish history, and rollback. |
| 356 | * New: Figma to Kirki importer — import designs directly into the canvas. |
| 357 | * New: Dev mode — full CSS visibility and clean markup for developer handoff. |
| 358 | * New: 100+ premium template kits for faster launches. |
| 359 | * New: White label support for agencies. |
| 360 | * Update: Unified builder and Customizer experience. |
| 361 | * Note: All existing Customizer controls are fully preserved. No changes to your current setup. |
| 362 | |
| 363 | = 5.2.2 = |
| 364 | * Fix: Color palette not displaying in the Customizer in certain cases. |
| 365 | * Fix: Select field inside Repeater control not retaining the selected value. |
| 366 | |
| 367 | = 5.2.1 = |
| 368 | * Fix: Fixed an issue where the file path was used incorrectly. |
| 369 | |
| 370 | = 5.2.0 = |
| 371 | * Update: Performance optimizations across the platform. |
| 372 | * Update: Added compatibility with WordPress 6.9. |
| 373 | |
| 374 | = 5.1.0 = |
| 375 | * Fix: Resolved the issue with fonts not loading properly. |
| 376 | * Fix: Addressed deprecated errors to boost compatibility. |
| 377 | * Update: Compatibility with WordPress 6.4 and PHP 8.2. |
| 378 | |
| 379 | = 5.0.0 = |
| 380 | * Update: Free and Pro merged. |
| 381 | |
| 382 | --- |
| 383 | |
| 384 | == Support == |
| 385 | |
| 386 | - Community support: https://facebook.com/groups/kirkicommunity |
| 387 | - Documentation: https://kirki.com/docs |
| 388 | - Website: https://kirki.com |
| 389 | |
| 390 | --- |
| 391 | |
| 392 | == Upgrade Notice == |
| 393 | |
| 394 | = 6.0.0 = |
| 395 | 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. |