Adds new features

HypothesisPlugin.inc.php

@@ -20,8 +20,15 @@ class HypothesisPlugin extends GenericPlugin {
 	 */
 	function register($category, $path, $mainContextId = null) {
 		if (parent::register($category, $path, $mainContextId)) {
-			HookRegistry::register('ArticleHandler::download',array(&$this, 'callback'));
+			HookRegistry::register('ArticleHandler::download', array(&$this, 'callback'));
 			HookRegistry::register('TemplateManager::display', array(&$this, 'callbackTemplateDisplay'));
+			HookRegistry::register('TemplateManager::display', [$this, 'addAnnotationNumberViewers']);
+			HookRegistry::register('LoadHandler', array($this, 'addAnnotationsHandler'));
+			HookRegistry::register('LoadComponentHandler', array($this, 'setupHypothesisHandler'));
+			HookRegistry::register('AcronPlugin::parseCronTab', [$this, 'addTasksToCrontab']);
+
+			$this->addHandlerURLToJavaScript();
+
 			return true;
 		}
 		return false;
@@ -55,12 +62,13 @@ function callbackTemplateDisplay($hookName, $args) {
 		$templateMgr = $args[0];
 		$template = $args[1];
 		$plugin = 'plugins-generic-pdfJsViewer';
-		$submissiontpl = 'submissionGalley.tpl';
-		$issuetpl = 'issueGalley.tpl';
-		
+		$submissionGalleyTpl = 'submissionGalley.tpl';
+		$issueGalleyTpl = 'issueGalley.tpl';
+
 		// template path contains the plugin path, and ends with the tpl file
-		if ( (strpos($template, $plugin) !== false) && (  (strpos($template, ':'.$submissiontpl,  -1 - strlen($submissiontpl)) !== false)  ||  (strpos($template, ':'.$issuetpl,  -1 - strlen($issuetpl)) !== false))) {
+		if ( (strpos($template, $plugin) !== false) && (  (strpos($template, ':'.$submissionGalleyTpl,  -1 - strlen($submissionGalleyTpl)) !== false)  ||  (strpos($template, ':'.$issueGalleyTpl,  -1 - strlen($issueGalleyTpl)) !== false))) {
 			$templateMgr->registerFilter("output", array($this, 'changePdfjsPath'));
+			$templateMgr->registerFilter("output", array($this, 'addHypothesisConfig'));
 		}
 		return false;
 	}
@@ -76,6 +84,83 @@ function changePdfjsPath($output, $templateMgr) {
 		return $newOutput;
 	}
 
+	/**
+	 * Adds Hypothesis tab configuration so sidebar opens automatically when PDF has annotations
+	 * @param $output string
+	 * @param $templateMgr TemplateManager
+	 * @return $string
+	 */
+	public function addHypothesisConfig($output, $templateMgr) {
+		if (preg_match('/<div[^>]+id="pdfCanvasContainer/', $output, $matches, PREG_OFFSET_CAPTURE)) {
+            $posMatch = $matches[0][1];
+			$config = $templateMgr->fetch($this->getTemplateResource('hypothesisConfig.tpl'));
+
+            $output = substr_replace($output, $config, $posMatch, 0);
+            $templateMgr->unregisterFilter('output', array($this, 'addHypothesisConfig'));
+        }
+		return $output;
+	}
+
+	public function addAnnotationNumberViewers($hookName, $args) {
+		$templateMgr = $args[0];
+		$template = $args[1];
+		$pagesToInsert = [
+			'frontend/pages/indexServer.tpl',
+			'frontend/pages/preprint.tpl',
+			'frontend/pages/preprints.tpl',
+			'frontend/pages/sections.tpl',
+			'frontend/pages/indexJournal.tpl',
+			'frontend/pages/article.tpl',
+			'frontend/pages/issue.tpl'
+		];
+
+		if (in_array($template, $pagesToInsert)) {
+            $request = Application::get()->getRequest();
+
+            $jsUrl = $request->getBaseUrl() . '/' . $this->getPluginPath() . '/js/addAnnotationViewers.js';
+            $styleUrl = $request->getBaseUrl() . '/' . $this->getPluginPath() . '/styles/annotationViewer.css';
+
+            $templateMgr->addJavascript('AddAnnotationViewers', $jsUrl, ['contexts' => 'frontend']);
+            $templateMgr->addStyleSheet('AnnotationViewerStyleSheet', $styleUrl, ['contexts' => 'frontend']);
+        }
+
+		return false;
+	}
+
+	public function addAnnotationsHandler($hookName, $args) {
+		$page = $args[0];
+		if ($page == 'annotations') {
+			$this->import('pages.annotations.AnnotationsHandler');
+			define('HANDLER_CLASS', 'AnnotationsHandler');
+			return true;
+		}
+		return false;
+	}
+
+	public function setupHypothesisHandler($hookName, $args) {
+		$component = &$args[0];
+        if ($component == 'plugins.generic.hypothesis.controllers.HypothesisHandler') {
+            return true;
+        }
+        return false;
+	}
+
+	public function addTasksToCrontab($hookName, $args) {
+		$taskFilesPath = &$args[0];
+        $taskFilesPath[] = $this->getPluginPath() . DIRECTORY_SEPARATOR . 'scheduledTasks.xml';
+        return false;
+	}
+
+	public function addHandlerURLToJavaScript()
+    {
+        $request = Application::get()->getRequest();
+        $templateMgr = TemplateManager::getManager($request);
+        $handlerUrl = $request->getDispatcher()->url($request, ROUTE_COMPONENT, null, 'plugins.generic.hypothesis.controllers.HypothesisHandler');
+        $data = ['hypothesisHandlerUrl' => $handlerUrl];
+
+        $templateMgr->addJavaScript('HypothesisHandler', 'app = ' . json_encode($data) . ';', ['contexts' => 'frontend', 'inline' => true]);
+    }
+
 	/**
 	 * Get the display name of this plugin
 	 * @return string
@@ -91,5 +176,9 @@ function getDisplayName() {
 	function getDescription() {
 		return __('plugins.generic.hypothesis.description');
 	}
+
+	function getStyleSheet() {
+		return $this->getPluginPath() . '/styles/annotationViewer.css';
+	}
 }
 

classes/Annotation.inc.php

@@ -0,0 +1,20 @@
+<?php
+
+class Annotation {
+    public $user;
+    public $dateCreated;
+    public $target;
+    public $content;
+
+    public function __construct(string $user, string $dateCreated, string $target, string $content) {
+        $this->user = $user;
+        $this->dateCreated = $dateCreated;
+        $this->target = $target;
+        $this->content = $content;
+    }
+
+    public static function __set_state($dump) {
+        $obj = new Annotation($dump['user'], $dump['dateCreated'], $dump['target'], $dump['content']);
+        return $obj;
+    }
+}

classes/HypothesisDAO.inc.php

@@ -0,0 +1,23 @@
+<?php
+
+import('lib.pkp.classes.db.DAO');
+
+use Illuminate\Database\Capsule\Manager as Capsule;
+use Illuminate\Support\Collection;
+
+class HypothesisDAO extends DAO {
+    public function getDatePublished($submissionId): string {
+        $result = Capsule::table('submissions')
+            ->where('submission_id', $submissionId)
+            ->select('current_publication_id')
+            ->first();
+        $currentPublicationId = get_object_vars($result)['current_publication_id'];
+
+        $result = Capsule::table('publications')
+            ->where('publication_id', $currentPublicationId)
+            ->select('date_published')
+            ->first();
+
+        return get_object_vars($result)['date_published'];
+    }
+}

classes/HypothesisHelper.inc.php

@@ -0,0 +1,134 @@
+<?php
+
+import('plugins.generic.hypothesis.classes.SubmissionAnnotations');
+import('classes.submission.Submission');
+
+class HypothesisHelper {
+
+    public function getSubmissionsAnnotations($contextId) {
+        $submissions = Services::get('submission')->getMany([
+            'contextId' => $contextId,
+            'status' => STATUS_PUBLISHED
+        ]);
+
+        $groupsRequests = $this->getSubmissionsGroupsRequests($submissions, $contextId);
+        $submissionsAnnotations = [];
+        foreach ($groupsRequests as $groupRequest) {
+            $groupResponse = $this->getRequestAnnotations($groupRequest);
+            if (!is_null($groupResponse) && $groupResponse['total'] > 0) {
+                $submissionsAnnotations = array_merge(
+                    $submissionsAnnotations,
+                    $this->groupSubmissionsAnnotations($groupResponse)
+                );
+            }
+        }
+
+        return $submissionsAnnotations;
+    }
+
+    private function getSubmissionsGroupsRequests($submissions, $contextId) {
+        $requests = [];
+        $requestPrefix = $currentRequest = "https://hypothes.is/api/search?limit=200&group=__world__";
+        $maxRequestLength = 4094;
+
+        foreach ($submissions as $submission) {
+            $submissionRequestParams = $this->getSubmissionRequestParams($submission, $contextId);
+
+            if(!is_null($submissionRequestParams)) {
+                if(strlen($currentRequest.$submissionRequestParams) < $maxRequestLength) {
+                    $currentRequest .= $submissionRequestParams;
+                }
+                else {
+                    $requests[] = $currentRequest;
+                    $currentRequest = $requestPrefix . $submissionRequestParams; 
+                }
+            }
+        }
+
+        return $requests;
+    }
+
+    private function getSubmissionRequestParams($submission, $contextId) {
+        $submissionRequestParams = "";
+        $publication = $submission->getCurrentPublication();
+
+        if(is_null($publication))
+            return null;
+
+        $galleys = $publication->getData('galleys');
+        foreach ($galleys as $galley) {
+            if ($galley->getFileType() == 'application/pdf') {
+                $galleyDownloadURL = $this->getGalleyDownloadURL($contextId, $submission, $galley);
+                if(!is_null($galleyDownloadURL)) {
+                    $submissionRequestParams .= "&uri={$galleyDownloadURL}";
+                }
+            }
+        }
+
+        return $submissionRequestParams;
+    }
+
+    private function getRequestAnnotations($requestURL) {
+        $ch = curl_init($requestURL);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+        $output = curl_exec($ch);
+        if(!$output || substr($output, 1, 8) != '"total":') return null;
+
+        return json_decode($output, true);
+    }
+
+    private function groupSubmissionsAnnotations($groupResponse) {
+        $submissionsAnnotations = [];
+
+        foreach ($groupResponse['rows'] as $annotationResponse) {
+            $urlBySlash = explode("/", $annotationResponse['links']['incontext']);
+            $submissionId = (int) $urlBySlash[count($urlBySlash) - 3];
+
+            if(!array_key_exists($submissionId, $submissionsAnnotations)) {
+                $submissionsAnnotations[$submissionId] = new SubmissionAnnotations($submissionId);
+            }
+
+            $annotation = $this->getAnnotation($annotationResponse);
+            $submissionsAnnotations[$submissionId]->addAnnotation($annotation);
+        }
+
+        return $submissionsAnnotations;
+    }
+
+    private function getAnnotation($annotationResponse): Annotation {
+        $user = substr($annotationResponse['user'], 5, strlen($annotationResponse['user']) - 17);
+        $dateCreated = $annotationResponse['created'];
+        $content = $annotationResponse['text'];
+
+        $target = "";
+        if(isset($annotationResponse['target'][0]['selector'])) {
+            foreach ($annotationResponse['target'][0]['selector'] as $selector) {
+                if($selector['type'] == 'TextQuoteSelector') {
+                    $target = $selector['exact'];
+                    break;
+                }
+            }
+        }
+
+        return new Annotation($user, $dateCreated, $target, $content);
+    }
+
+    public function getGalleyDownloadURL($contextId, $submission, $galley) {
+        $request = Application::get()->getRequest();
+        $indexUrl = $request->getIndexUrl();
+        $context = Services::get('context')->get($contextId);
+        $contextPath = $context->getPath();
+        $submissionType = (Application::getName() == 'ojs2' ? 'article' : 'preprint');
+
+        $submissionFile = $galley->getFile();
+        if(is_null($submissionFile))
+            return null;
+
+        $submissionBestId = $submission->getBestId();
+        $galleyBestId = $galley->getBestGalleyId();
+        $fileId = $submissionFile->getId();
+
+        return $indexUrl . "/$contextPath/$submissionType/download/$submissionBestId/$galleyBestId/$fileId";
+    }
+
+}

classes/SubmissionAnnotations.inc.php

@@ -0,0 +1,24 @@
+<?php
+
+import('plugins.generic.hypothesis.classes.Annotation');
+
+class SubmissionAnnotations {
+    public $submissionId;
+    public $submission;
+    public $annotations;
+
+    public function __construct(int $submissionId) {
+        $this->submissionId = $submissionId;
+        $this->annotations = [];
+    }
+
+    public static function __set_state($dump) {
+        $obj = new SubmissionAnnotations($dump['submissionId']);
+        $obj->annotations = $dump['annotations'];
+        return $obj;
+    }
+
+    public function addAnnotation(Annotation $annotation) {
+        $this->annotations[] = $annotation;
+    }
+}

classes/tasks/UpdateAnnotationsCache.inc.php

@@ -0,0 +1,33 @@
+<?php
+
+import('lib.pkp.classes.scheduledTask.ScheduledTask');
+
+class UpdateAnnotationsCache extends ScheduledTask {
+
+	public function executeActions() {
+        $contextIds = Services::get('context')->getIds([
+			'isEnabled' => true,
+		]);
+
+        foreach ($contextIds as $contextId) {
+            $cacheManager = CacheManager::getManager();
+            $cache = $cacheManager->getFileCache(
+                $contextId,
+                'submissions_annotations',
+                [$this, 'cacheDismiss']
+            );
+
+            $cache->flush();
+            $hypothesisHandler = new HypothesisHandler();
+			$cache->setEntireCache($hypothesisHandler->getSubmissionsAnnotations($contextId));
+        }
+
+		return true;
+	}
+
+    function cacheDismiss() {
+		return null;
+	}
+}
+
+

controllers/HypothesisHandler.inc.php

@@ -0,0 +1,27 @@
+<?php
+
+import('classes.handler.Handler');
+
+class HypothesisHandler extends Handler {
+    public function getAnnotationViewerData($args, $request) {
+        $galleyUrl = $args['galleyUrl'];
+        $explodedUrl = explode('/', $galleyUrl);
+        $galleyId = (int) end($explodedUrl);
+
+        $galleyDao = DAORegistry::getDAO('ArticleGalleyDAO');
+        $galley = $galleyDao->getById($galleyId);
+        if(!$galley) {
+            return json_encode(null);
+        }
+
+        $fileId = $galley->getFile()->getId();
+        $galleyDownloadUrl = str_replace('view', 'download', $galleyUrl);
+        $galleyDownloadUrl .= "/$fileId";
+
+        return json_encode([
+            'downloadUrl' => $galleyDownloadUrl,
+            'annotationMsg' => __('plugins.generic.hypothesis.annotation'),
+            'annotationsMsg' => __('plugins.generic.hypothesis.annotations')
+        ]);
+    }
+}