phile/render

Render the content of a page by passing it's URL.

phileRender

Render the content of a page by passing it's URL., _(*1)

This plugin requires that you use Twig for your template engine, _(*2)

1.1 Installation (composer)

php composer.phar require phile/render:*

1.2 Installation (Download)

• Install Phile
• Clone this repo into plugins/phile/render

2. Activation

After you have installed the plugin. You need to add the following line to your config.php file:, _(*3)

$config['plugins']['phile\\render'] = array('active' => true);

Usage

There will now be a new twig function called render. It takes a URL to a page, and renders the HTML for it!, _(*4)

Basic Examples:

The path is the same as the way we load pages via URLs., _(*5)

Let's say we have a page at content/special.md, then we will use:, _(*6)

{{ render('special') }}

This will render the HTML of the special page., _(*7)

Let's say we have a page at content/sub/special-nested.md, then we will use:, _(*8)

{{ render('sub/special-nested') }}

This will render the HTML of the sub/special-nested page., _(*9)

Conditional Examples

In the config file you can set conditionals so you don't load a page that may not be setup for loading in this way., _(*10)

return array(
  'conditional_checks' => array(
    'template' => 'partial',
    'role' => 'custom'
  )
);

This conditional means: only load pages that have a template of 'partial' and a role that is 'custom'. We can use any custom meta for the conditionals. We can also use multiple key => values for checking as you can see from the example., _(*11)

Errors

This plugin will fail silently if no page is found, or the conditional is not met., _(*12)