Overriding templates

EXT:academic_projects is using Fluid as template engine.

This documentation won't bring you all information about Fluid but only the most important things you need for using it. You can get more information in the section Fluid templates of the Sitepackage tutorial. A complete reference of Fluid ViewHelpers provided by TYPO3 can be found in the ViewHelper Reference

Change the templates using TypoScript constants

As any Extbase based extension, you can find the templates in the directory Resources/Private/.

If you want to change a template, copy the desired files to the directory where you store the templates.

We suggest that you use a sitepackage extension. Learn how to Create a sitepackage extension.

# TypoScript constants
plugin.tx_academicprojects {
    view {
        templateRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Templates/
        partialRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Partials/
        layoutRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Layouts/
    }
}

The image of a project

The project list item and the project page template render their image through the shared partial Academic/Image.html of EXT:academic_base, whose arguments and presets are documented in the Templates chapter of that extension.

Two consequences for an override:

Overriding Project/Item.html alone changes where the image sits, not how it is rendered. To change the markup, the breakpoints or the widths, place an Academic/Image.html of your own in the partial root path above.
The partial root path of EXT:academic_base is registered below the constant above, so the copy wins. A view of your own that renders Project/Item.html - a page object, for example - has to list that path itself, or the rendering fails on a partial it cannot resolve. Pick a key of your own rather than the one this extension uses, and list it under paths too if your page object is a PAGEVIEW, which reads no partialRootPaths:
```
# TypoScript setup
page.10 {
    partialRootPaths.-1700000001 = EXT:academic_base/Resources/Private/Partials/
    paths.-1700000001 = EXT:academic_base/Resources/Private/
}
```
Copied!

The project page

The page type Academic project renders through a page template of its own and five partials below Project/Page/. They are registered on the page object of the site, not through the constants above, and each of them can be replaced on its own, see The parts of a project page.