Skip to content

Commit 9d8ed7d

Browse files
authored
[FEATURE] Create a Site Configuration (#9)
1 parent e0c1425 commit 9d8ed7d

File tree

1 file changed

+48
-0
lines changed

1 file changed

+48
-0
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
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

Comments
 (0)