官术网_书友最值得收藏!

Creating custom block templates

All blocks come with a default view template, view.php. concrete5 also supports alternative templates, which users can enable through the concrete5 interface. You can also enable these alternative templates through your custom PHP code.

Getting ready

You will need a block type created and installed already. In this recipe, we are going to add a template to the block type that we created at the beginning of the chapter.

How to do it...

The steps for creating custom block templates are as follows:

  1. Open your block's directory.
  2. Create a new directory in your block's directory called templates/.
  3. Create a file called no_title.php in templates/.
  4. Add the following HTML code to no_title.php:
    <div class="content">
      <?php echo $content ?>
    </div>
  5. Activate the template by visiting a page that contains this block.
  6. Enter edit mode on the page and click on the block.
    Click on "Custom Template".
  7. Choose "No Title" and save your changes.

There's more...

You can specify alternative templates right from the block controller, so you can automatically render a different template depending on certain settings, conditions, or just about anything you can think of. Simply use the render() function in a callback that gets called before the view is rendered.

public function view() {
  $this->render('templates/no_title');
}

This will use the no_title.php file instead of view.php to render the block. Notice that adding the .php file extension is not required. Just like the block's regular view.php file, developers can include view.css and view.js files in their template directories to have those files automatically included on the page.

See also

  • The Using block controller callback functions recipe
  • The Creating a custom block type recipe
主站蜘蛛池模板: 芒康县| 融水| 武夷山市| 江永县| 疏附县| 洮南市| 桐庐县| 平舆县| 弥勒县| 安塞县| 泽普县| 昌乐县| 彭泽县| 洞头县| 广灵县| 凉城县| 淮安市| 德惠市| 曲沃县| 兴海县| 古丈县| 张北县| 洛隆县| 武陟县| 瑞昌市| 富平县| 临城县| 华蓥市| 泗水县| 定西市| 平阴县| 定日县| 右玉县| 宾阳县| 乌拉特前旗| 新晃| 罗源县| 瓮安县| 开化县| 阿合奇县| 安图县|