kitodo-presentation/dlf/plugins/pageview/class.tx_dlf_pageview.php

490 lines
12 KiB
PHP

<?php
/***************************************************************
* Copyright notice
*
* (c) 2011 Goobi. Digitalisieren im Verein e.V. <contact@goobi.org>
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
/**
* [CLASS/FUNCTION INDEX of SCRIPT]
*/
/**
* Plugin 'DLF: Pageview' for the 'dlf' extension.
*
* @author Sebastian Meyer <sebastian.meyer@slub-dresden.de>
* @package TYPO3
* @subpackage tx_dlf
* @access public
*/
class tx_dlf_pageview extends tx_dlf_plugin {
public $scriptRelPath = 'plugins/pageview/class.tx_dlf_pageview.php';
/**
* Holds the controls to add to the map
*
* @var array
* @access protected
*/
protected $controls = array ();
/**
* Flag if fulltexts are present
*
* @var boolean
* @access protected
*/
protected $hasFulltexts = false;
/**
* Holds the dependencies of the control features
*
* @var array
* @access protected
*/
protected $controlDependency = array (
'OverviewMap' => array (
'OpenLayers/Control/OverviewMap.js'
),
'PanPanel' => array (
'OpenLayers/Control/Button.js',
'OpenLayers/Control/Pan.js',
'OpenLayers/Control/Panel.js',
'OpenLayers/Control/PanPanel.js'
),
'PanZoom' => array (
'OpenLayers/Control/PanZoom.js'
),
'PanZoomBar' => array (
'OpenLayers/Control/PanZoom.js',
'OpenLayers/Control/PanZoomBar.js'
),
'ZoomPanel' => array (
'OpenLayers/Control/Button.js',
'OpenLayers/Control/Panel.js',
'OpenLayers/Control/ZoomIn.js',
'OpenLayers/Control/ZoomOut.js',
'OpenLayers/Control/ZoomToMaxExtent.js',
'OpenLayers/Control/ZoomPanel.js'
)
);
/**
* Holds the current images' URLs
*
* @var array
* @access protected
*/
protected $images = array ();
/**
* Holds the current fulltexts' URLs
*
* @var array
* @access protected
*/
protected $fulltexts = array ();
/**
* Holds the language code for OpenLayers
*
* @var string
* @access protected
*/
protected $lang = 'en';
/**
* Adds OpenLayers javascript
*
* @access protected
*
* @return string OpenLayers script tags ready for output.
*/
protected function addOpenLayersJS() {
$output = array ();
// Get localization for OpenLayers.
if ($GLOBALS['TSFE']->lang) {
$langFile = \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath($this->extKey, 'lib/OpenLayers/lib/OpenLayers/Lang/'.strtolower($GLOBALS['TSFE']->lang).'.js');
if (file_exists($langFile)) {
$this->lang = strtolower($GLOBALS['TSFE']->lang);
}
}
// Load required OpenLayers components.
$components = array (
// Map feature.
'OpenLayers/BaseTypes.js',
'OpenLayers/BaseTypes/Class.js',
'OpenLayers/BaseTypes/Bounds.js',
'OpenLayers/BaseTypes/Element.js',
'OpenLayers/BaseTypes/LonLat.js',
'OpenLayers/BaseTypes/Pixel.js',
'OpenLayers/BaseTypes/Size.js',
'OpenLayers/Console.js',
'OpenLayers/Lang.js',
'OpenLayers/Util.js',
'OpenLayers/Util/vendorPrefix.js',
'OpenLayers/Lang/'.$this->lang.'.js',
'OpenLayers/Events.js',
'OpenLayers/Events/buttonclick.js',
'OpenLayers/Events/featureclick.js',
'OpenLayers/Animation.js',
'OpenLayers/Tween.js',
'OpenLayers/Projection.js',
'OpenLayers/Map.js',
// Default event handlers and controls.
'OpenLayers/Handler.js',
'OpenLayers/Handler/Click.js',
'OpenLayers/Handler/Drag.js',
'OpenLayers/Handler/Box.js',
'OpenLayers/Handler/Keyboard.js',
'OpenLayers/Handler/MouseWheel.js',
'OpenLayers/Handler/Pinch.js',
'OpenLayers/Control.js',
'OpenLayers/Control/DragPan.js',
'OpenLayers/Control/PinchZoom.js',
'OpenLayers/Control/ZoomBox.js',
'OpenLayers/Control/Navigation.js',
'../../../plugins/pageview/OpenLayers_Control_Keyboard.js',
// Image layer.
'OpenLayers/Tile.js',
'OpenLayers/Tile/Image.js',
'OpenLayers/Layer.js',
'OpenLayers/Layer/HTTPRequest.js',
'OpenLayers/Layer/Grid.js',
'OpenLayers/Layer/Image.js',
);
// Load required OpenLayers components.
$componentsFulltexts = array (
// Geometry layer --> dfgviewer
'OpenLayers/Control/SelectFeature.js',
'OpenLayers/Control/DrawFeature.js',
'OpenLayers/Handler/Feature.js',
'OpenLayers/Handler/RegularPolygon.js',
'OpenLayers/Geometry.js',
'OpenLayers/Geometry/Collection.js',
'OpenLayers/Geometry/Polygon.js',
'OpenLayers/Geometry/MultiPoint.js',
'OpenLayers/Geometry/Curve.js',
'OpenLayers/Geometry/LineString.js',
'OpenLayers/Geometry/LinearRing.js',
'OpenLayers/Geometry/Point.js',
'OpenLayers/Feature.js',
'OpenLayers/Feature/Vector.js',
'OpenLayers/Layer/Vector.js',
'OpenLayers/Renderer.js',
'OpenLayers/Renderer/Elements.js',
'OpenLayers/Renderer/SVG.js',
'OpenLayers/Renderer/Canvas.js',
'OpenLayers/StyleMap.js',
'OpenLayers/Style.js',
// XML Parser.
'OpenLayers/Request.js',
'OpenLayers/Request/XMLHttpRequest.js',
'OpenLayers/Format.js',
'OpenLayers/Format/XML.js',
'../../../plugins/pageview/OpenLayers_Format_Alto.js',
'OpenLayers/Popup.js',
'OpenLayers/Popup/Anchored.js',
'OpenLayers/Popup/Framed.js',
'OpenLayers/Popup/FramedCloud.js',
);
// Add custom control features.
foreach ($this->controls as $control) {
$components = array_merge($components, array_diff($this->controlDependency[$control], $components));
}
// Add fulltext polygon features.
if ($this->hasFulltexts) {
$components = array_merge($components, $componentsFulltexts);
}
$output[] = '<script type="text/javascript">';
$output[] = 'var openLayersFiles = ["'.implode('", "', $components).'"];';
// concat files for syntax highlightning, if present in header
if (! empty($GLOBALS['TSFE']->additionalHeaderData['tx-dlf-header-sru'])) {
$output[] = 'window.OpenLayers = openLayersFiles.concat( openLayerFilesHighlightning );';
} else {
$output[] = 'window.OpenLayers = openLayersFiles;';
}
$output[] = '</script>';
// Add OpenLayers library.
$output[] = '
<script type="text/javascript" src="'.\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::siteRelPath($this->extKey).'lib/OpenLayers/lib/OpenLayers.js"></script>';
return implode("\n", $output);
}
/**
* Adds Viewer javascript
*
* @access protected
*
* @return string Viewer script tags ready for output
*/
protected function addViewerJS() {
$output = array ();
// Add jQuery library.
tx_dlf_helper::loadJQuery();
// Add OpenLayers library.
$output[] = $this->addOpenLayersJS($fulltexts);
// Add viewer library.
$output[] = '
<script type="text/javascript" src="'.\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::siteRelPath($this->extKey).'plugins/pageview/tx_dlf_pageview.js"></script>';
// Add viewer configuration.
$output[] = '
<script id="tx-dlf-pageview-initViewer" type="text/javascript">
tx_dlf_viewer = new dlfViewer();
tx_dlf_viewer.setDiv("'.$this->conf['elementId'].'");
tx_dlf_viewer.setLang("'.$this->lang.'");
tx_dlf_viewer.addControls(["'.implode('", "', $this->controls).'"]);
tx_dlf_viewer.addImages(["'.implode('", "', $this->images).'"]);
tx_dlf_viewer.addFulltexts(["'.implode('", "', $this->fulltexts).'"]);
</script>';
return implode("\n", $output);
}
/**
* Get image's URL
*
* @access protected
*
* @param integer $page: Page number
*
* @return string URL of image file
*/
protected function getImageUrl($page) {
$imageUrl = '';
// Get @USE value of METS fileGrp.
$fileGrps = t3lib_div::trimExplode(',', $this->conf['fileGrps']);
while ($fileGrp = @array_pop($fileGrps)) {
// Get image link.
if (!empty($this->doc->physicalPagesInfo[$this->doc->physicalPages[$page]]['files'][$fileGrp])) {
$imageUrl = $this->doc->getFileLocation($this->doc->physicalPagesInfo[$this->doc->physicalPages[$page]]['files'][$fileGrp]);
break;
} else {
if (TYPO3_DLOG) {
t3lib_div::devLog('[tx_dlf_pageview->getImageUrl('.$page.')] File not found in fileGrp "'.$fileGrp.'"', $this->extKey, SYSLOG_SEVERITY_WARNING);
}
}
}
return $imageUrl;
}
/**
* Get ALTO XML URL
*
* @access protected
*
* @param integer $page: Page number
*
* @return string URL of image file
*/
protected function getAltoUrl($page) {
$imageUrl = '';
// Get @USE value of METS fileGrp.
// we need USE="FULLTEXT"
$fileGrpFulltext = t3lib_div::trimExplode(',', $this->conf['fileGrpFulltext']);
while ($fileGrpFulltext = @array_pop($fileGrpFulltext)) {
// Get fulltext link.
if (!empty($this->doc->physicalPagesInfo[$this->doc->physicalPages[$page]]['files'][$fileGrpFulltext])) {
$fulltextUrl = $this->doc->getFileLocation($this->doc->physicalPagesInfo[$this->doc->physicalPages[$page]]['files'][$fileGrpFulltext]);
// Build typolink configuration array.
$fulltextUrl = '/index.php?eID=tx_dlf_fulltext_eid&url='. $fulltextUrl;
$this->hasFulltexts = true;
break;
} else {
if (TYPO3_DLOG) {
t3lib_div::devLog('[tx_dlf_pageview->getImageUrl('.$page.')] File not found in fileGrp "'.$fileGrp.'"', $this->extKey, SYSLOG_SEVERITY_WARNING);
}
}
}
return $fulltextUrl;
}
/**
* Get map controls
*
* @access protected
*
* @return array Array of control keywords
*/
protected function getMapControls() {
$controls = explode(',', $this->conf['features']);
// Sanitize input.
foreach ($controls as $key => $control) {
if (empty($this->controlDependency[$control])) {
unset ($controls[$key]);
}
}
return $controls;
}
/**
* The main method of the PlugIn
*
* @access public
*
* @param string $content: The PlugIn content
* @param array $conf: The PlugIn configuration
*
* @return string The content that is displayed on the website
*/
public function main($content, $conf) {
$this->init($conf);
// Load current document.
$this->loadDocument();
if ($this->doc === NULL || $this->doc->numPages < 1) {
// Quit without doing anything if required variables are not set.
return $content;
} else {
// Set default values if not set.
// page may be integer or string (physical page attribute)
if ( (int)$this->piVars['page'] > 0 || empty($this->piVars['page'])) {
$this->piVars['page'] = tx_dlf_helper::intInRange((int)$this->piVars['page'], 1, $this->doc->numPages, 1);
} else {
$this->piVars['page'] = array_search($this->piVars['page'], $this->doc->physicalPages);
}
$this->piVars['double'] = tx_dlf_helper::intInRange($this->piVars['double'], 0, 1, 0);
}
// Load template file.
if (!empty($this->conf['templateFile'])) {
$this->template = $this->cObj->getSubpart($this->cObj->fileResource($this->conf['templateFile']), '###TEMPLATE###');
} else {
$this->template = $this->cObj->getSubpart($this->cObj->fileResource('EXT:dlf/plugins/pageview/template.tmpl'), '###TEMPLATE###');
}
// Get image data.
$this->images[0] = $this->getImageUrl($this->piVars['page']);
$this->fulltexts[0] = $this->getAltoUrl($this->piVars['page']);
if ($this->piVars['double'] && $this->piVars['page'] < $this->doc->numPages) {
$this->images[1] = $this->getImageUrl($this->piVars['page'] + 1);
$this->fulltexts[1] = $this->getAltoUrl($this->piVars['page'] + 1);
}
// Get the controls for the map.
$this->controls = $this->getMapControls();
// Fill in the template markers.
$markerArray = array (
'###VIEWER_JS###' => $this->addViewerJS()
);
$content .= $this->cObj->substituteMarkerArray($this->template, $markerArray);
return $this->pi_wrapInBaseClass($content);
}
}
if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/dlf/plugins/pageview/class.tx_dlf_pageview.php']) {
include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/dlf/plugins/pageview/class.tx_dlf_pageview.php']);
}
?>