perch_content_create()

By default, Perch creates a region automatically when it is first used. It can then be configured from within the web interface to pick a template and set its options. This is the primary way to work with Perch regions.

In some circumstances, it’s also useful to be able to programmatically create a region. An example would be if you intend to always display the region using perch_content_custom(), which itself will not create regions. For this, we have perch_content_create().

<?php perch_content_create('News', array(
    'template' => 'article.html',
    'multiple' => true,
    'edit-mode' => 'listdetail',
    'sort' => 'date',
    'sort-order' => 'DESC',
));
?>

If a region doesn’t yet exist, perch_content_create() will create it, and configure it with the options provided. If it does exist, it does nothing.

For this reason, you must create the region before it is used on the page. Practically, that means putting your perch_content_create() statements at the top of the page. Directly after the Perch runtime include would be a good place.

perch_content_create options