| 1 |
# Block Animations, Motion & Scroll Effects – Ghost Kit # |
| 2 |
|
| 3 |
* Contributors: nko |
| 4 |
* Tags: animation, effects, scroll effects, blocks, gutenberg blocks |
| 5 |
* Donate link: https://www.ghostkit.io/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=donate |
| 6 |
* Requires at least: 6.6 |
| 7 |
* Tested up to: 7.1 |
| 8 |
* Requires PHP: 7.4 |
| 9 |
* Stable tag: 3.7.2 |
| 10 |
* License: GPLv2 or later |
| 11 |
* License URI: <http://www.gnu.org/licenses/gpl-2.0.html> |
| 12 |
|
| 13 |
Animate WordPress blocks with reveal, scroll, mouse and loop effects, set in the block settings. |
| 14 |
|
| 15 |
## Description ## |
| 16 |
|
| 17 |
**Ghost Kit adds motion to the blocks you already use.** Select a block, open Effects in the block settings, and choose what happens when it comes into view, when the page scrolls past it, and when the pointer moves across it. |
| 18 |
|
| 19 |
[See Live Demo](https://www.ghostkit.io/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=head) | [Documentation](https://www.ghostkit.io/docs/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=head) | [GitHub](https://github.com/nk-crew/ghostkit/) |
| 20 |
|
| 21 |
WordPress ships a good set of blocks now. What it still does not ship is motion, and the usual way to get motion is to rebuild the page in a page builder. Ghost Kit is the smaller move. Keep the blocks you have and add the animation on top. |
| 22 |
|
| 23 |
### 🎬 Reveal animations ### |
| 24 |
|
| 25 |
Start from a preset, Fade In, Zoom In or one of the three directional zooms, then adjust the offset, opacity, scale and rotation the block animates from. The transition is a spring rather than a fixed easing curve, so the movement settles instead of stopping dead. Reveal is in the free plugin. |
| 26 |
|
| 27 |
### 📜 Scroll effects ### |
| 28 |
|
| 29 |
Tie a block's position, scale, rotation and opacity to how far the page has scrolled, rather than to a single trigger. This is how parallax sections and scroll-driven reveals are built. |
| 30 |
|
| 31 |
### 🖱️ Mouse effects ### |
| 32 |
|
| 33 |
Move, tilt, scale or rotate a block as the pointer travels over it. Hover and press are separate states, so a card can lift under the cursor and sink when it is clicked. |
| 34 |
|
| 35 |
### 🔁 Loop animations ### |
| 36 |
|
| 37 |
Run an animation continuously. Rotating badges, floating shapes and drifting backgrounds are all loops with different transforms. |
| 38 |
|
| 39 |
### ♿ Reduced motion is respected ### |
| 40 |
|
| 41 |
Every effect checks `prefers-reduced-motion: reduce` before it runs, so a visitor who turned animations off in their operating system gets a still page. There is nothing to configure. |
| 42 |
|
| 43 |
### 🧩 It works on the blocks you already have ### |
| 44 |
|
| 45 |
Effects appear on every core WordPress block, from Paragraph, Heading and Image to Cover, Group, Columns, Buttons and Query Loop. They appear on every Ghost Kit block as well. A block from another plugin can opt in by declaring `supports.ghostkit` in its own `block.json`. |
| 46 |
|
| 47 |
You do not have to rebuild anything. Install the plugin, select a block that is already on the page, and the controls are there. |
| 48 |
|
| 49 |
### ⚙️ Extensions ### |
| 50 |
|
| 51 |
The same place carries the controls a block usually needs and WordPress leaves out. |
| 52 |
|
| 53 |
* [**Position**](https://www.ghostkit.io/docs/extensions/position/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 54 |
Switch a block to absolute or fixed and offset it, per screen size. |
| 55 |
|
| 56 |
* [**Spacings**](https://www.ghostkit.io/docs/extensions/spacings/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 57 |
Padding and margin per screen size, on any block. |
| 58 |
|
| 59 |
* [**Frame**](https://www.ghostkit.io/docs/extensions/frame/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 60 |
Borders, corner radius and shadows, with a separate hover state. |
| 61 |
|
| 62 |
* [**Display**](https://www.ghostkit.io/docs/extensions/display-conditions/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 63 |
Hide a block on the screen sizes where it does not belong. |
| 64 |
|
| 65 |
* [**Transform**](https://www.ghostkit.io/docs/extensions/transform/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 66 |
Translate, scale, rotate and skew, including a hover state. |
| 67 |
|
| 68 |
* [**Custom CSS & JavaScript**](https://www.ghostkit.io/docs/extensions/custom-css-js/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) |
| 69 |
Per page or site wide, edited in the admin with syntax highlighting. |
| 70 |
|
| 71 |
### 🧱 Blocks ### |
| 72 |
|
| 73 |
Ghost Kit also ships blocks for the things core still leaves out. Every one of them carries the Effects panel. |
| 74 |
|
| 75 |
* [Advanced Columns](https://www.ghostkit.io/docs/blocks/advanced-columns/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), a twelve column responsive grid with visual size and order controls |
| 76 |
* [Accordion](https://www.ghostkit.io/docs/blocks/accordion/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Tabs](https://www.ghostkit.io/docs/blocks/tabs/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Toggle Content](https://www.ghostkit.io/docs/blocks/toggle-content/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 77 |
* [Alert](https://www.ghostkit.io/docs/blocks/alert/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Icon](https://www.ghostkit.io/docs/blocks/icon/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Number Box](https://www.ghostkit.io/docs/blocks/number-box/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Progress](https://www.ghostkit.io/docs/blocks/progress/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Countdown](https://www.ghostkit.io/docs/blocks/countdown/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 78 |
* [Button](https://www.ghostkit.io/docs/blocks/button/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Circle Button](https://www.ghostkit.io/docs/blocks/circle-button/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Divider](https://www.ghostkit.io/docs/blocks/divider/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Shape Divider](https://www.ghostkit.io/docs/blocks/shape-divider/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 79 |
* [Video](https://www.ghostkit.io/docs/blocks/video/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [GIF](https://www.ghostkit.io/docs/blocks/gif/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Image Compare](https://www.ghostkit.io/docs/blocks/image-compare/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Image Scroller](https://www.ghostkit.io/docs/blocks/image-scroller/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Magnifying Image](https://www.ghostkit.io/docs/blocks/magnifying-image/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Carousel](https://www.ghostkit.io/docs/blocks/carousel/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Marquee](https://www.ghostkit.io/docs/blocks/marquee/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 80 |
* [Contact Form](https://www.ghostkit.io/docs/blocks/form/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Google Maps](https://www.ghostkit.io/docs/blocks/google-maps/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Pricing Table](https://www.ghostkit.io/docs/blocks/pricing-table/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Testimonial](https://www.ghostkit.io/docs/blocks/testimonial/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Table of Contents](https://www.ghostkit.io/docs/blocks/table-of-contents/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 81 |
* [Code Highlight](https://www.ghostkit.io/docs/blocks/code/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [GitHub Gist](https://www.ghostkit.io/docs/blocks/github-gist/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Changelog](https://www.ghostkit.io/docs/blocks/changelog/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Interactive Links](https://www.ghostkit.io/docs/blocks/interactive-links/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) |
| 82 |
|
| 83 |
### ✍️ Content formatting ### |
| 84 |
|
| 85 |
Formats that apply to a text selection rather than to a whole block. See them on the [formats demo page](https://www.ghostkit.io/docs/formats/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting). |
| 86 |
|
| 87 |
[Animated Text](https://www.ghostkit.io/docs/formats/animated-text/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Badges](https://www.ghostkit.io/docs/formats/badge/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Lorem Ipsum Generator](https://www.ghostkit.io/docs/formats/lorem-ipsum-generator/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Spoiler](https://www.ghostkit.io/docs/formats/spoiler/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Stroke](https://www.ghostkit.io/docs/formats/stroke/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Tooltip](https://www.ghostkit.io/docs/formats/tooltip/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Uppercase](https://www.ghostkit.io/docs/formats/uppercase/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting) |
| 88 |
|
| 89 |
### 🔥 Ghost Kit Pro ### |
| 90 |
|
| 91 |
> The free plugin covers reveal animations, the layout extensions and the block set. [**Ghost Kit Pro**](https://www.ghostkit.io/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=pro) adds the rest of the motion system and pays for the free version to keep being maintained and supported. |
| 92 |
|
| 93 |
* Scroll effects, mouse effects and loop animations |
| 94 |
* 3D rotation, custom viewport and replay for reveal animations |
| 95 |
* CSS transform and transition per block, with a hover state |
| 96 |
* Custom block attributes and custom responsive breakpoints |
| 97 |
* Marquee, Code Highlight, Interactive Links, Magnifying Image, Image Scroller, Circle Button and Toggle Content blocks |
| 98 |
* Animated Text, Stroke, Spoiler and Tooltip formats |
| 99 |
* More icon packs, Adobe Fonts and custom font files |
| 100 |
* Gradients for buttons, backgrounds, icons and badges |
| 101 |
* Extra shapes for the Shape Divider block |
| 102 |
|
| 103 |
### 🏳️ Multilingual ### |
| 104 |
|
| 105 |
Ghost Kit adds a layer of [WPML](https://wpml.org/) compatibility. Every block is translation ready. [Read the multilingual guide](https://www.ghostkit.io/docs/languages/multilingual/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=multilingual). |
| 106 |
|
| 107 |
## Installation ## |
| 108 |
|
| 109 |
### Automatic installation ### |
| 110 |
|
| 111 |
In the WordPress dashboard go to Plugins, click Add New, and search for Ghost Kit. Click Install Now and then Activate. Effects appear in the block settings straight away. |
| 112 |
|
| 113 |
### Manual installation ### |
| 114 |
|
| 115 |
Download the plugin, upload the folder to `wp-content/plugins` over FTP, and activate it from the Plugins screen. The WordPress documentation has [the longer version](https://wordpress.org/documentation/article/manage-plugins/#manual-plugin-installation-1). |
| 116 |
|
| 117 |
## Frequently Asked Questions ## |
| 118 |
|
| 119 |
### Which blocks can I animate? ### |
| 120 |
|
| 121 |
Every core WordPress block and every Ghost Kit block. That covers Paragraph, Heading, Image, Cover, Group, Columns, Buttons, Query Loop and the rest of the core set. A block from another plugin joins in once it declares `supports.ghostkit` in its `block.json`. |
| 122 |
|
| 123 |
### Do I need a page builder? ### |
| 124 |
|
| 125 |
No. Ghost Kit works inside the standard block editor and the Site Editor. Pages you have already built stay as they are, and the Effects panel appears on the blocks that are on them. |
| 126 |
|
| 127 |
### Do the animations work on mobile? ### |
| 128 |
|
| 129 |
Yes. Reveal animations run on touch devices as the visitor scrolls. Mouse effects need a pointer, so they stay idle on touch screens rather than misfiring. |
| 130 |
|
| 131 |
### Will animations slow down my site? ### |
| 132 |
|
| 133 |
The effects are CSS transforms and opacity changes, which the browser composites on the GPU. Ghost Kit loads the effects script only on pages that actually use an effect. |
| 134 |
|
| 135 |
### What happens for visitors who turned animations off? ### |
| 136 |
|
| 137 |
Ghost Kit checks `prefers-reduced-motion: reduce` and skips the animation for them, leaving the block in its final state. This is on by default and there is no setting to remember. |
| 138 |
|
| 139 |
### How do I add a parallax effect? ### |
| 140 |
|
| 141 |
Select the block, open Effects, and use Scroll to tie its vertical offset to the scroll position. Scroll effects are part of Ghost Kit Pro. |
| 142 |
|
| 143 |
### Can I reuse an effect on another block? ### |
| 144 |
|
| 145 |
Yes. The block toolbar has a Ghost Kit menu with Copy extensions and Paste extensions, so an effect you tuned on one block can be pasted onto the next one instead of set up again. |
| 146 |
|
| 147 |
### Does Ghost Kit have documentation? ### |
| 148 |
|
| 149 |
Yes, at [ghostkit.io/docs](https://www.ghostkit.io/docs/getting-started/?utm_source=wordpress.org&utm_medium=faq&utm_campaign=docs). It covers every block, every extension, and the filters and events for developers. |
| 150 |
|
| 151 |
### Is Ghost Kit translation ready? ### |
| 152 |
|
| 153 |
Yes, and it carries WPML compatibility for block content. |
| 154 |
|
| 155 |
## Screenshots ## |
| 156 |
|
| 157 |
1. Ghost Kit panels on a core Group block: Effects, Position, Spacings, Frame, Transform, Custom CSS and Display Conditions |
| 158 |
2. Reveal settings: a Zoom In preset, the offset the block animates from, and a spring transition |
| 159 |
3. Ghost Kit blocks in the inserter |
| 160 |
4. Frame: border, corner radius and shadow, each with a hover state and a value per screen size |
| 161 |
5. Display Conditions: hide a block at one screen size and leave it at the others |
| 162 |
6. Transform: translate, scale and rotate a block, in 2D or 3D |
| 163 |
|
| 164 |
## Changelog ## |
| 165 |
|
| 166 |
= 3.7.2 - Sep 14, 2026 = |
| 167 |
|
| 168 |
* fixed a critical error on sites where another plugin ships a different version of the same CSS parser, which showed up as "Declaration of Sabberworm\CSS\Value\Size::render() must be compatible" once the custom breakpoints styles were rebuilt |
| 169 |
* changed custom breakpoints to be applied to the shipped stylesheets directly instead of compiling styles on the site, so the change takes effect on the next page load |
| 170 |
* fixed RTL sites loading the left-to-right stylesheets for blocks, the editor and the settings pages |
| 171 |
* **Pro:** |
| 172 |
* fixed one failed plugin update on the Plugins screen leaving the remaining queued updates waiting for a page reload |
| 173 |
* fixed RTL sites loading the left-to-right stylesheets of the Pro blocks on the frontend and in the editor |
| 174 |
|
| 175 |
= 3.7.1 - Aug 31, 2026 = |
| 176 |
|
| 177 |
* changed Ghost Kit to stay active next to Ghost Kit Pro instead of being deactivated |
| 178 |
* **Pro:** |
| 179 |
* fixed effects sometimes not running, leaving blocks with a reveal effect hidden on the page |
| 180 |
|
| 181 |
= 3.7.0 - Aug 26, 2026 = |
| 182 |
|
| 183 |
* added WordPress 7.1 compatibility |
| 184 |
* added a Privacy-Enhanced Mode toggle to the Video block, shown once the entered URL is a YouTube one |
| 185 |
* changed YouTube embeds to use the regular YouTube host by default, because the privacy-enhanced host asks a share of visitors to sign in before it plays anything |
| 186 |
* fixed block icons and the custom color palette not reaching the blocks they style in the editor |
| 187 |
* fixed the typography preview not applying in the editor |
| 188 |
* fixed PHP warnings logged by the Table of Contents and Widgetized Area blocks |
| 189 |
* raised the minimum PHP requirement to 7.4 |
| 190 |
* **Pro:** |
| 191 |
* fixed tooltips never appearing in the editor |
| 192 |
* fixed the update notice still offering a version already installed |
| 193 |
* added a capability check to the license activation request |
| 194 |
|
| 195 |
= 3.6.1 - Jun 21, 2026 = |
| 196 |
|
| 197 |
* fixed stored XSS from contributors via Customizer post meta (`ghostkit_customizer_options`) |
| 198 |
* hardened Customizer post meta with permission checks, sanitization, and frontend filtering |
| 199 |
* fixed Gutenberg post saves failing when unchanged protected post meta was included in the REST request |
| 200 |
* allow local typography editing for users with `edit_post` on the post; global typography editing requires `edit_theme_options` |
| 201 |
|
| 202 |
= 3.6.0 - Jun 5, 2026 = |
| 203 |
|
| 204 |
* added WordPress 7.0 compatibility |
| 205 |
* improved frontend assets detection — centralize block.json handles, extensions, style variants, and effects markers in `GhostKit_Assets_Detector` |
| 206 |
* added `gkt_icons_detected_packs` filter to enqueue only icon packs used on the page |
| 207 |
* added editor filters for responsive preview sizes (`mediaSizes`, `previewWidth`) |
| 208 |
* fixed GitHub Gist block stylesheet lookup and gist-simple script registration in the editor |
| 209 |
* fixed Gist and Lottie block assets loading in the block editor |
| 210 |
* fixed Table of Contents REST request params sanitization |
| 211 |
* fixed URL Picker inspector layout overrides scope in the editor |
| 212 |
* fixed Pricing Table Item features list editing (replaced deprecated RichText multiline) |
| 213 |
* fixed quote to testimonial transform preserving content |
| 214 |
* fixed editor compatibility with stable Gutenberg controls and removed deprecations |
| 215 |
* use WordPress admin theme CSS variables for accent UI colors |
| 216 |
* minor changes and fixes |
| 217 |
* **Pro:** |
| 218 |
* fixed custom Breakpoints styles not loading from uploads on the frontend |
| 219 |
* fixed Breakpoints settings validation when editing values in settings |
| 220 |
* synced editor responsive preview with saved Pro breakpoint widths |
| 221 |
|
| 222 |
= 3.5.1 - Mar 4, 2026 = |
| 223 |
|
| 224 |
* fixed frontend general styles being enqueued in the editor, which caused style conflicts (e.g., issues with the `Display` extension in the editor) |
| 225 |
|
| 226 |
= 3.5.0 - Feb 24, 2026 = |
| 227 |
|
| 228 |
* improve assets loading to native way |
| 229 |
* update wp-background-processing library to fix warnings with Visual Portfolio plugin |
| 230 |
* fixed progress bar viewport animation on mobile |
| 231 |
* fixed nested accordion styles |
| 232 |
* **Pro:** |
| 233 |
* improve assets loading - load only used on the page assets and not all |
| 234 |
* minor changes and fixes |
| 235 |
|
| 236 |
= 3.4.6 - Dec 7, 2025 = |
| 237 |
|
| 238 |
* fixed incorrect double escaping of Effects extension attribute because of WP 6.9 changes |
| 239 |
* **Pro:** |
| 240 |
* fixed incorrect double escaping of Attributes extension attribute because of WP 6.9 changes |
| 241 |
|
| 242 |
= 3.4.5 - Dec 3, 2025 = |
| 243 |
|
| 244 |
* **Pro:** |
| 245 |
* fixed error appear in WordPress 6.9 because of changed behavior of `wp_enqueue_script_module` function |
| 246 |
|
| 247 |
= 3.4.4 - Sep 11, 2025 = |
| 248 |
|
| 249 |
* added permission checks to custom JS and CSS in posts meta editor (fixes possible XSS from contributors) |
| 250 |
|
| 251 |
= 3.4.3 - Jun 21, 2025 = |
| 252 |
|
| 253 |
* fixed always generating heading block anchors even if it not required |
| 254 |
|
| 255 |
= 3.4.2 - Jun 21, 2025 = |
| 256 |
|
| 257 |
* fixed XSS with theme template files |
| 258 |
* fixed block unique ID when duplicating multiple blocks |
| 259 |
* fixed displaying TOC heading content in editor |
| 260 |
* fixed Icon block rendering `aria-label` attribute on link |
| 261 |
* **Pro:** |
| 262 |
* fixed updater caching issue that sometimes caused Forbidden errors |
| 263 |
|
| 264 |
= 3.4.1 - Jan 13, 2025 = |
| 265 |
|
| 266 |
* fixed blocks error in Widgets screen because 'core/editor' store is not available |
| 267 |
* updated Google Fonts list |
| 268 |
* **Pro:** |
| 269 |
* changed loading of module script in Code block to `wp_enqueue_script_module` |
| 270 |
|
| 271 |
= 3.4.0 - Dec 18, 2024 = |
| 272 |
|
| 273 |
* added WordPress 6.7 compatibility fixes |
| 274 |
* significantly improved motion effects performance to prevent memory overload |
| 275 |
* fixed editor slow rendering when first page load and when duplicate blocks without any extensions on blocks |
| 276 |
* fixed displaying responsive toggle in editor header |
| 277 |
* fixed resizing editor preview when switch responsive toggles |
| 278 |
* fixed usage of `wp-content` hardcoded string, use constants if available |
| 279 |
* hidden Twitter and Instagram blocks from inserter as it is deprecated long time ago |
| 280 |
* removed fallback class for Breakpoints, as it is no longer required |
| 281 |
* minor changes |
| 282 |
* **Pro:** |
| 283 |
* changed text domain from `ghostkit-pro` to `ghostkit` |
| 284 |
* fixed displaying message about license activation in the plugins list when the license already active |
| 285 |
* removed Circle Button frontend script, because it is no longer used, as we have Effects extension |
| 286 |
|
| 287 |
= 3.3.3 - Sep 7, 2024 = |
| 288 |
|
| 289 |
* added escaping to imageTag attribute in the Grid block to prevent xss vulnerability |
| 290 |
|
| 291 |
= 3.3.2 - Jul 31, 2024 = |
| 292 |
|
| 293 |
* migrate Pro plugin from Paddle to LemonSqueezy |
| 294 |
* fixed customizer plugin selector settings rendering |
| 295 |
* fixed Color Palette plugin saving custom colors, displaying default color picker dropdown |
| 296 |
* fixed deprecated Templates modal loading |
| 297 |
|
| 298 |
= 3.3.0 - May 26, 2024 = |
| 299 |
|
| 300 |
* **Important**: the Pro plugin is now standalone and no longer requires the free plugin. If you are using Pro plugin v2, do not update the Free plugin to v3.3. Instead, update the Pro plugin and deactivate the Free one. |
| 301 |
* fixed Counter Box saving incorrect class names |
| 302 |
* fixed loading blocks in the legacy Widgets editor |
| 303 |
|
| 304 |
= 3.2.4 - Mar 15, 2024 = |
| 305 |
|
| 306 |
* fixed extensions enable in 3rd-party blocks with config like this: |
| 307 |
``` |
| 308 |
ghostkit: { |
| 309 |
customCSS: true, |
| 310 |
} |
| 311 |
``` |
| 312 |
|
| 313 |
= 3.2.3 - Feb 26, 2024 = |
| 314 |
|
| 315 |
* fixed loading some Google Fonts with specific names. For example, font "Source Serif 4" was not loaded properly |
| 316 |
* fixed Accordion and Tabs buttons default text align |
| 317 |
* fixed Video block with "icon only" style displaying poster image in editor |
| 318 |
|
| 319 |
= 3.2.2 - Feb 21, 2024 = |
| 320 |
|
| 321 |
#### Pro: |
| 322 |
|
| 323 |
* Pro plugin v2.2.2 |
| 324 |
* added transformation from Code and Preformatted blocks to Code Highlight |
| 325 |
* fixed Code block Vesper theme default color |
| 326 |
* fixed Code block None language rendering |
| 327 |
* fixed fonts rendering on frontend |
| 328 |
|
| 329 |
#### Free: |
| 330 |
|
| 331 |
* fixed Pro features Note returns an error and leads the block to crash in the editor |
| 332 |
|
| 333 |
= 3.2.1 - Feb 19, 2024 = |
| 334 |
|
| 335 |
* fixed typography and fonts loading on frontend |
| 336 |
|
| 337 |
= 3.2.0 - Feb 18, 2024 = |
| 338 |
|
| 339 |
> There are significant changes to the following blocks: `Google Maps`, `Tabs`, and `Accordion`. |
| 340 |
> Old blocks will work correctly, but after this update, it is highly recommended to do the following steps: |
| 341 |
> |
| 342 |
> 1. Open page in editor where these blocks are used |
| 343 |
> 2. Make any change in content (for ex. add and remove paragraph) |
| 344 |
> 3. Click on the Update button to re-save the page. |
| 345 |
|
| 346 |
#### Pro: |
| 347 |
|
| 348 |
* Pro plugin v2.2.0 |
| 349 |
* added Code Highlight block <https://www.ghostkit.io/docs/blocks/code/> |
| 350 |
* added support for alpha channel in Stroke format color |
| 351 |
* added support for `ivent` library used in the free plugin |
| 352 |
* fixed Magnifying Image block side view z-index |
| 353 |
* fixed wrong gap calculation in Marquee block |
| 354 |
* fixed enqueue assets for iframe - use `enqueue_block_assets` |
| 355 |
* removed Google Maps extension → added to the Free plugin |
| 356 |
* removed support for deprecated Fonts API |
| 357 |
|
| 358 |
#### Free: |
| 359 |
|
| 360 |
* reworked Google Maps block: |
| 361 |
* added support for custom markers and info window text |
| 362 |
* moved map styles to Styles tab |
| 363 |
* simplified Full Height map styles to use `--wp-admin--admin-bar--height` variable |
| 364 |
* removed dependency on 3rd-party library - use Google Maps API directly |
| 365 |
* reworked Tabs block: |
| 366 |
* improved WCAG compatibility |
| 367 |
* added `aria-selected`, `aria-labelledby`, `aria-controls`, and `aria-orientation` attributes |
| 368 |
* changed tab from `<a>` tag to `<>button>` |
| 369 |
* changed hidden tab content to `display: none` |
| 370 |
* on screen readers use arrow keys to switch tabs |
| 371 |
* tab content is focusable |
| 372 |
* reworked Accordion block: |
| 373 |
* added h1 title tag support |
| 374 |
* improved WCAG compatibility |
| 375 |
* changed heading from `<a>` tag to `<>button>` |
| 376 |
* added `aria-selected`, `aria-labelledby`, `aria-controls`, and `aria-orientation` attributes |
| 377 |
* fixed click on Add Accordion Item button in editor |
| 378 |
* added support for text color in Badge format |
| 379 |
* added support for Columns blocks inside the Form block |
| 380 |
* improved InputDrag and InputGroup components - expand the input when value is large (for example, when you add the CSS variable in Padding or Margin extension) |
| 381 |
* improved Form block validation - check validity on blur only for forms that were submitted and are invalid |
| 382 |
* fixed rare problem when extensions resets after block transformation from deprecated version |
| 383 |
* fixed displaying hidden elements if user has enabled reduced motion |
| 384 |
* fixed displaying deprecated Templates feature in the editor Options dropdown |
| 385 |
* fixed responsive toggle in editor toolbar in the latest Gutenberg |
| 386 |
* fixed form reCaptcha keys saving method (sometimes the secret key was not saved properly) |
| 387 |
* fixed Changelog block uses deprecated default template |
| 388 |
* fixed Number Box block decimal numbers animation |
| 389 |
* fixed Table of Contents block selection when no headings available on the page |
| 390 |
* fixed Table of Contents block rendering heading content in the latest Gutenberg |
| 391 |
* fixed enqueue assets for iframe - use `enqueue_block_assets` |
| 392 |
* changed internal EventHandler to `ivent` library |
| 393 |
* removed support for deprecated Fonts API |
| 394 |
* dev version improvements: |
| 395 |
* added unit and e2e tests |
| 396 |
* changed build structure to official `wp-scripts` |
| 397 |
* better assets enqueue version and dependencies |
| 398 |
* minor changes |
| 399 |
|
| 400 |
= 3.1.2 - Nov 23, 2023 = |
| 401 |
|
| 402 |
* improved Styles component to use useCallback |
| 403 |
* fixed possibility to add custom classes when our `ghostkit-custom-...` class added |
| 404 |
* fixed missing `+` symbol in custom CSS |
| 405 |
* fixed blocks enqueue method in Ghost Kit settings pages |
| 406 |
|
| 407 |
= 3.1.1 - Nov 16, 2023 = |
| 408 |
|
| 409 |
* fixed migration to new Ghost Kit attributes from deprecated blocks (mostly from Core blocks, which has deprecated attributes) |
| 410 |
* changed ProNote component in Reveal effect to collapsed version to not overwhelm effect settings panel |
| 411 |
* changed Spring transition defaults |
| 412 |
|
| 413 |
= 3.1.0 - Nov 12, 2023 = |
| 414 |
|
| 415 |
> Deprecated changes: |
| 416 |
|
| 417 |
* completely reworked block extensions. If you used extensions for your custom blocks, using custom JS, you will need to change it, as an API changed. |
| 418 |
* deprecated Templates extension and will be hidden if there are no custom templates available. It is recommended to use Patterns feature instead |
| 419 |
|
| 420 |
Changes: |
| 421 |
|
| 422 |
* added Effects extension |
| 423 |
* Reveal effects |
| 424 |
* Loop, Scroll, Mouse Press, Mouse Hover, Mouse Move effects (for Pro users) |
| 425 |
* added Custom CSS extension: |
| 426 |
* Opacity |
| 427 |
* Overflow |
| 428 |
* Clip Path |
| 429 |
* Cursor |
| 430 |
* User Select |
| 431 |
* Transition (for Pro users) |
| 432 |
* Custom styles |
| 433 |
* added Transform extension (for Pro users) |
| 434 |
* added Custom Attributes extension (for Pro users) |
| 435 |
* possibility to add custom HTML attributes, something like `data-speed="5"` |
| 436 |
* added more Position extension tools: |
| 437 |
* Width and Height |
| 438 |
* Min/Max Width and Height |
| 439 |
* added possibility to copy and paste extensions to blocks |
| 440 |
* added Icon block |
| 441 |
* added Fade Edges option to Carousel block |
| 442 |
* added Radio style to Tabs block |
| 443 |
* added Responsive toggle to editor toolbar with all available Ghost Kit Breakpoints |
| 444 |
* added Responsive toggle to block controls |
| 445 |
* improved Icon Picker UI |
| 446 |
* improved Video block settings |
| 447 |
* updated FontAwesome icons and Google Fonts |
| 448 |
* changed old attributes to new `ghostkit` |
| 449 |
* ghostkitId → ghostkit.id |
| 450 |
* ghostkitStyles → ghostkit.styles |
| 451 |
* ghostkitClassname → removed |
| 452 |
* changed Shape Divider block to flex |
| 453 |
* fixed Image Compare on touch screens |
| 454 |
* fixed Tabs block active tab in editor |
| 455 |
* fixed usage of custom db prefix to get saved typography settings |
| 456 |
|
| 457 |
= 3.0.2 - Sep 28, 2023 = |
| 458 |
|
| 459 |
* fixed form with recaptcha JS submit error |
| 460 |
* fixed Typography Select control dropdown position when placed inside Modal |
| 461 |
* fixed custom styles background processing error |
| 462 |
|
| 463 |
= 3.0.1 - Sep 27, 2023 = |
| 464 |
|
| 465 |
* fixed rare error on some operating systems, which does not contain the GLOB_BRACE constant |
| 466 |
|
| 467 |
= 3.0.0 - Sep 26, 2023 = |
| 468 |
|
| 469 |
> There are a lot of changes in v3, before updating it on production, we recommend test it in staging site first. Look at some of the breaking changes: |
| 470 |
|
| 471 |
* removed jQuery usage completely: |
| 472 |
* added simple fallbacks where possible |
| 473 |
* added instance to the `prepared.googleMaps` event |
| 474 |
* remove events `afterInit`, `beforeInit.blocks`, `afterInit.blocks` |
| 475 |
* new JS events documented here - <https://www.ghostkit.io/docs/developers/js-events/> |
| 476 |
* remove main GhostKit class from JS |
| 477 |
* removed Variants feature, use native Gutenberg Styles instead. This feature was introduced in first versions of Ghost Kit, but Gutenberg added their Styles feature, which is widely used now and our Variants no longer needed |
| 478 |
* removed custom bottom margin from all Ghost Kit blocks in FSE themes only (this change may impact your existing sites) |
| 479 |
* removed Parsley library, use native Form validation instead. Less size, better performance |
| 480 |
* there are a lot of plans for Ghost Kit v3 future updates (and new site coming soon). It will be huge 😎 |
| 481 |
|
| 482 |
Changes: |
| 483 |
|
| 484 |
* register all blocks in PHP using `register_block_type_from_metadata` |
| 485 |
* added Position extension - it allows creating fixed or absolute blocks with custom offsets |
| 486 |
* added Lottie block |
| 487 |
* added Motion One script for animations. Great performance and native WAAPI support. We will use it for all future advanced blocks and extensions |
| 488 |
* changed jQuery animations to Motion One |
| 489 |
* remove ScrollReveal script, use Motion One instead |
| 490 |
* added support for Fonts in FSE themes. You can now select the specific font to load it in editor Typography settings and on frontend |
| 491 |
* added Lorem Ipsum format-command. Just type in editor `lorem15` and press `space` and it will generate a lorem ipsum text instantly |
| 492 |
* added reCaptcha score check for Form block |
| 493 |
* added filters for parse blocks and fallback custom styles render |
| 494 |
* added Honeypot protection to Form block |
| 495 |
* added column settings for paragraph |
| 496 |
* added option to change the Title tag in the Accordion block |
| 497 |
* added support for `layout-flow` inside InnerBlocks |
| 498 |
* added support for adding different blocks inside Changelog block |
| 499 |
* added Hover trigger for Tabs block |
| 500 |
* added vertical orientation, hover trigger, and labels to Image Compare block |
| 501 |
* added Fade Edges option to Carousel block |
| 502 |
* improved inserter in blocks with InnerBlocks |
| 503 |
* improved Form radio and checkbox editor ui |
| 504 |
* improved Form block alert colors |
| 505 |
* improved Color Picker component to use native UI |
| 506 |
* moved some extensions to Styles tab in inspector control |
| 507 |
* moved Templates menu item under Ghost Kit menu |
| 508 |
* fixed Typography font weights output |
| 509 |
* fixed custom styles render in Astra, Blocksy, and Page Builder Framework themes |
| 510 |
* fixed Pricing block not displaying items when block inserted in the editor |
| 511 |
* fixed Tabs block click on tab in editor |
| 512 |
* fixed conflict with dynamically generated styles with custom breakpoints and cached CSS |
| 513 |
* fixed Progress bar width calculation in editor |
| 514 |
* fixed styled lists reversed and start attributes rendering in editor |
| 515 |
* fixed infinite loop of Widgetized Area block if sidebar nested himself |
| 516 |
* changed Form gap to CSS `gap` |
| 517 |
* changed Form default input sizes for better support of standard themes |
| 518 |
* changed category of all Ghost Kit blocks. Moved Ghost Kit block category to the top of the blocks list |
| 519 |
* changed block icons and color |
| 520 |
* renamed Grid → Advanced Columns |
| 521 |
* removed sessions usage from Form block |
| 522 |
* removed grid column helpful buttons to select column or grid block. You can use blocks list view to select complex inner blocks <https://learn.wordpress.org/tutorial/how-to-use-the-list-view/> |
| 523 |
* removed fallbacks for old versions: |
| 524 |
* remove old icons fallback script, which converted span icons to svg |
| 525 |
* remove fallback for custom styles render from data attribute |
| 526 |
* remove InnerBlocks fallback for frontend of blocks: Button, Grid, Pricing Table |
| 527 |
* removed Reusable Blocks item from Admin Menu since WP v6.3 |
| 528 |
* deprecated Highlight text format, use core Highlight format instead |
| 529 |
* a lot of minor changes |
| 530 |
|
| 531 |
= 2.25.0 - Jan 4, 2023 = |
| 532 |
|
| 533 |
* added JS events `prepareCountersObserver` and `prepareVideoObserver` |
| 534 |
* improved Carousel displaying in editor (added slides per view and gap styles) |
| 535 |
* improved appender CSS in some blocks which uses InnerBlocks |
| 536 |
* fixed "Display" extension styles in editor |
| 537 |
* fixed TOC conflict with special characters in headings |
| 538 |
* fixed Form block appended overflow upper blocks |
| 539 |
* fixed wrong variable type usage warning |
| 540 |
* fixed Customizer Plugin displaying in Non Block Based themes |
| 541 |
* disabled Color Palette Plugin from the Block Based themes (custom colors can be added in Appearance → Editor → Styles → Colors → Palette) |
| 542 |
* minor changes |
| 543 |
|
| 544 |
= 2.24.1 - Sep 29, 2022 = |
| 545 |
|
| 546 |
* fixed custom Gap settings save number value instead of string |
| 547 |
* changed Tested up to in readme |
| 548 |
|
| 549 |
= 2.24.0 - Sep 24, 2022 = |
| 550 |
|
| 551 |
* added Vertical Gap support to Grid and Buttons blocks |
| 552 |
* added horizontal align option for top icon/number in the Icon and Number boxes |
| 553 |
* added usage of IntersectionObserver for Animate on Scroll and similar features |
| 554 |
* added aria-label for URL picker |
| 555 |
* updated Swiper script to v8.4.0 |
| 556 |
* changed Grid vertical gap from margins to CSS `row-gap` |
| 557 |
* changed Button gap from margins to CSS `gap` |
| 558 |
* changed Spacing control start from the Top input |
| 559 |
* changed RangeControl in all block settings to allow custom values. For example, allow specifying more than 12 columns in the grid |
| 560 |
* fixed Animate on Scroll hide elements even when JS is disabled in browser |
| 561 |
* fixed invalid date in editor Countdown block when block inserted |
| 562 |
* fixed Carousel block making duplicate slides even when Loop option is disabled |
| 563 |
* fixed Carousel block content inside duplicated slides. For example, Tabs block now working correctly inside slides and duplicated slides |
| 564 |
* fixed Images Compare block usage inside Carousel block |
| 565 |
* fixed Form block nonce field ID conflict with block ID |
| 566 |
* fixed Form block send error on some hosts |
| 567 |
* fixed easing function in the Progress block animation |
| 568 |
* fixed rest call permission check |
| 569 |
* minor changes |
| 570 |
|
| 571 |
= 2.23.2 - Jul 28, 2022 = |
| 572 |
|
| 573 |
* fixed Countdown block wrong date with UTC timezone settings |
| 574 |
* fixed Countdown block possible DatePicker error, when invalid date specified |
| 575 |
|
| 576 |
= 2.23.0 - Jul 27, 2022 = |
| 577 |
|
| 578 |
* ! Important - breaking change - changed `Auto` Grid Column to flex Auto width (depends on the content width). To restore previous behavior use `Grow` column size |
| 579 |
* added Grow size for Grid Columns |
| 580 |
* updated Google Fonts list |
| 581 |
* fixed custom styles rendering in FSE templates editor |
| 582 |
* fixed automatic heading anchor generation, as we needed it for Table of Contents block. Enabled standard `generateAnchors` setting in the editor by default |
| 583 |
* fixed Table of Contents preview in editor if some of headings does not contain anchors |
| 584 |
* fixed Countdown block dependency of the user's time zone. Now used timezone setting from the WordPress site |
| 585 |
* removed `will-change` styles usage |
| 586 |
|
| 587 |
= 2.22.3 - Feb 17, 2022 = |
| 588 |
|
| 589 |
* fixed Video block play action |
| 590 |
* removed blocks categories fallback used for WP < 5.5 |
| 591 |
* minor changes |
| 592 |
|
| 593 |
= 2.22.2 - Feb 14, 2022 = |
| 594 |
|
| 595 |
* improved method to enqueue block assets and custom styles in block themes (we no more need to parse content of the posts, we can make everything inside block render) |
| 596 |
* improved styles for nested panels in grid background settings |
| 597 |
* disable Plugin Customizer settings in block themes, as Customizer no more used there |
| 598 |
* fixed custom styles render in block themes Site Editor |
| 599 |
* fixed custom styles re-rendering in editor when interacting with editor elements (better performance) |
| 600 |
* fixed updating custom styles attributes on editor load |
| 601 |
|
| 602 |
= 2.22.0 - Feb 7, 2022 = |
| 603 |
|
| 604 |
* !important - dropped IE support |
| 605 |
* added support for WordPress 5.9 |
| 606 |
* added Animate on Scroll presets in Toolbar block settings |
| 607 |
* added possibility to remove link in URLPicker component (for example, in Button block) |
| 608 |
* added support for scrollBehavior in TOC links (used in modern themes) |
| 609 |
* added ToggleGroup control to use it instead of ButtonGroup (better UI) |
| 610 |
* disabled automatic heading anchor generation code in WordPress 5.9 and higher (as it is already generates by the Gutenberg) |
| 611 |
* rolled back ScrollReveal to older version, since latest one is not working properly when cleaning styles |
| 612 |
* fixed mail send headers |
| 613 |
* fixed Video block autoplay after loading when fullscreen already closed |
| 614 |
* a lot of minor changes |
| 615 |
|
| 616 |
= 2.21.0 - Dec 1, 2021 = |
| 617 |
|
| 618 |
* !important - removed support for deprecated blocks older than Ghost Kit v2.12. Make sure you re-saved all pages with old blocks versions. |
| 619 |
* added possibility to remove image in Image Compare block |
| 620 |
* added possibility to change Alt text in the Testimonial photo and Video poster |
| 621 |
* added encodes for Google Maps styles and AWB background images attributes |
| 622 |
* fixed usage of image tag in Video and Testimonial block (no more tag string in the attribute) |
| 623 |
* fixed encode/decode functions fails when no string given |
| 624 |
* fixed XML export problem when block styles use `--` characters |
| 625 |
* removed poster images from the Video block with "Icon Only" style selected |
| 626 |
|
| 627 |
= 2.20.3 - Nov 9, 2021 = |
| 628 |
|
| 629 |
* fixed crashing block with Custom CSS |
| 630 |
|
| 631 |
= 2.20.2 - Oct 25, 2021 = |
| 632 |
|
| 633 |
* added option "Pause autoplay on mouse over" to carousel block |
| 634 |
* fixed custom CSS compiler error |
| 635 |
* fixed Table of Contents block scroll to anchor JS error when using Chinese headings |
| 636 |
|
| 637 |
= 2.20.1 - Oct 17, 2021 = |
| 638 |
|
| 639 |
* fixed icon wrong escaping in the Icon List style |
| 640 |
|
| 641 |
= 2.20.0 - Oct 14, 2021 = |
| 642 |
|
| 643 |
* added escaping for SVG icons (fixes conflict with XML content import) |
| 644 |
* added support for WordPress's excerpt in some blocks |
| 645 |
* improved form reCaptcha code to work only when submit button clicked |
| 646 |
* changed minimum PHP to 7.2 |
| 647 |
* fixed block assets loading when block used in new block widgets screen |
| 648 |
* fixed conflict with PublishPress Blocks plugin |
| 649 |
|
| 650 |
= 2.19.4 - Sep 2, 2021 = |
| 651 |
|
| 652 |
* fixed errors in new Widgets editor |
| 653 |
|
| 654 |
= 2.19.3 - Aug 31, 2021 = |
| 655 |
|
| 656 |
* added line breaks for form email texts |
| 657 |
* added support for WP 5.8 |
| 658 |
* fixed rare conflict with reusable blocks while parsing |
| 659 |
* hidden Slides per view and Gap carousel options when selected Fade effect |
| 660 |
* hidden Carousel slides before JS init to prevent content jumping |
| 661 |
|
| 662 |
= 2.19.2 - May 6, 2021 = |
| 663 |
|
| 664 |
* fixed carousel block initial slides count in editor |
| 665 |
* fixed possible error with nested reusable blocks while parse page blocks |
| 666 |
|
| 667 |
= 2.19.1 - Apr 3, 2021 = |
| 668 |
|
| 669 |
* fixed warning a non-numeric value encountered conflict with Give plugin |
| 670 |
|
| 671 |
= 2.19.0 - Apr 1, 2021 = |
| 672 |
|
| 673 |
* added vendor prefixes to scss files (fixes unprefixed styles generated for custom breakpoints) |
| 674 |
* added dynamic styles for breakpoints generation in background (using CRON) |
| 675 |
* improved custom styles output in `<body>` - use JS to prevent w3c error |
| 676 |
* changed Twitter and Google Maps blocks usage of svg images as backgrounds (we need this to prevent possible errors in generated dynamic styles) |
| 677 |
* fixed some editor settings dropdown wrong widths |
| 678 |
* fixed block error when selecting Form Submit block |
| 679 |
* fixed dynamic styles for breakpoints generation if change plugin version |
| 680 |
|
| 681 |
Further changelog entries can be found in the [CHANGELOG.md](https://github.com/nk-crew/ghostkit/blob/master/CHANGELOG.md) file. |
| 682 |
|
