Install on a new Contentful project¶
Netgen provides an uptodate installation of Contentful with Netgen Layouts pre-installed. The installation is based on a Symfony Website Skeleton, ready to be used as a base for your new project.
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-contentful-site my_project $ cd my_project
.env.local file in the project root directory to specify database
Install the database¶
Run the following commands from the project root to install Netgen Layouts database tables:
$ php bin/console doctrine:schema:update --force $ php bin/console doctrine:migrations:migrate --configuration=vendor/netgen/layouts-core/migrations/doctrine.yaml
If you are using Doctrine Migrations for other parts of your app and generate a new migration with
doctrine:migrations:diff console command, the generated migration will now include SQL commands that drop
Netgen Layouts tables. To prevent this from happening, you can add the following config to your Doctrine
configuration (if you already have
schema_filter config, update it accordingly):
doctrine: dbal: schema_filter: ~^(?!nglayouts_)~
Configure the app to use your Contentful instance by specifying
CONTENTFUL_ACCESS_TOKEN environment variables.
For development purposes, you can use a
.env.local file in the root of the
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.
Netgen Layouts admin interface is available at
https://127.0.0.1:8000/nglayouts/admin and you can use
admin as the
username and password to access it.
Read up on how to achieve various developer tasks in Netgen Layouts by visiting the Cookbook docs section.