Direktiven
- Variablen-Benennungen und Kommentare immer in englisch
- Nicht benötigte Inhalte (HTML/CSS/JS) entfernen
- no_cache=1 wird nie genutzt (stattdessen Caching richtig nutzen/Caches per TCEMAIN.clearCacheCmd konfigurieren)
- JavaScript / CSS Includes immer per TypoScript einbinden
- Mit Sprachdateien arbeiten (siehe #Sprachdateien)
- Bei sämtlichen FluidPage und FluidTemplate Elementen darauf achten, dass die Sheets einen verständlichen Namen haben (der Default Wert "options" ist nicht wirklich schön)
- Templates/Layouts in Partials aufteilen, damit diese wiederverwendet werden können und damit TYPO3 die Partials cachen kann (Siehe Fluid Best Practices).
- Soweit möglich sämltliches TypoScript in die Extension auslagern
Sprachdateien
Sämtliche Labels für Page- und Content-Elemente in der Sprachdatei lokalisieren. Bei Webseiten, welche vorerst nur in deutsch geplant sind, kann in die locallang.xlf alles in deutsch gepflegt werden. Falls der Kunde dann später noch eine andere Sprache (in Frontend und Backend) haben möchte, dann kann man so einfach alle Labels in die gewünschte Sprache überführen, indem man die gesamte Sprachdatei lokalisiert (z.B. 1:1 kopie der locallang.xlf zu dk.locallang.xlf)
Sass-Dateien
In der Main Scss befinden sich alle notwendigen Breakpoints - nach dem mobile-first Ansatz
Post Installations Schritte
- Im TypoScript Template ausschließlich das TypoScript von h2template inkludieren
- Im Install Tool den Namen des Kunden setzen unter [SYS][sitename]
- Domain-Record auf Seiten ID 1 ändern auf die aktuell Domain
- Neues GIT Repository erstellen, remote branch hinzufügen und URL in README.md ändern
TypoScript Konstanten
Das Dummy Paket verfügt über folgende Konstanten (Pfad: plugin.tx_h2template.settings)
| Eigenschaft | Beschreibung |
|---|---|
| debug | Ist dieser Wert aktiv, dann ist unser HOCHZWEI Debugging aktiv und es wird z.B. der Bootstrap Size Debugger angezeigt |
| scriptmerger | Aktiviert den Scriptmerger |
| google.trackingID | Hier die Analytics ID Eintragen. Anonymize IP ist per Default aktiviert |
| google.siteVerification | Steuert den Meta Tag für die Webmaster Tools Site Verification |
| preview | Dieser Wert wird über den GET-Param "preview=1" gesetzt. Kann genutzt werden um Kunden Änderungen an Liveseiten vorab zu zeigen |
| includefavicons | Inkludiert die Favicons die über den RealFavIcon Generator erstellt wurden (s. Going Live Checkliste) |
| sourceopt.enable | Aktiviert die sourceOpt Extension |
TypoScript Variablen (Setup)
Das Dummy Paket verfügt über folgende Variablen die abhänigig vom Context gesetzt werden (Pfad: plugin.tx_h2template.settings)
| igenschaft | Beschreibung |
|---|---|
| devcon | Dieser Wert ist true wenn man als Admin im BE eingeloggt ist - kann genutzt werden um in Livesystem zu debuggen |
Google Sitemap
Eine Google Sitemap ist bereits durch die Extension seo_basics vorhanden und per RealURL Konfiguration integriert
Extensions mit eigenem TypoScript via ext_typoscript_setup.txt
Einige Extension (z.B. indexed_search oder felogin) bringen eigenes TypoScript mit, welches erst nach dem TypoScript vom h2template geladen wird. Dieses kann man leider nicht direkt über die TypoScipt settings im Configuration/ Ordner überschreiben. Sofern man das TypoScript z.B. von indexed_search überschreiben möchte, muss man für die h2template Extension die Datei ext_typoscript_setup.txt anlegen und dort die jeweiligen Änderungen vornehmen.
Beispiel ext_typoscript_setup.txt
<INCLUDE_TYPOSCRIPT: source="FILE:EXT:h2template/Configuration/TypoScript/Extensions/indexed_search.ts">Nach dem Going Live
- Wenn eine Seite basierend auf h2template auf dem Kundenserver verschoben wurde, arbeiten wir weiter mit Git zum Deployen der Template Änderungen
- Projekt aus GitLab auschecken
- Remote Server einrichten (mit Zugangsdaten von Kundenwebhosting)
- Deployment-Pfad setzen und vorher Änderungen einmal Dateien Remote abgleichen (Synchronize with deployed on...)