acdh-oeaw / arche-thumbnails
Thumbnails service for the ARCHE Suite
Requires
- ext-imagick: *
- ext-pdo: *
- ext-pdo_sqlite: *
- ext-yaml: *
- acdh-oeaw/arche-diss-cache: ^0.11.1
- acdh-oeaw/arche-lib: ^7
- guzzlehttp/guzzle: ^7
- zozlak/logging: ^1
Requires (Dev)
- phpstan/phpstan: *
- phpunit/phpunit: ^11.4
- zozlak/yaml-merge: ^1.0
README
An ARCHE dissemination service providing thumbnails for resources (so they can be nicely displayed in the GUI).
For images it simply provides thumbnails and for another resources it tries to do its best either by finding a connected image (e.g. with acdh:hasTitleImage metadata link) or by rendering a content fragment (for text resources) or by providing an icon based on the resource type.
To speed things up it caches provided results.
It can be queried as {deploymentUrl}/?{parameters}, where available parameters are
id={archeId}(required) where thearcheIdis any identifier of an ARCHE resource. The value should be properly URL encoded.width(optional) a requested thumbnail width in pixels (if onlyheightis specified, it is computed automatically to keep the aspect ratio)height(optional) a requested thumbnail height in pixels (if onlywidthis specified, it is computed automatically to keep the aspect ratio)
Extending
Prepare a new class implementing acdhOeaw\repo\thumbnails\handler\HandlerInterface and register it by addding mimeHandlers[]='yourClassName' to the config.ini.
For example implementations look into the src\acdhOeaw\repo\thumbnails\handler folder.