Install on a new Ibexa OSS project

Netgen provides an uptodate installation of Ibexa OSS with Netgen Layouts pre-installed. The installation is based on a clean Ibexa OSS install, ready to be used as a base for your new project.

This installation can later be used to upgrade to future versions of Ibexa OSS by following official Ibexa upgrade instructions.

Create a database

Create a database for your project with:

CREATE DATABASE my_project CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;

Use Composer

Install Composer and execute the following from a directory of your choice:

$ composer create-project netgen/layouts-ibexa-site my_project
$ cd my_project

Configure and install the database

Create a .env.local file in the project root directory to specify database connection details:

DATABASE_URL=mysql://user:pass@127.0.0.1/my_project

Run the following commands from the project root to install Ibexa OSS database together with Netgen Layouts database tables:

$ php bin/console ibexa:install
$ php bin/console doctrine:migrations:migrate --configuration=vendor/netgen/layouts-core/migrations/doctrine.yaml

Rendering block items

To render block items, Netgen Layouts by default uses Ibexa OSS view type called standard. For every content object that you wish to include in a Netgen Layouts block, you need to define the standard view type, e.g.:

ezplatform:
    system:
        site_group:
            content_view:
                standard:
                    article:
                        template: "@ezdesign/content/standard/article.html.twig"
                        match:
                            Identifier\ContentType: article

Start the app

You can use the web server included with Symfony CLI to serve the app:

$ symfony server:ca:install # For HTTPS support, only needs to be ran once
$ symfony server:start

After that, open https://127.0.0.1:8000 in your browser to run the app.

What next?

Read up on how to achieve various developer tasks in Netgen Layouts by visiting the Cookbook docs section.