Quick Start Guide

Introduction

In this Quick Start Guide we are going to create a basic contentpage.
This contentpage consists of a controller/action and a view.

First I recommend you to read the overview. This helps you to understand what we are doing here. Furthermore I recommend you to read the documents-page. This page explains you what we are doing here. Together with this Quick Start Guide you should be able to understand pimcore documents in general.

The first few steps will be done directly in the code. Only for the last steps we are logging into the backend.

Create a new controller/action

Create a new PHP file in the folder /website/controllers and name it to ContentController.php
Open the file an put the following content into it.

This is a basic setup of an action/controller. The method “enableLayout” registers Zend_Layout to decorate our contentpage. In the defaultAction we can put some custom code or assign values to the template.

<?php

class ContentController extends Pimcore_Controller_Action_Frontend {

    public function defaultAction () {                
        $this->enableLayout();
    }
}

Do not end the file with a "?>". This is not recommended by Zend. You will find in some documents here that this has been done, but I recommend against it.

Create the template

Now we can create the templates for our new contentpage.
Create a new folder in /website/view/scripts and name it like the controller (in this case “content”). Put a new PHP file into this folder and name it like our action (default.php).
Then we can put some template code into it, for example:

<?php $this->layout()->setLayout('standard'); ?>

<h1><?php echo $this->input("headline", array("width" => 540)); ?></h1>

<?php while ($this->block("contentblock")->loop()) { ?>
    <h2><?php echo $this->input("subline"); ?></h2>
    <?php echo $this->wysiwyg("content"); ?>
<?php } ?>

Add Layout

Pimcore uses the advantages of Zend_Layout out of the ZF, for details please read more here about it.

Because we have enabled the layout engine in our controller, we can use layouts to wrap our contentpage with another template which contains the main navigation, a sidebar, …

With this code:

 <?php $this->layout()->setLayout('standard'); ?>

We tell the engine that we want to use the layout standard. Now create a new php file in the folder /website/views/layouts and name it to standard.php (just like the name of the layout appending .php).

Then we can also put some HTML and template code into it:

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="/static/source/css/screen.css" />
</head>

<body>
<?php echo $this->layout()->content ?>
</body>
</html>

The code <?php echo $this->layout()->content ?> is the placeholder where your contentpage will be inserted.

Adding the layout/template to a page

Now we need to connect the template to a page. This will now be done in the pimcore-backend.

First click on the left under "Documents" at "home" and then select the tab "settings" in the newly opened window. You will then see something like this:

In controller and action you will have to write the name of the controller and the name of the action. After you have saved it you can test this new controller and action.

Testing it

After clicking on the edit tab you should see something like this:

which will look like this (in the frontend) when its filled with content:

Quick Start Guide

Introduction

Create a new controller/action

Create the template

Add Layout

Adding the layout/template to a page

Testing it

Labels

Comments (11)

Raffael Luthiger says:

Raffael Luthiger says:

Jeroen van Sluijs says:

Raffael Luthiger says:

koen Huybrechts says:

Raffael Luthiger says:

Michael Ender says:

Raffael Luthiger says:

Raffael Luthiger says:

Sandeep Narwal says:

Raffael Luthiger says: