WP atomic content allows to create content blocks to use in posts, pages and custom post types.
- create a new block in the WordPress admin interface (in the block menu), write some contents and publish it
- copy the suggested shortcode
- in a page, post, or whatever, paste the shortcode where you want to see the block’s content
- you’re done
The shortcode, basically
This shortcode includes the content of the
my-block-name block in the page.
If the block is not found, nothing happens, no errors, no additional spaces. Nothing.
[block id="my-block-name" spacebefore="1em" spaceafter="30px" /]
It is possible to set space before and after the content with
spaceafter shortcode parameters.
Units are CSS compatible, so feel free to use
Custom CSS classes
[block id="my-block-name" class="my-class"]
class parameter, the CSS class is added to the block, in order to customize it.
It is possible to set many classes, with a space as separator.
You should note that two classes,
block-<id>, are added to every included blocks, without any customization.
Moreover, an identifier is added, to easily link the block with anchors (
The block editor is the same as the post editor. In other words, it is possible to format content (add paragraphs, titles, …).
It is also possible to add shortcodes, even to include blocks.
So you can make blocks composed of blocks, but be careful to not make cyclic references (
b which includes
You can include blocks from PHP code (i.e. in theme or plugin code), without shortcode.
The PHP functions, named
atomicContent works like the shortcode, with the same parameters.
string atomicContent($id, $classes = array(), $spaceBefore = null, $spaceAfter = null, $display = true)
true, the result is directly displayed. Otherwise it is returned as result of the function.
atomicContent("my-block-name", array("my-class"), "1em", "30px")
Use the WordPress administration interface, otherwise, you know what to do.
Contributors & Developers
“WP atomic content” is open source software. The following people have contributed to this plugin.Contributors
- The first version
- Class according to the block id added automatically
- Id according to the block id added automatically (for anchors)
- Incorrect version number in the PHP file
- Noob error v2: the PHP file was not commited…