Description
The goal of the block editor is to make adding rich content to WordPress simple and enjoyable.
Warning: This is beta software, do not run on production sites!
The new post and page building experience will make writing rich posts effortless, making it easy to do what today might take shortcodes, custom HTML, or “mystery meat” embed discovery.
WordPress already supports a large amount of “blocks”, but doesn’t surface them very well, nor does it give them much in the way of layout options. By embracing the blocky nature of rich post content, we will surface the blocks that already exist, as well as provide more advanced layout options for each of them. This will allow you to easily compose beautiful posts like this example.
Gutenberg is built by many contributors and volunteers. You can see the full list of contributors in the GitHub CONTRIBUTORS.md file which we are continuously updating. You can follow along on github.com/WordPress/gutenberg and on the #editor tag on the make.wordpress.org blog.
FAQ
- How can I send feedback or get help with a bug?
-
We’d love to hear your bug reports, feature suggestions and any other feedback! Please head over to the GitHub issues page to search for existing issues or open a new one. While we’ll try to triage issues reported here on the plugin forum, you’ll get a faster response (and reduce duplication of effort) by keeping everything centralized in the GitHub repository.
- How can I contribute?
-
The more the merrier! To get started, check out our guide for contributors.
Reviews
Don’t Rush It
Great work core team!
Why only 2 stars then? Well, like pretty much everything, it can take a fair few iterations to realise your original intentions.
I get that the future of the create/edit post screen is a WYSIWYG page builder (which will surely make the customiser completely redundant?) but it looks like it’s going to be tricky business for devs to add/edit blocks as needed, and the subsequent styling and functionality to go with it. If we’re going down the route of a WYSIWYG page builder then great, just bear in mind that every site looks and functions differently so it has be a breeze for devs to do what they need to do.
Saying to devs ‘go away and learn a whole new way of doing things, ooh, and you’ve got less than a year to do it’ is a bit unnecessary.
Although Gutenberg has the potential to revolutionise the adding and editing of posts, it’s a seismic departure from what we have atm, and imo, such a change, even if it is for the better, needs to be phased in, rather than slam-dunked.
Removed
Removed
This is a new era for WordPress
I’m writing plugin reviews very rarely but this time I feel strongly the need to support the Gutenberg developers and development.
Using WordPress since 1.x a lot changed in terms of usability for the “not techies” but the editing experience still su***. It’s quite hard to imagine the frontend output when editing articles in the Dashboard and I remember times when I recommended my users and clients to use Windows Live Writer to publish new content. Even the very powerful shortcodes are not best practice in usability as you can’t imagine what the output is (except you developed it). Then the overblown visual editors came up like Visual Composer. Not really a solution as they are totally blown with unnecessary blocks. But still the right direction.
Now I started to follow the idea of Gutenberg and all the discussions around that. And I see the minimalists who just want to stay with the TinyMCE as they are used to it and just want to write content without any fancy blocks in between. And yes I agree, there should be the option for those to stay with the current editor. But what I really can’t understand is the position which says “I don’t want it”, and “Matt decided to get block editors into core”. He did? Fantastic idea!!!
I just installed the beta of Gutenberg on a test WordPress environment and I’m really impressed how far this already is. Well done so far, congrats! It is really intuitive and easy to add the blocks, to change their settings, to rearrange them and I get a dozen of ideas which “blocks” I would love to develop. Also for frontend designers it is a big chance to realize content blocks which were just possible through the usage of shortcodes from which – as mentioned – none knows what the effect will be. After the oembed feature this is another big step into the right direction and I want to thank the developers for working on this. Especially because this might get a real “what you see is what you get” experience instead of the “imagine what you might get and edit again if it doesn’t fit your expectation”.
Gutes & innovatives Design!
Gutenberg hat ein echt sehr schönes und innovatives Design! Ich freu mich schon auf den Tag, an dem es standardmäßig in WordPress integriert sein wird! 🙂
destroys so much of what makes wordpress accessible
TinyMCE is so similar to other editors almost anyone can jump in and make changes.. now as developers we would have to provide instruction on how to use this new, gimicky & un-intuitive interface. I laughed at the thought.
Then I tried to paste in some content, as I’m almost certain a huge number of other WP users do.. I cried.
If this gets forced on WP userbase…..
Time for someone to start a fork to capitalize on Automattic WordPress’s almost inevitable fall from grace that we see beginning here.
WordPress, we have a problem.
This reminds me of what Adobe did a few months ago, giving Photoshop the worst UI possible for no reason, just for the sake of it. I can imagine how it went: “We have a perfectly working UI and few bugs, what do we do?”, “Who cares about bugs, let’s break the UI and turn a software for the pros into an app for selfie photographers!”.
I fear this is what is going to happen to Wp: turning a CMS-like platform that users and developers love into something “cool” for fashion bloggers.
Contributors & Developers
“Gutenberg” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Gutenberg” into your language.
Interested in development?
Browse the code or subscribe to the development log by RSS.
Changelog
0.5.0
- New tabs mode for the sidebar to switch between post settings and block inspector.
- Implement recent blocks display.
- Mobile implementation of block mover, settings, and delete actions.
- Search through all tabs on the inserter and hide tabs.
- New documentation app to serve all tutorials, faqs, docs, etc.
- Enable ability to add custom classes to blocks (via inspector).
- Add ability to drag-and-drop on image block placeholders to upload images.
- Add “table of contents” document outline for headings (with empty heading validation).
- Refactor tests to use Jest API.
- New block: Verse (intended for poetry, respecting whitespace).
- Avoid showing UI when typing and starting a new paragraph (text block).
- Display warning message when navigating away from the editor with unsaved changes.
- Use old editor as “freeform”.
- Improve PHP parser compatibility with different server configurations (“mbstring” extension and PCRE settings).
- Improve PostVisibility markup and accessibility.
- Add shortcuts to manage indents and levels in List block.
- Add alignment options to latest posts block.
- Add focus styles for quick tags buttons in text mode.
- Add way to report PHP parsing performance.
- Add labels and roles to UrlInput.
- Add ability to set custom placeholders for text and headings as attributes.
- Show error message when trashing action fails.
- Pass content to dynamic block render functions in PHP.
- Fix various z-index issues and clarify reasonings.
- Fix DropdownMenu arrows navigation and add missing aria-label.
- Update sandboxed iframe size calculations.
- Export inspector controls component under wp.blocks.
- Adjust Travis JS builds to improve task allocation.
- Fix warnings during tests.
- Fix caret jumping when switching formatting in Editable.
- Explicitly define prop-types as dependency.
- Update list of supported browsers for consistency with core.
0.4.0
- Initial FAQ (in progress).
- API for handling pasted content. (Aim is to have specific handling for converting Word, Markdown, Google Docs to native WordPress blocks.)
- Added support for linking to a url on image blocks.
- Navigation between blocks using arrow keys.
- Added alternate Table block with TinyMCE functionality for adding/removing rows/cells, etc. Retired previous one.
- Parse more/noteaser comment tokens from core.
- Re-engineer the approach for rendering embed frames.
- First pass at adding aria-labels to blocks list.
- Setting up Jest for better testing environment.
- Improve performance of server-side parsing.
- Update blocks documentation with latest API functions and clearer examples.
- Use fixed position for notices.
- Make inline mode the default for Editable.
- Add actions for plugins to register frontend and editor assets.
- Supress gallery settings sidebar on media library when editing gallery.
- Validate save and edit render when registering a block.
- Prevent media library modal from opening when loading placeholders.
- Update to sidebar design and behaviour on mobile.
- Improve font-size in inserter and latest posts block.
- Improve rendering of button block in the front end.
- Add aria-label to edit image button.
- Add aria-label to embed input url input.
- Use pointer cursor for tabs in inserter.
- Update design docs with regard to selected/unselected states.
- Improve generation of wp-block-* classes for consistency.
- Select first cell of table block when initializing.
- Fix wide and full alignment on the front-end when images have no caption.
- Fix initial state of freeform block.
- Fix ability to navigate to resource on link viewer.
- Fix clearing floats on inserter.
- Fix loading of images in library.
- Fix auto-focusing on table block being too agressive.
- Clean double reference to pegjs in dependencies.
- Include messages to ease debugging parser.
- Check for exact match for serialized content in parser tests.
- Add allow-presentation to fix issue with sandboxed iframe in Chrome.
- Declare use of classnames module consistently.
- Add translation to embed title.
- Add missing text domains and adjust PHPCS to warn about them.
- Added template for creating new issues including mentions of version number.
0.3.0
- Added framework for notices and implemented publishing and saving ones.
- Implemented tabs on the inserter.
- Added text and image quick inserts next to inserter icon at the end of the post.
- Generate front-end styles for core blocks and enqueue them.
- Include generated block classname in edit environment.
- Added “edit image” button to image and cover image blocks.
- Added option to visually crop images in galleries for nicer alignment.
- Added option to disable dimming the background in cover images.
- Added buffer for multi-select flows.
- Added option to display date and to configure number of posts in LatestPosts block.
- Added PHP parser based on PEG.js to unify grammars.
- Split block styles for display so they can be loaded on the theme.
- Auto-focusing for inserter search field.
- Added text formatting to CoverImage block.
- Added toggle option for fixed background in CoverImage.
- Switched to store attributes in unescaped JSON format within the comments.
- Added placeholder for all text blocks.
- Added placeholder text for headings, quotes, etc.
- Added BlockDescription component and applied it to several blocks.
- Implemented sandboxing iframe for embeds.
- Include alignment classes on embeds with wrappers.
- Changed the block name declaration for embeds to be “core-embed/name-of-embed”.
- Simplified and made more robust the rendering of embeds.
- Different fixes for quote blocks (parsing and transformations).
- Improve display of text within cover image.
- Fixed placeholder positioning in several blocks.
- Fixed parsing of HTML block.
- Fixed toolbar calculations on blocks without toolbars.
- Added heading alignments and levels to inspector.
- Added sticky post setting and toggle.
- Added focus styles to inserter search.
- Add design blueprints and principles to the storybook.
- Enhance FormTokenField with accessibility improvements.
- Load word-count module.
- Updated icons for trash button, and Custom HTML.
- Design tweaks for inserter, placeholders, and responsiveness.
- Improvements to sidebar headings and gallery margins.
- Allow deleting selected blocks with “delete” key.
- Return more than 10 categories/tags in post settings.
- Accessibility improvements with FormToggle.
- Fix media button in gallery placeholder.
- Fix sidebar breadcrumb.
- Fix for block-mover when blocks are floated.
- Fixed inserting Freeform block (now classic text).
- Fixed missing keys on inserter.
- Updated drop-cap class implementation.
- Showcasing full-width cover image in demo content.
- Copy fixes on demo content.
- Hide meta-boxes icons for screen readers.
- Handle null values in link attributes.
0.2.0
- Include “paste” as default plugin in Editable.
- Extract block alignment controls as a reusable component.
- Added button to delete a block.
- Added button to open block settings in the inspector.
- New block: Custom HTML (to write your own HTML and preview it).
- New block: Cover Image (with text over image support).
- Rename “Freeform” block to “Classic Text”.
- Added support for pages and custom post types.
- Improve display of “saving” label while saving.
- Drop usage of controls property in favor of components in render.
- Add ability to select all blocks with ctrl/command+A.
- Automatically generate wrapper class for styling blocks.
- Avoid triggering multi-select on right click.
- Improve target of post previewing.
- Use imports instead of accessing the wp global.
- Add block alignment and proper placeholders to pullquote block.
- Wait for wp.api before loading the editor. (Interim solution.)
- Adding several reusable inspector controls.
- Design improvements to floats, switcher, and headings.
- Add width classes on figure wrapper when using captions in images.
- Add image alt attributes.
- Added html generation for photo type embeds.
- Make sure plugin is run on WP 4.8.
- Update revisions button to only show when there are revisions.
- Parsing fixes on do_blocks.
- Avoid being keyboard trapped on editor content.
- Don’t show block toolbars when pressing modifier keys.
- Fix overlapping controls in Button block.
- Fix post-title line height.
- Fix parsing void blocks.
- Fix splitting inline Editable instances with shift+enter.
- Fix transformation between text and list, and quote and list.
- Fix saving new posts by making post-type mandatory.
- Render popovers above all elements.
- Improvements to block deletion using backspace.
- Changing the way block outlines are rendered on hover.
- Updated PHP parser to handle shorthand block syntax, and fix newlines.
- Ability to cancel adding a link from link menu.
0.1.0
- First release of the plugin.
