Issue Bug Closed

#109395theme_camino: Setup documentation missing required step: assign backend layout to pages

Alexander Hahn 03/27/26, 08:24 updated 03/31/26, 08:09

Description

The Setup documentation describes four steps to get the Camino theme running. However, it does not mention that every page must have a backend layout assigned before the frontend can render.

Without a backend layout there is a generic frontend error with no helpful hint for the user:

> Oops, an error occurred! Request: <id></id>

The actual exception buried in the log is:

> TYPO3Fluid\Fluid\Core\ViewHelper\InvalidArgumentValueException:
> The “contentArea” argument must be an instance of TYPO3\CMS\Core\Page\ContentArea

This is very hard to debug, especially for new users who follow the Setup guide step by step and then see a blank error page.

The Setup page should include a Step 5 (or a note after Step 4) along the lines of:

> *Assign a backend layout to your pages*
> Open each page’s Page Properties → Appearance → Backend Layout and select one of the three Camino layouts (e.g. “Camino: Content Page (Full-Width)”). Pages without a backend layout will not render in the frontend.

Reviews 1

History 48

  1. Garvin Hicking commented and changed status New Needs Feedback <span data-processor="relativetime" data-value="2026-03-27T16:44:02+00:00" > 03/27/26, 16:44 </span>

    I think the idea here is that people actually set “Backend Layout (subpages of this page)” alongside the “Backend Layout (this page only)”.

    To which specific piece in the docs do you refer to? What I see is:

    typo3/sysext/theme_camino/Documentation/BackendLayouts/Index.rst

    You can also specify the default backend layout used on newly created child pages
    by using :guilabel:`Backend Layout (subpages of this page)`

    I’ve now added a small section there.

  2. Gerrit Code Review pushed patch set 1 for main to change 93408 status Needs Feedback Under Review <span data-processor="relativetime" data-value="2026-03-27T16:45:50+00:00" > 03/27/26, 16:45 </span>

  3. Alexander Hahn commented <span data-processor="relativetime" data-value="2026-03-27T21:33:02+00:00" > 03/27/26, 21:33 </span>

    Garvin Hicking wrote in #note-1:
    > I think the idea here is that people actually set “Backend Layout (subpages of this page)” alongside the “Backend Layout (this page only)”.
    >
    > To which specific piece in the docs do you refer to? What I see is:
    >
    > typo3/sysext/theme_camino/Documentation/BackendLayouts/Index.rst
    > […]
    >
    > I’ve now added a small section there.

    Thanks for the addition, but my report referred to the Setup guide, not the BackendLayouts page. New users follow Setup step by step and never get there — could the note be added there as well?

  4. Garvin Hicking commented and changed status Under Review Resolved done 0 % 100 % <span data-processor="relativetime" data-value="2026-03-30T13:25:09+00:00" > 03/30/26, 13:25 </span>

    Applied in changeset commit:4893daed99e34904e79866489ca9497bc1a9f7d5.