PluginProbe
Content Blocks Builder – Create blocks, repeater blocks with carousel, grid, popup layouts / 2.8.4
Content Blocks Builder – Create blocks, repeater blocks with carousel, grid, popup layouts v2.8.4
2.8.14 2.8.13 2.8.12 2.7.5 2.7.6 2.7.7 2.7.8 2.7.9 2.8.0 2.8.1 2.8.10 2.8.11 2.8.2 2.8.3 2.8.4 2.8.5 2.8.6 2.8.7 2.8.8 2.8.9 trunk 1.0.1 1.0.2 1.1.0 1.1.1 All 147 releases
content-blocks-builder / readme.txt

readme.txt in Content Blocks Builder – Create blocks, repeater blocks with carousel, grid, popup layouts 2.8.4, at readme.txt

329 lines 21.1 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Content Blocks Builder - Create blocks, repeater blocks with carousel, grid, accordion, popup layouts ===
2 Contributors: Mr2P, freemius
3 Donate link: https://contentblocksbuilder.com?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=CBB+Donate
4 Tags: blocks, Gutenberg, carousel, grid, popup
5 Requires PHP: 7.4
6 Requires at least: 6.6
7 Tested up to: 6.8
8 Stable tag: 2.8.4
9 License: GPL-3.0
10 License URI: https://www.gnu.org/licenses/gpl-3.0.html
11
12 Group core blocks into containers or repeaters to create layouts like grid, carousel, popup, accordion — all in the Block Editor. Fast. Easy. Bloat-free.
13
14 == Description ==
15
16 Content Blocks Builder (CBB) helps you create **custom blocks**, **variations**, **styles**, and **patterns** — directly in the **Block Editor** without touching a **code editor**.
17
18 The WordPress Block Editor (Gutenberg) is a solid foundation for building websites. But when you need more specific layouts or custom functionality not available in default blocks, you're often forced to write custom code or rely on bloated third-party plugins.
19
20 CBB solves this by letting you visually group core or third-party blocks into flexible container blocks — right inside the native Block Editor. These container blocks support native features like typography, spacing, colors, borders, plus advanced features from CBB that help you build layouts like **responsive grid**, **slider/carousel**, **toggle/accordion**, **modal/off-canvas/popover**, **background effects** all without writing a single line of code.
21
22 You can also build repeater blocks to display repeatable content — similar to ACF repeater field type, but entirely block-based and visual.
23
24 [👉 Read the detailed guide to CBB blocks](https://contentblocksbuilder.com/documentation/custom-blocks/?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=CBB+Blocks).
25
26 The ultimate goal of CBB is to help you build complex layouts — all with core blocks, all visually, and fully compatible with any Gutenberg-ready theme.
27 **No React. No PHP. No lock-in. No clutter. No bloat. Developer-friendly.**
28
29 === Key technical features ===
30
31 - **Manage custom blocks**: Create, edit, copy, import, and delete custom blocks.
32 - **Create repeater blocks** that work similarly to ACF repeater fields. Supports carousel, grid, accordion and vertical stack layouts.
33 - **[[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)] Extenral CSS/JS and Custom CSS/JS**: You can enqueue external CSS or JavaScript files and write your own custom code directly for your blocks. This feature makes CBB feel a bit like **[CodePen.io](https://codepen.io)**—but for Gutenberg blocks. You can create anything you can imagine on the frontend.
34 - **Advanced block support features**: Modal, off-canvas, popover, toggle content, sticky, responsive dimensions, spacing, custom attributes, reveal animations, etc.
35 - **Manage block variations & block styles**: Create, edit, copy, import, and delete block variations. It works on any block. **[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)** enables you to input custom CSS for variations.
36 - **Manage block patterns**: Create, edit, copy, import, and delete custom block patterns.
37 - **Enhance the Query Loop block**: Add grid, carousel layouts, and advanced filter and sorting settings. Works with any post types.
38 - **Import/export** custom blocks, variations, and patterns from/to other sites
39 - **Pre-built library**: A library of pre-built blocks, variations, styles, and patterns. This library is not bundled with CBB; only items you import appear on your site.
40 - CBB are built with vanilla JS and CSS. It only depends on [SwiperJs](https://swiperjs.com/) for the carousel functionality, — and even then, the script and styles are loaded only if the carousel layout is used.
41
42 === Practical features you can build with CBB ===
43
44 - **Carousel layouts**: Ideal for creating banner slider, posts carousel, gallery, carousel of features or other repeating content, etc. CBB provides one of the best way to create a carousel layout in Gutenberg. Built on top of the popular SwiperJs carousel script, it supports extensive customization. **[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)** enables you to create entrance effects, advanced slide effects with effect builder, and further customization like slides per breakpoint, pagination, navigation, and synced carousels.
45 - **Responsive grid layouts**: Perfect for creating equal column grid, mosaic grid, bento grid, posts grid, grid of features or other repeating content, etc. CBB provides the easiest but most flexible and robost grid layout based on CSS Grid layout. You can customize template columns, grid gaps, size, and location for each grid item.
46 - **Accordion layouts**: Good for creating FAQ page, navigations, long features or specications.
47 - **Blog page design, magazine layout, post grid, post carousel**; Work with any post types.
48 - **Modal, off-canvas, popover, toggle content**: Great for creating popups, notification bars, toggle menu, toggle search box, hamburger menu, popover, show/hide content, etc. **[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)** allows you to add a custom entrance animation effect, delay to appear of the blocks, and save the closed state of blocks.
49 - **Sticky content**: Great for fixed/sticky header, footer, floating elements, sticky sidebar. **[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)** enables you to style blocks based on their stuck state and make blocks sticky only when scrolling up.
50 - **[[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)] Backgound effect**: Add parallax, infinite scrolling, and zooming effect to image easily. Perfect for hero section designs.
51 - **[[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)] Reveal animations**: Add stunning effects to blocks when they appear on the viewport the first time.
52 - **[[CBB Pro](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)] Custom layout & style**: With the ability to enqueue external JS/CSS and input custom JS/CSS, you can do anything with your blocks on frontend.
53
54 For dynamic data, we recommend using the **[Meta Field Block](https://metafieldblock.com)** plugin. It's the best way to display dynamic data.
55
56 === Why choose CBB? ===
57
58 - It's **fast**, **clean**, **flexible** and **code-free**. It **uses core blocks** to build container blocks.
59 - It's **bloat-free**. It doesn’t come bundled with a ton of specific-use blocks like other multiple-feature plugins.
60 - It's **easy to use**. It **adheres to Gutenberg** and maintain the primary user experience of Gutenberg, so anyone familiar with the Block Editor is already familiar with CBB.
61 - Sites built with CBB are **easier to maintain** as most tasks are accomplished through the Block Editor. You don't need to know React to create complex blocks or maintain a code repository for them. You can also import/export them from/to other sites.
62
63 === How does it help? ===
64
65 Below are some video tutorials that demonstrate how you can use this plugin to build your sites:
66
67 = Create a grid repeater block to display a grid of repeating content =
68
69 [youtube https://youtu.be/QKIPH5pmEWw]
70
71 = Create a banner slider for your site directly on the Editor =
72
73 [youtube https://youtu.be/EEk-kSa59VE]
74
75 = Create a custom blog page =
76
77 [youtube https://youtu.be/aHy3spQVBGc]
78
79 = Create a featured posts section =
80
81 [youtube https://youtu.be/paSXmpHU9K4]
82
83 = Create a glow-hover effect button variation =
84
85 [youtube https://youtu.be/rAWeQ2XLQJc]
86
87 === More video tutorials ===
88
89 = Create custom layouts =
90
91 CBB includes five built-in layout blocks: Advanced Group, Grid, Carousel, Stack and Accordion. You can use them or build your custom layout blocks easily.
92
93 Watch the video tutorial to create a simple responsive grid using the built-in Grid block.
94
95 [youtube https://www.youtube.com/watch?v=awSC09tTnS8]
96
97 [Create a similar layout by creating a custom grid block](https://youtu.be/mICLfKkF6tU).
98
99 Watch the video tutorial to create a banner slider using the built-in Carousel block.
100
101 [youtube https://www.youtube.com/watch?v=Eh3kX-9_mDg]
102
103 Watch the video tutorial to create a FAQ section using the built-in Accordion block.
104
105 [youtube https://www.youtube.com/watch?v=YA4-duNF_w4]
106
107 = Create popup, off-canvas, popover, and toggle content =
108
109 With the toggle content feature, you can build a popup, off-canvas, popover, and toggle content easily and you can put anything in there.
110
111 Watch the step-by-step video tutorial to create modal, off-canvas content.
112
113 [youtube https://youtu.be/y31TAKHZOD0]
114
115 [Create a responsive header with hamburger menu and search bar toggle](https://youtu.be/E4usfCydR7U).
116 [Create a notification bar](https://youtu.be/g_KOCqvU0Ps).
117 [Create a video popup](https://youtu.be/52jD9eeBJ78).
118 [Create a cookie popup](https://youtu.be/UEh_Da9Sozs).
119 [Create an off-canvas content](https://youtu.be/YnUt-zQXnCU).
120
121 = Enhance the Query Loop and other blocks =
122
123 CBB provides a bunch of advanced features to add style to custom blocks like responsive width, height, spacing, border, box-shadow, transform, alignments etc. And by wrapping around other blocks, you can add those features to other blocks as well.
124
125 How to build a magazine layout grid with just one Query Loop block
126
127 [youtube https://youtu.be/Q4LP68Dh_Pc]
128
129 [Create a banner slider using the Query Loop block](https://youtu.be/bcK_k3IfW8g).
130 [Create a carousel of posts using the Query Loop block](https://www.youtube.com/watch?v=i8d8Pha921c).
131 [Create a blog layout with overlay style using the Query Loop block](https://youtu.be/YQHrf4xFctg).
132
133 = Create block variations, block styles, and block patterns =
134
135 CBB helps you create custom variations, styles, and patterns directly in the Block Editor without using a code editor.
136
137 [Create variations and styles for the core image block](https://youtu.be/BAY8_evbyL0).
138 [Create variations for any block](https://youtu.be/caiY-YZT7ZY).
139 [Create patterns](https://youtu.be/gfSNwcAb-xc).
140
141 = Google Fonts =
142
143 This feature does a really simple job, it loads a font for headings text and another for the body text from more than 1000+ Google Fonts easily with a few clicks. If you are worried about GDPR compliance, there is an option to load fonts from [Bunny Fonts](https://fonts.bunny.net/) instead of [Google Fonts](https://fonts.google.com/).
144
145 [How to use Google Fonts and be GDPR compliant](https://www.youtube.com/watch?v=rhd4SEKUcHU).
146
147 === Which theme should I use with this plugin? ===
148 It is compatible with all Gutenberg-ready themes, but our recommended themes are default themes such as [Twenty Twenty Four](https://wordpress.org/themes/twentytwentyfour/), [Twenty Twenty Five](https://wordpress.org/themes/twentytwentyfive/), [Twenty Twenty Three](https://wordpress.org/themes/twentytwentythree/), [Twenty Twenty Two](https://wordpress.org/themes/twentytwentytwo/), or [Astra](https://wordpress.org/themes/astra/) theme.
149
150 === How does it work with other blocks/plugins? ===
151 This plugin works with all third-party blocks but we recommend using single-block plugins for lightweight and performance. We also develop several single block plugins, that work great with this plugin, please see them in the below section.
152
153 === Design library ===
154
155 We have already included a library of block patterns for you to quickly use or customize to fit your design. There is a popup inserter in the block editor for you to find and insert patterns with a few clicks.
156
157 [How to use the pattern inserter popup](https://youtu.be/UTrZSBvkzj0).
158
159 Browse the **[Design Library](https://boldpatterns.net?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=CBB)** to see what the plugin can do for you.
160
161 === Block and Variation library ===
162
163 Besides the pattern library, we have built an external library of content blocks and common block variations. All of the blocks/variations in this library have been created by CBB directly in the Block Editor. With a few clicks, you can easily import blocks or variations into your site. You use them directly or customize or learn from them.
164
165 Watch some video tutorials to learn how to use the library:
166
167 [Import the particles background block](https://youtu.be/BVvImhhZma4).
168 [Import the basic header block](https://youtu.be/hQBItwIu_90).
169 [Import the Query Loop variations](https://youtu.be/UpN9bdvs7Rs).
170 [Import the arrow buttons](https://youtu.be/U-e6wbFGiYg).
171
172 === Learn CBB ===
173
174 Check out the documentation at [contentblocksbuilder.com](https://contentblocksbuilder.com/documentation?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=CBB).
175 [Watch all tutorials on Youtube](https://www.youtube.com/@boldblocks/videos).
176 We're still recording video tutorials, so please [subscribe to our YouTube channel](https://www.youtube.com/channel/UCB7Y3mlCEKHVM-RCZaTkR1g?sub_confirmation=1) to get a notification when new videos are released.
177
178 === Pro version ===
179
180 In short, the professional version adds following advanced features to your content such as:
181
182 - **Custom CSS**: Adjusts layout and style easily right in the inspector settings.
183 - **Premium background effects**: Includes parallax, infinite scrolling, and zooming effect to background image.
184 - **Premium carousel features**: Adds entrance animations, advanced effects, an effect builder, customized pagination, navigation, etc.
185 - **Premium toggle content features**: Enhancements for modal, off-canvas, and popover content with custom entrance animations, delay time, and closed state saving.
186 - **Premium sticky content features**: Detects stuck state and adds the ability to make blocks sticky only on scrolling up.
187 - **Enqueue external JS/CSS** and **add custom JS/CSS** to blocks.
188 - **Add custom CSS** to variations.
189 - **Reveal/entrance animations**: Adds stunning effects to blocks when they first appear in the viewport.
190
191 Watch more video tutorials to see how the Pro version can help you build advanced features for your sites:
192
193 [Create a sticky header](https://youtu.be/KEryi1y1UZ4).
194 [Create a custom block for the image zooming effect like Medium using an external script](https://youtu.be/WgHuo6jwyN8).
195 [Create a page title bar with a parallax background effect](https://youtu.be/0g1SLTq-lQ4).
196 [How to create an animated heading block](https://youtu.be/RfPPTg93WcQ).
197 [How to create a Back To Top block](https://youtu.be/0aTKpeTvgUY).
198 [How to create an image compare block](https://youtu.be/1tmIWXHv4gE).
199 [Create the infinite scrolling background effect](https://youtu.be/mBleA20caGo)
200 [Create the parallax background effect](https://youtu.be/nDpeQbpu50s)
201
202 **[Go premium](https://contentblocksbuilder.com/pro/?utm_source=wp.org&utm_campaign=CBB+Upgrade&utm_medium=link&utm_content=CBB)** to unlock advanced features with CBB Pro.
203
204 If this plugin is useful for you, please do a quick review and [rate it](https://wordpress.org/support/plugin/content-blocks-builder/reviews/#new-post) on WordPress.org to help us spread the word. I would very much appreciate it.
205
206 === Other plugins ===
207
208 Please check out my other plugins if you're interested:
209
210 - **[Meta Field Block](https://wordpress.org/plugins/display-a-meta-field-as-block)** - A block to display custom fields as blocks on the front end. It supports custom fields for posts, terms, users, and setting fields. It can also be used in the Query Loop block.
211 - **[SVG Block](https://wordpress.org/plugins/svg-block)** - A block to display SVG images as blocks. Useful for images, icons, dividers, and buttons. It allows you to upload SVG images and load them into the icon library.
212 - **[Icon separator](https://wordpress.org/plugins/icon-separator)** - A tiny block just like the core/separator block but with the ability to add an icon.
213 - **[Breadcrumb Block](https://wordpress.org/plugins/breadcrumb-block)** - A simple breadcrumb trail block that supports JSON-LD structured data and is compatible with WooCommerce.
214 - **[Block Enhancements](https://wordpress.org/plugins/block-enhancements)** - Adds practical features to blocks like icons, box shadows, transforms, etc.
215 - **[Counting Number Block](https://wordpress.org/plugins/counting-number-block)** - A block to display numbers with a counting effect
216 - **[Better YouTube Embed Block](https://wordpress.org/plugins/better-youtube-embed-block)** - A block to solve the performance issue with embedded YouTube videos. It can also embed multiple videos and playlists.
217
218 The plugin is developed using @wordpress/scripts.
219
220 == Installation ==
221
222 = How to install it from wordpress.org =
223
224 Please see the video tutorial to install it from your site dashboard:
225
226 [youtube https://www.youtube.com/watch?v=wMTN0WpapPw]
227
228 = How to install it manually =
229
230 1. Upload the plugin files to the `/wp-content/plugins/content-blocks-builder` directory, or install the plugin through the WordPress plugins screen directly.
231 1. Activate the plugin through the 'Plugins' screen in WordPress
232
233 == Frequently Asked Questions ==
234
235 = Why do you need this plugin? =
236
237 To change the way of creating sites with WordPress from the legacy Classic Editor to the new Gutenberg Block Editor.
238
239 = Who needs this plugin? =
240
241 This plugin is made for developers or designers but anyone familiar with the Block Editor can use it.
242
243 = Is there a built-in design library? =
244
245 Yes, there is a library of production-ready block patterns.
246
247 = Is this another block library? =
248
249 No. It's like a tool to create custom layouts for core or third-party blocks without coding. However, it provides five custom block types: Grid, Carousel, Stack, Accordion and Advanced group.
250 Besides the five above block types, we have built an external library of content blocks and common block variations. You can easily import and use them in the plugin.
251
252 = Which themes does it support? =
253
254 It is compatible with all block-based themes and some popular classic themes like Astra, but our recommended themes are default themes such as [Twenty Twenty Four](https://wordpress.org/themes/twentytwentyfour/), [Twenty Twenty Five](https://wordpress.org/themes/twentytwentyfive/), [Twenty Twenty-Three](https://wordpress.org/themes/twentytwentythree/), [Twenty Twenty-Two](https://wordpress.org/themes/twentytwentytwo/), and [Astra](https://wordpress.org/themes/astra/) theme. If you find it doesn't work with your theme, please let us know. We'll work on it.
255
256 = What happens if I see the "Unexpected or Invalid Content" error? =
257
258 **Gutenberg moves quickly.**
259 We always do our best to support deprecated features, but sometimes we have to prioritize performance and code quality instead.
260
261 If you see the error **Block contains unexpected or invalid content** after upgrading the plugin from an older version, don't worry, your content will still work as expected. Just click the **Attempt Recovery** button to update deprecated blocks to the latest version.
262
263 Learn more about this error: [Unexpected or Invalid Content](https://wordpress.org/documentation/article/block-error-unexpected-or-invalid-content/)
264
265 == Screenshots ==
266
267 1. Block list screen
268
269 2. Block edit screen
270
271 3. Register block: synced overrides, template lock, description, CSS class, block icon
272
273 4. Register block: extended supports, variations
274
275 5. Register block: parent, ancestor, allowed, transformable, hidden, hide on frontend, enable repeater, scripts, stylesheets
276
277 6. Register repeater block: layout, title, description, CSS class, block icon
278
279 7. Register repeater block: extended supports, variations, limit child blocks
280
281 8. Carousel layout settings
282
283 9. Grid layout settings
284
285 10. Accordion layout settings
286
287 11. Toggle content settings
288
289 12. Sticky content settings
290
291 13. Background settings
292
293 14. Block library
294
295 15. Variation list screen
296
297 16. Variation edit screen
298
299 17. Register variation
300
301 18. Variation library
302
303 19. Pattern inserter popup
304
305 20. General settings
306
307 21. Typography settings
308
309 22. Import export settings
310
311 23. Developer settings
312
313 == Upgrade Notice ==
314
315 == Changelog ==
316
317 = 2.8.4 =
318 *Release Date - 13 October 2025*
319
320 * Added – Support for grid-auto-rows in grid layouts
321 * Improved – Automatically selects the default variation for an item block when creating variations in a repeater block
322 * Improved – Disables unnecessary properties when entering a label custom attribute
323 * Added – Border and radius options for accordion item blocks
324 * Improved – Updated accordion settings UI for better usability
325 * Improved – Generates semantic ID values for accordion item blocks
326 * Improved – Added support for toggling collapse and modal using the Spacebar and Enter keys on unsupported trigger elements
327
328 [View all changelog](https://contentblocksbuilder.com/changelog?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=Changelog)
329