This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP atomic content

Description

WP atomic content allows to create content blocks to use in posts, pages and custom post types.

Getting started

  1. create a new block in the WordPress admin interface (in the block menu), write some contents and publish it
  2. copy the suggested shortcode
  3. in a page, post, or whatever, paste the shortcode where you want to see the block’s content
  4. you’re done

The shortcode, basically

[block id="my-block-name"]

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.

Spaced content

[block id="my-block-name" spacebefore="1em" spaceafter="30px" /]

It is possible to set space before and after the content with spacebefore and spaceafter shortcode parameters.

Units are CSS compatible, so feel free to use px, em, rem, cm, …

Custom CSS classes

[block id="my-block-name" class="my-class"]

Adding the 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, atomic-content-block and block-<id>, are added to every included blocks, without any customization.

Moreover, an identifier is added, to easily link the block with anchors (id="<id>").

Block content

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 (a includes b which includes a).

PHP use

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.

The signature:

string atomicContent($id, $classes = array(), $spaceBefore = null, $spaceAfter = null, $display = true)

When $display is true, the result is directly displayed. Otherwise it is returned as result of the function.

Sample:

atomicContent("my-block-name", array("my-class"), "1em", "30px")

Installation

Use the WordPress administration interface, otherwise, you know what to do.

Reviews

Read all 1 review

Contributors & Developers

“WP atomic content” is open source software. The following people have contributed to this plugin.

Contributors

Translate “WP atomic content” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0

  • The first version

1.0.1

  • Class according to the block id added automatically
  • Id according to the block id added automatically (for anchors)

1.0.2

  • Incorrect version number in the PHP file

1.0.3

  • Noob error v2: the PHP file was not commited…