getblocklab/block-lab
Stars: 415
Forks: 63
Pull Requests: 563
Issues: 274
Watchers: 18
Last Updated: 2021-03-31 01:32:46
A WordPress Admin interface and a simple templating system for building custom Gutenberg blocks.
License: GNU General Public License v2.0
Languages: Makefile, PHP, JavaScript, Shell, CSS, SCSS
Block Lab
Contributors: lukecarbis, ryankienstra, Stino11, rheinardkorf Tags: gutenberg, blocks, block editor, fields, template Requires at least: 5.0 Tested up to: 5.5 Requires PHP: 5.6 Stable tag: trunk License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl
The easy way to build custom blocks for Gutenberg.
Description
IMPORTANT!
The Block Lab team has moved to Genesis Custom Blocks. To take advantage of all the great things about Block Lab as well as gain access to all new features as they are released, we recommend that you install Genesis Custom Blocks.
If you’re an existing Block Lab user and would like to learn more about what this means for you, including how to easily and automatically migrate to the new plugin, you can find more details here.
Features
A Familiar Experience
Work within the WordPress admin with an interface you already know.
Block Fields
Add from a growing list of available fields to your custom blocks.
Simple Templating
Let the plugin do the heavy lifting so you can use familiar WordPress development practices to build block templates.
Developer Friendly Functions
Simple to use functions, ready to render and work with the values stored through your custom block fields.
Links
Installation
From Within WordPress
- Visit Plugins > Add New
- Search for "Block Lab"
- Install the Block Lab plugin
- Activate Block Lab from your Plugins page.
Manually
- Clone Block Lab into a working directory with
https://github.com/getblocklab/block-lab.git cdinto theblock-labdirectory, and runnpm install && composer install- Next, build the scripts and styles with
npm build - Move the
block-labfolder to your/wp-content/plugins/directory - Activate the Block Lab plugin through the Plugins menu in WordPress
Frequently Asked Questions
Q: Do I need to write code to use this plugin? A: Although the plugin handles the majority of the work in building a custom block, you will need to build HTML templates to display the content of the block. You can learn how in the developer documentation.
Q: I have an idea for the plugin A: This plugin is open source and can only be better through community contribution. The GitHub repo is here.
Q: Where can I find documentation for this plugin? A: Here
Contributing
OPEN ISSUES
See all- "Date" control type by @lukecarbis
- Improve plugin packaging scripts. by @rheinardkorf
- Add instructions on how to use template tags in a template by @lukecarbis
- "Video" control type by @jcklpe
- Feature Request: Nested block control type by @jcklpe
- Feature Request: Field Validation by @camya
- Editor Fields and Setting Fields should be separate. by @kopepasah
- Select control: Problem with spaces between "key : value" of choices by @camya
- Add option for field value to be stored as post meta by @cameronjonesweb
- Color Picker Pop-up persists when it shouldn't by @RobStino
- Placeholder/drag and drop text designer by @DonTimo
- “Icon” control type by @pagelab
- Textarea limit of 6,020ish characters by @lukecarbis
- Ability to set block alignment / sizing options by @lmartins
- Feature Request: Selected State as Preview by @DieTapete
- If Block Lab isn't available in your language, show a notice by @lukecarbis
- Convert to HTML doesn't work by @RobStino
- Field Conditions by @lukecarbis
- Block Conditions by @lukecarbis
- oEmbed field by @lukecarbis
- File upload field by @lukecarbis
- Menu field by @lukecarbis
- Colour palette field by @lukecarbis
- Provide filter to allow dynamic population of fields with option lists by @erickyle
- Add a default value option to fields that use fetchInput. by @lukecarbis
- Enhancement: License Number by @rochow
- Fields with duplicate slugs are removed by @lukecarbis
- Multisite support for Block Lab blocks by @rikkilake
- HTML input field type by @x5hwuk7nc6jsudcc
- Renaming a block's slug causes it to break in documents where it is already in use by @x5hwuk7nc6jsudcc
- Duplicate Block by @lukecarbis
- CTRL+Z (windows 10) on inputs/textareas undoes the document instead of the block's text field by @abillahbd
- Config constant for license key by @thefrosty
- Block template stub by @lukecarbis
- Continue with integration and unit tests by @kienstra
- WPML Compatibility by @lukecarbis
- Entering title into Post field doesn't find the correct post by @kienstra
- Block failing to render in editor by @BenHarris
- Feature Request: Media Download by @DavidMillington-CD
- Blade rendering engine for blocks by @guzart
- Blocks are not printed if the content of the post is returned through get_post_field by @abbraccialaabbraccialiabbracciati
- Refactor 'Edit Block' UI to use React by @kienstra
- Minimum repeater rows and checkboxes by @lukecarbis
- Re-ordering the classic fields inside a repeater doesn't work by @lukecarbis
- Group Control by @lukecarbis
- Heading & Description Controls by @lukecarbis
- Filter block_lab_icons broken block with wp 5.3 by @gfazioli
- Preview does not work when you have a lot of contents by @rohan2388
- Feature/Enhancement request: Decimal/Float support by @pcfreak30
- Question: version control by @wiwimaster
- Feature request: Extended formatting in rich text by @zaewin
- PHP performance profiling by @kienstra
- No warning on saving new block if mismatched types by @webstationhq
- Maybe consider alternative to deprecated DotTip by @kienstra
- Implement block specific scripts similar to stylesheets by @cameronjonesweb
- QA: Yes, I do "Want to see how it's done" by @JulieKuehl
- QA: URL Field Validation by @JulieKuehl
- block css not loading (wrong path) in roots bedrock environment (fix included) by @lemon3
- Can't reset Post field by @DavidMillington-CD
- Conflict with Popup Maker by @3s777