This plugin designed with extensibility in mind for data that should be associated with a particular block type but need not have any defined meaning.
Author: | MyPreview (profile at wordpress.org) |
WordPress version required: | 5.5 |
WordPress version tested: | 6.1 |
Plugin version: | 2.0.2 |
Added to WordPress repository: | 10-02-2020 |
Last updated: | 07-11-2022
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 100 |
Rated by: | 4 |
Plugin URI: | https://www.mypreview.one |
Total downloads: | 5 005 |
Active installs: | 400+ |
Click to start download
|
This plugin designed with extensibility in mind for data that should be associated with a particular block type but need not have any defined meaning. data-*
attributes will allow you to store extra information on different Gutenberg blocks, without other hacks such as non-standard attributes, appending properties on DOM, or modifying a block as HTML which will throw a block validation error when opening the post edit page once again.
Screenshots
Plugin Settings
FAQ
How do I create a custom data attribute?
- Log into your WordPress website and navigate to Dashboard.
- Create a new page, by visiting “Pages” » “Add New”.
- Click on the “Add Block” button and select the “Button” block. Alternatively, you can start typing
/button
in a new paragraph block, then press enter.
- Once you’ve inserted the block, you can use the block settings sidebar to add your custom data attribute.
- Clicking on the
⚙
cog icon next to the publish button will toggle the visibility of this sidebar.
- In the block sidebar, you can expand the
Block Data Attribute
section to add custom attributes as needed.
- Publish the page.
Which blocks are allowed to accept custom data attributes?
Currently, custom data attributes can be saved within the following blocks:
core/button
core/column
core/columns
core/heading
core/group
core/paragraph
Generally, this would be possible due to a JavaScript hooks system with WordPress that includes block filters and several other types of filters available via JavaScript.
You can extend the predefined list of block names by hooking into the mypreview.blockDataAttributeAllowedBlocks
filter provided by the plugin.
How do I get help with the plugin?
The easiest way to receive support is to “Create a new topic” by visiting Community Forums page here.
Make sure to check the “Notify me of follow-up replies via email” checkbox to receive notifications, as soon as a reply posted to your question or inquiry.
Please note that this is an opensource 100% volunteer project, and it’s not unusual to get reply days or even weeks later.
Can I help in translating this plugin into a new language?
The plugin is fully translation-ready and localized using the GNU framework, and translators are welcome to contribute to the plugin.
Here’s the the WordPress translation website →
How do I contribute to this plugin?
We welcome contributions in any form, and you can help reporting, testing, and detailing bugs.
Here’s the GitHub development repository →
Did you like the idea behind this plugin?
If you or your company use any of my projects or like what I’m doing, please consider making a donation so I can continue maintaining and evolving all my projects and new ones. I’m in this for the long run.
–AND/OR–
Please share your experience by leaving this plugin 5 shining stars if you like it, thanks!
ChangeLog
2.0.2
- Compatibility with WordPress 6.1
2.0.1
- Added missing
data
keyword from the attribute name.
2.0.0
- Define unlimited number of attributes.
- Compatibility with WordPress 6.0
- Updated node modules.
1.0.5
- Fixed incorrect escaping in data
value
attribute pair.
1.0.4
- Updated node modules.
- Compatibility with WordPress 5.5
1.0.3
- Multiple code standards improvements.
- Compatibility with WordPress 5.4.1
1.0.2
- Multiple code standards improvements.
- Compatibility with WordPress 5.4.0
1.0.1
- Fixed Github repo web-address.
- Updated plugin banner image.
1.0.0