Skip to content

Installation Kitodo.Presentation mit DFG Viewer als Beispielanwendung

Stefan Weil edited this page Feb 3, 2024 · 12 revisions

Installationsanleitungen

  1. Grundinstallation und Systemvoraussetzungen
  2. Installation der Erweiterungen: (eine Option wählen)
    2a. Installation Kitodo.Presentation
    2b. Installation Kitodo.Presentation mit DFG Viewer als Beispielanwendung
    2c. Installation Kitodo.Presentation mit DFG Viewer und OCR-On-Demand als Beispielanwendung

Installation Kitodo.Presentation mit DFG Viewer als Beispielanwendung

Installation

Im Folgenden wird die Installation der TYPO3-Extension DFG-Viewer gezeigt.

cd /var/www/dfgviewer
composer config platform.php 7.4
composer require slub/dfgviewer
vendor/bin/typo3 extensionmanager:extension:install dlf
vendor/bin/typo3 extensionmanager:extension:install dfgviewer

Während der Installation werden drei Seiten erstellt: Die Stammseite, der Konfigurations-Ordner und die Hauptseite des Viewers. Nach einem reload sollte nun unter Web -> Page der Seitenbaum "DFG Viewer" mit der Seite "Viewer" vorhanden sein.

Übersicht

Konfigurationen

DFG Viewer config

Es müssen zwei Typo3 Konfigurationseinstellungen gesetzt werden. Diese kann man entweder über das Backend machen oder direkt in typo3conf/LocalConfiguration.php:

Weg 1: Backend Unter Admin Tools -> Settings -> Configure Installation-Wide Options werden alle Konfigurationen aufgelistet. Ganz oben lassen sich diese filtern.

  1. pageNotFoundOnCHashError: Den Haken entfernen
  2. requireCacheHashPresenceParameters: "tx_dlf[id], set[mets]" eintragen
  3. Änderungen durch den Button "Write configuration" schreiben

Weg 2: direkt Im Installationsverzeichnis (zb. '/var/www/dfgviewer/public/typo3conf') in die LocalConfiguration.php folgende Werte in die Struktur einfügen:

'FE' => [
  'cacheHash' => [
    'requireCacheHashPresenceParameters' => [
        'tx_dlf[id]',
        'set[mets]',
    ],
  ],
  'pageNotFoundOnCHashError' => false,
],

Wobei darauf geachtet werden muss, dass bereits vorhandene Schlüssel abgeändert werden müssen.

ID Fix

Als nächstes müssen die ID Konstanten des DFG-Viewers angepasst werden:

  1. Zunächst muss man die Uid der Seite herausfinden. Diese findet man unter: Web -> Template -> DFG Viewer -> Right-Click on Viewer -> Info
  2. Die Uid muss man sich nun kopieren bzw. merken.
  3. Nun muss man in die Einstellungen für den DFG-Viewer. Diese findet man unter: DFG Viewer -> Constant Editor (im Drop-Down-Menü (links/mittig) auswählbar) -> Category: PLUGIN.TX_DFGVIEWER
  4. Unter der Einstellung config.kitodoPageView muss nun in dem vorgesehenen Feld die Uid eingetragen werden.

Weitere Information und Beispiele kann man hier anschauen.

Test

Der Aufruf folgender Seite http://localhost/index.php?id=2&tx_dlf%5Bpage%5D=1&tx_dlf%5Bdouble%5D=0&tx_dlf%5Bid%5D=https%3A%2F%2Fdigital.slub-dresden.de%2Foai%2F%3Fverb%3DGetRecord%26metadataPrefix%3Dmets%26identifier%3Doai%3Ade%3Aslub-dresden%3Adb%3Aid-263566811&tx_dlf%5Bpagegrid%5D=1&cHash=3deb716062d5ea61c9640e5c5c5711dd sollte die Übersicht eines Digitalisates der SLUB Dresden öffnen. (Gegebenenfalls muss die id im Link angepasst werden und auf die Uid des Viewers gesetzt werden.)

Vorschau

DFGviewer-orig https://user-images.githubusercontent.com/43964592/172356713-e8ac9f6b-cf4a-4343-ac43-cdae76f86a8b.mp4