generateblocks
Last commit date
assets
1 year ago
dist
1 week ago
includes
1 week ago
plugin.php
1 week ago
readme.txt
1 week ago
readme.txt
340 lines
| 1 | === GenerateBlocks === |
| 2 | Contributors: edge22 |
| 3 | Donate link: https://generatepress.com |
| 4 | Tags: blocks, gutenberg, editor, page builder, posts |
| 5 | Requires at least: 6.7 |
| 6 | Tested up to: 7.0 |
| 7 | Requires PHP: 7.2 |
| 8 | Stable tag: 2.4.0 |
| 9 | License: GPLv2 or later |
| 10 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 | |
| 12 | A small collection of lightweight WordPress blocks that can accomplish nearly anything. |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | Add incredible versatility to your editor without bloating it with tons of one-dimensional blocks. With GenerateBlocks, you can learn a handful of blocks deeply and use them to build anything. |
| 17 | |
| 18 | [GenerateBlocks](https://generatepress.com/blocks?utm_source=wp-repo&utm_medium=link&utm_campaign=readme) works hand-in-hand with [GeneratePress](https://generatepress.com/theme?utm_source=wp-repo&utm_medium=link&utm_campaign=generateblocks-readme), but is built to work with any theme. |
| 19 | |
| 20 | Looking for more features? Check out [GenerateBlocks Pro](https://generatepress.com/blocks?utm_source=wp-repo&utm_medium=link&utm_campaign=readme). |
| 21 | |
| 22 | = Container = |
| 23 | |
| 24 | Organize your content into rows and sections. The Container block is the foundation of your content, allowing you to design unique sections for your content. |
| 25 | |
| 26 | = Grid = |
| 27 | |
| 28 | Create advanced layouts with flexible grids. The Grid block gives you the ability to create any kind of layout you can imagine. |
| 29 | |
| 30 | = Text = |
| 31 | |
| 32 | Craft text-rich content with advanced typography. Everything from headings to paragraphs - take full control of your text. |
| 33 | |
| 34 | = Button = |
| 35 | |
| 36 | Drive conversions with beautiful buttons. |
| 37 | |
| 38 | = Query = |
| 39 | |
| 40 | Build a list of posts from any post type using advanced query parameters. Query post meta and option fields in GenerateBlocks Pro. |
| 41 | |
| 42 | = Image = |
| 43 | |
| 44 | Add images to your content to make a visual statement. |
| 45 | |
| 46 | = Shape = |
| 47 | |
| 48 | Add custom SVG shapes to your pages with ease. |
| 49 | |
| 50 | = Dynamic Tags = |
| 51 | |
| 52 | Use our powerful dynamic tags to display dynamic content inside your blocks. |
| 53 | |
| 54 | * Post title |
| 55 | * Post excerpt |
| 56 | * Post permalink |
| 57 | * Post date |
| 58 | * Featured image |
| 59 | * Post meta |
| 60 | * Author meta |
| 61 | * Comment count |
| 62 | * Comments URL |
| 63 | * Author archives URL |
| 64 | * Author avatar URL |
| 65 | * Term list |
| 66 | * Previous posts URL |
| 67 | * Next posts URL |
| 68 | * Media |
| 69 | |
| 70 | In GenerateBlocks Pro, you get additional dynamic tags: |
| 71 | |
| 72 | * Archive title |
| 73 | * Archive description |
| 74 | * Site option |
| 75 | * Term meta |
| 76 | * User meta |
| 77 | * Current year |
| 78 | * Site title |
| 79 | * Site tagline |
| 80 | * Loop index number |
| 81 | * Loop item |
| 82 | |
| 83 | = Performance = |
| 84 | |
| 85 | We take performance seriously. Minimal CSS is generated only for the blocks you need, and our HTML structure is as simple as possible while allowing for maximum flexibility. |
| 86 | |
| 87 | = Coding standards = |
| 88 | |
| 89 | Built to the highest coding standards for security, stability and future compatibility. |
| 90 | |
| 91 | = Fully responsive = |
| 92 | |
| 93 | Style your blocks for different screen sizes. |
| 94 | |
| 95 | * Desktop: @media (min-width:1025px) |
| 96 | * Desktop & Tablet: @media (min-width:768px) |
| 97 | * Tablet: @media (max-width:1024px) and (min-width:768px) |
| 98 | * Tablet & Mobile: @media (max-width:1024px) |
| 99 | * Mobile: @media (max-width:767px) |
| 100 | |
| 101 | In GenerateBlocks Pro, you can create as many custom media queries as you need. |
| 102 | |
| 103 | = Documentation = |
| 104 | |
| 105 | Check out our [documentation](https://learn.generatepress.com/) for more information on the individual blocks and how to use them. |
| 106 | |
| 107 | == Installation == |
| 108 | |
| 109 | There's two ways to install GenerateBlocks. |
| 110 | |
| 111 | 1. Go to "Plugins > Add New" in your Dashboard and search for: GenerateBlocks |
| 112 | 2. Download the .zip from WordPress.org, and upload the folder to the `/wp-content/plugins/` directory via FTP. |
| 113 | |
| 114 | In most cases, #1 will work fine and is way easier. |
| 115 | |
| 116 | == Frequently Asked Questions == |
| 117 | |
| 118 | = How do I add your blocks to my page? = |
| 119 | |
| 120 | * Create a new page or post |
| 121 | * Add a new block, and look for the "GenerateBlocks" category |
| 122 | * Choose your block and start building. |
| 123 | * It's always best to start with a Container block. |
| 124 | |
| 125 | = What theme should I use? = |
| 126 | |
| 127 | GenerateBlocks was built to work hand-in-hand with [GeneratePress](https://generatepress.com). However, it will work with any theme you choose. |
| 128 | |
| 129 | == Changelog == |
| 130 | |
| 131 | = 2.4.0 = |
| 132 | * Security: Escape dynamic tag replacements inside HTML attributes |
| 133 | * Feature: Add block inspector slot support for the new Editor Access feature in GenerateBlocks Pro |
| 134 | * Feature: Add content-only and read-only support to our blocks |
| 135 | * Tweak: Users without dynamic data permissions can no longer add or save new dynamic data |
| 136 | * Tweak: Dynamic data no longer renders on pages last saved by a user without dynamic data permissions |
| 137 | * Tweak: Dynamic tags no longer resolve inside inline event handler attributes (onclick, onmouseover, etc.) |
| 138 | * Tweak: Add generateblocks_allow_dynamic_data_in_event_handlers filter |
| 139 | * Tweak: Add editor notices when a save disables or re-enables dynamic data |
| 140 | * Tweak: Improve permissions around dynamic data previews, metadata lookups, and query controls |
| 141 | * Tweak: Refresh the dashboard header design |
| 142 | * Tweak: Raise the minimum supported WordPress version to 6.7 |
| 143 | |
| 144 | = 2.3.0 = |
| 145 | * Security: Harden legacy dynamic URL output |
| 146 | * Feature: Add support for new Dev Tools feature in Pro |
| 147 | * Feature: Add support for direct CSS editing feature in Pro |
| 148 | * Feature: Add Set/Replace media block toolbar button |
| 149 | * Tweak: Improve Image block selection behavior in editor |
| 150 | * Tweak: Disable core Additional CSS field on GenerateBlocks blocks |
| 151 | * Tweak: Add generateblocks_enable_core_additional_css filter |
| 152 | |
| 153 | = 2.2.1 = |
| 154 | * Security: Improve dynamic tag replacement security in the editor |
| 155 | |
| 156 | = 2.2.0 = |
| 157 | * Security: Improve REST endpoint access control |
| 158 | * Security: Add dynamic tag validation middleware to stop unsafe meta references during save |
| 159 | * Feature: Add `generateblocks.media.imageAttributes` filter to control Media block auto-populated attributes |
| 160 | * Feature: Add grid-auto-columns field to Styles Builder |
| 161 | * Feature: Add grid-auto-rows field to Styles Builder |
| 162 | * Feature: Add grid-template-areas field to Styles Builder |
| 163 | * Feature: Add grid-area field to Styles Builder |
| 164 | * Feature: Add text-wrap field to Styles Builder |
| 165 | * Feature: Add global CSS values (inherit, initial, revert, revert-layer, unset) to SelectControl components |
| 166 | * Fix: Editor sidebar header alignment |
| 167 | * Fix: Search controls input styles in WordPress 6.9 |
| 168 | * Fix: Undo behavior in editor when editing styles |
| 169 | * Fix: Unique ID regeneration when pasting a block before its original |
| 170 | * Fix: Block HTML attribute escaping in WordPress 6.9 |
| 171 | * Tweak: Show standard icons in all libraries |
| 172 | * Tweak: Show compound selector symbol in Styles Builder list |
| 173 | * Tweak: Enforce template selector sizing overrides |
| 174 | |
| 175 | = 2.1.2 = |
| 176 | * Security: Restricted options REST API endpoint access for contributors/editors |
| 177 | |
| 178 | = 2.1.1 = |
| 179 | * Security: Remove sensitive values from REST API response for logged in users |
| 180 | * Fix: Disable image links in the editor |
| 181 | * Fix: Parse shortcodes in URL HTML attribute fields |
| 182 | * Fix: Keep existing image size when changing image in block |
| 183 | * Tweak: Improve image size field loading UI |
| 184 | |
| 185 | = 2.1.0 = |
| 186 | * Feature: Enable full iframe editor |
| 187 | * Feature: Improve styles builder indicator dot system |
| 188 | * Feature: Add `static` value to the "Position" control |
| 189 | * Feature: Add `aria-label` field to all blocks |
| 190 | * Feature: Add `inline-grid` option |
| 191 | * Feature: Add inherited values as placeholders |
| 192 | * Fix: Missing "current parent" query parameter |
| 193 | * Fix: Fallback preview support in color picker |
| 194 | * Fix: Inability to type some units in the `UnitControl` |
| 195 | * Fix: Block/pattern preview styles |
| 196 | * Fix: IME issues with multi-select component |
| 197 | * Fix: Border sync button alignment in v1 blocks |
| 198 | * Fix: Single comment count option key in dynamic tags |
| 199 | * Fix: Custom at-rule switching in the editor |
| 200 | * Fix: Font family filter in the styles builder |
| 201 | * Fix: `UnitControl` values starting with a dash |
| 202 | * Fix: Image block selection in WP 6.8 |
| 203 | * Fix: Dynamic tag parsing all blocks in Container at once |
| 204 | * Fix: Allow 0 as nested post meta key |
| 205 | * Fix: Ensure block style assets load in wp_head |
| 206 | * Fix: Dimension control tab order |
| 207 | * Fix: Conditional loading of instant pagination script |
| 208 | * Tweak: Improve editor performance |
| 209 | * Tweak: Always show popular user meta fields in dropdown |
| 210 | * Tweak: Add support for device visibility feature in Pro |
| 211 | * Tweak: Add `generateblocks_use_v1_blocks` filter |
| 212 | * Tweak: Improve default styles builder selectors/shortcuts |
| 213 | * Tweak: Load permissions earlier in the editor |
| 214 | * Tweak: Improve block keywords |
| 215 | * Tweak: Sanitize block ID attribute value |
| 216 | * Tweak: Allow the `download` attribute to have a value |
| 217 | * Tweak: Add searching notice to styles builder |
| 218 | * Tweak: Add `generateblocks_block_css` filter |
| 219 | * Tweak: Add `generateblocks_process_block_css` action |
| 220 | * Tweak: Add default `alt` tag to images |
| 221 | |
| 222 | = 2.0.2 = |
| 223 | * Fix: Image block selection in WP 6.8 |
| 224 | |
| 225 | = 2.0.1 = |
| 226 | * Fix: WordPress.org zip package issue |
| 227 | |
| 228 | = 2.0.0 = |
| 229 | * Security: Prevent logged-in contributors from querying private post content |
| 230 | * New: All blocks re-written from scratch for better performance and control |
| 231 | * New: Version 1 blocks still exist where used and function normally |
| 232 | * New: Version 1 blocks can be enabled by default with simple filter |
| 233 | * New: Element block - replaces the Container and Grid blocks |
| 234 | * New: Element blocks comes with Container and Grid variations in the block inserter |
| 235 | * New: Text block - replaces the Headline and Button blocks |
| 236 | * New: Text blocks comes with Headline, Text, and Button variations in the block inserter |
| 237 | * New: Query block - replaces the Query Loop block |
| 238 | * New: Looper block - replaces the Grid block inside of the Query block |
| 239 | * New: Loop Item block - replaces the Post Template (Container) in the Query block |
| 240 | * New: No Results block - add content that displays if no Query results are found |
| 241 | * New: Page Numbers block - add page numbers for pagination in your Query block |
| 242 | * New: Shape block - add any SVG shape to your pages |
| 243 | * New: Media block - replaces the Image block |
| 244 | * New: Local blocks now have the full styles builder found in GB Pro Global Styles |
| 245 | * New: Local blocks can now be designed at any breakpoint or nested rule |
| 246 | * New: Filter block design options in the editor based on whether they have a value |
| 247 | * New: Filter block design options in the editor based on whether they're inheriting a value |
| 248 | * New: Dynamic tags system. Insert dynamic data anywhere in your blocks |
| 249 | * New: Multiple dynamic tags can be inserted into a single block |
| 250 | * New: --gb-container-width CSS variable for getting the global max-width |
| 251 | * Performance: Local blocks now generate their CSS and HTML as you build in the editor |
| 252 | * Performance: Blocks are output as static HTML/CSS on the frontend for better performance |
| 253 | |
| 254 | = 1.9.1 = |
| 255 | * Fix: Patterns not loading properly in Chrome |
| 256 | * Fix: Pattern search mixing up active libraries |
| 257 | * Fix: Broken pattern preview in bulk select mode |
| 258 | * Fix: Headline editor margin when set to div |
| 259 | * Tweak: Improve pattern preview loading performance |
| 260 | |
| 261 | = 1.9.0 = |
| 262 | * Security: Disallow scripts in custom field values |
| 263 | * Feature: New Pattern Library |
| 264 | * Feature: Add support for new Global Styles in Pro |
| 265 | * Feature: Added opt-in defaults cache filter: `generateblocks_use_block_defaults_cache` |
| 266 | * Feature: Added new `generateblocks_do_inline_styles` filter to force inline styles if needed |
| 267 | * Feature: Add styles indicators to local block controls if Global Styles exist |
| 268 | * Feature: Keep `p` tag when converting core paragraph block to Headline block |
| 269 | * Feature: Use arrow keys to increase or decrease values in unit control |
| 270 | * Fix: Button URL dropdown closing on input |
| 271 | * Fix: Undefined $fontFamily in old Headline version |
| 272 | * Fix: Missing block width alignment in block themes |
| 273 | * Tweak: Remove "one-time" block CSS and include it for specific blocks when needed |
| 274 | * Tweak: Added new `(min-width: 768px)` media query to filterable queries |
| 275 | * Tweak: Replace Twitter icon with X icon |
| 276 | * Tweak: Use core Block Name for block labelling |
| 277 | |
| 278 | = 1.8.3 = |
| 279 | * Security: Add user capability check to Query Loop post status |
| 280 | |
| 281 | = 1.8.2 = |
| 282 | * Fix: Border colors not showing when old attributes are set. |
| 283 | * Tweak: Add support for the newly created core function "wp_img_tag_add_loading_optimization_attrs" |
| 284 | |
| 285 | = 1.8.1 = |
| 286 | * Fix: Icon padding controls order |
| 287 | * Fix: Global styles overwriting local attributes |
| 288 | * Fix: Editor controls spacing using RTL languages |
| 289 | |
| 290 | = 1.8.0 = |
| 291 | * Feature: Add flexbox alignment matrix component to Container toolbar |
| 292 | * Feature: Add new Borders panel with width/style/color options for all four sides |
| 293 | * Feature: Add new dimensions components in Spacing panel |
| 294 | * Feature: Mix and match padding/margin units across sides and devices |
| 295 | * Feature: Add more available units to all options that accept them |
| 296 | * Feature: Allow text values (calc(), var(), etc...) in options that accept them |
| 297 | * Feature: New "Add to Container" icon added to the toolbar of all blocks |
| 298 | * Feature: Allow removal of Container block around innerBlocks |
| 299 | * Feature: Display text field to allow user to replace image URL |
| 300 | * Feature: Headline block show text in List View |
| 301 | * Feature: Button block show text in List View |
| 302 | * Feature: Image block show alt/title in List View |
| 303 | * Feature: Add Block Label option to label Container, Query Loop, and Grid blocks in List View |
| 304 | * Feature: Only show one dimension field if synced |
| 305 | * Feature: Add option to disable Google fonts |
| 306 | * Feature: Allow all unit types in UnitControl |
| 307 | * Feature: Add help icon to unit list |
| 308 | * Fix: Attributes merging incorrect values when multiple blocks are selected |
| 309 | * Fix: Color and Background panels are visible/accessible on responsive views |
| 310 | * Fix: Template lock system not applying to inner blocks |
| 311 | * Fix: Button with dynamic content not displaying the aria-label |
| 312 | * Fix: unique id not regenareted correctly on widgets editor |
| 313 | * Fix: React createRoot warning |
| 314 | * Fix: Double-click when selecting Grid template |
| 315 | * Fix: Query loop parameter delete button size |
| 316 | * Fix: Advanced select jumping when near the bottom of the page |
| 317 | * Fix: Triple captions using static image with dynamic link |
| 318 | * Fix: Flex icons based on direction in device previews |
| 319 | * Fix: Container appender icon spacing |
| 320 | * Fix: useDeviceType state was one state behind when triggered from core buttons |
| 321 | * Fix: Use unit in UnitControl if value starts with decimal |
| 322 | * Fix: Remove trailing spaces from UnitControl numeric value |
| 323 | * Tweak: Require at least PHP 7.2 |
| 324 | * Tweak: Move block alignment to Layout panel |
| 325 | * Tweak: Remove help text from Grid vertical alignment |
| 326 | * Tweak: Remove the Button Container variation |
| 327 | * Tweak: Clean up UnitControl display across all browsers |
| 328 | * Tweak: Show all Google fonts in font family dropdown |
| 329 | * Tweak: Remove top/bottom margin from Query Loop in the editor |
| 330 | * Tweak: Force lowercase units in UnitControl |
| 331 | * Tweak: Improve UnitControl unit visibility |
| 332 | * Tweak: Show units in 2 rows |
| 333 | * Tweak: Use same unit list for all UnitControl controls |
| 334 | * Dev: Rebuild how block migrations run |
| 335 | * Dev: Migrate spacing attributes to new spacing object attribute |
| 336 | * Dev: Migrate typography attributes to new typography object attribute |
| 337 | * Dev: Migrate icon padding and size attributes to new iconStyles object attribute |
| 338 | |
| 339 | Full changelog can be found [here](https://generateblocks.com/category/changelog/). |
| 340 |