Skip to main content

Installation

Installation takes two steps: install the package, then set up the theme. You can do the setup in the back end under Layout › Creuva or on the console with creuva:install – both lead to the same result.

1. Install the package

With the Contao Manager

Open the Contao Manager (www.your-domain.com/contao-manager.phar.php), search for creuva in the Discover tab, add the package pdir/creuva-theme-bundle and click Apply changes. Then update the database when the Contao Manager prompts you to.

With Composer

composer require pdir/creuva-theme-bundle
vendor/bin/contao-console contao:migrate

2. Set up the theme in the back end

Log in to the back end as an administrator and open Layout › Creuva. Under Set up you choose what should be created:

OptionResult
Import a demo websiteNew website root with all pages, content, news, images and forms of a demo
Create an empty site structureNew website root with start, contact, imprint, privacy, accessibility statement, sitemap and search pages
Use an existing websiteThe Creuva layout is assigned to the selected website roots, the content stays unchanged
Only create the themeCreate the theme, modules and page layout; you assign the layout yourself later

For a new website root you enter the title, language and optionally the domain. You need the domain if there already is a website root with the same language and no domain. Below each form you find the matching console command and, after running it, the output.

Note

If the page reports that the database is not up to date, update it first in the Contao Manager or with contao:migrate.

What gets created

  • the theme “Creuva” with the modules main navigation, header, footer – brand, footer navigations, copyright and bottom links
  • a page layout of type “Modern” with the template page/layout/creuva, with all modules assigned to their slots
  • the image size “Logo” (480 × 120 px, 2x density), if the theme does not have one yet
  • the CSS styles for the CSS Style Selector
  • the assignment of the layout to the website root

The theme detects the contact, imprint, privacy, accessibility, sitemap and search pages of an existing website by their alias (kontakt, impressum, datenschutz, barrierefreiheit, sitemap, suche …) and links them in the header button, the header search and the footer. Module names and texts follow the language of the website root (German or English).

2. Set up the theme on the console

# Existing website: the website root is queried or passed by ID
vendor/bin/contao-console creuva:install --root=1

# New website with basic pages
vendor/bin/contao-console creuva:install --with-pages --site-title="My Company" --dns=example.org

# Complete demo website with sample content, images, news and form
vendor/bin/contao-console creuva:install --demo
OptionDescription
--root=<ID>Website root that receives the Creuva layout (can be used multiple times)
--with-pagesCreate a new website root with basic pages (automatic if there is none yet)
--demo[=<name>]Create a new website root with a demo: standard (default), unternehmen, portfolio, sportverein or a folder such as files/my-demo
--site-title, --language, --dnsTitle, language (default de) and domain of the new website root
--schemeColor scheme, e.g. green (default), petrol, blue – see Color schemes
--variantColor mode: light (default), dark, auto (follows the system setting)
--typographymodern (default, Plus Jakarta Sans) or editorial (headings in Fraunces)
--theme-nameName of the theme (default “Creuva”), e.g. for a second variant
--replaceDelete the website with the same domain and language, including its theme, beforehand, see Reset content
--resetDelete all Contao content beforehand
--force, --no-backupWith --reset/--replace: without confirmation or without a database backup

Notes

Error message: This page isn’t working / The page redirected you too many times

Edit the website root and set the protocol under URL settings to http:// or https://, depending on how your site should be accessed.

Demo icons and downloads are missing

Run vendor/bin/contao-console contao:symlinks so that public/files/creuva-demo is created.

Search finds nothing

Build the search index once after the setup: System › Maintenance or contao:crawl.