|
| 1 | +# Set Up a Site Configuration |
| 2 | + |
| 3 | +<!-- #TYPO3v13 #Beginner #Backend #Configuration @dragos_tuluc --> |
| 4 | + |
| 5 | +In TYPO3, a site configuration is essential for defining the domain, root page, and languages for a website. |
| 6 | + |
| 7 | +## Learning objective |
| 8 | + |
| 9 | +This guide explains how to create and configure a new site in a TYPO3 installation. |
| 10 | + |
| 11 | +## Prerequisites |
| 12 | + |
| 13 | +* A running TYPO3 instance. |
| 14 | +* A "root page" created in the page tree to serve as the starting point of the new website. |
| 15 | + |
| 16 | +## Navigate to the Sites Module |
| 17 | + |
| 18 | +1. Log in to your TYPO3 backend. |
| 19 | +2. In the main menu, go to **SITE MANAGEMENT > Sites**. |
| 20 | + |
| 21 | +## Create a New Site Configuration |
| 22 | + |
| 23 | +1. Click the **"Add new site configuration"** button or the `+` icon if you already have other sites. |
| 24 | +2. TYPO3 will often suggest creating a site based on an existing root page that is not yet configured. |
| 25 | +3. In the *General* tab, add your information to the following fields: |
| 26 | + * **Site Identifier:** A unique, lowercase name for the site (e.g., `my_website`). This is used internally by TYPO3. |
| 27 | + * **Root Page ID:** This is the most important setting. Select the page from your page tree that will be the root of your website (e.g., your "Home" page). |
| 28 | + * **Base URL:** The primary domain for the site, including the protocol (e.g., `https://www.example.com/`). |
| 29 | +4. In the Languages tab, click *Create new Language*. A new language form will appear. |
| 30 | +5. Fill in the following fields with your information: |
| 31 | + * **Title:** The human-readable name of the language (e.g., "English"). |
| 32 | + * **Entry Point:** The URL segment for this language. The default language should use `/`. Additional languages might use a prefix (e.g., `/de/`). |
| 33 | + * **Locale:** The locale for the language, which is important for date formatting and other localizations (e.g., `en_US.UTF-8`). |
| 34 | +6. In the **Error Handling** tab, fill in the following fields with your information: |
| 35 | + * Switch to the **Error Handling** tab. |
| 36 | + * Define how TYPO3 should handle HTTP error status codes, such as `404 Not Found`. |
| 37 | + * You can set a specific page to display, redirect to another URL, or use a custom Fluid template for each error code. |
| 38 | +7. Click the **Save** button to store your new site configuration. |
| 39 | + |
| 40 | +## Summary |
| 41 | + |
| 42 | +You have successfully created a site configuration. Your website is now accessible through the configured domain, and TYPO3 knows which page tree belongs to it. |
| 43 | + |
| 44 | +## Next Steps |
| 45 | + |
| 46 | +* **Add More Languages:** If your site is multilingual, you can add more languages in the *Languages* tab by repeating steps 4–5 above. |
| 47 | +* **Domain Variants:** Create variants for different domains or subdomains that point to the same site but might have slightly different settings. |
| 48 | +* **Static Routes:** For advanced URL routing, you can explore the *Static Routes* tab. |
0 commit comments