TYPO3Buddy
TYPO3Buddy is on FacebookTYPO3Buddy is on Twitter
menu

TYPO3 Basics: The website root page

The root page of your website is the page which contains all other pages. Reason for this is that the root page will contain configuration templates and other stuff that will apply to all other pages on the website. As TYPO3 will follow the page tree when displaying a page, it will always come across the root page and thus the configuration on it.

Why not use the "TYPO3Buddy" page? First of all, this isn't a page, because you can't put content on it. It's a container for the entire TYPO3 installation, as well as records such as backend users. Second, if you want to create a TYPO3 installation with multiple domains (yes, that's right, manage multiple websites from one TYPO3 backend!), you will need multiple root pages; one for each website. We won't cover that in this tutorial though.

Back to the root page of the TYPO3Buddy website; this is not a normal page, but a short cut to the home page, because the root page won't contain content that will be displayed on the website. The type of the root page will be set to "Short cut", and the short cut will be set to the "Home" page, by clicking the the map icon and choose the Home page as the short cut destination:

TYPO3 shortcut page - TYPO3Buddy website tutorial

Always save your changes by clicking one of the save icons (6.x) or the save button (7 and higher)!

Furthermore, you need to indicate that this page is the root page of your website by clicking the "Behaviour" tab and check the "Use as Root page" checkbox:

TYPO3 Enable use as root page - TYPO3Buddy website tutorial

Your root page is the base for the rest of the website and will contain configuration options and other stuff that will apply for the entire website.

You're also going to put some code in the Typoscript configuration box:

RTE.default {
  buttons.image.options.magic.maxWidth = 1920
  buttons.image.options.magic.maxHeight = 1080
  buttons.image.options.plain.maxWidth = 1920
  buttons.image.options.plain.maxHeight = 1080
}

By default, TYPO3 limits the image size of the images you can add to your website with the rich text editor (RTE). Why? We don't know. Probably a rudimentary thing, from times that bandwidth was expensive. This code overrides those limitations. Make sure you'll end up with the following:

TYPO3 General storage folder and page TSConfig - TYPO3Buddy website tutorial

Please note: the need for a general storage folder has been eliminated in recent TYPO3 versions! So you don't have to set a general storage folder. When you want to use Templavoila Plus though, you DO need to select a general storage folder! This is only possible after you've installed the Templavoila Plus extension and additional required extensions.

Save your changes.

Next you will add the main typoscript template to the root page ->

The TYPO3Buddy website is a tutorial to rebuild the TYPO3Buddy website from scratch. You can choose from a TYPO3 Fluid tutorial and a TYPO3 Templavoila tutorial. You'll build TYPO3 websites like you've done so for years!

Kind reminder! This tutorial has been tested with and updated for TYPO3 v10. Please keep in mind that the tutorial has once been set up for TYPO3 v6. It follows some deprecated conventions. If so, this will be mentioned in the tutorial.