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
      }
   }
}
Copied!

In this example, you place the customized fluid template into this file:

EXT:example/Resources/Private/Plugins/Kitodo/Partials/Navigation/Main.html

Copied!

Audioplayer

The audioplayer plugin is only active if the selected document has a valid audio filegroup (fileGrpAudio).

Properties

plugin.tx_dlf_audioplayer.

Property

Data type

Default

excludeOther

boolean

1

elementId

string

tx-dlf-audio

excludeOther

Show only documents from the selected page.

elementId

ID value of the HTML element for the audio player.

Basket

plugin.tx_dlf_basket.

Property

Data type

Default

pregeneration

boolean

pdfgenerate

string

 

pdfdownload

string

 

pdfprint

string

 

pdfparams

string

##docId##,##startpage##,##endpage##,##startx##,##starty##,##endx##,##endy##,##rotation##

pdfparamseparator

string

*

basketGoToButton

boolean

targetBasket

t3tsref:data-type-page-id

 

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({$config.storagePid}) === 'ephemera' or getDocumentType({$config.storagePid}) === 'newspaper']
page.10.variables {
    isNewspaper = TEXT
    isNewspaper.value = newspaper_anchor
}
[END]

[getDocumentType({$config.storagePid}) === 'year']
page.10.variables {
    isNewspaper = TEXT
    isNewspaper.value = newspaper_year
}
[END]

[getDocumentType({$config.storagePid}) === 'issue']
page.10.variables {
    isNewspaper = TEXT
    isNewspaper.value = newspaper_issue
}
[END]
Copied!

The {$config.storagePid} 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.tx_dlf_calendar.

Property

Data type

Default

initialDocument

integer

 

showEmptyYears

boolean

showEmptyMonths

boolean

1

Collection

The collection plugin shows one collection, all collections or selected collections.

plugin.tx_dlf_collection.

Property

Data type

Default

Description

collections

t3tsref:data-type-list

 

show_userdefined

integer

 

dont_show_single

boolean

randomize

boolean

targetPid

t3tsref:data-type-page-id

 

targetFeed

t3tsref:data-type-page-id

 

Embedded 3D Viewer

The embedded3dviewer plugin renders an iFrame in which the configured 3D viewer displays the model.

plugin.tx_dlf_embedded3dviewer.

Property

Data type

Description

document

string

The URL of the XML document which contains the model.

model

string

The URL of the 3D model.

viewer

string

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:

a. Create a new page "Feed" with slug "feed". b. Create an extension template on this page and include the TypoScript template of the feeds plugin. c. 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.tx_dlf_feeds.

Property

Data type

Default

collections

t3tsref:data-type-list

 

excludeOtherCollections

boolean

library

integer

 

limit

integer

50

prependSuperiorTitle

boolean

targetPid

t3tsref:data-type-page-id

 

title

string

 

description

string

 

List View

plugin.tx_dlf_listview.

Property

Data type

Default

limit

integer

25

targetPid

t3tsref:data-type-page-id

 

getTitle

boolean

basketButton

boolean

targetBasket

t3tsref:data-type-page-id

 

Metadata

plugin.tx_dlf_metadata.

Property

Data type

Default

excludeOther

boolean

1

linkTitle

boolean

1

targetPid

t3tsref:data-type-page-id

 

getTitle

boolean

1

showFull

boolean

1

rootline

integer

separator

string

#

OAI-PMH

plugin.tx_dlf_oaipmh.

Property

Data type

Default

library

integer

 

limit

integer

5

expired

integer

1800

show_userdefined

boolean

stylesheet

resource

Page Grid

plugin.tx_dlf_pagegrid.

Property

Data type

Default

paginate.itemsPerPage

integer

24

placeholder

resource

Navigation.tmpl

targetPid

t3tsref:data-type-page-id

 

Page View

plugin.tx_dlf_pageview.

Property

Data type

Default

excludeOther

boolean

1

features

t3tsref:data-type-list

1

elementId

string

tx-dlf-map

progressElementId

string

tx-dlf-page-progress

crop

boolean

useInternalProxy

boolean

magnifier

boolean

basketButton

boolean

targetBasket

t3tsref:data-type-page-id

 

Statistics

plugin.tx_dlf_statistics.

Property

Data type

Default

collections

t3tsref:data-type-list

 

description

string

 

Table Of Contents

plugin.tx_dlf_tableofcontents.

Property

Data type

Default

Description

excludeOther

boolean

1

basketButton

boolean

targetBasket

t3tsref:data-type-page-id

 

targetPid

t3tsref:data-type-page-id

 

titleReplacement

t3tsref:data-type-list

 

List containing types for which title should be replaced when the label is empty. The defined fields are used for replacement. Example data: 0 { type = issue fields = type,year } 1 { type = volume fields = type,volume }

Toolbox

plugin.tx_dlf_toolbox.

Property

Data type

Default

Values

tools

t3tsref:data-type-list

 
  • tx_dlf_annotationtool
  • tx_dlf_fulltexttool
  • tx_dlf_imagedownloadtool
  • tx_dlf_imagemanipulationtool
  • tx_dlf_pdfdownloadtool
  • tx_dlf_fulltextdownloadtool
  • tx_dlf_searchindocumenttool

solrcore

integer

 

fileGrpsImageDownload

t3tsref:data-type-list

MIN,DEFAULT,MAX

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.tx_dlf_fulltexttool.

Property

Data type

Default

Values

activateFullTextInitially

boolean

0: show fulltext after click on toggle link

1: show fulltext on document load

fullTextScrollElement

string

html, body

The fulltext is fetched and rendered by JavaScript into the <div id="tx-dlf-fulltextselection"> of the pageview plugin.

Please note: To allow JavaScript fetching the fulltext, the CORS headers must be configured appropriate on the providing webserver.

Search in Document Tool

This plugin adds an possibility to search all appearances of the phrase in currently displayed document

plugin.tx_dlf_searchindocumenttool.

Property

Data type

Default

Values

searchUrl

string

 

documentIdUrlSchema

string

empty

https://host.de/items/id/record - example value

idInputName

string

tx_dlf[id]

queryInputName

string

tx_dlf[query]

startInputName

string

tx_dlf[start]

pageInputName

string

tx_dlf[page]

highlightWordInputName

string

tx_dlf[highlight_word]

encryptedInputName

string

tx_dlf[encrypted]