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)!

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. For later use, you need to tell the root page where it can find the Storage folder of your website. Click on the "Resources" tab and set the General Record Storage Page to your Storage folder by clicking the folder icon. Please note that you can't set a general record storage folder in TYPO3 7, there's no option nor the need to set it elsewhere.

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 (and remember the need for a general storage folder has been eliminated in TYPO3 7):

TYPO3 General storage folder and page TSConfig - TYPO3Buddy website tutorial

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!