Documentation

Reusable Content & Text Blocks WordPress Plugin

Content Processing & PARA Parameter 2017-11-24T10:23:28+00:00

Content Processing & PARA Parameter

WordPress does a few things before the content from a page or post gets displayed on your site. For instance, it processes HTML paragraph (p) tags, it runs shortcodes and even sends the content to the theme and any plugins so they can do their thing to the content and include their bits.

The plugin gives you versatile control over these processes when a block is called from within a page or post … you can:

  • Include or suppress paragraph tags inside the content block when, for instance, you want the text in the content block to show up as part of an existing line in your page/post
  • Run or suppress shortcodes inside the content block
  • Or do full content processing, which is essential for the correct operation of the page builders

Within shortcodes or PHP calls, you can do this through the PARA parameter, possible values for which are:

  • None specified (default) – Do not insert paragraph tags, but run shortcodes within the content block. Please note that when shortcodes within a content block are run, they themselves may have paragraph tags within them
  • “no-shortcodes” – Do not insert paragraph tags and do not run shortcodes. Please note that mark-ups set in the WordPress WYSIWYG editor (e.g. bold, underline, colours, headings, etc.) will still be shown
  • “paragraphs” – Insert paragraph tags and run shortcodes
  • “paragraphs-no-shortcodes” – Insert paragraph tags, but do not run shortcodes
  • “full” – Perform full WordPress content filtering

Notes:

  • While full content filtering is necessary to allow compatibility with visual page builders, other plugins (e.g. author information blocks, social sharing buttons, etc.) that are designed to insert content into posts and pages during this content filtering process will also kick into effect. The result is that these insertions end up being repeated more than once on a page or post with content blocks in them. If full content filtering is absolutely essential, but you do not wish the third party plugin to insert additional content, you may be able to suppress this from within that plugin’s settings. For example, StarBox, which inserts author information into posts and pages, has the option to “Hide Author Box from custom posts types”
  • For backward compatibility the plugin interprets the old para=”yes” option (or true in PHP) as para=”full”