Plugin Reference
Kitodo Plugin Reference
Common Settings
Fluid Template Configuration
As of Kitodo.Presentation 4.0 the Fluid rendering engine is used. The former marker templates for plugins are not supported anymore.
Now, all HTML markup is done in Fluid. To use different templates, you have to overload the templates by the common TYPO3 way.
The following TypoScript defines additional paths inside an "example" extension:
plugin.tx_dlf {
view {
templateRootPaths {
10 = EXT:example/Resources/Private/Plugins/Kitodo/Templates
}
partialRootPaths {
10 = EXT:example/Resources/Private/Plugins/Kitodo/Partials
}
}
}
In this example, you place the customized fluid template into this file:
EXT:example/Resources/Private/Plugins/Kitodo/Partials/Navigation/Main.html
Audio Player
The audioplayer plugin is only active if the selected document has valid audio file use groups (useGroupsAudio).
TypoScript Configuration
plugin.
Basket
plugin.
Calendar
The calendar plugin may be used with newspaper and ephemeras (periodical published media). The plugin shows itself an overview of all available years or all issues in a calendar view of a selected year.
You can't place the plugin together with the pageview plugin on one page. But you can use TypoScript conditions on this page to select the proper plugin e.g by setting some specific FLUID variables.
This is an example usage of the TypoScript condition ("getDocumentType"):
[getDocumentType({$plugin.tx_dlf.persistence.storagePid}) === 'ephemera' or getDocumentType({$plugin.tx_dlf.persistence.storagePid}) === 'newspaper']
page.10.variables {
isNewspaper = TEXT
isNewspaper.value = newspaper_anchor
}
[END]
[getDocumentType({$plugin.tx_dlf.persistence.storagePid}) === 'year']
page.10.variables {
isNewspaper = TEXT
isNewspaper.value = newspaper_year
}
[END]
[getDocumentType({$plugin.tx_dlf.persistence.storagePid}) === 'issue']
page.10.variables {
isNewspaper = TEXT
isNewspaper.value = newspaper_issue
}
[END]
The {$plugin. is a TypoScript constant holding the Kitodo.Presentation storage pid.
This way, the FLUID variable "isNewspaper" is set according to the given value. Inside the FLUID template it's possible to switch to the right plugin now.
plugin.
Collection
The collection plugin shows one collection, all collections or selected collections. It can be used to display the list of collections or the contents of a single collection. The plugin is configured in the TypoScript and in the FlexForm.
TypoScript Configuration
plugin.
FlexForm Configuration
Embedded 3D Viewer
The embedded3dviewer plugin renders an iFrame in which the configured 3D viewer displays the model.
plugin.
FlexForm Configuration
|
Property |
Data type |
Description |
|---|---|---|
|
document |
The URL of the XML document which contains the model. | |
|
model |
The URL of the 3D model. | |
|
viewer |
Override the default viewer from the extension configuration (see Configuration) with a supported viewer (from the "dlf_3d_viewers" directory). |
Feeds
The feeds plugin renders a RSS 2.0 feed of last updated documents of all or a specific collection.
The following steps are necessary to activate the plugin:
- Create a new page "Feed" with slug "feed".
- Create an extension template on this page and include the TypoScript template of the feeds plugin.
- Place the "Kitodo Feeds" plugin on it and configure it for your needs.
The TypoScript part is necessary to switch the page rendering to a different page object.
plugin.
List View
TypoScript Configuration
plugin.
FlexForm Configuration
Media Player
The MediaPlayer plugin is only active if the selected document has valid video file use groups (useGroupsVideo).
plugin.
Metadata
plugin.
OAI-PMH
TypoScript Configuration
plugin.
Page Grid
TypoScript Configuration
plugin.
Page View
TypoScript Configuration
plugin.
|
Property |
Data type |
Default |
Description |
|---|---|---|---|
|
excludeOther |
1 |
Show only documents from the selected page. | |
|
features |
| ||
|
elementId |
tx-dlf-map |
ID value of the HTML element for the document images. | |
|
progressElementId |
tx-dlf-page-progress |
ID value of the HTML element for the page progress bar. | |
|
crop | |||
|
useInternalProxy | |||
|
magnifier | |||
|
basketButton | |||
|
targetBasket |
|
Search
TypoScript Configuration
plugin.
FlexForm Configuration
|
Property |
Data type |
Default |
|---|---|---|
|
fulltext | ||
|
fulltextPreselect | ||
|
datesearch | ||
|
solrcore | ||
|
limit |
50000 | |
|
extendedSlotCount | ||
|
extendedFields | ||
|
searchIn | ||
|
collections |
| |
|
facets |
| |
|
limitFacets |
15 | |
|
resetFacets | ||
|
sortingFacets | ||
|
suggest |
1 | |
|
showSingleResult | ||
|
targetPid |
| |
|
targetPidPageView |
|
1 |
Statistics
TypoScript Configuration
plugin.
|
Property |
Data type |
Default |
|---|---|---|
|
collections |
| |
|
description |
Table Of Contents
Table of Contents plugin renders a table of contents for the current document. The table of contents is generated based on the structure of the document.
TypoScript Configuration
plugin.
|
Property |
Data type |
Default |
Description |
|---|---|---|---|
|
excludeOther |
1 |
Show only documents from the selected page. | |
|
basketButton | |||
|
showFull | |||
|
targetBasket |
| ||
|
targetPid |
| ||
|
titleReplacement |
|
} 1 { type = volume fields = type,volume } |
List containing types for which title should be replaced when the label is empty. The defined fields are used for replacement. |
Toolbox
Toolbox Plugin is a plugin which can be used to display a selection of tools for the current page. The available tools are configured in the TypoScript.
'tools' is a required property which must contain at least one of the supported tools. The plugin will only be rendered if at least one tool is configured and supported for the current page.
TypoScript Configuration
plugin.
|
Property |
Data type |
Default |
Values |
|---|---|---|---|
|
tools |
|
| |
|
solrCoreUid |
Tools
Audio Video Tool
This tool loads the Buttons for the Audiolabel-Image, Equalizer and Marker Table
plugin.
plugin.tx_dlf_audiovideotool {
settings {
tools = audiovideotool
}
}
Fulltext Tool
This plugin adds an activation link for fulltext to the toolbox. If no fulltext is available for the current page, a span-tag is rendered instead.
The default behavior is to show the fulltext after click on the toggle link. There is a TypoScript configuration to show the fulltext initially.
plugin.
|
Property |
Data type |
Default |
Values |
|---|---|---|---|
|
activateFullTextInitially |
0: show fulltext after click on toggle link 1: show fulltext on document load | ||
|
fullTextScrollElement |
html, body |
The fulltext is fetched and rendered by JavaScript into the <div id="tx- of the pageview plugin.
Please note: To allow JavaScript fetching the fulltext, the CORS headers must be configured appropriate on the providing webserver.
plugin.tx_dlf_fulltexttool {
settings {
tools = fulltexttool
activateFullTextInitially = 0
fullTextScrollElement = html, body
}
}
Model Download Tool
This tool makes it possible to extract the model URL from the METS file or use the provided model parameter to provide a download URL.
plugin.
plugin.tx_dlf_modeldownloadtool {
settings {
tools = modeldownloadtool
}
}
Score Tool
This tool extracts the score from the SCORE file group and visualizes the MEI score of current page using Verovio.
The provided MIDI output of Verovio is played using the html-midi-player
plugin.
|
Property |
Data type |
Values |
|---|---|---|
|
midiPlayerSoundFont |
|
plugin.tx_dlf_scoretool {
settings {
tools = scoretool
midiPlayerSoundFont = default
}
}
Search in Document Tool
This plugin adds a possibility to search all appearances of the phrase in currently displayed document.
plugin.
|
Property |
Data type |
Default |
Values |
|---|---|---|---|
|
searchUrl | |||
|
documentIdUrlSchema |
empty |
https://host.de/items/id/record - example value | |
|
idInputName |
tx_dlf[id] | ||
|
queryInputName |
tx_dlf[query] | ||
|
startInputName |
tx_dlf[start] | ||
|
pageInputName |
tx_dlf[page] | ||
|
highlightWordInputName |
tx_dlf[highlight_word] | ||
|
encryptedInputName |
tx_dlf[encrypted] |
plugin.tx_dlf_searchindocumenttool {
settings {
tools = searchindocumenttool
idInputName = tx_dlf[id]
pidInputName = tx_dlf[pid]
queryInputName = tx_dlf[query]
startInputName = tx_dlf[start]
pageInputName = tx_dlf[page]
highlightWordInputName = tx_dlf[highlight_word]
encryptedInputName = tx_dlf[encrypted]
}
}
Viewer Selection Tool
This tool can display a selection list of configured 3D viewers (from the "dlf_3d_viewers" directory see Setup) that support the current model.
The model URL is extracted from the METS file or taken from the provided model parameter. The extension of the model is extracted from this URL and compared with the supported model formats specified in the respective viewer configuration.
plugin.
plugin.tx_dlf_viewerselectiontool {
settings {
tools = viewerselectiontool
}
}
Validation Form
The plugin renders an input field where a METS URL can be entered. After submission, the document is loaded and validated against the DOMDocumentValidation Middleware. For the validation to work, a corresponding configuration (see Configuration) must be present in TypoScript, and the type of this configuration must be provided to the plugin as a required parameter.
plugin.
|
Property |
Data type |
Description |
|---|---|---|
|
type |
Validation configuration type for DOMDocument validation |