Styleguide:Techn. Integration mit Template
Wichtige Hinweise
- Holen Sie sich die Templates bzw. Includes jede Stunde ab und cachen Sie lokal bei sich auf dem Server. Vermeiden Sie unbedingt bei jeden Aufruf die Dateien von unserem Server abzurufen.
- Bitte denken Sie daran, dass Sie für eine Subdomain immer ein SSL-Zertifikat für die verschlüsselte Übertragung von Daten bestellen müssen. Die Anzeige von Inhalten im Namensraums von berlin.de erfolgt immer verschlüsselt.
Grundsätzliche Template-Optionen
Aus jedem Landesauftritt kann ein Template in beliebiger URL-tiefe erzeugt werden. Bitte klären Sie vorher mit den entsprechenden Bereichen ab, welcher Auftritt und ggf. welcher Pfad verwendet werden soll. Der Pfad bestimmt, welcher Menüpunkt in der Navigation hervorgehoben bzw. aufgeklappt wird.
Beispiel:
- STD - Layout mit vollständiger "Hülle" (Top-Bereich der Institution, Navigation inkl. Breadcrumb und kompletter Footer, zusätzlich kann noch Notfallbox und Sidebar sichtbar sein): https://www.berlin.de/xx..xx/__i9/std/ bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/
An Stelle des Platzhalters <!-- Hier den Applikations-Content einfuegen --> <!-- CONTENT -->
kann der eigene Code eingefügt werden
- OHNE - Layout mit Top-Bereich der Institution, Navigation und komplettem Footer, aber ohne Breadcrumb und ggf. Notfallbox und Sidebar, somit ist mehr Platz für die Applikation verfügbar: https://www.berlin.de/xx..xx/__i9/ohne/ bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/ohne/
Welches Layout verwendet werden kann, muss mit der Landesredaktion abgestimmt werden.
Zusätzliche technische Möglichkeiten
Bei beiden Layout-Varianten können Sie sich auch nur 3 "Schnipsel" aufrufen, um sie direkt (z.b. via ESI) auf ihren Seiten einbinden zu können:
- HEAD https://www.berlin.de/xx..xx/__i9/std/head.inc = nur die Zeilen aus dem head-Bereich, bitte bei sich direkt vor dem schließenden "</head>" einfügen bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/head.inc
- TOP https://www.berlin.de/xx..xx/__i9/std/top.inc = der obere Bereich evtl. mit linker Navigation, bitte bei sich direkt nach dem sich öffnenden "<body>" einfügen bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/top.inc
- FOOT https://www.berlin.de/xx..xx/__i9/std/foot.inc = der untere Bereich (evtl. mit rechter Seitenspalte), bitte am Ende vor dem schließenden "</body>" einfügen bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/foot.inc
- Sondervariante nur Landesfooter https://www.berlin.de/xx..xx/__i9/std/landesfooter.inc = nur der dunkelgraue Landesfooter, bitte am Ende vor dem schließenden "</body>" einfügen, nicht gleichzeitig mit dem "foot.inc" verwenden bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/landesfooter.inc
- hier gibt es mit Parametern die Möglichkeit, das CSS und JavaScript nicht zu laden, folgende Parameter dazu an die Include-URL anhängen
- css=0 - für einen Aufruf ohne CSS
- js=0 - für einen Aufruf ohne JavaScript
- die Kombination beider Parameter ist ebenfalls möglich
- ohne Parameter sind CSS und JavaScript enthalten
- hier gibt es mit Parametern die Möglichkeit, das CSS und JavaScript nicht zu laden, folgende Parameter dazu an die Include-URL anhängen
Beispiel für eine ESI (https://varnish-cache.org/docs/6.0/users-guide/esi.html?highlight=esi) -Zeile:
<esi:include src="/rbmskzl/aktuelles/__i9/std/top.inc" onerror="continue" />
(in echte esi-Befehle kein http://www.berlin.de eintragen, sondern nur die halb-absolute URL)
Weitere Informationen dazu befinden sich auf der Seite Styleguide:Berlin.de_Subdomains.