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;
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¶
.env.local file in the project root directory to specify database
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
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.