Customize the current theme

Override a template per site (app way) or for every site (bundle way).

Contents

The Pushword App Way {id=app}

Create a file in ./templates/{$host}/page/ named like the default one — e.g. ./templates/{$host}/page/_navbar.html.twig replaces the navbar.

Example: this documentation’s templates.

The Bundle Way {id=symfony}

Every package is a Symfony bundle, so Symfony’s bundle override applies: copy the template under templates/bundles/. For page/page_default.html.twig:

./templates/bundles/PushwordCoreBundle/page/page_default.html.twig

Custom Error Page (404)

A page with the slug 404 is rendered for missing URLs. Without one, a generic template shows the translated errorTitle and errorDescription messages.

Static sites get one 404.html per locale. The generated server configs route by URL prefix: /fr/… serves /fr/404.html (a fr/.htaccess on Apache, a handle_errors matcher on Caddy), everything else the root 404.html. A fr/404 page, when it exists, is the one written there.

A 404 or <locale>/404 page is always noindex without canonical, whatever its robots field, and is left out of the sitemap, feeds, search index and pages_list(). At its own URL it answers HTTP 404 — in the app, the generated .htaccess/.Caddyfile, and cache mode, which never caches it.