Descrizione
WP atomic content allows to create content blocks to use in posts, pages and custom post types.
Getting started
- 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
[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")
Installazione
Use the WordPress administration interface, otherwise, you know what to do.
Recensioni
Contributi e sviluppo
“WP atomic content” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
CollaboratoriTraduci “WP atomic content” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.
Changelog (registro delle modifiche)
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…