README

TYPO3-Extension für den Katalog des Deutschen Literaturarchivs Marbach https://www.dla-marbach.de/katalog

Installation

Einmalig nach Erstellen eines Codespaces aufrufen:

task install

Verbindung zum Solr

Lokal muss GitHub CLI gh installiert sein.

DLA Testsystem

Auf dem lokalen PC mit aktiver VPN-Verbindung:

SOLR="serene.dla-marbach.de"
gh codespace ssh -- -N -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18983:$SOLR:8983

Entwicklungssystem

1. Codespace mit Repo https://github.com/dla-marbach/dla-opac-transform starten und im Codespace task solr ausführen

2. Auf dem lokalen PC:

SOLR="127.0.0.1"
gh codespace ssh -- -N -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18983:$SOLR:8983

GUIs

Katalog: http://127.0.0.1/katalog

• Trefferliste: http://127.0.0.1/find
• Bestandsübersicht: http://127.0.0.1/bestandsuebersicht
• Thematischer Sucheinstieg: http://127.0.0.1/systematik

TYPO3 Backend: http://127.0.0.1/typo3

• admin
• Dla1337!

Tests

Alle Playwright-Tests für den Katalog ausführen:

task test -- "katalog/"

Einzelnen Test ausführen:

task test -- -g "robots"

Test zum Vergleich auf Produktivsystem ausführen:

BASE_URL=https://www.dla-marbach.de task test -- -g "robots"

Weitere Hinweise

Der Code der Extension ist über Symlinks eingebunden. Nach Änderungen am Code wie beispielsweise in Configuration/TypoScript/setup.ts ist also lediglich ein Löschen des TYPO3-Caches erforderlich:

task cache

Nach einem Neustart des Codespaces ausführen:

task reinstall

Nach Änderungen an der dla-find Extension muss ein neuer Release/Tag erstellt werden: https://github.com/dla-marbach/typo3-find/releases

Datenbankdump für TYPO3-Grundkonfiguration

Bei der Installation (task install) wird ein Datenbank-Dump .devfiles/init.sql eingespielt. Bei einer neuen TYPO3-Version muss dieser Dump ggf. manuell neu erstellt werden.

TYPO3-Grundkonfiguration ohne Datenbankdump

1. Menü Maintenance / Analyze Database Structure: Alle Vorschläge übernehmen (ggf. mehrmals)

2. Menü Page: Neue Seite auf DLA OPAC ziehen und Start nennen

• Start anklicken und "Create new content" auswählen
• Menu > Sitemap auswählen
• Speichern
• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Page: Neue Seite auf Start ziehen und Katalog nennen

• Start anklicken und "Create new content" auswählen
• Plugin TYPO3 Find auswählen
• Reiter Plugin im Pulldown "DlaStart" auswählen
• Speichern
• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Page: Neue Unterseite von Katalog und Find nennen

• find anklicken und "Create new content" auswählen
• Plugin TYPO3 Find auswählen
• Speichern
• Edit page properties > URL Segment /katalog entfernen
• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Page: Neue Unterseite von Katalog und Bestandsübersicht nennen

• Bestandsuebersicht anklicken und "Create new content" auswählen
• Plugin TYPO3 Find auswählen
• Reiter Plugin im Pulldown "DlaCollection" auswählen
• Speichern
• Edit page properties > URL Segment /katalog entfernen
• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Page: Neue Unterseite von Katalog und Systematik nennen

• Systematik anklicken und "Create new content" auswählen
• Plugin TYPO3 Find auswählen
• Reiter Plugin im Pulldown "DlaClassification" auswählen
• Speichern
• Edit page properties > URL Segment /katalog entfernen
• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Page: Neuen Ordner unterhalb von Katalog und Daten nennen

• Kontextmenü im Seitenbaum für diese Seite aufrufen und Enable auswählen

1. Menü Typoscript für Seite Start

• Oben im Pulldown "Edit Typoscript Record" aufrufen

• Create a root TypoScript record

• Edit the whole Typoscript record

• Reiter Advanced Options / Include TypoScript sets auswählen: Alle Fluid und Find Items

• Reiter General im Bereich Setup einfügen:

  page.5 > // Flux-Renderer überschreiben, sonst Ausgabe doppelt
  page = PAGE
  page {
    typeNum = 0
    includeCSS.site = EXT:dla_opac_ng/Resources/Public/CSS/site.min.css
    10 = FLUIDTEMPLATE
    10 {
      file = EXT:dla_opac_ng/Resources/Private/Templates/Page/Start.html
      section = Main
      layoutRootPaths.10 = EXT:dla_opac_ng/Resources/Private/Layouts/
      partialRootPaths.10 = EXT:dla_opac_ng/Resources/Private/Partials/
    }
  }
  

1. Menü Typoscript für Seite Katalog

• Create an additional TypoScript record

• Edit the whole Typoscript record

• Reiter Advanced Options / Include TypoScript sets auswählen: Alle Fluid und Find Items

• Reiter General im Bereich Setup einfügen:

  plugin.tx_find.settings.mainPageUid = 2
  plugin.tx_find.settings.indexPageUid = 3
  plugin.tx_find.settings.collectionUid = 4
  plugin.tx_find.settings.helpUid = 1
  plugin.tx_find.settings.orderlink = https://www.dla-marbach.de/cgi-bin/aDISCGI/kallias_prod/lib/ng-ausleihe.html?test=test
  
  # Browser-Zurück ermöglichen
  config.additionalHeaders {
      20.header = Cache-control: private, must-revalidate
  }
  

1. Menü Typoscript für Seite find

• Create an additional TypoScript record

• Setup auswählen und einfügen:

  # Trefferliste noindex,nofollow; Detailseite nur nofollow
  page.meta.robots = noindex, nofollow
  page.meta.robots.replace = 1
  [traverse(request.getQueryParams(), 'tx_find_find/action') == 'detail']
    page.meta.robots = nofollow
    page.meta.robots.replace = 1
  [END]
  
  # Links rel="canonical" und rel="alternate" deaktivieren
  config.disableCanonical = 1
  config.disableHrefLang = 1
  

Datenbankdump erstellen

1. TYPO3 Backoffice > Maintenance > Clear Persistent Database Tables (dabei "be_sessions" zuletzt)

2. init.sql ersetzen:

ddev export-db t3example --gzip=false > .devfiles/init.sql