Can I use the Context block in regular posts?
Yes, of course. For carefully crafted “longer-form” posts, however, you might want to consider adding microformats by hand.
Why don’t reposts, etc., use h-cite
?
We’re very much looking into block-based solutions that go beyond the current “Context” block, for “even richer” in-HTML metadata.
That said, the world of microformats is so vast that IndieBlocks will likely never support them all.
Meanwhile, it is possible to convert Context blocks to, e.g., Custom HTML blocks, and manually apply your own markup.
See also More Advanced Microformats.
How do I disable the default block template?
If you find yourself mostly writing “regular” notes, you can disable the default block template by adding the following code snippet to, e.g., your (child) theme’s functions.php
:
remove_action( 'init', array( '\\IndieBlocks\\Blocks', 'register_block_templates' ), 20 );
In order to manually add the default blocks to a new note, look for the “Note Starter Pattern” rather than just the Context block; this block pattern comes with some additional microformats.
How do I change notes’ permalinks?
In order to change the /notes/
part in note URLs—like we’ve done on this site!—add the following bit of code to, e.g., your site’s functions.php
:
add_action( 'register_post_type_args', function( $args, $post_type ) { if ( 'indieblocks_note' === $post_type ){ $args['rewrite']['slug'] = 'stream'; // The new slug. } return $args; }, 99, 2 );
How do I hide the “Facepile” icons?
Using custom CSS:
.wp-block-indieblocks-facepile-content .icon { display: none; }
The next version of the plugin will come with more user-friendly ways to style or hide these icons.
How do I disable outgoing webmentions?
Add define( 'OUTGOING_WEBMENTIONS', false );
to your site’s wp-config.php
.
Why do Webmention services wrongly interpret my notes?
Your block theme might not show the “right” blocks, and you may have to dive into WordPress’ Site Editor to add them to your theme’s “Single” template.
E.g., it makes sense to display short-form post types in full (i.e., show the post content rather than an excerpt), also on archive pages, and allow Webmention services to detect the microformats in these posts’ markup.
Some themes don’t show post author and date blocks on archive or even single post pages, either. Adding them will give micoformats parsers more info to work with.
A classic theme might not support microformats at all, or only support an outdated version. It could be the target endpoint isn’t able to interpret your (source) posts, or wrongly determines them to be “articles,” i.e., long-form posts, instead of notes (or replies, etc.).