From 7f39d43e1759250507482c21854ab7b74ddf1318 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 6 Feb 2024 16:35:38 +0600
Subject: [PATCH 01/75] pkp/plagiarism#52 iThenticate API update and plugin
 update

---
 .gitignore                                   |   2 +-
 IThenticate.inc.php                          | 431 +++++++++++++++++++
 PlagiarismPlugin.inc.php                     | 383 ++++++++++------
 PlagiarismSettingsForm.inc.php               |  42 +-
 README.md                                    |  22 +-
 TestIThenticate.inc.php                      | 262 +++++++++++
 composer.json                                |  19 -
 composer.lock                                | 177 --------
 controllers/PlagiarismWebhookHandler.inc.php |  57 +++
 exclusions.txt                               |   9 -
 index.php                                    |   4 +-
 lib/phpxmlrpc-datetime.diff                  |  11 -
 locale/en_US/locale.po                       |  16 +-
 templates/settingsForm.tpl                   |  14 +-
 version.xml                                  |   4 +-
 15 files changed, 1053 insertions(+), 400 deletions(-)
 create mode 100644 IThenticate.inc.php
 create mode 100644 TestIThenticate.inc.php
 delete mode 100644 composer.json
 delete mode 100644 composer.lock
 create mode 100644 controllers/PlagiarismWebhookHandler.inc.php
 delete mode 100644 lib/phpxmlrpc-datetime.diff

diff --git a/.gitignore b/.gitignore
index 61ead86..e43b0f9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1 @@
-/vendor
+.DS_Store
diff --git a/IThenticate.inc.php b/IThenticate.inc.php
new file mode 100644
index 0000000..625d886
--- /dev/null
+++ b/IThenticate.inc.php
@@ -0,0 +1,431 @@
+<?php
+
+/**
+ * @file IThenticate.inc.php
+ *
+ * Copyright (c) 2003-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @brief Service class to handle API communication with iThenticate service
+ */
+
+class IThenticate
+{
+    /** 
+     * The base api url in the format of schems://host
+     * 
+     * @var string
+     */
+    protected $apiUrl;
+
+    /**
+     * The required API Key to make the request
+     * @see https://developers.turnitin.com/docs/tca#required-headers
+     * 
+     * @var string
+     */
+    protected $apiKey;
+
+    /**
+     * Describes the platform/plugin integrating with TCA
+     * @see https://developers.turnitin.com/docs/tca#required-headers
+     * 
+     * @var string
+     */
+    protected $integrationName;
+
+    /**
+     * The version of the code that is integrating with TCA
+     * @see https://developers.turnitin.com/docs/tca#required-headers
+     * 
+     * @var string
+     */
+    protected $integrationVersion;
+    
+    /**
+     * The EULA(end user license agreement) that user need to confrim before making request
+     * 
+     * @var string|null
+     */
+    protected $eulaVersion = null;
+
+    /**
+     * The EULA details for a specific version
+     * 
+     * @var array|null
+     */
+    protected $eualVersionDetails = null;
+
+    /**
+     * Base API path
+     * The string `API_URL` need to be replaced with provided api url to generarte fully qualified base url
+     * 
+     * @var string
+     */
+    protected $apiBasePath = "API_URL/api/v1/";
+
+    /**
+     * The default EULA version placeholder to retrieve the current latest version
+     * 
+     * @var string
+     */
+    public const DEFAULT_EULA_VERSION = 'latest';
+    
+    /**
+     * The default EULA confirming language
+     * 
+     * @var string
+     */
+    public const DEFAULT_EULA_LANGUAGE = 'en-US';
+
+    /**
+     * The default webhook events for which webhook request will be received
+     * @see https://developers.turnitin.com/docs/tca#event-types
+     * 
+     * @var string
+     */
+    public const DEFAULT_WEBHOOK_EVENTS = [
+        'SUBMISSION_COMPLETE',
+        'SIMILARITY_COMPLETE',
+        'SIMILARITY_UPDATED',
+        'PDF_STATUS',
+        'GROUP_ATTACHMENT_COMPLETE',
+    ];
+
+    /**
+     * Create a new instance
+     * 
+     * @param string        $apiUrl
+     * @param string        $apiKey
+     * @param string        $integrationName
+     * @param string        $integrationVersion
+     * @param string|null   eulaVersion
+     */
+    public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
+        $this->apiUrl               = rtrim(trim($apiUrl), '/\\');
+        $this->apiKey               = $apiKey;
+        $this->integrationName      = $integrationName;
+        $this->integrationVersion   = $integrationVersion;
+        $this->eulaVersion          = $eulaVersion;
+    }
+
+    /**
+     * Confirm the EUAL on the user's behalf for given version
+     * @see https://developers.turnitin.com/docs/tca#accept-eula-version
+     * 
+     * @param User      $user
+     * @param Context   $context
+     * @param string    $version
+     *
+     * @return bool
+     */
+    public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSION) {
+        
+        // Validate the EULA version
+        if (!$this->validateEulaVersion($this->eulaVersion ?? $version)) {
+            return false;
+        }
+
+        // if user has already accepted/confirm this EULA, no need to go further to reconfirm
+        if ($this->verifyUserEulaAcceptance($user, $this->getApplicationEulaVersion())) {
+            return true;
+        }
+        
+        $response = Application::get()->getHttpClient()->request(
+            'POST',
+            $this->getApiPath("eula/{$this->getApplicationEulaVersion()}/accept"),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => 'application/json'
+                ]),
+                'json' => [
+                    'user_id' => $user->getId(),
+                    'accepted_timestamp' => \Carbon\Carbon::now()->toIso8601String(),
+                    'language' => $this->getEualConfirmationLocale($context->getPrimaryLocale()),
+                ],
+                'verify' => false,
+                'exceptions' => false,
+            ]
+        );
+
+        return $response->getStatusCode() === 200;
+    }
+    
+    /**
+     * Create a new submission at service's end
+     * @see https://developers.turnitin.com/docs/tca#create-a-submission
+     * 
+     * @param Submission    $submission
+     * @param User          $user
+     * @param Author|null   $author
+     *
+     * @return string|null  if succeed, it will return the created submission UUID at service's end and 
+     *                      at failure, will return null
+     */
+    public function submitSubmission($submission, $user, $author = null) {
+
+        $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
+        $author ??= $publication->getPrimaryAuthor();
+
+        $response = Application::get()->getHttpClient()->request(
+            'POST',
+            $this->getApiPath("submissions"),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => 'application/json'
+                ]),
+                'json' => [
+                    'owner' => $author->getId(),
+                    'title' => $publication->getLocalizedTitle($publication->getData('locale')),
+                    'submitter' => $user->getId(),
+                    'metadata' => [
+                        'owners' => [
+                            [
+                                'id' => $author->getId(),
+                                'given_name' => $author->getLocalizedGivenName(),
+                                'family_name' => $author->getLocalizedFamilyName(),
+                                'email' => $author->getEmail(),
+                            ]
+                        ],
+                        'submitter' => [
+                            'id' => $user->getId(),
+                            'given_name' => $user->getLocalizedGivenName(),
+                            'family_name' => $user->getLocalizedFamilyName(),
+                            'email' => $user->getEmail(),
+                        ],
+                        'original_submitted_time' => \Carbon\Carbon::now()->toIso8601String(),
+                    ],
+
+                ],
+                'verify' => false,
+                'exceptions' => false,
+            ]
+        );
+
+        if ($response->getStatusCode() === 201) {
+            $result = json_decode($response->getBody()->getContents());
+            return $result->id;
+        }
+
+        return null;
+    }
+
+    /**
+     * Upload all submission files to the service's end
+     *
+     * @param string        $submissionTacId The submission UUID return back from service
+     * @param Submission    $submission
+     *
+     * @return bool         If all submission files uploaded successfully, only then it will 
+     *                      return TRUE and return FALSE on a single failure
+     */
+    public function uploadSubmissionFile($submissionTacId, $submission)
+    {
+        $submissionFiles = Services::get('submissionFile')->getMany([
+			'submissionIds' => [$submission->getId()],
+		]);
+        
+        $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
+
+        foreach($submissionFiles as $submissionFile) {
+            $file = Services::get('file')->get($submissionFile->getData('fileId'));
+            $uploadStatus = $this->uploadFile(
+                $submissionTacId, 
+                $submissionFile->getData("name", $publication->getData("locale")),
+                Services::get('file')->fs->read($file->path),
+            );
+
+            if (!$uploadStatus) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * Upload single submission file to the service's end
+     * @see https://developers.turnitin.com/docs/tca#upload-submission-file-contents
+     *
+     * @param string $submissionTacId The submission UUID return back from service
+     * @param string $fileName
+     * @param mixed  fileContent   
+     *
+     * @return bool
+     */
+    public function uploadFile($submissionTacId, $fileName, $fileContent) {
+        
+        $response = Application::get()->getHttpClient()->request(
+            'PUT',
+            $this->getApiPath("submissions/{$submissionTacId}/original"),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => 'binary/octet-stream',
+                    'Content-Disposition' => urlencode('inline; filename="'.$fileName.'"'),
+                ]),
+                'body' => $fileContent,
+                'verify' => false,
+                'exceptions' => true,
+            ]
+        );
+
+        return $response->getStatusCode() === 202;
+    }
+
+    /**
+     * Verify if user has already confirmed the given EUAL version
+     * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
+     *
+     * @param Author|User   $user
+     * @param string        $version
+     *
+     * @return bool
+     */
+    public function verifyUserEulaAcceptance($user, $version)
+    {
+        $response = Application::get()->getHttpClient()->request(
+            'GET',
+            $this->getApiPath("eula/{$version}/accept/{$user->getId()}"),
+            [
+                'headers' => $this->getRequiredHeaders(),
+                'exceptions' => false,
+            ]
+        );
+        
+        return $response->getStatusCode() === 200;
+    }
+
+    /**
+     * Validate/Retrieve the given EUAL version
+     * @see https://developers.turnitin.com/docs/tca#get-eula-version-info
+     *
+     * @param string $version
+     * @return bool
+     */
+    public function validateEulaVersion($version) {
+
+        $response = Application::get()->getHttpClient()->request(
+            'GET',
+            $this->getApiPath("eula/{$version}"),
+            [
+                'headers' => $this->getRequiredHeaders(),
+                'exceptions' => false,
+            ]
+        );
+        
+        if ($response->getStatusCode() === 200) {
+            $this->eualVersionDetails = json_decode($response->getBody()->getContents(), true);
+            
+            if (!$this->eulaVersion) {
+                $this->eulaVersion = $this->eualVersionDetails['version'];
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Register webhook end point
+     * @see https://developers.turnitin.com/docs/tca#create-webhook
+     *
+     * @param string $signingSecret
+     * @param string $url
+     * @param array  $events
+     * 
+     * @return string|null The UUID of register webhook if succeed or null if failed
+     */
+    public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WEBHOOK_EVENTS) {
+
+        $response = Application::get()->getHttpClient()->request(
+            'POST',
+            $this->getApiPath('webhooks'),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => ' application/json',
+                ]),
+                'json' => [
+                    'signing_secret' => base64_encode($signingSecret),
+                    'url' => $url,
+                    'event_types' => $events,
+                    'allow_insecure' => true,
+                ],
+                'verify' => false,
+                'exceptions' => false,
+            ]
+        );
+
+        if ($response->getStatusCode() === 201) {
+            $result = json_decode($response->getBody()->getContents());
+            return $result->id;
+        }
+
+        return null;
+    }
+
+    /**
+     * Get the stored EULA details
+     * 
+     * @return array|null
+     */
+    public function getEualDetails() {
+        return $this->eualVersionDetails;
+    }
+
+    /**
+     * Get the applicable EULA version
+     * 
+     * @return string
+     * @throws \Exception
+     */
+    public function getApplicationEulaVersion() {
+        if (!$this->eulaVersion) {
+            throw new \Exception('No EULA version set yet');
+        }
+
+        return $this->eulaVersion;
+    }
+
+    /**
+     * Convert given submission/context locale to service compatible and acceptable locale format
+     * @see https://developers.turnitin.com/docs/tca#eula
+     * 
+     * @param string $locale
+     * @return string
+     */
+    protected function getEualConfirmationLocale($locale) {
+        if (!$this->getEualDetails()) {
+            return static::DEFAULT_EULA_LANGUAGE;
+        }
+
+        $euleLangs = $this->getEualDetails()['available_languages'];
+        $locale = str_replace("_", "-", substr($locale, 0, 5));
+
+        return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+    }
+
+    /**
+     * Get the required headers that need to be sent with every request at service's end
+     * @see https://developers.turnitin.com/docs/tca#required-headers
+     * 
+     * @return array
+     */
+    protected function getRequiredHeaders(){
+        return [
+            'X-Turnitin-Integration-Name'       => $this->integrationName,
+            'X-Turnitin-Integration-Version'    => $this->integrationVersion,
+            'Authorization'                     => 'Bearer ' . $this->apiKey,
+        ];
+    }
+
+    /**
+     * Generate and return the final API end point to make request
+     * 
+     * @return string
+     */
+    protected function getApiPath($apiPathSegment) {
+        return str_replace('API_URL', $this->apiUrl, $this->apiBasePath) . $apiPathSegment;
+    }
+}
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index a1616ba..5101554 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -3,8 +3,8 @@
 /**
  * @file PlagiarismPlugin.inc.php
  *
- * Copyright (c) 2003-2021 Simon Fraser University
- * Copyright (c) 2003-2021 John Willinsky
+ * Copyright (c) 2003-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Plagiarism plugin
@@ -13,16 +13,31 @@
 import('lib.pkp.classes.plugins.GenericPlugin');
 
 class PlagiarismPlugin extends GenericPlugin {
+
+	public const PLUGIN_INTEGRATION_NAME = 'Plagiarism plugin for OJS/OMP/OPS';
+
 	/**
 	 * @copydoc Plugin::register()
 	 */
 	public function register($category, $path, $mainContextId = null) {
 		$success = parent::register($category, $path, $mainContextId);
-		$this->addLocaleData();
 
-		if ($success && $this->getEnabled()) {
-			HookRegistry::register('submissionsubmitstep4form::execute', array($this, 'callback'));
+		$this->addLocaleData();
+		
+		if (!($success || $this->getEnabled())) {
+			return false;	
 		}
+
+		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
+
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		HookRegistry::register("Schema::get::{$submissionDao->schemaName}", [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
+
+		$schemaName = $this->hasForcedCredentials() ? SCHEMA_SITE : Application::get()->getContextDAO()->schemaName;
+		HookRegistry::register("Schema::get::{$schemaName}", [$this, 'addPlagiarismCheckWebhookDataToSchema']);
+
+		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
+
 		return $success;
 	}
 
@@ -43,169 +58,292 @@ public function getDescription() {
 	/**
 	 * @copydoc LazyLoadPlugin::getCanEnable()
 	 */
-	function getCanEnable($contextId = null) {
+	public function getCanEnable($contextId = null) {
 		return !Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getCanDisable()
 	 */
-	function getCanDisable($contextId = null) {
+	public function getCanDisable($contextId = null) {
 		return !Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getEnabled()
 	 */
-	function getEnabled($contextId = null) {
+	public function getEnabled($contextId = null) {
 		return parent::getEnabled($contextId) || Config::getVar('ithenticate', 'ithenticate');
 	}
 
+	/**
+	 * Add properties for this type of public identifier to the submission entity's list for
+	 * storage in the database.
+	 * 
+	 * @param string $hookName `Schema::get::submission`
+	 * @param array $params
+	 * 
+	 * @return void
+	 */
+	public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
+		$schema =& $params[0];
+
+		$schema->properties->ithenticate_id = (object) [
+			'type' => 'string',
+			'description' => 'The iThenticate service submission uuid that return back after a submission has been successful submitted',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+	}
+
+	/**
+	 * Add properties for this type of public identifier to the site/context entity's list for
+	 * storage in the database.
+	 * 
+	 * @param string $hookName `Schema::get::context` or `Schema::get::site`
+	 * @param array $params
+	 * 
+	 * @return void
+	 */
+	public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
+		$schema =& $params[0];
+
+		$schema->properties->ithenticate_webhook_signing_secret = (object) [
+			'type' => 'string',
+			'description' => 'The iThenticate service webook registration signing secret',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+
+		$schema->properties->ithenticate_webhook_id = (object) [
+			'type' => 'string',
+			'description' => 'The iThenticate service webook id that return back after successful webhook registration',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+	}
+
 	/**
 	 * Fetch credentials from config.inc.php, if available
-	 * @return array username and password, or null(s)
-	**/
-	function getForcedCredentials() {
-		$request = Application::get()->getRequest();
-		$context = $request->getContext();
-		$contextPath = $context->getPath();
-		$username = Config::getVar('ithenticate', 'username[' . $contextPath . ']',
-				Config::getVar('ithenticate', 'username'));
-		$password = Config::getVar('ithenticate', 'password[' . $contextPath . ']',
-				Config::getVar('ithenticate', 'password'));
-		return [$username, $password];
+	 * 
+	 * @return array api url and api key, or null(s)
+	 */
+	public function getForcedCredentials() {
+		$request = Application::get()->getRequest(); /** @var Request $request */
+		$context = $request->getContext(); /** @var Context $context */
+		$contextPath = $context?->getPath();
+
+		$apiUrl = Config::getVar(
+			'ithenticate',
+			'api_url[' . $contextPath . ']',
+			Config::getVar('ithenticate', 'api_url')
+		);
+
+		$apiKey = Config::getVar(
+			'ithenticate',
+			'api_key[' . $contextPath . ']',
+			Config::getVar('ithenticate', 'api_key')
+		);
+
+		return [$apiUrl, $apiKey];
+	}
+
+	/**
+	 * Check and determine if plagiarism checking service creds has been set forced in config.inc.php
+	 * 
+	 * @return bool
+	 */
+	public function hasForcedCredentials() {
+		list($apiUrl, $apiKey) = $this->getForcedCredentials();
+		return !empty($apiUrl) && !empty($apiKey);
 	}
 
 	/**
 	 * Send the editor an error message
-	 * @param $submissionid int
-	 * @param $message string
+	 * 
+	 * @param int $submissionid
+	 * @param string $message
+	 * 
 	 * @return void
-	**/
-	public function sendErrorMessage($submissionid, $message) {
-		$request = Application::get()->getRequest();
-		$context = $request->getContext();
+	 */
+	public function sendErrorMessage($submissionId, $message) {
+		$request = Application::get()->getRequest(); /** @var Request $request */
+		$context = $request->getContext(); /** @var Context $context */
+		
 		import('classes.notification.NotificationManager');
 		$notificationManager = new NotificationManager();
-		$roleDao = DAORegistry::getDAO('RoleDAO'); /* @var $roleDao RoleDAO */
+		$roleDao = DAORegistry::getDAO('RoleDAO'); /** @var RoleDAO $roleDao  */
+		
 		// Get the managers.
-		$managers = $roleDao->getUsersByRoleId(ROLE_ID_MANAGER, $context->getId());
+		$managers = $roleDao->getUsersByRoleId(ROLE_ID_MANAGER, $context->getId()); /** @var DAOResultFactory $managers */
 		while ($manager = $managers->next()) {
-			$notificationManager->createTrivialNotification($manager->getId(), NOTIFICATION_TYPE_ERROR, array('contents' => __('plugins.generic.plagiarism.errorMessage', array('submissionId' => $submissionid, 'errorMessage' => $message))));
+			$notificationManager->createTrivialNotification(
+				$manager->getId(), 
+				NOTIFICATION_TYPE_ERROR, 
+				['contents' => __(
+					'plugins.generic.plagiarism.errorMessage', [
+						'submissionId' => $submissionId,
+						'errorMessage' => $message
+					]
+				)]
+			);
 		}
-		error_log('iThenticate submission '.$submissionid.' failed: '.$message);
+
+		error_log("iThenticate submission {$submissionId} failed: {$message}");
 	}
 
 	/**
-	 * Send submission files to iThenticate.
-	 * @param $hookName string
-	 * @param $args array
+	 * Setup the handler for webhook request
+	 * 
+	 * @param string $hookName
+	 * @param array $args
+	 * 
+	 * @return bool
 	 */
-	public function callback($hookName, $args) {
-		$request = Application::get()->getRequest();
-		$context = $request->getContext();
-		$contextPath = $context->getPath();
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /* @var $submissionDao SubmissionDAO */
-		$submission = $submissionDao->getById($request->getUserVar('submissionId'));
-		$publication = $submission->getCurrentPublication();
+	public function setupWebhookHandler($hookName, $params) {
+		$component =& $params[0];
 
-		require_once(dirname(__FILE__) . '/vendor/autoload.php');
+		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler') {
+			import($component);
+			PlagiarismWebhookHandler::setPlugin($this);
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Confirm EULA, create submission and upload submission files to iThenticate service
+	 * 
+	 * @param string $hookName
+	 * @param array $args
+	 * 
+	 * @return bool
+	 */
+	public function submitForPlagiarismCheck($hookName, $args) {
+		$request = Application::get()->getRequest(); /** @var Request $request */
+		$context = $request->getContext(); /** @var Context $context */
+		$siteDao = DAORegistry::getDAO('SiteDAO'); /** @var SiteDAO $siteDao */
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($request->getUserVar('submissionId')); /** @var Submission $submission */
+		$publication = $submission->getCurrentPublication(); /** @var Publication $publication */
+		$author = $publication->getPrimaryAuthor(); /** @var Author $author */
 
 		// try to get credentials for current context otherwise use default config
-        	$contextId = $context->getId();
-		list($username, $password) = $this->getForcedCredentials();
-		if (empty($username) || empty($password)) {
-			$username = $this->getSetting($contextId, 'ithenticateUser');
-			$password = $this->getSetting($contextId, 'ithenticatePass');
-		}
+		list($apiUrl, $apiKey) = $this->hasForcedCredentials()
+			? $this->getForcedCredentials()
+			: [
+				$this->getSetting($context->getId(), 'ithenticateApiUrl'), 
+				$this->getSetting($context->getId(), 'ithenticateApiKey')
+			];
+
+		import("plugins.generic.plagiarism.IThenticate");
 
-		$ithenticate = null;
-		try {
-			$ithenticate = new \bsobbe\ithenticate\Ithenticate($username, $password);
-		} catch (Exception $e) {
-			$this->sendErrorMessage($submission->getId(), $e->getMessage());
+		/** @var \IThenticate $ithenticate */
+		$ithenticate = new IThenticate(
+			$apiUrl,
+			$apiKey,
+			static::PLUGIN_INTEGRATION_NAME,
+			$this->getCurrentVersion()->getData('current')
+		);
+
+		// Try to validate and confirm the EULA on user's behalf
+		if (!$ithenticate->confirmEula($request->getUser(), $context)) {
+			$this->sendErrorMessage($submission->getId(), 'Could not confirm EULA at iThenticate.');
 			return false;
 		}
-		// Make sure there's a group list for this context, creating if necessary.
-		$groupList = $ithenticate->fetchGroupList();
-		$contextName = $context->getLocalizedName($context->getPrimaryLocale());
-		if (!($groupId = array_search($contextName, $groupList))) {
-			// No folder group found for the context; create one.
-			$groupId = $ithenticate->createGroup($contextName);
-			if (!$groupId) {
-				$this->sendErrorMessage($submission->getId(), 'Could not create folder group for context ' . $contextName . ' on iThenticate.');
-				return false;
-			}
+
+		// Create the submission at iThenticate's end
+		$submissionUuid = $ithenticate->submitSubmission($submission, $request->getUser(), $author);
+
+		if (!$submissionUuid) {
+			$this->sendErrorMessage($submission->getId(), 'Could not submit the submission at iThenticate.');
+			return false;
 		}
 
-		// Create a folder for this submission.
-		if (!($folderId = $ithenticate->createFolder(
-			'Submission_' . $submission->getId(),
-			'Submission_' . $submission->getId() . ': ' . $publication->getLocalizedTitle($publication->getData('locale')),
-			$groupId,
-			true,
-			true
-		))) {
-			$this->sendErrorMessage($submission->getId(), 'Could not create folder for submission ID ' . $submission->getId() . ' on iThenticate.');
+		// $submission->setData('ithenticate_id', $submissionUuid);
+		// $submissionDao->updateObject($submission);		
+		Services::get("submission")->edit($submission, [
+			'ithenticate_id' => $submissionUuid,
+		], $request);
+		
+		// Upload submission files for successfully created submission at iThenticate's end
+		if (!$ithenticate->uploadSubmissionFile($submissionUuid, $submission)) {
+			$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate.');
 			return false;
 		}
 
-		$submissionFiles = Services::get('submissionFile')->getMany([
-			'submissionIds' => [$submission->getId()],
-		]);
-
-		$authors = $publication->getData('authors');
-		$author = array_shift($authors);
-		foreach ($submissionFiles as $submissionFile) {
-			$file = Services::get('file')->get($submissionFile->getData('fileId'));
-			if (!$ithenticate->submitDocument(
-				$submissionFile->getLocalizedData('name'),
-				$author->getLocalizedGivenName(),
-				$author->getLocalizedFamilyName(),
-				$submissionFile->getLocalizedData('name'),
-				Services::get('file')->fs->read($file->path),
-				$folderId
-			)) {
-				$this->sendErrorMessage($submission->getId(), 'Could not submit "' . $submissionFile->getData('path') . '" to iThenticate.');
+		// If no webhook previously registered for this Site/Context, register it
+		$webhookStorable = $this->hasForcedCredentials() ? $request->getSite() : $context; /** @var Site|Context $webhookStorable */
+
+		if (!$webhookStorable->getData('ithenticate_webhook_id')) {
+			$signingSecret = \Illuminate\Support\Str::random(12);
+			
+			// http://ojs-stable-3_3_0.test/index.php/test-01/$$$call$$$/plugins/generic/plagiarism/controllers/plagiarism-webhook/handle
+			$webhookUrl = $request->getDispatcher()->url(
+                $request,
+                ROUTE_COMPONENT,
+                $context->getData('urlPath'),
+                'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler',
+                'handle'
+            );
+
+			if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
+				$webhookStorable->setData('ithenticate_webhook_signing_secret', $signingSecret);
+				$webhookStorable->setData('ithenticate_webhook_id', $webhookId);
+				$this->hasForcedCredentials()
+					? $siteDao->updateObject($webhookStorable)
+					: Application::get()->getContextDAO()->updateObject($webhookStorable);
+			} else {
+				error_log("unable to complete the iThenticate webhook registration during the submission process of ID : {$submission->getId()}");
 			}
 		}
 
-		return false;
+		return true;
 	}
 
 	/**
      * @copydoc Plugin::getActions()
      */
-    function getActions($request, $verb) {
+    public function getActions($request, $verb) {
         $router = $request->getRouter();
-        import('lib.pkp.classes.linkAction.request.AjaxModal');
-        return array_merge(
-                $this->getEnabled() ? array(
-            new LinkAction(
-                    'settings',
-                    new AjaxModal(
-                            $router->url($request, null, null, 'manage', null, array('verb' => 'settings', 'plugin' => $this->getName(), 'category' => 'generic')),
-                            $this->getDisplayName()
-                    ),
-                    __('manager.plugins.settings'),
-                    null
-            ),
-                ) : array(),
-                parent::getActions($request, $verb)
+		import('lib.pkp.classes.linkAction.request.AjaxModal');
+        
+		return array_merge(
+			$this->getEnabled() 
+				? [
+					new LinkAction(
+                    	'settings',
+                    	new AjaxModal(
+                            $router->url(
+								$request, 
+								null, 
+								null, 
+								'manage', 
+								null, 
+								['verb' => 'settings', 'plugin' => $this->getName(), 'category' => 'generic']
+							),
+                        	$this->getDisplayName()
+                    	),
+                    	__('manager.plugins.settings'),
+                    	null
+            		),
+				] : [],
+			parent::getActions($request, $verb)
         );
     }
 
     /**
      * @copydoc Plugin::manage()
      */
-    function manage($args, $request) {
+    public function manage($args, $request) {
         switch ($request->getUserVar('verb')) {
             case 'settings':
-                $context = $request->getContext();
+                $context = $request->getContext(); /** @var Context $context */
 
                 AppLocale::requireComponents(LOCALE_COMPONENT_APP_COMMON, LOCALE_COMPONENT_PKP_MANAGER);
-                $templateMgr = TemplateManager::getManager($request);
-                $templateMgr->registerPlugin('function', 'plugin_url', array($this, 'smartyPluginUrl'));
+                $templateMgr = TemplateManager::getManager($request); /** @var TemplateManager $templateMgr */
+                $templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
 
                 $this->import('PlagiarismSettingsForm');
                 $form = new PlagiarismSettingsForm($this, $context->getId());
@@ -224,34 +362,3 @@ function manage($args, $request) {
         return parent::manage($args, $request);
     }
 }
-
-/**
- * Low-budget mock class for \bsobbe\ithenticate\Ithenticate -- Replace the
- * constructor above with this class name to log API usage instead of
- * interacting with the iThenticate service.
- */
-class TestIthenticate {
-	public function __construct($username, $password) {
-		error_log("Constructing iThenticate: $username $password");
-	}
-
-	public function fetchGroupList() {
-		error_log('Fetching iThenticate group list');
-		return array();
-	}
-
-	public function createGroup($group_name) {
-		error_log("Creating group named \"$group_name\"");
-		return 1;
-	}
-
-	public function createFolder($folder_name, $folder_description, $group_id, $exclude_quotes) {
-		error_log("Creating folder:\n\t$folder_name\n\t$folder_description\n\t$group_id\n\t$exclude_quotes");
-		return true;
-	}
-
-	public function submitDocument($essay_title, $author_firstname, $author_lastname, $filename, $document_content, $folder_number) {
-		error_log("Submitting document:\n\t$essay_title\n\t$author_firstname\n\t$author_lastname\n\t$filename\n\t" . strlen($document_content) . " bytes of content\n\t$folder_number");
-		return true;
-	}
-}
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 2284d98..fc8bd60 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -1,13 +1,22 @@
 <?php
 
 import('lib.pkp.classes.form.Form');
+import('plugins.generic.plagiarism.PlagiarismPlugin');
 
 class PlagiarismSettingsForm extends Form {
 
-	/** @var int */
+	/**
+	 * The context id
+	 * 
+	 * @var int
+	 */
 	var $_contextId;
 
-	/** @var object */
+	/**
+	 * The PlagiarismPlugin instance
+	 * 
+	 * @var PlagiarismPlugin
+	 */
 	var $_plugin;
 
 	/**
@@ -21,8 +30,8 @@ function __construct($plugin, $contextId) {
 
 		parent::__construct($plugin->getTemplateResource('settingsForm.tpl'));
                 
-		$this->addCheck(new FormValidator($this, 'ithenticateUser', 'required', 'plugins.generic.plagiarism.manager.settings.usernameRequired'));
-		$this->addCheck(new FormValidator($this, 'ithenticatePass', 'required', 'plugins.generic.plagiarism.manager.settings.passwordRequired'));
+		$this->addCheck(new FormValidator($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlRequired'));
+		$this->addCheck(new FormValidator($this, 'ithenticateApiKey', 'required', 'plugins.generic.plagiarism.manager.settings.apiKeyRequired'));
 
 		$this->addCheck(new FormValidatorPost($this));
 		$this->addCheck(new FormValidatorCSRF($this));
@@ -31,26 +40,25 @@ function __construct($plugin, $contextId) {
 	/**
 	 * Initialize form data.
 	 */
-	function initData() {
-		list($username, $password) = $this->_plugin->getForcedCredentials();
-		$this->_data = array(
-                        'ithenticateUser' => $this->_plugin->getSetting($this->_contextId, 'ithenticateUser'),
-			'ithenticatePass' => $this->_plugin->getSetting($this->_contextId, 'ithenticatePass'),
-			'ithenticateForced' => !empty($username) && !empty($password)
-		);
+	public function initData() {
+		$this->_data = [
+            'ithenticateApiUrl' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiUrl'),
+			'ithenticateApiKey' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiKey'),
+			'ithenticateForced' => $this->_plugin->hasForcedCredentials(),
+		];
 	}
 
 	/**
 	 * Assign form data to user-submitted data.
 	 */
-	function readInputData() {
-                $this->readUserVars(array('ithenticateUser', 'ithenticatePass'));
+	public function readInputData() {
+		$this->readUserVars(['ithenticateApiUrl', 'ithenticateApiKey']);
 	}
 
 	/**
 	 * @copydoc Form::fetch()
 	 */
-	function fetch($request, $template = null, $display = false) {
+	public function fetch($request, $template = null, $display = false) {
 		$templateMgr = TemplateManager::getManager($request);
 		$templateMgr->assign('pluginName', $this->_plugin->getName());
 		return parent::fetch($request, $template, $display);
@@ -59,9 +67,9 @@ function fetch($request, $template = null, $display = false) {
 	/**
 	 * @copydoc Form::execute()
 	 */
-	function execute(...$functionArgs) {
-                $this->_plugin->updateSetting($this->_contextId, 'ithenticateUser', trim($this->getData('ithenticateUser'), "\"\';"), 'string');
-		$this->_plugin->updateSetting($this->_contextId, 'ithenticatePass', trim($this->getData('ithenticatePass'), "\"\';"), 'string');
+	public function execute(...$functionArgs) {
+        $this->_plugin->updateSetting($this->_contextId, 'ithenticateApiUrl', trim($this->getData('ithenticateApiUrl'), "\"\';"), 'string');
+		$this->_plugin->updateSetting($this->_contextId, 'ithenticateApiKey', trim($this->getData('ithenticateApiKey'), "\"\';"), 'string');
 		parent::execute(...$functionArgs);
 	}
 }
diff --git a/README.md b/README.md
index 10adbd7..daf19f4 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
 2. Install the plugin via the Plugin Gallery in the Dashboard
 3. Configure the plugin (see below)
    * Enable the plugin via config.inc.php or in a specific journal/press/preprint context
-   * Configure the plugin with the username and password you get from ithenticate.com
+   * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com
    * ![Example Settings configuration](ithenticate-settings.png)
 4. The author logs in and makes a submission
    * The submission files will be sent to iThenticate in Step 4 of the submission process
@@ -36,19 +36,19 @@ The config.inc.php settings format is:
 [ithenticate]
 
 ; Enable iThenticate to submit manuscripts after submit step 4
-;ithenticate = On
+; ithenticate = On
 
 ; Credentials can be set by context : specify journal path
-; The username to access the API (usually an email address)
-;username[MyJournal_path] = "user@email.com"
-; The password to access the API
-;password[MyJournal_path] = "password"
+; Unique turnitin api url
+; api_url[MyJournal_path] = ""
+; The API key to authorize the api calls
+; api_key[MyJournal_path] = ""
 
-; default credentials
-; The username to access the API (usually an email address)
-;username = "user@email.com"
+; Unique ithenticate api url
+; Make sure to provice the schema(http:// or https://) with the url and no trailing slash
+; api_url = "https://some-ithenticate-account.com"
 
-; The password to access the API
-;password = "password"
+; The API key to authorize the api calls
+; api_key = "YOUR_API_KEY"
 ```
 
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
new file mode 100644
index 0000000..810b3ff
--- /dev/null
+++ b/TestIThenticate.inc.php
@@ -0,0 +1,262 @@
+<?php
+
+/**
+ * @file TestIThenticate.inc.php
+ *
+ * Copyright (c) 2003-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @brief   Low-budget mock class for \IThenticate -- Replace the
+ *          constructor in PlagiarismPlugin::submitForPlagiarismCheck with this class name 
+ *          to log API usage instead of interacting with the iThenticate service.
+ */
+
+class TestIThenticate {
+
+    /**
+     * The EULA(end user license agreement) that user need to confrim before making request
+     * 
+     * @var string|null
+     */
+    protected $eulaVersion = 'v1beta';
+
+    /**
+     * The EULA details for a specific version
+     * 
+     * @var array|null
+     */
+    protected $eualVersionDetails = null;
+
+    /**
+     * The default EULA version placeholder to retrieve the current latest version
+     * 
+     * @var string
+     */
+    public const DEFAULT_EULA_VERSION = 'latest';
+    
+    /**
+     * The default EULA confirming language
+     * 
+     * @var string
+     */
+    public const DEFAULT_EULA_LANGUAGE = 'en-US';
+
+    /**
+     * The default webhook events for which webhook request will be received
+     * @see https://developers.turnitin.com/docs/tca#event-types
+     * 
+     * @var string
+     */
+    public const DEFAULT_WEBHOOK_EVENTS = [
+        'SUBMISSION_COMPLETE',
+        'SIMILARITY_COMPLETE',
+        'SIMILARITY_UPDATED',
+        'PDF_STATUS',
+        'GROUP_ATTACHMENT_COMPLETE',
+    ];
+
+    /**
+     * Create a new instance
+     * 
+     * @param string        $apiUrl
+     * @param string        $apiKey
+     * @param string        $integrationName
+     * @param string        $integrationVersion
+     * @param string|null   eulaVersion
+     */
+    public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
+        error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
+    }
+
+    /**
+     * Confirm the EUAL on the user's behalf for given version
+     * @see https://developers.turnitin.com/docs/tca#accept-eula-version
+     * 
+     * @param User      $user
+     * @param Context   $context
+     * @param string    $version
+     *
+     * @return bool
+     */
+    public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSION) {
+        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEualConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicationEulaVersion()}");
+        return true;
+    }
+    
+    /**
+     * Create a new submission at service's end
+     * @see https://developers.turnitin.com/docs/tca#create-a-submission
+     * 
+     * @param Submission    $submission
+     * @param User          $user
+     * @param Author|null   $author
+     *
+     * @return string|null  if succeed, it will return the created submission UUID at service's end and 
+     *                      at failure, will return null
+     */
+    public function submitSubmission($submission, $user, $author = null) {
+        error_log("Creating a new submission with id {$submission->getId()} by submitter {$user->getId()} for owner {$author->getId()}");
+        return \Illuminate\Support\Str::uuid()->__toString();
+    }
+
+    /**
+     * Upload all submission files to the service's end
+     *
+     * @param string        $submissionTacId The submission UUID return back from service
+     * @param Submission    $submission
+     *
+     * @return bool         If all submission files uploaded successfully, only then it will 
+     *                      return TRUE and return FALSE on a single failure
+     */
+    public function uploadSubmissionFile($submissionTacId, $submission)
+    {
+        error_log("Preparing to start process of uploading file for submission {$submission->getId()} with iThenticate submission UUID {$submissionTacId}");
+
+        $submissionFiles = Services::get('submissionFile')->getMany([
+			'submissionIds' => [$submission->getId()],
+		]);
+        
+        $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
+
+        foreach($submissionFiles as $submissionFile) {
+            $this->uploadFile(
+                $submissionTacId, 
+                $submissionFile->getData("name", $publication->getData("locale")),
+                '',
+            );
+        }
+
+        return true;
+    }
+
+    /**
+     * Upload single submission file to the service's end
+     * @see https://developers.turnitin.com/docs/tca#upload-submission-file-contents
+     *
+     * @param string $submissionTacId The submission UUID return back from service
+     * @param string $fileName
+     * @param mixed  fileContent   
+     *
+     * @return bool
+     */
+    public function uploadFile($submissionTacId, $fileName, $fileContent) {
+        error_log("Uploading submission file named {$fileName} for submission UUID {$submissionTacId}");
+        return true;
+    }
+
+    /**
+     * Verify if user has already confirmed the given EUAL version
+     * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
+     *
+     * @param Author|User   $user
+     * @param string        $version
+     *
+     * @return bool
+     */
+    public function verifyUserEulaAcceptance($user, $version) {
+        error_log("Verifying if user with id {$user->getId()} has already confirmed the given EUAL version {$version}");
+        return true;
+    }
+
+    /**
+     * Validate/Retrieve the given EUAL version
+     * @see https://developers.turnitin.com/docs/tca#get-eula-version-info
+     *
+     * @param string $version
+     * @return bool
+     */
+    public function validateEulaVersion($version) {
+        error_log("Validating/Retrieving the given EUAL version {$version}");
+        return true;
+    }
+
+    /**
+     * Register webhook end point
+     * @see https://developers.turnitin.com/docs/tca#create-webhook
+     *
+     * @param string $signingSecret
+     * @param string $url
+     * @param array  $events
+     * 
+     * @return string|null The UUID of register webhook if succeed or null if failed
+     */
+    public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WEBHOOK_EVENTS) {
+        error_log(
+            sprintf(
+                "Register webhook end point with singing secret : %s, url : %s and events : [%s]",
+                $signingSecret, 
+                $url, 
+                implode(', ',$events)
+            )
+        );
+        return \Illuminate\Support\Str::uuid()->__toString();
+    }
+
+    /**
+     * Get the stored EULA details
+     * 
+     * @return array|null
+     */
+    public function getEualDetails() {
+        return [
+            "version" => "v1beta",
+            "valid_from" => "2018-04-30T17:00:00Z",
+            "valid_until" => null,
+            "url" => "https://static.turnitin.com/eula/v1beta/en-us/eula.html",
+            "available_languages" => [
+              "sv-SE",
+              "zh-CN",
+              "ja-JP",
+              "ko-KR",
+              "es-MX",
+              "nl-NL",
+              "ru-RU",
+              "zh-TW",
+              "ar-SA",
+              "pt-BR",
+              "de-DE",
+              "el-GR",
+              "nb-NO",
+              "cs-CZ",
+              "da-DK",
+              "tr-TR",
+              "pl-PL",
+              "fi-FI",
+              "it-IT",
+              "vi-VN",
+              "fr-FR",
+              "en-US",
+              "ro-RO",
+            ],
+        ];
+    }
+
+    /**
+     * Get the applicable EULA version
+     * 
+     * @return string
+     * @throws \Exception
+     */
+    public function getApplicationEulaVersion() {
+        return $this->eulaVersion;
+    }
+
+    /**
+     * Convert given submission/context locale to service compatible and acceptable locale format
+     * @see https://developers.turnitin.com/docs/tca#eula
+     * 
+     * @param string $locale
+     * @return string
+     */
+    protected function getEualConfirmationLocale($locale) {
+        if (!$this->getEualDetails()) {
+            return static::DEFAULT_EULA_LANGUAGE;
+        }
+
+        $euleLangs = $this->getEualDetails()['available_languages'];
+        $locale = str_replace("_", "-", substr($locale, 0, 5));
+
+        return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+    }
+}
\ No newline at end of file
diff --git a/composer.json b/composer.json
deleted file mode 100644
index 37f1a3a..0000000
--- a/composer.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
-	"require": {
-		"bsobbe/ithenticate": "dev-dependabot/composer/phpxmlrpc/phpxmlrpc-4.9.2",
-		"phpxmlrpc/phpxmlrpc": "^4.9",
-		"cweagans/composer-patches": "^1.7"
-	},
-	"extra": {
-		"patches": {
-			"phpxmlrpc/phpxmlrpc": {
-				"Allow other datetime possibility": "lib/phpxmlrpc-datetime.diff"
-			}
-		}
-	},
-	"config": {
-		"allow-plugins": {
-			"cweagans/composer-patches": true
-		}
-	}
-}
diff --git a/composer.lock b/composer.lock
deleted file mode 100644
index e4d8331..0000000
--- a/composer.lock
+++ /dev/null
@@ -1,177 +0,0 @@
-{
-    "_readme": [
-        "This file locks the dependencies of your project to a known state",
-        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
-        "This file is @generated automatically"
-    ],
-    "content-hash": "1841d3e30deba0c3223aa19c5a18c7b8",
-    "packages": [
-        {
-            "name": "bsobbe/ithenticate",
-            "version": "dev-dependabot/composer/phpxmlrpc/phpxmlrpc-4.9.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/bsobbe/iThenticate.git",
-                "reference": "1266a0435143bc7a627be3a7dda98b690ba6bb47"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/bsobbe/iThenticate/zipball/1266a0435143bc7a627be3a7dda98b690ba6bb47",
-                "reference": "1266a0435143bc7a627be3a7dda98b690ba6bb47",
-                "shasum": ""
-            },
-            "require": {
-                "phpxmlrpc/phpxmlrpc": "4.9.2"
-            },
-            "type": "php-library",
-            "autoload": {
-                "psr-4": {
-                    "bsobbe\\ithenticate\\": ""
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Sobhan Bagheri (A.K.A sobbe)",
-                    "email": "b.sobhanbagheri@gmail.com"
-                }
-            ],
-            "description": "A library to use Ithenticate API easier and faster, to check and prevent plagiarism",
-            "keywords": [
-                "api",
-                "crossref",
-                "ithenticate",
-                "library",
-                "php",
-                "plagiarism",
-                "plagiarism-prevention"
-            ],
-            "support": {
-                "issues": "https://github.com/bsobbe/iThenticate/issues",
-                "source": "https://github.com/bsobbe/iThenticate/tree/dependabot/composer/phpxmlrpc/phpxmlrpc-4.9.2"
-            },
-            "time": "2023-01-11T23:51:36+00:00"
-        },
-        {
-            "name": "cweagans/composer-patches",
-            "version": "1.7.3",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/cweagans/composer-patches.git",
-                "reference": "e190d4466fe2b103a55467dfa83fc2fecfcaf2db"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/cweagans/composer-patches/zipball/e190d4466fe2b103a55467dfa83fc2fecfcaf2db",
-                "reference": "e190d4466fe2b103a55467dfa83fc2fecfcaf2db",
-                "shasum": ""
-            },
-            "require": {
-                "composer-plugin-api": "^1.0 || ^2.0",
-                "php": ">=5.3.0"
-            },
-            "require-dev": {
-                "composer/composer": "~1.0 || ~2.0",
-                "phpunit/phpunit": "~4.6"
-            },
-            "type": "composer-plugin",
-            "extra": {
-                "class": "cweagans\\Composer\\Patches"
-            },
-            "autoload": {
-                "psr-4": {
-                    "cweagans\\Composer\\": "src"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "BSD-3-Clause"
-            ],
-            "authors": [
-                {
-                    "name": "Cameron Eagans",
-                    "email": "me@cweagans.net"
-                }
-            ],
-            "description": "Provides a way to patch Composer packages.",
-            "support": {
-                "issues": "https://github.com/cweagans/composer-patches/issues",
-                "source": "https://github.com/cweagans/composer-patches/tree/1.7.3"
-            },
-            "time": "2022-12-20T22:53:13+00:00"
-        },
-        {
-            "name": "phpxmlrpc/phpxmlrpc",
-            "version": "4.9.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/gggeek/phpxmlrpc.git",
-                "reference": "805d727670b7a7c08c9f129327482f13a4c1ea11"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/gggeek/phpxmlrpc/zipball/805d727670b7a7c08c9f129327482f13a4c1ea11",
-                "reference": "805d727670b7a7c08c9f129327482f13a4c1ea11",
-                "shasum": ""
-            },
-            "require": {
-                "ext-xml": "*",
-                "php": "^5.3.0 || ^7.0 || ^8.0"
-            },
-            "conflict": {
-                "phpxmlrpc/extras": "<= 0.6.3"
-            },
-            "require-dev": {
-                "ext-curl": "*",
-                "ext-dom": "*",
-                "ext-mbstring": "*",
-                "phpunit/phpunit": "^4.8 || ^5.0 || ^8.5.14",
-                "phpunit/phpunit-selenium": "*",
-                "yoast/phpunit-polyfills": "*"
-            },
-            "suggest": {
-                "ext-curl": "Needed for HTTPS and HTTP 1.1 support, NTLM Auth etc...",
-                "ext-mbstring": "Needed to allow reception of requests/responses in character sets other than ASCII,LATIN-1,UTF-8",
-                "ext-zlib": "Needed for sending compressed requests and receiving compressed responses, if cURL is not available",
-                "phpxmlrpc/extras": "Adds more featured Server classes and other useful bits",
-                "phpxmlrpc/jsonrpc": "Adds support for the JSON-RPC protocol"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "PhpXmlRpc\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "BSD-3-Clause"
-            ],
-            "description": "A php library for building xmlrpc clients and servers",
-            "homepage": "https://gggeek.github.io/phpxmlrpc/",
-            "keywords": [
-                "webservices",
-                "xml-rpc",
-                "xmlrpc"
-            ],
-            "support": {
-                "issues": "https://github.com/gggeek/phpxmlrpc/issues",
-                "source": "https://github.com/gggeek/phpxmlrpc/tree/4.9.2"
-            },
-            "time": "2022-12-18T21:47:48+00:00"
-        }
-    ],
-    "packages-dev": [],
-    "aliases": [],
-    "minimum-stability": "stable",
-    "stability-flags": {
-        "bsobbe/ithenticate": 20
-    },
-    "prefer-stable": false,
-    "prefer-lowest": false,
-    "platform": [],
-    "platform-dev": [],
-    "plugin-api-version": "2.3.0"
-}
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
new file mode 100644
index 0000000..e6de97c
--- /dev/null
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -0,0 +1,57 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/controllers/grid/PlagiarismWebhookHandler.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @class PlagiarismWebhookHandler
+ * @ingroup plugins_generic_plagiarism
+ *
+ * @brief Handle the webhook calls for plagiarism check
+ */
+
+import('lib.pkp.classes.handler.PKPHandler');
+
+class PlagiarismWebhookHandler extends PKPHandler {
+
+    /** 
+     * The Plagiarism Plugin itself
+     * 
+     * @var PlagiarismPlugin 
+     */
+	protected static $_plugin;
+
+	/**
+	 * Get the plugin
+     * 
+	 * @return PlagiarismPlugin
+	 */
+	public static function getPlugin() {
+		return static::$_plugin;
+	}
+
+	/**
+	 * Set the Plugin
+     * 
+	 * @param PlagiarismPlugin $plugin
+	 */
+	public static function setPlugin($plugin) {
+		static::$_plugin = $plugin;
+	}
+
+	/**
+	 * Authorize this request.
+	 *
+	 * @return boolean
+	 */
+	public function authorize($request, &$args, $roleAssignments) {
+		return true;
+	}
+
+    public function handle() {
+        error_log('handle webhook request');
+    }
+}
\ No newline at end of file
diff --git a/exclusions.txt b/exclusions.txt
index 805d965..22b55ed 100644
--- a/exclusions.txt
+++ b/exclusions.txt
@@ -1,10 +1 @@
 plagiarism/exclusions.txt
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/demo
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/extras
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/tests
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/doc
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/pakefile.php
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/debugger
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/.gitignore
-plagiarism/vendor/phpxmlrpc/phpxmlrpc/.travis.yml
-plagiarism/vendor/bsobbe/ithenticate/.git
diff --git a/index.php b/index.php
index 024f479..4c2048f 100644
--- a/index.php
+++ b/index.php
@@ -3,8 +3,8 @@
 /**
  * @file index.php
  *
- * Copyright (c) 2003-2021 Simon Fraser University
- * Copyright (c) 2003-2021 John Willinsky
+ * Copyright (c) 2003-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Wrapper for plagiarism checking plugin.
diff --git a/lib/phpxmlrpc-datetime.diff b/lib/phpxmlrpc-datetime.diff
deleted file mode 100644
index aca430e..0000000
--- a/lib/phpxmlrpc-datetime.diff
+++ /dev/null
@@ -1,11 +0,0 @@
---- src/Helper/XMLParser_patched.php    Thu Feb  9 12:12:05 2023
-+++ src/Helper/XMLParser.php    Wed Jan 11 11:15:43 2023
-@@ -431,7 +431,7 @@
-                     if ($name == 'STRING') {
-                         $this->_xh['value'] = $this->_xh['ac'];
-                     } elseif ($name == 'DATETIME.ISO8601') {
--                        if (!preg_match('/^[0-9]{8}T[0-9]{2}:[0-9]{2}:[0-9]{2}$/', $this->_xh['ac'])) {
-+                        if (!preg_match('/^[0-9]{8}T[0-9]{2}:[0-9]{2}:[0-9]{2}$/', $this->_xh['ac']) && !preg_match('/^[0-9\-]{10}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$/', $this->_xh['ac'])) {
-                             Logger::instance()->errorLog('XML-RPC: ' . __METHOD__ . ': invalid value received in DATETIME: ' . $this->_xh['ac']);
-                         }
-                         $this->_xh['vt'] = Value::$xmlrpcDateTime;
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index edf9d1f..ff7c179 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -26,17 +26,17 @@ msgstr ""
 "Settings for the account used to upload submissions to iThenticate. Contact "
 "your iThenticate administrator for details."
 
-msgid "plugins.generic.plagiarism.manager.settings.username"
-msgstr "iThenticate Usename"
+msgid "plugins.generic.plagiarism.manager.settings.apiUrl"
+msgstr "iThenticate API URL"
 
-msgid "plugins.generic.plagiarism.manager.settings.password"
-msgstr "iThenticate Password"
+msgid "plugins.generic.plagiarism.manager.settings.apiKey"
+msgstr "iThenticate API KEY"
 
-msgid "plugins.generic.plagiarism.manager.settings.usernameRequired"
-msgstr "iThenticate Usename is required"
+msgid "plugins.generic.plagiarism.manager.settings.apiUrlRequired"
+msgstr "iThenticate API URL is required"
 
-msgid "plugins.generic.plagiarism.manager.settings.passwordRequired"
-msgstr "iThenticate Password is required"
+msgid "plugins.generic.plagiarism.manager.settings.apiKeyRequired"
+msgstr "iThenticate API KEY is required"
 
 msgid "plugins.generic.plagiarism.manager.settings.areForced"
 msgstr "iThenticate settings were found in config.inc.php and the settings here will not be used."
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 5b212e2..10966c2 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -9,15 +9,19 @@
 	{csrf}
 	{include file="controllers/notification/inPlaceNotification.tpl" notificationId="plagiarismSettingsFormNotification"}
 
-	<div id="description">{translate key="plugins.generic.plagiarism.manager.settings.description"}</div>
+	<div id="description">
+		{translate key="plugins.generic.plagiarism.manager.settings.description"}
+	</div>
+
 	{if $ithenticateForced}
-	<div id="ithenticate_notice"><b>{translate key="plugins.generic.plagiarism.manager.settings.areForced"}</b></div>
+		<div id="ithenticate_notice">
+			<b>{translate key="plugins.generic.plagiarism.manager.settings.areForced"}</b>
+		</div>
 	{/if}
 
 	{fbvFormArea id="webFeedSettingsFormArea"}
-            {fbvElement type="text" id="ithenticateUser" value=$ithenticateUser label="plugins.generic.plagiarism.manager.settings.username"}
-            {fbvElement type="text" id="ithenticatePass" value=$ithenticatePass label="plugins.generic.plagiarism.manager.settings.password" password=true}
-                
+		{fbvElement type="text" id="ithenticateApiUrl" value=$ithenticateApiUrl label="plugins.generic.plagiarism.manager.settings.apiUrl"}
+		{fbvElement type="text" id="ithenticateApiKey" value=$ithenticateApiKey label="plugins.generic.plagiarism.manager.settings.apiKey"}
 	{/fbvFormArea}
 
 	{fbvFormButtons}
diff --git a/version.xml b/version.xml
index ef8f420..5950b4c 100644
--- a/version.xml
+++ b/version.xml
@@ -4,8 +4,8 @@
 <!--
   * version.xml
   *
-  * Copyright (c) 2003-2021 Simon Fraser University
-  * Copyright (c) 2003-2021 John Willinsky
+  * Copyright (c) 2003-2024 Simon Fraser University
+  * Copyright (c) 2003-2024 John Willinsky
   * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
   *
   * Plugin version information.

From b51046e9ca8a8d58e35bb2e8b781710bd981b4d8 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 12 Feb 2024 12:38:19 +0600
Subject: [PATCH 02/75] pkp/plagiarism#52 update based on initial PR review

---
 IThenticate.inc.php      | 41 +++++++++++++++++++++++-----------------
 PlagiarismPlugin.inc.php | 18 ++++++++++++++----
 TestIThenticate.inc.php  | 31 +++++++++++++++---------------
 3 files changed, 54 insertions(+), 36 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 625d886..0162715 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -55,7 +55,7 @@ class IThenticate
      * 
      * @var array|null
      */
-    protected $eualVersionDetails = null;
+    protected $eulaVersionDetails = null;
 
     /**
      * Base API path
@@ -111,7 +111,7 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
     }
 
     /**
-     * Confirm the EUAL on the user's behalf for given version
+     * Confirm the EULA on the user's behalf for given version
      * @see https://developers.turnitin.com/docs/tca#accept-eula-version
      * 
      * @param User      $user
@@ -142,7 +142,7 @@ public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSI
                 'json' => [
                     'user_id' => $user->getId(),
                     'accepted_timestamp' => \Carbon\Carbon::now()->toIso8601String(),
-                    'language' => $this->getEualConfirmationLocale($context->getPrimaryLocale()),
+                    'language' => $this->getEulaConfirmationLocale($context->getPrimaryLocale()),
                 ],
                 'verify' => false,
                 'exceptions' => false,
@@ -159,15 +159,22 @@ public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSI
      * @param Submission    $submission
      * @param User          $user
      * @param Author|null   $author
+     * @param Site|null     $site
      *
      * @return string|null  if succeed, it will return the created submission UUID at service's end and 
      *                      at failure, will return null
      */
-    public function submitSubmission($submission, $user, $author = null) {
+    public function submitSubmission($submission, $user, $author = null, $site = null) {
 
         $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
         $author ??= $publication->getPrimaryAuthor();
 
+        if (!$site) {
+            import('lib.pkp.classes.db.DAORegistry');
+            $siteDao = DAORegistry::getDAO("SiteDAO"); /** @var SiteDAO $siteDao */
+            $site = $siteDao->getSite(); /** @var Site $site */
+        }
+
         $response = Application::get()->getHttpClient()->request(
             'POST',
             $this->getApiPath("submissions"),
@@ -183,15 +190,15 @@ public function submitSubmission($submission, $user, $author = null) {
                         'owners' => [
                             [
                                 'id' => $author->getId(),
-                                'given_name' => $author->getLocalizedGivenName(),
-                                'family_name' => $author->getLocalizedFamilyName(),
+                                'given_name' => $author->getGivenName($publication->getData('locale')) ?? $author->getLocalizedGivenName(),
+                                'family_name' => $author->getGivenName($publication->getData('locale')) ?? $author->getLocalizedFamilyName(),
                                 'email' => $author->getEmail(),
                             ]
                         ],
                         'submitter' => [
                             'id' => $user->getId(),
-                            'given_name' => $user->getLocalizedGivenName(),
-                            'family_name' => $user->getLocalizedFamilyName(),
+                            'given_name' => $user->getGivenName($site->getPrimaryLocale()) ?? $user->getLocalizedGivenName(),
+                            'family_name' => $user->getFamilyName($site->getPrimaryLocale()) ?? $user->getLocalizedFamilyName(),
                             'email' => $user->getEmail(),
                         ],
                         'original_submitted_time' => \Carbon\Carbon::now()->toIso8601String(),
@@ -274,7 +281,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
     }
 
     /**
-     * Verify if user has already confirmed the given EUAL version
+     * Verify if user has already confirmed the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
      *
      * @param Author|User   $user
@@ -297,7 +304,7 @@ public function verifyUserEulaAcceptance($user, $version)
     }
 
     /**
-     * Validate/Retrieve the given EUAL version
+     * Validate/Retrieve the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-version-info
      *
      * @param string $version
@@ -315,10 +322,10 @@ public function validateEulaVersion($version) {
         );
         
         if ($response->getStatusCode() === 200) {
-            $this->eualVersionDetails = json_decode($response->getBody()->getContents(), true);
+            $this->eulaVersionDetails = json_decode($response->getBody()->getContents(), true);
             
             if (!$this->eulaVersion) {
-                $this->eulaVersion = $this->eualVersionDetails['version'];
+                $this->eulaVersion = $this->eulaVersionDetails['version'];
             }
 
             return true;
@@ -370,8 +377,8 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
      * 
      * @return array|null
      */
-    public function getEualDetails() {
-        return $this->eualVersionDetails;
+    public function getEulaDetails() {
+        return $this->eulaVersionDetails;
     }
 
     /**
@@ -395,12 +402,12 @@ public function getApplicationEulaVersion() {
      * @param string $locale
      * @return string
      */
-    protected function getEualConfirmationLocale($locale) {
-        if (!$this->getEualDetails()) {
+    protected function getEulaConfirmationLocale($locale) {
+        if (!$this->getEulaDetails()) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $euleLangs = $this->getEualDetails()['available_languages'];
+        $euleLangs = $this->getEulaDetails()['available_languages'];
         $locale = str_replace("_", "-", substr($locale, 0, 5));
 
         return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 5101554..85d8b9f 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -11,6 +11,7 @@
  */
 
 import('lib.pkp.classes.plugins.GenericPlugin');
+import('lib.pkp.classes.db.DAORegistry');
 
 class PlagiarismPlugin extends GenericPlugin {
 
@@ -83,7 +84,7 @@ public function getEnabled($contextId = null) {
 	 * @param string $hookName `Schema::get::submission`
 	 * @param array $params
 	 * 
-	 * @return void
+	 * @return bool
 	 */
 	public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 		$schema =& $params[0];
@@ -94,6 +95,8 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
+
+		return false;
 	}
 
 	/**
@@ -103,7 +106,7 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 	 * @param string $hookName `Schema::get::context` or `Schema::get::site`
 	 * @param array $params
 	 * 
-	 * @return void
+	 * @return bool
 	 */
 	public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
 		$schema =& $params[0];
@@ -121,6 +124,8 @@ public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
+
+		return false;
 	}
 
 	/**
@@ -254,7 +259,12 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		}
 
 		// Create the submission at iThenticate's end
-		$submissionUuid = $ithenticate->submitSubmission($submission, $request->getUser(), $author);
+		$submissionUuid = $ithenticate->submitSubmission(
+			$submission,
+			$request->getUser(),
+			$author,
+			$request->getSite()
+		);
 
 		if (!$submissionUuid) {
 			$this->sendErrorMessage($submission->getId(), 'Could not submit the submission at iThenticate.');
@@ -263,6 +273,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 
 		// $submission->setData('ithenticate_id', $submissionUuid);
 		// $submissionDao->updateObject($submission);		
+		import('classes.core.Services');
 		Services::get("submission")->edit($submission, [
 			'ithenticate_id' => $submissionUuid,
 		], $request);
@@ -279,7 +290,6 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		if (!$webhookStorable->getData('ithenticate_webhook_id')) {
 			$signingSecret = \Illuminate\Support\Str::random(12);
 			
-			// http://ojs-stable-3_3_0.test/index.php/test-01/$$$call$$$/plugins/generic/plagiarism/controllers/plagiarism-webhook/handle
 			$webhookUrl = $request->getDispatcher()->url(
                 $request,
                 ROUTE_COMPONENT,
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 810b3ff..eff5b82 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -8,8 +8,8 @@
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief   Low-budget mock class for \IThenticate -- Replace the
- *          constructor in PlagiarismPlugin::submitForPlagiarismCheck with this class name 
- *          to log API usage instead of interacting with the iThenticate service.
+ *          constructor and import in PlagiarismPlugin::submitForPlagiarismCheck with  
+ *          this class name to log API usage instead of interacting with the iThenticate service.
  */
 
 class TestIThenticate {
@@ -26,7 +26,7 @@ class TestIThenticate {
      * 
      * @var array|null
      */
-    protected $eualVersionDetails = null;
+    protected $eulaVersionDetails = null;
 
     /**
      * The default EULA version placeholder to retrieve the current latest version
@@ -70,7 +70,7 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
     }
 
     /**
-     * Confirm the EUAL on the user's behalf for given version
+     * Confirm the EULA on the user's behalf for given version
      * @see https://developers.turnitin.com/docs/tca#accept-eula-version
      * 
      * @param User      $user
@@ -80,7 +80,7 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
      * @return bool
      */
     public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSION) {
-        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEualConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicationEulaVersion()}");
+        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEulaConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicationEulaVersion()}");
         return true;
     }
     
@@ -91,11 +91,12 @@ public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSI
      * @param Submission    $submission
      * @param User          $user
      * @param Author|null   $author
+     * @param Site|null     $site
      *
      * @return string|null  if succeed, it will return the created submission UUID at service's end and 
      *                      at failure, will return null
      */
-    public function submitSubmission($submission, $user, $author = null) {
+    public function submitSubmission($submission, $user, $author = null, $site = null) {
         error_log("Creating a new submission with id {$submission->getId()} by submitter {$user->getId()} for owner {$author->getId()}");
         return \Illuminate\Support\Str::uuid()->__toString();
     }
@@ -146,7 +147,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
     }
 
     /**
-     * Verify if user has already confirmed the given EUAL version
+     * Verify if user has already confirmed the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
      *
      * @param Author|User   $user
@@ -155,19 +156,19 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
      * @return bool
      */
     public function verifyUserEulaAcceptance($user, $version) {
-        error_log("Verifying if user with id {$user->getId()} has already confirmed the given EUAL version {$version}");
+        error_log("Verifying if user with id {$user->getId()} has already confirmed the given EULA version {$version}");
         return true;
     }
 
     /**
-     * Validate/Retrieve the given EUAL version
+     * Validate/Retrieve the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-version-info
      *
      * @param string $version
      * @return bool
      */
     public function validateEulaVersion($version) {
-        error_log("Validating/Retrieving the given EUAL version {$version}");
+        error_log("Validating/Retrieving the given EULA version {$version}");
         return true;
     }
 
@@ -198,7 +199,7 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
      * 
      * @return array|null
      */
-    public function getEualDetails() {
+    public function getEulaDetails() {
         return [
             "version" => "v1beta",
             "valid_from" => "2018-04-30T17:00:00Z",
@@ -249,14 +250,14 @@ public function getApplicationEulaVersion() {
      * @param string $locale
      * @return string
      */
-    protected function getEualConfirmationLocale($locale) {
-        if (!$this->getEualDetails()) {
+    protected function getEulaConfirmationLocale($locale) {
+        if (!$this->getEulaDetails()) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $euleLangs = $this->getEualDetails()['available_languages'];
+        $euleLangs = $this->getEulaDetails()['available_languages'];
         $locale = str_replace("_", "-", substr($locale, 0, 5));
 
         return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
     }
-}
\ No newline at end of file
+}

From ae26048ff1bd92ed6ad4f840b9d62fdc5657d56f Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 12 Feb 2024 12:41:08 +0600
Subject: [PATCH 03/75] pkp/plagiarism#52 added class doc block for Plagiarism
 Settings Form class

---
 PlagiarismSettingsForm.inc.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index fc8bd60..f0a1712 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -1,5 +1,15 @@
 <?php
 
+/**
+ * @file PlagiarismSettingsForm.inc.php
+ *
+ * Copyright (c) 2003-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @brief Plagiarism settings form
+ */
+
 import('lib.pkp.classes.form.Form');
 import('plugins.generic.plagiarism.PlagiarismPlugin');
 

From 7e17e22fad7ea19f29ba75bd30d03bbc75e61818 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 14 Feb 2024 15:33:14 +0600
Subject: [PATCH 04/75] pkp/plagiarism#52 fixed issue override issue

---
 PlagiarismPlugin.inc.php | 47 +++++++++++++++-------------------------
 1 file changed, 17 insertions(+), 30 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 85d8b9f..02f66da 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -10,6 +10,8 @@
  * @brief Plagiarism plugin
  */
 
+use Symfony\Component\VarDumper\Caster\ArgsStub;
+
 import('lib.pkp.classes.plugins.GenericPlugin');
 import('lib.pkp.classes.db.DAORegistry');
 
@@ -30,13 +32,8 @@ public function register($category, $path, $mainContextId = null) {
 		}
 
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
-
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
-		HookRegistry::register("Schema::get::{$submissionDao->schemaName}", [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
-
-		$schemaName = $this->hasForcedCredentials() ? SCHEMA_SITE : Application::get()->getContextDAO()->schemaName;
-		HookRegistry::register("Schema::get::{$schemaName}", [$this, 'addPlagiarismCheckWebhookDataToSchema']);
-
+		HookRegistry::register("Schema::get::" . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
+		HookRegistry::register("Schema::get::" . SCHEMA_CONTEXT, [$this, 'addPlagiarismCheckWebhookDataToSchema']);
 		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
 
 		return $success;
@@ -100,10 +97,10 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 	}
 
 	/**
-	 * Add properties for this type of public identifier to the site/context entity's list for
+	 * Add properties for this type of public identifier to the context entity's list for
 	 * storage in the database.
 	 * 
-	 * @param string $hookName `Schema::get::context` or `Schema::get::site`
+	 * @param string $hookName `Schema::get::context`
 	 * @param array $params
 	 * 
 	 * @return bool
@@ -200,8 +197,8 @@ public function sendErrorMessage($submissionId, $message) {
 	/**
 	 * Setup the handler for webhook request
 	 * 
-	 * @param string $hookName
-	 * @param array $args
+	 * @param string $hookName `LoadComponentHandler`
+	 * @param array $params
 	 * 
 	 * @return bool
 	 */
@@ -220,17 +217,16 @@ public function setupWebhookHandler($hookName, $params) {
 	/**
 	 * Confirm EULA, create submission and upload submission files to iThenticate service
 	 * 
-	 * @param string $hookName
+	 * @param string $hookName `submissionsubmitstep4form::execute`
 	 * @param array $args
 	 * 
 	 * @return bool
 	 */
 	public function submitForPlagiarismCheck($hookName, $args) {
 		$request = Application::get()->getRequest(); /** @var Request $request */
+		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
+		$submission = $form->submission; /** @var Submission $submission */
 		$context = $request->getContext(); /** @var Context $context */
-		$siteDao = DAORegistry::getDAO('SiteDAO'); /** @var SiteDAO $siteDao */
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
-		$submission = $submissionDao->getById($request->getUserVar('submissionId')); /** @var Submission $submission */
 		$publication = $submission->getCurrentPublication(); /** @var Publication $publication */
 		$author = $publication->getPrimaryAuthor(); /** @var Author $author */
 
@@ -271,12 +267,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			return false;
 		}
 
-		// $submission->setData('ithenticate_id', $submissionUuid);
-		// $submissionDao->updateObject($submission);		
-		import('classes.core.Services');
-		Services::get("submission")->edit($submission, [
-			'ithenticate_id' => $submissionUuid,
-		], $request);
+		$submission->setData('ithenticate_id', $submissionUuid);
 		
 		// Upload submission files for successfully created submission at iThenticate's end
 		if (!$ithenticate->uploadSubmissionFile($submissionUuid, $submission)) {
@@ -284,10 +275,8 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			return false;
 		}
 
-		// If no webhook previously registered for this Site/Context, register it
-		$webhookStorable = $this->hasForcedCredentials() ? $request->getSite() : $context; /** @var Site|Context $webhookStorable */
-
-		if (!$webhookStorable->getData('ithenticate_webhook_id')) {
+		// If no webhook previously registered for this Context, register it
+		if (!$context->getData('ithenticate_webhook_id')) {
 			$signingSecret = \Illuminate\Support\Str::random(12);
 			
 			$webhookUrl = $request->getDispatcher()->url(
@@ -299,11 +288,9 @@ public function submitForPlagiarismCheck($hookName, $args) {
             );
 
 			if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
-				$webhookStorable->setData('ithenticate_webhook_signing_secret', $signingSecret);
-				$webhookStorable->setData('ithenticate_webhook_id', $webhookId);
-				$this->hasForcedCredentials()
-					? $siteDao->updateObject($webhookStorable)
-					: Application::get()->getContextDAO()->updateObject($webhookStorable);
+				$context->setData('ithenticate_webhook_signing_secret', $signingSecret);
+				$context->setData('ithenticate_webhook_id', $webhookId);
+				Application::get()->getContextDAO()->updateObject($context);
 			} else {
 				error_log("unable to complete the iThenticate webhook registration during the submission process of ID : {$submission->getId()}");
 			}

From 26cb1d28efb57a8a5dd6fd14e7544e4fa3933268 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 27 Feb 2024 13:02:32 +0600
Subject: [PATCH 05/75] pkp/plagiarism#52 added eula handling and stamping to
 submission and submitter

---
 IThenticate.inc.php                           |  92 ++++--
 PlagiarismPlugin.inc.php                      | 306 ++++++++++++++++--
 PlagiarismSettingsForm.inc.php                |  35 +-
 README.md                                     |   1 -
 TestIThenticate.inc.php                       |  59 +++-
 .../FormValidatorIthenticateAccess.inc.php    |  37 +++
 .../ValidatorIthenticateAccess.inc.php        |  37 +++
 controllers/PlagiarismWebhookHandler.inc.php  |  21 +-
 locale/en_US/locale.po                        |  13 +
 locale/fr_CA/locale.po                        |   3 +
 10 files changed, 529 insertions(+), 75 deletions(-)
 create mode 100644 classes/form/validation/FormValidatorIthenticateAccess.inc.php
 create mode 100644 classes/validation/ValidatorIthenticateAccess.inc.php

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 0162715..9f9d4ad 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -59,7 +59,7 @@ class IThenticate
 
     /**
      * Base API path
-     * The string `API_URL` need to be replaced with provided api url to generarte fully qualified base url
+     * The string `API_URL` need to be replaced with provided api url to generate fully qualified base url
      * 
      * @var string
      */
@@ -83,7 +83,7 @@ class IThenticate
      * The default webhook events for which webhook request will be received
      * @see https://developers.turnitin.com/docs/tca#event-types
      * 
-     * @var string
+     * @var array
      */
     public const DEFAULT_WEBHOOK_EVENTS = [
         'SUBMISSION_COMPLETE',
@@ -110,31 +110,49 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
         $this->eulaVersion          = $eulaVersion;
     }
 
+    /**
+     * Validate the service access by retrieving the the enabled feature
+     * @see https://developers.turnitin.com/docs/tca#get-features-enabled
+     * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
+     * 
+     * @return bool
+     */
+    public function validateAccess() {
+
+        try {
+            $response = Application::get()->getHttpClient()->request(
+                'GET',
+                $this->getApiPath("features-enabled"),
+                [
+                    'headers' => $this->getRequiredHeaders(),
+                    'verify' => false,
+                    'exceptions' => false,
+                    'http_errors' => false,
+                ]
+            );
+        } catch (\GuzzleHttp\Exception\ConnectException $exception) {
+            return false;
+        } catch (\Throwable $exception) {
+            throw $exception;
+        }
+
+        return $response->getStatusCode() === 200;
+    }
+
     /**
      * Confirm the EULA on the user's behalf for given version
      * @see https://developers.turnitin.com/docs/tca#accept-eula-version
      * 
      * @param User      $user
      * @param Context   $context
-     * @param string    $version
      *
      * @return bool
      */
-    public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSION) {
-        
-        // Validate the EULA version
-        if (!$this->validateEulaVersion($this->eulaVersion ?? $version)) {
-            return false;
-        }
-
-        // if user has already accepted/confirm this EULA, no need to go further to reconfirm
-        if ($this->verifyUserEulaAcceptance($user, $this->getApplicationEulaVersion())) {
-            return true;
-        }
+    public function confirmEula($user, $context) {
         
         $response = Application::get()->getHttpClient()->request(
             'POST',
-            $this->getApiPath("eula/{$this->getApplicationEulaVersion()}/accept"),
+            $this->getApiPath("eula/{$this->getApplicableEulaVersion()}/accept"),
             [
                 'headers' => array_merge($this->getRequiredHeaders(), [
                     'Content-Type' => 'application/json'
@@ -190,15 +208,15 @@ public function submitSubmission($submission, $user, $author = null, $site = nul
                         'owners' => [
                             [
                                 'id' => $author->getId(),
-                                'given_name' => $author->getGivenName($publication->getData('locale')) ?? $author->getLocalizedGivenName(),
-                                'family_name' => $author->getGivenName($publication->getData('locale')) ?? $author->getLocalizedFamilyName(),
+                                'given_name' => $author->getGivenName($publication->getData('locale')),
+                                'family_name' => $author->getFamilyName($publication->getData('locale')),
                                 'email' => $author->getEmail(),
                             ]
                         ],
                         'submitter' => [
                             'id' => $user->getId(),
-                            'given_name' => $user->getGivenName($site->getPrimaryLocale()) ?? $user->getLocalizedGivenName(),
-                            'family_name' => $user->getFamilyName($site->getPrimaryLocale()) ?? $user->getLocalizedFamilyName(),
+                            'given_name' => $user->getGivenName($site->getPrimaryLocale()),
+                            'family_name' => $user->getFamilyName($site->getPrimaryLocale()),
                             'email' => $user->getEmail(),
                         ],
                         'original_submitted_time' => \Carbon\Carbon::now()->toIso8601String(),
@@ -230,7 +248,7 @@ public function submitSubmission($submission, $user, $author = null, $site = nul
     public function uploadSubmissionFile($submissionTacId, $submission)
     {
         $submissionFiles = Services::get('submissionFile')->getMany([
-			'submissionIds' => [$submission->getId()],
+            'submissionIds' => [$submission->getId()],
 		]);
         
         $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
@@ -387,7 +405,7 @@ public function getEulaDetails() {
      * @return string
      * @throws \Exception
      */
-    public function getApplicationEulaVersion() {
+    public function getApplicableEulaVersion() {
         if (!$this->eulaVersion) {
             throw new \Exception('No EULA version set yet');
         }
@@ -395,6 +413,38 @@ public function getApplicationEulaVersion() {
         return $this->eulaVersion;
     }
 
+    /**
+     * Set the applicable EULA version
+     * 
+     * @param string $version
+     * @return self
+     */
+    public function setApplicableEulaVersion($version) {
+        $this->eulaVersion = $version;
+
+        return $this;
+    }
+
+    /**
+     * Get the applicable EULA Url
+     * 
+     * @param  string|null $locale
+     * @return string
+     * 
+     * @throws \Exception
+     */
+    public function getApplicableEulaUrl($locale = null) {
+        if (!$this->eulaVersion) {
+            throw new \Exception('No EULA version set yet');
+        }
+
+        $applicableEulaLanguage = $this->getEulaConfirmationLocale($locale ?? static::DEFAULT_EULA_LANGUAGE);
+
+        $eulaUrl = $this->eulaVersionDetails['url'];
+
+        return str_replace(static::DEFAULT_EULA_LANGUAGE, $applicableEulaLanguage, $eulaUrl);
+    }
+
     /**
      * Convert given submission/context locale to service compatible and acceptable locale format
      * @see https://developers.turnitin.com/docs/tca#eula
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 02f66da..4a79fd6 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -10,15 +10,27 @@
  * @brief Plagiarism plugin
  */
 
-use Symfony\Component\VarDumper\Caster\ArgsStub;
-
 import('lib.pkp.classes.plugins.GenericPlugin');
 import('lib.pkp.classes.db.DAORegistry');
 
 class PlagiarismPlugin extends GenericPlugin {
 
+	/**
+	 * Specify a default integration name for iThenticate service
+	 */
 	public const PLUGIN_INTEGRATION_NAME = 'Plagiarism plugin for OJS/OMP/OPS';
 
+	/**
+	 * Number of seconds EULA details for a context should be cached before refreshing it
+	 */
+	public const EULA_CACHE_LIFETIME = 60 * 60 * 24;
+
+	/**
+	 * Set the value to `true` to enable test mode that will log instead of interacting with 
+	 * iThenticate API service.
+	 */
+	protected const ITHENTICATE_TEST_MODE_ENABLE = false;
+
 	/**
 	 * @copydoc Plugin::register()
 	 */
@@ -31,9 +43,16 @@ public function register($category, $path, $mainContextId = null) {
 			return false;	
 		}
 
+		// Need to register both of TemplateManager display and fetch hook as both of these
+		// get called when presenting the submission 
+		HookRegistry::register('TemplateManager::display', [$this, 'addEulaToChecklist']);
+		HookRegistry::register('TemplateManager::fetch', [$this, 'addEulaToChecklist']);
+
+		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmission']);
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
-		HookRegistry::register("Schema::get::" . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
-		HookRegistry::register("Schema::get::" . SCHEMA_CONTEXT, [$this, 'addPlagiarismCheckWebhookDataToSchema']);
+		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
+		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addPlagiarismCheckWebhookDataToSchema']);
+		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
 		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
 
 		return $success;
@@ -74,6 +93,40 @@ public function getEnabled($contextId = null) {
 		return parent::getEnabled($contextId) || Config::getVar('ithenticate', 'ithenticate');
 	}
 
+	/**
+	 * Add the IThenticate EULA url as a checklist of submission process
+	 * 
+	 * @param string $hookName `TemplateManager::display` or `TemplateManager::fetch`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function addEulaToChecklist($hookName, $params) {
+		$templateManager = & $params[0]; /** @var TemplateManager $templateManager */
+		$context = $templateManager->getTemplateVars('currentContext'); /** @var Context $context */
+		
+		if (!$context || strtolower($templateManager->getTemplateVars('requestedPage') ?? '') !== 'submission') {
+			return false;
+		}
+
+		$eualDetails = $this->getContextEulaDetails($context);
+		
+		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
+			array_push($checklist, [
+				'order' => (collect($checklist)->pluck('order')->sort(SORT_REGULAR)->last() ?? 0) + 1,
+				'content' => __('plugins.generic.plagiarism.submission.checklist.eula', [
+					'localizedEulaUrl' => $eualDetails[$locale]['url']
+				]),
+			]);
+
+			$context->setData('submissionChecklist', $checklist, $locale);
+		}
+
+		$templateManager->assign('currentContext', $context);
+		
+		return false;
+	}
+
 	/**
 	 * Add properties for this type of public identifier to the submission entity's list for
 	 * storage in the database.
@@ -93,6 +146,20 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 			'validation' => ['nullable'],
 		];
 
+		$schema->properties->ithenticate_eula_version = (object) [
+			'type' => 'string',
+			'description' => 'The iThenticate EULA version which has been agreed at submission checklist',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+
+		$schema->properties->ithenticate_eula_url = (object) [
+			'type' => 'string',
+			'description' => 'The iThenticate EULA url which has been agreen at submission checklist',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+
 		return false;
 	}
 
@@ -125,6 +192,24 @@ public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
 		return false;
 	}
 
+	/**
+	 * Add additional fields for users to stamp EULA details
+	 * 
+	 * @param string $hookName `userdao::getAdditionalFieldNames`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
+
+		$fields =& $params[1];
+
+		$fields[] = 'ithenticateEulaVersion';
+		$fields[] = 'ithenticateEulaConfirmedAt';
+
+		return false;
+	}
+
 	/**
 	 * Fetch credentials from config.inc.php, if available
 	 * 
@@ -214,6 +299,31 @@ public function setupWebhookHandler($hookName, $params) {
 		return false;
 	}
 
+	/**
+	 * Stamp the iThenticate EULA with the submission
+	 * 
+	 * @param string $hookName `Submission::add`
+	 * @param array $args
+	 * 
+	 * @return bool
+	 */
+	public function stampEulaToSubmission($hookName, $args) {
+		$submission =& $args[0]; /** @var Submission $submission */
+
+		$eualDetails = $this->getContextEulaDetails(
+			Application::get()->getRequest()->getContext(), 
+			$submission->getData('locale')
+		);
+
+		$submission->setData('ithenticate_eula_version', $eualDetails['version']);
+		$submission->setData('ithenticate_eula_url', $eualDetails['url']);
+
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submissionDao->updateObject($submission);
+
+		return false;
+	}
+
 	/**
 	 * Confirm EULA, create submission and upload submission files to iThenticate service
 	 * 
@@ -223,41 +333,43 @@ public function setupWebhookHandler($hookName, $params) {
 	 * @return bool
 	 */
 	public function submitForPlagiarismCheck($hookName, $args) {
-		$request = Application::get()->getRequest(); /** @var Request $request */
+		$request = Application::get()->getRequest();
 		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
-		$context = $request->getContext(); /** @var Context $context */
-		$publication = $submission->getCurrentPublication(); /** @var Publication $publication */
-		$author = $publication->getPrimaryAuthor(); /** @var Author $author */
-
-		// try to get credentials for current context otherwise use default config
-		list($apiUrl, $apiKey) = $this->hasForcedCredentials()
-			? $this->getForcedCredentials()
-			: [
-				$this->getSetting($context->getId(), 'ithenticateApiUrl'), 
-				$this->getSetting($context->getId(), 'ithenticateApiKey')
-			];
-
-		import("plugins.generic.plagiarism.IThenticate");
-
-		/** @var \IThenticate $ithenticate */
-		$ithenticate = new IThenticate(
-			$apiUrl,
-			$apiKey,
-			static::PLUGIN_INTEGRATION_NAME,
-			$this->getCurrentVersion()->getData('current')
-		);
-
-		// Try to validate and confirm the EULA on user's behalf
-		if (!$ithenticate->confirmEula($request->getUser(), $context)) {
-			$this->sendErrorMessage($submission->getId(), 'Could not confirm EULA at iThenticate.');
+		$context = $request->getContext();
+		$publication = $submission->getCurrentPublication();
+		$author = $publication->getPrimaryAuthor();
+		$user = $request->getUser();
+
+		// if EULA details not stamped to submission, not going to sent it for plagiarism check
+		if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
+			$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
 			return false;
 		}
 
+		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
+		
+		// Check if EULA stamped to submitter and if not, try to stamp it
+		if (!$user->getData('ithenticateEulaVersion') ||
+			$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
+			
+			// Check if user has ever already accepted this EULA version and if so, stamp it to user
+			// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
+			if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
+				$ithenticate->confirmEula($user, $context)) {
+				$this->stampEualVersionToSubmittingUser($user, $submissionEulaVersion);
+			} else {
+				$this->sendErrorMessage($submission->getId(), 'Unable to stamp the EULA details to submission submitter');
+				return false;
+			}
+		}
+
 		// Create the submission at iThenticate's end
 		$submissionUuid = $ithenticate->submitSubmission(
 			$submission,
-			$request->getUser(),
+			$user,
 			$author,
 			$request->getSite()
 		);
@@ -356,6 +468,138 @@ public function manage($args, $request) {
                 }
                 return new JSONMessage(true, $form->fetch($request));
         }
+
         return parent::manage($args, $request);
     }
+
+	/**
+	 * Get the cached EULA details form Context
+	 * 
+	 * @param Context 		$context
+	 * @param string|null 	$locale
+	 * 
+	 * @return array
+	 */
+	public function getContextEulaDetails($context, $locale = null) {
+		/** @var \FileCache $cache */
+		$cache = CacheManager::getManager()
+			->getCache(
+				'ithenticate_eula', 
+				"CONTEXT_ID_{$context->getId()}",
+				[$this, 'retrieveApplicableEulaDetails']
+			);
+		
+		if (time() - $cache->getCacheTime() > static::EULA_CACHE_LIFETIME) {
+			$cache->flush();
+		}
+
+		$eulaDetails = $cache->get("CONTEXT_ID_{$context->getId()}");
+
+		return $locale ? $eulaDetails[$locale] : $eulaDetails;
+	}
+
+	/**
+	 * Retrived and generate the localized EULA details for given context 
+	 * and cache it in following format
+	 * [
+	 *   'en_US' => [
+	 *     'version' => '',
+	 *     'url' => '',
+	 *   ],
+	 *   ...
+	 * ]
+	 * 
+	 * @param GenericCache 	$cache
+	 * @param mixed 		$cacheId
+	 * 
+	 * @return array
+	 */
+	public function retrieveApplicableEulaDetails($cache, $cacheId) {
+		$context = Application::get()->getRequest()->getContext();
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$eualDetails = [];
+		
+		if ($ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION)) {
+			foreach($context->getSupportedSubmissionLocaleNames() as $localeKey => $localeName) {
+				$eualDetails[$localeKey] = [
+					'version' 	=> $ithenticate->getApplicableEulaVersion(),
+					'url' 		=> $ithenticate->getApplicableEulaUrl($localeKey),
+				];
+			}
+		}
+
+		$cache->setEntireCache([$cacheId => $eualDetails]);
+
+		return $eualDetails;
+	}
+
+	/**
+	 * Create and return an instance of service class responsible to handle the
+	 * communication with iThenticate service.
+	 * 
+	 * If const `ITHENTICATE_TEST_MODE_ENABLE` set to true, it will return an
+	 * instance of mock class `TestIThenticate` instead of actual commucation
+	 * responsible class.
+	 * 
+	 * @param string $apiUrl
+	 * @param string $apiKey
+	 * 
+	 * @return \IThenticate|\TestIThenticate
+	 */
+	public function initIthenticate($apiUrl, $apiKey) {
+
+		if (static::ITHENTICATE_TEST_MODE_ENABLE) {
+			import("plugins.generic.plagiarism.TestIThenticate");
+			return new \TestIThenticate(
+				$apiUrl,
+				$apiKey,
+				static::PLUGIN_INTEGRATION_NAME,
+				$this->getCurrentVersion()->getData('current')
+			);
+		}
+
+		import("plugins.generic.plagiarism.IThenticate");
+
+		return new \IThenticate(
+			$apiUrl,
+			$apiKey,
+			static::PLUGIN_INTEGRATION_NAME,
+			$this->getCurrentVersion()->getData('current')
+		);
+	}
+
+	/**
+	 * Get the ithenticate service access as array in format [API_URL, API_KEY]
+	 * 
+	 * @param Context $context
+	 * @return array
+	 */
+	protected function getServiceAccess($context) {
+		// try to get credentials for current context otherwise use default config
+		list($apiUrl, $apiKey) = $this->hasForcedCredentials()
+			? $this->getForcedCredentials()
+			: [
+				$this->getSetting($context->getId(), 'ithenticateApiUrl'), 
+				$this->getSetting($context->getId(), 'ithenticateApiKey')
+			];
+		
+		return [$apiUrl, $apiKey];
+	}
+
+	/**
+	 * Stamp the EULA version and confirmation datetime for submitting user
+	 * 
+	 * @param User 		$user
+	 * @param string 	$version
+	 * 
+	 * @return void
+	 */
+	protected function stampEualVersionToSubmittingUser($user, $version) {
+		$userDao = DAORegistry::getDAO('UserDAO'); /** @var UserDAO $userDao */
+
+		$user->setData('ithenticateEulaVersion', $version);
+		$user->setData('ithenticateEulaConfirmedAt', Core::getCurrentDate());
+
+		$userDao->updateObject($user);
+	}
 }
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index f0a1712..95df0fb 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -12,6 +12,7 @@
 
 import('lib.pkp.classes.form.Form');
 import('plugins.generic.plagiarism.PlagiarismPlugin');
+import('plugins.generic.plagiarism.classes.form.validation.FormValidatorIthenticateAccess');
 
 class PlagiarismSettingsForm extends Form {
 
@@ -31,17 +32,19 @@ class PlagiarismSettingsForm extends Form {
 
 	/**
 	 * Constructor
-	 * @param $plugin PlagiarismPlugin
-	 * @param $contextId int
+	 * 
+	 * @param PlagiarismPlugin 	$plugin
+	 * @param int 				$contextId
 	 */
-	function __construct($plugin, $contextId) {
-		$this->_contextId = $contextId;
+	public function __construct($plugin, $contextId) {
 		$this->_plugin = $plugin;
+		$this->_contextId = $contextId;
 
 		parent::__construct($plugin->getTemplateResource('settingsForm.tpl'));
-                
+
 		$this->addCheck(new FormValidator($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlRequired'));
 		$this->addCheck(new FormValidator($this, 'ithenticateApiKey', 'required', 'plugins.generic.plagiarism.manager.settings.apiKeyRequired'));
+		$this->addCheck(new FormValidatorUrl($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlInvalid'));
 
 		$this->addCheck(new FormValidatorPost($this));
 		$this->addCheck(new FormValidatorCSRF($this));
@@ -52,7 +55,7 @@ function __construct($plugin, $contextId) {
 	 */
 	public function initData() {
 		$this->_data = [
-            'ithenticateApiUrl' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiUrl'),
+			'ithenticateApiUrl' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiUrl'),
 			'ithenticateApiKey' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiKey'),
 			'ithenticateForced' => $this->_plugin->hasForcedCredentials(),
 		];
@@ -74,6 +77,26 @@ public function fetch($request, $template = null, $display = false) {
 		return parent::fetch($request, $template, $display);
 	}
 
+	/**
+	 * @copydoc Form::validate()
+	 */
+	public function validate($callHooks = true) {
+		$this->addCheck(
+			new FormValidatorIthenticateAccess(
+				$this,
+				'',
+				'required',
+				'plugins.generic.plagiarism.manager.settings.serviceAccessInvalid',
+				$this->_plugin->initIthenticate(
+					$this->getData('ithenticateApiUrl'),
+					$this->getData('ithenticateApiKey')
+				)
+			)
+		);
+
+		return parent::validate($callHooks);
+	}
+
 	/**
 	 * @copydoc Form::execute()
 	 */
diff --git a/README.md b/README.md
index daf19f4..f6421c4 100644
--- a/README.md
+++ b/README.md
@@ -51,4 +51,3 @@ The config.inc.php settings format is:
 ; The API key to authorize the api calls
 ; api_key = "YOUR_API_KEY"
 ```
-
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index eff5b82..0dc3823 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -7,9 +7,9 @@
  * Copyright (c) 2003-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
- * @brief   Low-budget mock class for \IThenticate -- Replace the
- *          constructor and import in PlagiarismPlugin::submitForPlagiarismCheck with  
- *          this class name to log API usage instead of interacting with the iThenticate service.
+ * @brief   Low-budget mock class for \IThenticate -- set the const `ITHENTICATE_TEST_MODE_ENABLE`
+ *          value in the `PlagiarismPlugin` class to `true` to log API usage instead of 
+ *          interacting with the iThenticate service.
  */
 
 class TestIThenticate {
@@ -46,7 +46,7 @@ class TestIThenticate {
      * The default webhook events for which webhook request will be received
      * @see https://developers.turnitin.com/docs/tca#event-types
      * 
-     * @var string
+     * @var array
      */
     public const DEFAULT_WEBHOOK_EVENTS = [
         'SUBMISSION_COMPLETE',
@@ -69,18 +69,29 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
         error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
     }
 
+    /**
+     * Validate the service access by retrieving the the enabled feature
+     * @see https://developers.turnitin.com/docs/tca#get-features-enabled
+     * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
+     * 
+     * @return bool
+     */
+    public function validateAccess() {
+        error_log("Confirming the service access validation for given access details");
+        return true;
+    }
+
     /**
      * Confirm the EULA on the user's behalf for given version
      * @see https://developers.turnitin.com/docs/tca#accept-eula-version
      * 
      * @param User      $user
      * @param Context   $context
-     * @param string    $version
      *
      * @return bool
      */
-    public function confirmEula($user, $context, $version = self::DEFAULT_EULA_VERSION) {
-        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEulaConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicationEulaVersion()}");
+    public function confirmEula($user, $context) {
+        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEulaConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicableEulaVersion()}");
         return true;
     }
     
@@ -239,10 +250,42 @@ public function getEulaDetails() {
      * @return string
      * @throws \Exception
      */
-    public function getApplicationEulaVersion() {
+    public function getApplicableEulaVersion() {
         return $this->eulaVersion;
     }
 
+    /**
+     * Set the applicable EULA version
+     * 
+     * @param string $version
+     * @return self
+     */
+    public function setApplicableEulaVersion($version) {
+        $this->eulaVersion = $version;
+
+        return $this;
+    }
+
+    /**
+     * Get the applicable EULA Url
+     * 
+     * @param  string|null $locale
+     * @return string
+     * 
+     * @throws \Exception
+     */
+    public function getApplicableEulaUrl($locale = null) {
+        if (!$this->eulaVersion) {
+            throw new \Exception('No EULA version set yet');
+        }
+
+        $applicableEulaLanguage = $this->getEulaConfirmationLocale($locale ?? static::DEFAULT_EULA_LANGUAGE);
+
+        $eulaUrl = $this->eulaVersionDetails['url'];
+
+        return str_replace(static::DEFAULT_EULA_LANGUAGE, $applicableEulaLanguage, $eulaUrl);
+    }
+
     /**
      * Convert given submission/context locale to service compatible and acceptable locale format
      * @see https://developers.turnitin.com/docs/tca#eula
diff --git a/classes/form/validation/FormValidatorIthenticateAccess.inc.php b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
new file mode 100644
index 0000000..f5d14a9
--- /dev/null
+++ b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/classes/form/validation/FormValidatorIthenticateAccess.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class FormValidatorIthenticateAccess
+ * @see FormValidator
+ *
+ * @brief Form validation check for iThenticate service access.
+ */
+
+import('lib.pkp.classes.form.validation.FormValidator');
+import('plugins.generic.plagiarism.classes.validation.ValidatorIthenticateAccess');
+import("plugins.generic.plagiarism.IThenticate");
+import("plugins.generic.plagiarism.TestIThenticate");
+
+class FormValidatorIthenticateAccess extends FormValidator {
+    
+	/**
+	 * Constructor.
+	 * @param Form                          $form           the associated form
+	 * @param string                        $field          the name of the associated field
+	 * @param string                        $type           the type of check, either "required" or "optional"
+	 * @param string                        $message        the error message for validation failures (i18n key)
+     * @param \IThenticate|\TestIThenticate $ithenticate    iThenticate API communicating service class instance
+	 */
+	public function __construct(&$form, $field, $type, $message, $ithenticate) {
+		$validator = new ValidatorIthenticateAccess($ithenticate);
+		parent::__construct($form, $field, $type, $message, $validator);
+	}
+}
+
+
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
new file mode 100644
index 0000000..8e272f3
--- /dev/null
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/classes/validation/ValidatorIthenticateAccess.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class ValidatorIthenticateAccess
+ * @see Validator
+ *
+ * @brief Validator to validate iThenticate service access
+ */
+
+import ('lib.pkp.classes.validation.Validator');
+import("plugins.generic.plagiarism.IThenticate");
+import("plugins.generic.plagiarism.TestIThenticate");
+
+class ValidatorIthenticateAccess extends Validator {
+    
+    /**
+	 * The iThenticate API communicating service class instance
+	 * 
+	 * @var \IThenticate|\TestIThenticate
+	 */
+    protected $ithenticate;
+
+    public function __construct($ithenticate)
+    {
+        $this->ithenticate = $ithenticate;
+    }
+
+    function isValid($value) {
+		return $this->ithenticate->validateAccess();
+	}
+} 
\ No newline at end of file
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index e6de97c..86eb3bd 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -17,16 +17,16 @@
 
 class PlagiarismWebhookHandler extends PKPHandler {
 
-    /** 
-     * The Plagiarism Plugin itself
-     * 
-     * @var PlagiarismPlugin 
-     */
+	/** 
+	 * The Plagiarism Plugin itself
+	 * 
+	 * @var PlagiarismPlugin 
+	 */
 	protected static $_plugin;
 
 	/**
 	 * Get the plugin
-     * 
+	 * 
 	 * @return PlagiarismPlugin
 	 */
 	public static function getPlugin() {
@@ -35,7 +35,7 @@ public static function getPlugin() {
 
 	/**
 	 * Set the Plugin
-     * 
+	 * 
 	 * @param PlagiarismPlugin $plugin
 	 */
 	public static function setPlugin($plugin) {
@@ -51,7 +51,12 @@ public function authorize($request, &$args, $roleAssignments) {
 		return true;
 	}
 
+	/**
+	 * Handle the incoming webhook request
+	 *
+	 * @return void
+	 */
     public function handle() {
-        error_log('handle webhook request');
+        error_log('PKP Plagiarism plugin handle webhook request');
     }
 }
\ No newline at end of file
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index ff7c179..54dd223 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -35,11 +35,24 @@ msgstr "iThenticate API KEY"
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlRequired"
 msgstr "iThenticate API URL is required"
 
+msgid "plugins.generic.plagiarism.manager.settings.apiUrlInvalid"
+msgstr ""
+"The specified URL is not valid. Please double-check the URL and try again. "
+"(Hint: Try adding http:// to the beginning of the URL.)"
+
 msgid "plugins.generic.plagiarism.manager.settings.apiKeyRequired"
 msgstr "iThenticate API KEY is required"
 
+msgid "plugins.generic.plagiarism.manager.settings.serviceAccessInvalid"
+msgstr ""
+"The specified API URL/KEY is invalid and can not establish connection to IThenticate API service."
+"Please double-check the API URL/KEY and try again."
+
 msgid "plugins.generic.plagiarism.manager.settings.areForced"
 msgstr "iThenticate settings were found in config.inc.php and the settings here will not be used."
 
 msgid "plugins.generic.plagiarism.errorMessage"
 msgstr "Upload of submission {$submissionId} to iThenticate failed with error: {$errorMessage}"
+
+msgid "plugins.generic.plagiarism.submission.checklist.eula"
+msgstr "Plagiarism EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"
diff --git a/locale/fr_CA/locale.po b/locale/fr_CA/locale.po
index 8587d28..55c47a6 100644
--- a/locale/fr_CA/locale.po
+++ b/locale/fr_CA/locale.po
@@ -19,3 +19,6 @@ msgstr ""
 
 msgid "plugins.generic.plagiarism.displayName"
 msgstr "Plugiciel de détection de plagiat iThenticate"
+
+msgid "plugins.generic.plagiarism.submission.checklist.eula"
+msgstr "Plagiarism EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"

From 62ab975594d7be72b00835f35432e78c195db706 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 27 Feb 2024 13:42:37 +0600
Subject: [PATCH 06/75] pkp/plagiarism#52 code formatting update

---
 .../validation/FormValidatorIthenticateAccess.inc.php     | 4 +---
 classes/validation/ValidatorIthenticateAccess.inc.php     | 4 ++--
 controllers/PlagiarismWebhookHandler.inc.php              | 8 ++++----
 3 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/classes/form/validation/FormValidatorIthenticateAccess.inc.php b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
index f5d14a9..81393aa 100644
--- a/classes/form/validation/FormValidatorIthenticateAccess.inc.php
+++ b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
@@ -19,7 +19,7 @@
 import("plugins.generic.plagiarism.TestIThenticate");
 
 class FormValidatorIthenticateAccess extends FormValidator {
-    
+
 	/**
 	 * Constructor.
 	 * @param Form                          $form           the associated form
@@ -33,5 +33,3 @@ public function __construct(&$form, $field, $type, $message, $ithenticate) {
 		parent::__construct($form, $field, $type, $message, $validator);
 	}
 }
-
-
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index 8e272f3..9e9099b 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -31,7 +31,7 @@ public function __construct($ithenticate)
         $this->ithenticate = $ithenticate;
     }
 
-    function isValid($value) {
+    public function isValid($value) {
 		return $this->ithenticate->validateAccess();
 	}
-} 
\ No newline at end of file
+} 
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 86eb3bd..70e8d26 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -56,7 +56,7 @@ public function authorize($request, &$args, $roleAssignments) {
 	 *
 	 * @return void
 	 */
-    public function handle() {
-        error_log('PKP Plagiarism plugin handle webhook request');
-    }
-}
\ No newline at end of file
+	public function handle() {
+		error_log('PKP Plagiarism plugin handle webhook request');
+	}
+}

From 5432abebb094c6924a3229dcf0b4da7be98d15a2 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 27 Feb 2024 16:46:32 +0600
Subject: [PATCH 07/75] pkp/plagiarism#52 added the handling of missing service
 access case

---
 PlagiarismPlugin.inc.php | 25 +++++++++++++++-
 TestIThenticate.inc.php  | 64 ++++++++++++++++++++--------------------
 2 files changed, 56 insertions(+), 33 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 4a79fd6..d91010a 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -309,6 +309,12 @@ public function setupWebhookHandler($hookName, $params) {
 	 */
 	public function stampEulaToSubmission($hookName, $args) {
 		$submission =& $args[0]; /** @var Submission $submission */
+		$context = Application::get()->getRequest()->getContext();
+
+		if (!static::ITHENTICATE_TEST_MODE_ENABLE && !$this->isServiceAccessAvailable($context)) {
+			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
+			return false;
+		}
 
 		$eualDetails = $this->getContextEulaDetails(
 			Application::get()->getRequest()->getContext(), 
@@ -341,6 +347,11 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$author = $publication->getPrimaryAuthor();
 		$user = $request->getUser();
 
+		if (!static::ITHENTICATE_TEST_MODE_ENABLE && !$this->isServiceAccessAvailable($context)) {
+			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
+			return false;
+		}
+
 		// if EULA details not stamped to submission, not going to sent it for plagiarism check
 		if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
 			$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
@@ -489,7 +500,9 @@ public function getContextEulaDetails($context, $locale = null) {
 				[$this, 'retrieveApplicableEulaDetails']
 			);
 		
-		if (time() - $cache->getCacheTime() > static::EULA_CACHE_LIFETIME) {
+		// if running on ithenticate test mode, set the cache life time to 60 seconds
+		$cacheLifetime = static::ITHENTICATE_TEST_MODE_ENABLE ? 60 : static::EULA_CACHE_LIFETIME;
+		if (time() - $cache->getCacheTime() > $cacheLifetime) {
 			$cache->flush();
 		}
 
@@ -586,6 +599,16 @@ protected function getServiceAccess($context) {
 		return [$apiUrl, $apiKey];
 	}
 
+	/**
+	 * Check is ithenticate service access details(API URL & KEY) available for given context
+	 * 
+	 * @param Context $context
+	 * @return bool
+	 */
+	protected function isServiceAccessAvailable($context) {
+		return !collect($this->getServiceAccess($context))->filter()->isEmpty();
+	}
+
 	/**
 	 * Stamp the EULA version and confirmation datetime for submitting user
 	 * 
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 0dc3823..31b4cdb 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -26,7 +26,37 @@ class TestIThenticate {
      * 
      * @var array|null
      */
-    protected $eulaVersionDetails = null;
+    protected $eulaVersionDetails = [
+        "version" => "v1beta",
+        "valid_from" => "2018-04-30T17:00:00Z",
+        "valid_until" => null,
+        "url" => "https://static.turnitin.com/eula/v1beta/en-us/eula.html",
+        "available_languages" => [
+          "sv-SE",
+          "zh-CN",
+          "ja-JP",
+          "ko-KR",
+          "es-MX",
+          "nl-NL",
+          "ru-RU",
+          "zh-TW",
+          "ar-SA",
+          "pt-BR",
+          "de-DE",
+          "el-GR",
+          "nb-NO",
+          "cs-CZ",
+          "da-DK",
+          "tr-TR",
+          "pl-PL",
+          "fi-FI",
+          "it-IT",
+          "vi-VN",
+          "fr-FR",
+          "en-US",
+          "ro-RO",
+        ],
+    ];
 
     /**
      * The default EULA version placeholder to retrieve the current latest version
@@ -211,37 +241,7 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
      * @return array|null
      */
     public function getEulaDetails() {
-        return [
-            "version" => "v1beta",
-            "valid_from" => "2018-04-30T17:00:00Z",
-            "valid_until" => null,
-            "url" => "https://static.turnitin.com/eula/v1beta/en-us/eula.html",
-            "available_languages" => [
-              "sv-SE",
-              "zh-CN",
-              "ja-JP",
-              "ko-KR",
-              "es-MX",
-              "nl-NL",
-              "ru-RU",
-              "zh-TW",
-              "ar-SA",
-              "pt-BR",
-              "de-DE",
-              "el-GR",
-              "nb-NO",
-              "cs-CZ",
-              "da-DK",
-              "tr-TR",
-              "pl-PL",
-              "fi-FI",
-              "it-IT",
-              "vi-VN",
-              "fr-FR",
-              "en-US",
-              "ro-RO",
-            ],
-        ];
+        return $this->eulaVersionDetails;
     }
 
     /**

From 5e5622c91b1c61687873569dbd02202311ae3e70 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 4 Mar 2024 13:02:01 +0600
Subject: [PATCH 08/75] pkp/plagiarism#52 added exception handling for multiple
 file upload for single submission

---
 IThenticate.inc.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 9f9d4ad..144316c 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -291,7 +291,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
                 ]),
                 'body' => $fileContent,
                 'verify' => false,
-                'exceptions' => true,
+                'exceptions' => false,
             ]
         );
 

From eac1931eeef551f924db93d6e1b24eb1a42c396b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 4 Mar 2024 18:23:55 +0600
Subject: [PATCH 09/75] pkp/plagiarism#52 added ability to handle multiple file
 for single submission and webhook registration on settings update

---
 IThenticate.inc.php            |  33 -----------
 PlagiarismPlugin.inc.php       | 105 ++++++++++++++++++++++-----------
 PlagiarismSettingsForm.inc.php |  35 +++++++----
 TestIThenticate.inc.php        |  30 ----------
 4 files changed, 94 insertions(+), 109 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 144316c..9f1bc62 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -236,39 +236,6 @@ public function submitSubmission($submission, $user, $author = null, $site = nul
         return null;
     }
 
-    /**
-     * Upload all submission files to the service's end
-     *
-     * @param string        $submissionTacId The submission UUID return back from service
-     * @param Submission    $submission
-     *
-     * @return bool         If all submission files uploaded successfully, only then it will 
-     *                      return TRUE and return FALSE on a single failure
-     */
-    public function uploadSubmissionFile($submissionTacId, $submission)
-    {
-        $submissionFiles = Services::get('submissionFile')->getMany([
-            'submissionIds' => [$submission->getId()],
-		]);
-        
-        $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
-
-        foreach($submissionFiles as $submissionFile) {
-            $file = Services::get('file')->get($submissionFile->getData('fileId'));
-            $uploadStatus = $this->uploadFile(
-                $submissionTacId, 
-                $submissionFile->getData("name", $publication->getData("locale")),
-                Services::get('file')->fs->read($file->path),
-            );
-
-            if (!$uploadStatus) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
     /**
      * Upload single submission file to the service's end
      * @see https://developers.turnitin.com/docs/tca#upload-submission-file-contents
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index d91010a..7b82f94 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -141,7 +141,7 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 
 		$schema->properties->ithenticate_id = (object) [
 			'type' => 'string',
-			'description' => 'The iThenticate service submission uuid that return back after a submission has been successful submitted',
+			'description' => 'The json encoded data map of submission file id to ithenticate submission id for each file submission file',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
@@ -377,51 +377,84 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			}
 		}
 
-		// Create the submission at iThenticate's end
-		$submissionUuid = $ithenticate->submitSubmission(
-			$submission,
-			$user,
-			$author,
-			$request->getSite()
-		);
+		/** @var DAOResultIterator $submissionFiles */
+		$submissionFiles = Services::get('submissionFile')->getMany([
+            'submissionIds' => [$submission->getId()],
+		]);
 
-		if (!$submissionUuid) {
-			$this->sendErrorMessage($submission->getId(), 'Could not submit the submission at iThenticate.');
-			return false;
-		}
+		$submissionUuids = [];
 
-		$submission->setData('ithenticate_id', $submissionUuid);
-		
-		// Upload submission files for successfully created submission at iThenticate's end
-		if (!$ithenticate->uploadSubmissionFile($submissionUuid, $submission)) {
-			$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate.');
-			return false;
-		}
+		foreach($submissionFiles as $submissionFile) { /** @var SubmissionFile $submissionFile */
+			// Create a new submission at iThenticate's end
+			$submissionUuid = $ithenticate->submitSubmission(
+				$submission,
+				$user,
+				$author,
+				$request->getSite()
+			);
 
-		// If no webhook previously registered for this Context, register it
-		if (!$context->getData('ithenticate_webhook_id')) {
-			$signingSecret = \Illuminate\Support\Str::random(12);
-			
-			$webhookUrl = $request->getDispatcher()->url(
-                $request,
-                ROUTE_COMPONENT,
-                $context->getData('urlPath'),
-                'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler',
-                'handle'
+			if (!$submissionUuid) {
+				$this->sendErrorMessage($submission->getId(), 'Could not submit the submission at iThenticate.');
+				return false;
+			}
+
+			$submissionUuids[$submissionFile->getId()] = $submissionUuid;
+
+			$file = Services::get('file')->get($submissionFile->getData('fileId'));
+            $uploadStatus = $ithenticate->uploadFile(
+                $submissionUuid, 
+                $submissionFile->getData("name", $publication->getData("locale")),
+                Services::get('file')->fs->read($file->path),
             );
 
-			if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
-				$context->setData('ithenticate_webhook_signing_secret', $signingSecret);
-				$context->setData('ithenticate_webhook_id', $webhookId);
-				Application::get()->getContextDAO()->updateObject($context);
-			} else {
-				error_log("unable to complete the iThenticate webhook registration during the submission process of ID : {$submission->getId()}");
+			// Upload submission files for successfully created submission at iThenticate's end
+			if (!$uploadStatus) {
+				$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file ' . $submissionFile->getData("name", $publication->getData("locale")));
+				return false;
 			}
 		}
 
+		$submission->setData('ithenticate_id', json_encode($submissionUuids));
+
+		// If no webhook previously registered for this Context, register it
+		if (!$context->getData('ithenticate_webhook_id')) {
+			$this->registerIthenticateWebhook($ithenticate, $context);
+		}
+
 		return true;
 	}
 
+	/**
+	 * Register the webhook for this context
+	 * 
+	 * @param \IThenticate|\TestIThenticate $ithenticate
+	 * @param Context|null 					$context
+	 * 
+	 * @return void
+	 */
+	public function registerIthenticateWebhook($ithenticate, $context = null) {
+
+		$request = Application::get()->getRequest();
+		$context ??= $request->getContext();
+
+		$signingSecret = \Illuminate\Support\Str::random(12);
+		$webhookUrl = $request->getDispatcher()->url(
+			$request,
+			ROUTE_COMPONENT,
+			$context->getData('urlPath'),
+			'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler',
+			'handle'
+		);
+
+		if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
+			$context->setData('ithenticate_webhook_signing_secret', $signingSecret);
+			$context->setData('ithenticate_webhook_id', $webhookId);
+			Application::get()->getContextDAO()->updateObject($context);
+		} else {
+			error_log("unable to complete the iThenticate webhook registration for context id {$context->getId()}");
+		}
+	}
+
 	/**
      * @copydoc Plugin::getActions()
      */
@@ -466,7 +499,7 @@ public function manage($args, $request) {
                 $templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
 
                 $this->import('PlagiarismSettingsForm');
-                $form = new PlagiarismSettingsForm($this, $context->getId());
+                $form = new PlagiarismSettingsForm($this, $context);
 
                 if ($request->getUserVar('save')) {
                     $form->readInputData();
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 95df0fb..1d91c71 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -17,11 +17,11 @@
 class PlagiarismSettingsForm extends Form {
 
 	/**
-	 * The context id
+	 * The context
 	 * 
-	 * @var int
+	 * @var Context
 	 */
-	var $_contextId;
+	var $_context;
 
 	/**
 	 * The PlagiarismPlugin instance
@@ -34,11 +34,11 @@ class PlagiarismSettingsForm extends Form {
 	 * Constructor
 	 * 
 	 * @param PlagiarismPlugin 	$plugin
-	 * @param int 				$contextId
+	 * @param Context 			$context
 	 */
-	public function __construct($plugin, $contextId) {
+	public function __construct($plugin, $context) {
 		$this->_plugin = $plugin;
-		$this->_contextId = $contextId;
+		$this->_context = $context;
 
 		parent::__construct($plugin->getTemplateResource('settingsForm.tpl'));
 
@@ -55,8 +55,8 @@ public function __construct($plugin, $contextId) {
 	 */
 	public function initData() {
 		$this->_data = [
-			'ithenticateApiUrl' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiUrl'),
-			'ithenticateApiKey' => $this->_plugin->getSetting($this->_contextId, 'ithenticateApiKey'),
+			'ithenticateApiUrl' => $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
+			'ithenticateApiKey' => $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
 			'ithenticateForced' => $this->_plugin->hasForcedCredentials(),
 		];
 	}
@@ -101,8 +101,23 @@ public function validate($callHooks = true) {
 	 * @copydoc Form::execute()
 	 */
 	public function execute(...$functionArgs) {
-        $this->_plugin->updateSetting($this->_contextId, 'ithenticateApiUrl', trim($this->getData('ithenticateApiUrl'), "\"\';"), 'string');
-		$this->_plugin->updateSetting($this->_contextId, 'ithenticateApiKey', trim($this->getData('ithenticateApiKey'), "\"\';"), 'string');
+        $ithenticateApiUrl = trim($this->getData('ithenticateApiUrl'), "\"\';");
+		$ithenticateApiKey = trim($this->getData('ithenticateApiKey'), "\"\';");
+
+		if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
+			$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey)
+		{
+			// access updated or new access entered, need to update webhook registration	
+			$this->_plugin->registerIthenticateWebhook(
+				$this->_plugin->initIthenticate(
+					$this->getData('ithenticateApiUrl'),
+					$this->getData('ithenticateApiKey')
+				)
+			);
+		}
+
+		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiUrl', $ithenticateApiUrl, 'string');
+		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
 		parent::execute(...$functionArgs);
 	}
 }
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 31b4cdb..920b380 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -142,36 +142,6 @@ public function submitSubmission($submission, $user, $author = null, $site = nul
         return \Illuminate\Support\Str::uuid()->__toString();
     }
 
-    /**
-     * Upload all submission files to the service's end
-     *
-     * @param string        $submissionTacId The submission UUID return back from service
-     * @param Submission    $submission
-     *
-     * @return bool         If all submission files uploaded successfully, only then it will 
-     *                      return TRUE and return FALSE on a single failure
-     */
-    public function uploadSubmissionFile($submissionTacId, $submission)
-    {
-        error_log("Preparing to start process of uploading file for submission {$submission->getId()} with iThenticate submission UUID {$submissionTacId}");
-
-        $submissionFiles = Services::get('submissionFile')->getMany([
-			'submissionIds' => [$submission->getId()],
-		]);
-        
-        $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
-
-        foreach($submissionFiles as $submissionFile) {
-            $this->uploadFile(
-                $submissionTacId, 
-                $submissionFile->getData("name", $publication->getData("locale")),
-                '',
-            );
-        }
-
-        return true;
-    }
-
     /**
      * Upload single submission file to the service's end
      * @see https://developers.turnitin.com/docs/tca#upload-submission-file-contents

From 9740f11f2351208c12d34a7a4b19455a2a6a5ebc Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 5 Apr 2024 04:27:13 +0600
Subject: [PATCH 10/75] pkp/plagiarism#52 added similarity check initiation
 process via webhook

---
 IThenticate.inc.php                           | 157 ++++++++++++++----
 PlagiarismPlugin.inc.php                      | 123 +++++++++-----
 PlagiarismSettingsForm.inc.php                |  43 +++--
 TestIThenticate.inc.php                       |  34 ++--
 .../ValidatorIthenticateAccess.inc.php        |   3 +-
 controllers/PlagiarismWebhookHandler.inc.php  |  90 +++++++++-
 locale/en_US/locale.po                        |   4 +-
 7 files changed, 334 insertions(+), 120 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 9f1bc62..4a938e0 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -13,7 +13,7 @@
 class IThenticate
 {
     /** 
-     * The base api url in the format of schems://host
+     * The base api url in the format of schema://host
      * 
      * @var string
      */
@@ -44,7 +44,7 @@ class IThenticate
     protected $integrationVersion;
     
     /**
-     * The EULA(end user license agreement) that user need to confrim before making request
+     * The EULA(end user license agreement) that user need to confirmm before making request
      * 
      * @var string|null
      */
@@ -93,6 +93,18 @@ class IThenticate
         'GROUP_ATTACHMENT_COMPLETE',
     ];
 
+    /**
+     * The entity(e.g. submission owner, submitter etc) to id prefix mapping
+     * This helps to identify the type of entity associated with requesting system
+     * For example, `author/1` rather than only `1` identify as author entity of requesting system
+     * 
+     * @var array
+     */
+    public const ENTITY_ID_PREFIXES = [
+        'owner' => 'author_',
+        'submitter' => 'user_',
+    ];
+
     /**
      * Create a new instance
      * 
@@ -103,7 +115,7 @@ class IThenticate
      * @param string|null   eulaVersion
      */
     public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
-        $this->apiUrl               = rtrim(trim($apiUrl), '/\\');
+        $this->apiUrl               = rtrim(trim($apiUrl ?? ''), '/\\');
         $this->apiKey               = $apiKey;
         $this->integrationName      = $integrationName;
         $this->integrationVersion   = $integrationVersion;
@@ -111,7 +123,7 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
     }
 
     /**
-     * Validate the service access by retrieving the the enabled feature
+     * Validate the service access by retrieving the enabled feature
      * @see https://developers.turnitin.com/docs/tca#get-features-enabled
      * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
      * 
@@ -122,7 +134,7 @@ public function validateAccess() {
         try {
             $response = Application::get()->getHttpClient()->request(
                 'GET',
-                $this->getApiPath("features-enabled"),
+                $this->getApiPath('features-enabled'),
                 [
                     'headers' => $this->getRequiredHeaders(),
                     'verify' => false,
@@ -158,7 +170,7 @@ public function confirmEula($user, $context) {
                     'Content-Type' => 'application/json'
                 ]),
                 'json' => [
-                    'user_id' => $user->getId(),
+                    'user_id' => $this->getGeneratedId('submitter', $user->getId()),
                     'accepted_timestamp' => \Carbon\Carbon::now()->toIso8601String(),
                     'language' => $this->getEulaConfirmationLocale($context->getPrimaryLocale()),
                 ],
@@ -174,25 +186,19 @@ public function confirmEula($user, $context) {
      * Create a new submission at service's end
      * @see https://developers.turnitin.com/docs/tca#create-a-submission
      * 
-     * @param Submission    $submission
-     * @param User          $user
-     * @param Author|null   $author
-     * @param Site|null     $site
+     * @param Submission    $submission The article submission to check for plagiarism
+     * @param User          $user       The user who is making submitting the submission
+     * @param Author        $author     The author/owher of the submission
+     * @param Site          $site       The core site of submission system
      *
-     * @return string|null  if succeed, it will return the created submission UUID at service's end and 
-     *                      at failure, will return null
+     * @return string|null              if succeed, it will return the created submission UUID from 
+     *                                  service's end and at failure, will return null
      */
-    public function submitSubmission($submission, $user, $author = null, $site = null) {
+    public function createSubmission($submission, $user, $author, $site) {
 
         $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
         $author ??= $publication->getPrimaryAuthor();
 
-        if (!$site) {
-            import('lib.pkp.classes.db.DAORegistry');
-            $siteDao = DAORegistry::getDAO("SiteDAO"); /** @var SiteDAO $siteDao */
-            $site = $siteDao->getSite(); /** @var Site $site */
-        }
-
         $response = Application::get()->getHttpClient()->request(
             'POST',
             $this->getApiPath("submissions"),
@@ -201,20 +207,20 @@ public function submitSubmission($submission, $user, $author = null, $site = nul
                     'Content-Type' => 'application/json'
                 ]),
                 'json' => [
-                    'owner' => $author->getId(),
+                    'owner' => $this->getGeneratedId('owner', $author->getId()),
                     'title' => $publication->getLocalizedTitle($publication->getData('locale')),
-                    'submitter' => $user->getId(),
+                    'submitter' => $this->getGeneratedId('submitter', $user->getId()),
                     'metadata' => [
                         'owners' => [
                             [
-                                'id' => $author->getId(),
+                                'id' => $this->getGeneratedId('owner', $author->getId()),
                                 'given_name' => $author->getGivenName($publication->getData('locale')),
                                 'family_name' => $author->getFamilyName($publication->getData('locale')),
                                 'email' => $author->getEmail(),
                             ]
                         ],
                         'submitter' => [
-                            'id' => $user->getId(),
+                            'id' => $this->getGeneratedId('submitter', $user->getId()),
                             'given_name' => $user->getGivenName($site->getPrimaryLocale()),
                             'family_name' => $user->getFamilyName($site->getPrimaryLocale()),
                             'email' => $user->getEmail(),
@@ -265,6 +271,65 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
         return $response->getStatusCode() === 202;
     }
 
+    /**
+     * Schedule the similarity report generation process
+     * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
+     *
+     * @param string $submissionUuid The submission UUID return back from service
+     * @return bool
+     */
+    public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
+
+        $response = Application::get()->getHttpClient()->request(
+            'PUT',
+            $this->getApiPath("submissions/{$submissionUuid}/similarity"),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => 'application/json'
+                ]),
+                'json' => [
+                    // section `indexing_settings` settings
+                    'indexing_settings' => [
+                        'add_to_index' => true,
+                    ],
+
+                    // section `generation_settings` settings
+                    'generation_settings' => [
+                        'search_repositories' => [
+                            'INTERNET',
+                            'SUBMITTED_WORK',
+                            'PUBLICATION',
+                            'CROSSREF',
+                            'CROSSREF_POSTED_CONTENT'
+                        ],
+                        'auto_exclude_self_matching_scope' => 'ALL',
+                        'priority' => 'HIGH',
+                    ],
+
+                    // section `view_settings` settings
+                    'view_settings' => [
+                        'exclude_quotes' => true,
+                        'exclude_bibliography' => true,
+                        'exclude_citations' => false,
+                        'exclude_abstract' => false,
+                        'exclude_methods' => false,
+                        'exclude_custom_sections' => false,
+                        'exclude_preprints' => false,
+                        'exclude_small_matches' => 8,
+                        'exclude_internet' => false,
+                        'exclude_publications' => false,
+                        'exclude_crossref' => false,
+                        'exclude_crossref_posted_content' => false,
+                        'exclude_submitted_works' => false,
+                    ],
+                ],
+                'exceptions' => false,
+            ]
+        );
+        // ray(json_decode($response->getBody()->getContents()));
+        return $response->getStatusCode() === 202;
+    }
+
     /**
      * Verify if user has already confirmed the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
@@ -274,11 +339,11 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
      *
      * @return bool
      */
-    public function verifyUserEulaAcceptance($user, $version)
-    {
+    public function verifyUserEulaAcceptance($user, $version) {
+
         $response = Application::get()->getHttpClient()->request(
             'GET',
-            $this->getApiPath("eula/{$version}/accept/{$user->getId()}"),
+            $this->getApiPath("eula/{$version}/accept/" . $this->getGeneratedId('submitter' ,$user->getId())),
             [
                 'headers' => $this->getRequiredHeaders(),
                 'exceptions' => false,
@@ -336,7 +401,7 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
             $this->getApiPath('webhooks'),
             [
                 'headers' => array_merge($this->getRequiredHeaders(), [
-                    'Content-Type' => ' application/json',
+                    'Content-Type' => 'application/json',
                 ]),
                 'json' => [
                     'signing_secret' => base64_encode($signingSecret),
@@ -424,10 +489,10 @@ protected function getEulaConfirmationLocale($locale) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $euleLangs = $this->getEulaDetails()['available_languages'];
+        $eulaLangs = $this->getEulaDetails()['available_languages'];
         $locale = str_replace("_", "-", substr($locale, 0, 5));
 
-        return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+        return in_array($locale, $eulaLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
     }
 
     /**
@@ -447,9 +512,39 @@ protected function getRequiredHeaders(){
     /**
      * Generate and return the final API end point to make request
      * 
-     * @return string
+     * @return \GuzzleHttp\Psr7\Uri
      */
     protected function getApiPath($apiPathSegment) {
-        return str_replace('API_URL', $this->apiUrl, $this->apiBasePath) . $apiPathSegment;
+        $apiRequestUrl = str_replace('API_URL', $this->apiUrl, $this->apiBasePath) . $apiPathSegment;
+        return new \GuzzleHttp\Psr7\Uri($apiRequestUrl);
+    }
+
+    /**
+     * Generate and return unique entity id by concatenating the prefix to given id
+     * 
+     * @param  string   $entity     The entity name (e.g. owner/submitter etc).
+     * @param  mixed    $id         Entity id associated with requesting system.
+     * @param  bool     $silent     Silently return the passed `$id` is no matching entity mapping
+     *                              not found. Default to `true` and when set to `false`, will throw
+     *                              exception.
+     * 
+     * @return mixed
+     */
+    protected function getGeneratedId($entity, $id, $silent = true) {
+        if (!in_array($entity, array_keys(static::ENTITY_ID_PREFIXES))) {
+            if ($silent) {
+                return $id;
+            }
+
+            throw new Exception(
+                sprintf(
+                    'Invalid entity %s given, must be among [%s]',
+                    $entity,
+                    implode(', ', array_keys(static::ENTITY_ID_PREFIXES))
+                )
+            );
+        }
+
+        return static::ENTITY_ID_PREFIXES[$entity] . $id;
     }
 }
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 7b82f94..dd85262 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -51,6 +51,7 @@ public function register($category, $path, $mainContextId = null) {
 		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmission']);
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
+		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION_FILE, [$this, 'addPlagiarismCheckDataToSubmissionFileSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addPlagiarismCheckWebhookDataToSchema']);
 		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
 		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
@@ -109,20 +110,18 @@ public function addEulaToChecklist($hookName, $params) {
 			return false;
 		}
 
-		$eualDetails = $this->getContextEulaDetails($context);
+		$eulaDetails = $this->getContextEulaDetails($context);
 		
 		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
 			array_push($checklist, [
 				'order' => (collect($checklist)->pluck('order')->sort(SORT_REGULAR)->last() ?? 0) + 1,
 				'content' => __('plugins.generic.plagiarism.submission.checklist.eula', [
-					'localizedEulaUrl' => $eualDetails[$locale]['url']
+					'localizedEulaUrl' => $eulaDetails[$locale]['url']
 				]),
 			]);
 
 			$context->setData('submissionChecklist', $checklist, $locale);
 		}
-
-		$templateManager->assign('currentContext', $context);
 		
 		return false;
 	}
@@ -139,23 +138,45 @@ public function addEulaToChecklist($hookName, $params) {
 	public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 		$schema =& $params[0];
 
-		$schema->properties->ithenticate_id = (object) [
+		$schema->properties->ithenticate_eula_version = (object) [
 			'type' => 'string',
-			'description' => 'The json encoded data map of submission file id to ithenticate submission id for each file submission file',
+			'description' => 'The iThenticate EULA version which has been agreed at submission checklist',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_eula_version = (object) [
+		$schema->properties->ithenticate_eula_url = (object) [
 			'type' => 'string',
-			'description' => 'The iThenticate EULA version which has been agreed at submission checklist',
+			'description' => 'The iThenticate EULA url which has been agreen at submission checklist',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_eula_url = (object) [
+		return false;
+	}
+
+	/**
+	 * Add properties for this type of public identifier to the submission file entity's list for
+	 * storage in the database.
+	 * 
+	 * @param string $hookName `Schema::get::submissionFile`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params) {
+		$schema =& $params[0];
+
+		$schema->properties->ithenticate_id = (object) [
 			'type' => 'string',
-			'description' => 'The iThenticate EULA url which has been agreen at submission checklist',
+			'description' => 'The iThenticate submission id for submission file',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+
+		$schema->properties->ithenticate_similarity_scheduled = (object) [
+			'type' => 'boolean',
+			'description' => 'The status which identify if the iThenticate similarity process has been scheduled for this submission file',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
@@ -178,14 +199,14 @@ public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
 		$schema->properties->ithenticate_webhook_signing_secret = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate service webook registration signing secret',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
 		$schema->properties->ithenticate_webhook_id = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate service webook id that return back after successful webhook registration',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
@@ -218,7 +239,7 @@ public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
 	public function getForcedCredentials() {
 		$request = Application::get()->getRequest(); /** @var Request $request */
 		$context = $request->getContext(); /** @var Context $context */
-		$contextPath = $context?->getPath();
+		$contextPath = $context ? $context->getPath() : 'index';
 
 		$apiUrl = Config::getVar(
 			'ithenticate',
@@ -316,13 +337,13 @@ public function stampEulaToSubmission($hookName, $args) {
 			return false;
 		}
 
-		$eualDetails = $this->getContextEulaDetails(
+		$eulaDetails = $this->getContextEulaDetails(
 			Application::get()->getRequest()->getContext(), 
 			$submission->getData('locale')
 		);
 
-		$submission->setData('ithenticate_eula_version', $eualDetails['version']);
-		$submission->setData('ithenticate_eula_url', $eualDetails['url']);
+		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
+		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
 
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submissionDao->updateObject($submission);
@@ -331,7 +352,17 @@ public function stampEulaToSubmission($hookName, $args) {
 	}
 
 	/**
-	 * Confirm EULA, create submission and upload submission files to iThenticate service
+	 * Complete the submission process at iThenticate service's end
+	 * The steps follows as:
+	 * 	- Check if proper service credentials(API Url and Key) are available
+	 *  - Register webhook for context if not already registered
+	 *  - Check and only proceed if EULA is stamped to submission at initial stage
+	 *  - Stamp the EULA confirmation to submittion submitter if has not confirmed the version already
+	 *  - Traversing the submission files
+	 *  	- Create new submission at ithenticate's end for each submission file
+	 * 		- Upload the file for newly created submission uuid return back from ithenticate
+	 * 		- Stamp the retuning iThenticate submission id with submission file
+	 * 	- Return bool to indicate the status of process completion
 	 * 
 	 * @param string $hookName `submissionsubmitstep4form::execute`
 	 * @param array $args
@@ -342,6 +373,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$request = Application::get()->getRequest();
 		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$context = $request->getContext();
 		$publication = $submission->getCurrentPublication();
 		$author = $publication->getPrimaryAuthor();
@@ -352,6 +384,13 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			return false;
 		}
 
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+
+		// If no webhook previously registered for this Context, register it
+		if (!$context->getData('ithenticate_webhook_id')) {
+			$this->registerIthenticateWebhook($ithenticate, $context);
+		}
+
 		// if EULA details not stamped to submission, not going to sent it for plagiarism check
 		if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
 			$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
@@ -359,7 +398,6 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		}
 
 		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
-		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
 		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
 		
 		// Check if EULA stamped to submitter and if not, try to stamp it
@@ -370,7 +408,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
 			if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
 				$ithenticate->confirmEula($user, $context)) {
-				$this->stampEualVersionToSubmittingUser($user, $submissionEulaVersion);
+				$this->stampEulaVersionToSubmittingUser($user, $submissionEulaVersion);
 			} else {
 				$this->sendErrorMessage($submission->getId(), 'Unable to stamp the EULA details to submission submitter');
 				return false;
@@ -382,11 +420,9 @@ public function submitForPlagiarismCheck($hookName, $args) {
             'submissionIds' => [$submission->getId()],
 		]);
 
-		$submissionUuids = [];
-
 		foreach($submissionFiles as $submissionFile) { /** @var SubmissionFile $submissionFile */
 			// Create a new submission at iThenticate's end
-			$submissionUuid = $ithenticate->submitSubmission(
+			$submissionUuid = $ithenticate->createSubmission(
 				$submission,
 				$user,
 				$author,
@@ -394,31 +430,26 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			);
 
 			if (!$submissionUuid) {
-				$this->sendErrorMessage($submission->getId(), 'Could not submit the submission at iThenticate.');
+				$this->sendErrorMessage($submission->getId(), "Could not create the submission at iThenticate for file id {$submissionFile->getId()}");
 				return false;
 			}
 
-			$submissionUuids[$submissionFile->getId()] = $submissionUuid;
-
 			$file = Services::get('file')->get($submissionFile->getData('fileId'));
-            $uploadStatus = $ithenticate->uploadFile(
-                $submissionUuid, 
-                $submissionFile->getData("name", $publication->getData("locale")),
-                Services::get('file')->fs->read($file->path),
-            );
+			$uploadStatus = $ithenticate->uploadFile(
+				$submissionUuid, 
+				$submissionFile->getData("name", $publication->getData("locale")),
+				Services::get('file')->fs->read($file->path),
+			);
 
 			// Upload submission files for successfully created submission at iThenticate's end
 			if (!$uploadStatus) {
-				$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file ' . $submissionFile->getData("name", $publication->getData("locale")));
+				$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")));
 				return false;
 			}
-		}
-
-		$submission->setData('ithenticate_id', json_encode($submissionUuids));
 
-		// If no webhook previously registered for this Context, register it
-		if (!$context->getData('ithenticate_webhook_id')) {
-			$this->registerIthenticateWebhook($ithenticate, $context);
+			$submissionFile->setData('ithenticate_id', $submissionUuid);
+			$submissionFile->setData('ithenticate_similarity_scheduled', 0);
+			$submissionFileDao->updateObject($submissionFile);
 		}
 
 		return true;
@@ -529,7 +560,7 @@ public function getContextEulaDetails($context, $locale = null) {
 		$cache = CacheManager::getManager()
 			->getCache(
 				'ithenticate_eula', 
-				"CONTEXT_ID_{$context->getId()}",
+				$context->getId(),
 				[$this, 'retrieveApplicableEulaDetails']
 			);
 		
@@ -539,13 +570,13 @@ public function getContextEulaDetails($context, $locale = null) {
 			$cache->flush();
 		}
 
-		$eulaDetails = $cache->get("CONTEXT_ID_{$context->getId()}");
+		$eulaDetails = $cache->get($context->getId());
 
 		return $locale ? $eulaDetails[$locale] : $eulaDetails;
 	}
 
 	/**
-	 * Retrived and generate the localized EULA details for given context 
+	 * Retrieved and generate the localized EULA details for given context 
 	 * and cache it in following format
 	 * [
 	 *   'en_US' => [
@@ -563,20 +594,20 @@ public function getContextEulaDetails($context, $locale = null) {
 	public function retrieveApplicableEulaDetails($cache, $cacheId) {
 		$context = Application::get()->getRequest()->getContext();
 		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
-		$eualDetails = [];
+		$eulaDetails = [];
 		
 		if ($ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION)) {
 			foreach($context->getSupportedSubmissionLocaleNames() as $localeKey => $localeName) {
-				$eualDetails[$localeKey] = [
+				$eulaDetails[$localeKey] = [
 					'version' 	=> $ithenticate->getApplicableEulaVersion(),
 					'url' 		=> $ithenticate->getApplicableEulaUrl($localeKey),
 				];
 			}
 		}
 
-		$cache->setEntireCache([$cacheId => $eualDetails]);
+		$cache->setEntireCache([$cacheId => $eulaDetails]);
 
-		return $eualDetails;
+		return $eulaDetails;
 	}
 
 	/**
@@ -620,7 +651,7 @@ public function initIthenticate($apiUrl, $apiKey) {
 	 * @param Context $context
 	 * @return array
 	 */
-	protected function getServiceAccess($context) {
+	public function getServiceAccess($context) {
 		// try to get credentials for current context otherwise use default config
 		list($apiUrl, $apiKey) = $this->hasForcedCredentials()
 			? $this->getForcedCredentials()
@@ -650,7 +681,7 @@ protected function isServiceAccessAvailable($context) {
 	 * 
 	 * @return void
 	 */
-	protected function stampEualVersionToSubmittingUser($user, $version) {
+	protected function stampEulaVersionToSubmittingUser($user, $version) {
 		$userDao = DAORegistry::getDAO('UserDAO'); /** @var UserDAO $userDao */
 
 		$user->setData('ithenticateEulaVersion', $version);
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 1d91c71..5597c71 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -21,14 +21,14 @@ class PlagiarismSettingsForm extends Form {
 	 * 
 	 * @var Context
 	 */
-	var $_context;
+	protected $_context;
 
 	/**
 	 * The PlagiarismPlugin instance
 	 * 
 	 * @var PlagiarismPlugin
 	 */
-	var $_plugin;
+	protected $_plugin;
 
 	/**
 	 * Constructor
@@ -40,11 +40,25 @@ public function __construct($plugin, $context) {
 		$this->_plugin = $plugin;
 		$this->_context = $context;
 
+		$request = Application::get()->getRequest();
+
 		parent::__construct($plugin->getTemplateResource('settingsForm.tpl'));
 
 		$this->addCheck(new FormValidator($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlRequired'));
 		$this->addCheck(new FormValidator($this, 'ithenticateApiKey', 'required', 'plugins.generic.plagiarism.manager.settings.apiKeyRequired'));
 		$this->addCheck(new FormValidatorUrl($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlInvalid'));
+		$this->addCheck(
+			new FormValidatorIthenticateAccess(
+				$this,
+				'',
+				'required',
+				'plugins.generic.plagiarism.manager.settings.serviceAccessInvalid',
+				$this->_plugin->initIthenticate(
+					$request->getUserVar('ithenticateApiUrl'),
+					$request->getUserVar('ithenticateApiKey')
+				)
+			)
+		);
 
 		$this->addCheck(new FormValidatorPost($this));
 		$this->addCheck(new FormValidatorCSRF($this));
@@ -77,26 +91,6 @@ public function fetch($request, $template = null, $display = false) {
 		return parent::fetch($request, $template, $display);
 	}
 
-	/**
-	 * @copydoc Form::validate()
-	 */
-	public function validate($callHooks = true) {
-		$this->addCheck(
-			new FormValidatorIthenticateAccess(
-				$this,
-				'',
-				'required',
-				'plugins.generic.plagiarism.manager.settings.serviceAccessInvalid',
-				$this->_plugin->initIthenticate(
-					$this->getData('ithenticateApiUrl'),
-					$this->getData('ithenticateApiKey')
-				)
-			)
-		);
-
-		return parent::validate($callHooks);
-	}
-
 	/**
 	 * @copydoc Form::execute()
 	 */
@@ -105,8 +99,8 @@ public function execute(...$functionArgs) {
 		$ithenticateApiKey = trim($this->getData('ithenticateApiKey'), "\"\';");
 
 		if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
-			$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey)
-		{
+			$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey) {
+			
 			// access updated or new access entered, need to update webhook registration	
 			$this->_plugin->registerIthenticateWebhook(
 				$this->_plugin->initIthenticate(
@@ -118,6 +112,7 @@ public function execute(...$functionArgs) {
 
 		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiUrl', $ithenticateApiUrl, 'string');
 		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
+
 		parent::execute(...$functionArgs);
 	}
 }
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 920b380..be2719a 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -15,7 +15,7 @@
 class TestIThenticate {
 
     /**
-     * The EULA(end user license agreement) that user need to confrim before making request
+     * The EULA(end user license agreement) that user need to confirm before making request
      * 
      * @var string|null
      */
@@ -100,7 +100,7 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
     }
 
     /**
-     * Validate the service access by retrieving the the enabled feature
+     * Validate the service access by retrieving the enabled feature
      * @see https://developers.turnitin.com/docs/tca#get-features-enabled
      * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
      * 
@@ -129,15 +129,15 @@ public function confirmEula($user, $context) {
      * Create a new submission at service's end
      * @see https://developers.turnitin.com/docs/tca#create-a-submission
      * 
-     * @param Submission    $submission
-     * @param User          $user
-     * @param Author|null   $author
-     * @param Site|null     $site
+     * @param Submission    $submission The article submission to check for plagiarism
+     * @param User          $user       The user who is making submitting the submission
+     * @param Author        $author     The author/owher of the submission
+     * @param Site          $site       The core site of submission system
      *
-     * @return string|null  if succeed, it will return the created submission UUID at service's end and 
-     *                      at failure, will return null
+     * @return string|null              if succeed, it will return the created submission UUID from 
+     *                                  service's end and at failure, will return null
      */
-    public function submitSubmission($submission, $user, $author = null, $site = null) {
+    public function createSubmission($submission, $user, $author, $site) {
         error_log("Creating a new submission with id {$submission->getId()} by submitter {$user->getId()} for owner {$author->getId()}");
         return \Illuminate\Support\Str::uuid()->__toString();
     }
@@ -157,6 +157,18 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
         return true;
     }
 
+    /**
+     * Schedule the similarity report generation process
+     * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
+     *
+     * @param string $submissionUuid The submission UUID return back from service
+     * @return bool
+     */
+    public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
+        error_log("Scheduled similarity report generation process for submission UUID {$submissionUuid}");
+        return true;
+    }
+
     /**
      * Verify if user has already confirmed the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
@@ -268,9 +280,9 @@ protected function getEulaConfirmationLocale($locale) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $euleLangs = $this->getEulaDetails()['available_languages'];
+        $eulaLangs = $this->getEulaDetails()['available_languages'];
         $locale = str_replace("_", "-", substr($locale, 0, 5));
 
-        return in_array($locale, $euleLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+        return in_array($locale, $eulaLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
     }
 }
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index 9e9099b..d6b38f1 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -26,8 +26,7 @@ class ValidatorIthenticateAccess extends Validator {
 	 */
     protected $ithenticate;
 
-    public function __construct($ithenticate)
-    {
+    public function __construct($ithenticate) {
         $this->ithenticate = $ithenticate;
     }
 
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 70e8d26..f386325 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -13,7 +13,10 @@
  * @brief Handle the webhook calls for plagiarism check
  */
 
+use Illuminate\Database\Capsule\Manager as Capsule;
+
 import('lib.pkp.classes.handler.PKPHandler');
+import("plugins.generic.plagiarism.IThenticate");
 
 class PlagiarismWebhookHandler extends PKPHandler {
 
@@ -45,18 +48,97 @@ public static function setPlugin($plugin) {
 	/**
 	 * Authorize this request.
 	 *
-	 * @return boolean
+	 * @return bool
 	 */
 	public function authorize($request, &$args, $roleAssignments) {
 		return true;
 	}
 
 	/**
-	 * Handle the incoming webhook request
+	 * Handle the incoming webhook request from iThenticate service
+	 *
+	 * @return void
+	 */
+	public function handle($data) {
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+
+		if (!$context->getData('ithenticate_webhook_id') || !$context->getData('ithenticate_webhook_signing_secret')) {
+			error_log("iThenticate webhook not configured for context id {$context->getId()}");
+			return;
+		}
+
+		$headers = collect(array_change_key_case(getallheaders(), CASE_LOWER));
+		$payload = file_get_contents('php://input');
+
+		if (!$headers->has(['x-turnitin-eventtype', 'x-turnitin-signature'])) {
+			error_log('Missing required iThenticate webhook headers');
+			return;
+		}
+		
+		if (!in_array($headers->get('x-turnitin-eventtype'), \Ithenticate::DEFAULT_WEBHOOK_EVENTS)) {
+			error_log("Invalid iThenticate webhook event type {$headers->get('x-turnitin-eventtype')}");
+			return;
+		}
+
+		if ($headers->get('x-turnitin-signature') !== hash_hmac("sha256", $payload, $context->getData('ithenticate_webhook_signing_secret'))) {
+			error_log('Invalid iThenticate webhook signature');
+			return;
+		}
+		
+		switch($headers->get('x-turnitin-eventtype')) {
+			case 'SUBMISSION_COMPLETE' :
+				$this->handleSubmissionCompletedEvent($context, $payload);
+				break;
+			default:
+				error_log("Handling the iThenticate webhook event {$headers->get('x-turnitin-eventtype')} is not implemented yet");
+		}
+	}
+
+	/**
+	 * Initiate the iThenticate similarity report generation process for given 
+	 * iThenticate submission id
+	 * 
+	 * @param Context $context 
+	 * @param string $payload
 	 *
 	 * @return void
 	 */
-	public function handle() {
-		error_log('PKP Plagiarism plugin handle webhook request');
+	protected function handleSubmissionCompletedEvent($context, $payload) {
+		$payload = json_decode($payload);
+		if ($payload->status !== 'COMPLETE') {
+			error_log("Unable to schedule the similarity report generation process with given ithenticate submission processing status {$payload->status} for iThenticate submission id {$payload->id}");
+			return;
+		}
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$ithenticateSubmission = Capsule::table($submissionFileDao->settingsTableName)
+			->where('setting_name', 'ithenticate_id')
+			->where('setting_value', $payload->id)
+			->first();
+		
+		if (!$ithenticateSubmission) {
+			error_log("Invalid iThenticate submission id {$payload->id} given");
+			return;
+		}
+
+		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
+		
+		if ((int)$submissionFile->getData('ithenticate_similarity_scheduled')) {
+			error_log("Similarity report generation process as already been scheduled for iThenticate submission id {$payload->id}");
+			return;
+		}
+
+		$ithenticate = static::$_plugin->initIthenticate(
+			...static::$_plugin->getServiceAccess($context)
+		);
+		if (!$ithenticate->scheduleSimilarityReportGenerationProcess($payload->id)) {
+			error_log("Failed to schedule the similarity report generation process for iThenticate submission id {$payload->id}");
+			return;
+		}
+
+		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
+		$submissionFileDao->updateObject($submissionFile);
 	}
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 54dd223..2528314 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -45,7 +45,7 @@ msgstr "iThenticate API KEY is required"
 
 msgid "plugins.generic.plagiarism.manager.settings.serviceAccessInvalid"
 msgstr ""
-"The specified API URL/KEY is invalid and can not establish connection to IThenticate API service."
+"The specified API URL/KEY is invalid and can not establish connection to iThenticate API service."
 "Please double-check the API URL/KEY and try again."
 
 msgid "plugins.generic.plagiarism.manager.settings.areForced"
@@ -55,4 +55,4 @@ msgid "plugins.generic.plagiarism.errorMessage"
 msgstr "Upload of submission {$submissionId} to iThenticate failed with error: {$errorMessage}"
 
 msgid "plugins.generic.plagiarism.submission.checklist.eula"
-msgstr "Plagiarism EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"
+msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"

From c22c0bd581faeb7a379d3cf9629682f668fbcb80 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 5 Apr 2024 04:40:21 +0600
Subject: [PATCH 11/75] pkp/plagiarism#52 code formatting

---
 IThenticate.inc.php                           |  2 +-
 PlagiarismPlugin.inc.php                      | 86 +++++++++----------
 PlagiarismSettingsForm.inc.php                |  2 +-
 .../ValidatorIthenticateAccess.inc.php        |  4 +-
 4 files changed, 47 insertions(+), 47 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 4a938e0..1ccc248 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -326,7 +326,7 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
                 'exceptions' => false,
             ]
         );
-        // ray(json_decode($response->getBody()->getContents()));
+
         return $response->getStatusCode() === 202;
     }
 
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index dd85262..9cc2668 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -487,19 +487,19 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 	}
 
 	/**
-     * @copydoc Plugin::getActions()
-     */
+	 * @copydoc Plugin::getActions()
+	 */
     public function getActions($request, $verb) {
-        $router = $request->getRouter();
+		$router = $request->getRouter();
 		import('lib.pkp.classes.linkAction.request.AjaxModal');
         
 		return array_merge(
 			$this->getEnabled() 
 				? [
 					new LinkAction(
-                    	'settings',
-                    	new AjaxModal(
-                            $router->url(
+						'settings',
+						new AjaxModal(
+							$router->url(
 								$request, 
 								null, 
 								null, 
@@ -507,45 +507,45 @@ public function getActions($request, $verb) {
 								null, 
 								['verb' => 'settings', 'plugin' => $this->getName(), 'category' => 'generic']
 							),
-                        	$this->getDisplayName()
-                    	),
-                    	__('manager.plugins.settings'),
-                    	null
-            		),
+							$this->getDisplayName()
+						),
+						__('manager.plugins.settings'),
+						null
+					),
 				] : [],
 			parent::getActions($request, $verb)
-        );
-    }
-
-    /**
-     * @copydoc Plugin::manage()
-     */
-    public function manage($args, $request) {
-        switch ($request->getUserVar('verb')) {
-            case 'settings':
-                $context = $request->getContext(); /** @var Context $context */
-
-                AppLocale::requireComponents(LOCALE_COMPONENT_APP_COMMON, LOCALE_COMPONENT_PKP_MANAGER);
-                $templateMgr = TemplateManager::getManager($request); /** @var TemplateManager $templateMgr */
-                $templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
-
-                $this->import('PlagiarismSettingsForm');
-                $form = new PlagiarismSettingsForm($this, $context);
-
-                if ($request->getUserVar('save')) {
-                    $form->readInputData();
-                    if ($form->validate()) {
-                        $form->execute();
-                        return new JSONMessage(true);
-                    }
-                } else {
-                    $form->initData();
-                }
-                return new JSONMessage(true, $form->fetch($request));
-        }
-
-        return parent::manage($args, $request);
-    }
+		);
+	}
+
+	/**
+	 * @copydoc Plugin::manage()
+	 */
+	public function manage($args, $request) {
+		switch ($request->getUserVar('verb')) {
+			case 'settings':
+				$context = $request->getContext(); /** @var Context $context */
+
+				AppLocale::requireComponents(LOCALE_COMPONENT_APP_COMMON, LOCALE_COMPONENT_PKP_MANAGER);
+				$templateMgr = TemplateManager::getManager($request); /** @var TemplateManager $templateMgr */
+				$templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
+
+				$this->import('PlagiarismSettingsForm');
+				$form = new PlagiarismSettingsForm($this, $context);
+
+				if ($request->getUserVar('save')) {
+					$form->readInputData();
+					if ($form->validate()) {
+						$form->execute();
+						return new JSONMessage(true);
+					}
+				} else {
+					$form->initData();
+				}
+				return new JSONMessage(true, $form->fetch($request));
+		}
+
+		return parent::manage($args, $request);
+	}
 
 	/**
 	 * Get the cached EULA details form Context
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 5597c71..10a0c4f 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -95,7 +95,7 @@ public function fetch($request, $template = null, $display = false) {
 	 * @copydoc Form::execute()
 	 */
 	public function execute(...$functionArgs) {
-        $ithenticateApiUrl = trim($this->getData('ithenticateApiUrl'), "\"\';");
+		$ithenticateApiUrl = trim($this->getData('ithenticateApiUrl'), "\"\';");
 		$ithenticateApiKey = trim($this->getData('ithenticateApiKey'), "\"\';");
 
 		if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index d6b38f1..ff5ff8f 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -31,6 +31,6 @@ public function __construct($ithenticate) {
     }
 
     public function isValid($value) {
-		return $this->ithenticate->validateAccess();
-	}
+        return $this->ithenticate->validateAccess();
+    }
 } 

From 7ca680117a2001391fbdeb87ef4b706035936835 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Sat, 6 Apr 2024 02:53:06 +0600
Subject: [PATCH 12/75] pkp/plagiarism#52 code rearranged

---
 controllers/PlagiarismWebhookHandler.inc.php | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index f386325..c2e72a9 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -59,18 +59,17 @@ public function authorize($request, &$args, $roleAssignments) {
 	 *
 	 * @return void
 	 */
-	public function handle($data) {
+	public function handle() {
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
+		$headers = collect(array_change_key_case(getallheaders(), CASE_LOWER));
+		$payload = file_get_contents('php://input');
 
 		if (!$context->getData('ithenticate_webhook_id') || !$context->getData('ithenticate_webhook_signing_secret')) {
 			error_log("iThenticate webhook not configured for context id {$context->getId()}");
 			return;
 		}
 
-		$headers = collect(array_change_key_case(getallheaders(), CASE_LOWER));
-		$payload = file_get_contents('php://input');
-
 		if (!$headers->has(['x-turnitin-eventtype', 'x-turnitin-signature'])) {
 			error_log('Missing required iThenticate webhook headers');
 			return;
@@ -99,8 +98,8 @@ public function handle($data) {
 	 * Initiate the iThenticate similarity report generation process for given 
 	 * iThenticate submission id
 	 * 
-	 * @param Context $context 
-	 * @param string $payload
+	 * @param Context 	$context 	The current context for which the webhook request has initiated
+	 * @param string 	$payload	The incoming request payload through webhook
 	 *
 	 * @return void
 	 */
@@ -126,7 +125,7 @@ protected function handleSubmissionCompletedEvent($context, $payload) {
 		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
 		
 		if ((int)$submissionFile->getData('ithenticate_similarity_scheduled')) {
-			error_log("Similarity report generation process as already been scheduled for iThenticate submission id {$payload->id}");
+			error_log("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}");
 			return;
 		}
 

From f37056d02c13d4570c3c953a4dbc003d0753ca6e Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 25 Apr 2024 15:20:25 +0600
Subject: [PATCH 13/75] pkp/plagiarism#52 added check to hanlde error when no
 ithenticate service set

---
 PlagiarismPlugin.inc.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 9cc2668..078668f 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -29,7 +29,7 @@ class PlagiarismPlugin extends GenericPlugin {
 	 * Set the value to `true` to enable test mode that will log instead of interacting with 
 	 * iThenticate API service.
 	 */
-	protected const ITHENTICATE_TEST_MODE_ENABLE = false;
+	protected const ITHENTICATE_TEST_MODE_ENABLE = true;
 
 	/**
 	 * @copydoc Plugin::register()
@@ -110,6 +110,11 @@ public function addEulaToChecklist($hookName, $params) {
 			return false;
 		}
 
+		if (!$this->isServiceAccessAvailable($context)) {
+			error_log("ithenticate service access not set for context id {$context->getId()}");
+			return false;
+		}
+
 		$eulaDetails = $this->getContextEulaDetails($context);
 		
 		foreach($context->getData('submissionChecklist') as $locale => $checklist) {

From ff6f8e95d69e3d8e723b3344d032d286ab95e391 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 25 Apr 2024 15:23:06 +0600
Subject: [PATCH 14/75] pkp/plagiarism#52 disable test mode by default

---
 PlagiarismPlugin.inc.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 078668f..4e18ddb 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -29,7 +29,7 @@ class PlagiarismPlugin extends GenericPlugin {
 	 * Set the value to `true` to enable test mode that will log instead of interacting with 
 	 * iThenticate API service.
 	 */
-	protected const ITHENTICATE_TEST_MODE_ENABLE = true;
+	protected const ITHENTICATE_TEST_MODE_ENABLE = false;
 
 	/**
 	 * @copydoc Plugin::register()

From ecf0456645d8fb1a39986b0e7d77b6326ec38d44 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 30 Apr 2024 18:39:23 +0600
Subject: [PATCH 15/75] pkp/plagiarism#52 functionality added to handle EULA
 confirmation requirement status

---
 IThenticate.inc.php      | 190 +++++++++++++++++++++++++++------------
 PlagiarismPlugin.inc.php | 127 ++++++++++++++++++--------
 TestIThenticate.inc.php  |  97 +++++++++++++++++++-
 3 files changed, 319 insertions(+), 95 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 1ccc248..914d5aa 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -65,6 +65,13 @@ class IThenticate
      */
     protected $apiBasePath = "API_URL/api/v1/";
 
+    /**
+     * Should suppress the exception on api request and log request details and exception instead
+     * 
+     * @var bool
+     */
+    protected $suppressApiRequestException = true;
+
     /**
      * The default EULA version placeholder to retrieve the current latest version
      * 
@@ -122,33 +129,79 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
         $this->eulaVersion          = $eulaVersion;
     }
 
+    /**
+     * Will deactivate the exception suppression on api request and throw exception
+     * 
+     * @return self
+     */
+    public function withoutSuppressingApiRequestException() {
+        $this->suppressApiRequestException = false;
+
+        return $this;
+    }
+
+    /**
+     * Get the json details of all enable features or get certiain feature details
+     * To get certain or nested feature details, pass the feature params in dot(.) notation
+     * For Example
+     *  - to get specific feature as `similarity`, call as getEnabledFeature('similarity')
+     *  - to get nested feature as `viewer_modes` in `similarity`, call as getEnabledFeature('similarity.viewer_modes')
+     * @see https://developers.turnitin.com/docs/tca#get-features-enabled
+     * 
+     * @param  mixed $feature The specific or nested feature details to get
+     * @return mixed
+     * 
+     * @throws \Exception
+     */
+    public function getEnabledFeature($feature = null) {
+        
+        $result = '{}';
+
+        if (!$this->validateAccess($result)) {
+            return $this->suppressApiRequestException
+                ? json_decode($result, true)
+                : throw new \Exception('unbale to validate access details');
+        }
+
+        $result = json_decode($result, true);
+
+        if (!$feature) {
+            return $result;
+        }
+
+        return data_get(
+            $result,
+            $feature,
+            fn () => $this->suppressApiRequestException
+                ? null
+                : throw new \Exception("Feature details {$feature} does not exist")
+        );
+    }
+
     /**
      * Validate the service access by retrieving the enabled feature
      * @see https://developers.turnitin.com/docs/tca#get-features-enabled
      * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
      * 
+     * @param  mixed $result    This may contains the returned enabled feature details from 
+     *                          request validation api end point if validated successfully.
      * @return bool
      */
-    public function validateAccess() {
-
-        try {
-            $response = Application::get()->getHttpClient()->request(
-                'GET',
-                $this->getApiPath('features-enabled'),
-                [
-                    'headers' => $this->getRequiredHeaders(),
-                    'verify' => false,
-                    'exceptions' => false,
-                    'http_errors' => false,
-                ]
-            );
-        } catch (\GuzzleHttp\Exception\ConnectException $exception) {
-            return false;
-        } catch (\Throwable $exception) {
-            throw $exception;
+    public function validateAccess(&$result = null) {
+        
+        $response = $this->makeApiRequest('GET', $this->getApiPath('features-enabled'), [
+            'headers' => $this->getRequiredHeaders(),
+            'verify' => false,
+            'exceptions' => false,
+            'http_errors' => false,
+        ]);
+
+        if ($response && $response->getStatusCode() === 200) {
+            $result = $response->getBody();
+            return true;
         }
 
-        return $response->getStatusCode() === 200;
+        return false;
     }
 
     /**
@@ -162,7 +215,7 @@ public function validateAccess() {
      */
     public function confirmEula($user, $context) {
         
-        $response = Application::get()->getHttpClient()->request(
+        $response = $this->makeApiRequest(
             'POST',
             $this->getApiPath("eula/{$this->getApplicableEulaVersion()}/accept"),
             [
@@ -179,7 +232,7 @@ public function confirmEula($user, $context) {
             ]
         );
 
-        return $response->getStatusCode() === 200;
+        return $response ? $response->getStatusCode() === 200 : false;
     }
     
     /**
@@ -199,7 +252,7 @@ public function createSubmission($submission, $user, $author, $site) {
         $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
         $author ??= $publication->getPrimaryAuthor();
 
-        $response = Application::get()->getHttpClient()->request(
+        $response = $this->makeApiRequest(
             'POST',
             $this->getApiPath("submissions"),
             [
@@ -234,7 +287,7 @@ public function createSubmission($submission, $user, $author, $site) {
             ]
         );
 
-        if ($response->getStatusCode() === 201) {
+        if ($response && $response->getStatusCode() === 201) {
             $result = json_decode($response->getBody()->getContents());
             return $result->id;
         }
@@ -254,7 +307,7 @@ public function createSubmission($submission, $user, $author, $site) {
      */
     public function uploadFile($submissionTacId, $fileName, $fileContent) {
         
-        $response = Application::get()->getHttpClient()->request(
+        $response = $this->makeApiRequest(
             'PUT',
             $this->getApiPath("submissions/{$submissionTacId}/original"),
             [
@@ -268,7 +321,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
             ]
         );
 
-        return $response->getStatusCode() === 202;
+        return $response ? $response->getStatusCode() === 202 : false;
     }
 
     /**
@@ -280,7 +333,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
      */
     public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
 
-        $response = Application::get()->getHttpClient()->request(
+        $response = $this->makeApiRequest(
             'PUT',
             $this->getApiPath("submissions/{$submissionUuid}/similarity"),
             [
@@ -327,7 +380,7 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
             ]
         );
 
-        return $response->getStatusCode() === 202;
+        return $response ? $response->getStatusCode() === 202 : false;
     }
 
     /**
@@ -341,7 +394,7 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
      */
     public function verifyUserEulaAcceptance($user, $version) {
 
-        $response = Application::get()->getHttpClient()->request(
+        $response = $this->makeApiRequest(
             'GET',
             $this->getApiPath("eula/{$version}/accept/" . $this->getGeneratedId('submitter' ,$user->getId())),
             [
@@ -350,7 +403,7 @@ public function verifyUserEulaAcceptance($user, $version) {
             ]
         );
         
-        return $response->getStatusCode() === 200;
+        return $response ? $response->getStatusCode() === 200 : false;
     }
 
     /**
@@ -362,14 +415,10 @@ public function verifyUserEulaAcceptance($user, $version) {
      */
     public function validateEulaVersion($version) {
 
-        $response = Application::get()->getHttpClient()->request(
-            'GET',
-            $this->getApiPath("eula/{$version}"),
-            [
-                'headers' => $this->getRequiredHeaders(),
-                'exceptions' => false,
-            ]
-        );
+        $response = $this->makeApiRequest('GET', $this->getApiPath("eula/{$version}"), [
+            'headers' => $this->getRequiredHeaders(),
+            'exceptions' => false,
+        ]);
         
         if ($response->getStatusCode() === 200) {
             $this->eulaVersionDetails = json_decode($response->getBody()->getContents(), true);
@@ -396,25 +445,21 @@ public function validateEulaVersion($version) {
      */
     public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WEBHOOK_EVENTS) {
 
-        $response = Application::get()->getHttpClient()->request(
-            'POST',
-            $this->getApiPath('webhooks'),
-            [
-                'headers' => array_merge($this->getRequiredHeaders(), [
-                    'Content-Type' => 'application/json',
-                ]),
-                'json' => [
-                    'signing_secret' => base64_encode($signingSecret),
-                    'url' => $url,
-                    'event_types' => $events,
-                    'allow_insecure' => true,
-                ],
-                'verify' => false,
-                'exceptions' => false,
-            ]
-        );
-
-        if ($response->getStatusCode() === 201) {
+        $response = $this->makeApiRequest('POST', $this->getApiPath('webhooks'), [
+            'headers' => array_merge($this->getRequiredHeaders(), [
+                'Content-Type' => 'application/json',
+            ]),
+            'json' => [
+                'signing_secret' => base64_encode($signingSecret),
+                'url' => $url,
+                'event_types' => $events,
+                'allow_insecure' => true,
+            ],
+            'verify' => false,
+            'exceptions' => false,
+        ]);
+
+        if ($response && $response->getStatusCode() === 201) {
             $result = json_decode($response->getBody()->getContents());
             return $result->id;
         }
@@ -477,6 +522,41 @@ public function getApplicableEulaUrl($locale = null) {
         return str_replace(static::DEFAULT_EULA_LANGUAGE, $applicableEulaLanguage, $eulaUrl);
     }
 
+    /**
+     * Make the api request
+     * 
+     * @param string                                $method  HTTP method.
+     * @param string|\Psr\Http\Message\UriInterface $uri     URI object or string.
+     * @param array                                 $options Request options to apply. See \GuzzleHttp\RequestOptions.
+     * 
+     * @return \Psr\Http\Message\ResponseInterface|null
+     * 
+     * @throws \Throwable
+     */
+    public function makeApiRequest($method, $url, $options = []) {
+        
+        $response = null;
+
+        try {
+            $response = Application::get()->getHttpClient()->request($method, $url, $options);
+        } catch (\Throwable $exception) {
+            error_log(
+                sprintf(
+                    'iThenticate API request to %s for %s method failed with options %s',
+                    $url,
+                    $method,
+                    print_r($options, true)
+                )
+            );
+
+            $this->suppressApiRequestException
+                ? error_log($exception->__toString())
+                : throw $exception;
+        }
+
+        return $response;
+    }
+
     /**
      * Convert given submission/context locale to service compatible and acceptable locale format
      * @see https://developers.turnitin.com/docs/tca#eula
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 4e18ddb..45f46ce 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -31,6 +31,15 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	protected const ITHENTICATE_TEST_MODE_ENABLE = false;
 
+	/**
+	 * Running in test mode
+	 * 
+	 * @return bool
+	 */
+	public static function isRunningInTestMode() {
+		return static::ITHENTICATE_TEST_MODE_ENABLE;
+	}
+
 	/**
 	 * @copydoc Plugin::register()
 	 */
@@ -52,7 +61,7 @@ public function register($category, $path, $mainContextId = null) {
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION_FILE, [$this, 'addPlagiarismCheckDataToSubmissionFileSchema']);
-		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addPlagiarismCheckWebhookDataToSchema']);
+		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addIthenticateConfigSettingsToContextSchema']);
 		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
 		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
 
@@ -105,7 +114,7 @@ public function getEnabled($contextId = null) {
 	public function addEulaToChecklist($hookName, $params) {
 		$templateManager = & $params[0]; /** @var TemplateManager $templateManager */
 		$context = $templateManager->getTemplateVars('currentContext'); /** @var Context $context */
-		
+
 		if (!$context || strtolower($templateManager->getTemplateVars('requestedPage') ?? '') !== 'submission') {
 			return false;
 		}
@@ -116,6 +125,11 @@ public function addEulaToChecklist($hookName, $params) {
 		}
 
 		$eulaDetails = $this->getContextEulaDetails($context);
+
+		// if EULA confirmation is not required, so no need to show EULA as part of submission checklist
+		if ($eulaDetails['require_eula'] === false) {
+			return false;
+		}
 		
 		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
 			array_push($checklist, [
@@ -198,7 +212,7 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 	 * 
 	 * @return bool
 	 */
-	public function addPlagiarismCheckWebhookDataToSchema($hookName, $params) {
+	public function addIthenticateConfigSettingsToContextSchema($hookName, $params) {
 		$schema =& $params[0];
 
 		$schema->properties->ithenticate_webhook_signing_secret = (object) [
@@ -337,11 +351,16 @@ public function stampEulaToSubmission($hookName, $args) {
 		$submission =& $args[0]; /** @var Submission $submission */
 		$context = Application::get()->getRequest()->getContext();
 
-		if (!static::ITHENTICATE_TEST_MODE_ENABLE && !$this->isServiceAccessAvailable($context)) {
+		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
 			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
 			return false;
 		}
 
+		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
+			// EULA confirmation is not required, so no stamping of EULA with the submission
+			return false;
+		}
+
 		$eulaDetails = $this->getContextEulaDetails(
 			Application::get()->getRequest()->getContext(), 
 			$submission->getData('locale')
@@ -361,8 +380,13 @@ public function stampEulaToSubmission($hookName, $args) {
 	 * The steps follows as:
 	 * 	- Check if proper service credentials(API Url and Key) are available
 	 *  - Register webhook for context if not already registered
-	 *  - Check and only proceed if EULA is stamped to submission at initial stage
-	 *  - Stamp the EULA confirmation to submittion submitter if has not confirmed the version already
+	 *  - Check for EULA confrimation requirement
+	 * 		- Required
+	 * 			- Only allow to proceed if EULA is stamped to submission at initial stage
+	 * 			- Stamp the EULA confirmation to submitter if has not confirmed the version already
+	 * 		- Not Required
+	 * 			- No Need to check the submission stamping to EULA
+	 * 			- No need to stamp the EULA to the submitter
 	 *  - Traversing the submission files
 	 *  	- Create new submission at ithenticate's end for each submission file
 	 * 		- Upload the file for newly created submission uuid return back from ithenticate
@@ -384,7 +408,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$author = $publication->getPrimaryAuthor();
 		$user = $request->getUser();
 
-		if (!static::ITHENTICATE_TEST_MODE_ENABLE && !$this->isServiceAccessAvailable($context)) {
+		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
 			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
 			return false;
 		}
@@ -396,28 +420,33 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			$this->registerIthenticateWebhook($ithenticate, $context);
 		}
 
-		// if EULA details not stamped to submission, not going to sent it for plagiarism check
-		if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
-			$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
-			return false;
-		}
+		// If EULA confirmation is not required,
+		// no need to check the EULA stamping to submission and submitter
+		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
 
-		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
-		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
-		
-		// Check if EULA stamped to submitter and if not, try to stamp it
-		if (!$user->getData('ithenticateEulaVersion') ||
-			$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
-			
-			// Check if user has ever already accepted this EULA version and if so, stamp it to user
-			// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
-			if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
-				$ithenticate->confirmEula($user, $context)) {
-				$this->stampEulaVersionToSubmittingUser($user, $submissionEulaVersion);
-			} else {
-				$this->sendErrorMessage($submission->getId(), 'Unable to stamp the EULA details to submission submitter');
+			// if EULA details not stamped to submission, not going to sent it for plagiarism check
+			if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
+				$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
 				return false;
 			}
+
+			$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+			$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
+			
+			// Check if EULA stamped to submitter and if not, try to stamp it
+			if (!$user->getData('ithenticateEulaVersion') ||
+				$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
+				
+				// Check if user has ever already accepted this EULA version and if so, stamp it to user
+				// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
+				if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
+					$ithenticate->confirmEula($user, $context)) {
+					$this->stampEulaVersionToSubmittingUser($user, $submissionEulaVersion);
+				} else {
+					$this->sendErrorMessage($submission->getId(), 'Unable to stamp the EULA details to submission submitter');
+					return false;
+				}
+			}
 		}
 
 		/** @var DAOResultIterator $submissionFiles */
@@ -555,35 +584,43 @@ public function manage($args, $request) {
 	/**
 	 * Get the cached EULA details form Context
 	 * 
-	 * @param Context 		$context
-	 * @param string|null 	$locale
+	 * @param Context 	$context
+	 * @param mixed 	$locale
+	 * @param mixed 	$default
 	 * 
-	 * @return array
+	 * @return mixed
 	 */
-	public function getContextEulaDetails($context, $locale = null) {
+	public function getContextEulaDetails($context, $key = null, $default = null) {
 		/** @var \FileCache $cache */
 		$cache = CacheManager::getManager()
 			->getCache(
 				'ithenticate_eula', 
 				$context->getId(),
-				[$this, 'retrieveApplicableEulaDetails']
+				[$this, 'retrieveEulaDetails']
 			);
 		
 		// if running on ithenticate test mode, set the cache life time to 60 seconds
-		$cacheLifetime = static::ITHENTICATE_TEST_MODE_ENABLE ? 60 : static::EULA_CACHE_LIFETIME;
+		$cacheLifetime = static::isRunningInTestMode() ? 60 : static::EULA_CACHE_LIFETIME;
 		if (time() - $cache->getCacheTime() > $cacheLifetime) {
 			$cache->flush();
 		}
 
+		// $cache->flush();
+
 		$eulaDetails = $cache->get($context->getId());
 
-		return $locale ? $eulaDetails[$locale] : $eulaDetails;
+		return $key 
+			? data_get($eulaDetails, $key, $default)
+			: $eulaDetails;
 	}
 
 	/**
-	 * Retrieved and generate the localized EULA details for given context 
-	 * and cache it in following format
+	 * Retrieved and generate the localized EULA details and EULA confirmation requirement
+	 * for given context and cache it in following format
 	 * [
+	 *   'require_eula' => null/true/false, // null => not possible to retrived, 
+	 * 										// true => EULA confirmation required, 
+	 * 										// false => EULA confirmation not required
 	 *   'en_US' => [
 	 *     'version' => '',
 	 *     'url' => '',
@@ -596,12 +633,24 @@ public function getContextEulaDetails($context, $locale = null) {
 	 * 
 	 * @return array
 	 */
-	public function retrieveApplicableEulaDetails($cache, $cacheId) {
+	public function retrieveEulaDetails($cache, $cacheId) {
 		$context = Application::get()->getRequest()->getContext();
 		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
 		$eulaDetails = [];
-		
-		if ($ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION)) {
+
+		$eulaDetails['require_eula'] = $ithenticate->getEnabledFeature('tenant.require_eula');
+
+		// If `require_eula` is set to `true` that is EULA confirmation is required
+		// and default EULA version is verified
+		// we will map and store locale key to eula details (version and url) in following structure
+		//   'en_US' => [
+		//     'version' => '',
+		//     'url' => '',
+		//   ],
+		//   ...
+		if ($eulaDetails['require_eula'] === true &&
+			$ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION)) {
+
 			foreach($context->getSupportedSubmissionLocaleNames() as $localeKey => $localeName) {
 				$eulaDetails[$localeKey] = [
 					'version' 	=> $ithenticate->getApplicableEulaVersion(),
@@ -630,7 +679,7 @@ public function retrieveApplicableEulaDetails($cache, $cacheId) {
 	 */
 	public function initIthenticate($apiUrl, $apiKey) {
 
-		if (static::ITHENTICATE_TEST_MODE_ENABLE) {
+		if (static::isRunningInTestMode()) {
 			import("plugins.generic.plagiarism.TestIThenticate");
 			return new \TestIThenticate(
 				$apiUrl,
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index be2719a..8e774ea 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -58,6 +58,13 @@ class TestIThenticate {
         ],
     ];
 
+    /**
+     * Should suppress the exception on api request and log request details and exception instead
+     * 
+     * @var bool
+     */
+    protected $suppressApiRequestException = true;
+
     /**
      * The default EULA version placeholder to retrieve the current latest version
      * 
@@ -99,14 +106,102 @@ public function __construct($apiUrl, $apiKey, $integrationName, $integrationVers
         error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
     }
 
+    /**
+     * Will deactivate the exception suppression on api request and throw exception
+     * 
+     * @return self
+     */
+    public function withoutSuppressingApiRequestException() {
+        $this->suppressApiRequestException = false;
+        error_log('deactivating api request exception suppression');
+        return $this;
+    }
+
+    /**
+     * Get the json details of all enable features or get certiain feature details
+     * To get certain or nested feature details, pass the feature params in dot(.) notation
+     * For Example
+     *  - to get specific feature as `similarity`, call as getEnabledFeature('similarity')
+     *  - to get nested feature as `viewer_modes` in `similarity`, call as getEnabledFeature('similarity.viewer_modes')
+     * 
+     * @param  mixed $feature The specific or nested feature details to get
+     * @return mixed
+     * 
+     * @throws \Exception
+     */
+    public function getEnabledFeature($feature = null) {
+        
+        $result = '{
+            "similarity": {
+                "viewer_modes": {
+                    "match_overview": true,
+                    "all_sources": true
+                },
+                "generation_settings": {
+                    "search_repositories": [
+                        "INTERNET",
+                        "PUBLICATION",
+                        "CROSSREF",
+                        "CROSSREF_POSTED_CONTENT",
+                        "SUBMITTED_WORK"
+                    ],
+                    "submission_auto_excludes": true
+                },
+                "view_settings": {
+                    "exclude_bibliography": true,
+                    "exclude_quotes": true,
+                    "exclude_abstract": true,
+                    "exclude_methods": true,
+                    "exclude_small_matches": true,
+                    "exclude_internet": true,
+                    "exclude_publications": true,
+                    "exclude_crossref": true,
+                    "exclude_crossref_posted_content": true,
+                    "exclude_submitted_works": true,
+                    "exclude_citations": true,
+                    "exclude_preprints": true
+                }
+            },
+            "tenant": {
+                "require_eula": false
+            },
+            "product_name": "Turnitin Originality",
+            "access_options": [
+                "NATIVE",
+                "CORE_API",
+                "DRAFT_COACH"
+            ]
+        }';
+
+        $result = json_decode($result, true);
+
+        if (!$feature) {
+            error_log("iThenticate enabled feature details {$result}");
+            return $result;
+        }
+
+        $featureStatus = data_get(
+            $result,
+            $feature,
+            fn () => $this->suppressApiRequestException
+                ? null
+                : throw new \Exception("Feature details {$feature} does not exist")
+        );
+
+        error_log("iThenticate specific enable feature details {$featureStatus}");
+        return $featureStatus;
+    }
+
     /**
      * Validate the service access by retrieving the enabled feature
      * @see https://developers.turnitin.com/docs/tca#get-features-enabled
      * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
      * 
+     * @param  mixed $result    This may contains the returned enabled feature details from 
+     *                          request validation api end point if validated successfully.
      * @return bool
      */
-    public function validateAccess() {
+    public function validateAccess(&$result = null) {
         error_log("Confirming the service access validation for given access details");
         return true;
     }

From d52111a644376d583806fb09153eafd73aeca9c7 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 6 May 2024 14:05:30 +0600
Subject: [PATCH 16/75] pkp/plagiarism#52 added *_permission_set for owner and
 submitter

---
 IThenticate.inc.php      | 52 +++++++++++++++++++---
 PlagiarismPlugin.inc.php | 95 ++++++++++++++++++++++++++++------------
 TestIThenticate.inc.php  | 56 ++++++++++++++++++++---
 3 files changed, 162 insertions(+), 41 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 914d5aa..5a3eaff 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -100,6 +100,22 @@ class IThenticate
         'GROUP_ATTACHMENT_COMPLETE',
     ];
 
+    /**
+     * The list of valid permission for owner and submitter when creating a new submission
+     * @see https://developers.turnitin.com/docs/tca#create-a-submission
+     * 
+     * @var array
+     */
+    public const SUBMISSION_PERMISSION_SET = [
+        'ADMINISTRATOR',
+        'APPLICANT',
+        'EDITOR',
+        'INSTRUCTOR',
+        'LEARNER',
+        'UNDEFINED',
+        'USER',
+    ];
+
     /**
      * The entity(e.g. submission owner, submitter etc) to id prefix mapping
      * This helps to identify the type of entity associated with requesting system
@@ -239,15 +255,27 @@ public function confirmEula($user, $context) {
      * Create a new submission at service's end
      * @see https://developers.turnitin.com/docs/tca#create-a-submission
      * 
-     * @param Submission    $submission The article submission to check for plagiarism
-     * @param User          $user       The user who is making submitting the submission
-     * @param Author        $author     The author/owher of the submission
-     * @param Site          $site       The core site of submission system
+     * @param Site          $site                   The core site of submission system
+     * @param Submission    $submission             The article submission to check for plagiarism
+     * @param User          $user                   The user who is making submitting the submission
+     * @param Author        $author                 The author/owner of the submission
+     * @param string        $authorPermission       Submission author/owner permission set
+     * @param string        $submitterPermission    Submission submitter permission set
      *
      * @return string|null              if succeed, it will return the created submission UUID from 
      *                                  service's end and at failure, will return null
+     * 
+     * @throws \Exception
      */
-    public function createSubmission($submission, $user, $author, $site) {
+    public function createSubmission($site, $submission, $user, $author, $authorPermission, $submitterPermission) {
+
+        if (!$this->validatePermission($authorPermission, static::SUBMISSION_PERMISSION_SET)) {
+            throw new \Exception("in valid owner permission {$authorPermission} given");
+        }
+
+        if (!$this->validatePermission($submitterPermission, static::SUBMISSION_PERMISSION_SET)) {
+            throw new \Exception("in valid submitter permission {$submitterPermission} given");
+        }
 
         $publication = $submission->getCurrentPublication(); /** @var Publication $publication */
         $author ??= $publication->getPrimaryAuthor();
@@ -263,6 +291,8 @@ public function createSubmission($submission, $user, $author, $site) {
                     'owner' => $this->getGeneratedId('owner', $author->getId()),
                     'title' => $publication->getLocalizedTitle($publication->getData('locale')),
                     'submitter' => $this->getGeneratedId('submitter', $user->getId()),
+                    'owner_default_permission_set' => $authorPermission,
+                    'submitter_default_permission_set' => $submitterPermission,
                     'metadata' => [
                         'owners' => [
                             [
@@ -627,4 +657,16 @@ protected function getGeneratedId($entity, $id, $silent = true) {
 
         return static::ENTITY_ID_PREFIXES[$entity] . $id;
     }
+
+    /**
+     * Validate the existence of a permission against a given permission set
+     * 
+     * @param  string   $permission     The specific permission to check for existence
+     * @param  array    $permissionSet  The permission list to check against
+     * 
+     * @return bool True/False if the permission exists in the given permission set
+     */
+    protected function validatePermission($permission, $permissionSet) {
+        return in_array($permission, $permissionSet);
+    }
 }
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 45f46ce..e22b4d1 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -20,6 +20,11 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	public const PLUGIN_INTEGRATION_NAME = 'Plagiarism plugin for OJS/OMP/OPS';
 
+	/**
+	 * The default permission of submission primary author's to pass to the iThenticate service
+	 */
+	public const SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION = 'USER';
+
 	/**
 	 * Number of seconds EULA details for a context should be cached before refreshing it
 	 */
@@ -454,36 +459,43 @@ public function submitForPlagiarismCheck($hookName, $args) {
             'submissionIds' => [$submission->getId()],
 		]);
 
-		foreach($submissionFiles as $submissionFile) { /** @var SubmissionFile $submissionFile */
-			// Create a new submission at iThenticate's end
-			$submissionUuid = $ithenticate->createSubmission(
-				$submission,
-				$user,
-				$author,
-				$request->getSite()
-			);
-
-			if (!$submissionUuid) {
-				$this->sendErrorMessage($submission->getId(), "Could not create the submission at iThenticate for file id {$submissionFile->getId()}");
-				return false;
-			}
-
-			$file = Services::get('file')->get($submissionFile->getData('fileId'));
-			$uploadStatus = $ithenticate->uploadFile(
-				$submissionUuid, 
-				$submissionFile->getData("name", $publication->getData("locale")),
-				Services::get('file')->fs->read($file->path),
-			);
-
-			// Upload submission files for successfully created submission at iThenticate's end
-			if (!$uploadStatus) {
-				$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")));
-				return false;
+		try {
+			foreach($submissionFiles as $submissionFile) { /** @var SubmissionFile $submissionFile */
+				// Create a new submission at iThenticate's end
+				$submissionUuid = $ithenticate->createSubmission(
+					$request->getSite(),
+					$submission,
+					$user,
+					$author,
+					static::SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION,
+					$this->getSubmitterPermission($context, $user)
+				);
+	
+				if (!$submissionUuid) {
+					$this->sendErrorMessage($submission->getId(), "Could not create the submission at iThenticate for file id {$submissionFile->getId()}");
+					return false;
+				}
+	
+				$file = Services::get('file')->get($submissionFile->getData('fileId'));
+				$uploadStatus = $ithenticate->uploadFile(
+					$submissionUuid, 
+					$submissionFile->getData("name", $publication->getData("locale")),
+					Services::get('file')->fs->read($file->path),
+				);
+	
+				// Upload submission files for successfully created submission at iThenticate's end
+				if (!$uploadStatus) {
+					$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")));
+					return false;
+				}
+	
+				$submissionFile->setData('ithenticate_id', $submissionUuid);
+				$submissionFile->setData('ithenticate_similarity_scheduled', 0);
+				$submissionFileDao->updateObject($submissionFile);
 			}
-
-			$submissionFile->setData('ithenticate_id', $submissionUuid);
-			$submissionFile->setData('ithenticate_similarity_scheduled', 0);
-			$submissionFileDao->updateObject($submissionFile);
+		} catch (\Throwable $exception) {
+			$this->sendErrorMessage($submission->getId(), $exception->getMessage());
+			return false;
 		}
 
 		return true;
@@ -743,4 +755,29 @@ protected function stampEulaVersionToSubmittingUser($user, $version) {
 
 		$userDao->updateObject($user);
 	}
+
+	/**
+	 * Get the submission submitter's appropriate permission based on role in the submission context
+	 * 
+	 * @param Context 	$context
+	 * @param User 		$user
+	 * 
+	 * @return string
+	 */
+	protected function getSubmitterPermission($context, $user) {
+		
+		if ($user->hasRole([ROLE_ID_SITE_ADMIN, ROLE_ID_MANAGER], $context->getId())) {
+			return 'ADMINISTRATOR';
+		}
+
+		if ($user->hasRole([ROLE_ID_SUB_EDITOR], $context->getId())) {
+			return 'EDITOR';
+		}
+
+		if ($user->hasRole([ROLE_ID_AUTHOR], $context->getId())) {
+			return 'USER';
+		}
+
+		return 'UNDEFINED';
+	}
 }
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 8e774ea..76bee46 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -93,6 +93,22 @@ class TestIThenticate {
         'GROUP_ATTACHMENT_COMPLETE',
     ];
 
+    /**
+     * The list of valid permission for owner and submitter when creating a new submission
+     * @see https://developers.turnitin.com/docs/tca#create-a-submission
+     * 
+     * @var array
+     */
+    public const SUBMISSION_PERMISSION_SET = [
+        'ADMINISTRATOR',
+        'APPLICANT',
+        'EDITOR',
+        'INSTRUCTOR',
+        'LEARNER',
+        'UNDEFINED',
+        'USER',
+    ];
+
     /**
      * Create a new instance
      * 
@@ -163,7 +179,7 @@ public function getEnabledFeature($feature = null) {
                 }
             },
             "tenant": {
-                "require_eula": false
+                "require_eula": true
             },
             "product_name": "Turnitin Originality",
             "access_options": [
@@ -224,16 +240,30 @@ public function confirmEula($user, $context) {
      * Create a new submission at service's end
      * @see https://developers.turnitin.com/docs/tca#create-a-submission
      * 
-     * @param Submission    $submission The article submission to check for plagiarism
-     * @param User          $user       The user who is making submitting the submission
-     * @param Author        $author     The author/owher of the submission
-     * @param Site          $site       The core site of submission system
+     * @param Site          $site                   The core site of submission system
+     * @param Submission    $submission             The article submission to check for plagiarism
+     * @param User          $user                   The user who is making submitting the submission
+     * @param Author        $author                 The author/owner of the submission
+     * @param string        $authorPermission       Submission author/owner permission set
+     * @param string        $submitterPermission    Submission submitter permission set
      *
      * @return string|null              if succeed, it will return the created submission UUID from 
      *                                  service's end and at failure, will return null
+     * 
+     * @throws \Exception
      */
-    public function createSubmission($submission, $user, $author, $site) {
-        error_log("Creating a new submission with id {$submission->getId()} by submitter {$user->getId()} for owner {$author->getId()}");
+    public function createSubmission($site, $submission, $user, $author, $authorPermission, $submitterPermission) {
+
+        if (!$this->validatePermission($authorPermission, static::SUBMISSION_PERMISSION_SET)) {
+            throw new \Exception("in valid owner permission {$authorPermission} given");
+        }
+
+        if (!$this->validatePermission($submitterPermission, static::SUBMISSION_PERMISSION_SET)) {
+            throw new \Exception("in valid submitter permission {$submitterPermission} given");
+        }
+
+        error_log("Creating a new submission with id {$submission->getId()} by submitter {$user->getId()} for owner {$author->getId()} with owner permission as {$authorPermission} and submitter permission as {$submitterPermission}");
+
         return \Illuminate\Support\Str::uuid()->__toString();
     }
 
@@ -380,4 +410,16 @@ protected function getEulaConfirmationLocale($locale) {
 
         return in_array($locale, $eulaLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
     }
+
+    /**
+     * Validate the existence of a permission against a given permission set
+     * 
+     * @param  string   $permission     The specific permission to check for existence
+     * @param  array    $permissionSet  The permission list to check against
+     * 
+     * @return bool True/False if the permission exists in the given permission set
+     */
+    protected function validatePermission($permission, $permissionSet) {
+        return in_array($permission, $permissionSet);
+    }
 }

From 1c6adccb5a295dd0470a461c68e36eecc86a4dea Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 6 May 2024 17:19:04 +0600
Subject: [PATCH 17/75] pkp/plagiarism#52 added SIMILARITY_COMPLETE and
 SIMILARITY_UPDATED event handler along with user notification system on
 webhook handle

---
 PlagiarismPlugin.inc.php                     | 46 +++++----
 controllers/PlagiarismWebhookHandler.inc.php | 98 +++++++++++++++-----
 locale/en_US/locale.po                       | 27 ++++++
 3 files changed, 134 insertions(+), 37 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index e22b4d1..4db0db9 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -205,6 +205,13 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 			'validation' => ['nullable'],
 		];
 
+		$schema->properties->ithenticate_similarity_result = (object) [
+			'type' => 'string',
+			'description' => 'The similarity check result for this submission file in json format',
+			'apiSummary' => true,
+			'validation' => ['nullable'],
+		];
+
 		return false;
 	}
 
@@ -293,14 +300,26 @@ public function hasForcedCredentials() {
 	/**
 	 * Send the editor an error message
 	 * 
-	 * @param int $submissionid
-	 * @param string $message
+	 * @param string 	$message			The error/exception message to set as notification and log in error file
+	 * @param int|null 	$submissionid		The submission id for which error/exception has generated
 	 * 
 	 * @return void
 	 */
-	public function sendErrorMessage($submissionId, $message) {
+	public function sendErrorMessage($message, $submissionId = null) {
+
 		$request = Application::get()->getRequest(); /** @var Request $request */
 		$context = $request->getContext(); /** @var Context $context */
+		$message = $submissionId
+			? __(
+				'plugins.generic.plagiarism.errorMessage', [
+					'submissionId' => $submissionId,
+					'errorMessage' => $message
+				]
+			) : __(
+				'plugins.generic.plagiarism.general.errorMessage', [
+					'errorMessage' => $message
+				]
+			);
 		
 		import('classes.notification.NotificationManager');
 		$notificationManager = new NotificationManager();
@@ -312,12 +331,7 @@ public function sendErrorMessage($submissionId, $message) {
 			$notificationManager->createTrivialNotification(
 				$manager->getId(), 
 				NOTIFICATION_TYPE_ERROR, 
-				['contents' => __(
-					'plugins.generic.plagiarism.errorMessage', [
-						'submissionId' => $submissionId,
-						'errorMessage' => $message
-					]
-				)]
+				['contents' => $message]
 			);
 		}
 
@@ -357,7 +371,7 @@ public function stampEulaToSubmission($hookName, $args) {
 		$context = Application::get()->getRequest()->getContext();
 
 		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
-			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
+			$this->sendErrorMessage("ithenticate service access not set for context id {$context->getId()}", $submission->getId());
 			return false;
 		}
 
@@ -414,7 +428,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$user = $request->getUser();
 
 		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
-			$this->sendErrorMessage($submission->getId(), "ithenticate service access not set for context id {$context->getId()}");
+			$this->sendErrorMessage("ithenticate service access not set for context id {$context->getId()}", $submission->getId());
 			return false;
 		}
 
@@ -431,7 +445,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 
 			// if EULA details not stamped to submission, not going to sent it for plagiarism check
 			if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
-				$this->sendErrorMessage($submission->getId(), 'Unable to obtain the stamped EULA details to submission');
+				$this->sendErrorMessage('Unable to obtain the stamped EULA details to submission', $submission->getId());
 				return false;
 			}
 
@@ -448,7 +462,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 					$ithenticate->confirmEula($user, $context)) {
 					$this->stampEulaVersionToSubmittingUser($user, $submissionEulaVersion);
 				} else {
-					$this->sendErrorMessage($submission->getId(), 'Unable to stamp the EULA details to submission submitter');
+					$this->sendErrorMessage('Unable to stamp the EULA details to submission submitter', $submission->getId());
 					return false;
 				}
 			}
@@ -472,7 +486,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 				);
 	
 				if (!$submissionUuid) {
-					$this->sendErrorMessage($submission->getId(), "Could not create the submission at iThenticate for file id {$submissionFile->getId()}");
+					$this->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
 					return false;
 				}
 	
@@ -485,7 +499,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 	
 				// Upload submission files for successfully created submission at iThenticate's end
 				if (!$uploadStatus) {
-					$this->sendErrorMessage($submission->getId(), 'Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")));
+					$this->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
 					return false;
 				}
 	
@@ -494,7 +508,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 				$submissionFileDao->updateObject($submissionFile);
 			}
 		} catch (\Throwable $exception) {
-			$this->sendErrorMessage($submission->getId(), $exception->getMessage());
+			$this->sendErrorMessage($exception->getMessage(), $submission->getId());
 			return false;
 		}
 
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index c2e72a9..5d63020 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -10,7 +10,7 @@
  * @class PlagiarismWebhookHandler
  * @ingroup plugins_generic_plagiarism
  *
- * @brief Handle the webhook calls for plagiarism check
+ * @brief Handle the incoming webhook events for plagiarism check
  */
 
 use Illuminate\Database\Capsule\Manager as Capsule;
@@ -66,28 +66,32 @@ public function handle() {
 		$payload = file_get_contents('php://input');
 
 		if (!$context->getData('ithenticate_webhook_id') || !$context->getData('ithenticate_webhook_signing_secret')) {
-			error_log("iThenticate webhook not configured for context id {$context->getId()}");
+			static::$_plugin->sendErrorMessage("iThenticate webhook not configured for context id {$context->getId()}");
 			return;
 		}
 
 		if (!$headers->has(['x-turnitin-eventtype', 'x-turnitin-signature'])) {
-			error_log('Missing required iThenticate webhook headers');
+			static::$_plugin->sendErrorMessage('Missing required iThenticate webhook headers');
 			return;
 		}
 		
 		if (!in_array($headers->get('x-turnitin-eventtype'), \Ithenticate::DEFAULT_WEBHOOK_EVENTS)) {
-			error_log("Invalid iThenticate webhook event type {$headers->get('x-turnitin-eventtype')}");
+			static::$_plugin->sendErrorMessage("Invalid iThenticate webhook event type {$headers->get('x-turnitin-eventtype')}");
 			return;
 		}
 
 		if ($headers->get('x-turnitin-signature') !== hash_hmac("sha256", $payload, $context->getData('ithenticate_webhook_signing_secret'))) {
-			error_log('Invalid iThenticate webhook signature');
+			static::$_plugin->sendErrorMessage('Invalid iThenticate webhook signature');
 			return;
 		}
 		
 		switch($headers->get('x-turnitin-eventtype')) {
 			case 'SUBMISSION_COMPLETE' :
-				$this->handleSubmissionCompletedEvent($context, $payload);
+				$this->handleSubmissionCompleteEvent($context, $payload, $headers->get('x-turnitin-eventtype'));
+				break;
+			case 'SIMILARITY_COMPLETE' :
+			case 'SIMILARITY_UPDATED' :
+				$this->storeSimilarityScore($context, $payload, $headers->get('x-turnitin-eventtype'));
 				break;
 			default:
 				error_log("Handling the iThenticate webhook event {$headers->get('x-turnitin-eventtype')} is not implemented yet");
@@ -96,36 +100,39 @@ public function handle() {
 
 	/**
 	 * Initiate the iThenticate similarity report generation process for given 
-	 * iThenticate submission id
+	 * iThenticate submission id at receiving webhook event `SUBMISSION_COMPLETE`
 	 * 
 	 * @param Context 	$context 	The current context for which the webhook request has initiated
 	 * @param string 	$payload	The incoming request payload through webhook
+	 * @param string 	$event		The incoming webhook request event
 	 *
 	 * @return void
 	 */
-	protected function handleSubmissionCompletedEvent($context, $payload) {
+	protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 		$payload = json_decode($payload);
-		if ($payload->status !== 'COMPLETE') {
-			error_log("Unable to schedule the similarity report generation process with given ithenticate submission processing status {$payload->status} for iThenticate submission id {$payload->id}");
+
+		$ithenticateSubmission = $this->getIthenticateSubmission($payload->id);
+
+		if (!$ithenticateSubmission) {
+			static::$_plugin->sendErrorMessage("Invalid iThenticate submission id {$payload->id} given for webhook event {$event}");
 			return;
 		}
 
 		/** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
-		$ithenticateSubmission = Capsule::table($submissionFileDao->settingsTableName)
-			->where('setting_name', 'ithenticate_id')
-			->where('setting_value', $payload->id)
-			->first();
-		
-		if (!$ithenticateSubmission) {
-			error_log("Invalid iThenticate submission id {$payload->id} given");
+		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
+
+		if ($payload->status !== 'COMPLETE') {
+			// If the status not `COMPLETE`, then it's `ERROR`
+			static::$_plugin->sendErrorMessage(
+				"Unable to schedule the similarity report generation for file id {$submissionFile->getId()} with error : " . __("plugins.generic.plagiarism.ithenticate.submission.error.{$payload->error_code}"),
+				$submissionFile->getData('submissionId')
+			);
 			return;
 		}
-
-		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
 		
 		if ((int)$submissionFile->getData('ithenticate_similarity_scheduled')) {
-			error_log("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}");
+			static::$_plugin->sendErrorMessage("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
 			return;
 		}
 
@@ -133,11 +140,60 @@ protected function handleSubmissionCompletedEvent($context, $payload) {
 			...static::$_plugin->getServiceAccess($context)
 		);
 		if (!$ithenticate->scheduleSimilarityReportGenerationProcess($payload->id)) {
-			error_log("Failed to schedule the similarity report generation process for iThenticate submission id {$payload->id}");
+			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
 			return;
 		}
 
 		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
 		$submissionFileDao->updateObject($submissionFile);
 	}
+
+	/**
+	 * Store or Update the result of similarity check for a submission file at receiving
+	 * the webook event `SIMILARITY_COMPLETE` or `SIMILARITY_UPDATED`
+	 * 
+	 * @param Context 	$context 	The current context for which the webhook request has initiated
+	 * @param string 	$payload	The incoming request payload through webhook
+	 * @param string 	$event		The incoming webhook request event
+	 *
+	 * @return void
+	 */
+	protected function storeSimilarityScore($context, $payload, $event) {
+		$payload = json_decode($payload);
+
+		// we will not store similarity check result unless it has completed
+		if ($payload->status !== 'COMPLETE') {
+			return;
+		}
+
+		$ithenticateSubmission = $this->getIthenticateSubmission($payload->submission_id);
+
+		if (!$ithenticateSubmission) {
+			static::$_plugin->sendErrorMessage("Invalid iThenticate submission id {$payload->submission_id} given for webhook event {$event}");
+			return;
+		}
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
+		$submissionFile->setData('ithenticate_similarity_result', json_encode($payload));
+		$submissionFileDao->updateObject($submissionFile);
+	}
+
+	/**
+	 * Get the row data as object from submission file settings table or null if none found
+	 * 
+	 * @param string 	$id 	The given iThenticate submission id in UUID format
+	 * @return object|null
+	 */
+	private function getIthenticateSubmission($id) {
+		
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+
+		return Capsule::table($submissionFileDao->settingsTableName)
+			->where('setting_name', 'ithenticate_id')
+			->where('setting_value', $id)
+			->first();
+	}
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 2528314..e94462c 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -54,5 +54,32 @@ msgstr "iThenticate settings were found in config.inc.php and the settings here
 msgid "plugins.generic.plagiarism.errorMessage"
 msgstr "Upload of submission {$submissionId} to iThenticate failed with error: {$errorMessage}"
 
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.UNSUPPORTED_FILETYPE"
+msgstr "The uploaded filetype is not supported."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.PROCESSING_ERROR"
+msgstr "An unspecified error occurred while processing the submissions."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.CANNOT_EXTRACT_TEXT"
+msgstr "The submisison does not contain text to generate a Similarity Report or the word count of the submissions is 0 ."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_LITTLE_TEXT"
+msgstr "The submission does not have enough text to generate a Similarity Report (a submission must contain at least 20 words)."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_MUCH_TEXT"
+msgstr "The submission has too much text to generate a Similarity Report (after extracted text is converted to UTF-8, the submission must contain less than 2MB of text)."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_MANY_PAGES"
+msgstr "The submission has too many pages to generate a Similarity Report (a submission cannot contain more than 800 pages)."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.FILE_LOCKED"
+msgstr "The uploaded file requires a password in order to be opened."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.error.CORRUPT_FILE"
+msgstr "The uploaded file appears to be corrupt."
+
+msgid "plugins.generic.plagiarism.general.errorMessage"
+msgstr "Request processing error : {$errorMessage}"
+
 msgid "plugins.generic.plagiarism.submission.checklist.eula"
 msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"

From 15ac8f87ad847c0b39582848fc6413eda46ef1fa Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 8 May 2024 18:23:55 +0600
Subject: [PATCH 18/75] pkp/plagiarism#52 added specific few similarty report
 generation config setting as part of plugins settings

---
 IThenticate.inc.php                          |  62 +++----
 PlagiarismPlugin.inc.php                     | 102 +++++++----
 PlagiarismSettingsForm.inc.php               |  92 ++++++----
 TestIThenticate.inc.php                      | 173 ++++---------------
 controllers/PlagiarismWebhookHandler.inc.php |  11 +-
 locale/en_US/locale.po                       |  30 ++++
 templates/settingsForm.tpl                   |  57 +++++-
 7 files changed, 285 insertions(+), 242 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 5a3eaff..512242d 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -165,28 +165,26 @@ public function withoutSuppressingApiRequestException() {
      * @see https://developers.turnitin.com/docs/tca#get-features-enabled
      * 
      * @param  mixed $feature The specific or nested feature details to get
-     * @return mixed
+     * @return string|array|null
      * 
      * @throws \Exception
      */
     public function getEnabledFeature($feature = null) {
         
-        $result = '{}';
+        static $result;
 
-        if (!$this->validateAccess($result)) {
+        if (!isset($result) && !$this->validateAccess($result)) {
             return $this->suppressApiRequestException
-                ? json_decode($result, true)
+                ? []
                 : throw new \Exception('unbale to validate access details');
         }
 
-        $result = json_decode($result, true);
-
         if (!$feature) {
-            return $result;
+            return json_decode($result, true);
         }
 
         return data_get(
-            $result,
+            json_decode($result, true),
             $feature,
             fn () => $this->suppressApiRequestException
                 ? null
@@ -204,7 +202,7 @@ public function getEnabledFeature($feature = null) {
      * @return bool
      */
     public function validateAccess(&$result = null) {
-        
+
         $response = $this->makeApiRequest('GET', $this->getApiPath('features-enabled'), [
             'headers' => $this->getRequiredHeaders(),
             'verify' => false,
@@ -213,7 +211,7 @@ public function validateAccess(&$result = null) {
         ]);
 
         if ($response && $response->getStatusCode() === 200) {
-            $result = $response->getBody();
+            $result = $response->getBody()->getContents();
             return true;
         }
 
@@ -358,11 +356,13 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
      * Schedule the similarity report generation process
      * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
      *
-     * @param string $submissionUuid The submission UUID return back from service
+     * @param string    $submissionUuid The submission UUID return back from service
+     * @param array     $settings       The specific few settings
+     * 
      * @return bool
      */
-    public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
-
+    public function scheduleSimilarityReportGenerationProcess($submissionUuid, $settings = []) {
+        
         $response = $this->makeApiRequest(
             'PUT',
             $this->getApiPath("submissions/{$submissionUuid}/similarity"),
@@ -373,37 +373,39 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
                 'json' => [
                     // section `indexing_settings` settings
                     'indexing_settings' => [
-                        'add_to_index' => true,
+                        'add_to_index' => $settings['addToIndex'] ?? true,
                     ],
 
                     // section `generation_settings` settings
                     'generation_settings' => [
-                        'search_repositories' => [
+                        'search_repositories' => $this->getEnabledFeature(
+                            'similarity.generation_settings.search_repositories'
+                        ) ?? [
                             'INTERNET',
                             'SUBMITTED_WORK',
                             'PUBLICATION',
                             'CROSSREF',
                             'CROSSREF_POSTED_CONTENT'
                         ],
-                        'auto_exclude_self_matching_scope' => 'ALL',
-                        'priority' => 'HIGH',
+                        'auto_exclude_self_matching_scope' => $settings['autoExcludeSelfMatchingScope'] ?? 'ALL',
+                        'priority' => $settings['priority'] ?? 'HIGH',
                     ],
 
                     // section `view_settings` settings
                     'view_settings' => [
-                        'exclude_quotes' => true,
-                        'exclude_bibliography' => true,
-                        'exclude_citations' => false,
-                        'exclude_abstract' => false,
-                        'exclude_methods' => false,
-                        'exclude_custom_sections' => false,
-                        'exclude_preprints' => false,
-                        'exclude_small_matches' => 8,
-                        'exclude_internet' => false,
-                        'exclude_publications' => false,
-                        'exclude_crossref' => false,
-                        'exclude_crossref_posted_content' => false,
-                        'exclude_submitted_works' => false,
+                        'exclude_quotes'                    => $settings['excludeQuotes']                   ?? false,
+                        'exclude_bibliography'              => $settings['excludeBibliography']             ?? false,
+                        'exclude_citations'                 => $settings['excludeCitations']                ?? false,
+                        'exclude_abstract'                  => $settings['excludeAbstract']                 ?? false,
+                        'exclude_methods'                   => $settings['excludeMethods']                  ?? false,
+                        'exclude_custom_sections'           => $settings['excludeCustomSections']           ?? false,
+                        'exclude_preprints'                 => $settings['excludePreprints']                ?? false,
+                        'exclude_small_matches'             => $settings['excludeSmallMatches']             ?? 8,
+                        'exclude_internet'                  => $settings['excludeInternet']                 ?? false,
+                        'exclude_publications'              => $settings['excludePublications']             ?? false,
+                        'exclude_crossref'                  => $settings['excludeCrossref']                 ?? false,
+                        'exclude_crossref_posted_content'   => $settings['excludeCrossrefPostedContent']    ?? false,
+                        'exclude_submitted_works'           => $settings['excludeSubmittedWorks']           ?? false,
                     ],
                 ],
                 'exceptions' => false,
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 4db0db9..f457669 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -262,41 +262,6 @@ public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
 		return false;
 	}
 
-	/**
-	 * Fetch credentials from config.inc.php, if available
-	 * 
-	 * @return array api url and api key, or null(s)
-	 */
-	public function getForcedCredentials() {
-		$request = Application::get()->getRequest(); /** @var Request $request */
-		$context = $request->getContext(); /** @var Context $context */
-		$contextPath = $context ? $context->getPath() : 'index';
-
-		$apiUrl = Config::getVar(
-			'ithenticate',
-			'api_url[' . $contextPath . ']',
-			Config::getVar('ithenticate', 'api_url')
-		);
-
-		$apiKey = Config::getVar(
-			'ithenticate',
-			'api_key[' . $contextPath . ']',
-			Config::getVar('ithenticate', 'api_key')
-		);
-
-		return [$apiUrl, $apiKey];
-	}
-
-	/**
-	 * Check and determine if plagiarism checking service creds has been set forced in config.inc.php
-	 * 
-	 * @return bool
-	 */
-	public function hasForcedCredentials() {
-		list($apiUrl, $apiKey) = $this->getForcedCredentials();
-		return !empty($apiUrl) && !empty($apiKey);
-	}
-
 	/**
 	 * Send the editor an error message
 	 * 
@@ -565,7 +530,11 @@ public function getActions($request, $verb) {
 								null, 
 								'manage', 
 								null, 
-								['verb' => 'settings', 'plugin' => $this->getName(), 'category' => 'generic']
+								[
+									'verb' => 'settings',
+									'plugin' => $this->getName(),
+									'category' => 'generic'
+								]
 							),
 							$this->getDisplayName()
 						),
@@ -743,6 +712,67 @@ public function getServiceAccess($context) {
 		return [$apiUrl, $apiKey];
 	}
 
+	/**
+	 * Fetch credentials from config.inc.php, if available
+	 * 
+	 * @return array api url and api key, or null(s)
+	 */
+	public function getForcedCredentials() {
+		$context = Application::get()->getRequest()->getContext(); /** @var Context $context */
+		$contextPath = $context ? $context->getPath() : 'index';
+
+		$apiUrl = $this->getForcedConfigSetting($contextPath, 'api_url');
+		$apiKey = $this->getForcedConfigSetting($contextPath, 'api_key');
+
+		return [$apiUrl, $apiKey];
+	}
+
+	/**
+	 * Check and determine if plagiarism checking service creds has been set forced in config.inc.php
+	 * 
+	 * @return bool
+	 */
+	public function hasForcedCredentials() {
+		list($apiUrl, $apiKey) = $this->getForcedCredentials();
+		return !empty($apiUrl) && !empty($apiKey);
+	}
+
+	/**
+	 * Get the configuration settings for ithenticate similarity report generation process
+	 * 
+	 * @param Context $context
+	 * @return array
+	 */
+	public function getSimilarityConfigSettings($context) {
+		$contextPath = $context->getPath();
+
+		return [
+			'addToIndex' 			=> $this->getForcedConfigSetting($contextPath, 'addToIndex') 			?? $this->getSetting($context->getId(), 'addToIndex'),
+			'excludeQuotes' 		=> $this->getForcedConfigSetting($contextPath, 'excludeQuotes') 		?? $this->getSetting($context->getId(), 'excludeQuotes'),
+			'excludeBibliography' 	=> $this->getForcedConfigSetting($contextPath, 'excludeBibliography') 	?? $this->getSetting($context->getId(), 'excludeBibliography'),
+			'excludeCitations' 		=> $this->getForcedConfigSetting($contextPath, 'excludeCitations') 		?? $this->getSetting($context->getId(), 'excludeCitations'),
+			'excludeAbstract' 		=> $this->getForcedConfigSetting($contextPath, 'excludeAbstract') 		?? $this->getSetting($context->getId(), 'excludeAbstract'),
+			'excludeMethods' 		=> $this->getForcedConfigSetting($contextPath, 'excludeMethods') 		?? $this->getSetting($context->getId(), 'excludeMethods'),
+			'excludeSmallMatches' 	=> $this->getForcedConfigSetting($contextPath, 'excludeSmallMatches') 	?? $this->getSetting($context->getId(), 'excludeSmallMatches'),
+		];
+	}
+
+	/**
+	 * Get the forced config at global or context level if defined
+	 * 
+	 * @param string $contextPath
+	 * @param string $configKeyName
+	 * 
+	 * @return mixed
+	 */
+	protected function getForcedConfigSetting($contextPath, $configKeyName) {
+		return Config::getVar(
+			'ithenticate',
+			"{$configKeyName}[{$contextPath}]",
+			Config::getVar('ithenticate', $configKeyName)
+		);
+	}
+
 	/**
 	 * Check is ithenticate service access details(API URL & KEY) available for given context
 	 * 
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 10a0c4f..264c071 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -44,21 +44,23 @@ public function __construct($plugin, $context) {
 
 		parent::__construct($plugin->getTemplateResource('settingsForm.tpl'));
 
-		$this->addCheck(new FormValidator($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlRequired'));
-		$this->addCheck(new FormValidator($this, 'ithenticateApiKey', 'required', 'plugins.generic.plagiarism.manager.settings.apiKeyRequired'));
-		$this->addCheck(new FormValidatorUrl($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlInvalid'));
-		$this->addCheck(
-			new FormValidatorIthenticateAccess(
-				$this,
-				'',
-				'required',
-				'plugins.generic.plagiarism.manager.settings.serviceAccessInvalid',
-				$this->_plugin->initIthenticate(
-					$request->getUserVar('ithenticateApiUrl'),
-					$request->getUserVar('ithenticateApiKey')
+		if (!empty(array_filter([$request->getUserVar('ithenticateApiUrl'), $request->getUserVar('ithenticateApiKey')]))) {
+			$this->addCheck(new FormValidator($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlRequired'));
+			$this->addCheck(new FormValidator($this, 'ithenticateApiKey', 'required', 'plugins.generic.plagiarism.manager.settings.apiKeyRequired'));
+			$this->addCheck(new FormValidatorUrl($this, 'ithenticateApiUrl', 'required', 'plugins.generic.plagiarism.manager.settings.apiUrlInvalid'));
+			$this->addCheck(
+				new FormValidatorIthenticateAccess(
+					$this,
+					'',
+					'required',
+					'plugins.generic.plagiarism.manager.settings.serviceAccessInvalid',
+					$this->_plugin->initIthenticate(
+						$request->getUserVar('ithenticateApiUrl'),
+						$request->getUserVar('ithenticateApiKey')
+					)
 				)
-			)
-		);
+			);
+		}
 
 		$this->addCheck(new FormValidatorPost($this));
 		$this->addCheck(new FormValidatorCSRF($this));
@@ -69,9 +71,16 @@ public function __construct($plugin, $context) {
 	 */
 	public function initData() {
 		$this->_data = [
-			'ithenticateApiUrl' => $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
-			'ithenticateApiKey' => $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
-			'ithenticateForced' => $this->_plugin->hasForcedCredentials(),
+			'ithenticateForced' 	=> $this->_plugin->hasForcedCredentials(),
+			'ithenticateApiUrl' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
+			'ithenticateApiKey' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
+			'addToIndex' 			=> $this->_plugin->getSetting($this->_context->getId(), 'addToIndex'),
+			'excludeQuotes' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeQuotes'),
+			'excludeBibliography' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeBibliography'),
+			'excludeCitations' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeCitations'),
+			'excludeAbstract' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeAbstract'),
+			'excludeMethods' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeMethods'),
+			'excludeSmallMatches' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeSmallMatches'),
 		];
 	}
 
@@ -79,7 +88,17 @@ public function initData() {
 	 * Assign form data to user-submitted data.
 	 */
 	public function readInputData() {
-		$this->readUserVars(['ithenticateApiUrl', 'ithenticateApiKey']);
+		$this->readUserVars([
+			'ithenticateApiUrl',
+			'ithenticateApiKey',
+			'addToIndex',
+			'excludeQuotes',
+			'excludeBibliography',
+			'excludeCitations',
+			'excludeAbstract',
+			'excludeMethods',
+			'excludeSmallMatches',
+		]);
 	}
 
 	/**
@@ -95,23 +114,36 @@ public function fetch($request, $template = null, $display = false) {
 	 * @copydoc Form::execute()
 	 */
 	public function execute(...$functionArgs) {
+		
 		$ithenticateApiUrl = trim($this->getData('ithenticateApiUrl'), "\"\';");
 		$ithenticateApiKey = trim($this->getData('ithenticateApiKey'), "\"\';");
 
-		if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
-			$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey) {
-			
-			// access updated or new access entered, need to update webhook registration	
-			$this->_plugin->registerIthenticateWebhook(
-				$this->_plugin->initIthenticate(
-					$this->getData('ithenticateApiUrl'),
-					$this->getData('ithenticateApiKey')
-				)
-			);
+		if (!empty(array_filter([$ithenticateApiUrl, $ithenticateApiKey]))) {
+
+			if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
+				$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey) {
+				
+				// access updated or new access entered, need to update webhook registration	
+				$this->_plugin->registerIthenticateWebhook(
+					$this->_plugin->initIthenticate(
+						$this->getData('ithenticateApiUrl'),
+						$this->getData('ithenticateApiKey')
+					)
+				);
+			}
+
+			$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiUrl', $ithenticateApiUrl, 'string');
+			$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
 		}
 
-		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiUrl', $ithenticateApiUrl, 'string');
-		$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
+		$this->_plugin->updateSetting($this->_context->getId(), 'addToIndex', 			$this->getData('addToIndex'), 			'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeQuotes', 		$this->getData('excludeQuotes'), 		'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeBibliography', 	$this->getData('excludeBibliography'), 	'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeCitations', 	$this->getData('excludeCitations'), 	'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeAbstract', 		$this->getData('excludeAbstract'), 		'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeMethods', 		$this->getData('excludeMethods'), 		'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'excludeSmallMatches', 	$this->getData('excludeSmallMatches'), 	'int');
+		
 
 		parent::execute(...$functionArgs);
 	}
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 76bee46..f0e756e 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -15,16 +15,12 @@
 class TestIThenticate {
 
     /**
-     * The EULA(end user license agreement) that user need to confirm before making request
-     * 
-     * @var string|null
+     * @copydoc \IThenticate::$eulaVersion
      */
     protected $eulaVersion = 'v1beta';
 
     /**
-     * The EULA details for a specific version
-     * 
-     * @var array|null
+     * @copydoc \IThenticate::$eulaVersionDetails
      */
     protected $eulaVersionDetails = [
         "version" => "v1beta",
@@ -59,31 +55,22 @@ class TestIThenticate {
     ];
 
     /**
-     * Should suppress the exception on api request and log request details and exception instead
-     * 
-     * @var bool
+     * @copydoc \IThenticate::$suppressApiRequestException
      */
     protected $suppressApiRequestException = true;
 
     /**
-     * The default EULA version placeholder to retrieve the current latest version
-     * 
-     * @var string
+     * @copydoc \IThenticate::DEFAULT_EULA_VERSION
      */
     public const DEFAULT_EULA_VERSION = 'latest';
     
     /**
-     * The default EULA confirming language
-     * 
-     * @var string
+     * @copydoc \IThenticate::DEFAULT_EULA_LANGUAGE
      */
     public const DEFAULT_EULA_LANGUAGE = 'en-US';
 
     /**
-     * The default webhook events for which webhook request will be received
-     * @see https://developers.turnitin.com/docs/tca#event-types
-     * 
-     * @var array
+     * @copydoc \IThenticate::DEFAULT_WEBHOOK_EVENTS
      */
     public const DEFAULT_WEBHOOK_EVENTS = [
         'SUBMISSION_COMPLETE',
@@ -94,10 +81,7 @@ class TestIThenticate {
     ];
 
     /**
-     * The list of valid permission for owner and submitter when creating a new submission
-     * @see https://developers.turnitin.com/docs/tca#create-a-submission
-     * 
-     * @var array
+     * @copydoc \IThenticate::SUBMISSION_PERMISSION_SET
      */
     public const SUBMISSION_PERMISSION_SET = [
         'ADMINISTRATOR',
@@ -110,22 +94,14 @@ class TestIThenticate {
     ];
 
     /**
-     * Create a new instance
-     * 
-     * @param string        $apiUrl
-     * @param string        $apiKey
-     * @param string        $integrationName
-     * @param string        $integrationVersion
-     * @param string|null   eulaVersion
+     * @copydoc \IThenticate::__construct()
      */
     public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
         error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
     }
 
     /**
-     * Will deactivate the exception suppression on api request and throw exception
-     * 
-     * @return self
+     * @copydoc \IThenticate::withoutSuppressingApiRequestException()
      */
     public function withoutSuppressingApiRequestException() {
         $this->suppressApiRequestException = false;
@@ -134,20 +110,11 @@ public function withoutSuppressingApiRequestException() {
     }
 
     /**
-     * Get the json details of all enable features or get certiain feature details
-     * To get certain or nested feature details, pass the feature params in dot(.) notation
-     * For Example
-     *  - to get specific feature as `similarity`, call as getEnabledFeature('similarity')
-     *  - to get nested feature as `viewer_modes` in `similarity`, call as getEnabledFeature('similarity.viewer_modes')
-     * 
-     * @param  mixed $feature The specific or nested feature details to get
-     * @return mixed
-     * 
-     * @throws \Exception
+     * @copydoc \IThenticate::getEnabledFeature()
      */
     public function getEnabledFeature($feature = null) {
         
-        $result = '{
+        static $result = '{
             "similarity": {
                 "viewer_modes": {
                     "match_overview": true,
@@ -189,15 +156,14 @@ public function getEnabledFeature($feature = null) {
             ]
         }';
 
-        $result = json_decode($result, true);
 
         if (!$feature) {
             error_log("iThenticate enabled feature details {$result}");
-            return $result;
+            return json_decode($result, true);
         }
 
         $featureStatus = data_get(
-            $result,
+            json_decode($result, true),
             $feature,
             fn () => $this->suppressApiRequestException
                 ? null
@@ -209,13 +175,7 @@ public function getEnabledFeature($feature = null) {
     }
 
     /**
-     * Validate the service access by retrieving the enabled feature
-     * @see https://developers.turnitin.com/docs/tca#get-features-enabled
-     * @see https://developers.turnitin.com/turnitin-core-api/best-practice/exposing-tca-settings
-     * 
-     * @param  mixed $result    This may contains the returned enabled feature details from 
-     *                          request validation api end point if validated successfully.
-     * @return bool
+     * @copydoc \IThenticate::validateAccess()
      */
     public function validateAccess(&$result = null) {
         error_log("Confirming the service access validation for given access details");
@@ -223,13 +183,7 @@ public function validateAccess(&$result = null) {
     }
 
     /**
-     * Confirm the EULA on the user's behalf for given version
-     * @see https://developers.turnitin.com/docs/tca#accept-eula-version
-     * 
-     * @param User      $user
-     * @param Context   $context
-     *
-     * @return bool
+     * @copydoc \IThenticate::confirmEula()
      */
     public function confirmEula($user, $context) {
         error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEulaConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicableEulaVersion()}");
@@ -237,20 +191,7 @@ public function confirmEula($user, $context) {
     }
     
     /**
-     * Create a new submission at service's end
-     * @see https://developers.turnitin.com/docs/tca#create-a-submission
-     * 
-     * @param Site          $site                   The core site of submission system
-     * @param Submission    $submission             The article submission to check for plagiarism
-     * @param User          $user                   The user who is making submitting the submission
-     * @param Author        $author                 The author/owner of the submission
-     * @param string        $authorPermission       Submission author/owner permission set
-     * @param string        $submitterPermission    Submission submitter permission set
-     *
-     * @return string|null              if succeed, it will return the created submission UUID from 
-     *                                  service's end and at failure, will return null
-     * 
-     * @throws \Exception
+     * @copydoc \IThenticate::createSubmission()
      */
     public function createSubmission($site, $submission, $user, $author, $authorPermission, $submitterPermission) {
 
@@ -268,14 +209,7 @@ public function createSubmission($site, $submission, $user, $author, $authorPerm
     }
 
     /**
-     * Upload single submission file to the service's end
-     * @see https://developers.turnitin.com/docs/tca#upload-submission-file-contents
-     *
-     * @param string $submissionTacId The submission UUID return back from service
-     * @param string $fileName
-     * @param mixed  fileContent   
-     *
-     * @return bool
+     * @copydoc \IThenticate::uploadFile()
      */
     public function uploadFile($submissionTacId, $fileName, $fileContent) {
         error_log("Uploading submission file named {$fileName} for submission UUID {$submissionTacId}");
@@ -283,25 +217,21 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
     }
 
     /**
-     * Schedule the similarity report generation process
-     * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
-     *
-     * @param string $submissionUuid The submission UUID return back from service
-     * @return bool
+     * @copydoc \IThenticate::scheduleSimilarityReportGenerationProcess()
      */
-    public function scheduleSimilarityReportGenerationProcess($submissionUuid) {
-        error_log("Scheduled similarity report generation process for submission UUID {$submissionUuid}");
+    public function scheduleSimilarityReportGenerationProcess($submissionUuid, $settings = []) {
+        error_log(
+            sprintf(
+                'Scheduled similarity report generation process for submission UUID %s with similarity config %s',
+                $submissionUuid,
+                print_r($settings, true)
+            )
+        );
         return true;
     }
 
     /**
-     * Verify if user has already confirmed the given EULA version
-     * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
-     *
-     * @param Author|User   $user
-     * @param string        $version
-     *
-     * @return bool
+     * @copydoc \IThenticate::verifyUserEulaAcceptance()
      */
     public function verifyUserEulaAcceptance($user, $version) {
         error_log("Verifying if user with id {$user->getId()} has already confirmed the given EULA version {$version}");
@@ -309,11 +239,7 @@ public function verifyUserEulaAcceptance($user, $version) {
     }
 
     /**
-     * Validate/Retrieve the given EULA version
-     * @see https://developers.turnitin.com/docs/tca#get-eula-version-info
-     *
-     * @param string $version
-     * @return bool
+     * @copydoc \IThenticate::validateEulaVersion()
      */
     public function validateEulaVersion($version) {
         error_log("Validating/Retrieving the given EULA version {$version}");
@@ -321,14 +247,7 @@ public function validateEulaVersion($version) {
     }
 
     /**
-     * Register webhook end point
-     * @see https://developers.turnitin.com/docs/tca#create-webhook
-     *
-     * @param string $signingSecret
-     * @param string $url
-     * @param array  $events
-     * 
-     * @return string|null The UUID of register webhook if succeed or null if failed
+     * @copydoc \IThenticate::registerWebhook()
      */
     public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WEBHOOK_EVENTS) {
         error_log(
@@ -343,29 +262,21 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
     }
 
     /**
-     * Get the stored EULA details
-     * 
-     * @return array|null
+     * @copydoc \IThenticate::getEulaDetails()
      */
     public function getEulaDetails() {
         return $this->eulaVersionDetails;
     }
 
     /**
-     * Get the applicable EULA version
-     * 
-     * @return string
-     * @throws \Exception
+     * @copydoc \IThenticate::getApplicableEulaVersion()
      */
     public function getApplicableEulaVersion() {
         return $this->eulaVersion;
     }
 
     /**
-     * Set the applicable EULA version
-     * 
-     * @param string $version
-     * @return self
+     * @copydoc \IThenticate::setApplicableEulaVersion()
      */
     public function setApplicableEulaVersion($version) {
         $this->eulaVersion = $version;
@@ -374,12 +285,7 @@ public function setApplicableEulaVersion($version) {
     }
 
     /**
-     * Get the applicable EULA Url
-     * 
-     * @param  string|null $locale
-     * @return string
-     * 
-     * @throws \Exception
+     * @copydoc \IThenticate::getApplicableEulaUrl()
      */
     public function getApplicableEulaUrl($locale = null) {
         if (!$this->eulaVersion) {
@@ -394,11 +300,7 @@ public function getApplicableEulaUrl($locale = null) {
     }
 
     /**
-     * Convert given submission/context locale to service compatible and acceptable locale format
-     * @see https://developers.turnitin.com/docs/tca#eula
-     * 
-     * @param string $locale
-     * @return string
+     * @copydoc \IThenticate::getEulaConfirmationLocale()
      */
     protected function getEulaConfirmationLocale($locale) {
         if (!$this->getEulaDetails()) {
@@ -412,12 +314,7 @@ protected function getEulaConfirmationLocale($locale) {
     }
 
     /**
-     * Validate the existence of a permission against a given permission set
-     * 
-     * @param  string   $permission     The specific permission to check for existence
-     * @param  array    $permissionSet  The permission list to check against
-     * 
-     * @return bool True/False if the permission exists in the given permission set
+     * @copydoc \IThenticate::validatePermission()
      */
     protected function validatePermission($permission, $permissionSet) {
         return in_array($permission, $permissionSet);
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 5d63020..36b68a7 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -135,11 +135,16 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 			static::$_plugin->sendErrorMessage("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
 			return;
 		}
+		
+		list($apiUrl, $apiKey) = static::$_plugin->getServiceAccess($context);
+		$ithenticate = static::$_plugin->initIthenticate($apiUrl, $apiKey);
 
-		$ithenticate = static::$_plugin->initIthenticate(
-			...static::$_plugin->getServiceAccess($context)
+		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
+			$payload->id,
+			static::$_plugin->getSimilarityConfigSettings($context)
 		);
-		if (!$ithenticate->scheduleSimilarityReportGenerationProcess($payload->id)) {
+
+		if (!$scheduleSimilarityReport) {
 			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
 			return;
 		}
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index e94462c..341b412 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -83,3 +83,33 @@ msgstr "Request processing error : {$errorMessage}"
 
 msgid "plugins.generic.plagiarism.submission.checklist.eula"
 msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.title"
+msgstr "Submission similarity check settings"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.warning.note"
+msgstr "Note that if any of the following setting set in the config file at global or journal level, that will take precedence over what set here."
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.addToIndex"
+msgstr "The submission will be added to all valid node groups for future matching"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeQuotes"
+msgstr "Text in quotes of the submission will not count as similar content"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeBibliography"
+msgstr "Text in a bibliography sectionm of the submission will not count as similar content"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract"
+msgstr "Text in the abstract section of the submission will not count as similar content"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods"
+msgstr "Text in the method section of the submission will not count as similar content"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations"
+msgstr "The citations of the submission will be excuded from similarity check"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.label"
+msgstr "Exclude small match count"
+
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"
+msgstr "Similarity matches that match less than the specified amount of words will not count as similar content"
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 10966c2..206d8ad 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -5,7 +5,12 @@
 	{rdelim});
 </script>
 
-<form class="pkp_form" id="plagiarismSettingsForm" method="post" action="{url router=$smarty.const.ROUTE_COMPONENT op="manage" category="generic" plugin=$pluginName verb="settings" save=true}">
+<form 
+	class="pkp_form" 
+	id="plagiarismSettingsForm" 
+	method="post" 
+	action="{url router=$smarty.const.ROUTE_COMPONENT op="manage" category="generic" plugin=$pluginName verb="settings" save=true}"
+>
 	{csrf}
 	{include file="controllers/notification/inPlaceNotification.tpl" notificationId="plagiarismSettingsFormNotification"}
 
@@ -14,17 +19,59 @@
 	</div>
 
 	{if $ithenticateForced}
-		<div id="ithenticate_notice">
+		<div id="ithenticate_notice" class="pkpNotification pkpNotification--warning ithenticate--warning">
 			<b>{translate key="plugins.generic.plagiarism.manager.settings.areForced"}</b>
 		</div>
 	{/if}
 
-	{fbvFormArea id="webFeedSettingsFormArea"}
-		{fbvElement type="text" id="ithenticateApiUrl" value=$ithenticateApiUrl label="plugins.generic.plagiarism.manager.settings.apiUrl"}
-		{fbvElement type="text" id="ithenticateApiKey" value=$ithenticateApiKey label="plugins.generic.plagiarism.manager.settings.apiKey"}
+	{fbvFormArea id="ithenticateServiceAccessFormArea"}
+		{fbvElement 
+			type="text" 
+			id="ithenticateApiUrl" 
+			value=$ithenticateApiUrl 
+			label="plugins.generic.plagiarism.manager.settings.apiUrl"
+		}
+
+		{fbvElement 
+			type="text" 
+			id="ithenticateApiKey" 
+			value=$ithenticateApiKey 
+			label="plugins.generic.plagiarism.manager.settings.apiKey"
+		}
+	{/fbvFormArea}
+
+	{fbvFormArea id="ithenticateSimilarityReportSettings"}
+		{fbvFormSection title="plugins.generic.plagiarism.similarityCheck.settings.title" list=true}
+			<div id="ithenticate_similarity_config_notice" class="pkpNotification pkpNotification--warning ithenticate--warning">
+				<b>{translate key="plugins.generic.plagiarism.similarityCheck.settings.warning.note"}</b>
+			</div>
+
+			{fbvElement type="checkbox" name="addToIndex" 					id="addToIndex" 					checked=$addToIndex 					label="plugins.generic.plagiarism.similarityCheck.settings.field.addToIndex" 					translate="true"}
+			{fbvElement type="checkbox" name="excludeQuotes" 				id="excludeQuotes" 					checked=$excludeQuotes 					label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeQuotes" 				translate="true"}
+			{fbvElement type="checkbox" name="excludeBibliography" 			id="excludeBibliography" 			checked=$excludeBibliography 			label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeBibliography" 			translate="true"}
+			{fbvElement type="checkbox" name="excludeCitations" 			id="excludeCitations" 				checked=$excludeCitations 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations" 				translate="true"}
+			{fbvElement type="checkbox" name="excludeAbstract" 				id="excludeAbstract" 				checked=$excludeAbstract 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract" 				translate="true"}
+			{fbvElement type="checkbox" name="excludeMethods" 				id="excludeMethods" 				checked=$excludeMethods 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods" 				translate="true"}
+			
+			{fbvFormSection description="plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"}
+				{fbvElement 
+					type="text" 
+					id="excludeSmallMatches" 
+					value=$excludeSmallMatches 
+					label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.label"
+				}
+			{/fbvFormSection}
+		{/fbvFormSection}
 	{/fbvFormArea}
 
 	{fbvFormButtons}
 
 	<p><span class="formRequired">{translate key="common.requiredField"}</span></p>
 </form>
+
+<style>
+	.ithenticate--warning {
+		margin-top: 5px;
+		margin-bottom: 5px;
+	}
+</style>

From 483c0b90e9c45afc785ca950feddcff701c98ee2 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 9 May 2024 19:33:56 +0600
Subject: [PATCH 19/75] pkp/plagiarism#52 improved workflow for eula handling

---
 PlagiarismPlugin.inc.php                      | 434 ++++++++++++------
 .../PlagiarismEulaAcceptanceHandler.inc.php   |  92 ++++
 locale/en_US/locale.po                        |   6 +
 templates/confirmEula.tpl                     |  40 ++
 4 files changed, 435 insertions(+), 137 deletions(-)
 create mode 100644 controllers/PlagiarismEulaAcceptanceHandler.inc.php
 create mode 100644 templates/confirmEula.tpl

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index f457669..16dfd22 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -34,7 +34,7 @@ class PlagiarismPlugin extends GenericPlugin {
 	 * Set the value to `true` to enable test mode that will log instead of interacting with 
 	 * iThenticate API service.
 	 */
-	protected const ITHENTICATE_TEST_MODE_ENABLE = false;
+	protected const ITHENTICATE_TEST_MODE_ENABLE = true;
 
 	/**
 	 * Running in test mode
@@ -57,18 +57,35 @@ public function register($category, $path, $mainContextId = null) {
 			return false;	
 		}
 
+		$context = $mainContextId
+			? Services::get("context")->get($mainContextId)
+			: Application::get()->getRequest()->getContext();
+
+		// plugin can not function if the iThenticate service access not available at running context, 
+		if (!$this->isServiceAccessAvailable($context)) {
+			error_log("ithenticate service access not set for context id {$context->getId()}");
+			return false;
+		}
+
 		// Need to register both of TemplateManager display and fetch hook as both of these
 		// get called when presenting the submission 
 		HookRegistry::register('TemplateManager::display', [$this, 'addEulaToChecklist']);
 		HookRegistry::register('TemplateManager::fetch', [$this, 'addEulaToChecklist']);
 
 		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmission']);
+		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmittingUser']);
+		
+		HookRegistry::register('submissionsubmitstep4form::display', [$this, 'reConfirmEulaAcceptance']);
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
+
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION_FILE, [$this, 'addPlagiarismCheckDataToSubmissionFileSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addIthenticateConfigSettingsToContextSchema']);
+		
 		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
+
 		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
+		HookRegistry::register('LoadComponentHandler', [$this, 'handleEulaAcceptance']);
 
 		return $success;
 	}
@@ -108,48 +125,6 @@ public function getEnabled($contextId = null) {
 		return parent::getEnabled($contextId) || Config::getVar('ithenticate', 'ithenticate');
 	}
 
-	/**
-	 * Add the IThenticate EULA url as a checklist of submission process
-	 * 
-	 * @param string $hookName `TemplateManager::display` or `TemplateManager::fetch`
-	 * @param array $params
-	 * 
-	 * @return bool
-	 */
-	public function addEulaToChecklist($hookName, $params) {
-		$templateManager = & $params[0]; /** @var TemplateManager $templateManager */
-		$context = $templateManager->getTemplateVars('currentContext'); /** @var Context $context */
-
-		if (!$context || strtolower($templateManager->getTemplateVars('requestedPage') ?? '') !== 'submission') {
-			return false;
-		}
-
-		if (!$this->isServiceAccessAvailable($context)) {
-			error_log("ithenticate service access not set for context id {$context->getId()}");
-			return false;
-		}
-
-		$eulaDetails = $this->getContextEulaDetails($context);
-
-		// if EULA confirmation is not required, so no need to show EULA as part of submission checklist
-		if ($eulaDetails['require_eula'] === false) {
-			return false;
-		}
-		
-		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
-			array_push($checklist, [
-				'order' => (collect($checklist)->pluck('order')->sort(SORT_REGULAR)->last() ?? 0) + 1,
-				'content' => __('plugins.generic.plagiarism.submission.checklist.eula', [
-					'localizedEulaUrl' => $eulaDetails[$locale]['url']
-				]),
-			]);
-
-			$context->setData('submissionChecklist', $checklist, $locale);
-		}
-		
-		return false;
-	}
-
 	/**
 	 * Add properties for this type of public identifier to the submission entity's list for
 	 * storage in the database.
@@ -263,98 +238,205 @@ public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
 	}
 
 	/**
-	 * Send the editor an error message
+	 * Add the IThenticate EULA url as a checklist of submission process
 	 * 
-	 * @param string 	$message			The error/exception message to set as notification and log in error file
-	 * @param int|null 	$submissionid		The submission id for which error/exception has generated
+	 * @param string $hookName `TemplateManager::display` or `TemplateManager::fetch`
+	 * @param array $params
 	 * 
-	 * @return void
+	 * @return bool
 	 */
-	public function sendErrorMessage($message, $submissionId = null) {
+	public function addEulaToChecklist($hookName, $params) {
+		$templateManager = & $params[0]; /** @var TemplateManager $templateManager */
+		$context = $templateManager->getTemplateVars('currentContext'); /** @var Context $context */
 
-		$request = Application::get()->getRequest(); /** @var Request $request */
-		$context = $request->getContext(); /** @var Context $context */
-		$message = $submissionId
-			? __(
-				'plugins.generic.plagiarism.errorMessage', [
-					'submissionId' => $submissionId,
-					'errorMessage' => $message
-				]
-			) : __(
-				'plugins.generic.plagiarism.general.errorMessage', [
-					'errorMessage' => $message
-				]
-			);
+		if (!$context || strtolower($templateManager->getTemplateVars('requestedPage') ?? '') !== 'submission') {
+			return false;
+		}
+
+		$eulaDetails = $this->getContextEulaDetails($context);
+
+		// if EULA confirmation is not required, so no need to show EULA as part of submission checklist
+		if ($eulaDetails['require_eula'] === false) {
+			return false;
+		}
 		
-		import('classes.notification.NotificationManager');
-		$notificationManager = new NotificationManager();
-		$roleDao = DAORegistry::getDAO('RoleDAO'); /** @var RoleDAO $roleDao  */
+		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
+			array_push($checklist, [
+				'order' => (collect($checklist)->pluck('order')->sort(SORT_REGULAR)->last() ?? 0) + 1,
+				'content' => __('plugins.generic.plagiarism.submission.checklist.eula', [
+					'localizedEulaUrl' => $eulaDetails[$locale]['url']
+				]),
+			]);
+
+			$context->setData('submissionChecklist', $checklist, $locale);
+		}
 		
-		// Get the managers.
-		$managers = $roleDao->getUsersByRoleId(ROLE_ID_MANAGER, $context->getId()); /** @var DAOResultFactory $managers */
-		while ($manager = $managers->next()) {
-			$notificationManager->createTrivialNotification(
-				$manager->getId(), 
-				NOTIFICATION_TYPE_ERROR, 
-				['contents' => $message]
-			);
+		return false;
+	}
+
+	/**
+	 * Stamp the iThenticate EULA with the submission
+	 * 
+	 * @param string $hookName `Submission::add`
+	 * @param array $args
+	 * 
+	 * @return bool
+	 */
+	public function stampEulaToSubmission($hookName, $params) {
+		$submission =& $params[0]; /** @var Submission $submission */
+		$context = Application::get()->getRequest()->getContext();
+
+		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
+			// EULA confirmation is not required, so no stamping of EULA with the submission
+			return false;
 		}
 
-		error_log("iThenticate submission {$submissionId} failed: {$message}");
+		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
+
+		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
+		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
+
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submissionDao->updateObject($submission);
+
+		return false;
 	}
 
 	/**
-	 * Setup the handler for webhook request
+	 * Stamp the iThenticate EULA at the execution of the submission first stage to
+	 * the user who initiated the submission
 	 * 
-	 * @param string $hookName `LoadComponentHandler`
+	 * @param string $hookName `Submission::add`
 	 * @param array $params
 	 * 
 	 * @return bool
 	 */
-	public function setupWebhookHandler($hookName, $params) {
-		$component =& $params[0];
+	public function stampEulaToSubmittingUser($hookName, $params) {
+		$submission =& $params[0]; /** @var Submission $submission */
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+		$user = $request->getUser();
 
-		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler') {
-			import($component);
-			PlagiarismWebhookHandler::setPlugin($this);
-			return true;
+		// EULA confirmation is not required, so no stamping of EULA with the submission
+		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
+			return false;
+		}
+
+		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+
+		// If submission EULA version has already been stamped to user
+		// no need to do the confirmation and stamping again
+		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {
+			return false;
+		}
+
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
+		
+		// Check if user has ever already accepted this EULA version and if so, stamp it to user
+		// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
+		if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
+			$ithenticate->confirmEula($user, $context)) {
+			$this->stampEulaVersionToUser($user, $submissionEulaVersion);
+		} else {
+			$this->sendErrorMessage(
+				'Unable to stamp the EULA details to submission submitter at the first stage of submission',
+				$submission->getId()
+			);
 		}
 
 		return false;
 	}
 
 	/**
-	 * Stamp the iThenticate EULA with the submission
+	 * Check at the final stage of submission if the submitting user has already confirmed
+	 * or accepted the EULA version associated with submission
 	 * 
-	 * @param string $hookName `Submission::add`
-	 * @param array $args
+	 * @param string $hookName `submissionsubmitstep4form::display`
+	 * @param array $params
 	 * 
 	 * @return bool
 	 */
-	public function stampEulaToSubmission($hookName, $args) {
-		$submission =& $args[0]; /** @var Submission $submission */
-		$context = Application::get()->getRequest()->getContext();
+	public function reConfirmEulaAcceptance($hookName, $params) {
+		
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+		$user = $request->getUser();
+		$form = & $params[0]; /** @var SubmissionSubmitStep4Form $form */
+		$submission = $form->submission; /** @var Submission $submission */
 
-		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
-			$this->sendErrorMessage("ithenticate service access not set for context id {$context->getId()}", $submission->getId());
+		// EULA confirmation is not required, so no need for the checking of EULA acceptance
+		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
 			return false;
 		}
 
-		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
-			// EULA confirmation is not required, so no stamping of EULA with the submission
+		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+
+		// If submission EULA version has already been stamped to user
+		// no need to do the re-confirmation and stamping again
+		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {
 			return false;
 		}
 
-		$eulaDetails = $this->getContextEulaDetails(
-			Application::get()->getRequest()->getContext(), 
-			$submission->getData('locale')
+		$actionUrl = $request->getDispatcher()->url(
+			$request,
+			ROUTE_COMPONENT,
+			$context->getData('urlPath'),
+			'plugins.generic.plagiarism.controllers.PlagiarismEulaAcceptanceHandler',
+			'handle',
+			null,
+			[
+				'version' => $submissionEulaVersion,
+				'submissionId' => $submission->getId(),
+			]
 		);
 
-		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
-		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
+		// As submitting user has not confrimed/accepted the EULA,
+		// we will override the submission's final stage confirmation view 
+		// with a EULA confirmation view
+		$form->_template = $this->getTemplateResource('confirmEula.tpl');
 
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
-		$submissionDao->updateObject($submission);
+		import("plugins.generic.plagiarism.IThenticate");
+		$eulaVersionDetails = $this->getContextEulaDetails($context, [
+			$submission->getData('locale'),
+			$request->getSite()->getPrimaryLocale(),
+			\IThenticate::DEFAULT_EULA_LANGUAGE
+		]);
+		
+		$templateManager = TemplateManager::getManager();
+		$templateManager->assign([
+			'actionUrl' => $actionUrl,
+			'eulaAcceptanceMessage' => __('plugins.generic.plagiarism.submission.eula.acceptance.message', [
+				'localizedEulaUrl' => $eulaVersionDetails['url'],
+			]),
+			'cancelWarningMessage' => __('submission.submit.cancelSubmission'),
+			'cancelRedirect' => $request->getDispatcher()->url(
+				$request,
+				ROUTE_PAGE,
+				$context->getData('urlPath'),
+				'submissions'
+			)
+		]);
+
+		return false;
+	}
+
+	/**
+	 * Handle the EULA acceptance requried right before the final stage of submission
+	 * 
+	 * @param string $hookName `LoadComponentHandler`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function handleEulaAcceptance($hookName, $params) {
+		$component =& $params[0];
+
+		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismEulaAcceptanceHandler') {
+			import($component);
+			PlagiarismEulaAcceptanceHandler::setPlugin($this);
+			return true;
+		}
 
 		return false;
 	}
@@ -365,12 +447,10 @@ public function stampEulaToSubmission($hookName, $args) {
 	 * 	- Check if proper service credentials(API Url and Key) are available
 	 *  - Register webhook for context if not already registered
 	 *  - Check for EULA confrimation requirement
-	 * 		- Required
-	 * 			- Only allow to proceed if EULA is stamped to submission at initial stage
-	 * 			- Stamp the EULA confirmation to submitter if has not confirmed the version already
-	 * 		- Not Required
-	 * 			- No Need to check the submission stamping to EULA
-	 * 			- No need to stamp the EULA to the submitter
+	 * 		- Check if EULA is stamped to submission
+	 * 			- if not stamped, not allowed to submit at iThenticate
+	 * 		- Check if EULA is stamped to submitting user
+	 * 			- if not stamped, not allowed to submit at iThenticate
 	 *  - Traversing the submission files
 	 *  	- Create new submission at ithenticate's end for each submission file
 	 * 		- Upload the file for newly created submission uuid return back from ithenticate
@@ -421,15 +501,11 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			if (!$user->getData('ithenticateEulaVersion') ||
 				$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
 				
-				// Check if user has ever already accepted this EULA version and if so, stamp it to user
-				// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
-				if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
-					$ithenticate->confirmEula($user, $context)) {
-					$this->stampEulaVersionToSubmittingUser($user, $submissionEulaVersion);
-				} else {
-					$this->sendErrorMessage('Unable to stamp the EULA details to submission submitter', $submission->getId());
-					return false;
-				}
+				$this->sendErrorMessage(
+					"Unable to complete the itenticate submission as submitting user has not comfirmed or accepted the EULA", 
+					$submission->getId()
+				);
+				return false;
 			}
 		}
 
@@ -480,6 +556,26 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		return true;
 	}
 
+	/**
+	 * Setup the handler for webhook request
+	 * 
+	 * @param string $hookName `LoadComponentHandler`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function setupWebhookHandler($hookName, $params) {
+		$component =& $params[0];
+
+		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler') {
+			import($component);
+			PlagiarismWebhookHandler::setPlugin($this);
+			return true;
+		}
+
+		return false;
+	}
+
 	/**
 	 * Register the webhook for this context
 	 * 
@@ -579,13 +675,13 @@ public function manage($args, $request) {
 	/**
 	 * Get the cached EULA details form Context
 	 * 
-	 * @param Context 	$context
-	 * @param mixed 	$locale
-	 * @param mixed 	$default
+	 * @param Context 			$context
+	 * @param string|array|null $keys
+	 * @param mixed 			$default
 	 * 
 	 * @return mixed
 	 */
-	public function getContextEulaDetails($context, $key = null, $default = null) {
+	public function getContextEulaDetails($context, $keys = null, $default = null) {
 		/** @var \FileCache $cache */
 		$cache = CacheManager::getManager()
 			->getCache(
@@ -604,9 +700,24 @@ public function getContextEulaDetails($context, $key = null, $default = null) {
 
 		$eulaDetails = $cache->get($context->getId());
 
-		return $key 
-			? data_get($eulaDetails, $key, $default)
-			: $eulaDetails;
+		if (!$keys) {
+			return $eulaDetails;
+		}
+
+		if (is_array($keys)) {
+			foreach ($keys as $key) {
+				$value = data_get($eulaDetails, $keys);
+				if (!$value) {
+					continue;
+				}
+			}
+		}
+
+		return data_get(
+			$eulaDetails,
+			last(\Illuminate\Support\Arr::wrap($keys)),
+			$default
+		);
 	}
 
 	/**
@@ -654,6 +765,14 @@ public function retrieveEulaDetails($cache, $cacheId) {
 			}
 		}
 
+		// Also store the default iThenticate language version details
+		if (!isset($eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE])) {
+			$eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE] = [
+				'version' 	=> $ithenticate->getApplicableEulaVersion(),
+				'url' 		=> $ithenticate->getApplicableEulaUrl($ithenticate::DEFAULT_EULA_LANGUAGE),
+			];
+		}
+
 		$cache->setEntireCache([$cacheId => $eulaDetails]);
 
 		return $eulaDetails;
@@ -694,6 +813,23 @@ public function initIthenticate($apiUrl, $apiKey) {
 		);
 	}
 
+	/**
+	 * Stamp the EULA version and confirmation datetime for submitting user
+	 * 
+	 * @param User 		$user
+	 * @param string 	$version
+	 * 
+	 * @return void
+	 */
+	public function stampEulaVersionToUser($user, $version) {
+		$userDao = DAORegistry::getDAO('UserDAO'); /** @var UserDAO $userDao */
+
+		$user->setData('ithenticateEulaVersion', $version);
+		$user->setData('ithenticateEulaConfirmedAt', Core::getCurrentDate());
+
+		$userDao->updateObject($user);
+	}
+
 	/**
 	 * Get the ithenticate service access as array in format [API_URL, API_KEY]
 	 * 
@@ -757,6 +893,47 @@ public function getSimilarityConfigSettings($context) {
 		];
 	}
 
+	/**
+	 * Send the editor an error message
+	 * 
+	 * @param string 	$message			The error/exception message to set as notification and log in error file
+	 * @param int|null 	$submissionid		The submission id for which error/exception has generated
+	 * 
+	 * @return void
+	 */
+	public function sendErrorMessage($message, $submissionId = null) {
+
+		$request = Application::get()->getRequest(); /** @var Request $request */
+		$context = $request->getContext(); /** @var Context $context */
+		$message = $submissionId
+			? __(
+				'plugins.generic.plagiarism.errorMessage', [
+					'submissionId' => $submissionId,
+					'errorMessage' => $message
+				]
+			) : __(
+				'plugins.generic.plagiarism.general.errorMessage', [
+					'errorMessage' => $message
+				]
+			);
+		
+		import('classes.notification.NotificationManager');
+		$notificationManager = new NotificationManager();
+		$roleDao = DAORegistry::getDAO('RoleDAO'); /** @var RoleDAO $roleDao  */
+		
+		// Get the managers.
+		$managers = $roleDao->getUsersByRoleId(ROLE_ID_MANAGER, $context->getId()); /** @var DAOResultFactory $managers */
+		while ($manager = $managers->next()) {
+			$notificationManager->createTrivialNotification(
+				$manager->getId(), 
+				NOTIFICATION_TYPE_ERROR, 
+				['contents' => $message]
+			);
+		}
+
+		error_log("iThenticate submission {$submissionId} failed: {$message}");
+	}
+
 	/**
 	 * Get the forced config at global or context level if defined
 	 * 
@@ -783,23 +960,6 @@ protected function isServiceAccessAvailable($context) {
 		return !collect($this->getServiceAccess($context))->filter()->isEmpty();
 	}
 
-	/**
-	 * Stamp the EULA version and confirmation datetime for submitting user
-	 * 
-	 * @param User 		$user
-	 * @param string 	$version
-	 * 
-	 * @return void
-	 */
-	protected function stampEulaVersionToSubmittingUser($user, $version) {
-		$userDao = DAORegistry::getDAO('UserDAO'); /** @var UserDAO $userDao */
-
-		$user->setData('ithenticateEulaVersion', $version);
-		$user->setData('ithenticateEulaConfirmedAt', Core::getCurrentDate());
-
-		$userDao->updateObject($user);
-	}
-
 	/**
 	 * Get the submission submitter's appropriate permission based on role in the submission context
 	 * 
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
new file mode 100644
index 0000000..f63d730
--- /dev/null
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -0,0 +1,92 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @class PlagiarismEulaAcceptanceHandler
+ * @ingroup plugins_generic_plagiarism
+ *
+ * @brief Handle the reconfirmation and acceptance of iThenticate EULA
+ */
+
+import('lib.pkp.classes.handler.PKPHandler');
+import("plugins.generic.plagiarism.IThenticate");
+
+class PlagiarismEulaAcceptanceHandler extends PKPHandler {
+
+	/** 
+	 * The Plagiarism Plugin itself
+	 * 
+	 * @var PlagiarismPlugin 
+	 */
+	protected static $_plugin;
+
+	/**
+	 * Get the plugin
+	 * 
+	 * @return PlagiarismPlugin
+	 */
+	public static function getPlugin() {
+		return static::$_plugin;
+	}
+
+	/**
+	 * Set the Plugin
+	 * 
+	 * @param PlagiarismPlugin $plugin
+	 */
+	public static function setPlugin($plugin) {
+		static::$_plugin = $plugin;
+	}
+
+	/**
+	 * Authorize this request.
+	 *
+	 * @return bool
+	 */
+	public function authorize($request, &$args, $roleAssignments) {
+		return true;
+	}
+
+	/**
+	 * Handle the request
+	 *
+	 * @return void
+	 */
+	public function handle($args) {
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+        $user = $request->getUser();
+        $submissionEulaVersion = $args['version'];
+
+        /** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+        
+		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
+
+        if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
+			$ithenticate->confirmEula($user, $context)) {
+                
+            static::$_plugin->stampEulaVersionToUser($user, $submissionEulaVersion);
+		}
+
+		$request->redirectUrl(
+            $request->getDispatcher()->url(
+                $request,
+                ROUTE_PAGE,
+                $context->getData('urlPath'),
+                'submission',
+                'wizard',
+                4,
+                ['submissionId' => $args['submissionId']]
+            )
+        );
+	}
+
+}
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 341b412..8ac3248 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -84,6 +84,12 @@ msgstr "Request processing error : {$errorMessage}"
 msgid "plugins.generic.plagiarism.submission.checklist.eula"
 msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"
 
+msgid "plugins.generic.plagiarism.submission.eula.acceptance.message"
+msgstr "You must read and accept the <a target=\"_blank\" href=\"{$localizedEulaUrl}\">iThenticate EULA</a> before proceeding to finalise the submission."
+
+msgid "plugins.generic.plagiarism.submission.eula.accept.button.title"
+msgstr "Accept EULA and Continue"
+
 msgid "plugins.generic.plagiarism.similarityCheck.settings.title"
 msgstr "Submission similarity check settings"
 
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
new file mode 100644
index 0000000..3c90318
--- /dev/null
+++ b/templates/confirmEula.tpl
@@ -0,0 +1,40 @@
+{**
+ * plugins/generic/plagiarism/templates/confirmEula.tpl
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2003-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * Intermediate stage before final submission stage to view EULA
+ *}
+<script type="text/javascript">
+    $(function() {ldelim}
+        // Attach the JS form handler.
+        // $('#confirmEulaForm').pkpHandler('$.pkp.controllers.form.AjaxFormHandler');
+
+        let cancelWarningMessage = "{$cancelWarningMessage}",
+            cancelRedirect = "{$cancelRedirect}";
+        
+        $('form#confirmEulaForm').on('click', 'a.cancelButton', function (event) {
+            event.preventDefault();
+            if (confirm(cancelWarningMessage) === true) {
+                window.location.href = cancelRedirect;
+            }
+        });
+    {rdelim});
+</script>
+
+<form 
+    class="pkp_form" 
+    id="confirmEulaForm" 
+    method="post" 
+    action="{$actionUrl}"
+>
+    {csrf}
+ 
+    {include file="controllers/notification/inPlaceNotification.tpl" notificationId="submitStep4FormNotification"}
+
+    <p>{$eulaAcceptanceMessage}</p>
+
+    {fbvFormButtons id="eulaConfirmationAcceptance" submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"}
+</form>

From a00d5bc6b096663c52a78ba8545482dbe84133e0 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 14 May 2024 13:01:28 +0600
Subject: [PATCH 20/75] pkp/plagiarism#52 added retrying, polling, similarity
 score presentation and viewer launch functionality

---
 IThenticate.inc.php                           |  66 ++++++
 PlagiarismPlugin.inc.php                      | 153 ++++++++-----
 TestIThenticate.inc.php                       |  27 +++
 .../PlagiarismComponentHandler.inc.php        |  57 +++++
 .../PlagiarismEulaAcceptanceHandler.inc.php   |  46 +---
 ...PlagiarismIthenticateActionHandler.inc.php | 190 ++++++++++++++++
 controllers/PlagiarismWebhookHandler.inc.php  |  31 +--
 grids/SimilarityActionGridColumn.inc.php      | 205 ++++++++++++++++++
 locale/en_US/locale.po                        |  36 +++
 9 files changed, 685 insertions(+), 126 deletions(-)
 create mode 100644 controllers/PlagiarismComponentHandler.inc.php
 create mode 100644 controllers/PlagiarismIthenticateActionHandler.inc.php
 create mode 100644 grids/SimilarityActionGridColumn.inc.php

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 512242d..444c750 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -415,6 +415,72 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid, $sett
         return $response ? $response->getStatusCode() === 202 : false;
     }
 
+    /**
+     * Get the similarity result info
+     * @see https://developers.turnitin.com/docs/tca#get-similarity-report-info
+     *
+     * @param string $submissionUuid The submission UUID return back from service
+     * @return string|null
+     */
+    public function getSimilarityResult($submissionUuid) {
+
+        $response = $this->makeApiRequest(
+            'GET',
+            $this->getApiPath("submissions/{$submissionUuid}/similarity"),
+            [
+                'headers' => $this->getRequiredHeaders(),
+                'exceptions' => false,
+            ]
+        );
+
+        return $response && $response->getStatusCode() === 200
+            ? $response->getBody()->getContents()
+            : null;
+    }
+
+    /**
+     * Create the viewer launch url
+     * @see https://developers.turnitin.com/docs/tca#create-viewer-launch-url
+     *
+     * @param string    $submissionUuid The submission UUID return back from service
+     * @param User      $user           The viewing user
+     * @param string    $locale         The preferred locale
+     * 
+     * @return string|null
+     */
+    public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
+
+        $response = $this->makeApiRequest(
+            'POST',
+            $this->getApiPath("submissions/{$submissionUuid}/viewer-url"),
+            [
+                'headers' => array_merge($this->getRequiredHeaders(), [
+                    'Content-Type' => 'application/json'
+                ]),
+                'json' => [
+                    'viewer_user_id' => $this->getGeneratedId('submitter', $user->getId()),
+                    'locale' => $locale,
+                    'viewer_default_permission_set' => 'ADMINISTRATOR',
+                    'viewer_permissions' => [
+                        'may_view_submission_full_source' => true,
+                        'may_view_match_submission_info' => true,
+                        'may_view_flags_panel' => true,
+                        'may_view_document_details_panel' => true,
+                        'may_view_sections_exclusion_panel' => true,
+                    ],
+                ],
+                'exceptions' => false,
+            ]
+        );
+        
+        if ($response && $response->getStatusCode() === 200) {
+            $result = json_decode($response->getBody()->getContents());
+            return $result->viewer_url;
+        }
+
+        return null;
+    }
+
     /**
      * Verify if user has already confirmed the given EULA version
      * @see https://developers.turnitin.com/docs/tca#get-eula-acceptance-info
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 16dfd22..d41cb5f 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -36,6 +36,29 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	protected const ITHENTICATE_TEST_MODE_ENABLE = true;
 
+	/**
+	 * List of valid url components
+	 * 
+	 * @var array
+	 */
+	protected $validRouteComponentHandlers = [
+		'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler',
+		'plugins.generic.plagiarism.controllers.PlagiarismEulaAcceptanceHandler',
+		'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+	];
+
+	/**
+	 * List of columns record to retrieve to show ithenticate's similarity scores
+	 * 
+	 * @var array
+	 */
+	protected $similarityScoreColumns = [
+		'overall_match_percentage',
+		'internet_match_percentage',
+		'publication_match_percentage',
+		'submitted_works_match_percentage',
+	];
+
 	/**
 	 * Running in test mode
 	 * 
@@ -84,8 +107,9 @@ public function register($category, $path, $mainContextId = null) {
 		
 		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
 
-		HookRegistry::register('LoadComponentHandler', [$this, 'setupWebhookHandler']);
-		HookRegistry::register('LoadComponentHandler', [$this, 'handleEulaAcceptance']);
+		HookRegistry::register('LoadComponentHandler', [$this, 'handleRouteComponent']);
+
+		HookRegistry::register('editorsubmissiondetailsfilesgridhandler::initfeatures', [$this, 'addActionsToSubmissionFileGrid']);
 
 		return $success;
 	}
@@ -237,6 +261,27 @@ public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
 		return false;
 	}
 
+	/**
+	 * Handle the plugin specific route component requests
+	 * 
+	 * @param string $hookName `LoadComponentHandler`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function handleRouteComponent($hookName, $params) {
+		$component =& $params[0];
+
+		if (!in_array($component, $this->validRouteComponentHandlers)) {
+			return false;
+		}
+
+		import($component);
+		$componentName = last(explode('.', $component));
+		$componentName::setPlugin($this);
+		return true;
+	}
+
 	/**
 	 * Add the IThenticate EULA url as a checklist of submission process
 	 * 
@@ -421,26 +466,6 @@ public function reConfirmEulaAcceptance($hookName, $params) {
 		return false;
 	}
 
-	/**
-	 * Handle the EULA acceptance requried right before the final stage of submission
-	 * 
-	 * @param string $hookName `LoadComponentHandler`
-	 * @param array $params
-	 * 
-	 * @return bool
-	 */
-	public function handleEulaAcceptance($hookName, $params) {
-		$component =& $params[0];
-
-		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismEulaAcceptanceHandler') {
-			import($component);
-			PlagiarismEulaAcceptanceHandler::setPlugin($this);
-			return true;
-		}
-
-		return false;
-	}
-
 	/**
 	 * Complete the submission process at iThenticate service's end
 	 * The steps follows as:
@@ -557,22 +582,32 @@ public function submitForPlagiarismCheck($hookName, $args) {
 	}
 
 	/**
-	 * Setup the handler for webhook request
+	 * Add ithenticate related data and actions to submission file grid view
 	 * 
-	 * @param string $hookName `LoadComponentHandler`
+	 * @param string $hookName `editorsubmissiondetailsfilesgridhandler::initfeatures`
 	 * @param array $params
 	 * 
 	 * @return bool
 	 */
-	public function setupWebhookHandler($hookName, $params) {
-		$component =& $params[0];
+	public function addActionsToSubmissionFileGrid($hookName, $params) {
+		$request = Application::get()->getRequest();
+		$user = $request->getUser();
+		$context = $request->getContext();
 
-		if ($component == 'plugins.generic.plagiarism.controllers.PlagiarismWebhookHandler') {
-			import($component);
-			PlagiarismWebhookHandler::setPlugin($this);
-			return true;
+		if (!$user->hasRole([ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR, ROLE_ID_REVIEWER], $context->getId())) {
+			return false;
 		}
 
+		/** @var EditorSubmissionDetailsFilesGridHandler $editorSubmissionDetailsFilesGridHandler */
+		$editorSubmissionDetailsFilesGridHandler = & $params[0];
+
+		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
+		$editorSubmissionDetailsFilesGridHandler->addColumn(
+			new SimilarityActionGridColumn(
+				$this->similarityScoreColumns
+			)
+		);
+
 		return false;
 	}
 
@@ -893,11 +928,36 @@ public function getSimilarityConfigSettings($context) {
 		];
 	}
 
+	/**
+	 * Get the submission submitter's appropriate permission based on role in the submission context
+	 * 
+	 * @param Context 	$context
+	 * @param User 		$user
+	 * 
+	 * @return string
+	 */
+	public function getSubmitterPermission($context, $user) {
+		
+		if ($user->hasRole([ROLE_ID_SITE_ADMIN, ROLE_ID_MANAGER], $context->getId())) {
+			return 'ADMINISTRATOR';
+		}
+
+		if ($user->hasRole([ROLE_ID_SUB_EDITOR], $context->getId())) {
+			return 'EDITOR';
+		}
+
+		if ($user->hasRole([ROLE_ID_AUTHOR], $context->getId())) {
+			return 'USER';
+		}
+
+		return 'UNDEFINED';
+	}
+
 	/**
 	 * Send the editor an error message
 	 * 
-	 * @param string 	$message			The error/exception message to set as notification and log in error file
-	 * @param int|null 	$submissionid		The submission id for which error/exception has generated
+	 * @param string 	$message 		The error/exception message to set as notification and log in error file
+	 * @param int|null 	$submissionid 	The submission id for which error/exception has generated
 	 * 
 	 * @return void
 	 */
@@ -925,8 +985,8 @@ public function sendErrorMessage($message, $submissionId = null) {
 		$managers = $roleDao->getUsersByRoleId(ROLE_ID_MANAGER, $context->getId()); /** @var DAOResultFactory $managers */
 		while ($manager = $managers->next()) {
 			$notificationManager->createTrivialNotification(
-				$manager->getId(), 
-				NOTIFICATION_TYPE_ERROR, 
+				$manager->getId(),
+				NOTIFICATION_TYPE_ERROR,
 				['contents' => $message]
 			);
 		}
@@ -959,29 +1019,4 @@ protected function getForcedConfigSetting($contextPath, $configKeyName) {
 	protected function isServiceAccessAvailable($context) {
 		return !collect($this->getServiceAccess($context))->filter()->isEmpty();
 	}
-
-	/**
-	 * Get the submission submitter's appropriate permission based on role in the submission context
-	 * 
-	 * @param Context 	$context
-	 * @param User 		$user
-	 * 
-	 * @return string
-	 */
-	protected function getSubmitterPermission($context, $user) {
-		
-		if ($user->hasRole([ROLE_ID_SITE_ADMIN, ROLE_ID_MANAGER], $context->getId())) {
-			return 'ADMINISTRATOR';
-		}
-
-		if ($user->hasRole([ROLE_ID_SUB_EDITOR], $context->getId())) {
-			return 'EDITOR';
-		}
-
-		if ($user->hasRole([ROLE_ID_AUTHOR], $context->getId())) {
-			return 'USER';
-		}
-
-		return 'UNDEFINED';
-	}
 }
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index f0e756e..200756e 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -230,6 +230,33 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid, $sett
         return true;
     }
 
+    /**
+     * @copydoc \IThenticate::getSimilarityResult()
+     */
+    public function getSimilarityResult($submissionUuid) {
+        error_log("Similarity report result retrived for iThenticate submission id : {$submissionUuid}");
+        return '{
+            "submission_id": "'.$submissionUuid.'",
+            "overall_match_percentage": 15,
+            "internet_match_percentage": 12,
+            "publication_match_percentage": 10,
+            "submitted_works_match_percentage": 0,
+            "status": "COMPLETE",
+            "time_requested": "2017-11-06T19:14:31.828Z",
+            "time_generated": "2017-11-06T19:14:45.993Z",
+            "top_source_largest_matched_word_count": 193,
+            "top_matches": []
+        }';
+    }
+
+    /**
+     * @copydoc \IThenticate::createViewerLaunchUrl()
+     */
+    public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
+        error_log("Similarity report viewer launch url generated for iThenticate submission id : {$submissionUuid}");
+        return Application::get()->getRequest()->getBaseUrl();
+    }
+
     /**
      * @copydoc \IThenticate::verifyUserEulaAcceptance()
      */
diff --git a/controllers/PlagiarismComponentHandler.inc.php b/controllers/PlagiarismComponentHandler.inc.php
new file mode 100644
index 0000000..127e746
--- /dev/null
+++ b/controllers/PlagiarismComponentHandler.inc.php
@@ -0,0 +1,57 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/controllers/PlagiarismComponentHandler.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @class PlagiarismComponentHandler
+ * @ingroup plugins_generic_plagiarism
+ *
+ * @brief Base handler class for plagiarism plugin's ROUTE_COMPONENT classes
+ */
+
+import('lib.pkp.classes.handler.PKPHandler');
+import('lib.pkp.classes.security.authorization.UserRequiredPolicy');
+import('lib.pkp.classes.security.authorization.UserRolesRequiredPolicy');
+
+class PlagiarismComponentHandler extends PKPHandler {
+
+	/** 
+	 * The Plagiarism Plugin itself
+	 * 
+	 * @var PlagiarismPlugin 
+	 */
+	protected static $_plugin;
+
+	/**
+	 * Get the plugin
+	 * 
+	 * @return PlagiarismPlugin
+	 */
+	public static function getPlugin() {
+		return static::$_plugin;
+	}
+
+	/**
+	 * Set the Plugin
+	 * 
+	 * @param PlagiarismPlugin $plugin
+	 */
+	public static function setPlugin($plugin) {
+		static::$_plugin = $plugin;
+	}
+
+	/**
+	 * @copydoc PKPHandler::authorize()
+	 */
+	public function authorize($request, &$args, $roleAssignments) {
+
+		$this->addPolicy(new UserRequiredPolicy($request));
+		$this->addPolicy(new UserRolesRequiredPolicy($request));
+		
+		return parent::authorize($request, $args, $roleAssignments);
+	}
+}
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index f63d730..8eac35b 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -13,51 +13,20 @@
  * @brief Handle the reconfirmation and acceptance of iThenticate EULA
  */
 
-import('lib.pkp.classes.handler.PKPHandler');
+import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import("plugins.generic.plagiarism.IThenticate");
 
-class PlagiarismEulaAcceptanceHandler extends PKPHandler {
-
-	/** 
-	 * The Plagiarism Plugin itself
-	 * 
-	 * @var PlagiarismPlugin 
-	 */
-	protected static $_plugin;
-
-	/**
-	 * Get the plugin
-	 * 
-	 * @return PlagiarismPlugin
-	 */
-	public static function getPlugin() {
-		return static::$_plugin;
-	}
-
-	/**
-	 * Set the Plugin
-	 * 
-	 * @param PlagiarismPlugin $plugin
-	 */
-	public static function setPlugin($plugin) {
-		static::$_plugin = $plugin;
-	}
-
-	/**
-	 * Authorize this request.
-	 *
-	 * @return bool
-	 */
-	public function authorize($request, &$args, $roleAssignments) {
-		return true;
-	}
+class PlagiarismEulaAcceptanceHandler extends PlagiarismComponentHandler {
 
 	/**
-	 * Handle the request
+	 * Handle the presentation of iThenticate EULA right before the submission final stage
 	 *
+	 * @param array $args
+	 * @param Request $request
+	 * 
 	 * @return void
 	 */
-	public function handle($args) {
+	public function handle($args, $request) {
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
         $user = $request->getUser();
@@ -88,5 +57,4 @@ public function handle($args) {
             )
         );
 	}
-
 }
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
new file mode 100644
index 0000000..0b5c38c
--- /dev/null
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -0,0 +1,190 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/controllers/PlagiarismIthenticateActionHandler.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @class PlagiarismIthenticateActionHandler
+ * @ingroup plugins_generic_plagiarism
+ *
+ * @brief Handle the different iThenticate service related actions
+ */
+
+import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
+import('lib.pkp.classes.core.JSONMessage'); 
+import("plugins.generic.plagiarism.IThenticate");
+
+class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
+
+	/**
+	 * Launch the iThenticate similarity report viewer
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 * 
+	 * @return void
+	 */
+	public function launchViewer($args, $request) {
+		$context = $request->getContext();
+        $user = $request->getUser();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$viewerUrl = $ithenticate->createViewerLaunchUrl(
+			$submissionFile->getData('ithenticate_id'),
+			$user,
+			'en-US'
+		);
+
+		return $request->redirectUrl($viewerUrl);
+	}
+
+    /**
+	 * Upload the submission file and create a new submission at iThenticate service's end
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 * 
+	 * @return void
+	 */
+	public function submitSubmission($args, $request) {
+		$context = $request->getContext();
+		$user = $request->getUser();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']); /** @var SubmissionFile $submissionFile */
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId')); /** @var Submission $submission*/
+		$publication = $submission->getCurrentPublication();
+		$author = $publication->getPrimaryAuthor();
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$submissionUuid = $ithenticate->createSubmission(
+			$request->getSite(),
+			$submission,
+			$user,
+			$author,
+			static::$_plugin::SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION,
+			static::$_plugin->getSubmitterPermission($context, $user)
+		);
+
+		if (!$submissionUuid) {
+			static::$_plugin->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
+			return new JSONMessage(false);
+		}
+
+		$file = Services::get('file')->get($submissionFile->getData('fileId'));
+		$uploadStatus = $ithenticate->uploadFile(
+			$submissionUuid, 
+			$submissionFile->getData("name", $publication->getData("locale")),
+			Services::get('file')->fs->read($file->path),
+		);
+
+		// Upload submission files for successfully created submission at iThenticate's end
+		if (!$uploadStatus) {
+			static::$_plugin->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
+			return new JSONMessage(false);
+		}
+
+		$submissionFile->setData('ithenticate_id', $submissionUuid);
+		$submissionFile->setData('ithenticate_similarity_scheduled', 0);
+		$submissionFileDao->updateObject($submissionFile);
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+	}
+
+	/**
+	 * Schedule the similarity report generate process at iThenticate services's end
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 * 
+	 * @return void
+	 */
+    public function scheduleSimilarityReport($args, $request) {
+
+		$context = $request->getContext();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
+			$submissionFile->getData('ithenticate_id'),
+			static::$_plugin->getSimilarityConfigSettings($context)
+		);
+
+		if (!$scheduleSimilarityReport) {
+			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
+		$submissionFileDao->updateObject($submissionFile);
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+    }
+
+	/**
+	 * Refresh the submission's similarity score result
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 * 
+	 * @return void
+	 */
+    public function refreshSimilarityResult($args, $request) {
+		$context = $request->getContext();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$similarityScoreResult = $ithenticate->getSimilarityResult(
+			$submissionFile->getData('ithenticate_id')
+		);
+
+		if (!$similarityScoreResult) {
+			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$similarityScoreResult = json_decode($similarityScoreResult);
+
+		if ($similarityScoreResult->status !== 'COMPLETE') {
+			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$submissionFile->setData('ithenticate_similarity_result', json_encode($similarityScoreResult));
+		$submissionFileDao->updateObject($submissionFile);
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+    }
+
+}
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 36b68a7..13b33d5 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/grid/PlagiarismWebhookHandler.inc.php
+ * @file plugins/generic/plagiarism/controllers/PlagiarismWebhookHandler.inc.php
  *
  * Copyright (c) 2014-2024 Simon Fraser University
  * Copyright (c) 2000-2024 John Willinsky
@@ -15,35 +15,10 @@
 
 use Illuminate\Database\Capsule\Manager as Capsule;
 
-import('lib.pkp.classes.handler.PKPHandler');
+import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import("plugins.generic.plagiarism.IThenticate");
 
-class PlagiarismWebhookHandler extends PKPHandler {
-
-	/** 
-	 * The Plagiarism Plugin itself
-	 * 
-	 * @var PlagiarismPlugin 
-	 */
-	protected static $_plugin;
-
-	/**
-	 * Get the plugin
-	 * 
-	 * @return PlagiarismPlugin
-	 */
-	public static function getPlugin() {
-		return static::$_plugin;
-	}
-
-	/**
-	 * Set the Plugin
-	 * 
-	 * @param PlagiarismPlugin $plugin
-	 */
-	public static function setPlugin($plugin) {
-		static::$_plugin = $plugin;
-	}
+class PlagiarismWebhookHandler extends PlagiarismComponentHandler {
 
 	/**
 	 * Authorize this request.
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
new file mode 100644
index 0000000..dcd7192
--- /dev/null
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -0,0 +1,205 @@
+<?php
+
+/**
+ * @file 
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class SimilarityActionGridColumn
+ * @ingroup 
+ *
+ * @brief 
+ */
+
+import('lib.pkp.classes.controllers.grid.GridColumn');
+import('lib.pkp.classes.controllers.grid.ColumnBasedGridCellProvider');
+import('lib.pkp.classes.linkAction.request.AjaxAction');
+import('lib.pkp.classes.linkAction.request.OpenWindowAction');
+import('lib.pkp.classes.linkAction.request.RemoteActionConfirmationModal');
+
+class SimilarityActionGridColumn extends GridColumn {
+	
+    protected $similarityScoreColumns = [];
+
+    public function __construct($scoreColumns) {
+
+        $this->similarityScoreColumns = $scoreColumns;
+
+        $cellProvider = new ColumnBasedGridCellProvider();
+
+		parent::__construct(
+            'score',
+            'plugins.generic.plagiarism.similarity.action.column.score.title',
+            null,
+            null, 
+            $cellProvider,
+			['width' => 50, 'alignment' => COLUMN_ALIGNMENT_LEFT, 'anyhtml' => true]
+        );
+	}
+
+	/**
+	 * Method expected by ColumnBasedGridCellProvider
+	 * to render a cell in this column.
+	 *
+	 * @copydoc ColumnBasedGridCellProvider::getTemplateVarsFromRowColumn()
+	 */
+	public function getTemplateVarsFromRow($row) {
+
+        $request = Application::get()->getRequest();
+        $context = $request->getContext();
+
+		$submissionFileData = $row->getData();
+		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+		assert($submissionFile instanceof SubmissionFile);
+
+        // submission similarity score is available
+        if ($submissionFile->getData('ithenticate_similarity_scheduled') === true &&
+            $submissionFile->getData('ithenticate_similarity_result')) {
+            
+            $similarityResult = json_decode(
+                $submissionFile->getData('ithenticate_similarity_result'),
+                true
+            );
+            $scores = '';
+
+            foreach ($similarityResult as $column => $value) {
+                if (!in_array($column, $this->similarityScoreColumns)) {
+                    continue;
+                }
+
+                $scores = $scores . '<li>' . __("plugins.generic.plagiarism.similarity.score.column.{$column}") . ' : ' . $value .'</li>';
+            }
+
+            return ['label' => "<ul>{$scores}</ul>"];
+        }
+
+        return ['label' => ''];
+	}
+
+    /**
+	 * @copydoc GridColumn::getCellActions()
+	 */
+	public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_DEFAULT) {
+		$cellActions = parent::getCellActions($request, $row, $position);
+        $request = Application::get()->getRequest();
+        $context = $request->getContext();
+        $user = $request->getUser();
+
+        // User can not perform any of following actions if not a Journal Manager or Editor
+        //      - Upload file for plagiarims check if failed
+        //      - Schedule similarity report generation if not scheduled already
+        //      - Refresh the similarity report scores
+        //      - Launch similarity report viewer
+        if (!$user->hasRole([ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR], $context->getId())) {
+			return $cellActions;
+		}
+
+		$submissionFileData = $row->getData();
+        $submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+
+        // There was an error and submission not completed, 
+        // Ask for confirmation and try to complete the submission process
+        if (!$submissionFile->getData('ithenticate_id')) {
+            $cellActions[] = new LinkAction(
+                "plagiarism-submission-submit-{$submissionFile->getId()}",
+                new RemoteActionConfirmationModal(
+                    $request->getSession(),
+                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation'),
+                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title'),
+                    $request->getDispatcher()->url(
+                        $request,
+                        ROUTE_COMPONENT,
+                        $context->getData('urlPath'),
+                        'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+                        'submitSubmission',
+                        null,
+                        [
+                            'submissionFileId' => $submissionFile->getId(),
+                        ]
+                    )
+                ),
+                __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
+            );
+        }
+        
+        // Submission similarity report generation has not scheduled
+        if ($submissionFile->getData('ithenticate_similarity_scheduled') === false) {
+		    $cellActions[] = new LinkAction(
+                "plagiarism-similarity-report-schedule-{$submissionFile->getId()}",
+                new RemoteActionConfirmationModal(
+                    $request->getSession(),
+                    __('plugins.generic.plagiarism.similarity.action.generateReport.confirmation'),
+                    __('plugins.generic.plagiarism.similarity.action.generateReport.title'),
+                    $request->getDispatcher()->url(
+                        $request,
+                        ROUTE_COMPONENT,
+                        $context->getData('urlPath'),
+                        'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+                        'scheduleSimilarityReport',
+                        null,
+                        [
+                            'submissionFileId' => $submissionFile->getId(),
+                        ]
+                    )
+                ),
+                __('plugins.generic.plagiarism.similarity.action.generateReport.title')
+            );
+        }
+
+        // Generate the action for similarity score refresh
+        $similarityResultRefreshAction = new LinkAction(
+            "plagiarism-similarity-score-refresh-{$submissionFile->getId()}",
+            new RemoteActionConfirmationModal(
+                $request->getSession(),
+                __('plugins.generic.plagiarism.similarity.action.refreshReport.confirmation'),
+                __('plugins.generic.plagiarism.similarity.action.refreshReport.title'),
+                $request->getDispatcher()->url(
+                    $request,
+                    ROUTE_COMPONENT,
+                    $context->getData('urlPath'),
+                    'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+                    'refreshSimilarityResult',
+                    null,
+                    [
+                        'submissionFileId' => $submissionFile->getId(),
+                    ]
+                )
+            ),
+            __('plugins.generic.plagiarism.similarity.action.refreshReport.title')
+        );
+
+        // If similarity score not availabel
+        // show as cell action and upon it's available, show it as part of row action
+        $submissionFile->getData('ithenticate_similarity_result')
+            ? $row->addAction($similarityResultRefreshAction)
+            : array_push($cellActions, $similarityResultRefreshAction);
+
+        // Similarity viewer only available upon the availability of similarity report is 
+        if ($submissionFile->getData('ithenticate_similarity_result')) {
+            $row->addAction(
+                new LinkAction(
+                    "plagiarism-similarity-launch-viewer-{$submissionFile->getId()}",
+                    new OpenWindowAction(
+                        $request->getDispatcher()->url(
+                            $request,
+                            ROUTE_COMPONENT,
+                            $context->getData('urlPath'),
+                            'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+                            'launchViewer',
+                            null,
+                            [
+                                'submissionFileId' => $submissionFile->getId(),
+                            ]
+                        )
+                    ),
+                    __('plugins.generic.plagiarism.similarity.action.launch.viewer.title')
+                )
+            );
+        }
+
+		return $cellActions;
+	}
+
+}
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 8ac3248..35ce059 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -119,3 +119,39 @@ msgstr "Exclude small match count"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"
 msgstr "Similarity matches that match less than the specified amount of words will not count as similar content"
+
+msgid "plugins.generic.plagiarism.similarity.action.column.score.title"
+msgstr "Plagiarism Score"
+
+msgid "plugins.generic.plagiarism.similarity.action.launch.viewer.title"
+msgstr "Launch Plagiarims Similarity Viewer"
+
+msgid "plugins.generic.plagiarism.similarity.score.column.overall_match_percentage"
+msgstr "Overall Match Percentage"
+
+msgid "plugins.generic.plagiarism.similarity.score.column.internet_match_percentage"
+msgstr "Internet Match Percentage"
+
+msgid "plugins.generic.plagiarism.similarity.score.column.publication_match_percentage"
+msgstr "publication Match Percentage"
+
+msgid "plugins.generic.plagiarism.similarity.score.column.submitted_works_match_percentage"
+msgstr "submitted Works Match Percentage"
+
+msgid "plugins.generic.plagiarism.similarity.action.generateReport.title"
+msgstr "Schedule Plagiarism Report"
+
+msgid "plugins.generic.plagiarism.similarity.action.generateReport.confirmation"
+msgstr "Are you sure you want to generate the plagiarims report?"
+
+msgid "plugins.generic.plagiarism.similarity.action.refreshReport.title"
+msgstr "Refresh Plagiarism Similarity Score"
+
+msgid "plugins.generic.plagiarism.similarity.action.refreshReport.confirmation"
+msgstr "Are you sure you want to refresh plagiarims similarity score?"
+
+msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title"
+msgstr "Submit for Plagiarims Check"
+
+msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation"
+msgstr "Are you sure you want to submit this file for plagiarism check?"

From 4c16098cd89eae43346260fc88fc59bb513e63b7 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 14 May 2024 14:36:52 +0600
Subject: [PATCH 21/75] pkp/plagiarism#52 added missing doc blocks

---
 grids/SimilarityActionGridColumn.inc.php | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index dcd7192..a17f6ab 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -1,28 +1,38 @@
 <?php
 
 /**
- * @file 
+ * @file plugins/generic/plagiarism/grids/SimilarityActionGridColumn.inc.php
  *
  * Copyright (c) 2014-2024 Simon Fraser University
  * Copyright (c) 2000-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class SimilarityActionGridColumn
- * @ingroup 
+ * @ingroup plugins_generic_plagiarism
  *
- * @brief 
+ * @brief GridColumn handler to show similarity score and actions related to iThenticate
  */
 
 import('lib.pkp.classes.controllers.grid.GridColumn');
 import('lib.pkp.classes.controllers.grid.ColumnBasedGridCellProvider');
-import('lib.pkp.classes.linkAction.request.AjaxAction');
 import('lib.pkp.classes.linkAction.request.OpenWindowAction');
 import('lib.pkp.classes.linkAction.request.RemoteActionConfirmationModal');
 
 class SimilarityActionGridColumn extends GridColumn {
 	
-    protected $similarityScoreColumns = [];
+	/**
+	 * List of columns record to retrieve to show ithenticate's similarity scores
+	 *
+	 * @var array
+	 */
+	protected $similarityScoreColumns = [];
 
+	/**
+	 * Constructor
+	 *
+	 * @param array $scoreColumns   List of columns record to retrieve to show ithenticate's 
+	 *                              similarity scores 
+	 */
     public function __construct($scoreColumns) {
 
         $this->similarityScoreColumns = $scoreColumns;

From 7a7cc35cc056e41b05984d3fa902a46f858f7ea5 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 14 May 2024 16:07:32 +0600
Subject: [PATCH 22/75] pkp/plagiarism#52 added confirmation checkbox on
 submission EULA re-confirmation form

---
 .../PlagiarismEulaAcceptanceHandler.inc.php   | 29 +++++++++++++++--
 ...PlagiarismIthenticateActionHandler.inc.php |  2 +-
 locale/en_US/locale.po                        |  8 ++++-
 templates/confirmEula.tpl                     | 32 +++++++++++++++++--
 4 files changed, 64 insertions(+), 7 deletions(-)

diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index 8eac35b..ea18aed 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -31,6 +31,14 @@ public function handle($args, $request) {
 		$context = $request->getContext();
         $user = $request->getUser();
         $submissionEulaVersion = $args['version'];
+        $confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
+
+        if (!$confirmSubmissionEula) {
+            SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
+            return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
+        }
+
+        SessionManager::getManager()->getUserSession()->unsetSessionVar('confirmSubmissionEulaError');
 
         /** @var \IThenticate $ithenticate */
         $ithenticate = static::$_plugin->initIthenticate(
@@ -45,7 +53,21 @@ public function handle($args, $request) {
             static::$_plugin->stampEulaVersionToUser($user, $submissionEulaVersion);
 		}
 
-		$request->redirectUrl(
+		return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
+	}
+
+    /**
+	 * Generate and get the redirection url
+	 *
+	 * @param Request $request
+     * @param Context $context
+     * @param array $args
+	 * 
+	 * @return string
+	 */
+    protected function redirectToUrl($request, $context, $args) {
+        
+        return $request->redirectUrl(
             $request->getDispatcher()->url(
                 $request,
                 ROUTE_PAGE,
@@ -53,8 +75,9 @@ public function handle($args, $request) {
                 'submission',
                 'wizard',
                 4,
-                ['submissionId' => $args['submissionId']]
+                $args
             )
         );
-	}
+    }
+    
 }
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 0b5c38c..78519b5 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -43,7 +43,7 @@ public function launchViewer($args, $request) {
 		$viewerUrl = $ithenticate->createViewerLaunchUrl(
 			$submissionFile->getData('ithenticate_id'),
 			$user,
-			'en-US'
+			'en-US' // Need to update it based on user/submission appropriate locale
 		);
 
 		return $request->redirectUrl($viewerUrl);
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 35ce059..630af22 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -87,8 +87,14 @@ msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link<
 msgid "plugins.generic.plagiarism.submission.eula.acceptance.message"
 msgstr "You must read and accept the <a target=\"_blank\" href=\"{$localizedEulaUrl}\">iThenticate EULA</a> before proceeding to finalise the submission."
 
+msgid "plugins.generic.plagiarism.submission.eula.acceptance.confirm"
+msgstr "I have read the end user license agreement and accept it."
+
+msgid "plugins.generic.plagiarism.submission.eula.acceptance.error"
+msgstr "Must need to confirm and accept the EULA."
+
 msgid "plugins.generic.plagiarism.submission.eula.accept.button.title"
-msgstr "Accept EULA and Continue"
+msgstr "Confirm and Continue"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.title"
 msgstr "Submission similarity check settings"
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
index 3c90318..7572aa4 100644
--- a/templates/confirmEula.tpl
+++ b/templates/confirmEula.tpl
@@ -35,6 +35,34 @@
     {include file="controllers/notification/inPlaceNotification.tpl" notificationId="submitStep4FormNotification"}
 
     <p>{$eulaAcceptanceMessage}</p>
-
-    {fbvFormButtons id="eulaConfirmationAcceptance" submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"}
+	    
+    <div>
+        {fbvElement 
+            type="checkbox" 
+            name="confirmSubmissionEula" 
+            id="confirmSubmissionEula"
+            label="plugins.generic.plagiarism.submission.eula.acceptance.confirm" 
+            translate="true"
+            
+        }
+        
+        {if SessionManager::getManager()->getUserSession()->getSessionVar('confirmSubmissionEulaError')}
+            <span>
+                <label class="sub_label error">
+                    {translate key="plugins.generic.plagiarism.submission.eula.acceptance.error"}
+                </label>
+            </span>
+        {/if}
+    </div>
+    
+    {fbvFormButtons 
+        id="eulaConfirmationAcceptance"
+        submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"
+    }
 </form>
+
+<style>
+    .pkp_form li {
+        list-style: none;
+    }
+</style>

From 43656b9701aab6a1c32eb85de072cdf6980dbf3a Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 15 May 2024 14:32:14 +0600
Subject: [PATCH 23/75] pkp/plagiarism#52 added viewer update settings and
 proper handling of locale on viewer launch

---
 IThenticate.inc.php                           | 99 +++++++++++++------
 PlagiarismPlugin.inc.php                      | 17 +++-
 PlagiarismSettingsForm.inc.php                |  2 +
 TestIThenticate.inc.php                       | 46 ++++++---
 ...PlagiarismIthenticateActionHandler.inc.php | 21 +++-
 locale/en_US/locale.po                        |  3 +
 templates/settingsForm.tpl                    | 13 +--
 7 files changed, 143 insertions(+), 58 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 444c750..0b248b0 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -239,7 +239,7 @@ public function confirmEula($user, $context) {
                 'json' => [
                     'user_id' => $this->getGeneratedId('submitter', $user->getId()),
                     'accepted_timestamp' => \Carbon\Carbon::now()->toIso8601String(),
-                    'language' => $this->getEulaConfirmationLocale($context->getPrimaryLocale()),
+                    'language' => $this->getApplicableLocale($context->getPrimaryLocale()),
                 ],
                 'verify' => false,
                 'exceptions' => false,
@@ -442,13 +442,16 @@ public function getSimilarityResult($submissionUuid) {
      * Create the viewer launch url
      * @see https://developers.turnitin.com/docs/tca#create-viewer-launch-url
      *
-     * @param string    $submissionUuid The submission UUID return back from service
-     * @param User      $user           The viewing user
-     * @param string    $locale         The preferred locale
+     * @param string    $submissionUuid         The submission UUID return back from service
+     * @param User      $user                   The viewing user
+     * @param string    $locale                 The preferred locale
+     * @param string    $viewerPermission       The viewing user permission
+     * @param bool      $allowUpdateInViewer    Should allow to update in the viewer and save it which will
+     *                                          cause the update of similarity score
      * 
      * @return string|null
      */
-    public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
+    public function createViewerLaunchUrl($submissionUuid, $user, $locale, $viewerPermission, $allowUpdateInViewer) {
 
         $response = $this->makeApiRequest(
             'POST',
@@ -460,7 +463,7 @@ public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
                 'json' => [
                     'viewer_user_id' => $this->getGeneratedId('submitter', $user->getId()),
                     'locale' => $locale,
-                    'viewer_default_permission_set' => 'ADMINISTRATOR',
+                    'viewer_default_permission_set' => $viewerPermission,
                     'viewer_permissions' => [
                         'may_view_submission_full_source' => true,
                         'may_view_match_submission_info' => true,
@@ -468,6 +471,11 @@ public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
                         'may_view_document_details_panel' => true,
                         'may_view_sections_exclusion_panel' => true,
                     ],
+                    'similarity' => [
+                        'view_settings' => [
+                            'save_changes' => $allowUpdateInViewer
+                        ],
+                    ],
                 ],
                 'exceptions' => false,
             ]
@@ -600,26 +608,6 @@ public function setApplicableEulaVersion($version) {
         return $this;
     }
 
-    /**
-     * Get the applicable EULA Url
-     * 
-     * @param  string|null $locale
-     * @return string
-     * 
-     * @throws \Exception
-     */
-    public function getApplicableEulaUrl($locale = null) {
-        if (!$this->eulaVersion) {
-            throw new \Exception('No EULA version set yet');
-        }
-
-        $applicableEulaLanguage = $this->getEulaConfirmationLocale($locale ?? static::DEFAULT_EULA_LANGUAGE);
-
-        $eulaUrl = $this->eulaVersionDetails['url'];
-
-        return str_replace(static::DEFAULT_EULA_LANGUAGE, $applicableEulaLanguage, $eulaUrl);
-    }
-
     /**
      * Make the api request
      * 
@@ -655,22 +643,69 @@ public function makeApiRequest($method, $url, $options = []) {
         return $response;
     }
 
+    /**
+     * Get the applicable EULA Url
+     * 
+     * @param  string|array|null $locale
+     * @return string
+     * 
+     * @throws \Exception
+     */
+    public function getApplicableEulaUrl($locales = null) {
+        if (!$this->eulaVersion) {
+            throw new \Exception('No EULA version set yet');
+        }
+
+        $applicableEulaLanguage = $this->getApplicableLocale($locales ?? static::DEFAULT_EULA_LANGUAGE);
+
+        $eulaUrl = $this->eulaVersionDetails['url'];
+
+        return str_replace(
+            strtolower(static::DEFAULT_EULA_LANGUAGE),
+            strtolower($applicableEulaLanguage),
+            $eulaUrl
+        );
+    }
+
     /**
      * Convert given submission/context locale to service compatible and acceptable locale format
      * @see https://developers.turnitin.com/docs/tca#eula
      * 
-     * @param string $locale
+     * @param string|array $locales
+     * @param string|null  $eulaVersion
+     * 
      * @return string
      */
-    protected function getEulaConfirmationLocale($locale) {
-        if (!$this->getEulaDetails()) {
+    public function getApplicableLocale($locales, $eulaVersion = null) {
+        if (!$this->getEulaDetails() && !$this->validateEulaVersion($eulaVersion ?? $this->eulaVersion)) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $eulaLangs = $this->getEulaDetails()['available_languages'];
-        $locale = str_replace("_", "-", substr($locale, 0, 5));
+        if (is_string($locales)) {
+            return $this->getCorrespondingLocaleAvailable($locales) ?? static::DEFAULT_EULA_LANGUAGE;
+        }
+
+        foreach ($locales as $locale) {
+            $correspondingLocale = $this->getCorrespondingLocaleAvailable($locale);
+            if ($correspondingLocale) {
+                return $correspondingLocale;
+            }
+        }
+
+        return static::DEFAULT_EULA_LANGUAGE;
+    }
 
-        return in_array($locale, $eulaLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+    /**
+     * Get the corresponding available locale or return null
+     * 
+     * @param string $locales
+     * @return string|null
+     */
+    protected function getCorrespondingLocaleAvailable($locale) {
+        $eulaLangs = $this->eulaVersionDetails['available_languages'];
+        $locale = str_replace("_", "-", substr($locale, 0, 5));
+        
+        return in_array($locale, $eulaLangs) ? $locale : null;
     }
 
     /**
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index d41cb5f..8fd92a4 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -909,15 +909,17 @@ public function hasForcedCredentials() {
 	}
 
 	/**
-	 * Get the configuration settings for ithenticate similarity report generation process
+	 * Get the configuration settings(all or specific) for ithenticate similarity report generation process
 	 * 
-	 * @param Context $context
-	 * @return array
+	 * @param Context 		$context
+	 * @param string|null 	$settingName
+	 * 
+	 * @return array|string|null
 	 */
-	public function getSimilarityConfigSettings($context) {
+	public function getSimilarityConfigSettings($context, $settingName = null) {
 		$contextPath = $context->getPath();
 
-		return [
+		$similarityConfigSettings = [
 			'addToIndex' 			=> $this->getForcedConfigSetting($contextPath, 'addToIndex') 			?? $this->getSetting($context->getId(), 'addToIndex'),
 			'excludeQuotes' 		=> $this->getForcedConfigSetting($contextPath, 'excludeQuotes') 		?? $this->getSetting($context->getId(), 'excludeQuotes'),
 			'excludeBibliography' 	=> $this->getForcedConfigSetting($contextPath, 'excludeBibliography') 	?? $this->getSetting($context->getId(), 'excludeBibliography'),
@@ -925,7 +927,12 @@ public function getSimilarityConfigSettings($context) {
 			'excludeAbstract' 		=> $this->getForcedConfigSetting($contextPath, 'excludeAbstract') 		?? $this->getSetting($context->getId(), 'excludeAbstract'),
 			'excludeMethods' 		=> $this->getForcedConfigSetting($contextPath, 'excludeMethods') 		?? $this->getSetting($context->getId(), 'excludeMethods'),
 			'excludeSmallMatches' 	=> $this->getForcedConfigSetting($contextPath, 'excludeSmallMatches') 	?? $this->getSetting($context->getId(), 'excludeSmallMatches'),
+			'allowViewerUpdate'		=> $this->getForcedConfigSetting($contextPath, 'allowViewerUpdate') 	?? $this->getSetting($context->getId(), 'allowViewerUpdate'),
 		];
+
+		return $settingName
+			? ($similarityConfigSettings[$settingName] ?? null)
+			: $similarityConfigSettings;
 	}
 
 	/**
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 264c071..87d267d 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -98,6 +98,7 @@ public function readInputData() {
 			'excludeAbstract',
 			'excludeMethods',
 			'excludeSmallMatches',
+			'allowViewerUpdate',
 		]);
 	}
 
@@ -143,6 +144,7 @@ public function execute(...$functionArgs) {
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeAbstract', 		$this->getData('excludeAbstract'), 		'bool');
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeMethods', 		$this->getData('excludeMethods'), 		'bool');
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeSmallMatches', 	$this->getData('excludeSmallMatches'), 	'int');
+		$this->_plugin->updateSetting($this->_context->getId(), 'allowViewerUpdate', 	$this->getData('allowViewerUpdate'), 	'bool');
 		
 
 		parent::execute(...$functionArgs);
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 200756e..52b06a4 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -186,7 +186,7 @@ public function validateAccess(&$result = null) {
      * @copydoc \IThenticate::confirmEula()
      */
     public function confirmEula($user, $context) {
-        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getEulaConfirmationLocale($context->getPrimaryLocale())." for version {$this->getApplicableEulaVersion()}");
+        error_log("Confirming EULA for user {$user->getId()} with language ".$this->getApplicableLocale($context->getPrimaryLocale())." for version {$this->getApplicableEulaVersion()}");
         return true;
     }
     
@@ -252,8 +252,8 @@ public function getSimilarityResult($submissionUuid) {
     /**
      * @copydoc \IThenticate::createViewerLaunchUrl()
      */
-    public function createViewerLaunchUrl($submissionUuid, $user, $locale) {
-        error_log("Similarity report viewer launch url generated for iThenticate submission id : {$submissionUuid}");
+    public function createViewerLaunchUrl($submissionUuid, $user, $locale, $viewerPermission, $allowUpdateInViewer) {
+        error_log("Similarity report viewer launch url generated for iThenticate submission id : {$submissionUuid} with locale : {$locale}, viewer permission : {$viewerPermission} and update viewer permission : {$allowUpdateInViewer}");
         return Application::get()->getRequest()->getBaseUrl();
     }
 
@@ -314,30 +314,52 @@ public function setApplicableEulaVersion($version) {
     /**
      * @copydoc \IThenticate::getApplicableEulaUrl()
      */
-    public function getApplicableEulaUrl($locale = null) {
+    public function getApplicableEulaUrl($locales = null) {
         if (!$this->eulaVersion) {
             throw new \Exception('No EULA version set yet');
         }
 
-        $applicableEulaLanguage = $this->getEulaConfirmationLocale($locale ?? static::DEFAULT_EULA_LANGUAGE);
+        $applicableEulaLanguage = $this->getApplicableLocale($locales ?? static::DEFAULT_EULA_LANGUAGE);
 
         $eulaUrl = $this->eulaVersionDetails['url'];
 
-        return str_replace(static::DEFAULT_EULA_LANGUAGE, $applicableEulaLanguage, $eulaUrl);
+        return str_replace(
+            strtolower(static::DEFAULT_EULA_LANGUAGE),
+            strtolower($applicableEulaLanguage),
+            $eulaUrl
+        );
     }
 
     /**
-     * @copydoc \IThenticate::getEulaConfirmationLocale()
+     * @copydoc \IThenticate::getApplicableLocale()
      */
-    protected function getEulaConfirmationLocale($locale) {
-        if (!$this->getEulaDetails()) {
+    public function getApplicableLocale($locales, $eulaVersion = null) {
+        if (!$this->getEulaDetails() && !$this->validateEulaVersion($eulaVersion ?? $this->eulaVersion)) {
             return static::DEFAULT_EULA_LANGUAGE;
         }
 
-        $eulaLangs = $this->getEulaDetails()['available_languages'];
-        $locale = str_replace("_", "-", substr($locale, 0, 5));
+        if (is_string($locales)) {
+            return $this->getCorrespondingLocaleAvailable($locales) ?? static::DEFAULT_EULA_LANGUAGE;
+        }
 
-        return in_array($locale, $eulaLangs) ? $locale : static::DEFAULT_EULA_LANGUAGE;
+        foreach ($locales as $locale) {
+            $correspondingLocale = $this->getCorrespondingLocaleAvailable($locale);
+            if ($correspondingLocale) {
+                return $correspondingLocale;
+            }
+        }
+
+        return static::DEFAULT_EULA_LANGUAGE;
+    }
+
+    /**
+     * @copydoc \IThenticate::isCorrespondingLocaleAvailable()
+     */
+    protected function getCorrespondingLocaleAvailable($locale) {
+        $eulaLangs = $this->eulaVersionDetails['available_languages'];
+        $locale = str_replace("_", "-", substr($locale, 0, 5));
+        
+        return in_array($locale, $eulaLangs) ? $locale : null;
     }
 
     /**
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 78519b5..5281331 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -31,19 +31,34 @@ public function launchViewer($args, $request) {
 		$context = $request->getContext();
         $user = $request->getUser();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
+		$siteDao = DAORegistry::getDAO("SiteDAO"); /** @var SiteDAO $siteDao */
+		$site = $siteDao->getSite();
 
 		/** @var \IThenticate $ithenticate */
         $ithenticate = static::$_plugin->initIthenticate(
             ...static::$_plugin->getServiceAccess($context)
         );
 
+		$locale = $ithenticate
+			->setApplicableEulaVersion($submission->getData('ithenticate_eula_version'))
+			->getApplicableLocale(
+				collect([$submission->getData("locale")])
+					->merge($user->getData("locales"))
+					->merge([$context->getPrimaryLocale(), $site->getPrimaryLocale()])
+					->unique()
+					->toArray()
+			);
+
 		$viewerUrl = $ithenticate->createViewerLaunchUrl(
 			$submissionFile->getData('ithenticate_id'),
 			$user,
-			'en-US' // Need to update it based on user/submission appropriate locale
+			$locale,
+			static::$_plugin->getSubmitterPermission($context, $user),
+			(bool)static::$_plugin->getSimilarityConfigSettings($context, 'allowViewerUpdate')
 		);
 
 		return $request->redirectUrl($viewerUrl);
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 630af22..5ec5040 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -126,6 +126,9 @@ msgstr "Exclude small match count"
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"
 msgstr "Similarity matches that match less than the specified amount of words will not count as similar content"
 
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate"
+msgstr "Allow changes in the similarity viewer to update the similarity score"
+
 msgid "plugins.generic.plagiarism.similarity.action.column.score.title"
 msgstr "Plagiarism Score"
 
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 206d8ad..22e6366 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -46,12 +46,13 @@
 				<b>{translate key="plugins.generic.plagiarism.similarityCheck.settings.warning.note"}</b>
 			</div>
 
-			{fbvElement type="checkbox" name="addToIndex" 					id="addToIndex" 					checked=$addToIndex 					label="plugins.generic.plagiarism.similarityCheck.settings.field.addToIndex" 					translate="true"}
-			{fbvElement type="checkbox" name="excludeQuotes" 				id="excludeQuotes" 					checked=$excludeQuotes 					label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeQuotes" 				translate="true"}
-			{fbvElement type="checkbox" name="excludeBibliography" 			id="excludeBibliography" 			checked=$excludeBibliography 			label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeBibliography" 			translate="true"}
-			{fbvElement type="checkbox" name="excludeCitations" 			id="excludeCitations" 				checked=$excludeCitations 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations" 				translate="true"}
-			{fbvElement type="checkbox" name="excludeAbstract" 				id="excludeAbstract" 				checked=$excludeAbstract 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract" 				translate="true"}
-			{fbvElement type="checkbox" name="excludeMethods" 				id="excludeMethods" 				checked=$excludeMethods 				label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods" 				translate="true"}
+			{fbvElement type="checkbox" name="addToIndex" 			id="addToIndex" 			checked=$addToIndex 			label="plugins.generic.plagiarism.similarityCheck.settings.field.addToIndex" 			translate="true"}
+			{fbvElement type="checkbox" name="excludeQuotes" 		id="excludeQuotes" 			checked=$excludeQuotes 			label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeQuotes" 		translate="true"}
+			{fbvElement type="checkbox" name="excludeBibliography" 	id="excludeBibliography" 	checked=$excludeBibliography 	label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeBibliography" 	translate="true"}
+			{fbvElement type="checkbox" name="excludeCitations" 	id="excludeCitations" 		checked=$excludeCitations 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations" 		translate="true"}
+			{fbvElement type="checkbox" name="excludeAbstract" 		id="excludeAbstract" 		checked=$excludeAbstract 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract" 		translate="true"}
+			{fbvElement type="checkbox" name="excludeMethods" 		id="excludeMethods" 		checked=$excludeMethods 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods" 		translate="true"}
+			{fbvElement type="checkbox" name="allowViewerUpdate" 	id="allowViewerUpdate" 		checked=$allowViewerUpdate 		label="plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate" 	translate="true"}
 			
 			{fbvFormSection description="plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"}
 				{fbvElement 

From 7ceb718108921dd8fde3201b15567a96735a80bb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 15 May 2024 20:09:37 +0600
Subject: [PATCH 24/75] pkp/plagiarism#52 added eula confirmation modal as
 middle action from workflow section

---
 PlagiarismPlugin.inc.php                      |   1 +
 ...PlagiarismIthenticateActionHandler.inc.php | 232 +++++++++++++-----
 grids/SimilarityActionGridColumn.inc.php      |  89 ++++++-
 locale/en_US/locale.po                        |  11 +-
 templates/confirmEula.tpl                     |  39 ++-
 5 files changed, 300 insertions(+), 72 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 8fd92a4..7c0e2d5 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -604,6 +604,7 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
 		$editorSubmissionDetailsFilesGridHandler->addColumn(
 			new SimilarityActionGridColumn(
+				$this,
 				$this->similarityScoreColumns
 			)
 		);
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 5281331..1f44513 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -15,6 +15,7 @@
 
 import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import('lib.pkp.classes.core.JSONMessage'); 
+import('lib.pkp.classes.db.DAORegistry');
 import("plugins.generic.plagiarism.IThenticate");
 
 class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
@@ -24,8 +25,6 @@ class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
 	 *
 	 * @param array $args
 	 * @param Request $request
-	 * 
-	 * @return void
 	 */
 	public function launchViewer($args, $request) {
 		$context = $request->getContext();
@@ -64,13 +63,86 @@ public function launchViewer($args, $request) {
 		return $request->redirectUrl($viewerUrl);
 	}
 
-    /**
+	/**
+	 * Schedule the similarity report generate process at iThenticate services's end
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 */
+    public function scheduleSimilarityReport($args, $request) {
+
+		$context = $request->getContext();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
+			$submissionFile->getData('ithenticate_id'),
+			static::$_plugin->getSimilarityConfigSettings($context)
+		);
+
+		if (!$scheduleSimilarityReport) {
+			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
+		$submissionFileDao->updateObject($submissionFile);
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+    }
+
+	/**
+	 * Refresh the submission's similarity score result
+	 *
+	 * @param array $args
+	 * @param Request $request
+	 */
+    public function refreshSimilarityResult($args, $request) {
+		$context = $request->getContext();
+
+		/** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+
+		/** @var \IThenticate $ithenticate */
+        $ithenticate = static::$_plugin->initIthenticate(
+            ...static::$_plugin->getServiceAccess($context)
+        );
+
+		$similarityScoreResult = $ithenticate->getSimilarityResult(
+			$submissionFile->getData('ithenticate_id')
+		);
+
+		if (!$similarityScoreResult) {
+			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$similarityScoreResult = json_decode($similarityScoreResult);
+
+		if ($similarityScoreResult->status !== 'COMPLETE') {
+			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			return new JSONMessage(false);
+		}
+
+		$submissionFile->setData('ithenticate_similarity_result', json_encode($similarityScoreResult));
+		$submissionFileDao->updateObject($submissionFile);
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+    }
+
+	/**
 	 * Upload the submission file and create a new submission at iThenticate service's end
 	 *
 	 * @param array $args
 	 * @param Request $request
-	 * 
-	 * @return void
 	 */
 	public function submitSubmission($args, $request) {
 		$context = $request->getContext();
@@ -124,82 +196,132 @@ public function submitSubmission($args, $request) {
 	}
 
 	/**
-	 * Schedule the similarity report generate process at iThenticate services's end
+	 * Accept the EULA, stamp it to proper entity (Submission/User or both) and run
+	 * one of following intended action
+	 * 	- Upload submission file
+	 * 	- Schedule similarity report generation process
+	 *  - Refresh the similarity report scores
 	 *
 	 * @param array $args
 	 * @param Request $request
-	 * 
-	 * @return void
 	 */
-    public function scheduleSimilarityReport($args, $request) {
-
+	public function acceptEulaAndExecuteIntendedAction($args, $request) {
 		$context = $request->getContext();
+		$user = $request->getUser();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
-		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
+        $confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
 
-		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
-			$submissionFile->getData('ithenticate_id'),
-			static::$_plugin->getSimilarityConfigSettings($context)
-		);
+		if (!$confirmSubmissionEula) {
 
-		if (!$scheduleSimilarityReport) {
-			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
-		}
+			$templateManager = $this->getEulaConfirmationTemplate(
+				$request,
+				$args,
+				$context,
+				$submission,
+				$submissionFile
+			);
 
-		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
-		$submissionFileDao->updateObject($submissionFile);
+            SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
 
-		return DAO::getDataChangedEvent($submissionFile->getId());
-    }
+            return new JSONMessage(
+				true,
+				$templateManager->fetch(static::$_plugin->getTemplateResource('confirmEula.tpl'))
+			);
+        }
+
+		if (!$submission->getData('ithenticate_eula_version')) {
+            static::$_plugin->stampEulaToSubmission('', [$submission]);
+        }
+
+        if (!$user->getData('ithenticateEulaVersion')) {
+            static::$_plugin->stampEulaToSubmittingUser('', [$submission]);
+        }
+
+		$onAcceptAction = $args['onAcceptAction'];
+
+		return $this->{$onAcceptAction}($args, $request);
+	}
 
 	/**
-	 * Refresh the submission's similarity score result
+	 * Show the EULA confirmation modal before the intended action
 	 *
 	 * @param array $args
 	 * @param Request $request
-	 * 
-	 * @return void
 	 */
-    public function refreshSimilarityResult($args, $request) {
+	public function confirmEula($args, $request) {
 		$context = $request->getContext();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
-		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
-
-		$similarityScoreResult = $ithenticate->getSimilarityResult(
-			$submissionFile->getData('ithenticate_id')
+		$templateManager = $this->getEulaConfirmationTemplate(
+			$request,
+			$args,
+			$context,
+			$submission,
+			$submissionFile
 		);
 
-		if (!$similarityScoreResult) {
-			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
-		}
-
-		$similarityScoreResult = json_decode($similarityScoreResult);
+		return new JSONMessage(
+			true,
+			$templateManager->fetch(static::$_plugin->getTemplateResource('confirmEula.tpl'))
+		);
+	}
 
-		if ($similarityScoreResult->status !== 'COMPLETE') {
-			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
-		}
+	/**
+	 * Get the template manager to handle the EULA confirmation as the before action of 
+	 * intended action.
+	 *
+	 * @param Request 			$request
+	 * @param array 			$args
+	 * @param Context 			$context
+	 * @param Submission 		$submission
+	 * @param SubmissionFile 	$submissionFile
+	 * 
+	 * @return TemplateManager
+	 */
+	protected function getEulaConfirmationTemplate($request, $args, $context, $submission, $submissionFile) {
+
+		$eulaVersionDetails = $submission->getData('ithenticate_eula_version')
+			? [
+				'version' 	=> $submission->getData('ithenticate_eula_version'),
+				'url' 		=> $submission->getData('ithenticate_eula_url')
+			] : static::$_plugin->getContextEulaDetails($context, [
+				$submission->getData('locale'),
+				$request->getSite()->getPrimaryLocale(),
+				\IThenticate::DEFAULT_EULA_LANGUAGE
+			]);
+		
+		$actionUrl = $request->getDispatcher()->url(
+			$request,
+			ROUTE_COMPONENT,
+			$context->getData('urlPath'),
+			'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+			'acceptEulaAndExecuteIntendedAction',
+			null,
+			[
+				'version' => $eulaVersionDetails['version'],
+				'submissionFileId' => $submissionFile->getId(),
+				'onAcceptAction' => $args['onAcceptAction'],
+			]
+		);
 
-		$submissionFile->setData('ithenticate_similarity_result', json_encode($similarityScoreResult));
-		$submissionFileDao->updateObject($submissionFile);
+		$templateManager = TemplateManager::getManager();
+		$templateManager->assign([
+			'actionUrl' => $actionUrl,
+			'eulaAcceptanceMessage' => __('plugins.generic.plagiarism.submission.eula.acceptance.message', [
+				'localizedEulaUrl' => $eulaVersionDetails['url'],
+			]),
+		]);
 
-		return DAO::getDataChangedEvent($submissionFile->getId());
-    }
+		return $templateManager;
+	}
 
 }
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index a17f6ab..c054245 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -13,10 +13,12 @@
  * @brief GridColumn handler to show similarity score and actions related to iThenticate
  */
 
+import('lib.pkp.classes.db.DAORegistry');
 import('lib.pkp.classes.controllers.grid.GridColumn');
 import('lib.pkp.classes.controllers.grid.ColumnBasedGridCellProvider');
 import('lib.pkp.classes.linkAction.request.OpenWindowAction');
 import('lib.pkp.classes.linkAction.request.RemoteActionConfirmationModal');
+import('lib.pkp.classes.linkAction.request.AjaxModal');
 
 class SimilarityActionGridColumn extends GridColumn {
 	
@@ -27,14 +29,23 @@ class SimilarityActionGridColumn extends GridColumn {
 	 */
 	protected $similarityScoreColumns = [];
 
+    /** 
+	 * The Plagiarism Plugin itself
+	 * 
+	 * @var PlagiarismPlugin
+	 */
+	protected $_plugin;
+
 	/**
 	 * Constructor
 	 *
-	 * @param array $scoreColumns   List of columns record to retrieve to show ithenticate's 
-	 *                              similarity scores 
+     * @param PlagiarismPlugin  $plugin         The Plagiarism Plugin itself
+	 * @param array             $scoreColumns   List of columns record to retrieve to show ithenticate's 
+	 *                                          similarity scores 
 	 */
-    public function __construct($scoreColumns) {
+    public function __construct($plugin, $scoreColumns) {
 
+        $this->_plugin = $plugin;
         $this->similarityScoreColumns = $scoreColumns;
 
         $cellProvider = new ColumnBasedGridCellProvider();
@@ -108,10 +119,41 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 
 		$submissionFileData = $row->getData();
         $submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+        $submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
         // There was an error and submission not completed, 
         // Ask for confirmation and try to complete the submission process
         if (!$submissionFile->getData('ithenticate_id')) {
+
+            // first check if curernt user has already EULA confirmed that is associated with submission
+            // If not confirmed, need to confirm EULA first before uploading submission to iThenticate
+
+            if ($this->isEulaConfirmationRequired($context, $submission, $user)) {
+
+                $cellActions[] = new LinkAction(
+                    "plagiarism-eula-confirmation-{$submissionFile->getId()}",
+                    new AjaxModal(
+                        $request->getDispatcher()->url(
+                            $request,
+                            ROUTE_COMPONENT,
+                            $context->getData('urlPath'),
+                            'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+                            'confirmEula',
+                            null,
+                            [
+                                'submissionFileId' => $submissionFile->getId(),
+                                'onAcceptAction' => 'submitSubmission',
+                            ]
+                        ),
+                        __('plugins.generic.plagiarism.similarity.action.confirmEula.title')
+                    ),
+                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
+                );
+                
+                return $cellActions;
+            }
+
             $cellActions[] = new LinkAction(
                 "plagiarism-submission-submit-{$submissionFile->getId()}",
                 new RemoteActionConfirmationModal(
@@ -132,6 +174,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
                 ),
                 __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
             );
+
+            return $cellActions;
         }
         
         // Submission similarity report generation has not scheduled
@@ -156,6 +200,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
                 ),
                 __('plugins.generic.plagiarism.similarity.action.generateReport.title')
             );
+
+            return $cellActions;
         }
 
         // Generate the action for similarity score refresh
@@ -212,4 +258,41 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		return $cellActions;
 	}
 
+    /**
+	 * Check for the requrement of EULA confirmation
+	 *
+     * @param Context       $context
+     * @param Submission    $submission
+     * @param User          $user
+     * 
+     * @return bool
+	 */
+    protected function isEulaConfirmationRequired($context, $submission, $user) {
+
+        // Check if EULA confirmation required for this tenant
+        if ($this->_plugin->getContextEulaDetails($context, 'require_eula') === false) {
+            return false;
+        }
+
+        // If no EULA is stamped with submission
+        // means submission never passed through iThenticate process
+        if (!$submission->getData('ithenticate_eula_version')) {
+            return true;
+        }
+
+        // If no EULA is stamped with submission
+        // means user has never previously interacted with iThenticate process
+        if (!$user->getData('ithenticateEulaVersion')) {
+            return true;
+        }
+
+        // If user and submission EULA do not match
+        // means users previously agreed upon different EULA
+        if ($user->getData('ithenticateEulaVersion') !== $submission->getData('ithenticate_eula_version')) {
+            return true;
+        }
+
+        return false;
+    }
+
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 5ec5040..5e7a25c 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -133,7 +133,7 @@ msgid "plugins.generic.plagiarism.similarity.action.column.score.title"
 msgstr "Plagiarism Score"
 
 msgid "plugins.generic.plagiarism.similarity.action.launch.viewer.title"
-msgstr "Launch Plagiarims Similarity Viewer"
+msgstr "Launch Plagiarism Similarity Viewer"
 
 msgid "plugins.generic.plagiarism.similarity.score.column.overall_match_percentage"
 msgstr "Overall Match Percentage"
@@ -151,16 +151,19 @@ msgid "plugins.generic.plagiarism.similarity.action.generateReport.title"
 msgstr "Schedule Plagiarism Report"
 
 msgid "plugins.generic.plagiarism.similarity.action.generateReport.confirmation"
-msgstr "Are you sure you want to generate the plagiarims report?"
+msgstr "Are you sure you want to generate the Plagiarism report?"
 
 msgid "plugins.generic.plagiarism.similarity.action.refreshReport.title"
 msgstr "Refresh Plagiarism Similarity Score"
 
 msgid "plugins.generic.plagiarism.similarity.action.refreshReport.confirmation"
-msgstr "Are you sure you want to refresh plagiarims similarity score?"
+msgstr "Are you sure you want to refresh Plagiarism similarity score?"
 
 msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title"
-msgstr "Submit for Plagiarims Check"
+msgstr "Submit for Plagiarism Check"
 
 msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation"
 msgstr "Are you sure you want to submit this file for plagiarism check?"
+
+msgid "plugins.generic.plagiarism.similarity.action.confirmEula.title"
+msgstr "Plagiarism End User License Agreement Confirmation"
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
index 7572aa4..10f0965 100644
--- a/templates/confirmEula.tpl
+++ b/templates/confirmEula.tpl
@@ -9,18 +9,37 @@
  *}
 <script type="text/javascript">
     $(function() {ldelim}
-        // Attach the JS form handler.
-        // $('#confirmEulaForm').pkpHandler('$.pkp.controllers.form.AjaxFormHandler');
 
-        let cancelWarningMessage = "{$cancelWarningMessage}",
-            cancelRedirect = "{$cancelRedirect}";
-        
-        $('form#confirmEulaForm').on('click', 'a.cancelButton', function (event) {
-            event.preventDefault();
-            if (confirm(cancelWarningMessage) === true) {
-                window.location.href = cancelRedirect;
+        const isValidUrl = urlString => {
+            let url;
+
+            try { 
+                url = new URL(urlString); 
+            } catch(e) { 
+                return false; 
             }
-        });
+
+            return url.protocol === "http:" || url.protocol === "https:";
+        }
+        
+        let cancelWarningMessage = "{$cancelWarningMessage}" || undefined,
+            cancelRedirect = "{$cancelRedirect}" || undefined;
+
+        
+        if (isValidUrl(cancelRedirect)) {
+            $('form#confirmEulaForm').on('click', 'a.cancelButton', function (event) {
+                if (cancelRedirect === 'modal') {
+                    return true;
+                }
+                event.preventDefault();
+                if (confirm(cancelWarningMessage) === true) {
+                    window.location.href = cancelRedirect;
+                }
+            });
+        } else {
+            // Attach the JS form handler.
+            $('#confirmEulaForm').pkpHandler('$.pkp.controllers.form.AjaxFormHandler');
+        }
     {rdelim});
 </script>
 

From 837bd309640165c8de25a1e1e8519a25c268326b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 16 May 2024 15:00:05 +0600
Subject: [PATCH 25/75] pkp/plagiarism#52 added time stamp flag to indetify if
 submission completed without any fail with code optimiation for new
 submission create

---
 PlagiarismPlugin.inc.php                      | 110 ++++++++++++------
 ...PlagiarismIthenticateActionHandler.inc.php |  33 +-----
 grids/SimilarityActionGridColumn.inc.php      |   6 +-
 3 files changed, 76 insertions(+), 73 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 7c0e2d5..dd7aea5 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -110,6 +110,7 @@ public function register($category, $path, $mainContextId = null) {
 		HookRegistry::register('LoadComponentHandler', [$this, 'handleRouteComponent']);
 
 		HookRegistry::register('editorsubmissiondetailsfilesgridhandler::initfeatures', [$this, 'addActionsToSubmissionFileGrid']);
+		HookRegistry::register('editorreviewfilesgridhandler::initfeatures', [$this, 'addActionsToSubmissionFileGrid']);
 
 		return $success;
 	}
@@ -175,6 +176,16 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 			'validation' => ['nullable'],
 		];
 
+		$schema->properties->ithenticate_submission_completed_at = (object) [
+			'type' => 'string',
+			'description' => 'The timestamp at which this submission successfully completed uploading all files at iThenticate service end',
+			'apiSummary' => true,
+			'validation' => [
+				'date:Y-m-d H:i:s',
+				'nullable',
+			],
+		];
+
 		return false;
 	}
 
@@ -491,10 +502,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$request = Application::get()->getRequest();
 		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$context = $request->getContext();
-		$publication = $submission->getCurrentPublication();
-		$author = $publication->getPrimaryAuthor();
 		$user = $request->getUser();
 
 		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
@@ -522,7 +530,8 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
 			$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
 			
-			// Check if EULA stamped to submitter and if not, try to stamp it
+			// Check if submission EULA stamped to submitter and if not
+			// not going to sent it for plagiarism check
 			if (!$user->getData('ithenticateEulaVersion') ||
 				$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
 				
@@ -541,50 +550,26 @@ public function submitForPlagiarismCheck($hookName, $args) {
 
 		try {
 			foreach($submissionFiles as $submissionFile) { /** @var SubmissionFile $submissionFile */
-				// Create a new submission at iThenticate's end
-				$submissionUuid = $ithenticate->createSubmission(
-					$request->getSite(),
-					$submission,
-					$user,
-					$author,
-					static::SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION,
-					$this->getSubmitterPermission($context, $user)
-				);
-	
-				if (!$submissionUuid) {
-					$this->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
+				if (!$this->createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate)) {
 					return false;
 				}
-	
-				$file = Services::get('file')->get($submissionFile->getData('fileId'));
-				$uploadStatus = $ithenticate->uploadFile(
-					$submissionUuid, 
-					$submissionFile->getData("name", $publication->getData("locale")),
-					Services::get('file')->fs->read($file->path),
-				);
-	
-				// Upload submission files for successfully created submission at iThenticate's end
-				if (!$uploadStatus) {
-					$this->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
-					return false;
-				}
-	
-				$submissionFile->setData('ithenticate_id', $submissionUuid);
-				$submissionFile->setData('ithenticate_similarity_scheduled', 0);
-				$submissionFileDao->updateObject($submissionFile);
 			}
 		} catch (\Throwable $exception) {
 			$this->sendErrorMessage($exception->getMessage(), $submission->getId());
 			return false;
 		}
 
+		$submission->setData('ithenticate_submission_completed_at', Core::getCurrentDate());
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submissionDao->updateObject($submission);
+
 		return true;
 	}
 
 	/**
 	 * Add ithenticate related data and actions to submission file grid view
 	 * 
-	 * @param string $hookName `editorsubmissiondetailsfilesgridhandler::initfeatures`
+	 * @param string $hookName `editorsubmissiondetailsfilesgridhandler::initfeatures` or `editorreviewfilesgridhandler::initfeatures`
 	 * @param array $params
 	 * 
 	 * @return bool
@@ -598,11 +583,11 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 			return false;
 		}
 
-		/** @var EditorSubmissionDetailsFilesGridHandler $editorSubmissionDetailsFilesGridHandler */
-		$editorSubmissionDetailsFilesGridHandler = & $params[0];
+		/** @var EditorSubmissionDetailsFilesGridHandler|EditorReviewFilesGridHandler $submissionDetailsFilesGridHandler */
+		$submissionDetailsFilesGridHandler = & $params[0];
 
 		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
-		$editorSubmissionDetailsFilesGridHandler->addColumn(
+		$submissionDetailsFilesGridHandler->addColumn(
 			new SimilarityActionGridColumn(
 				$this,
 				$this->similarityScoreColumns
@@ -612,6 +597,57 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		return false;
 	}
 
+	/**
+	 * Create a new submission at iThenticate service's end
+	 * 
+	 * @param Request 						$request
+	 * @param User 							$user
+	 * @param Submission 					$submission
+	 * @param SubmissionFile 				$submissionFile
+	 * @param IThenticate|TestIThenticate 	$ithenticate
+	 * 
+	 * @return bool
+	 */
+	public function createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate) {
+		$context = $request->getContext();
+		$publication = $submission->getCurrentPublication();
+		$author = $publication->getPrimaryAuthor();
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+
+		$submissionUuid = $ithenticate->createSubmission(
+			$request->getSite(),
+			$submission,
+			$user,
+			$author,
+			static::SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION,
+			$this->getSubmitterPermission($context, $user)
+		);
+
+		if (!$submissionUuid) {
+			$this->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
+			return false;
+		}
+
+		$file = Services::get('file')->get($submissionFile->getData('fileId'));
+		$uploadStatus = $ithenticate->uploadFile(
+			$submissionUuid, 
+			$submissionFile->getData("name", $publication->getData("locale")),
+			Services::get('file')->fs->read($file->path),
+		);
+
+		// Upload submission files for successfully created submission at iThenticate's end
+		if (!$uploadStatus) {
+			$this->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
+			return false;
+		}
+
+		$submissionFile->setData('ithenticate_id', $submissionUuid);
+		$submissionFile->setData('ithenticate_similarity_scheduled', 0);
+		$submissionFileDao->updateObject($submissionFile);
+
+		return true;
+	}
+
 	/**
 	 * Register the webhook for this context
 	 * 
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 1f44513..6c528ee 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -153,50 +153,21 @@ public function submitSubmission($args, $request) {
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']); /** @var SubmissionFile $submissionFile */
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId')); /** @var Submission $submission*/
-		$publication = $submission->getCurrentPublication();
-		$author = $publication->getPrimaryAuthor();
 
 		/** @var \IThenticate $ithenticate */
         $ithenticate = static::$_plugin->initIthenticate(
             ...static::$_plugin->getServiceAccess($context)
         );
 
-		$submissionUuid = $ithenticate->createSubmission(
-			$request->getSite(),
-			$submission,
-			$user,
-			$author,
-			static::$_plugin::SUBMISSION_AUTOR_ITHENTICATE_DEFAULT_PERMISSION,
-			static::$_plugin->getSubmitterPermission($context, $user)
-		);
-
-		if (!$submissionUuid) {
-			static::$_plugin->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
+		if (!static::$_plugin->createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate)) {
 			return new JSONMessage(false);
 		}
 
-		$file = Services::get('file')->get($submissionFile->getData('fileId'));
-		$uploadStatus = $ithenticate->uploadFile(
-			$submissionUuid, 
-			$submissionFile->getData("name", $publication->getData("locale")),
-			Services::get('file')->fs->read($file->path),
-		);
-
-		// Upload submission files for successfully created submission at iThenticate's end
-		if (!$uploadStatus) {
-			static::$_plugin->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
-			return new JSONMessage(false);
-		}
-
-		$submissionFile->setData('ithenticate_id', $submissionUuid);
-		$submissionFile->setData('ithenticate_similarity_scheduled', 0);
-		$submissionFileDao->updateObject($submissionFile);
-
 		return DAO::getDataChangedEvent($submissionFile->getId());
 	}
 
 	/**
-	 * Accept the EULA, stamp it to proper entity (Submission/User or both) and run
+	 * Accept the EULA, stamp it to proper entity (Submission/User or both) and may run
 	 * one of following intended action
 	 * 	- Upload submission file
 	 * 	- Schedule similarity report generation process
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index c054245..4778903 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -61,16 +61,12 @@ public function __construct($plugin, $scoreColumns) {
 	}
 
 	/**
-	 * Method expected by ColumnBasedGridCellProvider
-	 * to render a cell in this column.
+	 * Method expected by ColumnBasedGridCellProvider to render a cell in this column.
 	 *
 	 * @copydoc ColumnBasedGridCellProvider::getTemplateVarsFromRowColumn()
 	 */
 	public function getTemplateVarsFromRow($row) {
 
-        $request = Application::get()->getRequest();
-        $context = $request->getContext();
-
 		$submissionFileData = $row->getData();
 		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
 		assert($submissionFile instanceof SubmissionFile);

From 4a7af87edc158aeabcff829041b0d09e8a23442e Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 17 May 2024 15:03:33 +0600
Subject: [PATCH 26/75] pkp/plagiarism#52 removed eula as checklist and force
 to confirm as final stage confirmation

---
 PlagiarismPlugin.inc.php                      | 129 ++++--------------
 .../PlagiarismEulaAcceptanceHandler.inc.php   |  23 ++--
 ...PlagiarismIthenticateActionHandler.inc.php |   4 +-
 3 files changed, 36 insertions(+), 120 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index dd7aea5..dc2db90 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -89,16 +89,8 @@ public function register($category, $path, $mainContextId = null) {
 			error_log("ithenticate service access not set for context id {$context->getId()}");
 			return false;
 		}
-
-		// Need to register both of TemplateManager display and fetch hook as both of these
-		// get called when presenting the submission 
-		HookRegistry::register('TemplateManager::display', [$this, 'addEulaToChecklist']);
-		HookRegistry::register('TemplateManager::fetch', [$this, 'addEulaToChecklist']);
-
-		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmission']);
-		HookRegistry::register('Submission::add', [$this, 'stampEulaToSubmittingUser']);
 		
-		HookRegistry::register('submissionsubmitstep4form::display', [$this, 'reConfirmEulaAcceptance']);
+		HookRegistry::register('submissionsubmitstep4form::display', [$this, 'confirmEulaAcceptance']);
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
 
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
@@ -293,59 +285,15 @@ public function handleRouteComponent($hookName, $params) {
 		return true;
 	}
 
-	/**
-	 * Add the IThenticate EULA url as a checklist of submission process
-	 * 
-	 * @param string $hookName `TemplateManager::display` or `TemplateManager::fetch`
-	 * @param array $params
-	 * 
-	 * @return bool
-	 */
-	public function addEulaToChecklist($hookName, $params) {
-		$templateManager = & $params[0]; /** @var TemplateManager $templateManager */
-		$context = $templateManager->getTemplateVars('currentContext'); /** @var Context $context */
-
-		if (!$context || strtolower($templateManager->getTemplateVars('requestedPage') ?? '') !== 'submission') {
-			return false;
-		}
-
-		$eulaDetails = $this->getContextEulaDetails($context);
-
-		// if EULA confirmation is not required, so no need to show EULA as part of submission checklist
-		if ($eulaDetails['require_eula'] === false) {
-			return false;
-		}
-		
-		foreach($context->getData('submissionChecklist') as $locale => $checklist) {
-			array_push($checklist, [
-				'order' => (collect($checklist)->pluck('order')->sort(SORT_REGULAR)->last() ?? 0) + 1,
-				'content' => __('plugins.generic.plagiarism.submission.checklist.eula', [
-					'localizedEulaUrl' => $eulaDetails[$locale]['url']
-				]),
-			]);
-
-			$context->setData('submissionChecklist', $checklist, $locale);
-		}
-		
-		return false;
-	}
-
 	/**
 	 * Stamp the iThenticate EULA with the submission
 	 * 
-	 * @param string $hookName `Submission::add`
-	 * @param array $args
+	 * @param Context $context
+	 * @param Submission $submission
 	 * 
 	 * @return bool
 	 */
-	public function stampEulaToSubmission($hookName, $params) {
-		$submission =& $params[0]; /** @var Submission $submission */
-		$context = Application::get()->getRequest()->getContext();
-
-		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
-			// EULA confirmation is not required, so no stamping of EULA with the submission
-			return false;
-		}
+	public function stampEulaToSubmission($context, $submission) {
 
 		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
 
@@ -355,28 +303,21 @@ public function stampEulaToSubmission($hookName, $params) {
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submissionDao->updateObject($submission);
 
-		return false;
+		return true;
 	}
 
 	/**
-	 * Stamp the iThenticate EULA at the execution of the submission first stage to
-	 * the user who initiated the submission
+	 * Stamp the iThenticate EULA to the submitting user
 	 * 
-	 * @param string $hookName `Submission::add`
-	 * @param array $params
+	 * @param Context 		$context
+	 * @param Submission 	$submission
+	 * @param User|null 	$user
 	 * 
 	 * @return bool
 	 */
-	public function stampEulaToSubmittingUser($hookName, $params) {
-		$submission =& $params[0]; /** @var Submission $submission */
+	public function stampEulaToSubmittingUser($context, $submission, $user = null) {
 		$request = Application::get()->getRequest();
-		$context = $request->getContext();
-		$user = $request->getUser();
-
-		// EULA confirmation is not required, so no stamping of EULA with the submission
-		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
-			return false;
-		}
+		$user ??= $request->getUser();
 
 		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
 
@@ -394,11 +335,7 @@ public function stampEulaToSubmittingUser($hookName, $params) {
 		if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
 			$ithenticate->confirmEula($user, $context)) {
 			$this->stampEulaVersionToUser($user, $submissionEulaVersion);
-		} else {
-			$this->sendErrorMessage(
-				'Unable to stamp the EULA details to submission submitter at the first stage of submission',
-				$submission->getId()
-			);
+			return true;
 		}
 
 		return false;
@@ -413,7 +350,7 @@ public function stampEulaToSubmittingUser($hookName, $params) {
 	 * 
 	 * @return bool
 	 */
-	public function reConfirmEulaAcceptance($hookName, $params) {
+	public function confirmEulaAcceptance($hookName, $params) {
 		
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
@@ -426,11 +363,11 @@ public function reConfirmEulaAcceptance($hookName, $params) {
 			return false;
 		}
 
-		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
-
-		// If submission EULA version has already been stamped to user
-		// no need to do the re-confirmation and stamping again
-		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {
+		// If submission has EULA stamped and user has EULA stamped and both are save version
+		// so there is no need to confirm EULA again
+		if ($submission->getData('ithenticate_eula_version') &&
+			$submission->getData('ithenticate_eula_version') == $user->getData('ithenticateEulaVersion')) {
+			
 			return false;
 		}
 
@@ -442,7 +379,6 @@ public function reConfirmEulaAcceptance($hookName, $params) {
 			'handle',
 			null,
 			[
-				'version' => $submissionEulaVersion,
 				'submissionId' => $submission->getId(),
 			]
 		);
@@ -517,28 +453,13 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			$this->registerIthenticateWebhook($ithenticate, $context);
 		}
 
-		// If EULA confirmation is not required,
-		// no need to check the EULA stamping to submission and submitter
-		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
+		$ithenticate->setApplicableEulaVersion($submission->getData('ithenticate_eula_version'));
 
-			// if EULA details not stamped to submission, not going to sent it for plagiarism check
-			if (!$submission->getData('ithenticate_eula_version') || !$submission->getData('ithenticate_eula_url')) {
-				$this->sendErrorMessage('Unable to obtain the stamped EULA details to submission', $submission->getId());
-				return false;
-			}
-
-			$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
-			$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
-			
-			// Check if submission EULA stamped to submitter and if not
-			// not going to sent it for plagiarism check
-			if (!$user->getData('ithenticateEulaVersion') ||
-				$user->getData('ithenticateEulaVersion') !== $submissionEulaVersion) {
-				
-				$this->sendErrorMessage(
-					"Unable to complete the itenticate submission as submitting user has not comfirmed or accepted the EULA", 
-					$submission->getId()
-				);
+		// Check EULA stamped to submission or submitter only if it is required
+		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
+			// not going to sent it for plagiarism check if EULA not stamped to submission or submitter
+			if (!$submission->getData('ithenticate_eula_version') || !$user->getData('ithenticateEulaVersion')) {
+				$this->sendErrorMessage('Unable to obtain the stamped EULA details to submission or submitter', $submission->getId());
 				return false;
 			}
 		}
@@ -563,7 +484,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submissionDao->updateObject($submission);
 
-		return true;
+		return false;
 	}
 
 	/**
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index ea18aed..1c1b3fb 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -30,28 +30,23 @@ public function handle($args, $request) {
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
         $user = $request->getUser();
-        $submissionEulaVersion = $args['version'];
+        $submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($args['submissionId']);
         $confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
 
         if (!$confirmSubmissionEula) {
             SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
-            return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
+            return $this->redirectToUrl(
+                $request,
+                $context,
+                ['submissionId' => $args['submissionId']]
+            );
         }
 
         SessionManager::getManager()->getUserSession()->unsetSessionVar('confirmSubmissionEulaError');
 
-        /** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
-        
-		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
-
-        if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
-			$ithenticate->confirmEula($user, $context)) {
-                
-            static::$_plugin->stampEulaVersionToUser($user, $submissionEulaVersion);
-		}
+        static::$_plugin->stampEulaToSubmission($context, $submission);
+        static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
 
 		return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
 	}
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 6c528ee..40ed183 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -206,11 +206,11 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
         }
 
 		if (!$submission->getData('ithenticate_eula_version')) {
-            static::$_plugin->stampEulaToSubmission('', [$submission]);
+			static::$_plugin->stampEulaToSubmission($context, $submission);
         }
 
         if (!$user->getData('ithenticateEulaVersion')) {
-            static::$_plugin->stampEulaToSubmittingUser('', [$submission]);
+			static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
         }
 
 		$onAcceptAction = $args['onAcceptAction'];

From 1568fbc8e0ef4123642d4416d55fb1bb1e2b4d04 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 17 May 2024 15:50:53 +0600
Subject: [PATCH 27/75] pkp/plagiarism#52 restriced zip file uploading to
 ithenticate

---
 PlagiarismPlugin.inc.php                 | 124 ++++++++++++-----------
 grids/SimilarityActionGridColumn.inc.php |  26 +++++
 locale/en_US/locale.po                   |   3 +
 3 files changed, 95 insertions(+), 58 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index dc2db90..e10b2b9 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -285,62 +285,6 @@ public function handleRouteComponent($hookName, $params) {
 		return true;
 	}
 
-	/**
-	 * Stamp the iThenticate EULA with the submission
-	 * 
-	 * @param Context $context
-	 * @param Submission $submission
-	 * 
-	 * @return bool
-	 */
-	public function stampEulaToSubmission($context, $submission) {
-
-		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
-
-		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
-		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
-
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
-		$submissionDao->updateObject($submission);
-
-		return true;
-	}
-
-	/**
-	 * Stamp the iThenticate EULA to the submitting user
-	 * 
-	 * @param Context 		$context
-	 * @param Submission 	$submission
-	 * @param User|null 	$user
-	 * 
-	 * @return bool
-	 */
-	public function stampEulaToSubmittingUser($context, $submission, $user = null) {
-		$request = Application::get()->getRequest();
-		$user ??= $request->getUser();
-
-		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
-
-		// If submission EULA version has already been stamped to user
-		// no need to do the confirmation and stamping again
-		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {
-			return false;
-		}
-
-		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
-		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
-		
-		// Check if user has ever already accepted this EULA version and if so, stamp it to user
-		// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
-		if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
-			$ithenticate->confirmEula($user, $context)) {
-			$this->stampEulaVersionToUser($user, $submissionEulaVersion);
-			return true;
-		}
-
-		return false;
-	}
-
 	/**
 	 * Check at the final stage of submission if the submitting user has already confirmed
 	 * or accepted the EULA version associated with submission
@@ -518,6 +462,62 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		return false;
 	}
 
+	/**
+	 * Stamp the iThenticate EULA with the submission
+	 * 
+	 * @param Context $context
+	 * @param Submission $submission
+	 * 
+	 * @return bool
+	 */
+	public function stampEulaToSubmission($context, $submission) {
+
+		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
+
+		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
+		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
+
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submissionDao->updateObject($submission);
+
+		return true;
+	}
+
+	/**
+	 * Stamp the iThenticate EULA to the submitting user
+	 * 
+	 * @param Context 		$context
+	 * @param Submission 	$submission
+	 * @param User|null 	$user
+	 * 
+	 * @return bool
+	 */
+	public function stampEulaToSubmittingUser($context, $submission, $user = null) {
+		$request = Application::get()->getRequest();
+		$user ??= $request->getUser();
+
+		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+
+		// If submission EULA version has already been stamped to user
+		// no need to do the confirmation and stamping again
+		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {
+			return false;
+		}
+
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
+		
+		// Check if user has ever already accepted this EULA version and if so, stamp it to user
+		// Or, try to confirm the EULA for user and upon succeeding, stamp it to user
+		if ($ithenticate->verifyUserEulaAcceptance($user, $submissionEulaVersion) ||
+			$ithenticate->confirmEula($user, $context)) {
+			$this->stampEulaVersionToUser($user, $submissionEulaVersion);
+			return true;
+		}
+
+		return false;
+	}
+
 	/**
 	 * Create a new submission at iThenticate service's end
 	 * 
@@ -549,11 +549,19 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 			return false;
 		}
 
-		$file = Services::get('file')->get($submissionFile->getData('fileId'));
+		$pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
+		$file = $pkpFileService->get($submissionFile->getData('fileId'));
+
+		// Not going to allow uploading a zip file to iThenticate service end
+		if ($pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP) {
+			error_log("plagiarims check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is now allowed");
+			return true;
+		}
+
 		$uploadStatus = $ithenticate->uploadFile(
 			$submissionUuid, 
 			$submissionFile->getData("name", $publication->getData("locale")),
-			Services::get('file')->fs->read($file->path),
+			$pkpFileService->fs->read($file->path),
 		);
 
 		// Upload submission files for successfully created submission at iThenticate's end
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 4778903..2e6637c 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -71,6 +71,11 @@ public function getTemplateVarsFromRow($row) {
 		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
 		assert($submissionFile instanceof SubmissionFile);
 
+        // Not going to allow plagiarims action on a zip file
+		if ($this->isSubmissionFileTypeZip($submissionFile)) {
+			return ['label' => __('plugins.generic.plagiarism.similarity.action.invalidFileType')];
+		}
+
         // submission similarity score is available
         if ($submissionFile->getData('ithenticate_similarity_scheduled') === true &&
             $submissionFile->getData('ithenticate_similarity_result')) {
@@ -115,6 +120,12 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 
 		$submissionFileData = $row->getData();
         $submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+
+		// Not going to allow plagiarims action on a zip file
+		if ($this->isSubmissionFileTypeZip($submissionFile)) {
+			return $cellActions;
+		}
+
         $submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
@@ -291,4 +302,19 @@ protected function isEulaConfirmationRequired($context, $submission, $user) {
         return false;
     }
 
+    /**
+	 * Check if submission file type in valid for plagiarims action
+     * Restricted for ZIP file
+	 *
+     * @param SubmissionFile $submissionFile
+     * @return bool
+	 */
+    protected function isSubmissionFileTypeZip($submissionFile) {
+
+        $pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
+		$file = $pkpFileService->get($submissionFile->getData('fileId'));
+
+		return $pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP;
+    }
+
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 5e7a25c..57fd9b8 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -167,3 +167,6 @@ msgstr "Are you sure you want to submit this file for plagiarism check?"
 
 msgid "plugins.generic.plagiarism.similarity.action.confirmEula.title"
 msgstr "Plagiarism End User License Agreement Confirmation"
+
+msgid "plugins.generic.plagiarism.similarity.action.invalidFileType"
+msgstr "Plagiarims actions Not available"

From 5a4e0018292e95d16c26ba94c638f54da71bf8ae Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 17 May 2024 16:58:41 +0600
Subject: [PATCH 28/75] pkp/plagiarism#52 added setting to enable/disable auto
 upload at submission time

---
 PlagiarismPlugin.inc.php       | 156 +++++++++++++++++++--------------
 PlagiarismSettingsForm.inc.php |   5 ++
 locale/en_US/locale.po         |   6 ++
 templates/settingsForm.tpl     |  14 +++
 4 files changed, 116 insertions(+), 65 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index e10b2b9..5c203d9 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -295,6 +295,12 @@ public function handleRouteComponent($hookName, $params) {
 	 * @return bool
 	 */
 	public function confirmEulaAcceptance($hookName, $params) {
+
+		// if the auto upload to ithenticate disbale
+		// not going to do the EULA confirmation at submission time
+		if ($this->hasAutoSubmissionDisabled()) {
+			return false;
+		}
 		
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
@@ -379,6 +385,13 @@ public function confirmEulaAcceptance($hookName, $params) {
 	 * @return bool
 	 */
 	public function submitForPlagiarismCheck($hookName, $args) {
+
+		// if the auto upload to ithenticate disbale
+		// not going to upload files to iThenticate at submission time
+		if ($this->hasAutoSubmissionDisabled()) {
+			return false;
+		}
+
 		$request = Application::get()->getRequest();
 		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
@@ -608,71 +621,6 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 		}
 	}
 
-	/**
-	 * @copydoc Plugin::getActions()
-	 */
-    public function getActions($request, $verb) {
-		$router = $request->getRouter();
-		import('lib.pkp.classes.linkAction.request.AjaxModal');
-        
-		return array_merge(
-			$this->getEnabled() 
-				? [
-					new LinkAction(
-						'settings',
-						new AjaxModal(
-							$router->url(
-								$request, 
-								null, 
-								null, 
-								'manage', 
-								null, 
-								[
-									'verb' => 'settings',
-									'plugin' => $this->getName(),
-									'category' => 'generic'
-								]
-							),
-							$this->getDisplayName()
-						),
-						__('manager.plugins.settings'),
-						null
-					),
-				] : [],
-			parent::getActions($request, $verb)
-		);
-	}
-
-	/**
-	 * @copydoc Plugin::manage()
-	 */
-	public function manage($args, $request) {
-		switch ($request->getUserVar('verb')) {
-			case 'settings':
-				$context = $request->getContext(); /** @var Context $context */
-
-				AppLocale::requireComponents(LOCALE_COMPONENT_APP_COMMON, LOCALE_COMPONENT_PKP_MANAGER);
-				$templateMgr = TemplateManager::getManager($request); /** @var TemplateManager $templateMgr */
-				$templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
-
-				$this->import('PlagiarismSettingsForm');
-				$form = new PlagiarismSettingsForm($this, $context);
-
-				if ($request->getUserVar('save')) {
-					$form->readInputData();
-					if ($form->validate()) {
-						$form->execute();
-						return new JSONMessage(true);
-					}
-				} else {
-					$form->initData();
-				}
-				return new JSONMessage(true, $form->fetch($request));
-		}
-
-		return parent::manage($args, $request);
-	}
-
 	/**
 	 * Get the cached EULA details form Context
 	 * 
@@ -831,6 +779,71 @@ public function stampEulaVersionToUser($user, $version) {
 		$userDao->updateObject($user);
 	}
 
+	/**
+	 * @copydoc Plugin::getActions()
+	 */
+    public function getActions($request, $verb) {
+		$router = $request->getRouter();
+		import('lib.pkp.classes.linkAction.request.AjaxModal');
+        
+		return array_merge(
+			$this->getEnabled() 
+				? [
+					new LinkAction(
+						'settings',
+						new AjaxModal(
+							$router->url(
+								$request, 
+								null, 
+								null, 
+								'manage', 
+								null, 
+								[
+									'verb' => 'settings',
+									'plugin' => $this->getName(),
+									'category' => 'generic'
+								]
+							),
+							$this->getDisplayName()
+						),
+						__('manager.plugins.settings'),
+						null
+					),
+				] : [],
+			parent::getActions($request, $verb)
+		);
+	}
+
+	/**
+	 * @copydoc Plugin::manage()
+	 */
+	public function manage($args, $request) {
+		switch ($request->getUserVar('verb')) {
+			case 'settings':
+				$context = $request->getContext(); /** @var Context $context */
+
+				AppLocale::requireComponents(LOCALE_COMPONENT_APP_COMMON, LOCALE_COMPONENT_PKP_MANAGER);
+				$templateMgr = TemplateManager::getManager($request); /** @var TemplateManager $templateMgr */
+				$templateMgr->registerPlugin('function', 'plugin_url', [$this, 'smartyPluginUrl']);
+
+				$this->import('PlagiarismSettingsForm');
+				$form = new PlagiarismSettingsForm($this, $context);
+
+				if ($request->getUserVar('save')) {
+					$form->readInputData();
+					if ($form->validate()) {
+						$form->execute();
+						return new JSONMessage(true);
+					}
+				} else {
+					$form->initData();
+				}
+				return new JSONMessage(true, $form->fetch($request));
+		}
+
+		return parent::manage($args, $request);
+	}
+
 	/**
 	 * Get the ithenticate service access as array in format [API_URL, API_KEY]
 	 * 
@@ -901,6 +914,19 @@ public function getSimilarityConfigSettings($context, $settingName = null) {
 			: $similarityConfigSettings;
 	}
 
+	/**
+	 * Check if auto upload of submission file has been disable globally or context level
+	 * 
+	 * @return bool
+	 */
+	public function hasAutoSubmissionDisabled() {
+		$context = Application::get()->getRequest()->getContext(); /** @var Context $context */
+		$contextPath = $context ? $context->getPath() : 'index';
+
+		return $this->getForcedConfigSetting($contextPath, 'disbaleAutoSubmission')
+			?? $this->getSetting($context->getId(), 'disbaleAutoSubmission');
+	}
+
 	/**
 	 * Get the submission submitter's appropriate permission based on role in the submission context
 	 * 
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 87d267d..d49bb6a 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -74,6 +74,7 @@ public function initData() {
 			'ithenticateForced' 	=> $this->_plugin->hasForcedCredentials(),
 			'ithenticateApiUrl' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
 			'ithenticateApiKey' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
+			'disbaleAutoSubmission' => $this->_plugin->getSetting($this->_context->getId(), 'disbaleAutoSubmission'),
 			'addToIndex' 			=> $this->_plugin->getSetting($this->_context->getId(), 'addToIndex'),
 			'excludeQuotes' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeQuotes'),
 			'excludeBibliography' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeBibliography'),
@@ -81,6 +82,7 @@ public function initData() {
 			'excludeAbstract' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeAbstract'),
 			'excludeMethods' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeMethods'),
 			'excludeSmallMatches' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeSmallMatches'),
+			'allowViewerUpdate' 	=> $this->_plugin->getSetting($this->_context->getId(), 'allowViewerUpdate'),
 		];
 	}
 
@@ -91,6 +93,7 @@ public function readInputData() {
 		$this->readUserVars([
 			'ithenticateApiUrl',
 			'ithenticateApiKey',
+			'disbaleAutoSubmission',
 			'addToIndex',
 			'excludeQuotes',
 			'excludeBibliography',
@@ -137,6 +140,8 @@ public function execute(...$functionArgs) {
 			$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
 		}
 
+		$this->_plugin->updateSetting($this->_context->getId(), 'disbaleAutoSubmission', $this->getData('disbaleAutoSubmission'), 'bool');
+
 		$this->_plugin->updateSetting($this->_context->getId(), 'addToIndex', 			$this->getData('addToIndex'), 			'bool');
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeQuotes', 		$this->getData('excludeQuotes'), 		'bool');
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeBibliography', 	$this->getData('excludeBibliography'), 	'bool');
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 57fd9b8..c4a230a 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -35,6 +35,12 @@ msgstr "iThenticate API KEY"
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlRequired"
 msgstr "iThenticate API URL is required"
 
+msgid "plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission"
+msgstr "Disbale auto upload of submission files to iThenticate at submission time"
+
+msgid "plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission.description"
+msgstr "By diabling it, submission need to manually upload from workflow section"
+
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlInvalid"
 msgstr ""
 "The specified URL is not valid. Please double-check the URL and try again. "
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 22e6366..5f65445 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -38,6 +38,20 @@
 			value=$ithenticateApiKey 
 			label="plugins.generic.plagiarism.manager.settings.apiKey"
 		}
+
+		<p>
+		{fbvFormSection description="plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission.description" list=true}
+			{fbvElement
+				type="checkbox"
+				name="disbaleAutoSubmission"
+				id="disbaleAutoSubmission"
+				checked=$disbaleAutoSubmission
+				label="plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission"
+				translate="true"
+			}
+		{/fbvFormSection}
+		</p>
+
 	{/fbvFormArea}
 
 	{fbvFormArea id="ithenticateSimilarityReportSettings"}

From 6e706e1212b38250d7e7ddb33a942b1ed8ae95b1 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Sun, 19 May 2024 17:24:10 +0600
Subject: [PATCH 29/75] pkp/plagiarism#52 moved the test mode setting to config
 file

---
 PlagiarismPlugin.inc.php | 29 +++++++++++------------------
 TestIThenticate.inc.php  |  6 +++---
 2 files changed, 14 insertions(+), 21 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 5c203d9..b8e518b 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -30,12 +30,6 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	public const EULA_CACHE_LIFETIME = 60 * 60 * 24;
 
-	/**
-	 * Set the value to `true` to enable test mode that will log instead of interacting with 
-	 * iThenticate API service.
-	 */
-	protected const ITHENTICATE_TEST_MODE_ENABLE = true;
-
 	/**
 	 * List of valid url components
 	 * 
@@ -59,15 +53,6 @@ class PlagiarismPlugin extends GenericPlugin {
 		'submitted_works_match_percentage',
 	];
 
-	/**
-	 * Running in test mode
-	 * 
-	 * @return bool
-	 */
-	public static function isRunningInTestMode() {
-		return static::ITHENTICATE_TEST_MODE_ENABLE;
-	}
-
 	/**
 	 * @copydoc Plugin::register()
 	 */
@@ -107,6 +92,15 @@ public function register($category, $path, $mainContextId = null) {
 		return $success;
 	}
 
+	/**
+	 * Running in test mode
+	 * 
+	 * @return bool
+	 */
+	public static function isRunningInTestMode() {
+		return Config::getVar('ithenticate', 'test_mode', false);
+	}
+
 	/**
 	 * @copydoc Plugin::getDisplayName()
 	 */
@@ -731,9 +725,8 @@ public function retrieveEulaDetails($cache, $cacheId) {
 	 * Create and return an instance of service class responsible to handle the
 	 * communication with iThenticate service.
 	 * 
-	 * If const `ITHENTICATE_TEST_MODE_ENABLE` set to true, it will return an
-	 * instance of mock class `TestIThenticate` instead of actual commucation
-	 * responsible class.
+	 * If the test mode is enable, it will return an instance of mock class 
+	 * `TestIThenticate` instead of actual commucation responsible class.
 	 * 
 	 * @param string $apiUrl
 	 * @param string $apiKey
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 52b06a4..4e065d2 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -7,9 +7,9 @@
  * Copyright (c) 2003-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
- * @brief   Low-budget mock class for \IThenticate -- set the const `ITHENTICATE_TEST_MODE_ENABLE`
- *          value in the `PlagiarismPlugin` class to `true` to log API usage instead of 
- *          interacting with the iThenticate service.
+ * @brief   Low-budget mock class for \IThenticate -- set the config setting 
+ *          `test_mdoe` to `On` in the `config.inc.php` to log API usage 
+ *          instead of interacting with the iThenticate service.
  */
 
 class TestIThenticate {

From 1a72ea64ba5c44fb0c8dbbb14de14a70791b8f25 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 20 May 2024 13:25:24 +0600
Subject: [PATCH 30/75] pkp/plagiarism#52 code indentation fixing

---
 .../ValidatorIthenticateAccess.inc.php        |  16 +-
 .../PlagiarismEulaAcceptanceHandler.inc.php   |  56 +--
 ...PlagiarismIthenticateActionHandler.inc.php |  38 +-
 grids/SimilarityActionGridColumn.inc.php      | 354 +++++++++---------
 4 files changed, 232 insertions(+), 232 deletions(-)

diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index ff5ff8f..d5849a9 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -19,18 +19,18 @@
 
 class ValidatorIthenticateAccess extends Validator {
     
-    /**
+	/**
 	 * The iThenticate API communicating service class instance
 	 * 
 	 * @var \IThenticate|\TestIThenticate
 	 */
-    protected $ithenticate;
+	protected $ithenticate;
 
-    public function __construct($ithenticate) {
-        $this->ithenticate = $ithenticate;
-    }
+	public function __construct($ithenticate) {
+		$this->ithenticate = $ithenticate;
+	}
 
-    public function isValid($value) {
-        return $this->ithenticate->validateAccess();
-    }
+	public function isValid($value) {
+		return $this->ithenticate->validateAccess();
+	}
 } 
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index 1c1b3fb..858575c 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -29,29 +29,29 @@ class PlagiarismEulaAcceptanceHandler extends PlagiarismComponentHandler {
 	public function handle($args, $request) {
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
-        $user = $request->getUser();
-        $submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$user = $request->getUser();
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($args['submissionId']);
-        $confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
+		$confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
 
-        if (!$confirmSubmissionEula) {
-            SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
-            return $this->redirectToUrl(
-                $request,
-                $context,
-                ['submissionId' => $args['submissionId']]
-            );
-        }
+		if (!$confirmSubmissionEula) {
+			SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
+			return $this->redirectToUrl(
+				$request,
+				$context,
+				['submissionId' => $args['submissionId']]
+			);
+		}
 
-        SessionManager::getManager()->getUserSession()->unsetSessionVar('confirmSubmissionEulaError');
+		SessionManager::getManager()->getUserSession()->unsetSessionVar('confirmSubmissionEulaError');
 
-        static::$_plugin->stampEulaToSubmission($context, $submission);
-        static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
+		static::$_plugin->stampEulaToSubmission($context, $submission);
+		static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
 
 		return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
 	}
 
-    /**
+	/**
 	 * Generate and get the redirection url
 	 *
 	 * @param Request $request
@@ -60,19 +60,19 @@ public function handle($args, $request) {
 	 * 
 	 * @return string
 	 */
-    protected function redirectToUrl($request, $context, $args) {
+	protected function redirectToUrl($request, $context, $args) {
         
-        return $request->redirectUrl(
-            $request->getDispatcher()->url(
-                $request,
-                ROUTE_PAGE,
-                $context->getData('urlPath'),
-                'submission',
-                'wizard',
-                4,
-                $args
-            )
-        );
-    }
+		return $request->redirectUrl(
+			$request->getDispatcher()->url(
+				$request,
+				ROUTE_PAGE,
+				$context->getData('urlPath'),
+				'submission',
+				'wizard',
+				4,
+				$args
+			)
+		);
+	}
     
 }
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 40ed183..9490fd8 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -28,7 +28,7 @@ class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
 	 */
 	public function launchViewer($args, $request) {
 		$context = $request->getContext();
-        $user = $request->getUser();
+		$user = $request->getUser();
 
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
@@ -38,9 +38,9 @@ public function launchViewer($args, $request) {
 		$site = $siteDao->getSite();
 
 		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
+		$ithenticate = static::$_plugin->initIthenticate(
+			...static::$_plugin->getServiceAccess($context)
+		);
 
 		$locale = $ithenticate
 			->setApplicableEulaVersion($submission->getData('ithenticate_eula_version'))
@@ -78,9 +78,9 @@ public function scheduleSimilarityReport($args, $request) {
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
 
 		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
+		$ithenticate = static::$_plugin->initIthenticate(
+			...static::$_plugin->getServiceAccess($context)
+		);
 
 		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
 			$submissionFile->getData('ithenticate_id'),
@@ -112,9 +112,9 @@ public function refreshSimilarityResult($args, $request) {
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
 
 		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
+		$ithenticate = static::$_plugin->initIthenticate(
+			...static::$_plugin->getServiceAccess($context)
+		);
 
 		$similarityScoreResult = $ithenticate->getSimilarityResult(
 			$submissionFile->getData('ithenticate_id')
@@ -155,9 +155,9 @@ public function submitSubmission($args, $request) {
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId')); /** @var Submission $submission*/
 
 		/** @var \IThenticate $ithenticate */
-        $ithenticate = static::$_plugin->initIthenticate(
-            ...static::$_plugin->getServiceAccess($context)
-        );
+		$ithenticate = static::$_plugin->initIthenticate(
+			...static::$_plugin->getServiceAccess($context)
+		);
 
 		if (!static::$_plugin->createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate)) {
 			return new JSONMessage(false);
@@ -185,7 +185,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
-        $confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
+		$confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
 
 		if (!$confirmSubmissionEula) {
 
@@ -197,9 +197,9 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 				$submissionFile
 			);
 
-            SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
+			SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
 
-            return new JSONMessage(
+			return new JSONMessage(
 				true,
 				$templateManager->fetch(static::$_plugin->getTemplateResource('confirmEula.tpl'))
 			);
@@ -207,11 +207,11 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 
 		if (!$submission->getData('ithenticate_eula_version')) {
 			static::$_plugin->stampEulaToSubmission($context, $submission);
-        }
+		}
 
-        if (!$user->getData('ithenticateEulaVersion')) {
+		if (!$user->getData('ithenticateEulaVersion')) {
 			static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
-        }
+		}
 
 		$onAcceptAction = $args['onAcceptAction'];
 
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 2e6637c..0ddc578 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -29,7 +29,7 @@ class SimilarityActionGridColumn extends GridColumn {
 	 */
 	protected $similarityScoreColumns = [];
 
-    /** 
+	/** 
 	 * The Plagiarism Plugin itself
 	 * 
 	 * @var PlagiarismPlugin
@@ -39,25 +39,25 @@ class SimilarityActionGridColumn extends GridColumn {
 	/**
 	 * Constructor
 	 *
-     * @param PlagiarismPlugin  $plugin         The Plagiarism Plugin itself
+	 * @param PlagiarismPlugin  $plugin         The Plagiarism Plugin itself
 	 * @param array             $scoreColumns   List of columns record to retrieve to show ithenticate's 
 	 *                                          similarity scores 
 	 */
     public function __construct($plugin, $scoreColumns) {
 
-        $this->_plugin = $plugin;
-        $this->similarityScoreColumns = $scoreColumns;
+		$this->_plugin = $plugin;
+		$this->similarityScoreColumns = $scoreColumns;
 
-        $cellProvider = new ColumnBasedGridCellProvider();
+		$cellProvider = new ColumnBasedGridCellProvider();
 
 		parent::__construct(
-            'score',
-            'plugins.generic.plagiarism.similarity.action.column.score.title',
-            null,
-            null, 
-            $cellProvider,
+			'score',
+			'plugins.generic.plagiarism.similarity.action.column.score.title',
+			null,
+			null, 
+			$cellProvider,
 			['width' => 50, 'alignment' => COLUMN_ALIGNMENT_LEFT, 'anyhtml' => true]
-        );
+		);
 	}
 
 	/**
@@ -71,7 +71,7 @@ public function getTemplateVarsFromRow($row) {
 		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
 		assert($submissionFile instanceof SubmissionFile);
 
-        // Not going to allow plagiarims action on a zip file
+		// Not going to allow plagiarims action on a zip file
 		if ($this->isSubmissionFileTypeZip($submissionFile)) {
 			return ['label' => __('plugins.generic.plagiarism.similarity.action.invalidFileType')];
 		}
@@ -105,162 +105,162 @@ public function getTemplateVarsFromRow($row) {
 	 */
 	public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_DEFAULT) {
 		$cellActions = parent::getCellActions($request, $row, $position);
-        $request = Application::get()->getRequest();
-        $context = $request->getContext();
-        $user = $request->getUser();
-
-        // User can not perform any of following actions if not a Journal Manager or Editor
-        //      - Upload file for plagiarims check if failed
-        //      - Schedule similarity report generation if not scheduled already
-        //      - Refresh the similarity report scores
-        //      - Launch similarity report viewer
-        if (!$user->hasRole([ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR], $context->getId())) {
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+		$user = $request->getUser();
+
+		// User can not perform any of following actions if not a Journal Manager or Editor
+		//      - Upload file for plagiarims check if failed
+		//      - Schedule similarity report generation if not scheduled already
+		//      - Refresh the similarity report scores
+		//      - Launch similarity report viewer
+		if (!$user->hasRole([ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR], $context->getId())) {
 			return $cellActions;
 		}
 
 		$submissionFileData = $row->getData();
-        $submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
 
 		// Not going to allow plagiarims action on a zip file
 		if ($this->isSubmissionFileTypeZip($submissionFile)) {
 			return $cellActions;
 		}
 
-        $submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
-        // There was an error and submission not completed, 
-        // Ask for confirmation and try to complete the submission process
-        if (!$submissionFile->getData('ithenticate_id')) {
-
-            // first check if curernt user has already EULA confirmed that is associated with submission
-            // If not confirmed, need to confirm EULA first before uploading submission to iThenticate
-
-            if ($this->isEulaConfirmationRequired($context, $submission, $user)) {
-
-                $cellActions[] = new LinkAction(
-                    "plagiarism-eula-confirmation-{$submissionFile->getId()}",
-                    new AjaxModal(
-                        $request->getDispatcher()->url(
-                            $request,
-                            ROUTE_COMPONENT,
-                            $context->getData('urlPath'),
-                            'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-                            'confirmEula',
-                            null,
-                            [
-                                'submissionFileId' => $submissionFile->getId(),
-                                'onAcceptAction' => 'submitSubmission',
-                            ]
-                        ),
-                        __('plugins.generic.plagiarism.similarity.action.confirmEula.title')
-                    ),
-                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
-                );
-                
-                return $cellActions;
+		// There was an error and submission not completed, 
+		// Ask for confirmation and try to complete the submission process
+		if (!$submissionFile->getData('ithenticate_id')) {
+
+			// first check if curernt user has already EULA confirmed that is associated with submission
+			// If not confirmed, need to confirm EULA first before uploading submission to iThenticate
+
+			if ($this->isEulaConfirmationRequired($context, $submission, $user)) {
+
+				$cellActions[] = new LinkAction(
+					"plagiarism-eula-confirmation-{$submissionFile->getId()}",
+					new AjaxModal(
+						$request->getDispatcher()->url(
+							$request,
+							ROUTE_COMPONENT,
+							$context->getData('urlPath'),
+							'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+							'confirmEula',
+							null,
+							[
+								'submissionFileId' => $submissionFile->getId(),
+								'onAcceptAction' => 'submitSubmission',
+							]
+						),
+						__('plugins.generic.plagiarism.similarity.action.confirmEula.title')
+					),
+					__('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
+				);
+
+				return $cellActions;
             }
 
-            $cellActions[] = new LinkAction(
-                "plagiarism-submission-submit-{$submissionFile->getId()}",
-                new RemoteActionConfirmationModal(
-                    $request->getSession(),
-                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation'),
-                    __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title'),
-                    $request->getDispatcher()->url(
-                        $request,
-                        ROUTE_COMPONENT,
-                        $context->getData('urlPath'),
-                        'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-                        'submitSubmission',
-                        null,
-                        [
-                            'submissionFileId' => $submissionFile->getId(),
-                        ]
-                    )
-                ),
-                __('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
-            );
+			$cellActions[] = new LinkAction(
+				"plagiarism-submission-submit-{$submissionFile->getId()}",
+				new RemoteActionConfirmationModal(
+					$request->getSession(),
+					__('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation'),
+					__('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title'),
+					$request->getDispatcher()->url(
+						$request,
+						ROUTE_COMPONENT,
+						$context->getData('urlPath'),
+						'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+						'submitSubmission',
+						null,
+						[
+							'submissionFileId' => $submissionFile->getId(),
+						]
+					)
+				),
+				__('plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title')
+			);
 
-            return $cellActions;
-        }
+			return $cellActions;
+		}
         
-        // Submission similarity report generation has not scheduled
-        if ($submissionFile->getData('ithenticate_similarity_scheduled') === false) {
-		    $cellActions[] = new LinkAction(
-                "plagiarism-similarity-report-schedule-{$submissionFile->getId()}",
-                new RemoteActionConfirmationModal(
-                    $request->getSession(),
-                    __('plugins.generic.plagiarism.similarity.action.generateReport.confirmation'),
-                    __('plugins.generic.plagiarism.similarity.action.generateReport.title'),
-                    $request->getDispatcher()->url(
-                        $request,
-                        ROUTE_COMPONENT,
-                        $context->getData('urlPath'),
-                        'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-                        'scheduleSimilarityReport',
-                        null,
-                        [
-                            'submissionFileId' => $submissionFile->getId(),
-                        ]
-                    )
-                ),
-                __('plugins.generic.plagiarism.similarity.action.generateReport.title')
-            );
+		// Submission similarity report generation has not scheduled
+		if ($submissionFile->getData('ithenticate_similarity_scheduled') === false) {
+			$cellActions[] = new LinkAction(
+				"plagiarism-similarity-report-schedule-{$submissionFile->getId()}",
+				new RemoteActionConfirmationModal(
+					$request->getSession(),
+					__('plugins.generic.plagiarism.similarity.action.generateReport.confirmation'),
+					__('plugins.generic.plagiarism.similarity.action.generateReport.title'),
+					$request->getDispatcher()->url(
+						$request,
+						ROUTE_COMPONENT,
+						$context->getData('urlPath'),
+						'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+						'scheduleSimilarityReport',
+						null,
+						[
+							'submissionFileId' => $submissionFile->getId(),
+						]
+					)
+				),
+				__('plugins.generic.plagiarism.similarity.action.generateReport.title')
+			);
 
-            return $cellActions;
-        }
+			return $cellActions;
+		}
 
-        // Generate the action for similarity score refresh
-        $similarityResultRefreshAction = new LinkAction(
-            "plagiarism-similarity-score-refresh-{$submissionFile->getId()}",
-            new RemoteActionConfirmationModal(
-                $request->getSession(),
-                __('plugins.generic.plagiarism.similarity.action.refreshReport.confirmation'),
-                __('plugins.generic.plagiarism.similarity.action.refreshReport.title'),
-                $request->getDispatcher()->url(
-                    $request,
-                    ROUTE_COMPONENT,
-                    $context->getData('urlPath'),
-                    'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-                    'refreshSimilarityResult',
-                    null,
-                    [
-                        'submissionFileId' => $submissionFile->getId(),
-                    ]
-                )
-            ),
-            __('plugins.generic.plagiarism.similarity.action.refreshReport.title')
-        );
-
-        // If similarity score not availabel
-        // show as cell action and upon it's available, show it as part of row action
-        $submissionFile->getData('ithenticate_similarity_result')
-            ? $row->addAction($similarityResultRefreshAction)
-            : array_push($cellActions, $similarityResultRefreshAction);
-
-        // Similarity viewer only available upon the availability of similarity report is 
-        if ($submissionFile->getData('ithenticate_similarity_result')) {
-            $row->addAction(
-                new LinkAction(
-                    "plagiarism-similarity-launch-viewer-{$submissionFile->getId()}",
-                    new OpenWindowAction(
-                        $request->getDispatcher()->url(
-                            $request,
-                            ROUTE_COMPONENT,
-                            $context->getData('urlPath'),
-                            'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-                            'launchViewer',
-                            null,
-                            [
-                                'submissionFileId' => $submissionFile->getId(),
-                            ]
-                        )
-                    ),
-                    __('plugins.generic.plagiarism.similarity.action.launch.viewer.title')
-                )
-            );
-        }
+		// Generate the action for similarity score refresh
+		$similarityResultRefreshAction = new LinkAction(
+			"plagiarism-similarity-score-refresh-{$submissionFile->getId()}",
+			new RemoteActionConfirmationModal(
+				$request->getSession(),
+				__('plugins.generic.plagiarism.similarity.action.refreshReport.confirmation'),
+				__('plugins.generic.plagiarism.similarity.action.refreshReport.title'),
+				$request->getDispatcher()->url(
+					$request,
+					ROUTE_COMPONENT,
+					$context->getData('urlPath'),
+					'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+					'refreshSimilarityResult',
+					null,
+					[
+						'submissionFileId' => $submissionFile->getId(),
+					]
+				)
+			),
+			__('plugins.generic.plagiarism.similarity.action.refreshReport.title')
+		);
+
+		// If similarity score not availabel
+		// show as cell action and upon it's available, show it as part of row action
+		$submissionFile->getData('ithenticate_similarity_result')
+			? $row->addAction($similarityResultRefreshAction)
+			: array_push($cellActions, $similarityResultRefreshAction);
+
+		// Similarity viewer only available upon the availability of similarity report is 
+		if ($submissionFile->getData('ithenticate_similarity_result')) {
+			$row->addAction(
+				new LinkAction(
+					"plagiarism-similarity-launch-viewer-{$submissionFile->getId()}",
+					new OpenWindowAction(
+						$request->getDispatcher()->url(
+							$request,
+							ROUTE_COMPONENT,
+							$context->getData('urlPath'),
+							'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+							'launchViewer',
+							null,
+							[
+								'submissionFileId' => $submissionFile->getId(),
+							]
+						)
+					),
+					__('plugins.generic.plagiarism.similarity.action.launch.viewer.title')
+				)
+			);
+		}
 
 		return $cellActions;
 	}
@@ -276,45 +276,45 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 	 */
     protected function isEulaConfirmationRequired($context, $submission, $user) {
 
-        // Check if EULA confirmation required for this tenant
-        if ($this->_plugin->getContextEulaDetails($context, 'require_eula') === false) {
-            return false;
-        }
+		// Check if EULA confirmation required for this tenant
+		if ($this->_plugin->getContextEulaDetails($context, 'require_eula') === false) {
+			return false;
+		}
 
-        // If no EULA is stamped with submission
-        // means submission never passed through iThenticate process
-        if (!$submission->getData('ithenticate_eula_version')) {
-            return true;
-        }
+		// If no EULA is stamped with submission
+		// means submission never passed through iThenticate process
+		if (!$submission->getData('ithenticate_eula_version')) {
+			return true;
+		}
 
-        // If no EULA is stamped with submission
-        // means user has never previously interacted with iThenticate process
-        if (!$user->getData('ithenticateEulaVersion')) {
-            return true;
-        }
+		// If no EULA is stamped with submission
+		// means user has never previously interacted with iThenticate process
+		if (!$user->getData('ithenticateEulaVersion')) {
+			return true;
+		}
 
-        // If user and submission EULA do not match
-        // means users previously agreed upon different EULA
-        if ($user->getData('ithenticateEulaVersion') !== $submission->getData('ithenticate_eula_version')) {
-            return true;
-        }
+		// If user and submission EULA do not match
+		// means users previously agreed upon different EULA
+		if ($user->getData('ithenticateEulaVersion') !== $submission->getData('ithenticate_eula_version')) {
+			return true;
+		}
 
-        return false;
+		return false;
     }
 
-    /**
+	/**
 	 * Check if submission file type in valid for plagiarims action
-     * Restricted for ZIP file
+	 * Restricted for ZIP file
 	 *
-     * @param SubmissionFile $submissionFile
-     * @return bool
+	 * @param SubmissionFile $submissionFile
+	 * @return bool
 	 */
-    protected function isSubmissionFileTypeZip($submissionFile) {
+	protected function isSubmissionFileTypeZip($submissionFile) {
 
-        $pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
+		$pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
 		$file = $pkpFileService->get($submissionFile->getData('fileId'));
 
 		return $pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP;
-    }
+	}
 
 }

From 548edd77696aa79a4795818f557ac668f01af870 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 21 May 2024 16:06:27 +0600
Subject: [PATCH 31/75] pkp/plagiarism#52 finalise the similarity score column

---
 PlagiarismPlugin.inc.php | 3 ---
 locale/en_US/locale.po   | 9 ---------
 2 files changed, 12 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index b8e518b..7c8d12b 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -48,9 +48,6 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	protected $similarityScoreColumns = [
 		'overall_match_percentage',
-		'internet_match_percentage',
-		'publication_match_percentage',
-		'submitted_works_match_percentage',
 	];
 
 	/**
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index c4a230a..de92f8c 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -144,15 +144,6 @@ msgstr "Launch Plagiarism Similarity Viewer"
 msgid "plugins.generic.plagiarism.similarity.score.column.overall_match_percentage"
 msgstr "Overall Match Percentage"
 
-msgid "plugins.generic.plagiarism.similarity.score.column.internet_match_percentage"
-msgstr "Internet Match Percentage"
-
-msgid "plugins.generic.plagiarism.similarity.score.column.publication_match_percentage"
-msgstr "publication Match Percentage"
-
-msgid "plugins.generic.plagiarism.similarity.score.column.submitted_works_match_percentage"
-msgstr "submitted Works Match Percentage"
-
 msgid "plugins.generic.plagiarism.similarity.action.generateReport.title"
 msgstr "Schedule Plagiarism Report"
 

From c0b60bdae3abbf36f4d4e1f296ac0108311b3eef Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 22 May 2024 14:45:42 +0600
Subject: [PATCH 32/75] pkp/plagiarism#52 added proper user notification
 presentation

---
 ...PlagiarismIthenticateActionHandler.inc.php | 75 ++++++++++++++++++-
 locale/en_US/locale.po                        | 24 ++++++
 2 files changed, 95 insertions(+), 4 deletions(-)

diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 9490fd8..46f7248 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -16,6 +16,7 @@
 import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import('lib.pkp.classes.core.JSONMessage'); 
 import('lib.pkp.classes.db.DAORegistry');
+import('classes.notification.NotificationManager');
 import("plugins.generic.plagiarism.IThenticate");
 
 class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
@@ -60,6 +61,16 @@ public function launchViewer($args, $request) {
 			(bool)static::$_plugin->getSimilarityConfigSettings($context, 'allowViewerUpdate')
 		);
 
+		if (!$viewerUrl) {
+			return $request->redirect(
+				null,
+				'user',
+				'authorizationDenied',
+				null,
+				['message' => 'plugins.generic.plagiarism.action.launchViewer.error']
+			);
+		}
+
 		return $request->redirectUrl($viewerUrl);
 	}
 
@@ -89,12 +100,23 @@ public function scheduleSimilarityReport($args, $request) {
 
 		if (!$scheduleSimilarityReport) {
 			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
+			$this->generateUserNotification(
+				$request,
+				NOTIFICATION_TYPE_ERROR, 
+				__('plugins.generic.plagiarism.action.scheduleSimilarityReport.error')
+			);
+			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
 		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
 		$submissionFileDao->updateObject($submissionFile);
 
+		$this->generateUserNotification(
+			$request,
+			NOTIFICATION_TYPE_SUCCESS, 
+			__('plugins.generic.plagiarism.action.scheduleSimilarityReport.success')
+		);
+		
 		return DAO::getDataChangedEvent($submissionFile->getId());
     }
 
@@ -122,19 +144,35 @@ public function refreshSimilarityResult($args, $request) {
 
 		if (!$similarityScoreResult) {
 			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
+			$this->generateUserNotification(
+				$request,
+				NOTIFICATION_TYPE_ERROR, 
+				__('plugins.generic.plagiarism.action.refreshSimilarityResult.error')
+			);
+			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
 		$similarityScoreResult = json_decode($similarityScoreResult);
 
 		if ($similarityScoreResult->status !== 'COMPLETE') {
 			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
-			return new JSONMessage(false);
+			$this->generateUserNotification(
+				$request,
+				NOTIFICATION_TYPE_WARNING, 
+				__('plugins.generic.plagiarism.action.refreshSimilarityResult.warning')
+			);
+			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
 		$submissionFile->setData('ithenticate_similarity_result', json_encode($similarityScoreResult));
 		$submissionFileDao->updateObject($submissionFile);
 
+		$this->generateUserNotification(
+			$request,
+			NOTIFICATION_TYPE_SUCCESS, 
+			__('plugins.generic.plagiarism.action.refreshSimilarityResult.success')
+		);
+
 		return DAO::getDataChangedEvent($submissionFile->getId());
     }
 
@@ -160,9 +198,20 @@ public function submitSubmission($args, $request) {
 		);
 
 		if (!static::$_plugin->createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate)) {
-			return new JSONMessage(false);
+			$this->generateUserNotification(
+				$request,
+				NOTIFICATION_TYPE_ERROR, 
+				__('plugins.generic.plagiarism.action.submitSubmission.error')
+			);
+			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
+		$this->generateUserNotification(
+			$request,
+			NOTIFICATION_TYPE_SUCCESS, 
+			__('plugins.generic.plagiarism.action.submitSubmission.success')
+		);
+
 		return DAO::getDataChangedEvent($submissionFile->getId());
 	}
 
@@ -295,4 +344,22 @@ protected function getEulaConfirmationTemplate($request, $args, $context, $submi
 		return $templateManager;
 	}
 
+	/**
+	 * Generate the user friendly notification upon a response received for an action
+	 *
+	 * @param Request 	$request
+	 * @param int 		$notificationType
+	 * @param string 	$notificationContent
+	 * 
+	 * @return void
+	 */
+	protected function generateUserNotification($request, $notificationType, $notificationContent) {
+		$notificationMgr = new NotificationManager();
+		$notificationMgr->createTrivialNotification(
+			$request->getUser()->getId(), 
+			$notificationType, 
+			['contents' => $notificationContent]
+		);
+	}
+
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index de92f8c..e10447a 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -167,3 +167,27 @@ msgstr "Plagiarism End User License Agreement Confirmation"
 
 msgid "plugins.generic.plagiarism.similarity.action.invalidFileType"
 msgstr "Plagiarims actions Not available"
+
+msgid "plugins.generic.plagiarism.action.scheduleSimilarityReport.error"
+msgstr "Unable to schedule the iThenticate similarity report generation process."
+
+msgid "plugins.generic.plagiarism.action.scheduleSimilarityReport.success"
+msgstr "Successfully schedule the iThenticate similarity report generation process."
+
+msgid "plugins.generic.plagiarism.action.launchViewer.error"
+msgstr "Report viewer not currently available, please try again later."
+
+msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.error"
+msgstr "Unable to refresh iThenticate similarity score."
+
+msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.warning"
+msgstr "The iThenticate similarity score has not yet completed."
+
+msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.success"
+msgstr "Successfully refreshed and updated the iThenticate similarity scores."
+
+msgid "plugins.generic.plagiarism.action.submitSubmission.error"
+msgstr "Unable to upload the submission file to iThenticate. Note that submission file size must be more than 0 MB and less or equal to 100 MB."
+
+msgid "plugins.generic.plagiarism.action.submitSubmission.success"
+msgstr "Successfully uploaded the submission file to iThenticate."

From 4eb64c4479621bb50d3bca64da9a6ed21d9dc86b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 24 May 2024 17:15:14 +0600
Subject: [PATCH 33/75] pkp/plagiarism#52 Readme updated and fixed some typos

---
 PlagiarismPlugin.inc.php                      |   8 ++--
 PlagiarismSettingsForm.inc.php                |   6 +--
 README.md                                     |  37 +++++++++++++++---
 .../logo/ithenticate-badge-rec-positive.png   | Bin 0 -> 13834 bytes
 .../ithenticate-settings.png                  | Bin
 images/similarity-check-settings.png          | Bin 0 -> 35473 bytes
 ithenticate-report.png                        | Bin 38726 -> 0 bytes
 locale/en_US/locale.po                        |  10 ++---
 templates/settingsForm.tpl                    |  10 ++---
 9 files changed, 48 insertions(+), 23 deletions(-)
 create mode 100644 assets/logo/ithenticate-badge-rec-positive.png
 rename ithenticate-settings.png => images/ithenticate-settings.png (100%)
 create mode 100644 images/similarity-check-settings.png
 delete mode 100644 ithenticate-report.png

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 7c8d12b..c07e985 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -287,7 +287,7 @@ public function handleRouteComponent($hookName, $params) {
 	 */
 	public function confirmEulaAcceptance($hookName, $params) {
 
-		// if the auto upload to ithenticate disbale
+		// if the auto upload to ithenticate disable
 		// not going to do the EULA confirmation at submission time
 		if ($this->hasAutoSubmissionDisabled()) {
 			return false;
@@ -377,7 +377,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 	 */
 	public function submitForPlagiarismCheck($hookName, $args) {
 
-		// if the auto upload to ithenticate disbale
+		// if the auto upload to ithenticate disable
 		// not going to upload files to iThenticate at submission time
 		if ($this->hasAutoSubmissionDisabled()) {
 			return false;
@@ -913,8 +913,8 @@ public function hasAutoSubmissionDisabled() {
 		$context = Application::get()->getRequest()->getContext(); /** @var Context $context */
 		$contextPath = $context ? $context->getPath() : 'index';
 
-		return $this->getForcedConfigSetting($contextPath, 'disbaleAutoSubmission')
-			?? $this->getSetting($context->getId(), 'disbaleAutoSubmission');
+		return $this->getForcedConfigSetting($contextPath, 'disableAutoSubmission')
+			?? $this->getSetting($context->getId(), 'disableAutoSubmission');
 	}
 
 	/**
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index d49bb6a..dac4206 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -74,7 +74,7 @@ public function initData() {
 			'ithenticateForced' 	=> $this->_plugin->hasForcedCredentials(),
 			'ithenticateApiUrl' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
 			'ithenticateApiKey' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
-			'disbaleAutoSubmission' => $this->_plugin->getSetting($this->_context->getId(), 'disbaleAutoSubmission'),
+			'disableAutoSubmission' => $this->_plugin->getSetting($this->_context->getId(), 'disableAutoSubmission'),
 			'addToIndex' 			=> $this->_plugin->getSetting($this->_context->getId(), 'addToIndex'),
 			'excludeQuotes' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeQuotes'),
 			'excludeBibliography' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeBibliography'),
@@ -93,7 +93,7 @@ public function readInputData() {
 		$this->readUserVars([
 			'ithenticateApiUrl',
 			'ithenticateApiKey',
-			'disbaleAutoSubmission',
+			'disableAutoSubmission',
 			'addToIndex',
 			'excludeQuotes',
 			'excludeBibliography',
@@ -140,7 +140,7 @@ public function execute(...$functionArgs) {
 			$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiKey', $ithenticateApiKey, 'string');
 		}
 
-		$this->_plugin->updateSetting($this->_context->getId(), 'disbaleAutoSubmission', $this->getData('disbaleAutoSubmission'), 'bool');
+		$this->_plugin->updateSetting($this->_context->getId(), 'disableAutoSubmission', $this->getData('disableAutoSubmission'), 'bool');
 
 		$this->_plugin->updateSetting($this->_context->getId(), 'addToIndex', 			$this->getData('addToIndex'), 			'bool');
 		$this->_plugin->updateSetting($this->_context->getId(), 'excludeQuotes', 		$this->getData('excludeQuotes'), 		'bool');
diff --git a/README.md b/README.md
index f6421c4..a57234f 100644
--- a/README.md
+++ b/README.md
@@ -12,15 +12,28 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
 3. Configure the plugin (see below)
    * Enable the plugin via config.inc.php or in a specific journal/press/preprint context
    * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com
-   * ![Example Settings configuration](ithenticate-settings.png)
+   * ![Example Settings configuration](images/ithenticate-settings.png)
 4. The author logs in and makes a submission
+   * At the Step 4 of submission process, submitting user must need to confirm the iThenticate's End User License Agreement to complete the submission.
    * The submission files will be sent to iThenticate in Step 4 of the submission process
-5. The Editor logs in to ithenticate.com to see the submission
-   * The submission will be found in a folder named by the Submission ID, under a Group named by the journal/press/preprint context
-   * Click to see the report
-   * ![Example report review](ithenticate-report.png)
+5. The Editor logs in to OJS/OMP/OPS installation, go to the submission list and open the workflow stage for the submission
+   * In the submission files grid view, Editor/Journal Manager can see the similarity scores if the similarity process has completed.
+   * Editor/Journal Manager can also launch the iThenticate's similarity viewer as an additional action.
+6. In addition to all of above, if the auto upload to iThenticate is disable, Editor/Journal Manager and upload each of submisison file one by one from the workflow stage.
 
-Watch [the demo](https://www.ithenticate.com/demo) to know more about the features of iThenticate.
+## Similarity Check Settings
+
+There are several iTheticate similarity check settings that can be configured via the plugin.
+1. Similarity Check Options
+   * `addToIndex` -- The submission will be added to all valid node groups for future matching
+   * `excludeQuotes` -- Text in quotes of the submission will not count as similar content
+   * `excludeBibliography` -- Text in a bibliography sectionm of the submission will not count as similar content
+   * `excludeAbstract` -- Text in the abstract section of the submission will not count as similar content
+   * `excludeMethods` -- Text in the method section of the submission will not count as similar content
+   * `excludeCitations` -- The citations of the submission will be excuded from similarity check
+   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content
+   * ![Available Similarity Check Options](images/similarity-check-settings.png)
+2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file . To configures, the settings parameter name need to be used which are `addToIndex`, `excludeQuotes`, `excludeBibliography`, `excludeAbstract`, `excludeMethods`, `excludeCitations` and `excludeSmallMatches`, 
 
 ## Configuration
 
@@ -50,4 +63,16 @@ The config.inc.php settings format is:
 
 ; The API key to authorize the api calls
 ; api_key = "YOUR_API_KEY"
+
+; Submission similarity check settings can also configured as global or journel level
+; To set a similarity check config on global level, just set the setting value as
+; addToIndex = On
+; To set a similarity check config on journale level, just set the setting value as
+; addToIndex[MyJournal_path] = On
+; See the README.md of plugin to see all possible similarity config settings
 ```
+
+## Restrictions
+1. Submission submitting user must confirm the iThenticate End User License Agreement to sent files to iThenticate service for plagiarims checking
+2. Upload of zip/tar/gzip is not allowed.
+3. Uploading of file size less that 0 MB and more that 100 MB will cause failure as per iTheticate's restriction
\ No newline at end of file
diff --git a/assets/logo/ithenticate-badge-rec-positive.png b/assets/logo/ithenticate-badge-rec-positive.png
new file mode 100644
index 0000000000000000000000000000000000000000..027f6cc30b36a315b1cf5d409a278ff0d3a5a858
GIT binary patch
literal 13834
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

literal 0
HcmV?d00001

diff --git a/ithenticate-settings.png b/images/ithenticate-settings.png
similarity index 100%
rename from ithenticate-settings.png
rename to images/ithenticate-settings.png
diff --git a/images/similarity-check-settings.png b/images/similarity-check-settings.png
new file mode 100644
index 0000000000000000000000000000000000000000..dece19671c19d71f6f56dc0f5acf31645b213963
GIT binary patch
literal 35473
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
UiX5cVE&u=k07*qoM6N<$f)(PR<NyEw

literal 0
HcmV?d00001

diff --git a/ithenticate-report.png b/ithenticate-report.png
deleted file mode 100644
index 1442919a29a40d32a4ba5827510c860a250aa33c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 38726
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
B()|Dc

diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index e10447a..b557867 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -35,11 +35,11 @@ msgstr "iThenticate API KEY"
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlRequired"
 msgstr "iThenticate API URL is required"
 
-msgid "plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission"
-msgstr "Disbale auto upload of submission files to iThenticate at submission time"
+msgid "plugins.generic.plagiarism.manager.settings.disableAutoSubmission"
+msgstr "Disable auto upload of submission files to iThenticate at submission time"
 
-msgid "plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission.description"
-msgstr "By diabling it, submission need to manually upload from workflow section"
+msgid "plugins.generic.plagiarism.manager.settings.disableAutoSubmission.description"
+msgstr "By disabling auto upload to iThenticate, submission need to manually upload from workflow section"
 
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlInvalid"
 msgstr ""
@@ -157,7 +157,7 @@ msgid "plugins.generic.plagiarism.similarity.action.refreshReport.confirmation"
 msgstr "Are you sure you want to refresh Plagiarism similarity score?"
 
 msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title"
-msgstr "Submit for Plagiarism Check"
+msgstr "Conduct Plagiarism Check"
 
 msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.confirmation"
 msgstr "Are you sure you want to submit this file for plagiarism check?"
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 5f65445..1ca3441 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -40,13 +40,13 @@
 		}
 
 		<p>
-		{fbvFormSection description="plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission.description" list=true}
+		{fbvFormSection description="plugins.generic.plagiarism.manager.settings.disableAutoSubmission.description" list=true}
 			{fbvElement
 				type="checkbox"
-				name="disbaleAutoSubmission"
-				id="disbaleAutoSubmission"
-				checked=$disbaleAutoSubmission
-				label="plugins.generic.plagiarism.manager.settings.disbaleAutoSubmission"
+				name="disableAutoSubmission"
+				id="disableAutoSubmission"
+				checked=$disableAutoSubmission
+				label="plugins.generic.plagiarism.manager.settings.disableAutoSubmission"
 				translate="true"
 			}
 		{/fbvFormSection}

From 0f7de7944f21ae7710e78ff8ee3954e3f5d266db Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 24 May 2024 19:20:25 +0600
Subject: [PATCH 34/75] pkp/plagiarism#52 similarity score presentation updated

---
 PlagiarismPlugin.inc.php                 | 29 ++++++++++----------
 grids/SimilarityActionGridColumn.inc.php | 34 +++++++++---------------
 templates/similarityScore.tpl            | 21 +++++++++++++++
 3 files changed, 47 insertions(+), 37 deletions(-)
 create mode 100644 templates/similarityScore.tpl

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index c07e985..e2c36e7 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -41,15 +41,6 @@ class PlagiarismPlugin extends GenericPlugin {
 		'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
 	];
 
-	/**
-	 * List of columns record to retrieve to show ithenticate's similarity scores
-	 * 
-	 * @var array
-	 */
-	protected $similarityScoreColumns = [
-		'overall_match_percentage',
-	];
-
 	/**
 	 * @copydoc Plugin::register()
 	 */
@@ -456,12 +447,7 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		$submissionDetailsFilesGridHandler = & $params[0];
 
 		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
-		$submissionDetailsFilesGridHandler->addColumn(
-			new SimilarityActionGridColumn(
-				$this,
-				$this->similarityScoreColumns
-			)
-		);
+		$submissionDetailsFilesGridHandler->addColumn(new SimilarityActionGridColumn($this));
 
 		return false;
 	}
@@ -983,6 +969,19 @@ public function sendErrorMessage($message, $submissionId = null) {
 		error_log("iThenticate submission {$submissionId} failed: {$message}");
 	}
 
+	/**
+	 * Get the iThenticate logo URL
+	 * 
+	 * @return string
+	 */
+	public function getIThenticateLogoUrl() {
+		return Application::get()->getRequest()->getBaseUrl()
+			. '/'
+			. $this->getPluginPath()
+			. '/'
+			. 'assets/logo/ithenticate-badge-rec-positive.png';
+	}
+
 	/**
 	 * Get the forced config at global or context level if defined
 	 * 
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 0ddc578..80c2713 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -22,13 +22,6 @@
 
 class SimilarityActionGridColumn extends GridColumn {
 	
-	/**
-	 * List of columns record to retrieve to show ithenticate's similarity scores
-	 *
-	 * @var array
-	 */
-	protected $similarityScoreColumns = [];
-
 	/** 
 	 * The Plagiarism Plugin itself
 	 * 
@@ -39,14 +32,11 @@ class SimilarityActionGridColumn extends GridColumn {
 	/**
 	 * Constructor
 	 *
-	 * @param PlagiarismPlugin  $plugin         The Plagiarism Plugin itself
-	 * @param array             $scoreColumns   List of columns record to retrieve to show ithenticate's 
-	 *                                          similarity scores 
+	 * @param PlagiarismPlugin  $plugin The Plagiarism Plugin itself
 	 */
-    public function __construct($plugin, $scoreColumns) {
+    public function __construct($plugin) {
 
 		$this->_plugin = $plugin;
-		$this->similarityScoreColumns = $scoreColumns;
 
 		$cellProvider = new ColumnBasedGridCellProvider();
 
@@ -82,19 +72,19 @@ public function getTemplateVarsFromRow($row) {
             
             $similarityResult = json_decode(
                 $submissionFile->getData('ithenticate_similarity_result'),
-                true
             );
-            $scores = '';
 
-            foreach ($similarityResult as $column => $value) {
-                if (!in_array($column, $this->similarityScoreColumns)) {
-                    continue;
-                }
+			$templateManager = TemplateManager::getManager();
+			$templateManager->assign([
+				'logoUrl' => $this->_plugin->getIThenticateLogoUrl(),
+				'score' => $similarityResult->overall_match_percentage,
+			]);
 
-                $scores = $scores . '<li>' . __("plugins.generic.plagiarism.similarity.score.column.{$column}") . ' : ' . $value .'</li>';
-            }
-
-            return ['label' => "<ul>{$scores}</ul>"];
+            return [
+				'label' => $templateManager->fetch(
+					$this->_plugin->getTemplateResource('similarityScore.tpl')
+				)
+			];
         }
 
         return ['label' => ''];
diff --git a/templates/similarityScore.tpl b/templates/similarityScore.tpl
new file mode 100644
index 0000000..2d25f07
--- /dev/null
+++ b/templates/similarityScore.tpl
@@ -0,0 +1,21 @@
+<span class="plagiarims-similarity-score">
+    <img src="{$logoUrl}">
+    <span> : {$score}%</span>
+</span>
+
+<style>
+    span.plagiarims-similarity-score {
+        display: flex;
+        align-items: center;
+    }
+
+    span.plagiarims-similarity-score img {
+        max-width: 100px;
+    }
+
+    span.plagiarims-similarity-score span {
+        padding-left: 5px;
+        font-weight: 550;
+        font-size: 15px;
+    }
+</style>
\ No newline at end of file

From 9b1eb4a4a56acf5efa58c7e9a59fd6d16ad5302e Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 12:40:59 +0600
Subject: [PATCH 35/75] pkp/plagiarism#52 camel cased all schema attributes

---
 PlagiarismPlugin.inc.php                      | 42 +++++++++----------
 ...PlagiarismIthenticateActionHandler.inc.php | 26 ++++++------
 controllers/PlagiarismWebhookHandler.inc.php  | 12 +++---
 grids/SimilarityActionGridColumn.inc.php      | 18 ++++----
 4 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index e2c36e7..38ea270 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -136,21 +136,21 @@ public function getEnabled($contextId = null) {
 	public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 		$schema =& $params[0];
 
-		$schema->properties->ithenticate_eula_version = (object) [
+		$schema->properties->ithenticateEulaVersion = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate EULA version which has been agreed at submission checklist',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_eula_url = (object) [
+		$schema->properties->ithenticateEulaUrl = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate EULA url which has been agreen at submission checklist',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_submission_completed_at = (object) [
+		$schema->properties->ithenticateSubmissionCompletedAt = (object) [
 			'type' => 'string',
 			'description' => 'The timestamp at which this submission successfully completed uploading all files at iThenticate service end',
 			'apiSummary' => true,
@@ -175,21 +175,21 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 	public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params) {
 		$schema =& $params[0];
 
-		$schema->properties->ithenticate_id = (object) [
+		$schema->properties->ithenticateId = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate submission id for submission file',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_similarity_scheduled = (object) [
+		$schema->properties->ithenticateSimilarityScheduled = (object) [
 			'type' => 'boolean',
 			'description' => 'The status which identify if the iThenticate similarity process has been scheduled for this submission file',
 			'apiSummary' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_similarity_result = (object) [
+		$schema->properties->ithenticateSimilarityResult = (object) [
 			'type' => 'string',
 			'description' => 'The similarity check result for this submission file in json format',
 			'apiSummary' => true,
@@ -211,14 +211,14 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 	public function addIthenticateConfigSettingsToContextSchema($hookName, $params) {
 		$schema =& $params[0];
 
-		$schema->properties->ithenticate_webhook_signing_secret = (object) [
+		$schema->properties->ithenticateWebhookSigningSecret = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate service webook registration signing secret',
 			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
-		$schema->properties->ithenticate_webhook_id = (object) [
+		$schema->properties->ithenticateWebhookId = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate service webook id that return back after successful webhook registration',
 			'writeOnly' => true,
@@ -297,8 +297,8 @@ public function confirmEulaAcceptance($hookName, $params) {
 
 		// If submission has EULA stamped and user has EULA stamped and both are save version
 		// so there is no need to confirm EULA again
-		if ($submission->getData('ithenticate_eula_version') &&
-			$submission->getData('ithenticate_eula_version') == $user->getData('ithenticateEulaVersion')) {
+		if ($submission->getData('ithenticateEulaVersion') &&
+			$submission->getData('ithenticateEulaVersion') == $user->getData('ithenticateEulaVersion')) {
 			
 			return false;
 		}
@@ -388,16 +388,16 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
 
 		// If no webhook previously registered for this Context, register it
-		if (!$context->getData('ithenticate_webhook_id')) {
+		if (!$context->getData('ithenticateWebhookId')) {
 			$this->registerIthenticateWebhook($ithenticate, $context);
 		}
 
-		$ithenticate->setApplicableEulaVersion($submission->getData('ithenticate_eula_version'));
+		$ithenticate->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'));
 
 		// Check EULA stamped to submission or submitter only if it is required
 		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
 			// not going to sent it for plagiarism check if EULA not stamped to submission or submitter
-			if (!$submission->getData('ithenticate_eula_version') || !$user->getData('ithenticateEulaVersion')) {
+			if (!$submission->getData('ithenticateEulaVersion') || !$user->getData('ithenticateEulaVersion')) {
 				$this->sendErrorMessage('Unable to obtain the stamped EULA details to submission or submitter', $submission->getId());
 				return false;
 			}
@@ -419,7 +419,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			return false;
 		}
 
-		$submission->setData('ithenticate_submission_completed_at', Core::getCurrentDate());
+		$submission->setData('ithenticateSubmissionCompletedAt', Core::getCurrentDate());
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submissionDao->updateObject($submission);
 
@@ -464,8 +464,8 @@ public function stampEulaToSubmission($context, $submission) {
 
 		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
 
-		$submission->setData('ithenticate_eula_version', $eulaDetails['version']);
-		$submission->setData('ithenticate_eula_url', $eulaDetails['url']);
+		$submission->setData('ithenticateEulaVersion', $eulaDetails['version']);
+		$submission->setData('ithenticateEulaUrl', $eulaDetails['url']);
 
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submissionDao->updateObject($submission);
@@ -486,7 +486,7 @@ public function stampEulaToSubmittingUser($context, $submission, $user = null) {
 		$request = Application::get()->getRequest();
 		$user ??= $request->getUser();
 
-		$submissionEulaVersion = $submission->getData('ithenticate_eula_version');
+		$submissionEulaVersion = $submission->getData('ithenticateEulaVersion');
 
 		// If submission EULA version has already been stamped to user
 		// no need to do the confirmation and stamping again
@@ -560,8 +560,8 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 			return false;
 		}
 
-		$submissionFile->setData('ithenticate_id', $submissionUuid);
-		$submissionFile->setData('ithenticate_similarity_scheduled', 0);
+		$submissionFile->setData('ithenticateId', $submissionUuid);
+		$submissionFile->setData('ithenticateSimilarityScheduled', 0);
 		$submissionFileDao->updateObject($submissionFile);
 
 		return true;
@@ -590,8 +590,8 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 		);
 
 		if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
-			$context->setData('ithenticate_webhook_signing_secret', $signingSecret);
-			$context->setData('ithenticate_webhook_id', $webhookId);
+			$context->setData('ithenticateWebhookSigningSecret', $signingSecret);
+			$context->setData('ithenticateWebhookId', $webhookId);
 			Application::get()->getContextDAO()->updateObject($context);
 		} else {
 			error_log("unable to complete the iThenticate webhook registration for context id {$context->getId()}");
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 46f7248..1ce1e01 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -44,7 +44,7 @@ public function launchViewer($args, $request) {
 		);
 
 		$locale = $ithenticate
-			->setApplicableEulaVersion($submission->getData('ithenticate_eula_version'))
+			->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'))
 			->getApplicableLocale(
 				collect([$submission->getData("locale")])
 					->merge($user->getData("locales"))
@@ -54,7 +54,7 @@ public function launchViewer($args, $request) {
 			);
 
 		$viewerUrl = $ithenticate->createViewerLaunchUrl(
-			$submissionFile->getData('ithenticate_id'),
+			$submissionFile->getData('ithenticateId'),
 			$user,
 			$locale,
 			static::$_plugin->getSubmitterPermission($context, $user),
@@ -94,12 +94,12 @@ public function scheduleSimilarityReport($args, $request) {
 		);
 
 		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
-			$submissionFile->getData('ithenticate_id'),
+			$submissionFile->getData('ithenticateId'),
 			static::$_plugin->getSimilarityConfigSettings($context)
 		);
 
 		if (!$scheduleSimilarityReport) {
-			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
 			$this->generateUserNotification(
 				$request,
 				NOTIFICATION_TYPE_ERROR, 
@@ -108,7 +108,7 @@ public function scheduleSimilarityReport($args, $request) {
 			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
-		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
+		$submissionFile->setData('ithenticateSimilarityScheduled', 1);
 		$submissionFileDao->updateObject($submissionFile);
 
 		$this->generateUserNotification(
@@ -139,11 +139,11 @@ public function refreshSimilarityResult($args, $request) {
 		);
 
 		$similarityScoreResult = $ithenticate->getSimilarityResult(
-			$submissionFile->getData('ithenticate_id')
+			$submissionFile->getData('ithenticateId')
 		);
 
 		if (!$similarityScoreResult) {
-			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
 			$this->generateUserNotification(
 				$request,
 				NOTIFICATION_TYPE_ERROR, 
@@ -155,7 +155,7 @@ public function refreshSimilarityResult($args, $request) {
 		$similarityScoreResult = json_decode($similarityScoreResult);
 
 		if ($similarityScoreResult->status !== 'COMPLETE') {
-			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticate_id'), $submissionFile->getData('submissionId'));
+			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
 			$this->generateUserNotification(
 				$request,
 				NOTIFICATION_TYPE_WARNING, 
@@ -164,7 +164,7 @@ public function refreshSimilarityResult($args, $request) {
 			return DAO::getDataChangedEvent($submissionFile->getId());
 		}
 
-		$submissionFile->setData('ithenticate_similarity_result', json_encode($similarityScoreResult));
+		$submissionFile->setData('ithenticateSimilarityResult', json_encode($similarityScoreResult));
 		$submissionFileDao->updateObject($submissionFile);
 
 		$this->generateUserNotification(
@@ -254,7 +254,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 			);
         }
 
-		if (!$submission->getData('ithenticate_eula_version')) {
+		if (!$submission->getData('ithenticateEulaVersion')) {
 			static::$_plugin->stampEulaToSubmission($context, $submission);
 		}
 
@@ -309,10 +309,10 @@ public function confirmEula($args, $request) {
 	 */
 	protected function getEulaConfirmationTemplate($request, $args, $context, $submission, $submissionFile) {
 
-		$eulaVersionDetails = $submission->getData('ithenticate_eula_version')
+		$eulaVersionDetails = $submission->getData('ithenticateEulaVersion')
 			? [
-				'version' 	=> $submission->getData('ithenticate_eula_version'),
-				'url' 		=> $submission->getData('ithenticate_eula_url')
+				'version' 	=> $submission->getData('ithenticateEulaVersion'),
+				'url' 		=> $submission->getData('ithenticateEulaUrl')
 			] : static::$_plugin->getContextEulaDetails($context, [
 				$submission->getData('locale'),
 				$request->getSite()->getPrimaryLocale(),
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 13b33d5..1118801 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -40,7 +40,7 @@ public function handle() {
 		$headers = collect(array_change_key_case(getallheaders(), CASE_LOWER));
 		$payload = file_get_contents('php://input');
 
-		if (!$context->getData('ithenticate_webhook_id') || !$context->getData('ithenticate_webhook_signing_secret')) {
+		if (!$context->getData('ithenticateWebhookId') || !$context->getData('ithenticateWebhookSigningSecret')) {
 			static::$_plugin->sendErrorMessage("iThenticate webhook not configured for context id {$context->getId()}");
 			return;
 		}
@@ -55,7 +55,7 @@ public function handle() {
 			return;
 		}
 
-		if ($headers->get('x-turnitin-signature') !== hash_hmac("sha256", $payload, $context->getData('ithenticate_webhook_signing_secret'))) {
+		if ($headers->get('x-turnitin-signature') !== hash_hmac("sha256", $payload, $context->getData('ithenticateWebhookSigningSecret'))) {
 			static::$_plugin->sendErrorMessage('Invalid iThenticate webhook signature');
 			return;
 		}
@@ -106,7 +106,7 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 			return;
 		}
 		
-		if ((int)$submissionFile->getData('ithenticate_similarity_scheduled')) {
+		if ((int)$submissionFile->getData('ithenticateSimilarityScheduled')) {
 			static::$_plugin->sendErrorMessage("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
 			return;
 		}
@@ -124,7 +124,7 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 			return;
 		}
 
-		$submissionFile->setData('ithenticate_similarity_scheduled', 1);
+		$submissionFile->setData('ithenticateSimilarityScheduled', 1);
 		$submissionFileDao->updateObject($submissionFile);
 	}
 
@@ -156,7 +156,7 @@ protected function storeSimilarityScore($context, $payload, $event) {
 		/** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
-		$submissionFile->setData('ithenticate_similarity_result', json_encode($payload));
+		$submissionFile->setData('ithenticateSimilarityResult', json_encode($payload));
 		$submissionFileDao->updateObject($submissionFile);
 	}
 
@@ -172,7 +172,7 @@ private function getIthenticateSubmission($id) {
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 
 		return Capsule::table($submissionFileDao->settingsTableName)
-			->where('setting_name', 'ithenticate_id')
+			->where('setting_name', 'ithenticateId')
 			->where('setting_value', $id)
 			->first();
 	}
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 80c2713..2df55df 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -67,11 +67,11 @@ public function getTemplateVarsFromRow($row) {
 		}
 
         // submission similarity score is available
-        if ($submissionFile->getData('ithenticate_similarity_scheduled') === true &&
-            $submissionFile->getData('ithenticate_similarity_result')) {
+        if ($submissionFile->getData('ithenticateSimilarityScheduled') === true &&
+            $submissionFile->getData('ithenticateSimilarityResult')) {
             
             $similarityResult = json_decode(
-                $submissionFile->getData('ithenticate_similarity_result'),
+                $submissionFile->getData('ithenticateSimilarityResult'),
             );
 
 			$templateManager = TemplateManager::getManager();
@@ -121,7 +121,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 
 		// There was an error and submission not completed, 
 		// Ask for confirmation and try to complete the submission process
-		if (!$submissionFile->getData('ithenticate_id')) {
+		if (!$submissionFile->getData('ithenticateId')) {
 
 			// first check if curernt user has already EULA confirmed that is associated with submission
 			// If not confirmed, need to confirm EULA first before uploading submission to iThenticate
@@ -176,7 +176,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		}
         
 		// Submission similarity report generation has not scheduled
-		if ($submissionFile->getData('ithenticate_similarity_scheduled') === false) {
+		if ($submissionFile->getData('ithenticateSimilarityScheduled') === false) {
 			$cellActions[] = new LinkAction(
 				"plagiarism-similarity-report-schedule-{$submissionFile->getId()}",
 				new RemoteActionConfirmationModal(
@@ -225,12 +225,12 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 
 		// If similarity score not availabel
 		// show as cell action and upon it's available, show it as part of row action
-		$submissionFile->getData('ithenticate_similarity_result')
+		$submissionFile->getData('ithenticateSimilarityResult')
 			? $row->addAction($similarityResultRefreshAction)
 			: array_push($cellActions, $similarityResultRefreshAction);
 
 		// Similarity viewer only available upon the availability of similarity report is 
-		if ($submissionFile->getData('ithenticate_similarity_result')) {
+		if ($submissionFile->getData('ithenticateSimilarityResult')) {
 			$row->addAction(
 				new LinkAction(
 					"plagiarism-similarity-launch-viewer-{$submissionFile->getId()}",
@@ -273,7 +273,7 @@ protected function isEulaConfirmationRequired($context, $submission, $user) {
 
 		// If no EULA is stamped with submission
 		// means submission never passed through iThenticate process
-		if (!$submission->getData('ithenticate_eula_version')) {
+		if (!$submission->getData('ithenticateEulaVersion')) {
 			return true;
 		}
 
@@ -285,7 +285,7 @@ protected function isEulaConfirmationRequired($context, $submission, $user) {
 
 		// If user and submission EULA do not match
 		// means users previously agreed upon different EULA
-		if ($user->getData('ithenticateEulaVersion') !== $submission->getData('ithenticate_eula_version')) {
+		if ($user->getData('ithenticateEulaVersion') !== $submission->getData('ithenticateEulaVersion')) {
 			return true;
 		}
 

From 963df1eb9668ccaeaaa0b1fcb7723df22df92fc1 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 13:17:20 +0600
Subject: [PATCH 36/75] pkp/plagiarism#52 moved the similarity score/action
 column as the second column

---
 PlagiarismPlugin.inc.php                 |  4 ++
 grids/RearrangeColumnsFeature.inc.php    | 59 ++++++++++++++++++++++++
 grids/SimilarityActionGridColumn.inc.php |  6 ++-
 3 files changed, 67 insertions(+), 2 deletions(-)
 create mode 100644 grids/RearrangeColumnsFeature.inc.php

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 38ea270..f144bcd 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -449,6 +449,10 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
 		$submissionDetailsFilesGridHandler->addColumn(new SimilarityActionGridColumn($this));
 
+		import('plugins.generic.plagiarism.grids.RearrangeColumnsFeature');
+		$features =& $params[3]; /** @var array $features */
+		$features[] = new RearrangeColumnsFeature($submissionDetailsFilesGridHandler);
+
 		return false;
 	}
 
diff --git a/grids/RearrangeColumnsFeature.inc.php b/grids/RearrangeColumnsFeature.inc.php
new file mode 100644
index 0000000..5689040
--- /dev/null
+++ b/grids/RearrangeColumnsFeature.inc.php
@@ -0,0 +1,59 @@
+<?php
+
+/**
+ * @file classes/controllers/grid/feature/RearrangeColumnsFeature.inc.php
+ *
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class RearrangeColumnsFeature
+ * @ingroup controllers_grid_feature
+ *
+ * @brief Rearrange grid columns for the Plagisarism plugin.
+ *
+ */
+
+import('lib.pkp.classes.controllers.grid.GridHandler'); 
+import('lib.pkp.classes.controllers.grid.feature.GridFeature');
+import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
+
+class RearrangeColumnsFeature extends GridFeature {
+	/**
+	 * The GridHandler instance
+     * 
+     * @var GridHandler
+	 */
+    public $gridHandler;
+
+	/**
+	 * @see GridFeature::GridFeature()
+	 */
+	public function __construct($gridHandler) {
+		$this->gridHandler = $gridHandler;
+		parent::__construct('rearrangeColumns');
+	}
+
+	/**
+	 * @see GridFeature::getGridDataElements()
+	 */
+	public function getGridDataElements($args) {
+        if (!reset($this->gridHandler->_columns) instanceof SimilarityActionGridColumn) {
+            return;
+        }
+
+		// The plagiarism report is the first column. Move it to the end.
+		$plagiarismColumn = array_shift($this->gridHandler->_columns); /** @var SimilarityActionGridColumn $plagiarismColumn */
+		$plagiarismColumn->addFlag('firstColumn', false);
+
+        // push the plagiarism score/action column as the second column
+        $afterKey = array_key_first($this->gridHandler->_columns);
+        $index = array_search($afterKey, array_keys( $this->gridHandler->_columns ));
+        $this->gridHandler->_columns = array_slice($this->gridHandler->_columns, 0, $index + 1)
+            + [SimilarityActionGridColumn::SIMILARITY_ACTION_GRID_COLUMN_ID => $plagiarismColumn]
+            + $this->gridHandler->_columns;
+
+	    // set the first file name column as first column
+        reset($this->gridHandler->_columns)->addFlag('firstColumn', true);
+	}
+}
\ No newline at end of file
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 2df55df..99aa1d8 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -21,6 +21,8 @@
 import('lib.pkp.classes.linkAction.request.AjaxModal');
 
 class SimilarityActionGridColumn extends GridColumn {
+
+	public const SIMILARITY_ACTION_GRID_COLUMN_ID = 'score';
 	
 	/** 
 	 * The Plagiarism Plugin itself
@@ -41,12 +43,12 @@ public function __construct($plugin) {
 		$cellProvider = new ColumnBasedGridCellProvider();
 
 		parent::__construct(
-			'score',
+			self::SIMILARITY_ACTION_GRID_COLUMN_ID,
 			'plugins.generic.plagiarism.similarity.action.column.score.title',
 			null,
 			null, 
 			$cellProvider,
-			['width' => 50, 'alignment' => COLUMN_ALIGNMENT_LEFT, 'anyhtml' => true]
+			['width' => 30, 'alignment' => COLUMN_ALIGNMENT_LEFT, 'anyhtml' => true]
 		);
 	}
 

From 97e1a5d4353d5f130171c79efd9ca64d5ff2d6a1 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 13:22:44 +0600
Subject: [PATCH 37/75] pkp/plagiarism#52 update import usage

---
 PlagiarismPlugin.inc.php              | 10 ++++----
 grids/RearrangeColumnsFeature.inc.php | 36 +++++++++++++--------------
 2 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index f144bcd..dcda012 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -405,7 +405,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 
 		/** @var DAOResultIterator $submissionFiles */
 		$submissionFiles = Services::get('submissionFile')->getMany([
-            'submissionIds' => [$submission->getId()],
+			'submissionIds' => [$submission->getId()],
 		]);
 
 		try {
@@ -446,10 +446,10 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 		/** @var EditorSubmissionDetailsFilesGridHandler|EditorReviewFilesGridHandler $submissionDetailsFilesGridHandler */
 		$submissionDetailsFilesGridHandler = & $params[0];
 
-		import('plugins.generic.plagiarism.grids.SimilarityActionGridColumn');
+		$this->import('grids.SimilarityActionGridColumn');
 		$submissionDetailsFilesGridHandler->addColumn(new SimilarityActionGridColumn($this));
 
-		import('plugins.generic.plagiarism.grids.RearrangeColumnsFeature');
+		$this->import('grids.RearrangeColumnsFeature');
 		$features =& $params[3]; /** @var array $features */
 		$features[] = new RearrangeColumnsFeature($submissionDetailsFilesGridHandler);
 
@@ -723,7 +723,7 @@ public function retrieveEulaDetails($cache, $cacheId) {
 	public function initIthenticate($apiUrl, $apiKey) {
 
 		if (static::isRunningInTestMode()) {
-			import("plugins.generic.plagiarism.TestIThenticate");
+			$this->import('TestIThenticate');
 			return new \TestIThenticate(
 				$apiUrl,
 				$apiKey,
@@ -732,7 +732,7 @@ public function initIthenticate($apiUrl, $apiKey) {
 			);
 		}
 
-		import("plugins.generic.plagiarism.IThenticate");
+		$this->import('IThenticate');
 
 		return new \IThenticate(
 			$apiUrl,
diff --git a/grids/RearrangeColumnsFeature.inc.php b/grids/RearrangeColumnsFeature.inc.php
index 5689040..a358a04 100644
--- a/grids/RearrangeColumnsFeature.inc.php
+++ b/grids/RearrangeColumnsFeature.inc.php
@@ -1,14 +1,14 @@
 <?php
 
 /**
- * @file classes/controllers/grid/feature/RearrangeColumnsFeature.inc.php
+ * @file plugins/generic/plagiarism/grids/SimilarityActionGridColumn.inc.php
  *
- * Copyright (c) 2024 Simon Fraser University
- * Copyright (c) 2024 John Willinsky
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class RearrangeColumnsFeature
- * @ingroup controllers_grid_feature
+ * @ingroup plugins_generic_plagiarism
  *
  * @brief Rearrange grid columns for the Plagisarism plugin.
  *
@@ -21,10 +21,10 @@
 class RearrangeColumnsFeature extends GridFeature {
 	/**
 	 * The GridHandler instance
-     * 
-     * @var GridHandler
+	 * 
+	 * @var GridHandler
 	 */
-    public $gridHandler;
+	public $gridHandler;
 
 	/**
 	 * @see GridFeature::GridFeature()
@@ -38,22 +38,22 @@ public function __construct($gridHandler) {
 	 * @see GridFeature::getGridDataElements()
 	 */
 	public function getGridDataElements($args) {
-        if (!reset($this->gridHandler->_columns) instanceof SimilarityActionGridColumn) {
-            return;
-        }
+		if (!reset($this->gridHandler->_columns) instanceof SimilarityActionGridColumn) {
+			return;
+		}
 
 		// The plagiarism report is the first column. Move it to the end.
 		$plagiarismColumn = array_shift($this->gridHandler->_columns); /** @var SimilarityActionGridColumn $plagiarismColumn */
 		$plagiarismColumn->addFlag('firstColumn', false);
 
-        // push the plagiarism score/action column as the second column
-        $afterKey = array_key_first($this->gridHandler->_columns);
-        $index = array_search($afterKey, array_keys( $this->gridHandler->_columns ));
-        $this->gridHandler->_columns = array_slice($this->gridHandler->_columns, 0, $index + 1)
-            + [SimilarityActionGridColumn::SIMILARITY_ACTION_GRID_COLUMN_ID => $plagiarismColumn]
-            + $this->gridHandler->_columns;
+		// push the plagiarism score/action column as the second column
+		$afterKey = array_key_first($this->gridHandler->_columns);
+		$index = array_search($afterKey, array_keys( $this->gridHandler->_columns ));
+		$this->gridHandler->_columns = array_slice($this->gridHandler->_columns, 0, $index + 1)
+			+ [SimilarityActionGridColumn::SIMILARITY_ACTION_GRID_COLUMN_ID => $plagiarismColumn]
+			+ $this->gridHandler->_columns;
 
-	    // set the first file name column as first column
-        reset($this->gridHandler->_columns)->addFlag('firstColumn', true);
+		// set the first file name column as first column
+		reset($this->gridHandler->_columns)->addFlag('firstColumn', true);
 	}
 }
\ No newline at end of file

From 43b72495b8767783584d8cb3136a7f34f75772c5 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 13:27:17 +0600
Subject: [PATCH 38/75] pkp/plagiarism#52 fixed class header doc block

---
 grids/RearrangeColumnsFeature.inc.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/grids/RearrangeColumnsFeature.inc.php b/grids/RearrangeColumnsFeature.inc.php
index a358a04..4f41667 100644
--- a/grids/RearrangeColumnsFeature.inc.php
+++ b/grids/RearrangeColumnsFeature.inc.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/grids/SimilarityActionGridColumn.inc.php
+ * @file plugins/generic/plagiarism/grids/RearrangeColumnsFeature.inc.php
  *
  * Copyright (c) 2014-2024 Simon Fraser University
  * Copyright (c) 2000-2024 John Willinsky

From d8fdc8e9187c9516b313a0a0fa60ef38e7fa3000 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 15:07:08 +0600
Subject: [PATCH 39/75] pkp/plagiarism#52 made compatible with OMP 3.3.0

---
 PlagiarismPlugin.inc.php | 72 ++++++++++++++++++++++++----------------
 1 file changed, 44 insertions(+), 28 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index dcda012..ee7dd07 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -52,16 +52,6 @@ public function register($category, $path, $mainContextId = null) {
 		if (!($success || $this->getEnabled())) {
 			return false;	
 		}
-
-		$context = $mainContextId
-			? Services::get("context")->get($mainContextId)
-			: Application::get()->getRequest()->getContext();
-
-		// plugin can not function if the iThenticate service access not available at running context, 
-		if (!$this->isServiceAccessAvailable($context)) {
-			error_log("ithenticate service access not set for context id {$context->getId()}");
-			return false;
-		}
 		
 		HookRegistry::register('submissionsubmitstep4form::display', [$this, 'confirmEulaAcceptance']);
 		HookRegistry::register('submissionsubmitstep4form::execute', [$this, 'submitForPlagiarismCheck']);
@@ -277,6 +267,14 @@ public function handleRouteComponent($hookName, $params) {
 	 * @return bool
 	 */
 	public function confirmEulaAcceptance($hookName, $params) {
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+
+		// plugin can not function if the iThenticate service access not available at global/context level 
+		if (!$this->isServiceAccessAvailable($context)) {
+			error_log("ithenticate service access not set for context id : " . ($context ? $context->getId() : 'undefined'));
+			return false;
+		}
 
 		// if the auto upload to ithenticate disable
 		// not going to do the EULA confirmation at submission time
@@ -284,8 +282,6 @@ public function confirmEulaAcceptance($hookName, $params) {
 			return false;
 		}
 		
-		$request = Application::get()->getRequest();
-		$context = $request->getContext();
 		$user = $request->getUser();
 		$form = & $params[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
@@ -368,16 +364,23 @@ public function confirmEulaAcceptance($hookName, $params) {
 	 */
 	public function submitForPlagiarismCheck($hookName, $args) {
 
+		$request = Application::get()->getRequest();
+		$context = $request->getContext();
+
+		// plugin can not function if the iThenticate service access not available at global/context level
+		if (!$this->isServiceAccessAvailable($context)) {
+			error_log("ithenticate service access not set for context id : " . ($context ? $context->getId() : 'undefined'));
+			return false;
+		}
+
 		// if the auto upload to ithenticate disable
 		// not going to upload files to iThenticate at submission time
 		if ($this->hasAutoSubmissionDisabled()) {
 			return false;
 		}
-
-		$request = Application::get()->getRequest();
+		
 		$form =& $args[0]; /** @var SubmissionSubmitStep4Form $form */
 		$submission = $form->submission; /** @var Submission $submission */
-		$context = $request->getContext();
 		$user = $request->getUser();
 
 		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
@@ -436,9 +439,15 @@ public function submitForPlagiarismCheck($hookName, $args) {
 	 */
 	public function addActionsToSubmissionFileGrid($hookName, $params) {
 		$request = Application::get()->getRequest();
-		$user = $request->getUser();
 		$context = $request->getContext();
 
+		// plugin can not function if the iThenticate service access not available at global/context level
+		if (!$this->isServiceAccessAvailable($context)) {
+			error_log("ithenticate service access not set for context id : " . ($context ? $context->getId() : 'undefined'));
+			return false;
+		}
+
+		$user = $request->getUser();
 		if (!$user->hasRole([ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR, ROLE_ID_REVIEWER], $context->getId())) {
 			return false;
 		}
@@ -826,20 +835,26 @@ public function manage($args, $request) {
 
 	/**
 	 * Get the ithenticate service access as array in format [API_URL, API_KEY]
+	 * Will try to get credentials for current context otherwise use default config
 	 * 
-	 * @param Context $context
-	 * @return array
+	 * @param Context|null $context
+	 * @return array	The service access creds in format as [API_URL, API_KEY]
 	 */
-	public function getServiceAccess($context) {
-		// try to get credentials for current context otherwise use default config
-		list($apiUrl, $apiKey) = $this->hasForcedCredentials()
-			? $this->getForcedCredentials()
-			: [
+	public function getServiceAccess($context = null) {
+
+		if ($this->hasForcedCredentials()) {
+			list($apiUrl, $apiKey) = $this->getForcedCredentials();
+			return [$apiUrl, $apiKey];
+		}
+
+		if ($context && $context instanceof Context) {
+			return [
 				$this->getSetting($context->getId(), 'ithenticateApiUrl'), 
 				$this->getSetting($context->getId(), 'ithenticateApiKey')
 			];
-		
-		return [$apiUrl, $apiKey];
+		}
+
+		return ['', ''];
 	}
 
 	/**
@@ -1003,12 +1018,13 @@ protected function getForcedConfigSetting($contextPath, $configKeyName) {
 	}
 
 	/**
-	 * Check is ithenticate service access details(API URL & KEY) available for given context
+	 * Check is ithenticate service access details(API URL & KEY) available at global level or
+	 * for the given context
 	 * 
-	 * @param Context $context
+	 * @param Context|null $context
 	 * @return bool
 	 */
-	protected function isServiceAccessAvailable($context) {
+	protected function isServiceAccessAvailable($context = null) {
 		return !collect($this->getServiceAccess($context))->filter()->isEmpty();
 	}
 }

From 830e9b577ec328bd8574a3d737621c9627f6797b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 27 May 2024 20:24:11 +0600
Subject: [PATCH 40/75] pkp/plagiarism#52 made compatible with OPS 3.3.0

---
 PlagiarismPlugin.inc.php                      | 18 ++++++
 ...PlagiarismArticleGalleyGridHandler.inc.php | 55 +++++++++++++++++++
 ...PlagiarismIthenticateActionHandler.inc.php | 34 +++++++++---
 grids/SimilarityActionGridColumn.inc.php      | 34 ++++++++++--
 locale/en_US/locale.po                        |  2 +-
 5 files changed, 131 insertions(+), 12 deletions(-)
 create mode 100644 controllers/PlagiarismArticleGalleyGridHandler.inc.php

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index ee7dd07..62efa37 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -41,6 +41,16 @@ class PlagiarismPlugin extends GenericPlugin {
 		'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
 	];
 
+	/**
+	 * Determine if running application is OPS or not
+	 * 
+	 * @return bool
+	 */
+    public static function isOPS()
+    {
+        return strtolower(Application::get()->getName()) === 'ops';
+    }
+
 	/**
 	 * @copydoc Plugin::register()
 	 */
@@ -247,6 +257,13 @@ public function handleAdditionalEulaConfirmationFieldNames($hookName, $params) {
 	public function handleRouteComponent($hookName, $params) {
 		$component =& $params[0];
 
+		if (static::isOPS() && $component === 'grid.articleGalleys.ArticleGalleyGridHandler') {
+			$this->import('controllers.PlagiarismArticleGalleyGridHandler');
+			PlagiarismArticleGalleyGridHandler::setPlugin($this);
+			$params[0] = "plugins.generic.plagiarism.controllers.PlagiarismArticleGalleyGridHandler";
+			return true;
+		}
+
 		if (!in_array($component, $this->validRouteComponentHandlers)) {
 			return false;
 		}
@@ -254,6 +271,7 @@ public function handleRouteComponent($hookName, $params) {
 		import($component);
 		$componentName = last(explode('.', $component));
 		$componentName::setPlugin($this);
+
 		return true;
 	}
 
diff --git a/controllers/PlagiarismArticleGalleyGridHandler.inc.php b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
new file mode 100644
index 0000000..d2fe75f
--- /dev/null
+++ b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
@@ -0,0 +1,55 @@
+<?php
+
+/**
+ * @file plugins/generic/plagiarism/controllers/PlagiarismArticleGalleyGridHandler.inc.php
+ *
+ * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2000-2024 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
+ *
+ * @class PlagiarismArticleGalleyGridHandler
+ * @ingroup plugins_generic_plagiarism
+ *
+ * @brief 	Handle the attachment of plagiarism score/action column to galleys file grid
+ * 			view for OPS
+ */
+
+import('controllers.grid.articleGalleys.ArticleGalleyGridHandler');
+
+class PlagiarismArticleGalleyGridHandler extends ArticleGalleyGridHandler {
+
+    /** 
+	 * The Plagiarism Plugin itself
+	 * 
+	 * @var PlagiarismPlugin 
+	 */
+	protected static $_plugin;
+
+	/**
+	 * Get the plugin
+	 * 
+	 * @return PlagiarismPlugin
+	 */
+	public static function getPlugin() {
+		return static::$_plugin;
+	}
+
+	/**
+	 * Set the Plugin
+	 * 
+	 * @param PlagiarismPlugin $plugin
+	 */
+	public static function setPlugin($plugin) {
+		static::$_plugin = $plugin;
+	}
+
+	/**
+	 * @copydoc GridHandler::initialize()
+	 */
+	public function initialize($request, $args = null) {
+		parent::initialize($request, $args);
+		
+        static::$_plugin->import('grids.SimilarityActionGridColumn');
+        $this->addColumn(new SimilarityActionGridColumn(static::$_plugin));
+	}
+}
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 1ce1e01..699c744 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -105,7 +105,7 @@ public function scheduleSimilarityReport($args, $request) {
 				NOTIFICATION_TYPE_ERROR, 
 				__('plugins.generic.plagiarism.action.scheduleSimilarityReport.error')
 			);
-			return DAO::getDataChangedEvent($submissionFile->getId());
+			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
 		$submissionFile->setData('ithenticateSimilarityScheduled', 1);
@@ -117,7 +117,7 @@ public function scheduleSimilarityReport($args, $request) {
 			__('plugins.generic.plagiarism.action.scheduleSimilarityReport.success')
 		);
 		
-		return DAO::getDataChangedEvent($submissionFile->getId());
+		return $this->triggerDataChangedEvent($submissionFile);
     }
 
 	/**
@@ -149,7 +149,7 @@ public function refreshSimilarityResult($args, $request) {
 				NOTIFICATION_TYPE_ERROR, 
 				__('plugins.generic.plagiarism.action.refreshSimilarityResult.error')
 			);
-			return DAO::getDataChangedEvent($submissionFile->getId());
+			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
 		$similarityScoreResult = json_decode($similarityScoreResult);
@@ -161,7 +161,7 @@ public function refreshSimilarityResult($args, $request) {
 				NOTIFICATION_TYPE_WARNING, 
 				__('plugins.generic.plagiarism.action.refreshSimilarityResult.warning')
 			);
-			return DAO::getDataChangedEvent($submissionFile->getId());
+			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
 		$submissionFile->setData('ithenticateSimilarityResult', json_encode($similarityScoreResult));
@@ -173,7 +173,7 @@ public function refreshSimilarityResult($args, $request) {
 			__('plugins.generic.plagiarism.action.refreshSimilarityResult.success')
 		);
 
-		return DAO::getDataChangedEvent($submissionFile->getId());
+		return $this->triggerDataChangedEvent($submissionFile);
     }
 
 	/**
@@ -203,7 +203,7 @@ public function submitSubmission($args, $request) {
 				NOTIFICATION_TYPE_ERROR, 
 				__('plugins.generic.plagiarism.action.submitSubmission.error')
 			);
-			return DAO::getDataChangedEvent($submissionFile->getId());
+			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
 		$this->generateUserNotification(
@@ -212,7 +212,7 @@ public function submitSubmission($args, $request) {
 			__('plugins.generic.plagiarism.action.submitSubmission.success')
 		);
 
-		return DAO::getDataChangedEvent($submissionFile->getId());
+		return $this->triggerDataChangedEvent($submissionFile);
 	}
 
 	/**
@@ -362,4 +362,24 @@ protected function generateUserNotification($request, $notificationType, $notifi
 		);
 	}
 
+	/**
+	 * Trigger the data change event to refresh the grid view
+	 *
+	 * @param SubmissionFile $submissionFile
+	 * @return JSONMessage
+	 */
+	protected function triggerDataChangedEvent($submissionFile) {
+		if (static::$_plugin::isOPS()) {
+			$articleGalleyDao = DAORegistry::getDAO('ArticleGalleyDAO'); /** @var ArticleGalleyDAO $articleGalleyDao */
+			$daoResultFactory = $articleGalleyDao->getByFileId($submissionFile->getId()); /** @var DAOResultFactory $daoResultFactory */
+			$articleGalley = $daoResultFactory->next(); /** @var ArticleGalley $articleGalley */
+			
+			if ($articleGalley) {
+				return DAO::getDataChangedEvent($articleGalley->getId());
+			}
+		}
+
+		return DAO::getDataChangedEvent($submissionFile->getId());
+	}
+
 }
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 99aa1d8..f7e3113 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -59,8 +59,23 @@ public function __construct($plugin) {
 	 */
 	public function getTemplateVarsFromRow($row) {
 
-		$submissionFileData = $row->getData();
-		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+		if ($this->_plugin::isOPS()) { // For OPS
+			$articleGalley = $row->getData(); /** @var ArticleGalley $articleGalley */
+			
+			if (!isset($articleGalley->_data['submissionFileId'])) {
+				return ['label' => ''];
+			}
+
+			$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+			$submissionFile = $submissionFileDao->getById($articleGalley->getData('submissionFileId')); /** @var SubmissionFile $submissionFile */
+
+			$articleGalleyDao = DAORegistry::getDAO('ArticleGalleyDAO'); /** @var ArticleGalleyDAO $articleGalleyDao */
+			$articleGalley = $articleGalleyDao->getByFileId($submissionFile->getId()); /** @var ArticleGalley $articleGalley */
+		} else {
+			$submissionFileData = $row->getData();
+			$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */			
+		}
+
 		assert($submissionFile instanceof SubmissionFile);
 
 		// Not going to allow plagiarims action on a zip file
@@ -110,8 +125,19 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 			return $cellActions;
 		}
 
-		$submissionFileData = $row->getData();
-		$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+		if ($this->_plugin::isOPS()) { // For OPS
+			$articleGalley = $row->getData(); /** @var ArticleGalley $articleGalley */
+
+			if (!isset($articleGalley->_data['submissionFileId'])) {
+				return $cellActions;
+			}
+
+			$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+			$submissionFile = $submissionFileDao->getById($articleGalley->getData('submissionFileId')); /** @var SubmissionFile $submissionFile */
+		} else {
+			$submissionFileData = $row->getData();
+			$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
+		}
 
 		// Not going to allow plagiarims action on a zip file
 		if ($this->isSubmissionFileTypeZip($submissionFile)) {
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index b557867..31f853f 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -136,7 +136,7 @@ msgid "plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpda
 msgstr "Allow changes in the similarity viewer to update the similarity score"
 
 msgid "plugins.generic.plagiarism.similarity.action.column.score.title"
-msgstr "Plagiarism Score"
+msgstr "Plagiarism Score/Action"
 
 msgid "plugins.generic.plagiarism.similarity.action.launch.viewer.title"
 msgstr "Launch Plagiarism Similarity Viewer"

From c75881028aec62a6820ec3fac5ebe24d8e8f3c4e Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 13:20:45 +0600
Subject: [PATCH 41/75] pkp/plagiarism#52 added similarity settings property,
 copyright year and file path updated

---
 IThenticate.inc.php                           |  4 +-
 PlagiarismPlugin.inc.php                      | 87 +++++++++++--------
 PlagiarismSettingsForm.inc.php                | 49 ++++-------
 README.md                                     | 19 ++--
 TestIThenticate.inc.php                       | 60 ++++++-------
 .../FormValidatorIthenticateAccess.inc.php    |  8 +-
 .../ValidatorIthenticateAccess.inc.php        |  8 +-
 ...PlagiarismArticleGalleyGridHandler.inc.php |  6 +-
 .../PlagiarismComponentHandler.inc.php        |  6 +-
 .../PlagiarismEulaAcceptanceHandler.inc.php   |  6 +-
 ...PlagiarismIthenticateActionHandler.inc.php | 16 ++--
 controllers/PlagiarismWebhookHandler.inc.php  |  8 +-
 exclusions.txt                                |  1 -
 grids/RearrangeColumnsFeature.inc.php         |  6 +-
 grids/SimilarityActionGridColumn.inc.php      | 12 +--
 index.php                                     |  4 +-
 locale/en_US/locale.po                        |  2 +-
 templates/confirmEula.tpl                     |  2 +-
 18 files changed, 156 insertions(+), 148 deletions(-)
 delete mode 100644 exclusions.txt

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 0b248b0..425c32a 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -3,8 +3,8 @@
 /**
  * @file IThenticate.inc.php
  *
- * Copyright (c) 2003-2024 Simon Fraser University
- * Copyright (c) 2003-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Service class to handle API communication with iThenticate service
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 62efa37..6217ff9 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -30,6 +30,22 @@ class PlagiarismPlugin extends GenericPlugin {
 	 */
 	public const EULA_CACHE_LIFETIME = 60 * 60 * 24;
 
+	/**
+	 * Mapping of similarity settings with value type
+	 * 
+	 * @var array
+	 */
+	public $similaritySettings = [
+		'addToIndex' 			=> 'bool',
+		'excludeQuotes' 		=> 'bool',
+		'excludeBibliography' 	=> 'bool',
+		'excludeCitations' 		=> 'bool',
+		'excludeAbstract' 		=> 'bool',
+		'excludeMethods' 		=> 'bool',
+		'excludeSmallMatches' 	=> 'int',
+		'allowViewerUpdate' 	=> 'bool',
+	];
+
 	/**
 	 * List of valid url components
 	 * 
@@ -46,8 +62,7 @@ class PlagiarismPlugin extends GenericPlugin {
 	 * 
 	 * @return bool
 	 */
-    public static function isOPS()
-    {
+    public static function isOPS() {
         return strtolower(Application::get()->getName()) === 'ops';
     }
 
@@ -139,21 +154,21 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 		$schema->properties->ithenticateEulaVersion = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate EULA version which has been agreed at submission checklist',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
 		$schema->properties->ithenticateEulaUrl = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate EULA url which has been agreen at submission checklist',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
 		$schema->properties->ithenticateSubmissionCompletedAt = (object) [
 			'type' => 'string',
 			'description' => 'The timestamp at which this submission successfully completed uploading all files at iThenticate service end',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => [
 				'date:Y-m-d H:i:s',
 				'nullable',
@@ -178,21 +193,21 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 		$schema->properties->ithenticateId = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate submission id for submission file',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
 		$schema->properties->ithenticateSimilarityScheduled = (object) [
 			'type' => 'boolean',
 			'description' => 'The status which identify if the iThenticate similarity process has been scheduled for this submission file',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
 		$schema->properties->ithenticateSimilarityResult = (object) [
 			'type' => 'string',
 			'description' => 'The similarity check result for this submission file in json format',
-			'apiSummary' => true,
+			'writeOnly' => true,
 			'validation' => ['nullable'],
 		];
 
@@ -305,7 +320,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 		$submission = $form->submission; /** @var Submission $submission */
 
 		// EULA confirmation is not required, so no need for the checking of EULA acceptance
-		if ($this->getContextEulaDetails($context, 'require_eula') === false) {
+		if ($this->getContextEulaDetails($context, 'require_eula') == false) {
 			return false;
 		}
 
@@ -338,7 +353,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 		$eulaVersionDetails = $this->getContextEulaDetails($context, [
 			$submission->getData('locale'),
 			$request->getSite()->getPrimaryLocale(),
-			\IThenticate::DEFAULT_EULA_LANGUAGE
+			IThenticate::DEFAULT_EULA_LANGUAGE
 		]);
 		
 		$templateManager = TemplateManager::getManager();
@@ -406,7 +421,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			return false;
 		}
 
-		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var IThenticate $ithenticate */
 
 		// If no webhook previously registered for this Context, register it
 		if (!$context->getData('ithenticateWebhookId')) {
@@ -525,7 +540,7 @@ public function stampEulaToSubmittingUser($context, $submission, $user = null) {
 			return false;
 		}
 
-		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var IThenticate $ithenticate */
 		$ithenticate->setApplicableEulaVersion($submissionEulaVersion);
 		
 		// Check if user has ever already accepted this EULA version and if so, stamp it to user
@@ -575,7 +590,7 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 
 		// Not going to allow uploading a zip file to iThenticate service end
 		if ($pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP) {
-			error_log("plagiarims check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is now allowed");
+			error_log("plagiarims check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is not allowed");
 			return true;
 		}
 
@@ -601,7 +616,7 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 	/**
 	 * Register the webhook for this context
 	 * 
-	 * @param \IThenticate|\TestIThenticate $ithenticate
+	 * @param IThenticate|TestIThenticate $ithenticate
 	 * @param Context|null 					$context
 	 * 
 	 * @return void
@@ -621,9 +636,11 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 		);
 
 		if ($webhookId = $ithenticate->registerWebhook($signingSecret, $webhookUrl)) {
-			$context->setData('ithenticateWebhookSigningSecret', $signingSecret);
-			$context->setData('ithenticateWebhookId', $webhookId);
-			Application::get()->getContextDAO()->updateObject($context);
+			$contextService = Services::get('context'); /** @var \PKP\Services\PKPContextService $contextService */
+			$context = $contextService->edit($context, [
+				'ithenticateWebhookSigningSecret' => $signingSecret,
+				'ithenticateWebhookId' => $webhookId
+			], $request);
 		} else {
 			error_log("unable to complete the iThenticate webhook registration for context id {$context->getId()}");
 		}
@@ -698,7 +715,7 @@ public function getContextEulaDetails($context, $keys = null, $default = null) {
 	 */
 	public function retrieveEulaDetails($cache, $cacheId) {
 		$context = Application::get()->getRequest()->getContext();
-		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var \IThenticate $ithenticate */
+		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var IThenticate $ithenticate */
 		$eulaDetails = [];
 
 		$eulaDetails['require_eula'] = $ithenticate->getEnabledFeature('tenant.require_eula');
@@ -745,13 +762,13 @@ public function retrieveEulaDetails($cache, $cacheId) {
 	 * @param string $apiUrl
 	 * @param string $apiKey
 	 * 
-	 * @return \IThenticate|\TestIThenticate
+	 * @return IThenticate|TestIThenticate
 	 */
 	public function initIthenticate($apiUrl, $apiKey) {
 
 		if (static::isRunningInTestMode()) {
 			$this->import('TestIThenticate');
-			return new \TestIThenticate(
+			return new TestIThenticate(
 				$apiUrl,
 				$apiKey,
 				static::PLUGIN_INTEGRATION_NAME,
@@ -761,7 +778,7 @@ public function initIthenticate($apiUrl, $apiKey) {
 
 		$this->import('IThenticate');
 
-		return new \IThenticate(
+		return new IThenticate(
 			$apiUrl,
 			$apiKey,
 			static::PLUGIN_INTEGRATION_NAME,
@@ -860,8 +877,8 @@ public function manage($args, $request) {
 	 */
 	public function getServiceAccess($context = null) {
 
-		if ($this->hasForcedCredentials()) {
-			list($apiUrl, $apiKey) = $this->getForcedCredentials();
+		if ($this->hasForcedCredentials($context)) {
+			list($apiUrl, $apiKey) = $this->getForcedCredentials($context);
 			return [$apiUrl, $apiKey];
 		}
 
@@ -878,10 +895,10 @@ public function getServiceAccess($context = null) {
 	/**
 	 * Fetch credentials from config.inc.php, if available
 	 * 
+	 * @param Context|null $context
 	 * @return array api url and api key, or null(s)
 	 */
-	public function getForcedCredentials() {
-		$context = Application::get()->getRequest()->getContext(); /** @var Context $context */
+	public function getForcedCredentials($context = null) {
 		$contextPath = $context ? $context->getPath() : 'index';
 
 		$apiUrl = $this->getForcedConfigSetting($contextPath, 'api_url');
@@ -893,10 +910,11 @@ public function getForcedCredentials() {
 	/**
 	 * Check and determine if plagiarism checking service creds has been set forced in config.inc.php
 	 * 
+	 * @param Context|null $context
 	 * @return bool
 	 */
-	public function hasForcedCredentials() {
-		list($apiUrl, $apiKey) = $this->getForcedCredentials();
+	public function hasForcedCredentials($context = null) {
+		list($apiUrl, $apiKey) = $this->getForcedCredentials($context);
 		return !empty($apiUrl) && !empty($apiKey);
 	}
 
@@ -910,17 +928,12 @@ public function hasForcedCredentials() {
 	 */
 	public function getSimilarityConfigSettings($context, $settingName = null) {
 		$contextPath = $context->getPath();
+		$similarityConfigSettings = [];
 
-		$similarityConfigSettings = [
-			'addToIndex' 			=> $this->getForcedConfigSetting($contextPath, 'addToIndex') 			?? $this->getSetting($context->getId(), 'addToIndex'),
-			'excludeQuotes' 		=> $this->getForcedConfigSetting($contextPath, 'excludeQuotes') 		?? $this->getSetting($context->getId(), 'excludeQuotes'),
-			'excludeBibliography' 	=> $this->getForcedConfigSetting($contextPath, 'excludeBibliography') 	?? $this->getSetting($context->getId(), 'excludeBibliography'),
-			'excludeCitations' 		=> $this->getForcedConfigSetting($contextPath, 'excludeCitations') 		?? $this->getSetting($context->getId(), 'excludeCitations'),
-			'excludeAbstract' 		=> $this->getForcedConfigSetting($contextPath, 'excludeAbstract') 		?? $this->getSetting($context->getId(), 'excludeAbstract'),
-			'excludeMethods' 		=> $this->getForcedConfigSetting($contextPath, 'excludeMethods') 		?? $this->getSetting($context->getId(), 'excludeMethods'),
-			'excludeSmallMatches' 	=> $this->getForcedConfigSetting($contextPath, 'excludeSmallMatches') 	?? $this->getSetting($context->getId(), 'excludeSmallMatches'),
-			'allowViewerUpdate'		=> $this->getForcedConfigSetting($contextPath, 'allowViewerUpdate') 	?? $this->getSetting($context->getId(), 'allowViewerUpdate'),
-		];
+		foreach(array_keys($this->similaritySettings) as $settingOption) {
+			$similarityConfigSettings[$settingOption] = $this->getForcedConfigSetting($contextPath, $settingOption)
+				?? $this->getSetting($context->getId(), $settingOption);
+		}
 
 		return $settingName
 			? ($similarityConfigSettings[$settingName] ?? null)
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index dac4206..b6b7e5d 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -3,8 +3,8 @@
 /**
  * @file PlagiarismSettingsForm.inc.php
  *
- * Copyright (c) 2003-2024 Simon Fraser University
- * Copyright (c) 2003-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Plagiarism settings form
@@ -71,38 +71,28 @@ public function __construct($plugin, $context) {
 	 */
 	public function initData() {
 		$this->_data = [
-			'ithenticateForced' 	=> $this->_plugin->hasForcedCredentials(),
+			'ithenticateForced' 	=> $this->_plugin->hasForcedCredentials($this->_context),
 			'ithenticateApiUrl' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl'),
 			'ithenticateApiKey' 	=> $this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey'),
 			'disableAutoSubmission' => $this->_plugin->getSetting($this->_context->getId(), 'disableAutoSubmission'),
-			'addToIndex' 			=> $this->_plugin->getSetting($this->_context->getId(), 'addToIndex'),
-			'excludeQuotes' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeQuotes'),
-			'excludeBibliography' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeBibliography'),
-			'excludeCitations' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeCitations'),
-			'excludeAbstract' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeAbstract'),
-			'excludeMethods' 		=> $this->_plugin->getSetting($this->_context->getId(), 'excludeMethods'),
-			'excludeSmallMatches' 	=> $this->_plugin->getSetting($this->_context->getId(), 'excludeSmallMatches'),
-			'allowViewerUpdate' 	=> $this->_plugin->getSetting($this->_context->getId(), 'allowViewerUpdate'),
 		];
+
+		foreach(array_keys($this->_plugin->similaritySettings) as $settingOption) {
+			$this->_data[$settingOption] = $this->_plugin->getSetting($this->_context->getId(), $settingOption);
+		}
 	}
 
 	/**
 	 * Assign form data to user-submitted data.
 	 */
 	public function readInputData() {
-		$this->readUserVars([
+		$this->readUserVars(
+			array_merge([
 			'ithenticateApiUrl',
 			'ithenticateApiKey',
 			'disableAutoSubmission',
-			'addToIndex',
-			'excludeQuotes',
-			'excludeBibliography',
-			'excludeCitations',
-			'excludeAbstract',
-			'excludeMethods',
-			'excludeSmallMatches',
-			'allowViewerUpdate',
-		]);
+			], array_keys($this->_plugin->similaritySettings))
+		);
 	}
 
 	/**
@@ -142,15 +132,14 @@ public function execute(...$functionArgs) {
 
 		$this->_plugin->updateSetting($this->_context->getId(), 'disableAutoSubmission', $this->getData('disableAutoSubmission'), 'bool');
 
-		$this->_plugin->updateSetting($this->_context->getId(), 'addToIndex', 			$this->getData('addToIndex'), 			'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeQuotes', 		$this->getData('excludeQuotes'), 		'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeBibliography', 	$this->getData('excludeBibliography'), 	'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeCitations', 	$this->getData('excludeCitations'), 	'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeAbstract', 		$this->getData('excludeAbstract'), 		'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeMethods', 		$this->getData('excludeMethods'), 		'bool');
-		$this->_plugin->updateSetting($this->_context->getId(), 'excludeSmallMatches', 	$this->getData('excludeSmallMatches'), 	'int');
-		$this->_plugin->updateSetting($this->_context->getId(), 'allowViewerUpdate', 	$this->getData('allowViewerUpdate'), 	'bool');
-		
+		foreach($this->_plugin->similaritySettings as $settingName => $settingValueType) {
+			$this->_plugin->updateSetting(
+				$this->_context->getId(),
+				$settingName,
+				$this->getData($settingName),
+				$settingValueType
+			);
+		}
 
 		parent::execute(...$functionArgs);
 	}
diff --git a/README.md b/README.md
index a57234f..4f2d9d2 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
 5. The Editor logs in to OJS/OMP/OPS installation, go to the submission list and open the workflow stage for the submission
    * In the submission files grid view, Editor/Journal Manager can see the similarity scores if the similarity process has completed.
    * Editor/Journal Manager can also launch the iThenticate's similarity viewer as an additional action.
-6. In addition to all of above, if the auto upload to iThenticate is disable, Editor/Journal Manager and upload each of submisison file one by one from the workflow stage.
+6. In addition to all of above, if the auto upload to iThenticate is disable, Editor/Journal Manager and upload each of submission file one by one from the workflow stage.
 
 ## Similarity Check Settings
 
@@ -48,22 +48,29 @@ The config.inc.php settings format is:
 
 [ithenticate]
 
-; Enable iThenticate to submit manuscripts after submit step 4
+; Enable iThenticate to upload submission files at the final stage or later manually 
+; if auto upload to iThenticate disable globally or Journal/Server/Press level
 ; ithenticate = On
 
-; Credentials can be set by context : specify journal path
+; Credentials can be set by context : specify Journal/Server/Press path
 ; Unique turnitin api url
-; api_url[MyJournal_path] = ""
+; api_url[Journal_or_Server_or_Press_path] = ""
 ; The API key to authorize the api calls
-; api_key[MyJournal_path] = ""
+; api_key[Journal_or_Server_or_Press_path] = ""
 
 ; Unique ithenticate api url
-; Make sure to provice the schema(http:// or https://) with the url and no trailing slash
+; Make sure to provide the schema(http:// or https://) with the url and no trailing slash
 ; api_url = "https://some-ithenticate-account.com"
 
 ; The API key to authorize the api calls
 ; api_key = "YOUR_API_KEY"
 
+; To disable auto upload of submisison files to iThenticate service, uncomment following line
+; disableAutoSubmission = On
+; It is possible to disable auto upload at specific Journal/Server/Press level rathar than globally
+; disableAutoSubmission[Journal_or_Server_or_Press_path] = On
+
+
 ; Submission similarity check settings can also configured as global or journel level
 ; To set a similarity check config on global level, just set the setting value as
 ; addToIndex = On
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 4e065d2..262ef12 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -3,11 +3,11 @@
 /**
  * @file TestIThenticate.inc.php
  *
- * Copyright (c) 2003-2024 Simon Fraser University
- * Copyright (c) 2003-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
- * @brief   Low-budget mock class for \IThenticate -- set the config setting 
+ * @brief   Low-budget mock class for IThenticate -- set the config setting 
  *          `test_mdoe` to `On` in the `config.inc.php` to log API usage 
  *          instead of interacting with the iThenticate service.
  */
@@ -15,12 +15,12 @@
 class TestIThenticate {
 
     /**
-     * @copydoc \IThenticate::$eulaVersion
+     * @copydoc IThenticate::$eulaVersion
      */
     protected $eulaVersion = 'v1beta';
 
     /**
-     * @copydoc \IThenticate::$eulaVersionDetails
+     * @copydoc IThenticate::$eulaVersionDetails
      */
     protected $eulaVersionDetails = [
         "version" => "v1beta",
@@ -55,22 +55,22 @@ class TestIThenticate {
     ];
 
     /**
-     * @copydoc \IThenticate::$suppressApiRequestException
+     * @copydoc IThenticate::$suppressApiRequestException
      */
     protected $suppressApiRequestException = true;
 
     /**
-     * @copydoc \IThenticate::DEFAULT_EULA_VERSION
+     * @copydoc IThenticate::DEFAULT_EULA_VERSION
      */
     public const DEFAULT_EULA_VERSION = 'latest';
     
     /**
-     * @copydoc \IThenticate::DEFAULT_EULA_LANGUAGE
+     * @copydoc IThenticate::DEFAULT_EULA_LANGUAGE
      */
     public const DEFAULT_EULA_LANGUAGE = 'en-US';
 
     /**
-     * @copydoc \IThenticate::DEFAULT_WEBHOOK_EVENTS
+     * @copydoc IThenticate::DEFAULT_WEBHOOK_EVENTS
      */
     public const DEFAULT_WEBHOOK_EVENTS = [
         'SUBMISSION_COMPLETE',
@@ -81,7 +81,7 @@ class TestIThenticate {
     ];
 
     /**
-     * @copydoc \IThenticate::SUBMISSION_PERMISSION_SET
+     * @copydoc IThenticate::SUBMISSION_PERMISSION_SET
      */
     public const SUBMISSION_PERMISSION_SET = [
         'ADMINISTRATOR',
@@ -94,14 +94,14 @@ class TestIThenticate {
     ];
 
     /**
-     * @copydoc \IThenticate::__construct()
+     * @copydoc IThenticate::__construct()
      */
     public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
         error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
     }
 
     /**
-     * @copydoc \IThenticate::withoutSuppressingApiRequestException()
+     * @copydoc IThenticate::withoutSuppressingApiRequestException()
      */
     public function withoutSuppressingApiRequestException() {
         $this->suppressApiRequestException = false;
@@ -110,7 +110,7 @@ public function withoutSuppressingApiRequestException() {
     }
 
     /**
-     * @copydoc \IThenticate::getEnabledFeature()
+     * @copydoc IThenticate::getEnabledFeature()
      */
     public function getEnabledFeature($feature = null) {
         
@@ -175,7 +175,7 @@ public function getEnabledFeature($feature = null) {
     }
 
     /**
-     * @copydoc \IThenticate::validateAccess()
+     * @copydoc IThenticate::validateAccess()
      */
     public function validateAccess(&$result = null) {
         error_log("Confirming the service access validation for given access details");
@@ -183,7 +183,7 @@ public function validateAccess(&$result = null) {
     }
 
     /**
-     * @copydoc \IThenticate::confirmEula()
+     * @copydoc IThenticate::confirmEula()
      */
     public function confirmEula($user, $context) {
         error_log("Confirming EULA for user {$user->getId()} with language ".$this->getApplicableLocale($context->getPrimaryLocale())." for version {$this->getApplicableEulaVersion()}");
@@ -191,7 +191,7 @@ public function confirmEula($user, $context) {
     }
     
     /**
-     * @copydoc \IThenticate::createSubmission()
+     * @copydoc IThenticate::createSubmission()
      */
     public function createSubmission($site, $submission, $user, $author, $authorPermission, $submitterPermission) {
 
@@ -209,7 +209,7 @@ public function createSubmission($site, $submission, $user, $author, $authorPerm
     }
 
     /**
-     * @copydoc \IThenticate::uploadFile()
+     * @copydoc IThenticate::uploadFile()
      */
     public function uploadFile($submissionTacId, $fileName, $fileContent) {
         error_log("Uploading submission file named {$fileName} for submission UUID {$submissionTacId}");
@@ -217,7 +217,7 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
     }
 
     /**
-     * @copydoc \IThenticate::scheduleSimilarityReportGenerationProcess()
+     * @copydoc IThenticate::scheduleSimilarityReportGenerationProcess()
      */
     public function scheduleSimilarityReportGenerationProcess($submissionUuid, $settings = []) {
         error_log(
@@ -231,7 +231,7 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid, $sett
     }
 
     /**
-     * @copydoc \IThenticate::getSimilarityResult()
+     * @copydoc IThenticate::getSimilarityResult()
      */
     public function getSimilarityResult($submissionUuid) {
         error_log("Similarity report result retrived for iThenticate submission id : {$submissionUuid}");
@@ -250,7 +250,7 @@ public function getSimilarityResult($submissionUuid) {
     }
 
     /**
-     * @copydoc \IThenticate::createViewerLaunchUrl()
+     * @copydoc IThenticate::createViewerLaunchUrl()
      */
     public function createViewerLaunchUrl($submissionUuid, $user, $locale, $viewerPermission, $allowUpdateInViewer) {
         error_log("Similarity report viewer launch url generated for iThenticate submission id : {$submissionUuid} with locale : {$locale}, viewer permission : {$viewerPermission} and update viewer permission : {$allowUpdateInViewer}");
@@ -258,7 +258,7 @@ public function createViewerLaunchUrl($submissionUuid, $user, $locale, $viewerPe
     }
 
     /**
-     * @copydoc \IThenticate::verifyUserEulaAcceptance()
+     * @copydoc IThenticate::verifyUserEulaAcceptance()
      */
     public function verifyUserEulaAcceptance($user, $version) {
         error_log("Verifying if user with id {$user->getId()} has already confirmed the given EULA version {$version}");
@@ -266,7 +266,7 @@ public function verifyUserEulaAcceptance($user, $version) {
     }
 
     /**
-     * @copydoc \IThenticate::validateEulaVersion()
+     * @copydoc IThenticate::validateEulaVersion()
      */
     public function validateEulaVersion($version) {
         error_log("Validating/Retrieving the given EULA version {$version}");
@@ -274,7 +274,7 @@ public function validateEulaVersion($version) {
     }
 
     /**
-     * @copydoc \IThenticate::registerWebhook()
+     * @copydoc IThenticate::registerWebhook()
      */
     public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WEBHOOK_EVENTS) {
         error_log(
@@ -289,21 +289,21 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
     }
 
     /**
-     * @copydoc \IThenticate::getEulaDetails()
+     * @copydoc IThenticate::getEulaDetails()
      */
     public function getEulaDetails() {
         return $this->eulaVersionDetails;
     }
 
     /**
-     * @copydoc \IThenticate::getApplicableEulaVersion()
+     * @copydoc IThenticate::getApplicableEulaVersion()
      */
     public function getApplicableEulaVersion() {
         return $this->eulaVersion;
     }
 
     /**
-     * @copydoc \IThenticate::setApplicableEulaVersion()
+     * @copydoc IThenticate::setApplicableEulaVersion()
      */
     public function setApplicableEulaVersion($version) {
         $this->eulaVersion = $version;
@@ -312,7 +312,7 @@ public function setApplicableEulaVersion($version) {
     }
 
     /**
-     * @copydoc \IThenticate::getApplicableEulaUrl()
+     * @copydoc IThenticate::getApplicableEulaUrl()
      */
     public function getApplicableEulaUrl($locales = null) {
         if (!$this->eulaVersion) {
@@ -331,7 +331,7 @@ public function getApplicableEulaUrl($locales = null) {
     }
 
     /**
-     * @copydoc \IThenticate::getApplicableLocale()
+     * @copydoc IThenticate::getApplicableLocale()
      */
     public function getApplicableLocale($locales, $eulaVersion = null) {
         if (!$this->getEulaDetails() && !$this->validateEulaVersion($eulaVersion ?? $this->eulaVersion)) {
@@ -353,7 +353,7 @@ public function getApplicableLocale($locales, $eulaVersion = null) {
     }
 
     /**
-     * @copydoc \IThenticate::isCorrespondingLocaleAvailable()
+     * @copydoc IThenticate::isCorrespondingLocaleAvailable()
      */
     protected function getCorrespondingLocaleAvailable($locale) {
         $eulaLangs = $this->eulaVersionDetails['available_languages'];
@@ -363,7 +363,7 @@ protected function getCorrespondingLocaleAvailable($locale) {
     }
 
     /**
-     * @copydoc \IThenticate::validatePermission()
+     * @copydoc IThenticate::validatePermission()
      */
     protected function validatePermission($permission, $permissionSet) {
         return in_array($permission, $permissionSet);
diff --git a/classes/form/validation/FormValidatorIthenticateAccess.inc.php b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
index 81393aa..9a37a45 100644
--- a/classes/form/validation/FormValidatorIthenticateAccess.inc.php
+++ b/classes/form/validation/FormValidatorIthenticateAccess.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/classes/form/validation/FormValidatorIthenticateAccess.inc.php
+ * @file classes/form/validation/FormValidatorIthenticateAccess.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class FormValidatorIthenticateAccess
@@ -26,7 +26,7 @@ class FormValidatorIthenticateAccess extends FormValidator {
 	 * @param string                        $field          the name of the associated field
 	 * @param string                        $type           the type of check, either "required" or "optional"
 	 * @param string                        $message        the error message for validation failures (i18n key)
-     * @param \IThenticate|\TestIThenticate $ithenticate    iThenticate API communicating service class instance
+     * @param IThenticate|TestIThenticate $ithenticate    iThenticate API communicating service class instance
 	 */
 	public function __construct(&$form, $field, $type, $message, $ithenticate) {
 		$validator = new ValidatorIthenticateAccess($ithenticate);
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index d5849a9..5e41ad6 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/classes/validation/ValidatorIthenticateAccess.inc.php
+ * @file classes/validation/ValidatorIthenticateAccess.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class ValidatorIthenticateAccess
@@ -22,7 +22,7 @@ class ValidatorIthenticateAccess extends Validator {
 	/**
 	 * The iThenticate API communicating service class instance
 	 * 
-	 * @var \IThenticate|\TestIThenticate
+	 * @var IThenticate|TestIThenticate
 	 */
 	protected $ithenticate;
 
diff --git a/controllers/PlagiarismArticleGalleyGridHandler.inc.php b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
index d2fe75f..5ce31cc 100644
--- a/controllers/PlagiarismArticleGalleyGridHandler.inc.php
+++ b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/PlagiarismArticleGalleyGridHandler.inc.php
+ * @file controllers/PlagiarismArticleGalleyGridHandler.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @class PlagiarismArticleGalleyGridHandler
diff --git a/controllers/PlagiarismComponentHandler.inc.php b/controllers/PlagiarismComponentHandler.inc.php
index 127e746..6559a49 100644
--- a/controllers/PlagiarismComponentHandler.inc.php
+++ b/controllers/PlagiarismComponentHandler.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/PlagiarismComponentHandler.inc.php
+ * @file controllers/PlagiarismComponentHandler.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @class PlagiarismComponentHandler
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index 858575c..10e372e 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+ * @file controllers/PlagiarismEulaAcceptanceHandler.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @class PlagiarismEulaAcceptanceHandler
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 699c744..31400d6 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/PlagiarismIthenticateActionHandler.inc.php
+ * @file controllers/PlagiarismIthenticateActionHandler.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @class PlagiarismIthenticateActionHandler
@@ -38,7 +38,7 @@ public function launchViewer($args, $request) {
 		$siteDao = DAORegistry::getDAO("SiteDAO"); /** @var SiteDAO $siteDao */
 		$site = $siteDao->getSite();
 
-		/** @var \IThenticate $ithenticate */
+		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
 			...static::$_plugin->getServiceAccess($context)
 		);
@@ -88,7 +88,7 @@ public function scheduleSimilarityReport($args, $request) {
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
 
-		/** @var \IThenticate $ithenticate */
+		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
 			...static::$_plugin->getServiceAccess($context)
 		);
@@ -133,7 +133,7 @@ public function refreshSimilarityResult($args, $request) {
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
 
-		/** @var \IThenticate $ithenticate */
+		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
 			...static::$_plugin->getServiceAccess($context)
 		);
@@ -192,7 +192,7 @@ public function submitSubmission($args, $request) {
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId')); /** @var Submission $submission*/
 
-		/** @var \IThenticate $ithenticate */
+		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
 			...static::$_plugin->getServiceAccess($context)
 		);
@@ -316,7 +316,7 @@ protected function getEulaConfirmationTemplate($request, $args, $context, $submi
 			] : static::$_plugin->getContextEulaDetails($context, [
 				$submission->getData('locale'),
 				$request->getSite()->getPrimaryLocale(),
-				\IThenticate::DEFAULT_EULA_LANGUAGE
+				IThenticate::DEFAULT_EULA_LANGUAGE
 			]);
 		
 		$actionUrl = $request->getDispatcher()->url(
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index 1118801..d61e30a 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/controllers/PlagiarismWebhookHandler.inc.php
+ * @file controllers/PlagiarismWebhookHandler.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @class PlagiarismWebhookHandler
@@ -50,7 +50,7 @@ public function handle() {
 			return;
 		}
 		
-		if (!in_array($headers->get('x-turnitin-eventtype'), \Ithenticate::DEFAULT_WEBHOOK_EVENTS)) {
+		if (!in_array($headers->get('x-turnitin-eventtype'), IThenticate::DEFAULT_WEBHOOK_EVENTS)) {
 			static::$_plugin->sendErrorMessage("Invalid iThenticate webhook event type {$headers->get('x-turnitin-eventtype')}");
 			return;
 		}
diff --git a/exclusions.txt b/exclusions.txt
deleted file mode 100644
index 22b55ed..0000000
--- a/exclusions.txt
+++ /dev/null
@@ -1 +0,0 @@
-plagiarism/exclusions.txt
diff --git a/grids/RearrangeColumnsFeature.inc.php b/grids/RearrangeColumnsFeature.inc.php
index 4f41667..4a01b88 100644
--- a/grids/RearrangeColumnsFeature.inc.php
+++ b/grids/RearrangeColumnsFeature.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/grids/RearrangeColumnsFeature.inc.php
+ * @file grids/RearrangeColumnsFeature.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class RearrangeColumnsFeature
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index f7e3113..9b970f0 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -1,10 +1,10 @@
 <?php
 
 /**
- * @file plugins/generic/plagiarism/grids/SimilarityActionGridColumn.inc.php
+ * @file grids/SimilarityActionGridColumn.inc.php
  *
- * Copyright (c) 2014-2024 Simon Fraser University
- * Copyright (c) 2000-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *
  * @class SimilarityActionGridColumn
@@ -84,7 +84,7 @@ public function getTemplateVarsFromRow($row) {
 		}
 
         // submission similarity score is available
-        if ($submissionFile->getData('ithenticateSimilarityScheduled') === true &&
+        if ($submissionFile->getData('ithenticateSimilarityScheduled') == true &&
             $submissionFile->getData('ithenticateSimilarityResult')) {
             
             $similarityResult = json_decode(
@@ -204,7 +204,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		}
         
 		// Submission similarity report generation has not scheduled
-		if ($submissionFile->getData('ithenticateSimilarityScheduled') === false) {
+		if ($submissionFile->getData('ithenticateSimilarityScheduled') == false) {
 			$cellActions[] = new LinkAction(
 				"plagiarism-similarity-report-schedule-{$submissionFile->getId()}",
 				new RemoteActionConfirmationModal(
@@ -295,7 +295,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
     protected function isEulaConfirmationRequired($context, $submission, $user) {
 
 		// Check if EULA confirmation required for this tenant
-		if ($this->_plugin->getContextEulaDetails($context, 'require_eula') === false) {
+		if ($this->_plugin->getContextEulaDetails($context, 'require_eula') == false) {
 			return false;
 		}
 
diff --git a/index.php b/index.php
index 4c2048f..d4a8022 100644
--- a/index.php
+++ b/index.php
@@ -3,8 +3,8 @@
 /**
  * @file index.php
  *
- * Copyright (c) 2003-2024 Simon Fraser University
- * Copyright (c) 2003-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Wrapper for plagiarism checking plugin.
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 31f853f..95911a6 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -67,7 +67,7 @@ msgid "plugins.generic.plagiarism.ithenticate.submission.error.PROCESSING_ERROR"
 msgstr "An unspecified error occurred while processing the submissions."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.CANNOT_EXTRACT_TEXT"
-msgstr "The submisison does not contain text to generate a Similarity Report or the word count of the submissions is 0 ."
+msgstr "The submission does not contain text to generate a Similarity Report or the word count of the submissions is 0 ."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_LITTLE_TEXT"
 msgstr "The submission does not have enough text to generate a Similarity Report (a submission must contain at least 20 words)."
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
index 10f0965..278a0c0 100644
--- a/templates/confirmEula.tpl
+++ b/templates/confirmEula.tpl
@@ -1,7 +1,7 @@
 {**
  * plugins/generic/plagiarism/templates/confirmEula.tpl
  *
- * Copyright (c) 2014-2024 Simon Fraser University
+ * Copyright (c) 2024 Simon Fraser University
  * Copyright (c) 2003-2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
  *

From 8e279cea8d1666471f729ba790707182ead87918 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 14:18:53 +0600
Subject: [PATCH 42/75] pkp/plagiarism#52 better archive file restriction
 applied

---
 PlagiarismPlugin.inc.php                       | 16 +++++++++++++---
 README.md                                      |  8 ++++----
 .../PlagiarismArticleGalleyGridHandler.inc.php |  2 +-
 grids/SimilarityActionGridColumn.inc.php       | 18 +++++++++---------
 locale/en_US/locale.po                         |  2 +-
 templates/similarityScore.tpl                  |  8 ++++----
 6 files changed, 32 insertions(+), 22 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 6217ff9..bf95363 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -46,6 +46,17 @@ class PlagiarismPlugin extends GenericPlugin {
 		'allowViewerUpdate' 	=> 'bool',
 	];
 
+	/**
+	 * List of archive mime type that will not be uploaded to iThenticate service
+	 * 
+	 * @var array
+	 */
+	public $uploadRestrictedArchiveMimeTypes = [
+		'application/gzip',
+		'application/zip',
+		'application/x-tar',
+	];
+
 	/**
 	 * List of valid url components
 	 * 
@@ -588,9 +599,8 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 		$pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
 		$file = $pkpFileService->get($submissionFile->getData('fileId'));
 
-		// Not going to allow uploading a zip file to iThenticate service end
-		if ($pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP) {
-			error_log("plagiarims check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is not allowed");
+		if (in_array($file->mimetype, $this->uploadRestrictedArchiveMimeTypes)) {
+			error_log("plagiarism check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is not allowed");
 			return true;
 		}
 
diff --git a/README.md b/README.md
index 4f2d9d2..802ee5c 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
 
 ## Similarity Check Settings
 
-There are several iTheticate similarity check settings that can be configured via the plugin.
+There are several iThenticate similarity check settings that can be configured via the plugin.
 1. Similarity Check Options
    * `addToIndex` -- The submission will be added to all valid node groups for future matching
    * `excludeQuotes` -- Text in quotes of the submission will not count as similar content
@@ -80,6 +80,6 @@ The config.inc.php settings format is:
 ```
 
 ## Restrictions
-1. Submission submitting user must confirm the iThenticate End User License Agreement to sent files to iThenticate service for plagiarims checking
-2. Upload of zip/tar/gzip is not allowed.
-3. Uploading of file size less that 0 MB and more that 100 MB will cause failure as per iTheticate's restriction
\ No newline at end of file
+1. Submission submitting user must confirm the iThenticate End User License Agreement to sent files to iThenticate service for plagiarism checking.
+2. zip/tar/gzip will not be upload to iThenticate service for plagiarism checking.
+3. Uploading of file size more that 100 MB will cause failure as per iThenticate's restriction.
\ No newline at end of file
diff --git a/controllers/PlagiarismArticleGalleyGridHandler.inc.php b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
index 5ce31cc..19f6b1e 100644
--- a/controllers/PlagiarismArticleGalleyGridHandler.inc.php
+++ b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
@@ -44,7 +44,7 @@ public static function setPlugin($plugin) {
 	}
 
 	/**
-	 * @copydoc GridHandler::initialize()
+	 * @copydoc ArticleGalleyGridHandler::initialize()
 	 */
 	public function initialize($request, $args = null) {
 		parent::initialize($request, $args);
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 9b970f0..f6b9cc3 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -78,8 +78,8 @@ public function getTemplateVarsFromRow($row) {
 
 		assert($submissionFile instanceof SubmissionFile);
 
-		// Not going to allow plagiarims action on a zip file
-		if ($this->isSubmissionFileTypeZip($submissionFile)) {
+		// Not going to allow plagiarism action on a zip file
+		if ($this->isSubmissionFileTypeRestricted($submissionFile)) {
 			return ['label' => __('plugins.generic.plagiarism.similarity.action.invalidFileType')];
 		}
 
@@ -117,7 +117,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		$user = $request->getUser();
 
 		// User can not perform any of following actions if not a Journal Manager or Editor
-		//      - Upload file for plagiarims check if failed
+		//      - Upload file for plagiarism check if failed
 		//      - Schedule similarity report generation if not scheduled already
 		//      - Refresh the similarity report scores
 		//      - Launch similarity report viewer
@@ -139,8 +139,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 			$submissionFile = $submissionFileData['submissionFile']; /** @var SubmissionFile $submissionFile */
 		}
 
-		// Not going to allow plagiarims action on a zip file
-		if ($this->isSubmissionFileTypeZip($submissionFile)) {
+		// Not going to allow plagiarism action on a zip file
+		if ($this->isSubmissionFileTypeRestricted($submissionFile)) {
 			return $cellActions;
 		}
 
@@ -321,18 +321,18 @@ protected function isEulaConfirmationRequired($context, $submission, $user) {
     }
 
 	/**
-	 * Check if submission file type in valid for plagiarims action
+	 * Check if submission file type in valid for plagiarism action
 	 * Restricted for ZIP file
 	 *
 	 * @param SubmissionFile $submissionFile
 	 * @return bool
 	 */
-	protected function isSubmissionFileTypeZip($submissionFile) {
+	protected function isSubmissionFileTypeRestricted($submissionFile) {
 
 		$pkpFileService = Services::get('file'); /** @var \PKP\Services\PKPFileService $pkpFileService */
 		$file = $pkpFileService->get($submissionFile->getData('fileId'));
-
-		return $pkpFileService->getDocumentType($file->mimetype) === DOCUMENT_TYPE_ZIP;
+		
+		return in_array($file->mimetype, $this->_plugin->uploadRestrictedArchiveMimeTypes);
 	}
 
 }
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 95911a6..bd76aa9 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -166,7 +166,7 @@ msgid "plugins.generic.plagiarism.similarity.action.confirmEula.title"
 msgstr "Plagiarism End User License Agreement Confirmation"
 
 msgid "plugins.generic.plagiarism.similarity.action.invalidFileType"
-msgstr "Plagiarims actions Not available"
+msgstr "plagiarism actions Not available"
 
 msgid "plugins.generic.plagiarism.action.scheduleSimilarityReport.error"
 msgstr "Unable to schedule the iThenticate similarity report generation process."
diff --git a/templates/similarityScore.tpl b/templates/similarityScore.tpl
index 2d25f07..b5dfb79 100644
--- a/templates/similarityScore.tpl
+++ b/templates/similarityScore.tpl
@@ -1,19 +1,19 @@
-<span class="plagiarims-similarity-score">
+<span class="plagiarism-similarity-score">
     <img src="{$logoUrl}">
     <span> : {$score}%</span>
 </span>
 
 <style>
-    span.plagiarims-similarity-score {
+    span.plagiarism-similarity-score {
         display: flex;
         align-items: center;
     }
 
-    span.plagiarims-similarity-score img {
+    span.plagiarism-similarity-score img {
         max-width: 100px;
     }
 
-    span.plagiarims-similarity-score span {
+    span.plagiarism-similarity-score span {
         padding-left: 5px;
         font-weight: 550;
         font-size: 15px;

From d17927e8605aed8a78d613146a59ae79d98c20ac Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 15:55:28 +0600
Subject: [PATCH 43/75] pkp/plagiarism#52 fixed issue with
 getContextEulaDetails method implementation

---
 PlagiarismPlugin.inc.php                      | 33 +++++++++++++++----
 ...PlagiarismIthenticateActionHandler.inc.php | 11 +++++++
 2 files changed, 38 insertions(+), 6 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index bf95363..975908b 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -519,7 +519,13 @@ public function addActionsToSubmissionFileGrid($hookName, $params) {
 	 */
 	public function stampEulaToSubmission($context, $submission) {
 
-		$eulaDetails = $this->getContextEulaDetails($context, $submission->getData('locale'));
+		$request = Application::get()->getRequest();
+
+		$eulaDetails = $this->getContextEulaDetails($context, [
+			$submission->getData('locale'),
+			$request->getSite()->getPrimaryLocale(),
+			IThenticate::DEFAULT_EULA_LANGUAGE
+		]);
 
 		$submission->setData('ithenticateEulaVersion', $eulaDetails['version']);
 		$submission->setData('ithenticateEulaUrl', $eulaDetails['url']);
@@ -658,6 +664,23 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 
 	/**
 	 * Get the cached EULA details form Context
+	 * The eula details structure is in the following format
+	 * [
+	 *   'require_eula' => null/true/false, // null => not possible to retrived, 
+	 * 										// true => EULA confirmation required, 
+	 * 										// false => EULA confirmation not required
+	 *   'en_US' => [
+	 *     'version' => '',
+	 *     'url' => '',
+	 *   ],
+	 *   ...
+	 * ]
+	 * 
+	 * Based on the `key` param defined, it will return in following format
+	 * 	- 	if null, will return the whole details in above structure
+	 * 	- 	if array, will try to find the first matching `key` index value and return that
+	 * 	- 	if array and not found any match or if string, will return value based on last
+	 * 		array index or string value and considering the default value along with it
 	 * 
 	 * @param Context 			$context
 	 * @param string|array|null $keys
@@ -680,8 +703,6 @@ public function getContextEulaDetails($context, $keys = null, $default = null) {
 			$cache->flush();
 		}
 
-		// $cache->flush();
-
 		$eulaDetails = $cache->get($context->getId());
 
 		if (!$keys) {
@@ -690,9 +711,9 @@ public function getContextEulaDetails($context, $keys = null, $default = null) {
 
 		if (is_array($keys)) {
 			foreach ($keys as $key) {
-				$value = data_get($eulaDetails, $keys);
-				if (!$value) {
-					continue;
+				$value = data_get($eulaDetails, $key);
+				if ($value) {
+					return $value;
 				}
 			}
 		}
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 31400d6..c4cd4ea 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -197,6 +197,17 @@ public function submitSubmission($args, $request) {
 			...static::$_plugin->getServiceAccess($context)
 		);
 
+		// If no webhook previously registered for this Context, register it
+		if (!$context->getData('ithenticateWebhookId')) {
+			static::$_plugin->registerIthenticateWebhook($ithenticate, $context);
+		}
+
+		// As the submission has been already and should be stamped with an EULA at the
+		// confirmation stage, need to set it
+		if ($submission->getData('ithenticateEulaVersion')) {
+			$ithenticate->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'));
+		}
+
 		if (!static::$_plugin->createNewSubmission($request, $user, $submission, $submissionFile, $ithenticate)) {
 			$this->generateUserNotification(
 				$request,

From 35a3bd27947dccc41472fee6826cc9ca361a67bb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 18:37:40 +0600
Subject: [PATCH 44/75] pkp/plagiarism#52 added authorization policies to
 component route classes

---
 PlagiarismPlugin.inc.php                      |  4 +-
 .../PlagiarismEulaAcceptanceHandler.inc.php   | 34 +++++++++--
 ...PlagiarismIthenticateActionHandler.inc.php | 59 ++++++++++++++-----
 grids/SimilarityActionGridColumn.inc.php      | 10 ++++
 templates/confirmEula.tpl                     | 49 ++++++++-------
 5 files changed, 110 insertions(+), 46 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 975908b..d830393 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -350,9 +350,6 @@ public function confirmEulaAcceptance($hookName, $params) {
 			'plugins.generic.plagiarism.controllers.PlagiarismEulaAcceptanceHandler',
 			'handle',
 			null,
-			[
-				'submissionId' => $submission->getId(),
-			]
 		);
 
 		// As submitting user has not confrimed/accepted the EULA,
@@ -369,6 +366,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 		
 		$templateManager = TemplateManager::getManager();
 		$templateManager->assign([
+			'submissionId' => $submission->getId(),
 			'actionUrl' => $actionUrl,
 			'eulaAcceptanceMessage' => __('plugins.generic.plagiarism.submission.eula.acceptance.message', [
 				'localizedEulaUrl' => $eulaVersionDetails['url'],
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index 10e372e..4ca7a02 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -15,9 +15,30 @@
 
 import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import("plugins.generic.plagiarism.IThenticate");
+import('lib.pkp.classes.security.authorization.SubmissionAccessPolicy');
 
 class PlagiarismEulaAcceptanceHandler extends PlagiarismComponentHandler {
 
+	/**
+	 * @copydoc PKPHandler::__construct()
+	 */
+	public function __construct() {
+		parent::__construct();
+
+		$this->addRoleAssignment(
+			[ROLE_ID_AUTHOR, ROLE_ID_SITE_ADMIN, ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR],
+			['handle']
+		);
+	}
+
+	/**
+	 * @copydoc PKPHandler::authorize()
+	 */
+	public function authorize($request, &$args, $roleAssignments) {
+		$this->addPolicy(new SubmissionAccessPolicy($request, $args, $roleAssignments, 'submissionId'));
+		return parent::authorize($request, $args, $roleAssignments);
+	}
+
 	/**
 	 * Handle the presentation of iThenticate EULA right before the submission final stage
 	 *
@@ -30,16 +51,15 @@ public function handle($args, $request) {
 		$request = Application::get()->getRequest();
 		$context = $request->getContext();
 		$user = $request->getUser();
-		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
-		$submission = $submissionDao->getById($args['submissionId']);
-		$confirmSubmissionEula = $args['confirmSubmissionEula'] ?? false;
+		$submission = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION); /** @var Submission $submission */
+		$confirmSubmissionEula = $request->getUserVar('confirmSubmissionEula') ?? false;
 
 		if (!$confirmSubmissionEula) {
 			SessionManager::getManager()->getUserSession()->setSessionVar('confirmSubmissionEulaError', true);
 			return $this->redirectToUrl(
 				$request,
 				$context,
-				['submissionId' => $args['submissionId']]
+				['submissionId' => $submission->getId()]
 			);
 		}
 
@@ -48,7 +68,11 @@ public function handle($args, $request) {
 		static::$_plugin->stampEulaToSubmission($context, $submission);
 		static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
 
-		return $this->redirectToUrl($request, $context, ['submissionId' => $args['submissionId']]);
+		return $this->redirectToUrl(
+			$request,
+			$context, 
+			['submissionId' => $submission->getId()]
+		);
 	}
 
 	/**
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index c4cd4ea..0236ae7 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -21,6 +21,41 @@
 
 class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
 
+	/**
+	 * @copydoc PKPHandler::__construct()
+	 */
+	public function __construct() {
+		parent::__construct();
+
+		$this->addRoleAssignment(
+			[
+				ROLE_ID_MANAGER,
+				ROLE_ID_SUB_EDITOR,
+				ROLE_ID_ASSISTANT, 
+				ROLE_ID_SITE_ADMIN
+			],
+			[
+				'launchViewer',
+				'scheduleSimilarityReport',
+				'refreshSimilarityResult',
+				'submitSubmission',
+				'acceptEulaAndExecuteIntendedAction'
+			]
+		);
+	}
+
+	/**
+	 * @copydoc PlagiarismComponentHandler::authorize()
+	 */
+	public function authorize($request, &$args, $roleAssignments) {
+		$this->markRoleAssignmentsChecked();
+
+		import('lib.pkp.classes.security.authorization.SubmissionFileAccessPolicy');
+		$this->addPolicy(new SubmissionFileAccessPolicy($request, $args, $roleAssignments, SUBMISSION_FILE_ACCESS_READ, (int) $args['submissionFileId']));
+		
+		return parent::authorize($request, $args, $roleAssignments);
+	}
+
 	/**
 	 * Launch the iThenticate similarity report viewer
 	 *
@@ -30,9 +65,7 @@ class PlagiarismIthenticateActionHandler extends PlagiarismComponentHandler {
 	public function launchViewer($args, $request) {
 		$context = $request->getContext();
 		$user = $request->getUser();
-
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 		$siteDao = DAORegistry::getDAO("SiteDAO"); /** @var SiteDAO $siteDao */
@@ -84,9 +117,8 @@ public function scheduleSimilarityReport($args, $request) {
 
 		$context = $request->getContext();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 
 		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
@@ -129,9 +161,8 @@ public function scheduleSimilarityReport($args, $request) {
     public function refreshSimilarityResult($args, $request) {
 		$context = $request->getContext();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 
 		/** @var IThenticate $ithenticate */
 		$ithenticate = static::$_plugin->initIthenticate(
@@ -186,9 +217,7 @@ public function submitSubmission($args, $request) {
 		$context = $request->getContext();
 		$user = $request->getUser();
 
-		/** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']); /** @var SubmissionFile $submissionFile */
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId')); /** @var Submission $submission*/
 
@@ -240,8 +269,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 		$context = $request->getContext();
 		$user = $request->getUser();
 
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
@@ -287,8 +315,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 	public function confirmEula($args, $request) {
 		$context = $request->getContext();
 
-		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
-		$submissionFile = $submissionFileDao->getById($args['submissionFileId']);
+		$submissionFile = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION_FILE); /** @var SubmissionFile $submissionFile */
 		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
 		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
 
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index f6b9cc3..69b8bbc 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -167,6 +167,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 							'confirmEula',
 							null,
 							[
+								'stageId' => $request->getUserVar('stageId'),
+								'submissionId' => $submission->getId(),
 								'submissionFileId' => $submissionFile->getId(),
 								'onAcceptAction' => 'submitSubmission',
 							]
@@ -193,6 +195,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 						'submitSubmission',
 						null,
 						[
+							'stageId' => $request->getUserVar('stageId'),
+							'submissionId' => $submission->getId(),
 							'submissionFileId' => $submissionFile->getId(),
 						]
 					)
@@ -219,6 +223,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 						'scheduleSimilarityReport',
 						null,
 						[
+							'stageId' => $request->getUserVar('stageId'),
+							'submissionId' => $submission->getId(),
 							'submissionFileId' => $submissionFile->getId(),
 						]
 					)
@@ -244,6 +250,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 					'refreshSimilarityResult',
 					null,
 					[
+						'stageId' => $request->getUserVar('stageId'),
+						'submissionId' => $submission->getId(),
 						'submissionFileId' => $submissionFile->getId(),
 					]
 				)
@@ -271,6 +279,8 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 							'launchViewer',
 							null,
 							[
+								'stageId' => $request->getUserVar('stageId'),
+								'submissionId' => $submission->getId(),
 								'submissionFileId' => $submissionFile->getId(),
 							]
 						)
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
index 278a0c0..e01f5c7 100644
--- a/templates/confirmEula.tpl
+++ b/templates/confirmEula.tpl
@@ -55,29 +55,34 @@
 
     <p>{$eulaAcceptanceMessage}</p>
 	    
-    <div>
-        {fbvElement 
-            type="checkbox" 
-            name="confirmSubmissionEula" 
-            id="confirmSubmissionEula"
-            label="plugins.generic.plagiarism.submission.eula.acceptance.confirm" 
-            translate="true"
-            
-        }
-        
-        {if SessionManager::getManager()->getUserSession()->getSessionVar('confirmSubmissionEulaError')}
-            <span>
-                <label class="sub_label error">
-                    {translate key="plugins.generic.plagiarism.submission.eula.acceptance.error"}
-                </label>
-            </span>
-        {/if}
-    </div>
+    {fbvFormArea id="EulaConfirmationSection"}
+        {fbvFormSection}
+            <input type="hidden" name="submissionId" value="{$submissionId|escape}" />
+            <div>
+                {fbvElement 
+                    type="checkbox" 
+                    name="confirmSubmissionEula" 
+                    id="confirmSubmissionEula"
+                    label="plugins.generic.plagiarism.submission.eula.acceptance.confirm" 
+                    translate="true"
+                    
+                }
+                
+                {if SessionManager::getManager()->getUserSession()->getSessionVar('confirmSubmissionEulaError')}
+                    <span>
+                        <label class="sub_label error">
+                            {translate key="plugins.generic.plagiarism.submission.eula.acceptance.error"}
+                        </label>
+                    </span>
+                {/if}
+            </div>
     
-    {fbvFormButtons 
-        id="eulaConfirmationAcceptance"
-        submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"
-    }
+            {fbvFormButtons 
+                id="eulaConfirmationAcceptance"
+                submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"
+            }
+        {/fbvFormSection}
+	{/fbvFormArea}
 </form>
 
 <style>

From 874f558cd5347a8e9f7c27318b454d9ebc73ee87 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 21:29:34 +0600
Subject: [PATCH 45/75] pkp/plagiarism#52 fixed authorization policies to
 component route classes

---
 controllers/PlagiarismIthenticateActionHandler.inc.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 0236ae7..8a41ab4 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -39,7 +39,8 @@ public function __construct() {
 				'scheduleSimilarityReport',
 				'refreshSimilarityResult',
 				'submitSubmission',
-				'acceptEulaAndExecuteIntendedAction'
+				'acceptEulaAndExecuteIntendedAction',
+				'confirmEula',
 			]
 		);
 	}
@@ -367,12 +368,14 @@ protected function getEulaConfirmationTemplate($request, $args, $context, $submi
 			[
 				'version' => $eulaVersionDetails['version'],
 				'submissionFileId' => $submissionFile->getId(),
+				'stageId' => $request->getUserVar('stageId'),
 				'onAcceptAction' => $args['onAcceptAction'],
 			]
 		);
 
 		$templateManager = TemplateManager::getManager();
 		$templateManager->assign([
+			'submissionId' => $submission->getId(),
 			'actionUrl' => $actionUrl,
 			'eulaAcceptanceMessage' => __('plugins.generic.plagiarism.submission.eula.acceptance.message', [
 				'localizedEulaUrl' => $eulaVersionDetails['url'],

From 94b6424d63c6adc002dab22673c910c9726582c3 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 28 May 2024 22:52:12 +0600
Subject: [PATCH 46/75] pkp/plagiarism#52 mad auth policies OPS compatible

---
 ...PlagiarismIthenticateActionHandler.inc.php |  5 +---
 grids/SimilarityActionGridColumn.inc.php      | 26 ++++++++++++++-----
 2 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 8a41ab4..c6f0e04 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -302,9 +302,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 			static::$_plugin->stampEulaToSubmittingUser($context, $submission, $user);
 		}
 
-		$onAcceptAction = $args['onAcceptAction'];
-
-		return $this->{$onAcceptAction}($args, $request);
+		return $this->submitSubmission($args, $request);
 	}
 
 	/**
@@ -369,7 +367,6 @@ protected function getEulaConfirmationTemplate($request, $args, $context, $submi
 				'version' => $eulaVersionDetails['version'],
 				'submissionFileId' => $submissionFile->getId(),
 				'stageId' => $request->getUserVar('stageId'),
-				'onAcceptAction' => $args['onAcceptAction'],
 			]
 		);
 
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 69b8bbc..9b9641b 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -167,10 +167,9 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 							'confirmEula',
 							null,
 							[
-								'stageId' => $request->getUserVar('stageId'),
+								'stageId' => $this->getStageId($request),
 								'submissionId' => $submission->getId(),
 								'submissionFileId' => $submissionFile->getId(),
-								'onAcceptAction' => 'submitSubmission',
 							]
 						),
 						__('plugins.generic.plagiarism.similarity.action.confirmEula.title')
@@ -195,7 +194,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 						'submitSubmission',
 						null,
 						[
-							'stageId' => $request->getUserVar('stageId'),
+							'stageId' => $this->getStageId($request),
 							'submissionId' => $submission->getId(),
 							'submissionFileId' => $submissionFile->getId(),
 						]
@@ -223,7 +222,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 						'scheduleSimilarityReport',
 						null,
 						[
-							'stageId' => $request->getUserVar('stageId'),
+							'stageId' => $this->getStageId($request),
 							'submissionId' => $submission->getId(),
 							'submissionFileId' => $submissionFile->getId(),
 						]
@@ -250,7 +249,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 					'refreshSimilarityResult',
 					null,
 					[
-						'stageId' => $request->getUserVar('stageId'),
+						'stageId' => $this->getStageId($request),
 						'submissionId' => $submission->getId(),
 						'submissionFileId' => $submissionFile->getId(),
 					]
@@ -279,7 +278,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 							'launchViewer',
 							null,
 							[
-								'stageId' => $request->getUserVar('stageId'),
+								'stageId' => $this->getStageId($request),
 								'submissionId' => $submission->getId(),
 								'submissionFileId' => $submissionFile->getId(),
 							]
@@ -345,4 +344,19 @@ protected function isSubmissionFileTypeRestricted($submissionFile) {
 		return in_array($file->mimetype, $this->_plugin->uploadRestrictedArchiveMimeTypes);
 	}
 
+	/**
+	 * Get the proper workflow stage id for iThenticate actions
+	 *
+	 * @param Request $request
+	 * @return int
+	 */
+	protected function getStageId($request) {
+
+		if ($this->_plugin::isOPS()) {
+			return WORKFLOW_STAGE_ID_PRODUCTION;
+		}
+
+		return $request->getUserVar('stageId');
+	}
+
 }

From f0a326733091c640f9f83f763c70d47734ccbf63 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 29 May 2024 13:18:18 +0600
Subject: [PATCH 47/75] pkp/plagiarism#52 code indentation fixed

---
 PlagiarismPlugin.inc.php                      |  10 +-
 .../ValidatorIthenticateAccess.inc.php        |   6 +
 ...PlagiarismArticleGalleyGridHandler.inc.php |   6 +-
 .../PlagiarismEulaAcceptanceHandler.inc.php   |   4 +-
 ...PlagiarismIthenticateActionHandler.inc.php |   4 +-
 grids/RearrangeColumnsFeature.inc.php         |   2 +-
 grids/SimilarityActionGridColumn.inc.php      |  17 ++-
 templates/confirmEula.tpl                     | 126 +++++++++---------
 templates/similarityScore.tpl                 |   2 +-
 9 files changed, 93 insertions(+), 84 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index d830393..af5ea8a 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -3,8 +3,8 @@
 /**
  * @file PlagiarismPlugin.inc.php
  *
- * Copyright (c) 2003-2024 Simon Fraser University
- * Copyright (c) 2003-2024 John Willinsky
+ * Copyright (c) 2024 Simon Fraser University
+ * Copyright (c) 2024 John Willinsky
  * Distributed under the GNU GPL v3. For full terms see the file LICENSE.
  *
  * @brief Plagiarism plugin
@@ -73,9 +73,9 @@ class PlagiarismPlugin extends GenericPlugin {
 	 * 
 	 * @return bool
 	 */
-    public static function isOPS() {
-        return strtolower(Application::get()->getName()) === 'ops';
-    }
+	public static function isOPS() {
+		return strtolower(Application::get()->getName()) === 'ops';
+	}
 
 	/**
 	 * @copydoc Plugin::register()
diff --git a/classes/validation/ValidatorIthenticateAccess.inc.php b/classes/validation/ValidatorIthenticateAccess.inc.php
index 5e41ad6..2684f6a 100644
--- a/classes/validation/ValidatorIthenticateAccess.inc.php
+++ b/classes/validation/ValidatorIthenticateAccess.inc.php
@@ -26,10 +26,16 @@ class ValidatorIthenticateAccess extends Validator {
 	 */
 	protected $ithenticate;
 
+	/**
+	 * Constructor
+	 */
 	public function __construct($ithenticate) {
 		$this->ithenticate = $ithenticate;
 	}
 
+	/**
+	 * @copydoc Validator::isValid()
+	 */
 	public function isValid($value) {
 		return $this->ithenticate->validateAccess();
 	}
diff --git a/controllers/PlagiarismArticleGalleyGridHandler.inc.php b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
index 19f6b1e..d3eb3f0 100644
--- a/controllers/PlagiarismArticleGalleyGridHandler.inc.php
+++ b/controllers/PlagiarismArticleGalleyGridHandler.inc.php
@@ -18,7 +18,7 @@
 
 class PlagiarismArticleGalleyGridHandler extends ArticleGalleyGridHandler {
 
-    /** 
+	/** 
 	 * The Plagiarism Plugin itself
 	 * 
 	 * @var PlagiarismPlugin 
@@ -49,7 +49,7 @@ public static function setPlugin($plugin) {
 	public function initialize($request, $args = null) {
 		parent::initialize($request, $args);
 		
-        static::$_plugin->import('grids.SimilarityActionGridColumn');
-        $this->addColumn(new SimilarityActionGridColumn(static::$_plugin));
+		static::$_plugin->import('grids.SimilarityActionGridColumn');
+		$this->addColumn(new SimilarityActionGridColumn(static::$_plugin));
 	}
 }
diff --git a/controllers/PlagiarismEulaAcceptanceHandler.inc.php b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
index 4ca7a02..2c33028 100644
--- a/controllers/PlagiarismEulaAcceptanceHandler.inc.php
+++ b/controllers/PlagiarismEulaAcceptanceHandler.inc.php
@@ -79,8 +79,8 @@ public function handle($args, $request) {
 	 * Generate and get the redirection url
 	 *
 	 * @param Request $request
-     * @param Context $context
-     * @param array $args
+	 * @param Context $context
+	 * @param array $args
 	 * 
 	 * @return string
 	 */
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index c6f0e04..bbc31a0 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -114,7 +114,7 @@ public function launchViewer($args, $request) {
 	 * @param array $args
 	 * @param Request $request
 	 */
-    public function scheduleSimilarityReport($args, $request) {
+	public function scheduleSimilarityReport($args, $request) {
 
 		$context = $request->getContext();
 
@@ -159,7 +159,7 @@ public function scheduleSimilarityReport($args, $request) {
 	 * @param array $args
 	 * @param Request $request
 	 */
-    public function refreshSimilarityResult($args, $request) {
+	public function refreshSimilarityResult($args, $request) {
 		$context = $request->getContext();
 
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
diff --git a/grids/RearrangeColumnsFeature.inc.php b/grids/RearrangeColumnsFeature.inc.php
index 4a01b88..b2e6318 100644
--- a/grids/RearrangeColumnsFeature.inc.php
+++ b/grids/RearrangeColumnsFeature.inc.php
@@ -56,4 +56,4 @@ public function getGridDataElements($args) {
 		// set the first file name column as first column
 		reset($this->gridHandler->_columns)->addFlag('firstColumn', true);
 	}
-}
\ No newline at end of file
+}
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 9b9641b..6c03330 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -22,6 +22,9 @@
 
 class SimilarityActionGridColumn extends GridColumn {
 
+	/** 
+	 * The grid column id name where similarity score/action will be visible
+	 */
 	public const SIMILARITY_ACTION_GRID_COLUMN_ID = 'score';
 	
 	/** 
@@ -292,16 +295,16 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		return $cellActions;
 	}
 
-    /**
+	/**
 	 * Check for the requrement of EULA confirmation
 	 *
-     * @param Context       $context
-     * @param Submission    $submission
-     * @param User          $user
-     * 
-     * @return bool
+	 * @param Context       $context
+	 * @param Submission    $submission
+	 * @param User          $user
+	 * 
+	 * @return bool
 	 */
-    protected function isEulaConfirmationRequired($context, $submission, $user) {
+	protected function isEulaConfirmationRequired($context, $submission, $user) {
 
 		// Check if EULA confirmation required for this tenant
 		if ($this->_plugin->getContextEulaDetails($context, 'require_eula') == false) {
diff --git a/templates/confirmEula.tpl b/templates/confirmEula.tpl
index e01f5c7..449eced 100644
--- a/templates/confirmEula.tpl
+++ b/templates/confirmEula.tpl
@@ -8,85 +8,85 @@
  * Intermediate stage before final submission stage to view EULA
  *}
 <script type="text/javascript">
-    $(function() {ldelim}
+	$(function() {ldelim}
 
-        const isValidUrl = urlString => {
-            let url;
+		const isValidUrl = urlString => {
+			let url;
 
-            try { 
-                url = new URL(urlString); 
-            } catch(e) { 
-                return false; 
-            }
+			try { 
+				url = new URL(urlString); 
+			} catch(e) { 
+				return false; 
+			}
 
-            return url.protocol === "http:" || url.protocol === "https:";
+			return url.protocol === "http:" || url.protocol === "https:";
         }
         
-        let cancelWarningMessage = "{$cancelWarningMessage}" || undefined,
-            cancelRedirect = "{$cancelRedirect}" || undefined;
+		let cancelWarningMessage = "{$cancelWarningMessage}" || undefined,
+			cancelRedirect = "{$cancelRedirect}" || undefined;
 
-        
-        if (isValidUrl(cancelRedirect)) {
-            $('form#confirmEulaForm').on('click', 'a.cancelButton', function (event) {
-                if (cancelRedirect === 'modal') {
-                    return true;
-                }
-                event.preventDefault();
-                if (confirm(cancelWarningMessage) === true) {
-                    window.location.href = cancelRedirect;
-                }
-            });
-        } else {
-            // Attach the JS form handler.
-            $('#confirmEulaForm').pkpHandler('$.pkp.controllers.form.AjaxFormHandler');
-        }
-    {rdelim});
+		if (isValidUrl(cancelRedirect)) {
+			$('form#confirmEulaForm').on('click', 'a.cancelButton', function (event) {
+				if (cancelRedirect === 'modal') {
+					return true;
+				}
+
+				event.preventDefault();
+
+				if (confirm(cancelWarningMessage) === true) {
+					window.location.href = cancelRedirect;
+				}
+			});
+		} else {
+			// Attach the JS form handler.
+			$('#confirmEulaForm').pkpHandler('$.pkp.controllers.form.AjaxFormHandler');
+		}
+	{rdelim});
 </script>
 
 <form 
-    class="pkp_form" 
-    id="confirmEulaForm" 
-    method="post" 
-    action="{$actionUrl}"
+	class="pkp_form" 
+	id="confirmEulaForm" 
+	method="post" 
+	action="{$actionUrl}"
 >
-    {csrf}
- 
-    {include file="controllers/notification/inPlaceNotification.tpl" notificationId="submitStep4FormNotification"}
+	{csrf}
+
+	{include file="controllers/notification/inPlaceNotification.tpl" notificationId="submitStep4FormNotification"}
 
-    <p>{$eulaAcceptanceMessage}</p>
+	<p>{$eulaAcceptanceMessage}</p>
 	    
-    {fbvFormArea id="EulaConfirmationSection"}
-        {fbvFormSection}
-            <input type="hidden" name="submissionId" value="{$submissionId|escape}" />
-            <div>
-                {fbvElement 
-                    type="checkbox" 
-                    name="confirmSubmissionEula" 
-                    id="confirmSubmissionEula"
-                    label="plugins.generic.plagiarism.submission.eula.acceptance.confirm" 
-                    translate="true"
-                    
-                }
+	{fbvFormArea id="EulaConfirmationSection"}
+		{fbvFormSection}
+			<input type="hidden" name="submissionId" value="{$submissionId|escape}" />
+			<div>
+				{fbvElement 
+					type="checkbox" 
+					name="confirmSubmissionEula" 
+					id="confirmSubmissionEula"
+					label="plugins.generic.plagiarism.submission.eula.acceptance.confirm" 
+					translate="true"
+				}
                 
-                {if SessionManager::getManager()->getUserSession()->getSessionVar('confirmSubmissionEulaError')}
-                    <span>
-                        <label class="sub_label error">
-                            {translate key="plugins.generic.plagiarism.submission.eula.acceptance.error"}
-                        </label>
-                    </span>
-                {/if}
-            </div>
+				{if SessionManager::getManager()->getUserSession()->getSessionVar('confirmSubmissionEulaError')}
+					<span>
+						<label class="sub_label error">
+							{translate key="plugins.generic.plagiarism.submission.eula.acceptance.error"}
+						</label>
+					</span>
+				{/if}
+			</div>
     
-            {fbvFormButtons 
-                id="eulaConfirmationAcceptance"
-                submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"
-            }
-        {/fbvFormSection}
+			{fbvFormButtons 
+				id="eulaConfirmationAcceptance"
+				submitText="plugins.generic.plagiarism.submission.eula.accept.button.title"
+			}
+		{/fbvFormSection}
 	{/fbvFormArea}
 </form>
 
 <style>
-    .pkp_form li {
-        list-style: none;
-    }
+	.pkp_form li {
+		list-style: none;
+	}
 </style>
diff --git a/templates/similarityScore.tpl b/templates/similarityScore.tpl
index b5dfb79..21f370e 100644
--- a/templates/similarityScore.tpl
+++ b/templates/similarityScore.tpl
@@ -18,4 +18,4 @@
         font-weight: 550;
         font-size: 15px;
     }
-</style>
\ No newline at end of file
+</style>

From 0e4296dcd6530d9cd7717bd9f2977776a2eb5a3b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 31 May 2024 19:55:05 +0600
Subject: [PATCH 48/75] pkp/plagiarism#52 update translation and viewer launch
 settings

---
 IThenticate.inc.php                           |  2 +-
 PlagiarismPlugin.inc.php                      | 27 +++---
 README.md                                     | 59 +++++-------
 ...PlagiarismIthenticateActionHandler.inc.php | 30 +++---
 controllers/PlagiarismWebhookHandler.inc.php  | 73 +++++++++++++--
 grids/SimilarityActionGridColumn.inc.php      | 51 ++++-------
 locale/en_US/locale.po                        | 91 +++++++++++++------
 templates/similarityScore.tpl                 | 17 +++-
 8 files changed, 217 insertions(+), 133 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 425c32a..554e6c5 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -176,7 +176,7 @@ public function getEnabledFeature($feature = null) {
         if (!isset($result) && !$this->validateAccess($result)) {
             return $this->suppressApiRequestException
                 ? []
-                : throw new \Exception('unbale to validate access details');
+                : throw new \Exception('unable to validate access details');
         }
 
         if (!$feature) {
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index af5ea8a..7339a0a 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -388,7 +388,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 	 * The steps follows as:
 	 * 	- Check if proper service credentials(API Url and Key) are available
 	 *  - Register webhook for context if not already registered
-	 *  - Check for EULA confrimation requirement
+	 *  - Check for EULA confirmation requirement
 	 * 		- Check if EULA is stamped to submission
 	 * 			- if not stamped, not allowed to submit at iThenticate
 	 * 		- Check if EULA is stamped to submitting user
@@ -425,11 +425,6 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		$submission = $form->submission; /** @var Submission $submission */
 		$user = $request->getUser();
 
-		if (!static::isRunningInTestMode() && !$this->isServiceAccessAvailable($context)) {
-			$this->sendErrorMessage("ithenticate service access not set for context id {$context->getId()}", $submission->getId());
-			return false;
-		}
-
 		$ithenticate = $this->initIthenticate(...$this->getServiceAccess($context)); /** @var IThenticate $ithenticate */
 
 		// If no webhook previously registered for this Context, register it
@@ -443,7 +438,7 @@ public function submitForPlagiarismCheck($hookName, $args) {
 		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
 			// not going to sent it for plagiarism check if EULA not stamped to submission or submitter
 			if (!$submission->getData('ithenticateEulaVersion') || !$user->getData('ithenticateEulaVersion')) {
-				$this->sendErrorMessage('Unable to obtain the stamped EULA details to submission or submitter', $submission->getId());
+				$this->sendErrorMessage(__('plugins.generic.plagiarism.stamped.eula.missing'), $submission->getId());
 				return false;
 			}
 		}
@@ -460,7 +455,8 @@ public function submitForPlagiarismCheck($hookName, $args) {
 				}
 			}
 		} catch (\Throwable $exception) {
-			$this->sendErrorMessage($exception->getMessage(), $submission->getId());
+			error_log('submit for plagiarism check failed with excaption ' . $exception->__toString());
+			$this->sendErrorMessage(__('plugins.generic.plagiarism.ithenticate.upload.complete.failed'), $submission->getId());
 			return false;
 		}
 
@@ -596,7 +592,12 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 		);
 
 		if (!$submissionUuid) {
-			$this->sendErrorMessage("Could not create the submission at iThenticate for file id {$submissionFile->getId()}", $submission->getId());
+			$this->sendErrorMessage(
+				__('plugins.generic.plagiarism.ithenticate.submission.create.failed', [
+					'submissionFileId' => $submissionFile->getId(),
+				]), 
+				$submission->getId()
+			);
 			return false;
 		}
 
@@ -604,7 +605,6 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 		$file = $pkpFileService->get($submissionFile->getData('fileId'));
 
 		if (in_array($file->mimetype, $this->uploadRestrictedArchiveMimeTypes)) {
-			error_log("plagiarism check for file mime type : {$file->mimetype} with submission file id : {$submissionFile->getId()} and submission id : {$submission->getId()} is not allowed");
 			return true;
 		}
 
@@ -616,7 +616,12 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 
 		// Upload submission files for successfully created submission at iThenticate's end
 		if (!$uploadStatus) {
-			$this->sendErrorMessage('Could not complete the file upload at iThenticate for file id ' . $submissionFile->getData("name", $publication->getData("locale")), $submission->getId());
+			$this->sendErrorMessage(
+				__('plugins.generic.plagiarism.ithenticate.file.upload.failed', [
+					'submissionFileId' => $submissionFile->getId(),
+				]), 
+				$submission->getId()
+			);
 			return false;
 		}
 
diff --git a/README.md b/README.md
index 802ee5c..d6876df 100644
--- a/README.md
+++ b/README.md
@@ -5,21 +5,21 @@ For OJS/OMP/OPS 3.x
 ## Overview
 
 This plugin permits automatic submission of uploaded manuscripts to the [iThenticate service](http://www.ithenticate.com/) for plagiarism checking.
-1. You need an account of ithenticate.com (costs involved)
+1. You need an account on ithenticate.com (costs involved)
    * paid via Crossref Similarity Check
    * or, paid directly to iThenticate
-2. Install the plugin via the Plugin Gallery in the Dashboard
+2. Install the plugin via the Plugin Gallery
 3. Configure the plugin (see below)
    * Enable the plugin via config.inc.php or in a specific journal/press/preprint context
    * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com
    * ![Example Settings configuration](images/ithenticate-settings.png)
 4. The author logs in and makes a submission
-   * At the Step 4 of submission process, submitting user must need to confirm the iThenticate's End User License Agreement to complete the submission.
-   * The submission files will be sent to iThenticate in Step 4 of the submission process
-5. The Editor logs in to OJS/OMP/OPS installation, go to the submission list and open the workflow stage for the submission
-   * In the submission files grid view, Editor/Journal Manager can see the similarity scores if the similarity process has completed.
-   * Editor/Journal Manager can also launch the iThenticate's similarity viewer as an additional action.
-6. In addition to all of above, if the auto upload to iThenticate is disable, Editor/Journal Manager and upload each of submission file one by one from the workflow stage.
+   * At Step 4 of the submission process, submitting user must confirm iThenticate's End User License Agreement to complete the submission.
+   * The submission files will be sent to iThenticate in Step 4 of the submission process.
+5. The Editor logs in to OJS/OMP/OPS installation and opens the Submission workflow page.
+   * In the submission files grid view, the Editor can see the similarity scores if the similarity process has completed.
+   * The Editor can also launch iThenticate's similarity viewer.
+6. If auto upload to iThenticate is disabled, the Editor can send each submission file to iThenticate from the workflow stage.
 
 ## Similarity Check Settings
 
@@ -27,17 +27,17 @@ There are several iThenticate similarity check settings that can be configured v
 1. Similarity Check Options
    * `addToIndex` -- The submission will be added to all valid node groups for future matching
    * `excludeQuotes` -- Text in quotes of the submission will not count as similar content
-   * `excludeBibliography` -- Text in a bibliography sectionm of the submission will not count as similar content
+   * `excludeBibliography` -- Text in a bibliography section of the submission will not count as similar content
    * `excludeAbstract` -- Text in the abstract section of the submission will not count as similar content
    * `excludeMethods` -- Text in the method section of the submission will not count as similar content
    * `excludeCitations` -- The citations of the submission will be excuded from similarity check
-   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content
+   * `excludeSmallMatches` -- Similarity matches that match less than the specified number of words will not count as similar content
    * ![Available Similarity Check Options](images/similarity-check-settings.png)
-2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file . To configures, the settings parameter name need to be used which are `addToIndex`, `excludeQuotes`, `excludeBibliography`, `excludeAbstract`, `excludeMethods`, `excludeCitations` and `excludeSmallMatches`, 
+2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file.
 
 ## Configuration
 
-You may set the credentials in config.inc.php, or you may set the credentials per-journal in the plugin settings.  If credentials are present in config.inc.php, they will override those entered in the plugin settings form.
+You may set the credentials in config.inc.php, or you may set the credentials per journal/press/server in the plugin settings.  If credentials are present in config.inc.php, they will override those entered in the plugin settings form.
 
 The config.inc.php settings format is:
 
@@ -48,38 +48,29 @@ The config.inc.php settings format is:
 
 [ithenticate]
 
-; Enable iThenticate to upload submission files at the final stage or later manually 
+; Enable iThenticate to upload submission files for plagiarism checking.
 ; if auto upload to iThenticate disable globally or Journal/Server/Press level
 ; ithenticate = On
 
-; Credentials can be set by context : specify Journal/Server/Press path
-; Unique turnitin api url
-; api_url[Journal_or_Server_or_Press_path] = ""
-; The API key to authorize the api calls
-; api_key[Journal_or_Server_or_Press_path] = ""
-
-; Unique ithenticate api url
-; Make sure to provide the schema(http:// or https://) with the url and no trailing slash
+; Global iThenticate API URL
 ; api_url = "https://some-ithenticate-account.com"
 
-; The API key to authorize the api calls
+; Global iThenticate API key
 ; api_key = "YOUR_API_KEY"
 
-; To disable auto upload of submisison files to iThenticate service, uncomment following line
+; If desired, credentials can also be set by context by specifying each Journal/Server/Press path.
+; api_url[Journal_or_Server_or_Press_path] = "https://some-ithenticate-account.com"
+; api_key[Journal_or_Server_or_Press_path] = "YOUR_API_KEY"
+
+; To globally disable auto upload of submission files to iThenticate service, uncomment following line.
 ; disableAutoSubmission = On
-; It is possible to disable auto upload at specific Journal/Server/Press level rathar than globally
+; It is possible to disable auto upload at specific Journal/Server/Press level rather than globally
 ; disableAutoSubmission[Journal_or_Server_or_Press_path] = On
 
-
-; Submission similarity check settings can also configured as global or journel level
-; To set a similarity check config on global level, just set the setting value as
-; addToIndex = On
-; To set a similarity check config on journale level, just set the setting value as
-; addToIndex[MyJournal_path] = On
-; See the README.md of plugin to see all possible similarity config settings
+; Other settings can be configured here; see README.md for all options.
 ```
 
 ## Restrictions
-1. Submission submitting user must confirm the iThenticate End User License Agreement to sent files to iThenticate service for plagiarism checking.
-2. zip/tar/gzip will not be upload to iThenticate service for plagiarism checking.
-3. Uploading of file size more that 100 MB will cause failure as per iThenticate's restriction.
\ No newline at end of file
+1. The submitting user must confirm the iThenticate End User License Agreement to send files to iThenticate service for plagiarism checking.
+2. zip/tar/gzip files will not be uploaded to iThenticate.
+3. Uploading files larger than 100 MB will cause failure as per iThenticate limits.
\ No newline at end of file
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index bbc31a0..f5eaf14 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -132,12 +132,10 @@ public function scheduleSimilarityReport($args, $request) {
 		);
 
 		if (!$scheduleSimilarityReport) {
-			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
-			$this->generateUserNotification(
-				$request,
-				NOTIFICATION_TYPE_ERROR, 
-				__('plugins.generic.plagiarism.action.scheduleSimilarityReport.error')
-			);
+			$message = __('plugins.generic.plagiarism.webhook.similarity.schedule.failure', [
+				'submissionFileId' => $submissionFile->getId(),
+			]);
+			$this->generateUserNotification($request, NOTIFICATION_TYPE_ERROR, $message);
 			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
@@ -175,24 +173,20 @@ public function refreshSimilarityResult($args, $request) {
 		);
 
 		if (!$similarityScoreResult) {
-			static::$_plugin->sendErrorMessage("Unable to retrieve similarity result for submission file id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
-			$this->generateUserNotification(
-				$request,
-				NOTIFICATION_TYPE_ERROR, 
-				__('plugins.generic.plagiarism.action.refreshSimilarityResult.error')
-			);
+			$message = __('plugins.generic.plagiarism.action.refreshSimilarityResult.error', [
+				'submissionFileId' => $submissionFile->getId(),
+			]);
+			$this->generateUserNotification($request, NOTIFICATION_TYPE_ERROR, $message);
 			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
 		$similarityScoreResult = json_decode($similarityScoreResult);
 
 		if ($similarityScoreResult->status !== 'COMPLETE') {
-			static::$_plugin->sendErrorMessage("Similarity result info not yet complete for submission file id " . $submissionFile->getData('ithenticateId'), $submissionFile->getData('submissionId'));
-			$this->generateUserNotification(
-				$request,
-				NOTIFICATION_TYPE_WARNING, 
-				__('plugins.generic.plagiarism.action.refreshSimilarityResult.warning')
-			);
+			$message = __('plugins.generic.plagiarism.action.refreshSimilarityResult.warning', [
+				'submissionFileId' => $submissionFile->getId(),
+			]);
+			$this->generateUserNotification($request, NOTIFICATION_TYPE_WARNING, $message);
 			return $this->triggerDataChangedEvent($submissionFile);
 		}
 
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index d61e30a..ff1c86f 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -41,22 +41,26 @@ public function handle() {
 		$payload = file_get_contents('php://input');
 
 		if (!$context->getData('ithenticateWebhookId') || !$context->getData('ithenticateWebhookSigningSecret')) {
-			static::$_plugin->sendErrorMessage("iThenticate webhook not configured for context id {$context->getId()}");
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.configuration.missing', [
+				'contextId' => $context->getId(),
+			]));
 			return;
 		}
 
 		if (!$headers->has(['x-turnitin-eventtype', 'x-turnitin-signature'])) {
-			static::$_plugin->sendErrorMessage('Missing required iThenticate webhook headers');
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.headers.missing'));
 			return;
 		}
 		
 		if (!in_array($headers->get('x-turnitin-eventtype'), IThenticate::DEFAULT_WEBHOOK_EVENTS)) {
-			static::$_plugin->sendErrorMessage("Invalid iThenticate webhook event type {$headers->get('x-turnitin-eventtype')}");
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.event.invalid', [
+				'event' => $headers->get('x-turnitin-eventtype'),
+			]));
 			return;
 		}
 
 		if ($headers->get('x-turnitin-signature') !== hash_hmac("sha256", $payload, $context->getData('ithenticateWebhookSigningSecret'))) {
-			static::$_plugin->sendErrorMessage('Invalid iThenticate webhook signature');
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.signature.invalid'));
 			return;
 		}
 		
@@ -89,7 +93,10 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 		$ithenticateSubmission = $this->getIthenticateSubmission($payload->id);
 
 		if (!$ithenticateSubmission) {
-			static::$_plugin->sendErrorMessage("Invalid iThenticate submission id {$payload->id} given for webhook event {$event}");
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.submissionId.invalid', [
+				'submissionUuid' => $payload->id,
+				'event' => $event,
+			]));
 			return;
 		}
 
@@ -97,17 +104,33 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
 
+		if (!$this->verifySubmissionFileAssociationWithContext($context, $submissionFile)) {
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.submissionFileAssociationWithContext.invalid', [
+				'submissionFileId' => $submissionFile->getId(),
+				'contextId' => $context->getId(),
+			]));
+			return;
+		}
+
 		if ($payload->status !== 'COMPLETE') {
 			// If the status not `COMPLETE`, then it's `ERROR`
 			static::$_plugin->sendErrorMessage(
-				"Unable to schedule the similarity report generation for file id {$submissionFile->getId()} with error : " . __("plugins.generic.plagiarism.ithenticate.submission.error.{$payload->error_code}"),
+				__('plugins.generic.plagiarism.webhook.similarity.schedule.error', [
+					'submissionFileId' => $submissionFile->getId(),
+					'error' => __("plugins.generic.plagiarism.ithenticate.submission.error.{$payload->error_code}"),
+				]),
 				$submissionFile->getData('submissionId')
 			);
 			return;
 		}
 		
 		if ((int)$submissionFile->getData('ithenticateSimilarityScheduled')) {
-			static::$_plugin->sendErrorMessage("Similarity report generation process has already been scheduled for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
+			static::$_plugin->sendErrorMessage(
+				__('plugins.generic.plagiarism.webhook.similarity.schedule.previously', [
+					'submissionFileId' => $submissionFile->getId(),
+				]),
+				$submissionFile->getData('submissionId')
+			);
 			return;
 		}
 		
@@ -120,7 +143,12 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 		);
 
 		if (!$scheduleSimilarityReport) {
-			static::$_plugin->sendErrorMessage("Failed to schedule the similarity report generation process for iThenticate submission id {$payload->id}", $submissionFile->getData('submissionId'));
+			static::$_plugin->sendErrorMessage(
+				__('plugins.generic.plagiarism.webhook.similarity.schedule.failure', [
+					'submissionFileId' => $submissionFile->getId(),
+				]),
+				$submissionFile->getData('submissionId')
+			);
 			return;
 		}
 
@@ -149,17 +177,44 @@ protected function storeSimilarityScore($context, $payload, $event) {
 		$ithenticateSubmission = $this->getIthenticateSubmission($payload->submission_id);
 
 		if (!$ithenticateSubmission) {
-			static::$_plugin->sendErrorMessage("Invalid iThenticate submission id {$payload->submission_id} given for webhook event {$event}");
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.submissionId.invalid', [
+				'submissionUuid' => $payload->submission_id,
+				'event' => $event,
+			]));
 			return;
 		}
 
 		/** @var SubmissionFileDAO $submissionFileDao */
 		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO');
 		$submissionFile = $submissionFileDao->getById($ithenticateSubmission->submission_file_id);
+
+		if (!$this->verifySubmissionFileAssociationWithContext($context, $submissionFile)) {
+			static::$_plugin->sendErrorMessage(__('plugins.generic.plagiarism.webhook.submissionFileAssociationWithContext.invalid', [
+				'submissionFileId' => $submissionFile->getId(),
+				'contextId' => $context->getId(),
+			]));
+			return;
+		}
+
 		$submissionFile->setData('ithenticateSimilarityResult', json_encode($payload));
 		$submissionFileDao->updateObject($submissionFile);
 	}
 
+	/**
+	 * Verify if the given submission file is associated with current running/set context
+	 * 
+	 * @param Context $context
+	 * @param SubmissionFile $submissionFile
+	 * 
+	 * @return bool
+	 */
+	protected function verifySubmissionFileAssociationWithContext($context, $submissionFile) {
+		$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /** @var SubmissionDAO $submissionDao */
+		$submission = $submissionDao->getById($submissionFile->getData('submissionId'));
+
+		return (int) $submission->getData('contextId') === (int) $context->getId();
+	}
+
 	/**
 	 * Get the row data as object from submission file settings table or null if none found
 	 * 
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 6c03330..072fb57 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -39,7 +39,7 @@ class SimilarityActionGridColumn extends GridColumn {
 	 *
 	 * @param PlagiarismPlugin  $plugin The Plagiarism Plugin itself
 	 */
-    public function __construct($plugin) {
+	public function __construct($plugin) {
 
 		$this->_plugin = $plugin;
 
@@ -61,11 +61,12 @@ public function __construct($plugin) {
 	 * @copydoc ColumnBasedGridCellProvider::getTemplateVarsFromRowColumn()
 	 */
 	public function getTemplateVarsFromRow($row) {
-
+		$request = Application::get()->getRequest();
+		
 		if ($this->_plugin::isOPS()) { // For OPS
 			$articleGalley = $row->getData(); /** @var ArticleGalley $articleGalley */
 			
-			if (!isset($articleGalley->_data['submissionFileId'])) {
+			if (!$articleGalley->getData('submissionFileId')) {
 				return ['label' => ''];
 			}
 
@@ -98,6 +99,19 @@ public function getTemplateVarsFromRow($row) {
 			$templateManager->assign([
 				'logoUrl' => $this->_plugin->getIThenticateLogoUrl(),
 				'score' => $similarityResult->overall_match_percentage,
+				'viewerUrl' => $request->getDispatcher()->url(
+					$request,
+					ROUTE_COMPONENT,
+					$request->getContext()->getData('urlPath'),
+					'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
+					'launchViewer',
+					null,
+					[
+						'stageId' => $this->getStageId($request),
+						'submissionId' => $submissionFile->getData('submissionId'),
+						'submissionFileId' => $submissionFile->getId(),
+					]
+				)
 			]);
 
             return [
@@ -131,7 +145,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 		if ($this->_plugin::isOPS()) { // For OPS
 			$articleGalley = $row->getData(); /** @var ArticleGalley $articleGalley */
 
-			if (!isset($articleGalley->_data['submissionFileId'])) {
+			if (!$articleGalley->getData('submissionFileId')) {
 				return $cellActions;
 			}
 
@@ -231,7 +245,7 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 						]
 					)
 				),
-				__('plugins.generic.plagiarism.similarity.action.generateReport.title')
+				__('plugins.generic.plagiarism.similarity.action.generateReport.title'),
 			);
 
 			return $cellActions;
@@ -261,37 +275,12 @@ public function getCellActions($request, $row, $position = GRID_ACTION_POSITION_
 			__('plugins.generic.plagiarism.similarity.action.refreshReport.title')
 		);
 
-		// If similarity score not availabel
+		// If similarity score not available
 		// show as cell action and upon it's available, show it as part of row action
 		$submissionFile->getData('ithenticateSimilarityResult')
 			? $row->addAction($similarityResultRefreshAction)
 			: array_push($cellActions, $similarityResultRefreshAction);
 
-		// Similarity viewer only available upon the availability of similarity report is 
-		if ($submissionFile->getData('ithenticateSimilarityResult')) {
-			$row->addAction(
-				new LinkAction(
-					"plagiarism-similarity-launch-viewer-{$submissionFile->getId()}",
-					new OpenWindowAction(
-						$request->getDispatcher()->url(
-							$request,
-							ROUTE_COMPONENT,
-							$context->getData('urlPath'),
-							'plugins.generic.plagiarism.controllers.PlagiarismIthenticateActionHandler',
-							'launchViewer',
-							null,
-							[
-								'stageId' => $this->getStageId($request),
-								'submissionId' => $submission->getId(),
-								'submissionFileId' => $submissionFile->getId(),
-							]
-						)
-					),
-					__('plugins.generic.plagiarism.similarity.action.launch.viewer.title')
-				)
-			);
-		}
-
 		return $cellActions;
 	}
 
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index bd76aa9..4d38190 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -30,7 +30,7 @@ msgid "plugins.generic.plagiarism.manager.settings.apiUrl"
 msgstr "iThenticate API URL"
 
 msgid "plugins.generic.plagiarism.manager.settings.apiKey"
-msgstr "iThenticate API KEY"
+msgstr "iThenticate API key"
 
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlRequired"
 msgstr "iThenticate API URL is required"
@@ -39,20 +39,20 @@ msgid "plugins.generic.plagiarism.manager.settings.disableAutoSubmission"
 msgstr "Disable auto upload of submission files to iThenticate at submission time"
 
 msgid "plugins.generic.plagiarism.manager.settings.disableAutoSubmission.description"
-msgstr "By disabling auto upload to iThenticate, submission need to manually upload from workflow section"
+msgstr "If auto upload to iThenticate is disabled, submission files need to be sent manually from submission workflow"
 
 msgid "plugins.generic.plagiarism.manager.settings.apiUrlInvalid"
 msgstr ""
-"The specified URL is not valid. Please double-check the URL and try again. "
+"The specified API URL is not valid. Please double-check the URL and try again. "
 "(Hint: Try adding http:// to the beginning of the URL.)"
 
 msgid "plugins.generic.plagiarism.manager.settings.apiKeyRequired"
-msgstr "iThenticate API KEY is required"
+msgstr "The iThenticate API key is required"
 
 msgid "plugins.generic.plagiarism.manager.settings.serviceAccessInvalid"
 msgstr ""
-"The specified API URL/KEY is invalid and can not establish connection to iThenticate API service."
-"Please double-check the API URL/KEY and try again."
+"The specified API URL/key is invalid or a connection to iThenticate API service cannot be established."
+"Please double-check the API URL/key and try again."
 
 msgid "plugins.generic.plagiarism.manager.settings.areForced"
 msgstr "iThenticate settings were found in config.inc.php and the settings here will not be used."
@@ -67,16 +67,16 @@ msgid "plugins.generic.plagiarism.ithenticate.submission.error.PROCESSING_ERROR"
 msgstr "An unspecified error occurred while processing the submissions."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.CANNOT_EXTRACT_TEXT"
-msgstr "The submission does not contain text to generate a Similarity Report or the word count of the submissions is 0 ."
+msgstr "The submission does not contain text to generate a Similarity Report or the word count of the submission is 0."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_LITTLE_TEXT"
-msgstr "The submission does not have enough text to generate a Similarity Report (a submission must contain at least 20 words)."
+msgstr "The submission does not have enough text to generate a Similarity Report. A submission must contain at least 20 words."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_MUCH_TEXT"
-msgstr "The submission has too much text to generate a Similarity Report (after extracted text is converted to UTF-8, the submission must contain less than 2MB of text)."
+msgstr "The submission has too much text to generate a Similarity Report. After extracted text is converted to UTF-8, the submission must contain less than 2MB of text."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.TOO_MANY_PAGES"
-msgstr "The submission has too many pages to generate a Similarity Report (a submission cannot contain more than 800 pages)."
+msgstr "The submission has too many pages to generate a Similarity Report. A submission cannot contain more than 800 pages."
 
 msgid "plugins.generic.plagiarism.ithenticate.submission.error.FILE_LOCKED"
 msgstr "The uploaded file requires a password in order to be opened."
@@ -85,7 +85,7 @@ msgid "plugins.generic.plagiarism.ithenticate.submission.error.CORRUPT_FILE"
 msgstr "The uploaded file appears to be corrupt."
 
 msgid "plugins.generic.plagiarism.general.errorMessage"
-msgstr "Request processing error : {$errorMessage}"
+msgstr "Request processing error: {$errorMessage}"
 
 msgid "plugins.generic.plagiarism.submission.checklist.eula"
 msgstr "iThenticate EULA <a target=\"_blank\" href=\"{$localizedEulaUrl}\">link</a>"
@@ -97,7 +97,7 @@ msgid "plugins.generic.plagiarism.submission.eula.acceptance.confirm"
 msgstr "I have read the end user license agreement and accept it."
 
 msgid "plugins.generic.plagiarism.submission.eula.acceptance.error"
-msgstr "Must need to confirm and accept the EULA."
+msgstr "The EULA must be confirmed before continuing."
 
 msgid "plugins.generic.plagiarism.submission.eula.accept.button.title"
 msgstr "Confirm and Continue"
@@ -106,16 +106,16 @@ msgid "plugins.generic.plagiarism.similarityCheck.settings.title"
 msgstr "Submission similarity check settings"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.warning.note"
-msgstr "Note that if any of the following setting set in the config file at global or journal level, that will take precedence over what set here."
+msgstr "Note that if any of the following settings are set in the configuration file at the global or journal/server/press level, those settings will take precedence over this form."
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.addToIndex"
-msgstr "The submission will be added to all valid node groups for future matching"
+msgstr "Submissions will be indexed in the accounts repository and will be available for comparison in Similarity Reports by other users within your organization"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeQuotes"
 msgstr "Text in quotes of the submission will not count as similar content"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeBibliography"
-msgstr "Text in a bibliography sectionm of the submission will not count as similar content"
+msgstr "Text in a bibliography section of the submission will not count as similar content"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract"
 msgstr "Text in the abstract section of the submission will not count as similar content"
@@ -124,7 +124,7 @@ msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods"
 msgstr "Text in the method section of the submission will not count as similar content"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations"
-msgstr "The citations of the submission will be excuded from similarity check"
+msgstr "The citations of the submission will be excluded from similarity check"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.label"
 msgstr "Exclude small match count"
@@ -133,7 +133,7 @@ msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMat
 msgstr "Similarity matches that match less than the specified amount of words will not count as similar content"
 
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate"
-msgstr "Allow changes in the similarity viewer to update the similarity score"
+msgstr "Changes made in reports will be saved for the next time the report is viewed"
 
 msgid "plugins.generic.plagiarism.similarity.action.column.score.title"
 msgstr "Plagiarism Score/Action"
@@ -141,6 +141,9 @@ msgstr "Plagiarism Score/Action"
 msgid "plugins.generic.plagiarism.similarity.action.launch.viewer.title"
 msgstr "Launch Plagiarism Similarity Viewer"
 
+msgid "plugins.generic.plagiarism.similarity.match.title"
+msgstr "Similarity Match"
+
 msgid "plugins.generic.plagiarism.similarity.score.column.overall_match_percentage"
 msgstr "Overall Match Percentage"
 
@@ -154,7 +157,7 @@ msgid "plugins.generic.plagiarism.similarity.action.refreshReport.title"
 msgstr "Refresh Plagiarism Similarity Score"
 
 msgid "plugins.generic.plagiarism.similarity.action.refreshReport.confirmation"
-msgstr "Are you sure you want to refresh Plagiarism similarity score?"
+msgstr "Are you sure you want to refresh the Plagiarism similarity score?"
 
 msgid "plugins.generic.plagiarism.similarity.action.submitforPlagiarismCheck.title"
 msgstr "Conduct Plagiarism Check"
@@ -166,28 +169,64 @@ msgid "plugins.generic.plagiarism.similarity.action.confirmEula.title"
 msgstr "Plagiarism End User License Agreement Confirmation"
 
 msgid "plugins.generic.plagiarism.similarity.action.invalidFileType"
-msgstr "plagiarism actions Not available"
-
-msgid "plugins.generic.plagiarism.action.scheduleSimilarityReport.error"
-msgstr "Unable to schedule the iThenticate similarity report generation process."
+msgstr "Plagiarism checking not available"
 
 msgid "plugins.generic.plagiarism.action.scheduleSimilarityReport.success"
-msgstr "Successfully schedule the iThenticate similarity report generation process."
+msgstr "Successfully scheduled the iThenticate similarity report generation process."
 
 msgid "plugins.generic.plagiarism.action.launchViewer.error"
 msgstr "Report viewer not currently available, please try again later."
 
 msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.error"
-msgstr "Unable to refresh iThenticate similarity score."
+msgstr "Unable to refresh iThenticate similarity score for submission file id : {$submissionFileId}."
 
 msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.warning"
-msgstr "The iThenticate similarity score has not yet completed."
+msgstr "The iThenticate similarity report has not yet completed for submission file id : {$submissionFileId}."
 
 msgid "plugins.generic.plagiarism.action.refreshSimilarityResult.success"
 msgstr "Successfully refreshed and updated the iThenticate similarity scores."
 
 msgid "plugins.generic.plagiarism.action.submitSubmission.error"
-msgstr "Unable to upload the submission file to iThenticate. Note that submission file size must be more than 0 MB and less or equal to 100 MB."
+msgstr "Unable to upload the submission file to iThenticate. Note that submission file size must be at most 100 MB."
 
 msgid "plugins.generic.plagiarism.action.submitSubmission.success"
 msgstr "Successfully uploaded the submission file to iThenticate."
+
+msgid "plugins.generic.plagiarism.webhook.configuration.missing"
+msgstr "iThenticate webhook not configured for context id {$contextId} ."
+
+msgid "plugins.generic.plagiarism.webhook.headers.missing"
+msgstr "Missing required iThenticate webhook headers"
+
+msgid "plugins.generic.plagiarism.webhook.event.invalid"
+msgstr "Invalid iThenticate webhook event type {$event}"
+
+msgid "plugins.generic.plagiarism.webhook.signature.invalid"
+msgstr "Invalid iThenticate webhook signature"
+
+msgid "plugins.generic.plagiarism.webhook.submissionId.invalid"
+msgstr "Invalid iThenticate submission id {$submissionUuid} given for webhook event {$event}"
+
+msgid "plugins.generic.plagiarism.webhook.submissionFileAssociationWithContext.invalid"
+msgstr "The given submission file id : {$submissionFileId} does not exists for context id : {$contextId}"
+
+msgid "plugins.generic.plagiarism.webhook.similarity.schedule.error"
+msgstr "Unable to schedule the similarity report generation for file id {$submissionFileId} with error : {$error}"
+
+msgid "plugins.generic.plagiarism.webhook.similarity.schedule.previously"
+msgstr "Similarity report generation process has already been scheduled for submission file id {$submissionFileId}"
+
+msgid "plugins.generic.plagiarism.webhook.similarity.schedule.failure"
+msgstr "Failed to schedule the similarity report generation process for submission file id {$submissionFileId}"
+
+msgid "plugins.generic.plagiarism.stamped.eula.missing"
+msgstr "The stamped EULA inforamtion is missing for the submission or submitting user."
+
+msgid "plugins.generic.plagiarism.ithenticate.upload.complete.failed"
+msgstr "Unable to complete the uploading of all files at iThenticate service for plagiarism check."
+
+msgid "plugins.generic.plagiarism.ithenticate.submission.create.failed"
+msgstr "Could not create the submission at iThenticate for submission file id : {$submissionFileId}"
+
+msgid "plugins.generic.plagiarism.ithenticate.file.upload.failed"
+msgstr "Could not complete the file upload at iThenticate for submission file id  : {$submissionFileId}"
diff --git a/templates/similarityScore.tpl b/templates/similarityScore.tpl
index 21f370e..31ed882 100644
--- a/templates/similarityScore.tpl
+++ b/templates/similarityScore.tpl
@@ -1,6 +1,15 @@
 <span class="plagiarism-similarity-score">
-    <img src="{$logoUrl}">
-    <span> : {$score}%</span>
+    <a
+        target="_blank"
+        href="{$viewerUrl}"
+        title="{translate key="plugins.generic.plagiarism.similarity.action.launch.viewer.title"}"
+    >
+        <img 
+            src="{$logoUrl}"
+            alt="{translate key="plugins.generic.plagiarism.similarity.match.title"}"
+        />
+    </a>
+    <span>{$score}%</span>
 </span>
 
 <style>
@@ -14,8 +23,10 @@
     }
 
     span.plagiarism-similarity-score span {
-        padding-left: 5px;
+        padding-left: 10px;
+        padding-bottom: 5px;
         font-weight: 550;
         font-size: 15px;
+        color: #006798;
     }
 </style>

From 8ad108dde3bbfdf62ce94ba6f20a8b55c51bd58b Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 31 May 2024 23:12:00 +0600
Subject: [PATCH 49/75] pkp/plagiarism#52 updated readme and similarity
 settings screenshot

---
 README.md                            |   7 ++++---
 images/similarity-check-settings.png | Bin 35473 -> 38797 bytes
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index d6876df..9edff55 100644
--- a/README.md
+++ b/README.md
@@ -25,13 +25,14 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
 
 There are several iThenticate similarity check settings that can be configured via the plugin.
 1. Similarity Check Options
-   * `addToIndex` -- The submission will be added to all valid node groups for future matching
+   * `addToIndex` -- Submissions will be indexed in the accounts repository and will be available for comparison in Similarity Reports by other users within your organization
    * `excludeQuotes` -- Text in quotes of the submission will not count as similar content
    * `excludeBibliography` -- Text in a bibliography section of the submission will not count as similar content
    * `excludeAbstract` -- Text in the abstract section of the submission will not count as similar content
    * `excludeMethods` -- Text in the method section of the submission will not count as similar content
-   * `excludeCitations` -- The citations of the submission will be excuded from similarity check
-   * `excludeSmallMatches` -- Similarity matches that match less than the specified number of words will not count as similar content
+   * `excludeCitations` -- The citations of the submission will be excluded from similarity check
+   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content
+   * `allowViewerUpdate` -- Changes made in reports will be saved for the next time the report is viewed
    * ![Available Similarity Check Options](images/similarity-check-settings.png)
 2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file.
 
diff --git a/images/similarity-check-settings.png b/images/similarity-check-settings.png
index dece19671c19d71f6f56dc0f5acf31645b213963..92f9f1a562149e25bb890cfaafdda0ba4f2a3d86 100644
GIT binary patch
delta 35116
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
AQvd(}

delta 31766
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


From a08cb79dc854a870c088ecb8f2bb44b803fcd944 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 31 May 2024 23:26:05 +0600
Subject: [PATCH 50/75] pkp/plagiarism#52 updated readme

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 9edff55..c0efef8 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,8 @@ The config.inc.php settings format is:
 ; Other settings can be configured here; see README.md for all options.
 ```
 
+> NOTE : Changing the api credentails (api url and/or api key) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
+
 ## Restrictions
 1. The submitting user must confirm the iThenticate End User License Agreement to send files to iThenticate service for plagiarism checking.
 2. zip/tar/gzip files will not be uploaded to iThenticate.

From feac09456e3d4c2ec2b7d1707061c0b698ddeac7 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 3 Jun 2024 17:41:08 +0600
Subject: [PATCH 51/75] pkp/plagiarism#52 added exclude_small_matches
 validation

---
 IThenticate.inc.php            | 12 +++++++++++-
 PlagiarismSettingsForm.inc.php | 18 ++++++++++++++++++
 README.md                      |  2 +-
 TestIThenticate.inc.php        |  8 ++++++++
 locale/en_US/locale.po         |  3 +++
 templates/settingsForm.tpl     |  3 +--
 6 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 554e6c5..599ce39 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -116,6 +116,14 @@ class IThenticate
         'USER',
     ];
 
+    /**
+     * The minimum value of similarity report's view_setting's `exclude_small_matches` option
+     * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
+     * 
+     * @var int
+     */
+    public const EXCLUDE_SAMLL_MATCHES_MIN = 8;
+
     /**
      * The entity(e.g. submission owner, submitter etc) to id prefix mapping
      * This helps to identify the type of entity associated with requesting system
@@ -400,7 +408,9 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid, $sett
                         'exclude_methods'                   => $settings['excludeMethods']                  ?? false,
                         'exclude_custom_sections'           => $settings['excludeCustomSections']           ?? false,
                         'exclude_preprints'                 => $settings['excludePreprints']                ?? false,
-                        'exclude_small_matches'             => $settings['excludeSmallMatches']             ?? 8,
+                        'exclude_small_matches'             => (int) $settings['excludeSmallMatches'] >= self::EXCLUDE_SAMLL_MATCHES_MIN  
+                                                                ? (int) $settings['excludeSmallMatches'] 
+                                                                : self::EXCLUDE_SAMLL_MATCHES_MIN,
                         'exclude_internet'                  => $settings['excludeInternet']                 ?? false,
                         'exclude_publications'              => $settings['excludePublications']             ?? false,
                         'exclude_crossref'                  => $settings['excludeCrossref']                 ?? false,
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index b6b7e5d..b21b94a 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -13,6 +13,7 @@
 import('lib.pkp.classes.form.Form');
 import('plugins.generic.plagiarism.PlagiarismPlugin');
 import('plugins.generic.plagiarism.classes.form.validation.FormValidatorIthenticateAccess');
+import('plugins.generic.plagiarism.IThenticate');
 
 class PlagiarismSettingsForm extends Form {
 
@@ -62,6 +63,18 @@ public function __construct($plugin, $context) {
 			);
 		}
 
+		$this->addCheck(
+			new FormValidatorCustom(
+				$this,
+				'excludeSmallMatches',
+				'required', 
+				'plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.validation.min',
+				function($excludeSmallMatches) {
+					return (int) $excludeSmallMatches >= IThenticate::EXCLUDE_SAMLL_MATCHES_MIN;
+				}
+			)
+		);
+
 		$this->addCheck(new FormValidatorPost($this));
 		$this->addCheck(new FormValidatorCSRF($this));
 	}
@@ -80,6 +93,11 @@ public function initData() {
 		foreach(array_keys($this->_plugin->similaritySettings) as $settingOption) {
 			$this->_data[$settingOption] = $this->_plugin->getSetting($this->_context->getId(), $settingOption);
 		}
+		
+		// set the default value `8` for `excludeSmallMatches` as per iThenticate guide
+		if ((int) $this->_data['excludeSmallMatches'] < IThenticate::EXCLUDE_SAMLL_MATCHES_MIN) {
+			$this->_data['excludeSmallMatches'] = IThenticate::EXCLUDE_SAMLL_MATCHES_MIN;
+		}
 	}
 
 	/**
diff --git a/README.md b/README.md
index c0efef8..9880e29 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ There are several iThenticate similarity check settings that can be configured v
    * `excludeAbstract` -- Text in the abstract section of the submission will not count as similar content
    * `excludeMethods` -- Text in the method section of the submission will not count as similar content
    * `excludeCitations` -- The citations of the submission will be excluded from similarity check
-   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content
+   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content. Mimimum value is 8.
    * `allowViewerUpdate` -- Changes made in reports will be saved for the next time the report is viewed
    * ![Available Similarity Check Options](images/similarity-check-settings.png)
 2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file.
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 262ef12..e1d4ea1 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -93,6 +93,14 @@ class TestIThenticate {
         'USER',
     ];
 
+    /**
+     * The minimum value of similarity report's view_setting's `exclude_small_matches` option
+     * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
+     * 
+     * @var int
+     */
+    public const EXCLUDE_SAMLL_MATCHES_MIN = 8;
+
     /**
      * @copydoc IThenticate::__construct()
      */
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index 4d38190..c82ed86 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -132,6 +132,9 @@ msgstr "Exclude small match count"
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"
 msgstr "Similarity matches that match less than the specified amount of words will not count as similar content"
 
+msgid "plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.validation.min"
+msgstr "Must be an integer(without any fraction) with minimum value 8"
+
 msgid "plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate"
 msgstr "Changes made in reports will be saved for the next time the report is viewed"
 
diff --git a/templates/settingsForm.tpl b/templates/settingsForm.tpl
index 1ca3441..05e11bb 100644
--- a/templates/settingsForm.tpl
+++ b/templates/settingsForm.tpl
@@ -66,8 +66,6 @@
 			{fbvElement type="checkbox" name="excludeCitations" 	id="excludeCitations" 		checked=$excludeCitations 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeCitations" 		translate="true"}
 			{fbvElement type="checkbox" name="excludeAbstract" 		id="excludeAbstract" 		checked=$excludeAbstract 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeAbstract" 		translate="true"}
 			{fbvElement type="checkbox" name="excludeMethods" 		id="excludeMethods" 		checked=$excludeMethods 		label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeMethods" 		translate="true"}
-			{fbvElement type="checkbox" name="allowViewerUpdate" 	id="allowViewerUpdate" 		checked=$allowViewerUpdate 		label="plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate" 	translate="true"}
-			
 			{fbvFormSection description="plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.description"}
 				{fbvElement 
 					type="text" 
@@ -76,6 +74,7 @@
 					label="plugins.generic.plagiarism.similarityCheck.settings.field.excludeSmallMatches.label"
 				}
 			{/fbvFormSection}
+			{fbvElement type="checkbox" name="allowViewerUpdate" 	id="allowViewerUpdate" 		checked=$allowViewerUpdate 		label="plugins.generic.plagiarism.similarityCheck.settings.field.allowViewerUpdate" 	translate="true"}
 		{/fbvFormSection}
 	{/fbvFormArea}
 

From 60421422ca58bb054782caf728ec22cd5dc630eb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 4 Jun 2024 12:11:08 +0600
Subject: [PATCH 52/75] pkp/plagiarism#52 updated enable/disable behaviour to
 handle pkp/plagiarism#49

---
 PlagiarismPlugin.inc.php             |  27 +++++++++++++++++++++------
 README.md                            |  14 ++++++++------
 images/enable-plugin.png             | Bin 0 -> 17335 bytes
 images/ithenticate-settings.png      | Bin 18282 -> 21444 bytes
 images/similarity-check-settings.png | Bin 38797 -> 75193 bytes
 5 files changed, 29 insertions(+), 12 deletions(-)
 create mode 100644 images/enable-plugin.png

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 7339a0a..bac740e 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -84,9 +84,16 @@ public function register($category, $path, $mainContextId = null) {
 		$success = parent::register($category, $path, $mainContextId);
 
 		$this->addLocaleData();
-		
-		if (!($success || $this->getEnabled())) {
-			return false;	
+
+		// if plugin hasn't registered, not allow loading plugin
+		if (!$success) {
+			return false;
+		}
+
+		// Plugin has been registered but not enabled
+		// will allow to load plugin but no plugin feature will be executed
+		if (!$this->getEnabled($mainContextId)) {
+			return $success;
 		}
 		
 		HookRegistry::register('submissionsubmitstep4form::display', [$this, 'confirmEulaAcceptance']);
@@ -133,21 +140,29 @@ public function getDescription() {
 	 * @copydoc LazyLoadPlugin::getCanEnable()
 	 */
 	public function getCanEnable($contextId = null) {
-		return !Config::getVar('ithenticate', 'ithenticate');
+		if (!Config::getVar('ithenticate', 'ithenticate')) {
+			return false;
+		}
+
+		return !$this->getEnabled($contextId);
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getCanDisable()
 	 */
 	public function getCanDisable($contextId = null) {
-		return !Config::getVar('ithenticate', 'ithenticate');
+		if (!Config::getVar('ithenticate', 'ithenticate')) {
+			return false;
+		}
+
+		return !$this->getEnabled($contextId);
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getEnabled()
 	 */
 	public function getEnabled($contextId = null) {
-		return parent::getEnabled($contextId) || Config::getVar('ithenticate', 'ithenticate');
+		return parent::getEnabled($contextId) && Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**
diff --git a/README.md b/README.md
index 9880e29..bb6e576 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,9 @@ This plugin permits automatic submission of uploaded manuscripts to the [iThenti
    * or, paid directly to iThenticate
 2. Install the plugin via the Plugin Gallery
 3. Configure the plugin (see below)
-   * Enable the plugin via config.inc.php or in a specific journal/press/preprint context
+   * Enable the iThenticate service from `config.inc.php` by setting `ithenticate` to `On`.
+   * Enable the plugin from Plugin Gallery by clicking on the checkbox. 
+   * ![Example Enabling Plugin](images/enable-plugin.png)
    * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com
    * ![Example Settings configuration](images/ithenticate-settings.png)
 4. The author logs in and makes a submission
@@ -49,9 +51,9 @@ The config.inc.php settings format is:
 
 [ithenticate]
 
-; Enable iThenticate to upload submission files for plagiarism checking.
-; if auto upload to iThenticate disable globally or Journal/Server/Press level
-; ithenticate = On
+; Enable/Disable iThenticate service to upload submission files for plagiarism checking.
+; Unsetting this will turn off the plugin globally.
+ithenticate = On
 
 ; Global iThenticate API URL
 ; api_url = "https://some-ithenticate-account.com"
@@ -71,9 +73,9 @@ The config.inc.php settings format is:
 ; Other settings can be configured here; see README.md for all options.
 ```
 
-> NOTE : Changing the api credentails (api url and/or api key) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
+> NOTE : Changing the api credentails (api_url and/or api_key) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
 
 ## Restrictions
 1. The submitting user must confirm the iThenticate End User License Agreement to send files to iThenticate service for plagiarism checking.
 2. zip/tar/gzip files will not be uploaded to iThenticate.
-3. Uploading files larger than 100 MB will cause failure as per iThenticate limits.
\ No newline at end of file
+3. Uploading files larger than 100 MB will cause failure as per iThenticate limits.
diff --git a/images/enable-plugin.png b/images/enable-plugin.png
new file mode 100644
index 0000000000000000000000000000000000000000..f8ca1b1ba69f91d2c9c31ac39199590293bb0e73
GIT binary patch
literal 17335
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
A8vp<R

literal 0
HcmV?d00001

diff --git a/images/ithenticate-settings.png b/images/ithenticate-settings.png
index 5ba7ddf539b395e62f4506865ffdbec324998fa8..eccc9939e64059df7f58b01c6ab1eb086768412d 100644
GIT binary patch
literal 21444
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

literal 18282
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
Eg5azz4gdfE

diff --git a/images/similarity-check-settings.png b/images/similarity-check-settings.png
index 92f9f1a562149e25bb890cfaafdda0ba4f2a3d86..538720f6c0feca74495b40a7071ecf66476ae836 100644
GIT binary patch
delta 71823
zcmY(rbwE?m|NoDoAgv+{q*SCO1SH2m5s?<@mIh^n#716`l9uj)AR^_Yo6#v<(hL|~
z8!?*Se1CqQ`2MlGxaXd`bMEeW)#JHH<n@}~8xKR@s4G&D-zO&`BBD}y{qijl(RF>o
zYy2$|!nV1Lx4-1!8YTC2{VZal8-!1;{o6-)5IxtDS5hK8YgvA@wsv&2b8`EHu=-l|
zl<NDnYhrQZ)Z*90MB`{^%77bO6E;LdazsimpKHUfZOxK3IgX7=?2SCQ_d@jB4u4AC
zANe?&$FA&3O5g4<hTqkMC}6Ql#EfCWIvv`)>-&OtGauf6^Jw_>u=C|+)f`M_`)mf^
zfcMaGl-!(Kl|0)r->#T2^(JiQcFRB;#I@H*s41BlB!rybEi^Ux`vb(pq>dugPkhqM
z@872SKRXDYlTbe<B_aNBJJA0>Z~o^n=pX;)rrJnGsVt`d>E}N!o=EjyS1et@=#RHh
z&{R%J>;~ii-$RM0pSXFmeRQI#45Byuxt~JY1;|!`UHND_i=PsOcNl5esEhv5nCcUs
z2WQv77sxtJG}rgF2HYf813&on{2`myw%4jyH!H@Q@ypU>$j=-wSC{R1`>kvDhal`+
zZbe6H8m9{Qc~Q?*@@(K4^I)}x%QveOjL0Y4j!Uzp*Y$7}6paFIXA+EIFs;K@w<jv8
zK<cHIhu>auNPID_Dww3a0+W~HUVB_gg}cWxf<cM24cNT9Sl0k{1R4%X8RE5=UWm`n
zz*L^N3^?W{=x)&)Sj9;4-l43kU^zevLH#z;GKH_mBlis}a|@{kKAhy^D&SLl+MZXl
zF8sbwxT9Obx2eQ$uoa7m0jllmF_%by8#!HftqgaTD687Y-g#9FW#`Qs|5#>u-^r}v
zL&33_qlYR?RaHek*<h$YG_exP&jCGmLyKJj?~jjG`py@edbLsIF3{>>r`<d$iuXmM
zXY~+@&htdG+ZzT}$WI%eP#4>~vw0AA2iQ&xYRm6zTGnkf1Ez`JG`sRRI05>c{H9Hu
zn|Ev3&KEjo16a#d@lB)x&x-wZB#@}f)274eozxG%)^|JyygkANYS$bR-7yX8KhkQQ
ze3qDIhgAe;XO~#<YxPNb`N@&?bRF<G^)tVAIz2bwe2J~@Y<AbLdmif+Lzl;Vu4n3L
zjSrDMH`jjU<2%(~?Da#L2|$1UlR63B7jp@cXEh&Sa;$y`Ki_oB&rRGAK%L`umg6*b
zSdV^(xXTi*Lf!n;CBAu+G*XuYM;OSwx*^ES2WtS2r*fPUR}aDeYcn~=kz_3F!mG7?
z$FcX`m0;uX;?BQwGK}$c3-_2EgpXYE8Xb4cV+tkEEx<NVG2t<P(hn=m2<NZVUmO;!
z3LekCdCBBdTViB|R;bOqI$wQ=1i8`p?FG~^In_Viblen_>RiW}zPZ?F;P>AD9#M`B
zLfXZMnasdzypm8^EgK4?2<^XR?IxH!KBIM=A9FH=2;~pcJidmks!=kSL67y^q!kI&
zfbWjTqC0TtGN$FO!*U3zI_ME(OAh<df-yi>GBe8MJ#`<Sv~}m}Gv?Xv7D2H2y|G8=
znYioNK4HjPMR@PnIoyvvNbu0}7OdMU-6<bY-?aIY{4_Q#F>&4Qk1`i(P_94ul|sn(
z7A*<h;yFH=jI+A=3xV~Ec0s?P4B+x)R-P62RTD5O>`S;Jl|6oruR>k$ADj}qQZ{e8
z9**h3xDap)ao3eUL)o<(yoL)zi|rRH;;40M$>p#8fBn|v*;27nS`vIt^r=s{z)?=M
zegac`KtrphxxJ2`<4HVmf>|{`yRq+C66!p6zh>8WH_bgCS*&I7rkXrj;-r3nr_VUh
z3BWhv8$`?!3QOlGcy|c1Z3`Px09l*GwAamUJGzc$+P$fSD6sq5M{qj{a8j&nXY2WW
z#aNo|v)y9>nZnH*`Pidr8g(RSx%Mf-1s@<+oN&P;uKoutCZaF%zhrXj9E_H=bNzxW
zVdp3^YwPu{T8!;mpa#2DBsN%=Ip<a&a;T}WuCMBEwf7QJ)uzWJMrYQs4jPwf0y~_k
zoVL#^uCq?^mE%q;%qv#RxqWyxf6+Mov6sJ&#%F<ewr=k5*Ul$m>g1rwCDoy(e`A@Q
zZyh8CTV?GvuWM1>5!}+s3W%0D`s>A#3yPZ()`_}yOt=6~d$mpYO<l5zQ9zG+&%{rJ
zOO?y8^t!UZ%py5g{nc@&Y;6Dyq}np#?V|T?L)Du0;?)`IDh=J^6bm2lo{M`G8+h<Y
zUD*?p5_Y6~)~(?;oZ+>RAF9>(-6=LiLGO$856~6WaVxd-lO>-DYx3PMY;nG_W8UZx
z`I;8wtP{MIsTOtRn>|ml3P`S|i|83rfM!T;=C}<ha7NKz&R<=a!FqV|x?+Pb;1^?2
zVh|B=v-Vywnp1km<u@KKLCC2ngc!9MU*>V8F&bY)18&*7b%jepsh-?s?c_IWhO_Xq
zo@|&v2FJOmUKhH#KvS^Cysk%+wy?ZRKd(gFHsg=o9A&CqOYW_Jmb;$en3kxv*H}u|
z(uZ_TYyu2i++#R%4d-*9sc8FGPel>KFU6|{@mk!^ysCfKGl@rCT~LZVenLXTLh>Yj
z?y3<VZTG?mEszdnF|gZGIemo9FCA-aSu$aLgZ2XDWn`X?=H0L?@i7&c38WZ+Uv!W&
z5_f#{X|lT7fuR8JQ8AYuT@wY3?(gSy+m%N6<WBGpBbRnMMX7msh}Pv|vs<|~qQJJ^
zSmn&E`bT!z#=e6~7e&V=Etep-?_pWyMbX)KRbzrn<CO5+5HYW5^&<Ji6MM_kv~S+y
z2DUt6*)ECaamV5FN$2R;9UY{XPStMX*~)o7lE_5=R0BA9Unax=fbbYWphhGl8&6n|
zT{oDpIsjS;k@wBDH~q=H9_n;VbUBFeFda0uyC|1Pg(xulOUhtm1g+4)6E4>LY_I82
z>CVrbsGj2<J<+u&UiRWC&69ftQU$8*o;{?zefrk=x>uF<3E~ugI`zDM#|M0&^XXu;
zg=zQ#JxeW8X2L~(6<jT{lYMSK*!d#@j28cH!J!%T9Y?=nYtgMgJ7q7iv(kiR(s9;(
zVw?41O>vcX7YST^fX&MO+N4LVE*fkN0GF<d<|UVFin1Gs!y;RE+;1Dt>;+*vWZh1!
z=qv7Pg$gIdJ@BF(;OdO4RllDPS^x2uzyqKvwgoJ)<Bs&kjPM>1MyliWtms9ezD1~J
z$|CVDY509p7qH@5Gx1^cFej7a3;(#mLdDf<qDI@=vr}OMYs>aETN+8$7w}fsJZh-d
z<$k7YHWLjQWjf^(;&UDiPvv2`PrXJV>L<4<rP%g9kv`t$a2WRdRb){dRaAOd7zzw3
zgIISTmMYbGWM`rSIzJ#AJQgi)XFpFBo(jl2y%7lyVmlNlQrj4}Rfrbmyk@;@V4LAC
zWh(im{OzD!dsX(>OBm`*V~|`AlNZmO(g`^#F%X|QwM@{_Rk9`?AecYA<^`t$bo5Hs
zS3&Plgy43zLlNa+W~mOysn2uu0+3qUiiI4+8r19kno@V{zKgI!`5fE4DV&f-`j@WJ
z3aVel%w|s(>})#$-Z)ZL>?z`|4(aJ$-c%N~FmKeiP!C}}Xou}C&g?R&w@!iH<T2GP
z;b!>&61I2eYiyPr81_Z1j#0bOc1wuBMNnb@HG~`U{sfaWP@51i&G3*Iz_mI(fBpkY
znb}2OTfhp9C+&aF#2)+yf#2M(ZQrTX$KA<*+xW!txiQww6|#(pAFClI3_tL<3(r=w
zudWS?U4)ZBTg^oE`$qV!F2z@`I6J#(5qp6LI}mKB##W+%P0Eu(_2WzDb+%frP6>XD
zNp*K!?LkK6!n8!h6hkm@$1jG?H$?B4cu$#m&W_fAQ#O~PTXYhy9?WlrIA7+n&6q+8
z?gbZJ|M-IRTgXftart{x`6_r-vYW<h6C|6N3|7%Ca9TLSMg!?{b<nEW%Cx7Jua2Ha
zQXLQSvDGh&{`k9ND|=ypqeB@PpT_JAf}WX{r!>F*p%T?aHU|fK%zTjp?Vfshe$7T2
zOW~?|8H?-BvG6T<`Zd=2Hrk8I7IMDjyi+QEx4YmTyCo{|xxot@2=%8nT=7|m9mQPE
z!;u%UKT946+P~yuDQ?KkL372834pIpxpi?-E7i={X8OJjiB&pnwtclXuf^1rdqh^4
z1Rh+P;->j+l<f$-^H<^ekk?q+`x*aC<EyM!s85R)j)c^-5yS7KRDWv3wpMsQdikDU
z#T`4+9QTI9aSE<}_1Tfk%Y&U~NKdsY-3U!#vi_^S6Bf(6+k07TrstfQQ_mAs{FL(|
zRyKahGdJcWIDDd2mw4!b@%vhT7YVFo>sDEJoE)dNH`QJOUL@nuE!<vKLN47_vB3e4
zPCJ;K$b&wryS03DefImd{R3ppO6nvT0~G{cGvE#~bvDOWcghINU#$X{d1syOS8KYS
ze|hcO4aqi%uq2T_3|&mY`N`NrBp{PO5)gr3$AhjKy;npKDI`;%#=Rg>5^%KSO7gwy
zi6?}$a|@u}A*KNfNiPk`(`=6GTSjV+Z%n-lpn9u>A}k6j%`5bIH}nV#-M!x|u$iX~
z$~Q8^)ot~2Gu(!iX8+x6%M-Sc{gfRg4X@#@rV(o06AH8A7VTSUj<xo<mkl5jxTe<;
z;^dEQRK%O@k;<gTgWO3Qa=S4dJ+({P$L9;RKt<&1HQ94CP2TTs0ej~Yz=d9?O8egj
za+FUow=%g5uja4LfP6a|skN+~FYHmTAO7=!QszP`USyF8Mo;AtT+a0Gn5UY;zi;LF
zFNIcpaykAX-oVou4R2!~{w*e<XXbl&&y>%H_>L3es5~$C^Rr~rtJ8_R7gCqUOIpch
zz(F=BGXB2dkk#<JcklD)B9*ky@fuftA-Vzn5tsYHfQO>rX;%zZh3u`}asS}=1KE>q
z4I4m<6U@I$SV`kD7uCMrBZXX(=#FmALt!3v#<%?&<nn&*Q~&!113u#-(ufWgkG~JO
z8njwy<;EGVA$>4>WxIQ^FNWyD!h`{z9oNjX`XA|#gKsqM1m9x6_Fseb=I{6V!TW!9
zy4a()#AcjZ<2MOT40}R&r~+H_w}C_AToLwo`@^!@L$aB*hfbW=B|f!Bck8CnoDcfX
zu125wz%X=rE5|wK{2z%JOL*IfO;s)Z-#%umj8v1dO?P=!IU$CGEuB{&0bl6-$IF>5
z6ZEE3ZXY(u`HGU`;!CHV+Z^)y1rYpp^vR49>f+;FztJ4lgr#uf1@|a)nqz;dl``AE
z07E0AnL#*sG=E@J$*<^ZZj54ZY~?-F+Pyhe^11J?=J?66+L?pI%Ovv*_ubMiAB%Ug
zz>FbA#NmtL^ypzwJ^3*}w95f9i|r`Iolbmzch-<0IuwQPI3xJiDYc>0@oXkd630^$
zjfqQtT3Q0-Y#H$clf88KiU}J3irB<qv9v+ysKWQ^0>8_8(xu30vWR~ABSOimB{?r(
zi`=2Ko72Ds*>I%H-oYSjJ_2h>Hh<0HdoW~>89Jj$>d9b4`4x!vJILu)#1c%r=cJgg
zhTtZRRE6_8&H1=MI7e+nL;_{b>`@LoQKe<1?D;9dVM*IP&YEAd5q^hOxJqgIz}l=~
z8K62+NVt`3we%+4znL+BcD?7%EGRS5!9t*?9(yTsKR^+JzLesgBgne#TBClA`t;-1
zpaNGy6xd$^{CP8k`lNnqyxqfjZSC*&VBSX7$hHjw05mKjXG=Pn(@v=}4Kp0;dyq&5
zY3nC3H1>N-*Zg9ErB8S4nPXy1V6)HGIZ>y;q;-;-JcZL5H%=*P?XK78j66wqTuqby
zn+XvFHlj@pgbu0fPnQ&N&n~H%`Php|=7PET!zh5#QvSU#WA4_kZTnm@>)rNy->%wr
z5y_|RiS?DKTJW8<^!bY;SWTHceb<dC55ieQZyhF-SgJB4IeAY{$J%WF{(b&x&`+U@
z-)G~8My|onA&t|?<Uv_$8tcx!UOmxY(Inmngt*BawTfWd60F~YotR=zgiq)a?STdV
zOkisOyuTHJg;47VkQlMOQet~C5i)pC($iD)Fy2?SGRNZEle1*!eHkg9eJ?W3rz2-?
zhJ7g$DO<@tdp_SpFj8}jlWLv){&{vg^|IK>_d`eLr!7l4n`*l-_1&B@;a`m}QaB*H
z<`Rbwk5j%w1>wyUr*9g4RmTkg%4Jn~4N4$&d6sGZxC0XJ(Q$TvRq57qwin6UUzCdR
zthAPFadP89f=?gfhng=GKqjM3jVCLid{VWt=X<Rp%wg=APhS(h+gb7#oD65<cRtQ#
z$c=IuVu2;>qxk1+$|CbaG#0;)o=VzC+$g5O#F(#}cO5<zI=x-g7Rs81df{m;K{*6K
z?imHkW33w*%6+*<Ae4cueQD52gJ^YMy6f}3q!wpYvIm3m-q27T!pvl1j|($f?RxR=
zKX7kAI1eMj{bxEC288C?UnYa;z6sp!u^Nq@lQ%yyf2ZI}3!N}^A#!?AVk<$}74zo{
zw*e0#bi~$*BGRrM_8|Jy^7hd;A7S9vS}2`9Tbxq|4=7kOks@diwMd6#7-9(zgv9%;
zP;mTpI_xPH-r}PykC#R3zdJBbCp#+n`Py$)#fPq#!+R`*18EmVmP6Aj9v+C>Y9;F3
z+o{`~1NH*g{s`5OvDeVFPlvcnGewWF`a1a-d-qjz2W+4U&M2O1MFu1Xo&kio)H^he
z`JVcnW7aUykr)0Pzmgx|F1E`0cPt+b2q9z+^EK3D9%N7HYPdW#$FmV`^BZS-@zGQM
zKZNYwBCtl8?Vlg-GhU&o{y29VsxI(oO}%ICW{dM)3Ekc_Wn*kb`W+UE2vA088XcN+
z-<`aHR#0N@5V^%Mk2=Q)4gk&!@lStH_X(vF9OB{E;)z>hgta|d!G72&Vi@+xVS#PX
zsp*)?k{`Q{;;;PsXsO$Gz2be@4Y=jq0WjP^N~euruV+H;u<W<!_^OttgdjL4<a`*`
zBzNkQ((U%gjhy&-F|mk1($}riLN8ADwyYU4ZjM!T2xt7Fet=*O1t^vtEFF;feTvh7
z)X)T2J!W^4H6dPme@Zu4^HegrgCd0|rMNL}*JRgAkBx$-c}v_^*VjUTB7l8!I8lgN
z#B502cF6tasmT=|TZbYW$qUYy7@-}nS|)8&n?(_gyx`IvmNxVFWiVz$z?bs<3_7NS
zxx-aMfWnO7E&Ihu6acHYe5ut}n2U@${}YqrLffHxlu+6B2!(W!EZ|$YvD5>9D)<3d
zXAu3C<3>59VitoEDzG9uTWs;``%U&9Oh5nk+JO(lj-+B*AvVHikl2c(ZAX10QRuwv
zQs|w?oH70@sqEvk_P<b!Ogh)3fN<D~bF~$tnZq4dD((x`4#280r+BURi_yt57w(7e
z>-qf?KyJ$$$(UX*H^(n}K?;cRh3|QC4Z5J4MRt5L5B}8JYzMHwe0&%0Rc2#yiF9A-
z#(uN9t9MJj!zjPh!joD5&kSa-eW6<?M555Fy!8AUtZ_{IxAMX>3jZ#h`!ssRMNp7)
z(5nz@mc7z=g98BL@|jprze$(;$zld<jz`y1Z<#lit964$c7bP8B2angMtQ}9NcRD)
z8`T=cGer!SK9iXv6z|&UdLEtJ4JhVExNFNCTX7JzmFyMkdfq+y>l!_ze9NiW(Vwn{
zE|<=eJMh4`%jsqmDVXS#Nwy-z)*sIqD0+5fT|&MxwtxmohKcIQ1pTn#v}UhV{l4Yf
zjqTtH)<8aG{MUJDynGzP>id5!_(P1WV#uB<vKz=F$H;5;N?JM;tq&Eh?fy(ip?gRZ
z;%agF)wYWli8GS<ShyJ%%i*I(6MgMB-E%RE&q_|ui{)~^p-v|^@Iiv`Z)<^yvMWP1
zkB;t6aZW!5>Mu_>^SB~FVIi%FA1NlT_D=;UXEiUtZ^UPPv=Ai=ePh%gZ<I??=2PxR
z#c=V-okw<?i;5K)Lh*u)n~Nq48tc}WnAx4NY4=`PyOW)jHOuYmr_=Bo#}ro)dnDJE
zzD|r(k0ZhQ&l1_rsykQoA6VKM^VQ!vkfYF@*F9_k!fLJbGdS2!4Kj`k{M<)90^yeT
z<F}raZ3**4>z>ym!4jwQ9$KnfJo9_;zX~ot=TLc*S_Q18rW2hin^<LTVY|*BR!Se>
zmHCR(UFvh3yKT4Z*!^M~ggj#XSZ^+c!vZda#3C(Cqm#eHW*)>!zzclsxEo%WqF=G^
z5+f;rH$RS7Gw}Ep3c=UN>jQT$W6h*KLBty)%uTPoac?&A6%=IMWA&$NwJhlqo3=V@
zaH^X1V9(fSfGcGNJx!aVJsjk+`aH*N@Gac)NrVV=iG%Niy>Lvx2P1i7?a|1yeoyvD
z(x#<$CY~!EbV5N1MU}|&F^KiLk~=ni5_>BEcqn7JhJLoR%_sEgU^VqaQHrTlDbX4o
z^tsmd&KIXMHI^~1jj{O+lHtAZkWj_D7vM(l^OASU7iOLn-==bW&C_8boSjR!UjBKL
z^RsZ;yqa=303^Hq+%ocf<j(Mch)i3V{)2|&$Fub$qmdm#B(wu6rnuO6TQ?oQlQlI2
zAnf`Z%Nd!zL}PRv;w4|##kX5@Lj3odk#|OgR^?jM2C*oV5cI6~v4?;YAvf*h_!dei
zEgQmvltBFnqd``A9o7jc6RZ4X-9OvfPRNm*ydj<xqV!MqueXavvaeN!xKRdlLMo_v
zZxucbYOeeEOrn9wjs#>gC(`ebkGfF^BtMFJ$IVCO*YqsR;9h)p@TQYZHIdr!JqnWh
zZ={fGI*reit7~{}t#fu~PislKr5M)?@<5cI>8jg5&K}5mN15EkLq2UGW!A7U6oYFn
zrp`>gwfF1Zb20A5@0$*X*AG%DsqWKq`@<ye(5Thl#9bR`$(J3yrd;Bgr+VdeVg`uJ
zCDj(xlQmnZ|0a`UPUyH5p784a+xRbjB9a@fCkJs72XA{gR5m&STD0h@wkPtYsFnYQ
zAN80WGwR8Cg=^KqN*BAoa<>-TQ^9<D%(JEMnS0kZYasxVxAq)+2RikVGwjv2XpHb%
zhLo&RCDy}Hk6Q@c3uj&Zl*<)A?SV)jPM8bv7PGPP2p{s0(~(y1Fvqp*Sxs;BmH7F7
zu;bZw)c~Y<w?MJZFh!gv+sr$VV)=O;%}whMq=49@Tigt5GZXaM-h{;C0Zw-)$=-cp
zyBC6!q-%0<3X#Pxg4GzK5^RK@O-}w2{S{$tgvp8^LN5mR(IbuhUG$;I#;*gwczCgb
zZ!j|AK_?BvoqJBxKXk>=A$d2~6_VfwOOY;KhtKq2Mh=Y%xIqbiNERc@RB_~#O-X+7
zGeXFvy1|*U_u0l^TAT9uM>(^M%Zm}k3vJ&|5aApuP9H^P2cyZ$?-bW23orMhsHbJ@
zURXwocTmW9m<&2L&)^It-4mz*cEw{mi#9ILLz&w0hRU+GD)6W*hqp5kCZYJWy#4$^
z<FJftA-^4`t=#2?6I6(rqASSdQIzU*YQ>uu6q46Y8}0U}718V>l`)M>)3NlS^phRZ
z^4W5kR<eO#nsg4BX!aJJDE2_eBz+64rq}upF#xOT_o@miSKcn5jynQ27|OB|G~w~B
zvY#}@5Q(fV)(%qR^3(|>6}J|$=DWpCh<ZS38$6Oi9o-q817IbO=hM4;3*TJL;7(fx
zqb*QKiCh9#y^E4yW2$1CKa*4SQ|sd8Z!AEEN(Mh)01pKZY$P&&q9Mn(Sbx;Oc<APe
zs|WFE_?3>MDWdGiArYu<Pb;%?OYJX;?xAW40wHu#RCQw1Eoc4$m4;TIBrGk){+wAl
z%{Ez{?{Vwo>8k~*h~6~)TM!ZSzErrHcRoSSMDnc^C++Grw?zL4Z1O{OM)JEOJTyIl
zxlWj-)MvMal0RRkBxMZ?x5!<IAXC7V=Rx?fQ&-4lw0&;4I45wQ&rD)yidsOT_%97)
zZGkxu2hU5s^{M&w(3+~~5>x%B?1>%vQ5Cu9FRq&L*Bjs7)h*T)@9$WUY?cSq(&MR{
z0t{W=s)Jc>>QWAG2W+z0lJ5;%!qnajc=iW-I<^*kzOD^QrIy~>69sbv#CMPj-`;S$
zyedx!mEsm<gMI?!nTnby!a9$&wlxg7^yICYym^{<tJ)e8yUHZ(S`>YXD|-Smr~ElP
zD#{+sbtfM+8M*hWKn?|4hf*lxm<@)h1EP#K`F!o@R@42DH0AEGa#-XdGY<rjG>ByF
zbf-aC%IJopsSl4utZWHcGzEWpa%PRoUE8aqRb5J-FdaaaLzP->`)bUSHYB-yNn9g(
zA2hZS>!~bSIT=e2m~Su#d$g#iN3y@ll|Q1taWAz*ty1-s?w<}8zfIeB>6=<%kq&Ra
zo=*R@x~)HyZQ@5O`Lm>tsj2$61?LDf6*9pFqfv;Oh%c_a21!zFYG*1QV7>UMxXSqC
ze1h6G=fDYgekf_#(N@0ov3DhK&EYOP{k9yVyKZ%dq=}|-qqC=>cFLQ*CV1(w(2!$w
zbFe49l4Nk*z9LTV3~jNHRy2z5mzkGLr5xh!`#dxWmg_itC^;m^<+s`vA<h`9^ND6T
z*!ZuKkUbjYt6Bfm<}*8plfmojop9D*(fgiX;mCCWysFz(E31Ef%;RuTMo3IGd0A!N
z$Zn*aQxd0zh<h*1ND3e5{b71wCz9gk*!kDLx5nT=Xp3J+d7}O9JNk<(6O6w&I?fWj
zKxW+(C;l-<mXU68+i|e7DP8kolLhr&HI}D*??=MikYG>FS?B7x1PBr#?lu^WAVTex
zZ14b=_KIlP-Fma=Q&UF7Z{Y~?5Nx;5_vkKWzckCpLX?^Sq$>rRVr|j#y{Z6$&7C)D
z*!TmQT4OIg9+1e1yc`~z(gb1<UzQ4s6`4Js$TOO)y_ERC_4Cxo^k74=sh2^~DOMKT
zPj8$TsHe%cE)9OvI@Nz$q+^Zl)x8uWz6jv)oQGvZ#FR-%-1kg$L1p2lAHKn?hr>5o
z7h1d6!}qo-CTKCOzKY&Pa@o&>SrpHtN8{O5%44Tz%E-6(K|cBN2yZu7(Y;oPY!tgU
zKfpfl5t}mS9_&)l!hg-$-%z2%i%OWP{c(?l4LtGIO=O(^0U=Bkq5Gu6Xs!0M_y?do
zX>t|4>H3@TCs-VO2W%~+!E#Tw<9=4)Kv?`+F8v!XQ`LV5-KbLcPxH4DwwTd$)b-+2
zU}<fD4nLPh3u|h@QRicVb%HEsxyIdp9~lvn<F21`MSX5@)l;f!U}W^npofkf5sZ@W
z${7W+GLEw>gT^Qpga@JSXiybDhdprDO@A`b+Sxv{*>Ry&DW8_x_j+Evvt4Ts!Jj%$
zP_M~SlzmfPsl=`9V-b-}D9hM>f7osJXl?3;?BO$*EJB}Agq7Pi?vznhB1ih7d}KtZ
zO~u#xgDzWEoUjhtIa~`0oz}?DVuTVkz<=_$ubv5b&KJe`=Uri=p5`zM-2n=x1Cf5O
zN)os*g|my-e5~Zs19qkuRu@ZWH&zvXzt08lX`4O$&9D>kHte(cyTas0?~F~{2}Q!j
z-D&aliB}(Aba0cHDuSDspt|BUB&SR!i(PrbR_BfQI;SI%AX2v71f_9{oaHu&L8m!?
zGQ{U`n>Z=I!jRavvNwxmRf7RI37ZDF<lscaTj7Xk>eTlrvYEv4Mj?MDMXQm{?_IC6
zAE;S46N;Qrx{pepn_L)wzh~ycVC-P>*qq_erbgV@YRj9p>0y?RTc+zG$NqjJQMs(Y
zwTFMP?8VyRzV$Cga(Q(L6W>ys(lCwSu~eCFf_j%(Y55WfV)9*nm}~(46W>GF+;02k
zWvU%?@W_*7IMee_4Tvl@RfKx<COM^G)L1*XeZP>x3nFT}g(d^0#}NwYqBv#2Y`u)(
zZiFnu)0D9i(gSo^soUcki!ZT~)>usj+0owPhqMvWQm>dC5u;B}o2$R`4ZUMZV|^%c
zIt0#QWAwee&oFoW1bZ9Uh0Yti`KlotrD(NYRMxL9Da`4>p>%fUPW$mYi=0vEZVuZ}
zj_i=VKx|0PLiK_yv5EH@|7p+lKvSz*+(>G$IOKq$iN^QAMSSuB0d;UvkiC=uaUS>H
zvXWcFQ}m-AfNbr=Ll)Q??btGOeI9}2&aeuob*J;sz53&vP!6EZj>kZRWSxP+$u&jc
zx`8NU)YjprN?k*1PQ%(8BsPLtIL`G&1jV+NdL3JBkG!int}i)modWTb@ge@1X&1=v
zIwqF~StN-t&7v54PJK`))@4MJ=rO?@4mgj5Q!-z?*tN^?3_>d>`G>cB8b-R^H^stZ
z_TTgQ+G}E>Er1AGXu>N&`hkj2e*>@EvKkVXf$?+{Ps%xOL{g{)uAF#(TYLPKr4W}B
z4H3}YN2ysjHA<Gd6Z^}ecVOaZu<R|9hth?~qgELlKjrx}#yI4e5V=i%d*O{o4OG!|
zy%X!hMyUleZl0Y>o%4l0;UfC?!Nu`Lh$ZXJc|KdFc_5h2_ne33!OwTPhMcEW?II@n
zlVW{mZbCYcfFGQ#iNWhF`=9HI^QicwFCo^(zdJHN4}^+CYv^s69QPwa8UiXaXrGo1
zOGF`Y@Jf3qT-}}@)!F-p&ymk7_#THo5r`Y1<8zjt>v*1_Ez8dW)t@|Sz$9FjuqbN?
z@xtjHfQq!XDIe$sw7PvdxO3B?_YV)4iy1oQhF*8BI?3x5$vej4mUgug)Fv}~M}<rf
zF6Z0c(}Hwn1KBygPOZ?%o@vN*J>9Q7A3_gf9nq`%{nHO++0DVo1DE6|L1<&;rC1|X
z^u)7EQ_tz+^_B$K`Q)(q6MoT}5m7EM)DWO-X4qTOck;{xnQHIQI}NqVFB`|V*90j$
zVg$;a=~6I~I-ZQ=Nx$291PfUNNerH+<t>7Z(&^?qDlmq#x}K}6DK@q|n)I_OW~cQ#
z1%=2I%$80#!}D-{8@gv$m33>03Qu0+wqEuvEpyM&>5gzFz=?@pErnN4qQJN!2f&S$
z4Qs()d|6Hli)tw}uJ}-UN@1IjLY@b{>3sd9NqZM+h)$?l4Dv4>8PY$9s?w-&Nq7Fj
zN0<e)rg}B5!X4D;)ze$e3+AV4*RY5B80l8O1Di@-=y?`IdFe%6-$N~ys<wIKk#n7!
z1Eq2Gw-Zq~-M@7o=XiqK{tg-eCxsb7WqY2L-~_f`VW3~NZ90bN;&QP}XKWomJLQyA
zK|LHz4}VzX;V%psi%MK^kz^46o|jXx=T+(UXPoAFA{~;S8|B|x{oY;)OxyJe%8-}8
zk=*4G?xQh5ePYPqB%ez+@VyH9^S3P~UswxWa1N~_w@ui0Seg>k_4EV^`o)mWxt_X)
zOlB^_Ml*}PKQ_*IbNUyp56y<IWeVBtQxMzJ{gUD}v$1QO@+vTv$!pPpW3B~>_qNrM
zjl_UV@3JO*t~5@F(S<%~(1hnkCgoRZr&ON9t2elP4h7g=dvzXjIM$x`+>6?v*`-5}
z+Zx%_o=$=H`lvK)z950@n{$gHc}ol)IX(<}N=wNuW8+$Gp6@A`=^P{36s6(k4Ej*k
z>e47~iZFU}th0ZCV)d!!X|-b<MD{Cd5$|7JW0zLfe<)oYE9q28Kh;3)?nuX#v>}wD
z(<2y4y0`mdb-p>^TmLkIm_xCio6~OEi4HbBA@<HevZ>l75D2^@I_3C5WTwaYFpWjr
zD5~<(VM+JA_$92)CbPZiE$t)U6%y<1KK}WykblTtMgTEI>Sx2jwHnuhMLCQcvmGX%
zN+SvQV&*LAY`cz{q%69bluK;=kKUVMW#*pns_AozmRh0XG9)sjzu~o#u=8-9&<UrF
zP}exiv>8w}Q5_6>?r}s(GS0$hD-Zp5;Qx?*01@dANXr%5;NG{;|7S;&|8zKU8Kb`O
zPfUMZ18)QSMs<T7s(6nYTwN?7xxo0pTp$H2sm<gg(e-&#?~y95otx3cT3Vue@7_1g
zAWDb_oB)j->T1&eKBE+M1R+y%=OhMoYVYj=$)W<4Di`9tqE-**?mPOCO=xWBHRkVW
z8-{Da!G2(w{bPmiO10C%cZ??YC8Ivnt6H-TOmtMC*L!-|i!uIYpkK0#zYbc)AQY=^
zqN+NTeMaaOt&==&<T3BW@LP2L@DDyf5393#zVK5xC}$({ChW1UPa506v=7t}<22I!
zx<Sv&$mSN!|6-Az=%yzmiPwKsIm^=h?CyTaK6C$80)mkXwOrPq?-^8B#71nXO@uN*
zbFE#>sTqZo=R1Ev`p_LYe9P^NZXNSh(U{b8EzGeyDsnag#*EzI0EiU;?NSR*6ufrz
z4W8d2@=KkU2{|N=Ufd(DW^KWw-h?s*c3yLIqrb<W0IS7g&*v!g67s=_jpQi$lj-tA
z7?c5#j|*k%)I4_{8&Z@#)ie;+7+N7K-F|M=u2(06t;f~e8k;rGa@I3UcqmQOudH&;
zDDCs#s3$=9<$5kPbu|@iamLlUcGHxe(7vYabBj}L_wM0Beaz}12MDN_GBV+}8~)~4
zbbwA{D!gIh2Dh<$(=Piqz3cUk^=~~QJMlNQh9pfDF-dw7sYw`KGa2-U);S|*Tm4y%
zwJ0!t{u<bsP3NKw<+TCf!W+~8`EpEhhl=gqfbMLMo<7)=m&=dWv`2)6o46odXl4=p
z#Pa)EEcJ$oq-Ws{ImlNF^I?P>z!G20fJg|Px6@q;FHoS&PTXr8{Le@?`=zUmPUCsf
zgOE_gT)JOq$^V~jB~Ym=ZT>^n1Dv;M!+Qfv-q{!KS+bq|U29p`^;wnn?6v^Z-uR^)
z8qJ^TnwI~(Zp}y}aLv6}Qo}!7%h&k*#-n#2P2r+*?M9Vk6C>wibjT_u+Yhais)S3n
zj8cjYQURHWu3NkTwbu?F{A1`$wKwPwQ(w1d;u^GSJHe+<Cv`o27u;O(RaAzoRd!0E
zy&Wzo8(|135cL3|7ABZ|4qW0<^B4cvsVS2u>!p)RQPKh@&Mjn}t2fjCF^6T;=N3ZW
z`V_J^Tv<M;07LCYEpOb-?y~oAlnK18km>pKi8Ql;&HX@=vBN0I4YybGlhMRXdgsHe
zCrV0Cu+~kSiFJ(b5xif%wXO^&ueY;P(bi`D-H}eOs`uIK$nr3tpLEur{FEJA_bySd
zSipeJL-VIu+nAu;I4Q11yNr^Wii@=Vqk!X>2kOfo>2(V&y<b}mc+(t}YMOr>AZg^@
zQh*snNI*n&obuVwb1~zhqUgchN1JrI`VT#$V3qL|MyVh7YU(ExGObox*)E-j7lh40
zg~D0JUK^$6ueJeR8Y7Nrg%xAYo`5gn0<eTAJp9$l;Oe4H`1OOV0qe?Vuig>`BmWOZ
z%thVyJ?3_YCZyGQk$GduW}N`hUVLDy3d5T}ICKe8xGJ)hDU2rL-QR9J+wo<%M@T{W
zK`djpm+tmK`kfEWoe#{P93&ZkRAQs`U=s)I@GfUwY(`eTaQf1y<OgSkziJEST?b^&
z{>^?UJ7@i6#;%VoP2RzF)jVX$a{5VcAe!KqPvlhDMRhmMyHA*iWD2@%Rn7bPs@5BD
za!x`hJ0OmWtZ1*<4`vgc%X66oGVkJF&ND(5y~$;DncQ^tw{~-^reA9F;OPl~H$ON)
zNnV}*(K~D;)S@;m`2?4aW?}PBn1bclNEFyQlq<cXW$<f5dB3XPR7D%1&V*ijowVFq
zYi-(Eax8*yp818ac)T|5Wc7AH4M5JUBq9Qrr6IwZG46J<+>NM{KBt{%sg0iz;c2aB
zLhsM`epP2*btyuIQJW^a%B;X<tB|sY2E*+J;hU#e0?OE>ck$)|$=1rijAcaX63B~7
z0^el97Hqd7y<5L8tTB^5huY9VZdis(p7^!hQMB^zdc&}oqIds+<&-l4EW(?MayWG-
zc#Uarwlr;uPub=Ci3X&%%e8_NMk?8(!KDNsVysNyoPt=mb?UA-P+)87TSg$%56z1>
zBmW@{XVoS$BP|OW2);s^%BlB-5z*US-`Oco;;;CtW=d%+!6OCp`_{+z|JTG2%&&t{
zAebEKyZxa~=*KYeU0N3}fc0`O1Xfs7s=PWU%t|(g5P}SQETM@y*?<@LC|Esv1GR=9
zE)J+mo*8j1Js4Jj{o`7Or<-Z_qBpOG8rBp9H~xVSI|S}U14N?k)xY3;`31xkQF4%t
zbu-4}H-|TuXLK3fulsZFCI~wV)GWt-CKD*uWfSaR_1=m>P$4AeIBvgEubRR2=EB%1
zKM7E#9yreUmel1<EZr1@Klc)WtCj<idbatbPsWPDo+l2ELXj2YhJ|HR?XIm$tFeZ#
z{GgbT;;K2X43E}ORyNjLQkk{qN=$-@+wwjOWM2Qs4O71Ah9wH;bt?w4SzNDRCL(^;
zV;UMS$a(&U_LcM8-Cd4|E&<B%1A6SwprOQS1OaD;^$OHEfJiiPVO&K-0MbG4`m_bu
z_4LZ0#^+rJ9n$j&dZpqKO}$%QAc#78aMfnN6TI?ty?M!h$~wuUv~LrM@&k2D*nNn}
ziwKDV^?0mRpc_83Q~s!jnoL8<3X(cQZ9|i8??Kk}Y)4zVdW8J2@i^UeQeSd7Spw#1
zkeRgS;K4+VtYj6%5|1a)aI%sH`$zI#x`aSCg~sdtAvH?gPZ&yN(E*m9{?Cms$ei5Q
zB#ce_O75_k{8iPXvf5$jsoyw(KuAAmf%l4@oL#OAr99fDB&U7+jyt)Ywng#Xiz1kN
z>Nx`?F6}R)d5`ph&p`Wbijh)fgj_;z((&70jsS|DluiDQ5RQR@Kzq0iK95_?Ki&Bk
zy)O<m?u}b#I2u$n+;EVd%ytd#JQ^*V@bVb8h#j*LVy~QWfKI-(;7*RfcCMxj_}HwN
zM~t^c{1OgZc=zNB@gkP!b)nSvq>|iO=!Nz1U-E>IW{bjDbVxJ>fBhSTtIBt5`$8)S
zkmx+oIrJ1xlp9JF#J0ojsYKjcxH2!F)Z7VCf5q`hOR|H4)rkO-@W@YvU;UvMeVQF6
z0JWB|J&|z9lO<=kKu<DfKrJ1DCPbzwGrfpd??HCg<Upr8sL>0>kKxg$Eo=|E0yJ(;
z>H7St{(tOZhyNtylQ_V_K_jyMF<1vo{ps7?>6e~!K}n>^3~I`sLN>q0srUSLmF&M1
zdeKC{4@8B%mNkeUaMoQ94(lE?V4&S3l#3>@KBMMNw2o?}OSG(lK_cb~ouOQQwxTtB
zWz8f^%PEgo=?;amPt(o>D(gzA=g1}0eoqm@mCBo~>IkOJqXb|{CP^(X$kc4^dM5<l
zafw!84_EA+%)}+;qnuB}pT8oP`@r~!@s8P?|GD*y9jqeU<qh~N4GS(i0Ti6{+Vmp9
zG$WU*UJBPiZ+VnPyhM51Hj+GDB!Kv5)rM}S#?Y?neL-D+S3R)qX(alw-~yH9cP#g{
z)eMU|;m9W!H|7DcX@@wl)YbXE;&$sU{f3E|PTg2{s{xJ+Qb{vnq-#16F4!nBloc{V
z_Y)NDi5uOlXIU6q3Y8aOY}&tWU2s7s4*nnab)jiSLg;CsSdFT3y;kLl>Nxl{^)q7D
zFkA2v<19La1%f+>FL~%Y4XxUqJMIww(b*XYG-5lLVE>HH_w@6IG&@Gl@F%seJI>zP
zGTx~yH^tXZ<c1JCB50=HS`$T(t0nI5+!o#q;pd%xkz|Yu`H2s;Z)+fsg6q1J0~628
z|F$uvi+&k2FYIe`D7D#YPbn^vXUOW-(3OyLTwGy%VdSp_@{J~dQzBti6kWZ)e@6l&
z3`Jv=Ak=YtP5XM5SZmC~xAwTiRfXAhy^e7F=R_L6GJA9or-N0<(2yNd1z3^5qr;9u
zS~sZorI{W1#>Vr&b-R}<LcED8>@PEk4=WFK8W5Ethc}61zh(DTN-}a3+p5e>)UQ07
z?KQi^Ek6thLPu0l3X?DoWFJil^8<o$_{yC{0@x}c9OYRcHnryIDK{&Yv+Yn?Fk4v!
zH7_Lo8cs-{^F<1N%-XhYn<AOL=&Q@~_dT`GTV><Uk~ivcB_Z|GHiNVMm!RoCLZm+w
zq&6oUu$w&}-es3Ot89_iT}!N<;9qrDwc*T?($b2HRvKLXIdc<a3JlJknc~$g^S%h>
zr=G)g9j@V)g&YeaywpC;skL2x+*<kj(b%sBQx?%p7d0ioR}XFIA8J}pj||nGlenER
z$7G~P`8gXT;QljQQC?ECIpkH7P!qAOm&3yfBgKfcy<ICAyQ&N_2eKA2w%-jK%!yF-
z>Y*<r!4HtpVrhRpEdY4+AazLX5VF2llnv7$@~6j{FW{wjCcb{vU6I-4<$c%`sbIPb
zw~RefL}x9Qjeo-k*Qnz0uQ=xbV;0hA&Fi=7rXYaOZ=<jxmK_nQmJZnz4U|p7kfDVw
zra7T{*qrC80Cg*uES8R@hvDFSlMdKUtRILCm6tird144)<L`t(>SLogeM9I0&rp!_
z292qj&#%kOn&CeOhCNyxS$+zn13Cm^d1F}com5S48~Ve4lw<#yXw_DK1InV*mw7$C
zM$Z4_D$<R9o!|vWi^9-yoQ95HL3PirBm!~?LD)L3^Y7%h^aKd2@@j-vQR&sL!p~>s
zfK_b|(_zDNXmxH-3HpspG-b|bn9|(m%8Z~KL_!_{>cfQK^{uUrB{LOym9+hLL|vL6
z*l5vRu14#^r&hJytJe4LBdDX{Lj7rzi=2^m*b#KB*gs|4f4(0fl3i_jVid^9Osk|O
zceqUEVu}eo=6jB!X|Imeoy&Rw7-G~)<-F7^aN&5<6J8TTbR1_UY{8^aOoLO@EC{(5
zV##CEX4KD3_p3ld(?!8{Omi2fmc&KNi7GIyCdW%;C}?3=fXo8p@SHy6l$W4X{h1mP
z!&dHt?<qDl7-DZ!2|-SA2RJjC1r5GE#xRCdQVoZBm}913)7{i(X8<vgQ40a)%~LeW
z9&0RU9pT!H3OF&)ScsU{O)lOIcXYq*ejVE+eXgK_K^_;V%qi3A!NV$_uzenF<P-Tn
z<4guo|5<EKO}dUtc2iX*egbFKzkO;Wb^k}W*<Q888`1xbh%TS~rzI_K9Q$4oFm{=a
zqp^oElO8BB3Q~MVhX>=hPx5a8H*b;D)GS$9{Ivh?t9{wPoGeH)j!IhocJx29`(Iwz
z=RW^QKhh7)oUkm%|8D+YX@uVkuJ0=OTc*g<LBpWH?Vq0C_WKcer&j9czxZ3Evx@<k
zl?m*n_lmA!1<WGJM*@%#_nXySZ^uuQ&wsN0ufAZ9Ngb>BU-Y=RQQP9=e0cs$Z#+>)
z6S57nF%g*)wPCjVsaO49HPU<>)lhvJDJK|(vG%NtI8ABP@s(Cj-@vi9&B7TF7D&0x
zEa5z{(&RugPT)?TpMPE6<pMbAY0XFc!lJJeG%06p8t|5!rA|TtE7!;8uJH57&S!S7
zNK2=yC4=%>CORt6lIWV^kx`13(edfp{ucahQJr0K=IZ&u*m-;k+tf~%@YT*`U4!S;
zqEoBuqDvZ*Y9Rj)OH45R9x`J8X1)yU#z3&tzlr%GoxH>w)9`)|Fmvszzy>6Awh7vq
z#i49`3EZsW@zjc|+PU!Y{9*|EK$MvnAa~9>K3vAA64Z-yuG{UWi9da|{ZH&hi|R*^
zOvUERKNu#vm-JCb*SJyRhfeJ=xp(bEzo7S7U#=lP2+^}S`6A5}>wGc>e?a-3gWuR1
z{9HvoF~ithB>>3l<8my(EgB_r3@q=$o42PjVD(EZvjkU<{?#_^@MeJ6TxK>Ml1BRc
z_YRuI8-6KVYxc&B``2KKLyz&M(<c3|qi@KK+h)52?iv&;>o?ycSkNniK;rmD78R=?
zt~cX01M5F%V0ggd8a)AU&+|tO^J6%b?Ir85Uj>B-KtUeuu*CPPkNwFUvgXW1`v85m
zDtmQOKXt25VANw`soJN!I>_jJPhBS(%+HFE!>|dCbW|NDq--?w=t-V@s)r<)TIcG_
zdFftyAqly?f{&+b1aqcv87nI})Gub%*rtcxr_Kvs?v6JbhAAYejLurf{qR4}+CbvH
zbn5|dV#wv^ijAM;x^v`u2?HPFE;vwdjm%2q`}D$`J^H8uWV=Z<Z@=q*Jkgyg=48xQ
z>6?qGUqKCa0gju+;_H>Zhbu0q1)H1!f-6C<x9l)1V-;k*bQ-(KB`LDGYn~8`<(o4*
zo0_Oyik5BkJ}S%1K#5*fAbl&&#*ltM0*3otrml;pUgN#VmT#k<*a~kXh?_0;3MPxp
z$f4h3>G@M0HrBUldItG^lD-Hmi~wixYhgGklY?G?NUA*1`932F8f|?Oa2C#+<<%Zt
zEMA0gcyph%sfF}v(l#>#b}P&^;g5L;t626dO{-0rg~0vJ*~*f=(10??V!IA7*MerL
zCYpIB(ljQKFyNiQ#|js$N66JN@SZY8<P~bn>(zsMs+m3(2#<^*ebRKdxurH5aPaFF
z-u;rR%Oe#Eoy@MP9dY6y`RIU;5CtbR-#OHW@jE>ms9j-nc$qJ`;1Aq5A^*65CMr9Z
zs_IY$wZ4*udwbMlbO>tf*#!)$Wu}j_CtM3YE}Fz?gPcIWS~T4!ye}o3<6V3cZl)Z_
z)5wTgGYJTrc!qOg`4M6ed-Cr(9kgGZmI_qS*rJ1Bc>(7Mv$BO`=G6}A^eks>&s{oT
zF_bHco;^X9Hsn94gPl_5*EEUanj{g0BK^mjaAj6T*gC)D+jJ<f$rB<1?B(ds3WDYW
zF*dzg%I)Ow<`|qM>N@J5hx$)RU@A&EU$css&hR^3&yc=88}d)Z`f#^;pAYL?y}Kg_
zoT#Y3Ab52qRf}PKD=c4d*F9&<Y~8oQlJ^H>W$75AqZ7)Gj~XFve60_p*T2Vo#JTlF
zoRQATy!HpiGk`_3vu%bq$mt8+p@B<`@XRkSmw_zl4P#bl>?nx~PWS-|->{1bY%2Sq
z&iaGEX-Y<t_vkUTfz(>oWDiHRTwl2CK5WX=QkTpngzIBCftQC}y?krKmb5X_2j#S=
znf(wXoUAkOTg977%?mra-JQm_xV@AE&k$q!KEOMNW@aelYOj}A*0R+%;CR9Gl_^K?
zuyC(H9JG`6)fb;NT@((tuR61PiB~}^Uh`XLug=YI>0s>UO7h5|xx&VflA#WQgy9AC
zwb;&!#GZvnvZ1<Ff=Y^|V-Ojuetst}z46`SnxvsR=h^V?Hyni<LlB=POQ;V)tCfid
zSQZl~{!nDXd_yv)K6Uok2UMbON_F2f{i-8j;sL$$Sqw`#7E4OPim1sllCg{Fu<Q+g
z)vp{pnx|$*V)ry^EC94Nf^0c1-cp*E$@j+B&1b-bvb81)(jJE6r#^S~tSMT)NN@bi
zHqZ`YJ7~D%WoG~?`r-uSK+KeSrERo8zEkg>zRkLIte@o@@1gugD)AYiGXy$!JAy?x
z3ssSpzL=ztTpKa)o+5DS^VO+7N;@-?9^~^uvHO96_^*S|l5CUV@=bZR(>FatGT)Gc
zx=YNE!_ToY7go#yho5q5+jnc=F!g$;8cgEspA-=-fxTb3Pbp~3{*$1`NB~0Nq#v@~
zX$9QPm9s9iXI?f+0(_+0yl-|}{$+GvFO8K|8HMY)pDP~|6iz;Pf(8;C8IhoC$U|2j
z9)`&|=hl8x-AK@s{t&*0kBRpA?!B&JmU`l_TOAkuLcIH1Gwm<;aRaV>A#T=#EYjRX
zZA8*f-RX!3LN?29Id_s^|8fL<*HzXPJo{Y{an_GK#{T=y2s)C%b~>E|F?B5McP~bh
zdnLl0xArQl8u+=c(^iKzeJ2eQpT9h+s{5x-R9d=5%KViNMw`*CWyG`JD~JO39$Uzz
zI4_7O*{9(HsHM0)S6(=>y_4Rda)Qg>SK;KMtqWC1`K$r>EYi+)=cT8|C4PW?PkUWa
zvp|RwK02m(>glGba!*z7t4rIa?X?_DJ`7=wrHzBUsZvUKxR2vELsTCw@tK|Uyex*4
zHaRb0<30K%Wz~se2?+LO>RRPri}2-;P_yJ2J3MEaLu_zacNF@BpyUvnI$KTOgCY|<
zHG|+se*jyE$jRbGkf4uw)z#%0#g99CbNEJa&uW5r)=kgESLcY2oor38TCO`w>|c3#
z*JIun|J}r!AZE?{6QCYWOe-MYWIaRa6DKo;B*>xGF+7q@dhj7vLbBL4QzWYCpGavZ
zhwZ`+=eMcnm=PR${Qq%v)=^Qs@xP~$5L8-XQIzhEWkC@TDN$KKx}>CQfrTLil<tr&
zk(OGzJEVK*kglcsF5i28=l;&+--X@TIm|QjyyNw`@7K^@u>DC<Kwydk-4ryUOW(+9
z(U-U<TS*9gC+X**2SIqo(oF*9<M>j%jhq<N(smZu&5o!-?tth6k;cPNC8q7YG@MIK
zv_f)>mWRYkR7XIx))m9%h1DN^?C^=wNW9EN<c#Nq(Ywy@*=MFKX*+As=G%rrE;n{)
zFS;L}-xpTJ1J8j)Yyh+Yxo;GK=XlY(hp#-~aJPPA@iU7kiB9fjTBjCSm5?LJvsr<Q
z=Qm`5@JuB9=&t|>d%IGiUYLqAz7zIxA*6c55JmbQPeL~tJ0oPdw@UQzi5<FPb>^{m
z(Q?~L1jO%)%n3eD<B8ViYdOYeIPbab7Z^<Kcl?+H1_-GJ5(=;0|MFDgPoxa^0HVSO
zpErKKsekly(&RI18HD*8g!$jCW7?HYr~m6c{lg%Q5c5yKQkcL~Pim_~9_DdKj9b8X
z&Aj{e2_N6O2kQ;I7ZfcQ;E7%dp`NU>a4M30*#KjsT^Y60j7L|zHkU#Znpr$_89G<-
z4LhcZ08dB)1iDB=;>WQKUW@sNqUTyFMT@YZIn!O)k%uQa^wKp4??bo3deTY#%9=RO
z$;mwKmZ_SmgO1hZ-h8D$HLNyyD&EGp+eQ?>Po-n`3N+tF+(l{Kw2MHV@<pET8J?i8
z1~>>AoCrNXI73(7zIKjlC>45A>z&M?H{t+jzpcCXOr&8``6g1HLF`@dkMi&yR^*d{
zTL^KpQuI2y7kt4A^7<AT@AP21E8+L0=h>WVj65TAC#MFOiVCURqiX2MK$c|iTIsf-
z5!VoQVz2)t;L!HIsoV4D_vt+uz!UcQ@&IviU+ic?r-)yaREC4MqC-XIt0w^}!{(f8
zws00hFyX18<{Fv4{(&#m@ha9g*L+}^EG^-@HDbdReQygnLl+@DEytk8(XQUbmK<&#
zodT)D(M!I(6<1x7d-e+9)w~0j_u^e59bONo=i~V}2ywbn+sge7tIaU^*gk+~jgi<N
zLivbhzo2uJ)rj9ae3cl8xZs^<{>aSGF?e53SUz52`}s0O$=@*6zVrCL+DAN!+4+WA
z=%QF^0p0XAJNL#W-Dqn|UgGsCN6Ww{MSV+rw`MC?_or9G*<tEXEz=jlBZrIVL)~Hp
zI6q(V!k>_)LblYxdmH0L5dK%Z%{W)+YCWudRP#Jr$-fjxw77)boJ<b>5r%rmg3%qv
z-B4LUnl2Mu^3V(Z|7<e5__bzohC*%5cLnuGEMJc-iY9e7k-Bm%=q-Xg^*Eblt#{^`
zjg6Zg<2-A#$0M@l?v?i(pDmV`@Q8TI?24uRWqj5!O$`lVAHuvCuBN)aOlhzp3pF$o
zTh~-s0Jn%S({anBR+k5hS}T<i+<==1EMe>jT^x3;$PZQElf*=T&ZdmRkK?9nu+-z#
z-KZrMN=~O{2>i<Hz|cCd!h!ahpJiRyNMSMNOxk%i3-f+G^0buRSH&y`##=by3HurZ
zlEohEBn8gfxS11lmfA3fKBn)vYs|-4`&a`8^AWsHYR5J7B^x3~U=m+#DG#WjDKp<}
z7?ce4-Z3aV!c(m3+_K89Vq~uB&sEt~3ozTaQ1$qnvD=!iu%G?lT6@i~z~rer-KQ>&
z#hu3wu$d*}XZj14Q*yrtmaO^(mZh7Y&IfGkrp(~MMDI0umK3lpqK9blUklss+cscw
zOWPEtaPo`>`!a$!AHVQVD`8E?FL2FQ3*UnIL;WkCb6(LXZtFIAc)Z4(dVraAyspdU
zDblv-m=$H>bKf166ah<=e(x6b%uH@9m+ba?N|bbb-JKp5MYF$wcgYkoGyCOufNb@T
zX!XS}?G1U5mwS}1UMug60O)5AHXvDw>g6z_`<zb?Lri?OT1$u^y%wwgDbT7Y+l9gK
zfq`Y-zU=kh0Wo=rzZD(fQ9#BdAGWbL@f0_4p_&AJFaB1=%io1w-}JTKd#3QTP2LL+
zu39Ahr!rZ5*YdrY>er&ud=-R_dNs@SZ<M!M$-{ocBI|L<=$N`GNi`aa0KX5}vGG`3
zxUv^<ODl!g{(6j!D0LdquXz-|t^U0eIEsCS4N51szH>7pzFnP7GpXkZN-C@9czwu&
zn3@v^EsOi2_=`D;ot&X=ma=rsK(Q^(@7nuym1N5Uezm0%>>Z)f9*z0}7gl+nKGNAU
z*OHga%=-H%i>7elZ&g_yD*){Rs|8MMSG4_N@(-Dw0rL#}y|^^y3~|~3h5!d2uH0Pk
z8k+)3V@wG79Y@+(kmDXc=%i=fV?X8CUxbZi4h<KoL+%M7osnPbly7l!ta+l-%6Vp1
ziGzzWvDO=p$%gds!--Im8_Ed@ZKI6F)m*jRnRD9nmvJ!!Kxx1_fDk=I9I(lM@o{Mr
zA?a05%8A{vVDghq!|qf+k#H;M(Ya+WA@-wNe91dKnc?Bq(<^Ie!X6%Y`A2#oQiOLt
z(46O%L*t}C8`<4ZWKTqg{Ec{O6&w*V#oulv7vpyq!eu(VdY#54M)cs2l7#qi1(vnN
z<{SA24}Ml3vmS{?AZs`hi-=l|a_(_zC0aI|HxG80FYvr<pWuYVmsYHL#`W*I1hCD-
z7@KU95q(?6U*%Hne3g^&W1dmU^b-r;;W(<wJP#3(mzjkk9lV!C?)Qk+hzIl(y(X_q
zKPIn8|4^ckN)7kTGy${K{w!pBi4QSOVvDU25F~y=I0I~jKQ_uy#{8N5rIURq5kH!9
z|9ib17M?QAbLa1f4TJXg>FFqK3sjVrPZEZamE|#2P`x?xBMz&1p}>@);}oL0&CVng
zF>&~0(!%vWZiMHPlGp=$$RB`Cv{C<`M_<xHROb?!{}fAzG$APY5r}D2Hazg57WR7c
z=NPs0tr75k4y+F*Wj4W23BFy<Wg&f%g&`RurD||EmA!6ILNID_zRDsg#)94Hccer6
z_0KB?@&UQ_cmWX-N&)s&e^6SmK8dMzkpvU&qUR{>LX0T2IP|FAfOsHURov}O2}K=*
z{rhf|px%(#TGK&maQ3sJMw%rp1L?$_3f#Lxr6i!+cU?`Me!N5Y<H+E4SCaYiyy?1b
z?S9H-Lty|*{;sRTdpKKTG@Iw&q%QL@{DF*3jS~rumHzN@linx=10$P<iuRYkirOUH
zOds%)iv&yUFiw)>Xp4$w;Z~g8`^~2kZal^{t1?dqlf_eLUy#B2HH|S^Oz9v_v4JjD
zQh>+q-s5oCo2T8xrZ+?frEC7>s?6?z?cv`A)CRsC;>5)(N<E-;g)PG)v2W~n9lGhX
z+5|jthnl}fhILxqxmZ6vKK^zj*TIu&fWka(a)iE|?4-fQ=Uwgd*qBYL?b|SciQ|8{
z#`0Wg@c#T8^2>~KsKO_HWEpec1$~DGrvZ5-Jq?GiPE#IpK3$aYJH$Vx@C(w=q}}8;
z+YWI&-jYatSF6-SC7Sj7ZwSBf_nj?8l*oUopQ|THKT6}<q^_%H;b(xHY-U;P$L--r
zUu)4`iPi0s0{CFx(M5FH^>gN`z;@vdRNf1=e|hQ4%8bly`~lSTt>_zdO<n{mz(q!Y
zYrdxB)|Kf0>0NIkuaXfnUQo1A09qAq)DSW5prNsC&8b!*ZWa!8CHqqkA%CIzU~R7?
zftt?lC&sWe4gVNa-}nTrgj5X_;q*p-sBmWD8X#Y5&m%ck?q0Soku)4<S;aAZZlILm
z^H@&pNSasF1uaPr>-$sahI`He#&tP+O`qJ0hfrI)dUJD<VB?vd?q+PV!0YDGZ=cB$
z6cV4AW3@|chP;w{LOQIde>wt=7}##P^5eb;3O6^!QC!!0gWbsc2R2%PId{NEuJks^
zw$u%gl(Dr~f6WXg6LwdwhlR_ZlN=9+BorRR93Bh>7AHpw$atTPxP+qsla_CR;WM^<
z#6_1rnBMF5Hk=l6S9PcE8Y7&lCmwDo2Y3&O{gy>$lnT+t=c^&%!+2+_;u`2zGYAJV
z0NNSp!b|>jx5dY7tK^it5usu~19cMbAEfOyN4Jv~glBxmfDrn!mX&twwu6IDRX>n8
ze-obNA`DMNbnFqi!2*C08yTz?`qe+u;$}ZwXzZ`1oK$TetehgBl%}u~vrSEVEW^gS
z1Hg;(s(kcZ<1)!dS}p{e2n(f$^3$I&3*rCGMR{#X4=G5yhEaXt#9aAX2c8Lm8f!05
z-pp{4x{cvE_%;?9f3>WFbXb|PTs~I|-{8k<Kg!S3kg^zTkOAbcS<!vmYRmrL!Fm|W
z^;tjqmlN#=B+McM<c>GUV3m*4V%Ti!98kjw_F)1?ZCPob=at_}!tXOtb{Z?qoK34<
zZ4X6U(2Gw`#)ARHjyD7qk80V;WvF_uAf=c3QshVcRqxcuA@6L(Bf4^-nXT5hZ+9t!
z05rwS(7D0_SaC)fy-x?zjQae@HMcnGC$LSj&9~D=JgjodEzn5a>{W^trcV`HGT)>o
zRn@SmPZiduW#|%-+W)vj8=f@kku(u7%zvwQTzQCQpyjel3`F;?O!pqYsjtr4PMf@3
zWHaxpFx<RPkmglicp{vYr~*7xERM9#MCWUkX!e2Jiwp}D)0v8zVgBs@zSJZ-;-&q~
zwGNqCDz3)@#x3|OjQJ^=Etp`xy`8e<{Egbh3=1x^{+fSQjEdwM6}M_Af3t_bHeD;%
zyl~;{d7bF{>czEJtUqD;gi_+(t{3%GDO{n}@U;?m4nQ$i6vNEtm{K*?YTNpVLqtyw
zNOl-tsI=&<gt7k}%}vkI(izvN&xfnqfE#;1NyL=YMiuv*LM2DOp?PJZ?6ym6bk+_2
z9?1c5|9VNymZ&rsb=Hs$BMllij)YX)gNNc<x)=GmC=E|_`4Ng^a<_S;;8I-JyR-hX
z=##FWOw^)kia8YY){yFYjh|0q_q3b=RfC`B#V(&}r!3{yIN-e+?v)K(`l9)|EBpTP
z^?%Af4!>yl`_Tyv(b8U`)aY<S9Ja<n1)(>~p3=i?4_P(rSKR6qvAM!Rs2lHf?dm=U
z14>d#Q?*`08?HtnxAlPSg;*P88{$FL4aWbUAPmATrv@}5R0<~wE0|lg)EZ|$<V?B=
zwcD^&E(Yuob}sw&&H0r5Kda#&tqbj07v8;~<SlI0?a{ne-D=7x`d{z*YOR^m><{Iq
z=e9hxcx_v!%RAn#|Id!NHghx(#<nsFwnJ6y(7{&TucMC$_+M$q`)9XuM*~WZyn*L@
zssBzB>Bo2YObeCw+Se|Mryc(SO4f&er2?iEFRjux51{pCH|j&80SNdSXwXr<QB{7O
zUO{HuS^iK)@|N96<wT(_3+AXjCX|aH2Xfs9Y-{rD{&E#>S$0X&rfOe2YY;ng=STq5
z;Aiz&CYR6%5fggR15lsO^nk(5&HiLZ__}U1-oz&zzVB4pJ2r>fnq*ScqUxzgag`L;
zb{9QuRoc|a(+bm>gZj9pg0(hmJNaYXL!0FNT@U|lEmNDpb$TrgWEgJIJkmE6i6!5c
zrA-DEsb(_0m>AKh7`Mfp|B0${o(F)+5=tkpg^BB@2XjJV5!&B`sCAC)c1rcb^@ne*
zuP0&`oD-c3hV)5&J!XwdZOZ?qF8ocdd0m|FYliz<dGRLo!|U(Sll$fhCGI&ye!{kL
zN}Zv(ijFD%*IvUlc5|~``+srr^UOcUHMWlb%R_k;O_#`BIa}#Hs(^|$weJBMKPBfb
zgm0}T%n!GbUNzG^CVlHv9XI4}mVUeEr>q<%@-=2_=oNg}r_ea`Z}Yez`H=L_wNXcG
zCH~h9zYusP`GRHp_vNqPf^&PlAGRxtkJmpsjhCaN|GVeIC?~q`GvC9Cpc1p9iQuq&
zWb8|?24so<mFZrPyy{`|IGYzxG+UBQ<tfW^-CMDiKj03nb#;Apsd0gh(yvW60>I&Z
zojhbYvi$H@FL|S79}KA@FK~F}NY-?~158M=QMIbeNx)~781--RJ;&8Hd&yG?t1QsL
z+(_vD$`XQmlCOrZx#a4q(y^&x?;jp4h6B!3+^S(8TNP^Chd5OD1i;m=f&-UxgE(f@
zi|2E*3Py<ZgPZI=Np7&u#Bd}Nt=W#L@BJ`KBFS~-|DkchoqOJ@ZMu~b_MFzsva@8f
zu6!6);$S@;^bv8;Z>62@X?@%3={Q97K>jj)S@PAPF`ax)l@o=vbs}QmjVO9MTODm@
z5XaTJU3?|4qlH4A1ExpLE4?uq?XlEJT`6YTt7d`p;HrL6yf)AstS_g>THET;&1vR>
z3mP)0IFEaZ766NoXh>G=f0jNP8MxbTgFz#j+6%j+b`p~27%+J-<FvoW^7W8yy-Rq>
z8o#7I{oq|1H)--cyHTKtplGH|)8Qcjlg|^!TpIToK$!Iyjn@=sp;)SFJSlQ(2(Y_}
zuvp`{{QNV&AvJvl8E3K0NvAbHE~TJ4+>haWA@~y$%vB=bfa0)!amVufb8QUAZxn@w
zAezG1w;!^URB!$azxXpImsCAfD!aC|#ppMpG5nJ7GLbp(p-kzXgp(>rrm6v7P0aN#
z#oQhz07kPk$Wla4C?2j@qg@K5$8fyqXl;Y(^E|kEJW<r#M=fic?I(Etq&6T^&mpWZ
zFsi%$NUd7A1ZABJZuZ~Ydw`?vIzsDAskgTM(Za6s{U*i2gw}-$TGXp=8m{vor>R~<
z)6H~MuF=pD^>c97_9uB-eJA#Jq@SiUW$S@Iq&kp~9eh~%#B^L^9!sa3weKjY`Bw7|
zs@9OTv7tZ9idzMI3b^>{xT7pXs<mS>aDq}Zb4+GExL+`Z2j?yv1c;b;@!yq(dvdm!
z=U+zug5lGUT(Wa9u{6ab7I7Kd$C`cP7@<mC)yQd)j2)1xQcY5w&+I5a52ZS1yu$#{
z8<s-41X*{*gm|q}pVCVm_Tor;)oK0<Ew2mHR*rI~Sxm&&Sw7dk&@(jr>TNT2yqkfZ
z-dA5&)t|vX7p~^d{;hS5xK+(o;f*Q!)V!(2OLk(Qj;<imW_x1quU~UAp)Iw~O!m(+
z`U~!cSFLcGlV9yJv5uU4gCftOr^5ok@ZR<Cn?|sYfwKZZby_j1Syzw7wK=xSGB?Gg
zw*a;pUF=ze;xv7pG7JsM1q0*EazQQ`8uw8&;pNye=N3*L-#+KyI7W_!uVDDhc9!Hh
zI}b07_x6hCa{R9C62;|Mj*T~DE!Q#-7F~TxvDZc-#kq&Leii4qK<9N}31A3*$eekY
z&$Ea(^9e6X(77rdvO6q4LiHm!t3}H!ZM+DLzjAYZP6|Ct=o&Wd@sE}dkAIS0gK}#v
zf}pex)tk(Q^L2E;5Qn?0U`B*1VOy`MzgM|!Wh<H~_}WthpYfM6$J_%s?K3>erH9DI
z^Mg%g%i(*wjs$$te(0SXAme`)@E{BS(^DOP4R~e2ase8lne%t=p_9gop{`5X13h)!
zmsYF9zq2;{3)YBg7_rqSzU{W!qcp+XbiJ30Gz`t!_U9>bw<ZkE=}j{l`*s-x%fmUT
z`FCjAr_EVx3H&8e`<MfJEGI0IQ<d8#dnwP$I%9(@H}##XYp#D1;6XO5zFX+UykhcN
zLUI0ZW-c6~D5q{H8+<*pO`okoaCuA%#+Ch8Df{^(P*fa)$KP{RRp+rV2~yDW4?1qT
zYV=N09WVSd4bSu|YzPfehi$M<FkwBzy6Z3)9gO1Kpi9^-c_5?fbXV_X6jgU9NBA#p
zJk`f&D9n}~5n9*+RJAWFIw=-bzhO?)Vf{>1frYe#*5Hxg9^Pj(@u|ZH@2&^$vg<sW
zZch6M{3n;tTN)D^?ArAE?GruQ(B0XcR{~*&Yynt4#{1QE6PlB`$rTNXL8bpzD#H`@
zw{CT<sW`?$vfVqd;tVA5OEwk5a&D!(FHi0{oEks^vl$hV0k-Jlrclan>pq&~&}tJq
zeQ#>mL@NvTaLEW-;J<w5gW9XXh;MBnLb7wO<YenQ?S7b6MOzosjWQ%+*%FK1*r?aj
z_p4#e&GR&ZF4>uS7`Gf=h*tC=0%?=vDQ`iK`XN)Rcn7m^r#MBcC-vUY|2UQk08wg7
z@ZH{*u|U|#J<3rmgU@ET?=9qP*0JtBsKthln1r!Xr*J>GMTd5yZZ`OBJO4fo1VvJ<
z=)so!=l&(x&U@Z$>+hopknwAjJ3TCE$({kO-0l8dvQ4O|iEMKkGw#bT*#e&nK$S=5
zE8(j9A&oE-9dNzlaSl<I6mT{@XsUIiBT6G~?qXl*QadyQ-B(~qiHZKM7;@5qX6dBX
zubGaroIeMVV$v{O5mR`=rwjvMrVxwNyQqnI*`Q^1w(Tt^0t6{Gl{G#HZWl<!%<V)?
zie?&#@c-2ua_!v~AghH4tJP4?d^4^iqrWFr9i{9PqLZ%Zs48GRnF3q>vH8lEb{-ux
zp8GM`ev(Pmz*<#NNnittcdgqw_oWVooi^uy5>hoh!~eMiCsQeb>dHr7&i0~i^YFO@
zzVyGX5rz)`<`ViframO$@W|y)=@B}#&BBunIqDaPJ~L4TnG1*+y-lokW1<PVPgSw-
z%p7!U=G_`N0UP?rNTE($)Wg9VDaoojzCBGLW*z2YRkX^!pu<TMXnwnhFEuqRVlp+w
z5@<eVyZXJwAaeb!_pMyCSF@Fa`<R-14rfMJbq5H{YvUICPHrQLT}FduVRb39+QbtL
z>*yoO2uB+)bb)AAv3+ks7T)DN%pDb-mVDDM@tX_aPBoi?U-an@oTmE^V~<^=p4GEB
zlcp~7q;?0Z)c)1v+1J?IouOb9ae8`jITGJEM(=uUKQ~9&pdGeuZ4925?3}xo$;WC!
z_{!?gt1XM}^5J9i^1hi+D~D```0ml*nYS!aiH-weELWY>M#<Yu!Q)NW7d&%e61xeg
zDIo0b4FvsMpgAP==ryt{{cNM8c5BOPP*Q42AGWlQYFI{#>>PMz_pGe{L1j^Vf-A{+
zvbIB*OZzF`l`lArDra3MUNF3CB9%>8;?;EDU$`A`y?oC|Lq*7b)aAWzTgyhb^2%zM
zBB=Ckb{!IbVHCA_Hfuac+$9XCfudbXh<{(36ST3f7?tgc%)?e7Aw_T=_u;b5FG;5x
z#2v$dA9jro&NAAsMAwG`UvKj?9DktH0=;AJ3(#&P#f@8f-+jZDn;f+?4%IJ`2Us`y
zL1faMT_!_K=wxIM8nBdQr=*v-e@}t_<*$)WD)T#BfoaC;BPd!11aOQf5xu1J6dImS
z*ttBIF%iFHxL(9RnaNd3&e=A8nP93SxjP17?pc+m26<9{p}9l*bR|Fs2cp;R@L7x@
zNKUOYLyGx`;jUG2IFK*?(D22vp%ZiCy=;1e_BCe%eN}H4CyVQLM$%knESTt)lsDU8
zJ&<Op8=TjPr<cH!Z)%f)YO&Xoal8|k3Gey2n2X@IJ9l0aT_%yRWBtO*s|0U>hx*G;
z_K6h>PQUpe17FQ`wZ~boq`@6f;>=a>_+Nh+nTOCm8FAM)fn~>@cS_7!!Xbh4=#W((
zSJjSj)PTdJj;C@H8bV;U(D8;}v5CQbBg0eaH`+W~+5sf4gB19VEU>@Jw!IZTbsL0u
zQX8|4!sMATXqwp1Uld=yM7$8#MN<`Dqeg=p!T%DB`EQR$Rrk{lzOlTpZ9V8K>sU!x
zbVm^fEv$+mx&%~!0-`(b#voku>9yPN#}*jSe2@RW#KmVB<Ysjxg_i3fexmPqTgd`k
zfRdMSK)0~oF*5iAX++xy=6KaTtM>z5w;3lM|4sEu*tY&jzD7=efX{H(a~|giduyFo
zo9{>NJ;06TjU}D0<S9(Pq@)?RnFLM@-<npRNAVoWg1#U5B<TeD#97xbb<%#2Yc=TK
z>A=2bLNbONj&Yb1@tF2{^<aS+LsGoZ>>L2Kp?@vF-2<i8OT@o9#;q1csizozI)M?B
zpplP5q@*PDz^gFzdQM0xy2sH&<W33<$)5QSC+v5gqFsnIV}@c)r;}3F9xpDME-Pa&
zWmVQ?=nwRD$YT*G5YjOgoFi}i3|IHAhnlDqqyLZnD-mCNFSFGHA-hGDW*;pC@W6Oz
z{)<5lR$)Hem+Hc%!#u|vm!eax_y9(UaaJ9RrXv-Jh$|Whm2YGQufCd_NMdfHU=Dv&
zt$l5}(kJYu6`-MM=syL~;gNj!Jm01o#$vR*`MM{!>N&YyTpl<hyG~hTTCjl=T8+RR
z?sGgG%Y_IbpI}2I`O%qU%eYEF9D(K61~p<W4AHllUW@7^GLE&(F?S{^gt%G2#K6Wz
z1F(74g3iny!Z6oXGSXp#6U*3bEwCIZY4omg!TwpJ>%y^M#>(`do<xH*`)_M@r^b7L
zTM@q-8DiEUI6LF~5#C2c8-m*wq#72B;2nH2D68~h8b}4l6qF#)HH}|YTN7w@+vMin
zS;7XW0`-2Q<Q}@dNs}Pv_+_GI`b&~C-!n5!TDOD)HEmdc(TARjOY!xt_0^y>s#jhN
z+2X<Le{8K)^U7!1KK`TEYu-K_aBVEVCpaI?L7&=Uka{;N*=lyPK#sm_kvU`Dw68pp
zb8siILY6m-j<^7tCrP(%J&Jl!dJonr6`Hb?o3@OvM;P>eRJK}SbZb<4_FQo$-Ygx!
zsGqU1+@mXd4?KNU4NY?8qvgM%N$vxvnP5ByYQ2#A;K+*g`eBe5E#5(rD;^k~&jXGB
z5N<wd5iqIyaV8cLwj*Qwqkj`^;*R#k;{GgI2FPN8d3uJitvj?S%_Lc4w<xra$5<i}
zsB?sMA4_HkE!omIW+MxDRpks*?WP<|I_4!DJz^U`(5M=4>O?JcfSkL7b5k#;T#{~a
zw+qW{+^fI!s9N7p>9=FAa1z%Z+YxOGT#uL7dTb-hN_rsgNf#x@n(EKi_3gZRYY`Fh
z=YZRs(X*cyt0D~OKuBPWzC&gMIKd=^B|rVVVdHslwnlRCN~kvHG1HJ->KTo|mw%eF
zs>5$cN2QJ#QY{2%RvOxv=8cRWHet?Z4p&RdP*-fyukF4GM0wx7VcAdA#n3wlejRUa
z%lSpV3k(hAvNL`ZQSj9Er2pG}ia6yvHt_MOrqJ7m7=|FjM?|UGb71UpJU*QmNKUVT
zA+_BgHkld?6*2wdjSU(CBsj(IfC_%jZt6PdG3)ro*jn+^=U6_1>34!Zrk-XK2N(C2
zqYrt2l0~`EWqIP4{g7~P`c_T^QBwsad-yTbC+10f{D%TKtc~$cN+ndOIY!_T6PTqK
z`2H{0i03*+IH&9T15&x#GiC7*W~95c=j9B7UQcZYarV{z!*A<_#EP$h&ADNg9AI<b
zF2w6s!_Tb6y;h-%t2Ml96$QN%4E%h0jYV}2t4u$Ojj6~PV<wL*p?OZF4?7-p1ZKWU
ziYYH@e+1k2m`@_Yg$)JCdlzm9cmt{SZh2n*Rd#(PIyn@|cHJxV^&E(v5L&st+pGOF
zd+n}oSLk96W9S1sGJ^_C>-;iw7lJE%NatG6rPJbNASHgt0}I4FR}5Wd7gKe&bdL?k
zSx0#O<VP<ubIe8yk*7gsu~4VpEXj_fcN%hOpBjTewk0sP)ibuwOU7R{+yK04r}Tkk
zStJ!IpKNMI1QH@3S6c+GB`QKpS)U<E5Uf~RAE92zpNM8xq;u8m>w?-<<8%RsA&eNd
z+93IkV9Q|m_&Q>W^V^1&@l^ozmGnG6oY0k7$%_KSUR+eQ%&y8IV*Wa<Vp*MIa@Fjw
zD6K_Zd?fc*pPC*1K1wt@MeMO%Oe4K1H5Pg!YC@MV(i~)+^ECj|sQG-BKY^-dT)6_p
zwPxV2Q1gvQ{O--XWf|TR+aH+b{8hao-7wr_QzM*Jny_CkL8Sx1;~7dl8~#l(j5FgP
z?H74Nu<FH?yof4XAdgI&B&!^^RA@+Y$B<M}c0B|?`TTi!?6XB7z-~iVa*L}Yhosj9
zjVY<IEOh(;bpS(RY6Q*5ywj-c@G_WRt{q~Cmithy(-a!GX<AmAb#%j4^P2GkrdB|A
z=bT+0P;Y$nYzx_9em0|2k!xXvI4Ze$%fQ&`qbDJ(dfadU%&ZP}eHu5j0DM1<Ud#AQ
zp$p0b2nKvbmhUle6qn!xYs}ZDMoK49`{Hh~Gki*Jn;)2548IKfek5k)KTI%G80NdB
zzw4}$Xa13756k)BLAM#d9pp`&k;F@um$0Gy2J>%$8I4y-uBzcA;F0bJc6!}n<o1vO
zgk}x)y4tZ+@?{|<&d4HH&B<6=I#}zMS1JpcSa=Ddj|>TLiKSBO4ctb^oGgo}rrV#Q
z`SSwyiLf4Srk`*<&l906dv8*8jmpIOXxn+BR2n=go*Y*cwo+V&t93qPlmU(%9lld;
zKfjXa&IyN!c^~OH`IdW)gk2v;GTl~GL@o>hdq>lhW>sT<r&?%t+pzHhW&KNY!l~sL
z5tWYDt$^8VrY?2!M<-PKaw1r$am^?2Sp~ZF=by|OwVuBrP%lk111oWhB0MGvXRM``
zuFnWjhc8nckDVQV!K7ik%_OyPgC|#EZNv_a(tvAUOVOD5D@w)It4kCB$EEf;Jn#b*
zU`V02V8KWxNqU%(IR13;p-f~k7b%-<ilYfJAfcxqo{|yhVj4uU|8l=GqazzpaSfeB
zOT&Ad|Al?`$qnz;rC6X$lU;^qPrR(yo7P@Wb<hwW5#ret{RF!e!lVkn(@-!Uti@?V
zScC%k9&)E*<0sM==FnAzQPf(a|NXLU1QP_~>i44*0tlLj$t;-DKTr3l=JA19iGXO(
z3ZBYt#-oB1W_q$*>>eFtJtnhLpt1F?+OanhJfN1HAxkjz4u|}6(E!_X=Ofq@){3D4
z9cD4iz+>n|89JtxJ^Y$2?)6emzVIQP=V8JRnNw)CIX4rb@>Zc=BTN&i2o0JcIWQhq
zPZM=_HK&iU|L7S+brSfXQgYRR2LK}ij{}Q{<x;sQcAYk82MfoPH#|Co<94}sGrw1s
z*9VZuC%s>7A;o*%hQZqy%k!Sp4P%@HWr8)V0yo5&{(^%L$q%pBXyP|to#sRcl7uO|
zk-W^8uCYYNuUQb0$`~P@o;>t6a&5O)y9-64#vOvF1MK#TnAK2RUvwD>z+LTl;U~px
zzc1ZrS#r8r6{WrVWfr@vxCkK1dgLk4%6ry@e>wXt0FU1gONfBqtD%jQZsOl=8E)6P
z1FyE{`O%-iq9`|bWL6wctU(lf>tm|;Oqr1;pAof`v}Y%#LBa&|D>C&r`z!j(Lg_26
zIPXKm9scRyp<$WiOT;BL;6%Jk3OZi0L63iVJJ*sv4BD71Avq8*p$@#&^ob884vrpl
zDYoa7N<EZb=9)E8NcG_M8nlr+sKiJyq4@ge7VihPja1Hi@N0ZAKF9{+%1_J;+c5=F
ztp`(tIGw^YQN^kuJOK}wh^#xmdkwo1-$c22>R-o}oWFxw(yi2Z0gt+>HCRXmFIcm>
zv8qmHGYKGnpqw8#yDK93D({Jp$){1K*SujHCg}}1lMO385KAehG|b}JBlJdbEW8un
zZCEcL*<K%YbT?f`D!m)D>~*c0J;nR{$qmg-2bIv%tk*`b-ft4Jem9cA#cjbljrz^V
zcp8B9r1T9_snI8L0C>%*_UJj5+N<`b6fb@@JyqmnWj(k)6F9q>cimsAIpcByV-HGt
zxS0L-^W`l0tnkwOW{v)z(=bVyzffKC-ikIOwcb)V@4LmH+&-649^_}fL|#a!!M<%v
zJMLd;y(Stz|5u-4?qmJxMBWS|A-gG-uR9)aPH1&TssTRn2pusV%x?r1uLam8x#UF1
zsEY-eo;)QcNgdilHV1kHFoOfDcD~#F4oNw6rxP6Sdq>JJ^rbg@l!`;GljqEwyEB?1
z<CNxAGj&eW`8W_TQ%4&@k;oe+2|(k{jdu#)#1grSVztnCEr0Sz9qw*$@g5hEU(n0v
z7MGOjJp?{q&)3uJIzz8HAa!u5yXirs=IkGuo)gLt{M>GD7GCm%C|a6_U95G=l1&ZQ
z2kG22vMMMnNozNT0-YHrs8kQ@BIM?7bI|MaCBnvIr?9DIlp9=2?lvm6M&SK=a9r~#
z(PbnC@5N<@eO8)F78;UEziVF7Xf2pHYIrux2b_#)?C}-A-L`04o%(522qU<rqdm?W
z&ZD4aGcIWbs*VGamp{F%jN|A&=(Qu$mQR)y-;u74dq!&=yz^4NWhgx}7PexLn;_aE
zG2wZjv(LP(Y-4vr0eU=94EGGvZI<s;yz9v&Wn8rgEObwwgk{B__ndRS4DQ#zd<wTN
z07_DltnJD#;l3X5Kl(1Rm5~=iN6noN5Fh8mfz_m%Am;D$Z&X(m+R(frSYDPje9PlN
zH%opC&s}U;!Q=R?CnM?2JVUD*L-Nu!_tm`1?Sz#uRz#W@?G^9pWJ4O-I=S&vg`ni9
zU)otmH=Bm_UJQqOjWCE@XDk0)>r<`+uKJ?I&EmH^MH+`!Ppg`CuT8>zw8saM-XzAf
zi8G5o`0KUY2b%BGR@aQKmGPpqD!4&*UUqL5ItX50Lb@J!?AUElsT9p&hTH5o(a$kh
zo8U7Z$1OM9^raKd6z*XwE(z4nJkgm}o<-N9`~I9<`>PaZR839&?Nv<~>Q;vU-PDRa
z0R>+lSbYGTHwL%*A_8wA6^^@ol!_%Jdq#q*S=jDcwV)BusRgWLKnODczUDQRcH5|$
zOWFoL^G*&h%_|>sE)@@6Bef_Zwl!UoaaWwn!VM5F{X}nCzQq++MZRmO|7BQ{LNCtJ
z*z}|erG_<$L!iUlT+5%3PcQ-aR-6h?g5BK8ne~{}^(l2s+2qZ?`@v`4Ppteh#G}pT
zoQw(lbv5)rW$$BL0g6Gs@hVejF)tUht9OV=G5nn*Vy4!5RQn}#Zp~>38+Ca(;`{vW
zvMXr5PFYL+^qP1Sik!bf{pQ*q>aYB>Y>Vy+d6`%17jj-mdaZ`4t}y}?A0}2v?E}ta
z4KC8u^A=Xlu3t*k6C(+@>r<P?lEx8bV??@>Ln>~nJf<zK3%TQ)7B6&9o?7b<lgy<;
z4?Z+?sr`$uf2IQHzwNu@>`Yp2+%*)p_J`_23X`rX#wTM%IGReBQf_gZ203&*Qmiu)
zu634JcEz{#=Ix$Exwr#*Iak+>g-<PjFPjnKc|<%XtEBr^WrisgbIA5*Dv#-|6H6vh
zOByLY^{YOyhuL63Unve-Hg}n8OW3u*yT#AXefn@T$!Ba$c?J17+CY6g96r?HhCN0X
zGT<{wo3vDaiFSQrvwqM^-ggEu&8$9ZSXnsSX*k?u2D%Uj<6U4p);qoX9ReEErvWdZ
zt<S_Pd!j=_dhpTA8TpxJw-o+Ae<Mc_^28icBQ_Ijs}UOY^nbtI{Y#pr1pPN;k+MTq
zDI~1MtcdUFojdm*b^jXmf4?lv;)9DBS5)XFQvkeDOIh0&hMq8#0Q}IEL0&uU(ELfQ
zPyC0!?bvGcVjb$(k+sakmU^O{ifJUa8dczl>>G|+68CZwG8*0Jl1ZG#NfYpwp5vcG
z@mlauxBHLbjA@QN{m$E24e-28y{bPOoyYlkrvVU6f4-5BGoyY~OcG1obbt_d=Hanf
zb#U9%p*i6hq%Hz_5(*Vkgm%x=rzd`*V9I%}&f6P5L&krOZLWE`ZJ$+i9^aoc0RBYt
zk-<ghI8_r2Dv^9#7yJ%u;ID0?m&CGR`RTLT8f?ug#&;dDG%IxDi%f|cf`x^<TDwIG
zDOyewFL<n@f28f}b5X8d9Hf%&tzm~+jm+my91cs@>jICBV<5$r$b*UOfuAGmZ+qsu
z7%MsE05G|(+c6kquakl(exS303C;BcJ#EPLq;r~(=cZb*fJzBa!VXH`f-ZHG<f*be
zWY+@Y$1^6w_lKZGgegK6j+DAbld}zA(BF1Nh&0?ew571||DGrvDAvjMp={iy+Y?*n
zE&y~_!;eu_zZO98*1CG>?~FX>5i*^Ay7bl6+ck|DF+;~!np*)*A(7<;kjvq4VfQXo
z$kp`VgqBO#x*fS6lZ?Y{>b@|acgD)kD;*h$Nd^|TFvdeJHoQ-6UcEAAP|4kbm01BZ
z9J~PMsD;rDq$X#Id$G*Vy~^F-t;YGi1mIzpCC;SKuEKq}pyY@w=dg$~;?(0hrsnjb
zMcFGnko%xzG&wDfk5JFtKg=uJwpf~8|GVq2G)Tb0m`}8L?4*mpToW1`Qcyk~;EayU
z7M`x14OIzngx;2RF=%(?vAPz1=P4gW#@DaDq<Eh}<+j+@r4^m4!g#DZdKa?>JiYZu
z9`h4W!k5|wwmzoiXXPw1t3Lfr`<`dbEX55<Pc#~zlVX^1pv)Y`ht=|uV}1Ibh@S%9
zwNNeKQ{O9C^jWM8a5cU09AUd(QOD&yK2kOwta{iE2d4%&?fHerwf&)2U}6<)g#01u
zHhZh@b?%7!wbyMuMZ+4esR^L`a7A`KTh~jZ$_BL2&cDC>mAn(R-`KT#^+>$O@m=$M
zYy6@dS75?C<i9IeND+%;fNb-8=1bCF<S+-vfW>wY`$fb4jlul)Dv@$Z^7Y6k*vo!#
zP%V#2fxG0`e=<MCZkr!JNZ0?%$4vYi)Gc&@ic(1gFK#3hj)}Da@(@&{Ksd0uE#^(d
z(2W1o$IJP*%7Tq5wpZ^5ku}f8W6qyjqN46qE^?`D@w<$?zwA<Sm>C=HZua%FaXAJk
zvCCJXxVx$|gP!May^4FINmMp2F}4c%-ldH7HE_IbEXWdm%`+)hD3*AFN+<y584H%l
zOimKa9VA{g{vFx_j(pR~8dDDuOzjFOhaj`Daqdu==9Qr_e3FkY+|M8Avu#_PZoakw
z7Ee6=M~`9;Ng7c@3ff|DDizdgrs_7Ap~{U1$KY<o8^}U}SrzA+9oKidYwN}re|kmP
zNJ%}#Pt0Olh;RlQj!$M1bA84t%ablrZb|KD@%3jSIXkI<Cg1Xdxyit^)10fzVbTgZ
z=^Jl+aC(@vJ?W+U%?)o;1QHZnT`|{Jd^!8igArT<LYXMhLsR$&8!Bj?t~lQ>j|KWz
zR`eqnw9NeLUR!zkHu~p{9|c~BSd(;-^bs;I*~#UmoUZlU-85BM;v@7<F$Spd*Y(9B
z#t2T6qXGJ-KE96UbWb?L)&3N$ajcRY5#L15V3xS3R&?a~e>r#RjHhUz=lAi(meIwv
zyBFZ-kGCEfp3t#hp$)uJ5)yU1u4yPqlnWYyUE~Sh1V~&>+o{#-m;V|+9>C|awioTC
zBPnW(U9$&C*f_KvvW#)ZT!S521JhF21qa1|^<;6*xR4=_b%_P7b^n^ClOkK)>VbET
zq9wXyukyS!l^vg~rvbOC`gbS#ELGK}5*V<XB#OpU`UCbfV|!8F?@Oi$J>zU==m4BZ
z@P5r9#2G~e98#H{hyG~uzQ^A<^plvb!4C`XOg^`~jb@^mN?8>=I7RnAi(H7QZ-J0R
zjHDf~%_yk^*6Nnx$-vgt<z$nd1hf-34BH9!NoQ+y#2EogGH+8>CcVQ8DSYm%94Wi2
zHiMpxh1=bQcO>VOzoU-O!@;hiezduX=}Fc8**lp`fuqRM3T0AydiGM<e8pNso5}|v
zb-vvEtz>#9*ir*AOdc1>4kX8WYrsCSq<AR8!THeqYiMji+hER#e1!bo`Duq|OXVSd
z8XdpNx<hBO$4!J8{@B1nxOHYyn|BXaT~J>fR}ye-MK^!5=Q=s<)|q^rLKx9lu#RDY
zY8HWbowtEhyw3eVDx4n<-thFxA3b>!PM<)c;eCWod(=90xP3qW1Jgtd17$tv!}Sm>
zU~rppemyC=1S<K5J#CrBJstX-M{onzEzi&Fk~rDljG?z2`(K0+zk`GCh3bAct@6qx
z+T+VTzT9y66e|;Y5}*2$$CtzNb@V_v8Ns=V*jfxBY%$7D%y_c@eCBaG#~c&3btH?{
zkXG;`Pq}!nbXlp8T=<PJklPbyGa|9VH6?Vr`cS^nD_@}X{)RV6Oi-vP{P(EbC`vqh
z=-Xe?-h3qk(GW}nMjF~CZ)}}=Ktrs6^QS)agbiJi&tfuOs2&zohQsgjN?|wMrAOhi
zLo)G?-Oy#c&pypxlB}Tt%JWNsAUz*^Y?ncg`EnI^DkXbF$REIkx(40osiJ${#?0&Z
z9PHOw&0ydDxMO)UHw|K63=%KuiluD!zMrGIcAk7Xu-Uk&Y?}{v9=yA~Fl|3kfAoM_
z2P57G4RhN2ET{exo1B<$6=uMDf~%S6!0Jm6C&Z(+arhYcaeDKW#9ygX(d>>MlLmCJ
zb)x4aMAS}`7kET$pNXE(XEodb%DP1tn_yn1cj(--fx|{dASHwat;9<;!Di7GABX6_
z_JfmNjmAudkFzJmu3XbmHD&imCYNOtt9-<BgXQLXYgYrK?QsNY;1`i^;Cm}?xr2JY
z>F!oNfWSF~{^k!hdji%*!HR*IggZ&+zvE0-V6~^T1$#td=Z}n-D*p(#R^xWsg8DK2
zb@JiMyB()bYioe$zk2`?MT}je>m9Og@JInPUWL60@4D~NsrOB-DDYmQO~ooY!IZM8
zNAM9<A7VEc`0u9UNb*h_!|9(Mbp7uGzUxXN!xxpCHmPeF+-FZ858d7@+<8{=SOah|
zuYoIcKxgh+1z)Rv$CQVILG1e8{_n_2zvFhTQN&fiVu3T;v3@%Z1aD@_gdMUpi=3ui
z9_L!>-Q1F*=ai5o-*?TTHR_isj>3_f4gOFp)mObzH=|O@!VB=D9yXRVezD6Gc@2S8
z6{xQz>T$Mh`Cs82;1LAA69{lHM!9(XYJ9MRV~53lldkB*y@IAeNHt)oILfDGff!sZ
z^&31-r}29%;~5C9Hz>U%M@A=UE6X+hR`tt@VwoDyRUvKaGI#Z8z2Tu*E+LASXFoNX
ze*F{I8e!oVxrGUR*@?MbSI0ckU6>Mg_a<q`4EL2g5|StwKR7pwX$Dw*tU_=m^n%D5
zy=odX39Y|q5kHjw(kFEm!E?TgOYy?~ZL<U}F^$Y1n;j$Z#jmrO3c76-iCw{_%Du=y
zib4v;Hk#`3w1s@=tuJeVBF8{QPX_;=kS9zXOZHB5bl~PlA`@?V?|bl9$kR3#^h8V*
z99?2jhBQ=6?k8GbK>!o8i-qy=AKs|C{YH=B$U!m8y2mcrh$)BQ+A4NL){BVta_`U;
zXcuY8J)f)hU=Y_mdZtor>vt9*)nm-S#s_iKpX=U2SCiA|g(oQ)G(64^ydFa&!*F05
z_7hqjDa)_4LT>#)*9KK5xAD49Rdxq&cPOJJk;eM)O&+&Rpj?-AfK=Di_a{z(%L0xW
z9b>mmvVj~1t|$pVqlU^5cfZ8^VHi7E^B($f>LrgSY`j2EXxb}qw_xW_8%criKCDY(
zV4u-ke(0;K0%Ne$nQx1(%XH59Khd7V(ac;$A6;MIx(g`8z?xsUxmg(BdvY^mR%hXB
z@+z{_1wE<}IIzo=n9EzuNONHb@zV`v0WT3$VrPIBxoq7OchNJ%u$!zMnQLG0zWrRo
zH%7Xmisw;TiWx}f@OBqV0pvPsUl}bcwL!tMmm;+<!!YOamG1l@iRhwtl-3;Q-H`@x
zqEY#%20d!{qfY>R3%=yRD~g>J8EK2#0ARA=Y`)GHc(ZoT3sAIK<-{Pv8DSzKbi^_#
zeu{5_$wAjbQ@xosU*XGOVa&=n9G+C@8a?7%Mow)Re9QJx<7y@+X*KK?U2WZ%ImrnB
z7nZIf21A#KKl)@lx!~?QbxA0P_#6DtEjzlo4-HZZn5Ess)`|rF)jsa=^+fGifC_Jq
z0l-V#ZRwV$kdaVQ!e%FmULsh);WYdmj)@C5nKU{OXxpKJ2{$$`ZT~Vo%?}!JIq2NJ
zU!FCZaN>^Ht)A*UtXs<&XP~YJ2SpDK@x4i=Uhh@oWlWA57hB07dDPAerW09DzLvVa
zCG}_F#lRwMR`3v;REcipjG$+>#&Ws_D%Ktcq{Mma;??uQT^o;5tnd{QPY-vu*7W60
zd2FtzC>TE{c3NyVEp~26Hcz|v<BkoI1YL>Jda6+}vfwe;Q9`HfcArG{<mIM*c3{%3
zQ(y#x4}3^D<qv+#OInsKcwMP`B!_zotjM%Rrn!i1dsDz+t05D%D>w&+<0&q{K?0we
zN+VsM?u!A%tMy6)D=m+mHZd5OotiBDci%Lobw^F+dTFe8g3jF8$_n4&qY8^1NfPvP
zMJV$itW&`9dbh$p2E%q~yc$0$-a`Ym;Yt_+qG$4`Gtc!}8k_O#F!qfNS-HDi2Ksy)
zYq8id8FVpSEWpfF9!6##?nD7CAC7KVIz{8blbO|2`X}xjQ-l#(boIA4t1MD^i-QA%
zxkdCONKKprQ>8#@RsLI-!o7y+hIK!%BU3QO2@dmkd;tCdCTHOWc>^x&ok5n=UT6-`
z|BSWaB0wY!02dA}DW=J+WG<AzaDu*Ixm%P4_a78D{Y%y@5J9sEa{$tR-iVX^AF6Pp
zX^^vz@ZstfRgz&~@a)DU`VOc@L~w5BgTR5Ags&eooQhiwA|)&OO^xLPC+d3KPu@my
zYmP-k>*~GYN~e-u=()Pbu>HkviG|342rba^0D8wS^cqXR<qwqF0dGZh<{JXv=t<IS
zyq-AKMj^@BHo_I)bjS8qA>E^SCKv5@a^7D@Cds<)T{K@vOj9~v%3o+9!@I(u`O<-r
z!IiJtrEAfGj3JBmEl5lxJXzFY(H<kKki?HpnniAmq*c#)-C$7itWfu<Pl7!Dk~RPy
zSbXb4UyAeUa!ur$Vp2cNt@r5)Z}zBuI4us5%fnTCBbXy_LXw=;WxX%;?<Shwb;|zs
zagaDxnka$8Vc0wAp`=BXIt!%pjMH;?4JoM!8Cb$;KCyKBOIM&D6H}d#iyD})RHl<=
zrG?wyRTb>jMl_EjIFb`zl)^Cbr5NiqzvMwPwv|~&Sd{QC_f!gweep;q>7vLh1yjyD
zrbmx(zH}V{6+Fqp(|fnbSS6er4=KZa+}g)(zZ+Zriu_LZBYEfpA-t7BZ!vcR+)R|s
zb`Zmf5R97n&yL25XJT;1UEQ4ihnS|`ek7@01mAY?&eBU<;5(d{n_laj)&D*^9lHZ%
z6W7!nR6AbiD)DcOr%m%UnN<u8r^d1IlT1l^8bf@5OYe|G_HH8qth*UZQGvT5ttun#
zj>od8cb9+xCH@~6!4&1S2kCq77gH<}Wr6z|wd0gB*22(_rEI-8LZxiJPs7i4o{m0i
zA^*Ndz}*1I>gQl*tTQOXS9-21|IlsW)2=%Iz?sX)N~PDUtMgTJh!TmBIq14yNdPR3
za2)6xqM{pNd1QN<Aie;VQ+v8m=qn7Xl3fWU7q%^z*jqSyqGF23F}sO2B$h^;<Mm=B
zCQE1OjCfThA~X2V$WHP@DaV>8lU#@)iW{dk1hl@DW_mxTv)KEeEPnm(<O}o&^tGNu
zvs5j-J{9bhE=-SA{KB`GewBSPfJ>hIOJW)^I~CY5<gpB%C{H-&9B7WAyqa);`UBi|
z(f!Su+ROExXUKV}^F==*c`2UTwxE>!-mk!I{%+KR?&BZCqD4eJI*;w9BOgT&emX_E
zHqFqx&#o|NgnwN`V!re4!gS{eK00=2)TNWK#3Bl74eP(3IM`EWTBUphoInV>`qbQ<
zoIVg?VXT9?bX%HTn?7FLQul2H$;+F(`U3suD^d5oGqg~0PjEu7u&NDj(gS?C+F=u}
z+CYZW#q?_b6a%&Gd^Fi~abj|_P^52qYqw=SZ9l?5zkI&Cb3v8V_qq9D_aF(@LAQ$J
z&0{5!7EwYhF+f6A|9XT9*tREK@77v5A>e9;)ZrRl8p-2JGVVqe$t$`Pf^SQ+n7b$9
z3|?QBAVqI~^$ZplF*b7-8^|v9M~;$7Gt3-+SC#aM>F`T|29xZMPY>^a6p{qapX-bI
zQtnqzE0Zx6HcZT%lr_m8yG#c#Hg|LPqCtk5#*gTBpMDIc4kp|O<TJ4Q`!HyJs+tgQ
zy#JTX?=FMzRjKpsoTj6MFHSPa8tf5Un4}Ijar!pi6xmXx^6xV~C6$1$GDYOjy6Kbf
z_@19uM!5Y!cKjL=I{KF`tPfiF7q5ZaPjobWW#Zd(P*Ub*Dvwk-9FW-82?n89g1aB3
z9#-&XZtviwFiN=qy$Q$;{)uC`q-N@60Yu+*!%E7Y=(IyH7gEJ3+R!i*xK|LXnct>E
z1fQ-Ppw*E4hN+7%;ibE>U2<#90hWO$<s)`dSJR_OhVuxTlqRmM*u~ua_vZYTdLyf|
z)bE;~@d~=FK7U*4-f#SvM2FsO-t7aGq&I$Ntl=tWoHbB^o>JPGG!_<}{-e}5M3Vam
zLb}qC;b!saDZNUhkCF6}{Uf?u54neSUw!$GaoBz7R6_i`+rA5g!5;k|uHHNzs`!8V
zw}fP?lqHNxQ3+YHk0C{6YqKRrA;j2sW{#z(EMrNslTh|$>^o)Ohla6@Y-1VgFpTX!
zKA-RX_}$;%-{avijx+N<uh(^5&nt<j9w^Z};42lSRzQ?av0+Y<XWcxv?gg|J=s1Ob
z+R=n5T!<LWIOV?0nQ~D)evu`9<aHC;m;Gz)fSd~6Ai}!$!z+MRL_;O1z_b5L%^8)j
zDA_VSMmj_Cpg48XdC*e>mA{;?PvR4*oP8a(ku#MfQ*~Ot{n^yfe#o)u@ug=es=eZH
zH*hV|T(Tjf(aK2_dU$qh8C^~T!DLU-J(0ST6<D#Ny%Zww^sq4(wVZl%>3PK6nb!-U
zD({xLkM~1;V37cXRvu#8B$;KITKpn{yGasx)zCtRyRPduZwULPR_yNg>zDruFWjmW
zk>0$<jaCE>G6eNjU2ruQ`j%`=j#reUGaH}PKupG<gXOZbH#6F1->5`O<Gq?3=aXdG
z_w77*28xTW6t-Iz7oS&ck~DB4Do!+tUJ48g3-KTj<rDzyBOkS|^8yocdW)y423%d5
z0BW><J`Pq=ByFwTV?tY}GBPaVNRHJeGC_NF`3^toNOFKR%Fo9lz?G%_V$6hUz>lgg
z-dx_5B6f$D4HW}YinAT@*I5oPvyk|n``N~@4ZvNC<{!nxcrV9I=+wASwHV|3Eam@a
z$_1EN>t|86Eb{duNj<>VD689Cfi%m5Z!I1E8oZ>~HMQw1u&vyy9raA-&VVkfSV2GV
zh<PKc+aBTf?@LB@B)Xe^?#(OV>F-bY5F>?qy|<3iclJqm#9_<k&G(OOBV?|sZ@5T;
zlG~B99NF8s%KgHuC(#%=2>BS%UA@*7Z2)91xEty1J?qDjHn_S%uyNaq^{By?diJ%T
zh3X6WcYjsz)cx7CE|X+2gtYUpf<ncI+V<4?p883r0*V#V=Uho{(nLjJv?^}K0bK;m
z!nW1dsX%k1UhhSsmRL8UQ<vXtKT|Q&Joym$TraxZSY2XN{Ic{}M6nf*zw(`B(0@a_
zbgEDaFKG2E#)UG78kE#s+M%Q?{B|wW#XlC<-FzkvLuWUK>_Y?{h(861&i9^=K2d4%
z)DhTS<fNJ#^&!);CHiK97G0_;dNC7O3ZvN^PWR*xH|cE+RT?>8H4LG(ztC1r_aQek
zOQnYvK1>ZQ+UCyGJHjX5P&yld+mo}~wON9;hEP9-HYm~ifzUy3Y;X93!4|2#>C85@
z(l#~@uV-28{?ghZf|ZvKiDQrAscG52?7s>6Ro;wYT-rg{WVi8_CzhOS6w&(GVjoxh
zc4$P>QapSW)h|IMLZ^SlNU|N04f&>F^7ys=B&vr!GO&p~12{}FodC!Zel<I!8*7W1
z%7<F}zhI(*4Vwcx-cwUU0);2K!Yk=(;8m0Auy8YIom?Umg#9&A`LB{<7kcWH@#G@s
zY?#M7Uh17tYR0JoALiSqi)7$-^K+sLnIp!-s`fW8S&W`Mv4bz>pXUk6wOeiv_d}nr
ze0R+$o@O}*u=TLF`me@<(`60|7%p=i*C^0rel>jlo3Fx5j)S|s<Nv(;j5(}^f*TCr
z8--kVx~OH|<XMD4xX)Ketsga={(qI0|EN51u_t;+(Ffb@4{NBhxcqIEwUXQUKDu;G
zcQZY`mnB+lsZ~aM?f}@sYF=GJk0@Dbvn?)ObuO^qGdqXKXAZynt2C>GIF{qK-}ad_
z75=y3eN9Q5pN@CE@LxXE<2P2y(PeP6w2+2xy@mhxnhcAch*4m&x^Jv)6@?eB1Ogi(
z6^^eS3~FVQ=)L6Z1;c8$U4$BGZvU?NzV=qZMdJn#oUJD@ywmTMdGyS^;B$%bp$XQ5
z*DYeblQ?#<V<BNj!UE|YZiR<GKN?=PB`;>$?06x4ekt0${EJ<~+C6qG_A$&>S>&#i
znrE)IyIN7-`^FYi$X;1%;cnHnzZBUqGJhi=_E8#Lp7uP5Yw{!!LpU%J*2mwGAU~SF
zI0aA*8*l`Cr)QnfzBc=GTjOzHR?Y?)Fv1-?yn*0F>^?3n<lLt#-p8<LUiuOKCB$Q*
z!nF8E=zIMjsjIuUJ(Sjo;g_KtxBz!ab;QeO{eF70zGNIQ$tsNTnHIIG%7V_JB9@#^
zg{Z&WzU$Z19LHUa=MAhSTa4&BP4Bi21KTghE|Y^vw}KKq?ir$NDBe(%%{>06Hh%$$
z1z%79#gVD!dj@p-ZLDoZ2t;H%tm_f!BLw~r)vgY4iC<&4x{V|yi0^*iP6*4~!Ju*N
zuPgT>%X{~aytf&AERqzrN^IR!C9D_8B3|{E93Z<no}I(bAxZ5*-t|7Z+0;VdH^*W%
z2WuDA&(;mQ<Chw@_L%y;(gl9eb0=FORB5=8*SG%mn&@(RLy0U_gBs=I_0ZG``Xi!t
zT~<_YFA{QSDRQr-?NKV$to4Gf`7e)q(#n|;%S9<1(Irpo-*CX(O@%_IdG^mY2)QSD
zsb&l8&0Yv18pGufS$dssH)3T0YKgITIyCn-qDsR<U3r_n6T?0E%=&BXbL-lO^OXgU
z%$q`AG&t&RiNN;$%z`N|CnXM22Pv<lZY<t<KW`W6nd%|_mos6Y&RCl6Sm`-eyjz5m
z*E9><XrYZX+-svmObc2%km)`D%_-i0sj|<q`#xIDNrv&`K==J4aKr<Qo3vxa01@rv
zAr>>DLPTJOt}4NNoD=5zX5eewj@1ucFV_5ft4BYe?oA90b!okqEnWp|4!M&yuqhTV
ze}up)1M1E6^aKRibW9h%D6D2Va<jP;-s^7qq(sNrt*einlZueDO)^;b1A$n5srltR
z0`5&k6P>S)L=G37ziR?X`>=-P)UGD$al#%~REB1>C&=#WU2a~Au(Hg6-~&!=O-mq<
z;1crrf=qKzA-d^P-e6omyBT%P{@x7aG)gbGFNgwq3NR5$(epnE!37?J27T&!deF#C
zLI&-)2#LlvB#B;d$W0^d&qrw{v8z6(p|})5c_d$_G|sdK_%rl@o4EWw_0Q&z8h!T+
zhH&P6x!vyLeY$bM<Jq>Y(1x6%1HJYA@&#Kt<LeED(z)YLb$Th5o~pad5=#&FAJK2&
z_JaKn1YTb_4KHYlW4y^yVCOX0+PQfzw~YfTYg7eyt8Bv>bec*t2{~%IY%s^GPm7UH
zW{>6Xr~WDeKLR4+FL)&DLbtU@<}(ep*3tR!g|z&dRYj5_r8L1s77xzBqXt&Mqz9+N
zUB{uT{BHikd!Y3kRt2hlW9%=X>Fm~%o>R!>SK@Bk@(ZEH%u1r&IXX@*Gkg=3Ud7Qf
z_mkBr-PTaol8p)30`&e~qhNo8>ul1Nm42a0H6Se6^0tgkgwq(`8y#estoC+6wJ{CW
zOK}nBNg4Q9ygS;*hn_k#n`_ZRN%kK($=4HClGGQzkE#uXZ1qANOF-8fm!Rcm@x~xi
zLDKi@@EUfC``^?clWFP41-&_?CQb2DwH_DO1%y7N)RNWtnD~o;7UPDcD1A%9V{wI_
zK>RrG!@b@eEYm`N2R#%qL%%Zx97l^PZ<Dy9T#53YI(%MVvjuydx+;0PP_KL@+k;d_
zwpn$QQcemymRICL#+Q6q%l$i>dV0yOUlUOvN9Zye&dahJqZ8~zmDE*0auz9!<0{*6
zaehw*jWW{1T)8a!g_OJ0Is4T~&A<S63BjC`bx@yhpwv($d902Nax^q04U{E~aYJSm
zvil>_6=y?L1fB|`l^Jm4>xl0Qaj18EI+b2o*7I*{E=eHl+VrN9COlJR(T;e_wgJV5
zuVD9LR>DH}J_}Y4^u@sssfMw7;)@Lvyzu)K(!wz1e;kfnH|B#kRMEYffbeFRg!0VQ
z-RG&=gP@!Hp1`i#J;7;Hzm7jKa*&PIjy@E%bV*3TQr8wfHh-b&eq5QA^K{sYxoKw9
ztg1(A{L12w@+6>LcYwP#@*K2V`D>Q60{T39B}(Bk&2_-qHoDL`!;#k!v0StFNbYc*
zrJ2+8j<8pYv@!kRbGa=^!1W?xCyk0K-PUStZE7O)>gkNF&n+9aUfqmXoz?>Ut8!o<
zTJGt_S(O~86T^k#EzrjB_W?I^QT;f7Tk_cNM5V|V4T**EsYPMGd9D328H~aXt?2XG
zKQ&45@`4MQdFdEL#Y8!~qE$D)hMm6sdDpbSb8Z6E>V*{FuTKHzgxa8|0#6Q(C=Cs)
zmn}-|M@ziTRKN||7w0#>!QRfIPrd=oW8l#xr2)dw>ply#Mg=JR`zUnl^11htZ&(Y{
z0?sM!&BlnFU`RKb&yG&`42#0`HMI8svo2PUzD=ZEh(w-{%)EwnPY7l%$NN)&OUIwM
z7b-!$ML^xrcA-Ry0;)z*Q^5Vjz(IeA$_v`hJ|6#gCQmUL6nUKG`Jp2>;pRdf(2Qdh
z_;#?@2h>9bA|)=Jv`vV>k6UqC?5tzbDH~ymXXB*TZD=7VfoomqlJi7nZRI0xFd=IQ
zi<tiMTsPjneDv*{*YO<uD3iUUtgAUHW>`8E*z0yV6(*Ox0SYT6$&ac`?JP*m?y`Js
zdnY;>ogL%O-9qo4SuhKe>mL+#(fl2~o-<t-`J_)Iy6VWdjHP><0$O%m1<bWoyyovK
zoOc=Kwy-@2UjysN23?9~SMub29vruyuLnKl+KbW7ntG9WNcJ!laXUqiEjC9LV053^
zSI+~C^tqge^er9>ffClBiBHSG8I^YI%st)h|Lmb1rk9~>-g*N=B2;p)Ty6Tg@?iP?
z0^yB|GPslIbWQ;aYvz&^UR2JSKXo#5ZKl*y>a+?whGv9hPH1vpumCo3@`bYR1qL{r
z+;L^nErnlxk|-XZ;EM+WEGAD31!D0(msPD1mwcs;!MvUP==XuM=5?Uzm9kR3Trih6
zAOw^0n%qh;bk&0OG>Date4h`M^aBepOcX8ULV_+DLA+<9F6Ir0kvdqQTfvZ-X|U$U
zXyDn-Nf``X<_USXb>iSJIvaXuTUPoukD(mwhjkT3`vJ2;p@k>Zx=g-Vt5se-wKMzo
zju)d<71-g8T%)DT?Dl`TLqkB!SkWw^Hk{U5Go(B91RR(d;|Ky?<~?7*$=|tSYr9#b
zHrxCCtm(Jcesk)*qi*$HqVS&%S24NgG3$$~nJgQflh9^|lKa2wd6JVMwxMiNZKtFU
zo3H@g4ZU;y#rrqEUAOZ~5ZdhVuI|$1AN-4_Y9EnDYJX#W!8_>PF}OgQI<q-y<#SIK
zFB@!wr6(=Ufaijl>s0ecF{u<cobq>1q`z6K+sQ|?`bNO~EdHE3Ni2mCTs#$KF$s{V
ziy*)jPU$F2oC6Zn;vpU*W7(iAp9yq2!&suHl8!J8I@q`7XYzGg7ePrAiijy)HHnmh
zg8yI9Ly#+K>C;Hdq@5UJ=g0rT8*%sU1Snc&_rwoFtEY2$S8Q2M-8#Oh=iQ0n{qR_>
zMG6t|8XuTn?bu{unkX3$IrvvqZYg7}G+~>aoP`)Rnd{-vGjX~ztRY<uV7bQik6=eL
zFx?Zj;|oPZ&466m(O(k;6rtgPr=#^f)KSUSH<o^bo$n8wj{$jmwk$UD%MUU71h-V=
zPW(bTZ(hz6tIzaaj7NJK@0hLhGweLinL^&uW;@y^rl|+BA{84-6@ztoW(WVc^-TQr
z_ZEZ7H~zAk&&6y#5&@EB5CIwk4mB3Bg7{s>-d~%T{WK=%PwFt;x5W&|_Rl?M$>5%I
z+><9(f7`LUc^GHgV6RIl(&A!8$+8R2<&Ts%KItXNw!NgxPSTMdFQWx*bl>3vyB_aj
z11lD1cD%-wIeb@&+sH%D^~CC`PV5CP!MLOajDlx}t!ozGjzBMGov`^tNgR7JZBQiG
zw)N7`yVYVL*|R`V>_)t7i1M&tKV6b7%Qevnx<Xr)`CB@I#Cv2S*yFm4VNllp8(5Y=
z-+D%Oj3LJlcnR{4TY36#_VXWL7@ovB1ax8;dSYcOUOJi8-qe(+y_>C!p!J>3Y!FHD
z`iEh#24Zo6>CKL`4~HGs40TKhig&qt)QiAA9-Xnkbjwlxc^RLLkkEzM5J;Upd)2zh
z6G<3K>`qcD3!>=`BD7#|fvZ->r18b>k>#t*o;j{N4|^$fVrdBz3VEBvnXe`e`kNUw
zVm7x@E|#Zdw(2C9ML!_#Uk|CZ#0NfjfaN;<1wcKdAZq&j?9}$jvO1nau$>VLZsJ2n
z^pLIE^3b;(bNfYB8(PhcXlDntC5+gUoIC~@tkU>2`yWk{Je|}c3g@lV1B)q4oVOO5
z$ZxLHGuHi7zR50N<beNCl{Yr9D`y$)?b*!~@yoaNZTD#J$w~5DDlG(!B4;chE~EhX
z0^eaty>^}m?}6nMZ+}Bo6~w^v#q?TH*Z-V$Hv%q7Bw^y6AKdfseszemG@Ko~pO^0|
z`dsPqq_hoVzCmD5`ta9d&Xo1{FPVRtTWgt`9A9?J%wNr`_0NrSYzlX*H6uOyIi@bH
zT-I{I3{wM^?{vc^i?uS7=ab%Dd<*E?;M#8W?Ns<6_dR${`aXum12luUD+Hq6DhqRX
zHPQ=v9&{-gU{9#*%aZRky$w9YjB<yQ1jK0s;frwTAH!J}rTVjm3zBas(M+fFu6?&=
zI>najX@xSFRxf%}AvBO=l`j)JHV`lsMwrzv^wB5XAhevBdN*+fhS?wjIBYq~wY4PI
z-uM+Ts=igSak}HPKqHvCL)=1qKv3E{dG3ETIBr$(|2m=M4^w7Ut2x}g)Ft3C{yHVg
zR0>%vY6bQQg%x8;9N0_SA9$|g_{V=RjFs(k)vuJlgVDfws{x89V2C#SGCJMvm1Chv
zLzM8YAY`vPf{3LaG*DVHPky)1!Tv=6<nB_Scez)>MsAiU*~r~E{2gjaQ*D{utV>hW
zQViAv8P@yO2ty8OYM#4s|A2cOv}ZC1Wzu`dg~h25B+++;1W8nm$bIG8+-%8+Cd$DK
zj67Uc^Pb~?R>~ow8lpBT*;$*KjXUq5PVU>Kb)oandZ`KrY^&?RyZ!HsBCm&fbDT;+
z*-ny<>Qn(b`GHe*Lp8Q`wF)gxvCzhiT-)l=ogz5^`*_oxYIT;O<qaE?_e1h&1MgqP
znF^NMZI~}~i$5_Zxz9s7Y`Y4w_h?oUc;SR|iOKhT{$%A(c)VBZKvo@%?lp1nnTN=`
zwWC0!K`yX2)un2xv<!YmUXss8W(c&aniy&K?ky>}+tnwg(ja$+dL=J&AJBTV=w2DK
z&SvSiLR!jw_a$F;6@b-23^O<Sz)7O=)co7cK-~hbPXq76p9Wt|epH**`Pjk1sile{
zlqOlrdMzZijZ3(}5ADYTdJ1`b$9nP4A?kMDg8>nZ1T{LyvK1X19~Qv<<+;IWl3w74
zAzT*xGU8@M?4-xn&fSiM5r3KL>}1qS#4p$PVNXFes+`rXjjz}TG+d)IcIyp4BGdI}
z64W>?-t#%8hroEslhxS7_$w>EKzm?wH<q4$kzV8@R|1U~48by@{C%r^TN3T94fVJ#
z4fOWyKxY<nBp}&dg^cgZ$&s@0X=v^U$;O`=W?szU?GEzdomj}F!DS5PNYyRFp&HgI
zfA~d*doaS+B47MS`4)+u=0F3z{`<=5`cwJ*r>vXys+!rHMu@hW#;PcMa3R89w%%p!
zk`LKfVckpj$<5sz;-BUWQloz3LUEZVK$e#ZpaZ?<PR~>8y=794G~)Ur_<zvzFOp=d
zO&O9Q6fgekjpb<{u^eklgt9tev*8U@#><8W*Te*2IFn_cKO8Dpz$#Fr`U=rCeEbV7
z<`i3emur=4lLp-bZ?X;y6N*|<XV3xh>ONon+<lD6?*0AnU5K~$aAQq^({12;zl@=>
z!}e|->C*5xXHw*Q$*MUq2V*p}F2f2U;6(_1>Eyf6QN7%~$bsket^LW_?=gSg>^p97
zKBMYpCFbmAB`%}sl(^HrN^n*+FsM=%Lvzzbc*-nd{^jmqn`$_~LS7eR6Y+UKfxgSk
zu<<?>#!=Gb=znm}MDg&R^cEmdd1B&oe|n;lW+9$+E6BwRTDJH75V(YmW&U%2Q|bpZ
zW3Bx12Zy!gJN%RSuisCXX{v8Wgr@yD)2Dmh;_4lFkg;GVHFLeOz181K(slBNTrP!l
ze6Zt}*u>qRZWW^8%Rh7H&RL8NHi8DiYnXeNybXu0H;~{@rG&$xf!Oa9#IwJUc<qRN
zqH~$+KT}~*xWo;XX0ra2JhI8sYct}7*WemW$Tgb&2&xC)x}|&j72k$%R+29Bt?+n?
zC|Ojht)lU91IcHkSfP+)mNuO%5C9SCRK=5u6I80}m;!s1Npn7FQ1-JN1}$Eb?{f2R
zJzS@gQP|_oV7)^CoaWmyCn(ity%BZWf6J=dVqDhn_RbArIV!xij;EL9;+@`4-n|zx
zAjoJ-=dreP+oU{CMZ%wBx7A;p9IwKh*UpqOaYO0dETUrjcZ}}scrOn07F%DESXI+T
zZ-fdB84D+qerK{HyGEjO%M~84i81HMO&zF|6`j59yuzOiOx*FYxvd~Qv-H76$!Ics
zZ>|t!Y<PIViC8Mh8fm(UwRRnG=mn|o2ZQR!ObZXAI#>FY%|D;|!bit-OFYNOEI;6u
zVC}o>X7=$G)`uz7;hSq`4}<PkHiB12<m3{!aassBbrJbX@Nic%b8A+Z27#^;jkIK`
z?X!e5RhR?mZPeA|9|y~tejt-qwB*U!k8;k;B>N7=k>o3yv>erwqnwqO43)}GhQLuq
zDOxWBocz9b1(t3DEWCU@@Q1sf$yGtsu|(*7@PlyCiFCBT3LgxHAsHlcc+7Rf{NWgS
zUJHuSYLNxQ%KSCH4=EGwB`pnm^H3FU)#EqPz&Nlx=IUx_{s327`T;hx^_OdX=DFZz
zVeQ5cWy7<f#>s4oVct!%VIx%UP~bIqryA3-n7PPZ0W}cm#B)_T((iGOoSSkz&ZZ-Q
z-=_30Z`DkhzR;j_OE>%tn?3#oJmR63)_NF!UpU|Y-kqjMeDM5>T0&2eS6I`xL@yE&
z2z0s3TG!Yr{*_xXf6`$aaL{KIM@aD)5Fo$qWI@`TFYwdw2i!9-^_u>s?Isa51?H}9
z&*UXNJ;e&;uYp3I5(Yehl}loFy@pCOViGs@4TA-b`a`<T`N%Zxo~b@1c~q7_<L_+Q
zkI5}0O?>rP#LxW9PkjDYMRS8g^GIC*fGSz@=hoBoe&ipTxqz?H{S$KeNh0{H35v2r
z>G(2=aE@t23(}x~b!EIOC;Mw{85*|_BOE>8b97ogz<Czbdt(|eyWF$<q={jOrdoEN
zVrY%ME&uFrdk_<wZ+fng$S4;vT3~EYZTYCcgA!q@);%iLzp*QZ9u52CLVFAFU&}rw
zGW!vk;-ji0X_lP71e%}~Yl-6Kv+H4UK1*25rijb_tm81SnoabGczVx;2u#eDfHh3G
z2tm#8EY*jp6(j#ph}Y}wFa2(`1eGfY`tdT+GNcd#8V&F~e1d4&#Y@@QYqO7gE&CR|
zZyM8Fm(NIaOYs}pXqHJC76P6Jgi$ToyU$SuoV{m7`qS;q?qvlnMVB@jIi*8*CG310
zSsC1%hBm-)GMgJO>$&*W&0wlq9j(#hzS$MnX(1)Gu8w_mO~NN-Bh4=9cta3|+6;F@
zW#D7L?AH2e|HBN1Ep0e4#ji;@!3{mZvze(kFK61qx350$b>TiOuxBa$?QP-8v#88s
zS>3>Qm1Y)~D@Lv=t#Sq1e~>-FbsGTf0jNQi>d3ZCuhP(mDS=!Tvlkg`H!DtG*Hq?F
zk|Ev@DC)YwQAqq2*Ltg#$W+ys?nyc<KEu_~)wdfj*E;t}&*$HdI@rsASn9mAnH1Oh
zwx$5OBs}JiNL|`KFdvilnRV0=d7mCM5I2Y)Eq?HRSP%$5{2@V;Dg=sF1&__aQZb3z
z_3!iVVR!>!m`$tw>P%WoMB>@7B@oXuD7;g$_euV@$x6K(9jhm+Nh<81QRpQrhc%{z
zdDQ-XOO^dH^l-;z)iSwkfpy7B(lGCFY|p>q><<#b0M}{YHYedng!1C+WaC3E0Za&q
zYz0L-#Y#rnnm{5$bjwM;3M`D#4Z@fK!#*^MwP~h{>k?Zj3(VrBMjfe{A%7vGaAbjF
ze{$xLL~tS)?QuDq#7EqkvClDIxBkn+vCOgNi@$=asCzLPX)txXn5olBD(>$zA31tP
zX(@>vSOvQFt3x*whW6`wpDYZl&ef%fIescT>Km+s==l`Oa&@gO_a%rR>*{L@D~zfO
z$7Z@a1$U6e3LkXgsYeMGsE)NQsz-?Xe#x}a&E>YTHWJqM`DC6X$+->8tt>~My4AR(
zL|%p;XCX3<OIY={Vp&uPZ{E1vtEl`F%+hJF0JOfRcg~CVN1`?f+qM+DGtk4>0iJ*C
z-bPEP;%a0v#QK|H6~Wm^SYob}A3$@+^)G1Ay9LVx%5{gNN-aWW_y1J=3ia4sakkFH
z{WyA4ds_ocIPm^8U8(PjGYe}i$~$Ygp*IzLtHswlSBk6DX~>i{SeavuJGY{GujObK
zK>gZz8_TvuJu-Vt;mKxHul=+8fg4G5rXHjiq^5dMsYq{lVRl`XZNQgftl8AxXENL~
z76B^;&ILP&$NN_G5`WY?sniZWP^>FhJ_+fV4#$|g<4pv{W7+Ua{ediR#)C0n<UH42
z(x=pEzx?Yh!LMv<>Y6IwhT}4q$iQysbb8GN<eX?w&eXwdUUI>oCGkIfMZM1s#0<)f
zP&S3S`@f`@6+?UTYF|(2H}U?hQe5SpaV_>!?!A>5Ygid{*;1eSk&C#kw9SRc9*+M|
zIC<ynnS9ZuY92k&3|MYz>88Pl-lDbKF6`33!m#X<MAcpJJDl!zSOQJFAD|^!ub3N`
zNer|4|4Deu3I7Rc;S}X}K%eS=CB*-xshsq+2qlg}@L~QiQuzO*tN!N)3M|f7cEbRZ
z*tQ_cJAPb%Kup(2^8e0ZHC_UxLv{l*)eFk`D-}Raz{n+6kBcvcn2x{CC(y;k#o4_C
z3Qku=cXZBvuQj_<fA!KU=J0oRdtC#fYIT3PDIlSya9f~;%Z-43)K|dJB3UB;*gPCm
zGd+uVo=wRb+lM@^;vNr~a=ui~?kH&#w)1A!Cf^}Bc3=q%a{O5`<=rzhtg#!6v*RqZ
z8*Bjde+hl;YH+G8=$fe>Z?JQj3a({aGkl;|Xp>~NhI_wrH=V<-nPLQ9g1OknK$<R1
zg36ZTu?jdKOsx`k0tUxJmK;!9+hbS0j}2E8z12xE_7-S*+)T@yB<>2ENi~&tAg5ve
zF#8hk0kc3`z{7nP=S`oXe@>qW4hD&#WiX&yuv~MezJ4{dn{MQ_LVd7Ivz-$|YXlv0
z_!o*h^0&0wz0_3ahsnkWvFm8#U9Ew~#s#6nl#9Mr^_D7Mw3cSuuL$PHR@_29swqep
zO0HH{tfE{;z$Moj{^diA1d!iyB`I>GY|{5(DlN6P)9A>$SaIDtHq(JBxr{R6LIRum
zJ|fq5FDXncU2*5KbNwdBn;umSt(z5*IOGu6>tJzM4dUdT#p4#oR<KTV(B#)C`<OT>
z+)xzcYj!f>ho4uWc;s5UIJ}0^(?qzbH9@E<+-#~fV1MRmq&FH^I~N)Pfh)=*72Td2
zP^6bQHiBiooJ5tYZwL6?|Mtio09CDIzoQ|E3Zb{4?*_HMuTwrrodj3bqqPFswcbj=
zyVYBVpnv#hvYjWY<GQ=hHIp%6NShb9F&(~A7UAV|t<}zKD?u^hl!LHIdGqi_Vm9tT
zOSmY*IB@L}zjdO5a#h-NHe&ln$YqXv{~0BI3e7VSOzx2jy-@POP(EOX%kqW4WMrWZ
ztPaQFDz1=n`{+b3SNfbdX(PJpc0PxQPhkD&eI}EN7uqlMo_)Vik94-{q#pdip9#Md
zG<WFqJ~ZQ%zfURg_OOQjiL5px=Wl>_Tm3Hd2otN)BqUuD!*xoYb*~L}<UGt#S8c58
z_;sARc}9^>%*)mUs16xdI#tQOV`j!vHB35BJv(uhM$o1G%9i!)b_v!4Wy@j8LK~vG
z;N*z;vcJ9AiG-IY_3VX~KwJb>+AjhTu%=}Y$v6A2LsDkmRW<F@*LTt~K^czW%LyX&
zuTsm^vHAjOx95;4CF4we7s>8Ftjni1%S>xoEw4BlF-@odeb8D6)y0<ZP=E;&WL(>w
z)1s^Rj;Y@DN*{D>Jg4FDjLs(|RT%O<$L+rjRm~R<@83GGtr5)q{+gdp#};P(>bc0F
zzHmN@`lNj(70fAKJ8!hk{<VYPSy6MSuhg|%IOdH^)LuoQ!^ad}@KtPOyjnBBvB_52
zwj_#O*$&VL>ZM1LLgvWc1Xj_7mjNppl{pqJbc@>B6yb$wO@6anYYJ2z*QM}E6^fxl
zDq<Kevj?%ElUyS-0<c>k*PiM|tO37>DVlpf!iV(g`duW5ZmqoL{scTP?fSu0mPOUU
z^km-!|HbDVO;OzRHzu}LQN`s1g|(IS7WUL^62K~Bk?8X)(H9YjiQ0$gRUJS?Yz^1J
zM}ex|v{`#_g6HdIDx$09C+6w}1|}i0*kJvXi9;~u7mIChd*H<CDcNt(dgFkxq9JZ|
z`$`*EJa_NDD+3;l%87x)4BXuINfm{zlS9n;Lx$OL#eQcMx+laA_zq?naT!3!u_Azb
zdU=_9{5E4w@Az3mDffwMP_3O0<45uhy~e<0WSnktJ&aC4CT3wtMH%$syyu=vf1Ogd
z5$>1-2lI%_ksf&F<giCxYI4e2qJ1Od)ILYk1xg1~dK7uxtbU6rnd#Hpjyi!udMZwG
z2#dPxHpsCz{cGX*(VIiQukjq|%fLY+m_}jmtUX*G_CuuMDxwsfd{qP<uhr`Hqdl#{
zK>ORPkn2T+qJ>a#D$+y^Stamrseg8RK_H>y3v;(>vIjoC=j?cnz=3z}-X|_zt7hkW
zC!>l$-jb66ctT%>$QkiA%m}P~s|EYcbB3!_J33a_wcLN+5SnwcpdA3fqO!ZAl$-lp
z-qv%@tMTIs1C!GgB1um7#`O2i1fJL%cGCVv31d1|({OUN(`@dIx#g=)Axba$Jz9CK
zhiG%yW4MyqaVii7RfAZChcD|b6v*f5(8v{wn3FPd_tQBO4CqS&ilQI2j;9qjj(%oD
z<V;A_+Nehoir%VbL4be`3vGelKAktSFF-Vz##!VEr=M-JA*2*RF0I|1sL|HxuGbZo
z4|MS@8Od=cdt%OzLB+6G>`^z^T&1wtF0_2vDB#vnfI3=WWhu>~#QovsGPp+kr0Kjm
zfN3eVA01a~WG&i|F<=jJZxl1*zu#T-Z>#{V4rjPGaQz?#$lv(R5~eWP_#dSTNliW8
zOI5tHBU@3gQ)btlx<9_aHE|+@yPL0$TBn+_cSQU!m0-H6be|ik9EGlr<~=HdN7N+y
z{?udNfX*Mbec|W7b#RiEbC<^iIW(OZUq8vN&))%Mt+ZFllbc^FZdC7HkVyiL_O2_<
zn6CgTyG<NiNZMHSV2O7N$dv8a($8O=v*9Q@jX6urkjaf5Pi@^@9OqKxxXJiGu3>TS
zjID4-zYOvs$g-3;8p0aRkU{;cl>G*bO3Vo53Q2Bk)a6m&vul#~Rv?VMZuPi9x-h7|
z)iPb1RO?+fmf@Kz&<rLX_}u%8G|EE60mzC$j8fen(Mz3+m+CxiDnCT47l2p!*kOi}
z^e)Ju{{ga7x##NX)Omt1pW`zoqZ$#%+7Ey$1$?HY9$f9>S11%XUzgXx3@6TLL8)na
zZV0d-Ozempv@$5WSES~otFkv+0&fjc>3^*>Z_n!;1z)n2-U>yPye5CvCHw)B%IJv%
zFU-aUnDDCbIJGF^v+|+X>5u5xKUHVj8uEPH9#K+0h2*7_mmmNV>4I*d9k4gIu<28+
zSn*3p=f)C0WTa;5VsOh3fIL%Gl_Tir-DM&SM=%wXc5oSR$?ZPVINs2N_wai3d@H%@
zhPEf`t6uMukN5Olt+F0902IFlrCGFupE#%rO3&MTRzU<eTTwxu={ui(wZhaCu*1te
z^`P4LC|ifH_&THx>4Ue0=kQZXRqLre0lFuXs$OD{7>4V&_SlbPSrMr^LIt-rm`(#=
zh^7~@WtZ*ox~NoHk=Ki|2n|bWrUcTqdaGASFL5hbHe25dm|g}MwR0HW$<8tBRAd&~
z>$gx=kE))Y^2Tr5#P)nxLsFYzwt~N{FRL6PU<5<Dubp_Vz$1Y^zjmG{3mo^3pSlyK
zGwVF1kWDORcls<`74;{>fMJB%2!??Zy8z0T?o+Ju7~Y?tE;ZhpTIW^`#-(&%V9}G#
z@F<c3Ok|TbnlK8Bi{SQK34uO!YpPDAqVX+0Yzw21wOE?6o%e1Ttk6oFBsq8{%7*B>
z*snEdCtfKm0b@Q^c-Bc!fx({CXJeV5M72Mz7sZdaB14od@%-T5H1jX$c74CiNpxt~
z!&Ml|wQ{liNKRc55n=aOyyp=poah6{T|BNq_AaXDq25@5<+NQ5v{jTBLu26+S2GU&
z{w)me)RLa7(QxX?M+ti(J#N`QaD3UXgd7MplR@;__;gFQT@bXK4BN(#$TCnR1fGAY
zHe#s-tQuQcJW&sqwj5DgiT@F^Y<;zjlx3_{CcrINPBNE~K{dbt#m*D5#_UUV7DJlD
zGEg!LMp9TkDzz#GCWizozMje)q^A~o{SjR{0>y)2H;|L_?K^@$+}KyyxcX*(164&!
zkQ}Ak+~Vn4{vo?T%*aLtB@3PV0;GbP*v!2JFcC4n)SyVFV_Pg|k;#N}_z~#s>?J86
z%G3?dKM7zIT0r$MTg)hRt<Xhk%DGKoVc{Pr94R2!OE(v}yb~=bbyLV(0RLT&oXPM7
zdq|lQjA!UiS{SN5EIg(*eSwrU)=`6XS#+~{rnxvcd`DX57tTV{7Up$atGCGQKS)Ed
zh(?Y>dQve3!_Wa5&Q8jsI<3{iG}FZF-vN`A03Mqn`yXktb+R&=H)VuttAIh^F4J^t
z%C}Upez7AHb6G^dw||RZjgEdf4KOc?WR3i#;MKh0x}^mK?0FCZm<$pk>{2IQGyOoz
z|ND5Ui=JKH9Pcr7rcjJOOYCEgOyVa^)xNMYX9Vrj4mJ+r&#AynZxh3d_|yde?7GE*
z6{ncibA8ly1L(G`UcNV$u5vLe(cz^>zkJ#--9U7)LV)%9l3_#j;EI3M6kXB3iOP66
zQnB+iub@mj_tfC-UGDB0t^+Pod-bgo!}zPV>qY;no+qADw_!QF%P49Dt5Gq~rOk!p
zK32Lhb=d1EB4={^wygODxbLzov#aRJ>00W{=^lRE@vcOtKQd?kB<fXNaRy|I4Cg!C
zwPi0ius85b<8Au)XElynlay!7{E|Ud=!KHqX07i(Q%EjsEz#(Mv28)cq)%B!umN?D
z{AQ4Kd3Kru@Y)y&dzgQX<ZpE7&E5HV_h2m*o@<~i6ZBjZuB0^j0qE?Fnh2b)6gd&(
zmLL3^=YJ>nII+h@FCjhmBFOJ_R8}Bwhm@QC#(p-;?LG;DmPwC<Ns;#it}4@Q+NfDi
z%VobT*}Xqj*Ke(CY>c<H?XC3)Cr_+~3uxvdq^{F@dyE{cJfqo85W30hMV_-3`MiP|
z=C|9<W{59~`MLpg-5Sd|0KFDI`9ss~juAg0Vq@3uthQ=H51T^D4_AUOX&%5ph4(h3
z9IP0`e-h&M8+lqh_7?YvHE&$aa^~s6uWZ!oHw)7$lqx+^7Uo;!?#<sjAq8(mqIB<O
z8`N0#sOh{U7}dC1mVlaC8E{bSO0p?yv>v2Oc|@L$?*shal9r|^=^RL#s4TR{?{!Pu
z%v-s!w2pT{(aCK#9=BHf``JpGLQMIp)5K~%O!i2n(!~27d?*kI%~sj|wYBDxu2wF_
zBesX12*A>H;BCJ%kw^LWw@ePb2d)aadfmJO!B_Pl9H1v|F_W#P14)2%VE{_S(hcGF
zR6~0KJ|$PazInzcA@%Xkorr?IubDO;>G?ccd}{JAwl+Ll;l3uFhv9+$hK-sAX^_Wo
zd*$PRxBE&~&J<;Uy<p<nRvH6m4A+y`$;G&2o*Fwd*N-aiLbQ7hIrS8a$=U#IO*Yz}
zl@w+>#y{nbGhMd!e2i!3O~Wp7R1XZ4SLRFr*OWfA)-im302k~Qm?KNOhO%w38?oHi
z(%Z0SDi$*rmhfw02`vP7%}r&ACntSwYhx{fWoWPJo!psznBwbKow^5IOe~rTiOY3Q
z{r-*Vrtdutwx?5BxfD~nLFTwNn0-~{i1)gaKwRVJc55|FPUE@i<||^9QI;Y@4=f+R
z!kPTq%8f^gR^5a*&e^<DTZ3`<J>&YYT$P&RI`5Zq^%r}rw-y)(Qcg`hcQI#v9R_f=
z-PBVeHd<h4toxXyui;t5Y<sUW2GLvGq2C;!NEE&y$V>JPXQ-`h+UP<3A@tp!=#=lg
zT$kTY>4S}}_vN4iPorC!Ijt{d2WWT!c1o|e&Dbou2c{qSLjFhw5=Z`7(<l_kGwL!D
ztn$n7JO>VcU}v8QMtUbD`0CR2;bnUvzvy-sO{_352#3@lvc8SW+1{q{Ch<VIey~1Q
zWkDdXJskU2!lJo&J}Q&I9SJ26z*Efnuf^}W9el23hTedv{O&{FB{81R`TIcGFDR`Z
zjS7;nGb~E*<suHm8?X6bW{b}y-w`}j3}K3=r(;DohKa`0SZEf|Dt@E+Q2*eot@I&l
z{ocHDtbaP`t-k7t^S7N-uguNn#h~zp4w#R@LlPSGO@bG2dAL6qI7XxL{O!RIL)BwD
z+-?xjto6y1fAKlhgqfw@EgaC<t~_%Jm{=|}ai5L4(#V~%XmeTFX!rE&DdnZKeC>5{
zVyQppD?S!0Tdnn#y1PwFYD|JJEX$&*!ZqB~_UXR1KZ9ZAEVvRjJG%TXyz+gY*Eb;K
z<@V=*c2zwl;`BRp!>Xh2amCTr1xKsk3Dv0lXv~R|XeHhv$7NSo>M;Op-x%Nhr&Y7=
zvoE68;G1wl837kNbkcNry)illKcu~J_vNit3gtAruDSIM7)y@*I@fr|$U{BvYCeYD
zw&s!l)1sQQA0^$UvUO&)-`2KPW~PW{SYN!<*cQpy()wDI({g&C;J(+&#`LLKjxo2s
zeq-;K4=Oa>hvA~ihh?QeGY{jx7vsx8QV~r#>p#jvFRu4;iUfK1zK}isuFOOVkyQ=S
zUT>oHT4-GjF{MQcnMmldQ1hA@*y&8xKGSS=ZjZb6CCU+Of(<pwp$4~=0|+&f+kIA*
z9U3*FGB#3GyU|tVB_PBjfS+kvfaCH=>6yQB+hsBJvv64R^S2b>9MQt71FHGnvo}E<
zd@>^4iX6n9S|whRp7Z!#>)7U9(RTCh5gfXo`(R2?30_yaS-?>_3o^*884P%V1OIU?
zJC?ppRq{}sH(^3m&CBe-tlZvM!Np<@sj^F*c_-o@Hn_0jmYyqND}?A|ipl`o{vj*n
zAbYKQ6L;6JM1ZqS=518CPiy!7yCaUNP5M|lT>hodFuny+@@)&+c6~^ruSZ;msFbv9
ztJ;&-w=tsMFrh0<wYUf9#blpJ1s10r-s~%IDg(JkNyCzXkUsNHt_X@s89`pNUVGYM
zh&xzk7cwovGCtF*+MBB@%s86<`R{3?1d*oo+RS%dK>%|@MEWeht&22lO!RzasRv;N
zh0I_Wx1n)aS$^?$U;QneYpA+^Jxv^`=T#Ze3;WbDM<H5;YjYD86<3bW_}6(C&JbeR
z;xNWgTEo;X?N_DA={SpU=0qm{kvKR9p2ghP?<}arQNlJ8uQ})8OduDw1u9~SK^nI^
zXN_k%0G<C#UK{J$!r4h&phxfHeK{{;c13ns1KQqz-xCtrZ-dk7j$g31-5Tq}&oH8|
zp1LJ0p#pwg^ql(2s4gUoc72^zca3xoBE+Ma&p&i4UqM>Jn<ek0V?gR>*r)yW(*@jL
z={GknIypWlXy7OA^w5BC9mw{>_P=%csDN-l-~#$4gEBP(;$$@|Zp+S|qQ7}XjCdcb
z8^dj$FIDICI0EvA`9<yhOF=ps#9EMBB4*KJ-cp9>`$TBz<qx`DxpB2dvj3|Xs$_jP
z>VV;#<-p|Dt*XNvPuGAe3Mz9q^=?-A43$lx^zt=L7Rn~7$=46}TGkdkevi*YNs}c2
zZH2oogjs0H?^M&kbq<)VVJ~<Su1=Zt9~(2|Q)A0tO`q27_$EDRL4gWWDi@%gyuS9?
z4XvLyC|B>8F}S<67x>fgIg%!d&b%S*L^3~_PieX8*c4ANAwaU}`q)P@<MR4L<ZoLg
zB{rTH&^2-T6NNW*L#!=)X)$onWJm@03sOzR4l6{f@)+Lm3;W%1t8DR=541sl4HHwK
z3AkulQaPYe*ybT-a$2Skt)IUC9PzRKEB$B&LM0JLGW|K&5hf;s))9Mk${6iCJ~J;U
z;C<~eqes{(h?KafM~>0$*RSzw1tI)&MLYHI*m!QLm34$Yjkl)At&GESr@jGO9vR*A
z7S$jz-0-qytK~cP(~T>{D2YpELv6Xm4dDD@ObySfUplsfW9M;f1@O@Hw$-DN9BXcE
z1tRH!4|DC8D(;^_s3SglFFL2xE3bv#g%pyEvf-<~{V7s4FOFU_O%(sMc+P;Hck^8<
znZ5651`wCE8V-ec4mo7bUk6|ms_3`x+^uPKFuBp~^cr3AbDGDV81>1zN%G+jrdd*y
z7~h#Mnkuo9|2aj!s3L7-I*)SU$8TMJPp{c4u`E|KHo~wezL+SKL<Kj3;eb?*I857_
zY@e7H(02+p#OOFNMm~RJV(_ax-f@U^za(7tR!DoJWnz5Pj(7;5Ux=|j;t$;KKg;j@
z-o`EnJ99(ZEoSOn=oQ9a8KyPL{Qk^G`>+F4iJC8k!O3rPvv84cgaeYNY$ksi_^=uh
z@7#dx@AV1uP5QO`YuY#1<awQj+(k9sir~~RDY|;Y|G38y>FUzLH(tbF>nVClkNTUJ
z2=l&!3KL`co&o?pSibv=&s0mE#$@<FG*3sjh*nE}PqHgNR$$6~6`b%Y|H-x>n-b&f
zN8#+>O*VkBt0MI`A*+zeF1Q9U4!m;gew+)}Rh}GTB<^v}@=UGV8DQA#<6#8Z6|mN`
zdaTL{QMnT;Qo~dAkXII=^`@{A7N|@+BQTp#ob4Luj0DI+qD@lC8EvhD-y*X&qW@~N
za+tbb6{6a{TEBsKH9X*GQDHx-p>xFd^_7A(CXCrTk^y-y*TVy!)SM{U=-L`nOAPU*
z85BnOs*a5W%WYoeJd7z!k(zlgTs3e`s^fqaT6tI-RG4bZnHp$X10mmVk)xE^si_Kg
zXc`_53<I7BdKMa`rum48TtZB#>@2UV)G)_(S==6O>z9PvsL|*gtC(TUoSTg?)>TnW
zkXYgT?utI&TEp#xUqKb!5<ceVtd*%7h7Kwv&x>`uh8#;agm9>X6^FLBS!?s(H{=Xv
zbM>f^43cI(sx37hHZh4lt&@I{ac#u|6WzdOIuNr;YiivvqAeA!Oy*|uTgo`PPa!j)
z*L&zUg}Ht1fH6fF7xV4i=o(#sWH<G$cXQwB6>k)T=N03d!)-^r!M8*ib=MZ}nV}i6
zuMtl>!5$_&zv46@%b{SCTdOe7o}s7t6=8SoeF$Or9#UNPTVJ%1@qUkZ#WA<R%JS{Y
zfNYxF55e)wB_`|Q+-ic<p`CXrvA0u{F83o~^_N4ipv5B?<OpVddOclqfz2xS79Ysm
zqVB7(dEWf?L8+T>GDEK0WT{>vhH=pjZorVcVQu8;g&xYQRROH#UW<5D3BzzI4SEy=
zgB<RP*`~FrVQ`nmnYXIwv1|#GxBNLkXCSOak>yNWWxRgjf~bCo*C8^M{ixH1b(wWd
z{UiglYZ2LKMVBX<ffc?k1W_+w^A;8~52Ip~=Tzg{#Ez`usFJTbxd^QIZ^LhwY;y5m
zij|Y4a2Uzi;sw|)bhXG~YQY$@KCs1G-ya2;Y|-JHzAiH>vZj~N?PCJX1rWO})r(rG
z5*!o#MCWK--h?L2776(l-^zd?obGyTM_e3=VQRR5-5>3N#^IjNLs%EPw8mOCXDJ9f
zQA|I>CV_QduGUaO`EkfvKZ_%@fjD-Z26+fZwSwhKSLXsSpF;ku4lv-)6h1O++Jr&j
zCDi>tyR2r!OtHPtVKu<ecxoy|SC75{D%cb>6DJ#tiROTj?`aut3RQI40L><F_9=<&
z*i5s&v9l7&JM!s*DS@t!Vme-SwVge@Lf)p9W4XO;wv|Db8%Hu>0a8HSockcLcL?>V
z;t+H?;f|Wdom@Zddi}*p=DYuiz5YK+Bk-m19`kLl4$}c18L<ofUUL5*CGtO5M^om!
z-E5&;6PYp6z5fd%aQ*$iXp$#C_w8nYWMjh3uad6+TdFLYKhHy-cQ<ar2z;STmyR^N
zY$wns)bihVP$~NuFn{YG3v5q=qH(}%zOKlyX>#0r2u8y3@JihV>Pw?w%&B14zep8s
zsowmH39908ZMyksZrhn}vI|w%3l7B!JCclI6mh6W;ZP%e=I#T-_gZyCGYy}MN89FT
zT()7Xq$o)~h^HZQ_oaSy?q^ST%%_UGQTkKaqA_b-T_%0NLTpsM)c)j_uYMV}qN;ik
zl}9B<_CB*xAGd2cbkB$3F2u)(R^CE5O;JRBU-?pz)eF=3==!UzOL*}hyG|pqk*3d2
zwlXai{N`@(!nd~XT5z(Op*|5ND7Iep=T})82U9_w(Xw5GBBb_}P*_S9A*V3)Q?jBH
z{jWG*+$>Nv-#GoaZ$zJOz6O_)x<l8bH3_=J4d4$9R%^67eNUrOQ^B<0$Ek|N+^${*
zR#HlYPkO8$&e$)TZLV~Q)%)CdZ?ihzkK;jT3V8t>!aLA-!wR+Cg2Ww7h26gu4f>kR
z54)Ca+gZ9hQ)8LnC~AtMC2#6l@_yY_xlryypi+A(j$l2aJL~jJNhCTY2xBUD0y1@V
zdK=r77+cuexw)arRZp|Zvd=5mmQf4(xAQH`lfwE1H8DIrWX)r;D_3`ps6<1%Ef>V6
zbkl^?spp%1@nD=XBO-y+N&Gd1TV8I*X=?7(?)5kpa0<<`IS-~t5mYYM@t`^bYk+T{
zyL<47wLy)ok|CVzS<7Lb-J|BztFWNW4`&EWbR)hiW!h6Wo3(Oa+juUw{fa(xj?LL+
zEddUII46ASbwR5o)~@+Q%+Vu`EAE4a<mA(YWeU;+Ix)lyeIc+t|DN8Wv27zc4IF@n
z%LJ3zlkf2#JTk_A%N`zh1WCFA)bATx-2J_5J5+2YaM<s(&G)+J`W->@2R|d=P7%Xk
zos_adox%;KJEE@SfEh7W#{Rp4sms{cZBg72yEN>+?$=H|OnxQ(F+CAI@T>2UKbXpb
ziK=P|R9^P00rlJTIiI?@%2=}_XQ+ID%G7(OHC0PeNE~KH#k=>r5H}$Rh+GO-AHc?H
z>c_;PST}edXll`L8b+SQYYlKrMTGD5IUX-4qaWDp32tLiHrtdfzcD5I%4tdD!WRMB
zs{o{;1>1eHe(hi&ePcUYAC$O!Oqn`{^GeH4D<L{q%=&`-?ubgr@Z+xB=xbB3^FviT
z`2}OJ4ymwQHbl071~BqQ-Si34!Gd8>)(6`2TIoaWL0{g^>^At;@e3ikse%yVyk~=)
z=fe`A=PDr6<8PHqgxoaGKi0Qpu{-y)?#%nu8{Y{{?bnX?c~rybQy&BO?s7kC=JbWK
zm}1u28g<+2x}!Ikk!-!%6fxs`Dz*2(ZI=CXgd5!O(rrRnB0&Gv8!ZUQ1u2-`31fB2
zWw;9FhU^$BaW7N5KEq*z&HO1>^-7sVn(FRX_V6o?>7!fcs}#*b#0>vpA1h*-P4JIW
z2_KHmwjtLu4_!R+{bsH`S+UjsFbAAz*tn>ORQiRT$$n*w>g>3+qrB~+uVSC={xgE+
zACA9}3`UtyV5~5k;};wuj$7<kdyWEh;_WuMyJDu|tn#|ukF>_pr)IXjW2btV*;Daf
zG$#vCO%lPau-xkbWq7q;AwL*jqjpMD^Gkn2Kpg;grJTLNz4eQ9Z<6nvy##yk;PZ!~
zCe{YdwFXZw^eC9n6iD|ZJ<9B!&g;EdD*Dz+%-`7nh;>;&IY+WaHVs28vUL!LTd;=Q
zFWd!>2(Lt~ou)_Yc3j!HJ~U?J>N95qu~S*26nAOxRv&qc&wTb|Tn6D&Hpw#|vQRc%
zOZ^2Y%pV}uDW%IphB)KbPak{p7nfF(+rBi3Le{@api~9?YQaEJ!A^53^+X}mnN2EX
zj02LAdxVM8H(WjVMX0f*4bK)zc;#TK!GYGuAtv{viMI#!pxAi<Xr;Sh@gzKIqmczA
za62D?91^ir^k*VZKT=xj^WuRcX7gk~;FQ9dtI3GBZ=}a90~x)ufIu4Z#(3B0x9AT$
zZ+M2>&lc5B_f*=#p`=SJi|sAm?>2n|fcu;h>tO!UB{uv2(Dt5zaJ28+uuh^SA*@c+
zL|HAm)k$;_y+;osS}c}Pf+SY&(W6GM38IVDdkdm>BH9u*$~%6~`}^Pb^Xd8UzR%ZX
zX0DmJ=DN=FIM3rac=zZ*Juh}9^cI29df-dzB27<SX~EIxTBsHi?#@!$c$Xw>t5mOw
zS-?8RcO&{-F)Y<-Yg7#(R6hHF$=;TB8o2%gRJeJaW_fHOiRlq>`!OnLbmA*W|A1Dw
zM#w?%^gtFe%l#NsJ3AXKxLP*J$aHN4PEINY@e!hPOLpvZ_2|dGVT2yt%>tjUsVvT>
zWKLyUz_n-B9GLIbnELi~^mfG#QJWZZwZNZ)7v16XTdWOR-w?+Uj7loj)*}j?=_1s5
zqk8*Vu7aXaBva~kc-5ddfEs^5<bR=@i4jn%z>kQ<ZTKjO$!T?naf$SZuQ&wQSgS$X
zw|(<Q4XUB*2$HMUhfEwYms#Qr-N(bg>G9a~0ISq$vKh0}ahDVvr0!W@^5+M>jR^m)
z@>+vP4#28e)@(9k$QQPFC1fSH95^E!_jbdp+LG}HK-Elbi98vHd>29fueDGp=0R5J
zcGjE2wU53VRB6_~)^;hRUjWmG5!4tpWz-$$(Ey<}qseFK#xm*6zJ*KIee;vZQ~|HY
zd^->|nWL4}iOHllXo~ddU(LQp6P<L@-&MXjVjdTcqwp*|tH0iL{))S{O(nh@KOmp{
zb3NCUC-5}y<ZihiVR8J7#BS-l!$5|MG1#Oq8P|pgyx%2sqh*S+0ahbL`EV5l0vWhM
zc$P50_5O8Y2c6Uhcg%KS^1T$Xbn;M-C%fIS(<=9SWLRJDfv?}@%P428p~{KXsbXob
z8XYwxOwb%`N_M|AUq-WW@v%SeX5-)LwE$6=!#5ylQR}9KK>cdpWrOThVlVSjs^APh
z1|%Cki+}G{&CLloEEApFy2iMJ6s4)0qJ&?%S(xW1S;32MW?Xh-lYF;QN7mY^ZaW;X
zl|_?qupWa{u)L#*&9mzb*Q)}YegIPlJeuJzXbbuhE4|rS@6fp>pIj>bd{s8n#)>f5
zsw?;DPO%2|XP1}poPQj!F9YW07DSlT-5w$Fak~Z561;)tU9%DmZp)~TqknIxmxM>|
zx8FS0kgsK6{0oYLeM+bB5nv-@EFedROZEO-TeOMS=+pil!|#hm*4RU$#Wzwo;!V^w
z!D?ZLf(aulb`Kt3=3&9G1Kl;`B^mDt4L2b>aV8I>N8PyLkVWkrZWq&Y2A0PSdbdbj
z;R@S=0R0(B3NAuO871EW`|B7^Hu|_JW^Tqp-0w&f_$xX|?LKK?nT`&z<|J;+kwFcl
z$BGziU2t2R_x0{WG5&{d2?%-L<@)XW4Ex=_zHv#5WDwu#Pg_72tmyiAt~J?}4oe*m
zjConxlk^5J<mOm-4nX3`GdozN#4yTKo<D#e<JNb496IYSwl%J6*BqP=&JUvjg!{!|
zx7Mql=>3wx*wm2O?C>?x=wDk)l8fg<y#%6**=Pc3VgY}CCQ(pe@+CPFTu3vx>xOkX
zNgajV><1DhA9Er@8ftz^?CNK0p#p4*8NMjZ;(TcFsC~n@h24z$c2#Yw!suhe0B{Wb
zZmJoa8y1~4dDUQx-`bZa4tUI;ZC89j<^;qt5t1d<2?$1QBKFdIXPwH-tfR_h-?>PF
zUQ?<Z<=|Z0+c^2yQWXJ~Q~gyJ$>5{d@e$Xr-42KDR?BQ;w9JEJ;x%EZWFh}Dk@9F5
zZsxhHq!fLb6V93C?k;X{ij)Qd`b`!D8xB4ZbGDwHLqB{uf5AA$)F{8{@w&DpZhUm`
zigpf<+;jMcKPaX8aurzZRWZg;4Kj^bRX@0<zkLmQBW0sTKmB^g8pXA#`3L#F$}8oY
zFyjDJ!U55Iy4?FVV1y8(*n%21G$g5Zntc#W-^Z948ClK4F{mbi{lf+jqz;U|`)w$y
zD)9iH>4McKCiyU~!0+Z+swtzh2F^o;h9zonpdx9cRQ$1tzFWA6!;FphwOACx4yeL_
zPlIypGt~uZzc#GG8T4JY2*u+P&$}`!Tep6KR>{1yHj1w{ZZC31dSjH!(U1y6t*~UL
z_lV9B@`|!%HA^q44Y)}DNlL)KO#1t#YomAm<2~u6t3MS*nd2|ufwwf<|HI6c1qB>E
zIH3WD5l$;KVw(C5?_bE{ph@q+4?>ts4dRbWETq4Yu;v%EN$%C^im%B#01%?E6hT3U
z{*UhSYv6J$e%jfs`31DqSxNMmv02r4mOqQ>WD2nGp8-Ikm#QNf>};v`rj6}m_L*g6
z*)NEPOxrfG`;Euyip4h$<a^cLn<zecR8!$V6s#5Zf;ChNql$o&67JV*g;4+Ph<NIz
zrO?NRG}uwUlX$Tnn4q2=2;vQO=6<+Q!%WB&!unlS3Lzgtj<ZzU=uY-&;8EO#o=qwP
z@CP#1oAzEW2au$!TmI?OEvI!|5m;S$_aM2;gknTt2(aMHm0J(uW7JG=Yxs>ifFK{(
zp!9kLb*qI*x`TXm7B>K^P?0gcGmP$P1|i!WI6{GeSgvhhGx}P3;*q9f`>Qn^#{Ov|
zgjJ5vutfzft1^bL8ICgvuD_lv1nAPqRIY9$uRWQ{-R|%UZv6p`b3gEL7DZik-1x#h
z14T{MH8+%?zB;{64wzF^pdLXw)+D_H<T2u%f3q_fpYJWHy|(%ZdT<Uu&)Ryt+B@oG
zP}%i#WIm8tNfI4`*ggfFCk&K7n)8<;TdrCULZLj2;<oT$sK;8&mv%rSt5+{zNvmAc
z9@^7OPDF%H70kaUcs3{Mznbvl9q5^YKUfbfsk--WVU_Vu(cv&+yzr(IfSpikn*Q_V
zjz{#b739It)5`lxpa`_zHkVmWt7jIhE#hi*{>M$cS}w8WA>y}JXMpeG*#%iKVQ`7X
zZeE&zI(vi<jk&%7R2Q*SFi3l;+}ZW?CUYysVy*qes`seit7?U{UXeISW+Azl(@QMa
z5A_HR|GSnDT*)|i_AwfdX_wc#plVskGFGMv*E6zZDV2erz%wym|Fmen_>|Cu*@~qa
z?DLpT&rv}6av4O#Y)Wm4AM>t6tio<Y2}xZ2(@c^tg@LRs-;I{r&C!-wTY{N*@2Dgh
z=laI4k)kteB+A5YGJ)h@`Yxuf#xqZA&jr_GKfmd@ni&pwGeco38^{3Qcbn$udTJbW
zC#4E`Dvc;lZxuBJehG*rrM)R9N7zxp5JVZ3xaSFlQu)qYZ?_5&#N#34u%ccYzO8$2
zjeZ<R0<(hG<RCA*T5{Gl1XK$S*ZVe0387JOx69>W{^3Qud?U_$A+&&xzUi02PuWQK
z=_x#j#tfF<;v4<#Q<`=-{PL-#T%g{EIf9qn4BkAfR?JZnJ4GM4kT|wn4qp;O2<Sfq
z*}Ro~u-UkMr5J1DMnwrWF$}u$afRCO|Fj3HJ@vRhGsH^#aF|in3(v8xpRnTpD>7y5
z^eP!2w%-36>8I1sO9T;>BWC4j<8KH$<)W*cQ*Ku}nthj^;O34ksIC0j<cX1_CcNdK
zV=+;#NdatV<nHVY<cF-?4~&3yJ3mk(J~|RpGAF@eRgNN|ycm&FSi0RKj3VJZDWe3i
ztzUF-jI81<VaY8}n*_omWWFi&vRS+LvQsD5yzP9=|3&|mP2JS2Qyp%@CP_gcmP49)
z!k=u0J=_cTFX`ef;*^bFhGBmvRvG;fXPr#uL$5&3+Y&5f{0le*qN}Q?Vpy7}C&+DC
z>Y3(O{FWm;EV$kVBYB{+t7j*j9xM|W)2xU%Kz9{0I;dow#4;9H+o~tmhHwz^dT2Dr
zCcbk1w)aJE`l2r-uJDvb<>($_%+FB{YjrS{b7?&3&B48xWVaqM?#)uOL)ie&Uejv7
zHf<;B5f91t$CXkCEDD+_RiaFT8i96DKTX$=(=+nd!e<l*fjv=t?if#Q>;`J!^)XEI
zOhgmh%1pHjTYP5zL`n_V-x0sg!&h}6+!E%*0c}=B`bma2XlT6~`Yl9_N=<wpWmElt
zkh?g6Pzzb=N;kb|Mc|<h=TU74>k>}1&w%wygSX}$F;w`oisOkPU-`3TsGbDBkdR#n
zCjTZry8GbA<@R4zI>yW&LbBe#jDq#>5c})rZ#Frga@5R!k;#4tY~PM3taa4XS!~AP
zM1V6JjgxDS?(dnnABA{#)_x2-AyP_qmV)NRK1**~vZ`HwEKML*{WSp6Dpg?anS>{`
zHK6M3Bw22Y%*x$pE?}x(Tlx$2l2Kb+gId6HgQxqsFtO{#$F?-aq7W)z1c>k<wvB;3
ziKoe+G;P-nzs$DSz?nryAT}=g^MV!p@i94OvUZ;M7Z=nX74s>%Yg`VwTC*a<<0{n?
z6$AKt?d&B;ue<curAc@jxIA^fa?cDuct0^|e`X5SF&ie>1YY05F;&ntBU|{L^t3-G
z@OZWu)>j<KIPo-%0JaXyepRgvk-v2#_*_gS@yeGm-XcCHF-NHZf>&Zu0#$CgHeh}&
zBp@b15VwMoeQBLhH=VlKJnJAr*t+8;1~TgjYw_FOV`hd<kIU1jt#M}~trNqk0(zg(
z(BMSl{W|!;Ygy#7jEmTke3F5b8}^%3q!^xkA|q{X`)fN8K><*hy1zf&L=o|=-X2?6
z(<)%k>Y3A<a|C@4vdp0)Up`a^@3+H8?n*vFZGkbKISp-CtiZi9It4No|JQ>lIg?*k
zVg8iQ=RQzx1^+@nDOo%Qn(OqNq)O<s$G<9+&k}5VpaVx~cd+T#%h&4v{{CiQnX7dm
zZsAYD6wHXC-~)VabyV*fNAkHQuM)c9t!WapJzizAFlJo9f2+WV-%S51u$@e%++nGo
zb)Qpu`>Ad1pbEDeKj+_x%o^TU9rwe}7Ol;eO0sP5gT6qKp49Zf?1%h$qy~&5${X+g
z9{6?^a4&1LoTs1P@#!J_-Ck|mzf)DFB7tLd_NIEYc83#C5X4;1Ns`NoN4$*IBFejS
z??VEcEKxI&p*CEW>jBXNhAJ$asdq12wGcZs)UrxCjyS4!gU9d^AH02#ai{S%TMix$
zwmdT%p8V<H{;#W6zteAvznh;f;Kxbhep^iN7)n3alJwa4Mps6RCUu;w2#}@nfm=};
z`b~(4jB5Gs0J>9~aJFrG63SWmZ;;j1n!9ph;QrvkVAGPzNyp}&TQ~X@|Gc9s<(PUs
z02vRJK%Yq5OE#S?5)-^_>hY~DJllOEziEHOJtc88kp760UtXARRLvUid@I!Zos?Bq
zyqny&C0mB?x?MqdNMXD7{T|lnT3lg938~uB-X8YX0NgUNv!+*%#@zn3fuWu3rKOy)
zl&v(EwfYDntTsgCwM&2fMp)40Hn{1s=S>mtpSqVa13{@%x@Ejez3Bv!D?K(pUn0(1
z?wj{0w4fLX6+Jt9D6<?!%v@N94_={3&pSfu_k|o-(PTlGoppyp^QF<{x8F}lGuqx~
zj?)qYkK{NVR|5A%aS3p7v-o$<jYPQK3Bhac2rU1YFpN3B6BEMHtsB&;9M3-V@GkDV
zczRr-&R}o-n7X0aT}T86%Pj(qle^h}hzTR;T(*-rxuquhpVE7m!i&i1f8FLZIplFS
zrIzd7Kn~1!*ir9UV+|qR6!fltM=f=8XTK2?0DefteC{%%VAIkXkG~c8DqW-v!qc>{
zRiKd&fUUcB%$SA=(<Pe@h0~?{WTe2{YQ7bh{~njuE0@C7Svmb6mX}fUX|hE?=yIq*
z=s0PiqGl`_pN_<rSYgMi-C7PE6e?fHU;YRVU`@kNqUC;lGqP=&jqUh6^>#{}JEJ%&
zz<RY#5VShmN>@1vXEpAySDwgxhpv2@Xac){He}+`bHOHIs%K5H*Uu0F^gzF+!e0Dz
z&$tCO(1EM?kOx;0Z1ikA^=l_HtCJfgM0zxNTL!lG-};C!J#Qj@a{U6&ZT-p8$3%n(
zNja^srrk%;x~p#bkI7qT(85}8rw3sJ3@p<q5J;%^hBK28N3(l<l367lXzPf+zp?%k
zVGF9RwknT^PGHMSYuaae6-;8wTy|bqIZI=Da^IZv8h`&Ao^ZEKbr)xwx|-V5Q3QYL
z)&}j#GeYc(He^FPe4T;C=K?~!5J*9ONn(doLrE^+qNq@~$4FcvI`P%ytCeOz?zMGI
z-X(%k+1@(R4JQ-6PeZYVj6$=7v%Nk{%Z3Xu8YYj%ioe4i`ljyu9kE4SM$x0a$h!EI
z*as=uN){7F4U>8`y>{LSx1qP<vix<gEz#>%bfzfc@Jxu4M)V+%H=Lb6FA|wiGbGVZ
z_PwXwFT@n}SjyBV1UrkfaQYhH$B`J@>N4*5>%TN~AF>-ZCA_oLnf?N)&1Ab3UOwO&
zY{8vvUuJzZMiop#OIH&qAadEe-PIT>#UGlST^A=N@$405(<iX|zK_sRV>iTxXG|Z*
z#cD5^zTX)kuo2rXHtpNzTi~y<8etMreAopUfm`o?x-1p{P7{yR7()V&QCS<jjTBM~
z1JWoWr-yqK3#59hRaiuxe!Ur8Vc6}TdSz$)_M2VY1@0QXKC6^levwp?5Rc7Bn4xHh
zNO|H+1hMB)RM)2B+TtfmNl0%wFqiG@_|%09>v*Q-eOOb(A8U9pHN>YW!pZ@~jfotv
zU~h}~&03Avu|3G<_7VaN&tjBSY^wNWJME&Q+`9xFQuB5<@k2u2zVA{j$T&Du^tQR1
z(z7I=VfwWCj!=qGQwpRuA{2+F_P$mUhv-E@^boNCBb7}Mx#w8g``#t{Diy}+%(V0L
zW@sp^5rs$B*G6JSnUd1;ECWsK#hm<wpQin-l*s+9Z6*x8F%>q@oZXw(711G<6S*U4
z(@72u3Q)4(b)V=WM7EQq_Mi+c1>;qiMy8$L^>q6MlJprNwkSmG%+8;1_>O&bKFt-1
zLaI?c#1PVYh7g#xy$ev8&Zt%)@*kmT`Z3ZLA`nEfz_Q)?++Y0xVY*QY1XzkfoJhJT
z6S!m#BI&4%Hz)yO9<(4Nw(HZAG_K9(gJH^&G@H%~OTi>44i^QBSy@;Fv)j(6j9TJ>
zA0$PD(rrmFb_er&OoDj<47g-Sy#r;!*-&~E&Dq%39tG$I%}I{vk3h~7{$zmwIA>hr
z2>wNzqKCq2N`qDmpVNAPJfTe>u|ca;dsHN?Ge2ehZEN7y0}A?)kVDla-;csB3>oXA
zP{E08B?Fsa=ut|t<fgaUI{sUNj95ACzwniLTwsS|@C*-X)mKO6#Nm-tHE=%@MdqSt
zF{L?6nrS(Z0}3^v6GEVuC{W-qJaa5WVmaR&sb~{STAxde8HLRb)w9QRiv=aWX;)y@
zsC=AP1(3C=F^w{2BE@HeHJdtQrSWWpsC(_{i3~PK_FfDL47JCI#C99Y`8D({z8UzU
zFJqn9(w3d4fyR{(g!K^Gm)#$b-a7AB&m1s-Z+Y|E{>)}_y1!=`HA2=W&K&&E<Gpv!
zQV0PFy!c{<X1GB5&+PaCE5LTL?mHSPqDFmiA1Ejtr*$21^sf<U!O)5TDXo?rS8ta=
z8Y&TLqy(BrZjBmN@Wdj<gdBF&+nOhJC!<*0x9n%%Bc|?SLcBh@eQG8)LQ1ZMFnJy1
z?X8U}&q_%Qvu?2YFiO&q98NmneGKR|!>t_HJ2vTBcGTNA?yok<myV8($m|XH>DE01
zM0`*$dPM8ce-7JQjWg+5?Jr)j6<_zfAARJjw!4imbvKqiZt9J1Xs8|7ABX*JFkbhg
zWrB`#mvPp@e*0Xvt`h5Nac4e~%6CmIOy?V~d(<u4meyGpOJ25>v+ZJ(TAr@&Uv{Lo
z@O#_GpPn)6)D2pp7oc^~yzZoDkh)k1?5WOgJe#&TT9@v1R@y!HrGWN7EM)K8{9E7W
zlXTqgIC_vEC;Ky8UrG<HS8EPBJLXedUU!dA&pgtU-s_`MB8M8dLp&~zfOYMH6GtZK
z@p*0Gv71Am<1qChzC!j@wPuLQRIMVBLzYF9Lce1$g+>EO0M7Xcx*udx+f@LFJ_JJ?
zE8}S5`pVV!x`E!jL^r(+_Ib_jYQB{}jWOYTFfF%C_-M+VvFUN$@{v%L4E=K{|7KOc
z=7-bUI*4MGMjx8K5dAY%nWJ~f<C%;7r{^n&5rIc+$%PfV=W)2r4wTSwh}_jtbuXyy
ze#YFe=HuI|FTRa|mriTJe1Jacg`U`}@3)G0#7{gg6-&jmdX*V#<Fsgk5Yp@sQcWu9
zQTGiniRb5LY-y5Zhruc*A7B4bO05WgP^V_AC-H&M_e2N{gVV07aX5}9?;hL6u`qnk
zML77U9`$>+m_sex4r4iF_kGwZ%#ESp;n9(GKRwO42(gE`owJY6ivfjU_e;HVB{Ry#
z?3TnRJ;zo)*+R^BR<{;t&#~j-JN+h@h0n;DuT*p)XSukNDO^sAmIl$pnDCHSA`{O7
zXkdi)kDrSPN@dwRA~&AYNJqe0NLPZ$Xop$FNA7&zU7t{EY|+y)(DZg*HZUvBeN-k0
z3K78Bvk>Fbt*grEfcC4JLOrQW;xO5GLZ@~^3(1#F1|)Ax`|siev6Et#e|^2}0e^Rg
z2oEPnmbnuCpwf`mFu2h<ky|Dc{Nexo{SHx65|Qv?Ra4SO9@%+_zLhC2mZe<d50<vG
zsQ(^%1|I5HNoDav;rO594C8>ihCI@SYVP5Rb2nG`U;k}+sKQKA+SN*)i~m2rF&{`M
zWN+Kkj_@vA!ZS{^izxorm~M`!ki<h%P?u5e+F71_A5qm_BmC!F;3+5WZrNELT3aI?
z{O2zIXV9K1SoQ#=49PrSN>F~5)DjcH`r^Bl#pDkq9d9a?jQ+Vh&j&acBjPdygRRN4
zI~MWS$sFWVt;~^bT{6LaGU{~Gp&4SHp9cRKs&**W5a*TK@2Bw``P3GOst<WRPJ)&E
zMd*roR%ZEs&I=9)kQKuDp(-t&(`cmANIOw;r&oq(=B%6Jyj$X&X<5Vb1P~g#YPTMJ
z*P87z(xw#?%)yzw4)|8bd=}h_F-Um4)x%k&?$$qGF=E2l`eDAvK=8JIb}qxY%oTLy
z{>6$?QkRvs!$BO+uI|=oQKzS4rE2si^P|zpUImW!T?fZHpnuet_9W7VTH<fxXRh#1
zF5l_kls=KCv{qfoI|9w@-2Hm~Qnzdyl_xd!T*fQ}9XNCNP-}6NLp@5H#o2--ba7!t
z!C%q~Jp+m_J38SHIhj?2#dT)%dxL8Q4A|7FV|6Ot+e<&MD;Z(B*S<V!njne}E<nDw
z;ttqeXw$5p1|B<18TjZE-WqREbJ{i;(P=<C*t{f(QH*+hCt7-$McA{1a|iulE*?`d
zI}PCsb?)^T&@aHKp~tEm>^I_h5?PAdVvjDeX02^WXTIOR?bGqIZM&m_E<;dNYx~m|
zzn}dQKKk4x9mH~x7r_=OkNHK!zu!uDXyKEjXCXsM%nIy$;$4kb<AHF*<qupur|T-j
z^l(1WN~8l7Tk_@GS25qGOWfn<VsbF>FD0GH?=6m+qQ+*n=sw&vXi+*cNNgfVebRW~
zI#QAiv9J;5zt1=J{*&*VP>^fM{R2I66epHP(zKo%S8TpSQO#$PtFiiL4QFf$O<wb~
zV!~$+bpwG#hlJRyma77c>HNy^UL4=O$+UCqvI-`jW*>v*w4i)dp9gslg~tjkbBpLS
zLfXflC{wtIj+)VEc$%9>edP|RCCOY*oMoZ$r9!-n-#4<6xGJbG+<n&il(0gJf+Mp9
z#{f!uNu+U+m!F)BZ_R3!5MeMZ=s(2ye5@o&;^{i@b(11!wv6+9ek+|ZbjbW#*-o@Y
znLTd4_~*3I$e9G4`}41HFy0oyQw`y<aoZ2Ww)gk;pY9hQ$!9(;9;tmtx&AUM6Cc0x
zQ|xx%_vteKR4v<kI-1nyadSOIaqPyKak^W%@`cIOQq9BMdX7qQPEvQ!%oTM0xj0!C
zJuegVfP#7YhsU(d+!ZUyTaU~Wx3{ZK&d%!{PS8?)tJ}xK0nw?^(=<E3))Bq#TG9S`
z-##?GseYT5`w*R1uH2BxwK=Ewapbu<OO3j2zF$0&Ku$Mv?O7J}(pcHi=d2M`^JdE6
z2UC=X2>p?4?oDdP!ji(|k?PE~<YP9F;XqY82IS<`7P``e7k(<sG(WlT(*k2s@s5mt
zl#}qaxFP{6ZWg8=8uzU95XnT#i+!*6zbn+uH%xUu=nEsyTW=$$6EW9em4B9_n}xt3
zQq}~Qcvbb4fZ`e4DOTs+zyEB{Ix^PQQQu+m*dM^4JvUPA3m)ng<XxW5L0v#mvM>lV
zEOFmflCICe|KE#+7oPFLA1hNUo6F(ri|EUZPB}t`gqs3|=iJ*lWQ|Cc%)|Hpv$*|d
zsnb@@&L<?64}haVRZR70nJYLg3<0N=eB=C4&_{K4rOX6KSXY$z-ww(Sl2yZvScF5w
zURyS<#i@;f82EYZq`pbMTnItFnfKhJ;i`WrMB$(1?hes&){&zR+G`La-9k+b0}KB;
zv-@O*c7Y#OX#RcM%-a7swRa_d>6-<gP2pER>pemKKXpow7g%jggIphz-gjr^{`Y92
zl(O@K@E-`-57h!^K3(?>gadCltSO^P56X#1<IZmXYemnd!{J?Q4|eY)6;&sse=REk
zI)vRrO&)eLW$`tmpHV!!iY$E<$IANe^OFHe*%l%RL>sXk){k9gg@sDty%|m&2IfBO
z^T74xjcBLZZbfTAM;beZtc&L(!$0@K@GkIIRyd=t7%8MuomSw5qFP!}K4Ap6EZ)if
zqKr%Js4_nCp1F-8+rO_Tn|&)NiGb?4VD*9B!$<>edEnnKI7rqBZ<f}u(#mGJ>%;$c
z81slEUI)XZWP0$UfBlZF!2CDUmt<bbu*q6!X(sJY84_mj{DfTQm|UKsxUc8WwWX&n
zJ%e%YfGshG;;#9Z$+;LSjE<gbOt3(Bb*b;GT?CN$)z3He!>-ZB@j2}Gc0xrVl(i-M
z-1f@7QFJv=uX#*qxZ3&f(D`vxF?@DiCpq-lq8g#JU)(62|8s-;E?OtG+|cBQW>VDd
znIjvI%;u~{r)>iepZ&{r(CaX=<}qK46jW>77gJpfcik?A`!l)|EkRRZTD6aK8%2ll
zmw~%34X?5m$02ul8_%z}cONwt`{!}>J3OD<?2p}be6C-vwOy^L530}psSn4nt)3kH
zno0`0+M5mf%?KSU+j__yj-SJO{AgZNS&zmC4_*GqmHjJ&OZ#}l$+MGOf>p%|&8Nzf
zHEBV0=&_U1g%+pDA+d+vmPXhX3zV+b2em*+1&@UzG)=0v^1|FOC(gR5!J|aJA?ndb
zeV<GNH|c&U*kZSI#?cAd_B*w3>wtwO@vwV<xS3wX5t`>X=9PiI(xR?8OT|QD-*inz
z`oc)tVpO@=Oz@Ga{-Lu_xN)6YQ(2!y2|}jDcWgBIFDOM0M%J^1QqqZwJ2NJY`oKls
zA9u=WU16z`BZQA0LJqE2Qn>c8tnjELGZXd4B30j0Pgu$5m7AV}L3#Bf7)Urd_vBvC
zKQG&X*Bv$gp87&yUWPUsxhQ^98>gc*_oyNRSuB{fxoUg9UhUqfuGNUNVvj^wS&Q-2
z3<&DkX!vLlP$lupbo2Y2{z4!11JFOkV;qjL|IF(kS<72WSdxxyf!Nz1<-9Jd?B%q&
zP^C>XDWjCwp${k{KX<73uiyv|hv9vob3u+m_!n^T8gVfBz(w+}uafzWAv4~`a-wB4
zbl~phtd4ieqnhMqTBt8gWU=$e2cY6m^JC(R!^HE4+5s6w=E*jFs(I?r;-_Cck8C+Q
zN2#`zC7*N}Y{><%Qu@~K228T}KJhng>Kl&4E|)jxAO0*)7N~8T@oweQ<;#*;!i*y%
zKj8DTx8&1_uzu!t6MbT*tIN<c;!9fi8Di1=GnuPy(}&^S&`f532N^Gnrx{?03!&gE
zYdk|p?%dm5G*`*eGPTuD?ra9Pi^pTdY8M*S+F!6`lap*7TRV#RI=eR^%PM1F?|9!*
zqixpjd9qHt|M*vLowPYyhi*sR>+-wBG_H}E#8W=uvH5;}lCqczU#2PR!9`l@6A5|_
zltN;;Ca21gf5sDim>Y3E>>2Q7>v@H1v_q--Nr(~I-VS%Noa<gl#VCu}Ud~8hcxlNu
z)suwtNHO3kkpE43uep(@RcVn5W1~!Zzc(gI^%#A*Hm*G0R{w7L)=n_pN%CB5O__Nw
zdyr<LS2Ct;Cn(GR!8Iq$rl`5+>sx6Lxu;?99L}PB#AR4jyiuXz^9-QZ<_TZuhi~q~
zx<)Dr*e5D-iw?<SQj_`-qC3xi&Sp}?vCb!kMKRCwF3&2rpeZtD4MvQE@^_5LuFHS^
z7U-QC*Dbm(<D0fqfY8@z88<D!peh%&izqn-0%2GYukQnD#q%sFeDDLy^Guxj+$ZeS
zXlK+CFuA?^S?%T3t8JiNK85x}OeUUBm0lm_$lde<^a+D44RP9OBj&85&jivkUAz!F
z`WXICM4xSsXH07-UBh=pxlrkN-(o`Fx53tEudlDxKQ*9vYc$z~Waht{Q(MV<*>Up7
z>d|{=gqc|Zm~Hf0yjB5cfpl!9&jyW$LNSnDxH59=cjro!rM&gZcU6Z*D|nMdQ~E8~
zoxwIA@OO`DvxKLDtLN?+S29l~<_V#cYo_u=Up$GF-OXP2^{0D;&(?3Sq>ct90=rjS
z){{Mp;-DF8iN{AHA>_6f>^Sg4gEXogGv?SXT?sWZ{IVm(&Ki2^XuNp7-J)tZK=3~|
z*4DwI?Pz&u@K%M%|9RutO2l}*M|b`$3XUHf1Ij#|f%PJ;0YYl6X^)+zN<Fvplc`V?
z=bw)0#N93_q`;bA8jXZ7wlTEgC(nO}`rAc1a>pRkhMBID3^)2UxO=jpzmD*GvYANr
zJWJ=yQEfSE1CGu&vqTw5R1a0B!5D;X*5aZ-`P{vp#R4IvQ&t-8songDQ$ri3HCc8+
z$b_goGa~C1DERlj8!DgO+ZOkhkP*&&ISsgEfPUW5d7b1kQhOk6e;c%ARQ1>xr~(Uy
znM@*1Bzz(cFgz&>?usUNW7|Z%Uw~+x-B7xt=kdm%P;?5CB*2N-^=>u4ENE29uv&Pr
zczxyFpY<U{#KrhVuU?%A5_8-^3{C0&b@g{&lm^;z_M&mW<*zy)jiBJj-HM+-8$2j{
z?}F0G?`uKdSwqB7gvXe%Q<<$>Gk*B1ttZX#oLVAA7y3Uy^Z5!zX}q;uKy<I2HD4rX
z22}IT{N1?Am)n*7Jy79mHxuv^{uwwP6x9;48+fA2`0<4gVmVY-7FOTUO%eZI%JY+k
zWr;{}){|U9N1VOv`P!^2B?}zGET4_kq{2lQF>8PJ`-=aDi<UWex2{{o+xDaxZw!6M
z33gp$l#vjta|l2HqW29n_`BubUP*x3%j2rtWeNHwE_I$@2T~d#XadZr%Bm7oOG=+>
z54zT>ff@~84lAlqw8|dfBgz-BMnMKaISr>d^nU#+na~s%SlJ)1q=SO+c8WjYtC5Z~
zw#kpd&VYkPS-*wz&HM)F&|~XW4OicI8fYtMq7Dp>G=jH1@VeuyUC68Z`+G;Q--F+L
zhl5;U<L11+opcM9)rVty)%|>SBrk|=;?oTy3Pv!<^J-iQCLVbA?f0zHc&YQijUxFC
zYhE=PhAE;^ff#dUc*fC$u0=A*ERd*g@mnTY1o)IhG)7DQu1AllL234UcgvCi4m$<`
zh`>GQRex95?!j_rRV9xl*F55Qa2wP_7GNa}aSS09d6I1Q#;9?pxMVC|ODgqM!$}ez
zl_g$zu1d5fcWGsC-JdYJSC!S^q!Kg(3+G`JP3VUwmZt6Dgf4Z<CHd_k1k@)}kKgV8
z_jQ1Kk~Rp;6$A~^15g6<DDH|z!FkVPjg3fO&}lFYWSTn(34<oPwYAG(bOoTtvS5by
zg3oDZ9=wr~{|SEwQMB}_VaMwSmhc|Q?*&m(Qq~X;(^0FpmcI^e1o_9`b7ne(B?*YO
z@W+VEz~gJX8U0cS3H%S2NN5Dv_P#C#*m?Tznk)+Dx;6moNoq0|%jAQdsQdH_Ss?k>
z&u+rZb5v;??5!>8-J~`OC#ADP(PfI7O>WbYTDuHBo>u?6-wHHtd~_P4u}`;BCP9sX
zZQ{-!t(q)jA{it_+}8hqttgTVppA7>c=s*yCiNfHmgk_N(ahNamzAjtIE}VJu@i4v
zVF&FFKs%q_XG_*1a2fzETgTrmvm(jKCuFV;$>Y1pI~lzubT-U7nNbikuSvZ~GU)28
zQ-zCLlM{D&{fk+!EHG$7^!vs;dKR2&gE8}<dPJmVSU&s8zk+zG+d(TIVj>gUi1#2y
zH*xtaXqGY#y84pM{hFx-W||JOe}Q54MriwL4M>2cVY)D-e(~HY<~6<wV<u%s-qZMj
zgO%djxvSt!eOvF$<!+SRZyJ|+3J>A`h;o)hIq>HZL7d>9`M)2uwe{D{gDMfW>kvk8
zJ<9eetcP`~g<^*iI)GC30<=h464^d}*@KR|BU%K^?zc=ggMjeacLLr$Ea544!*s-6
zPH;J~hAo1!j<2L3&*1y~6Z}K`zC@-LFP1E&wtdNFYDpF1+q{-{N-AEtZ3kk10n?&X
zw|wg5L*Heu&iV&S8gDaO+AF^wt7xa$2orNI5XUborM<=Wz2!u4$Kt=65(uPe6HyW*
z)gPu*0_QKJDi2@0tK5FUQz=lBO2Pm9pmOPiMK<K{yB7@tVr(jB#bs4wNm=^XmscqJ
z0J6=waZW5z-WL<@7VNz<qCl=e$l$3>D-4gJ;h#k}y!=iaYSnFV)gGe5oNI$YZ*vg)
z^JgYRf4!9(-S(K(Mcx~kH=4W4$T-Vu{RBly01)qmWctEeUwXC#urf0t^F*g}-<r5K
z*JZa`cFd{B5`M$<yCD^DAUd$uOR_>Qb7HG<MXcX`W;iO(2?zbySZ~eL+UG`!2+qJe
z+CmVsC|&<>^Ch{o`k}<Cd<hL%1pYt!n>?#F#BkPhru6V?iFBoc&_|RA3XFm~#K#uQ
zWW~qAw|{*3V-C2jn62RLosXHrhzanZhVdJ=ugdHBtMv^7@Q=CVh7<4a;~XaYL5LwV
zkUNlD@K*k}=p&Iv7Q)Wk;v>%p-Iv;}Lo(s-ZP?t{dm>Kp92|+)3)9_I-9q1QI!+Wl
z9(?ktSuha!5QyzgWDh#E0<fNPV05P2<Zv}O$9n#PbIhbi#hyf9Hb@{W_Et+%a%f9D
zWBT)+PDsa{I7EpsU`1r+H(zImTpsM;T4CT>XzkEmndgzRgWnz{ANU;qW<{Vggplg{
zHr)ZPABntYwmByGPX|}@zp}Q7DA~ifZzMcd@=+S503A#j&p>0&<*Qjo$am#I<sq+G
z-`xt={X5%_kc0Hrx1x#7ABlK0>(<T`q<yRkR3Wy;3L)Gl-DfIGjig6%G@~P>Na&FF
za2i=6sQU#pv**BWx4q)K3UVl%eg5V4cI|8i$OA|)<RL^9@}kN6t?7}#BauPhW&D*!
zQuF0DfP$RLYq`BcGJL@l+CiwiyLo#2OssxM2e;(LjX7zfSaa{Y0}iyw3SQqv#SqhO
zp*5zD?&{3@GhLJwP2+!ln)IiK-#CXUquBwT*>*=9^s+CZiQRf%^|suU`vGwPhL~|j
zg}^XG+68s?{dGR?67{|%FDCEyt^f5k060NyIG1sf2KGnpwR7+066=DS7_`0#uGMk7
z8ceAsH>#6-lL$>-UiE4$XWDV*tS~b&vXh+Ew=J_dLom6ra~|RT&u3*hdIR)U-TKQM
z9VKF)7;kYu{Hvakq|rfY6A$$_<&#*ggKhU_ThPz>p&6PjT076fb^_R1pMFS-5q9W3
z7S?mCFi34lr{X==!^CUd$#CfNX-Ti&>N`I;uPzo71`+Z9ZXo~bO1zCdG5>n6L9+I&
zcU&KPzqwY~{bx|w<ada0OUPwOWB=!9=8+kqw?UILmrP~kz(1)HOcn&aVOWn9{|O0i
z&Pbqd{|Bgr{c|A<RuF$B25aKZzrdA@NLh$s#{Bgt=D$N^zO#jk*U`3vtF2)3560jr
zf@5Xr^{)|v&tLZcFvS0>BLx1>L;SxwLg4?8hxq?tgus6iZ+q5C&xZ3lW8OnYCQN>Q
z(#~`yo9aJv2z-~?co<vjVos-*u{o(SKtMba{3oey8vZ}K(~`NA#;}ZF3f#)1?sv0u
z6#CMMqNHD@`A1cU_0J<dy|m~trS$h*vDL7Iq2Fkt*(&tTSHjfvBpq;>K>vqFAK&;y
z^et+>(VK}2^wInF0D2P~HPRSHO9?)f#%!(fQn#ERJ2`HRusG&MPO0_t)F3r3-bAnw
zZ+GyK5YMKt2L-qprJHL=TMRZ*B@3W^GYrZw9}x0BWe!TMm6r#;UHPJWpU37`S67>3
z2?sk4(E4viZgvGfyn)2;02|xD#}j#pzrP~JCk+<UUp1_kd#*-OjDx06qv(c{Dammf
zd(#9kTqi`TG$nEQ>x8*I2B8bjKl9#&U?j;ZeTg1d_5yR8JTM%YUIFunno!wa2UR}~
z4v*gd6&yW&-r@j%bXM(d-aux-2Xi1&^_y86uJD>pyfD~k?EqK@GbBYbJch*o19sG|
zCG2u!krE-nn7BMR32}J9LztNC*ynhrs5bvHIk^zAMfsi8XDzqz=xIa+&-k&dK|g_n
z50$Hw1>&$vc=^jMj#V)FdjjSv<%x^nQoIeGr>4=|CqHUk4ceT5ilj>}(8_ux-1k-S
z>Y2Z-H1K?=M%7?A`LXa(HOZK{cUBT&8$>(P(V$$Y!0=}yeY`9<%^%P%T6C;ob%+;(
z1xxH?_RU=P?Xfn0+FF?D`zTV<+f=R)vCT%aj<ERc`0g(j6Vv+fb9#xDxWW2^+DDv=
zeMhD_Wu^F_5}2uU1<Ty=(}D^@qY=2o5z!}HfO?7o$78Fwq`VsL6UkDe$AB8)f{t@V
zlHFe09#{S9-m=9WT}bvRPJ=N;8q808nlF>Plq{0M`4SFw?pzO~3X!^Ik+)W;xH&XA
zPjZ?cp8Il**8^*@Dq~<`Y0*PvA%z>HshGW89`#hvY3djH>d$^G*sI++c2|Xd7R>_e
zA9RvGEvaZJrm^0`8eaodZPLa;+p!o;nM=<(hz!`(%_cGd@@yXZ^)Wua3qC{7DtJu$
zr;Zn$;q@FsZWaX?z2q$=m4JrQbWX<JF<rqt!t>&^LUOf}-7&p$9*@i99oMHe7r*Rf
zgcRaQdUfWv6h|mnZ`_2!*PoIf0tb{C@L~r;q7t~`?i{;%Od-M|8qP-Ui_tsJ>jFE!
z5Qj1L+ZVqXeIBtg;i4~yhqR!r7u7C}V0LqFX8R^TtrC#cvdq0PCNsC3X$2Up``C0F
zxuOfnAN^@m)jFyUQ~uo_>td^U^KL7KwE~Xf-^xAF244R->!5A{Vn7+Y<l1$86Dt2(
zOcHk{$i~JZ3i+7>cFVrfnvc{3WqPhW4GpkuW>)}<+0Y<&Ed_eo(e}bG#SEFsO|_)W
zirh2_*C0gy)VXEgKIY&iXM?>SsKh8$6nZ{0cJJXF-i%if2RmQfdVS^Lpi~-<MpF~&
zT_F$gY?%N2TY&gz^3AqoUS#9LP2D5|z38JpDS9sco>=V2j<w$Sh&M%KldQB*-KLRy
zb^|G~eBXXm%NHceHH>{<PIT^NE0g`1T*4RWM;2Rp(l@PpaY%wEaVzNRIt`c9F0P8k
z6u5K&6G{;c?o$2%jyR44j{DHBi}2OA!Y?O!YEiVT&cFl52gG6;1K~^oVmGp;>Huau
zYb+d0iO@sdE#t6$-mj*OU|~e)n)c0LkK>#CM156ULNejI!!p;18%SX6^3P&c7%5#6
z0Xd^{qehy@AUa*l?S(H`R2h3zQu@Mi$KI+DG)eprPazmaLi1w%2Dafb?@?hyLwuYG
zfOrlKL546ghDRr58tJsR;B*IEWniXxnny+zzn*Nd(AWN}osdZ#%>N3P>pE_88^YA+
z&YgL12}qvs#95<|z0)NM5fm2*4|PjPuZr)_k9gc<XgB$hFPOn=Fd=oC0w;(Wjq9_!
zO@dXzHQthjx%1m8r14wHkG`Ue2Xy-1r-+R4owzJK8~6XSU>_FwI^2H8T6bJf4I00t
zRk;SzmIH)bD%%Od7`*1e)F}*G`JP0dWwyl<HnnGdKxH@>`7(TV%J7;JF#AE$_6t;8
zj9yl`boCuiE43J<I7dc`ww@2ZKMed6CUPf6>%8pi{Ko=m*x=D<r?nCtu;1{Pu`>=A
z-;0$xH_5HX<LqFWBm63dJf=Tf7#q=!<^29{l|oicl`a&G^l@NY1tsCs|AS$G%9M^S
z1;bm`8@L2G$5_Tl4k@WEcz@YfNI(byX*DMHZ?9H>U|HRiae<65vI5Ma$JPS(=@t$M
zoW9x!@Ig4ibiKM4n5I`^zQiTi8cYvK79fUVYu&M36B7BHCE*|{oHu$2CiYKm)L@Oh
z=e;5U@KdRCN40_E0@k#e9;{=XTxHwz-Ce?zan}Kz16e-bpUK@^XS$px*+R!iaWzR{
z*OAzx!`1FNIXlo@M5rkfarBhV8p-=wg$b20J7k!r3B1;0Dn|Nfv}&Uyg50_wcJtV3
z=zQLZezCmEr5>p}0de>+Brkvd-oc0+&T&!*-cjpO;;5}-Bo@~FlBbGt&npZWwv0+y
zQ^C(Td`)3*N2H=CysCpfXLy3J#|GAV&_S$Z!Vh<3H5AYnPRhw4g(#Giefe0Hu~qJl
z64|o`E^VS<=n;hia<58)oC*|<Pi_2Z5a}w8)SFpH&hh9P)lBKBDG+ayAPwTcb^2{e
zQhLkhcvej7%lh$36m=f)Jq`-ub`Yf+AZUBXNXlc{1!6~f7|_GdkZ6>nUH*I=(ZQ4i
z3UncFPzJ|oGw(X3t<svIYNZVPCD7Fns6p)5joaqfTb-X&050*@px<DGOEp;6Dx$IC
zv2%vey{fkg&~j!qK?5M$>4&^KD0i8n!~f#@J2aRq&7JXQ7BNZ3mK=ak(xT=Io;NoD
z6>qh(Fa)co8#gE@obxwQXsEJ_$ixfW(ltOROC6NuT^t8jEFYl<&<0@bo}^sBFKeb6
zr5kPDYNZdPOCZ3<-x<+G?K~RPwF6Gx$hu@Fjy2FST;&Sn2ECfAoiWU@uTmC?_-*Dr
zpStd1Pkia!`qxZ|3M6P*Ko}upJ@OVJm&APa%vPnZT02jte%+9#HpCUkXInuY(_9#^
za*K1ejzO$yrV2P81$f$e6bTCTMM5L^8o69Rm&j1;+b!SrTl_E}Bhsb`%|gr{M(Dnk
z2HI#&RnA&ROAin&Vc;O5P<8r(a-_Q>j5JK5ykUcO&JqC0OQ|eJQ(s#qn~c%is9T0+
zz~zZ!n#-4mm_z||cg<A_U+aZ?=kZDe^cC8#_2&Y>1YzL3d>CJ7DD!D}NOIp9GO`b*
z-;oTIKNMU4H18YD(dec*SHF*hV(9lN(^#yts@mJ-32>CJ@f%t>rNw$tkE|08Nkl*>
zOl0+Kq(2B)iaNut4x`gz&%f7llHj5q1by*f7kjZr)Jgx-QS>-8Qm3)3^$KH06tK>1
zF$7#z1)qqf@r5(GT=iHZmLA(6-Prw>m8fUaJD=EOR?%3q1wHlvd8~yShqXEqM?Dp3
zI#r-yml2bN?{@x|UhvP@;3YI@#GTPd10*-{7K!{6E;<ho;QAcm)-IJ96UjtoKk;55
zG;@G-wl`6dkjjeql_`TYeYU8VB|Se7m9jscnUd7vwkGPlssiP=X|hhgK1yz_^$Myg
z74L#zR;XJYP*N$CFn%hTzca(LO@#ptM%F1RH}7<?(kd$5z3-vOs}yVC>NsnBRE5dK
z#a`3xwJ}J!8n?JQO7;YawN!*cU^r7%FhUM_zr$KCo=O4c+Zo$^*deEYx&O&z0W}&A
zMYqe2k_@_93gJO@gSfx_F7@ucdVwjL_=$$=tG|T`Wa8h?#KdwW&&Iq<X+W6pZ>ia8
z1#OnO?|Hr_Xqj99;(7~P2V5Ry(E}EjI|d@ql*N-1;Q?;k$1M^RK~nFJnO+ZW>ZFMu
zH_VE*`l!1ct%dVmssgNw_aZBriY5ZCj^mv~7vLrt9EJUIM*$bBOw)XrekJ{MQ4|LT
zVXNOy@zwGYB++Sq^IuU^i(txhPM<vbWGk`3SiIh~;80zd{RLF=HkN{x8tuDMRWJ3X
zRpuWnR@g=dbsgjA_oH-pvuF=nr;p_I4zvq**gbyzsH$_`0*rjj4<cb%M?4v#5ym21
zJimR8IQ05C;qmdJ!^R@=NDkK?l+13ZQJv&|V@(oupD|2{b{<qWGwYAY9$g<C&8!uG
z22)+%04IMziPV>FEk^|={lqQ##}Ax_ohwribrj+=Sf%Uu(|yAra5o!7$mnqBj5QGe
zt^y`fu7GS^(~oHfrmUv-6L|^?!Y@@o8LCl+;~MKy^AoF6iAfk{G}@TP!cu9@|DfK6
zH8)AC`SC$NN`J4ildQ(K`tCDH(0!Ja_^6%DkMrdS#nHxdP&TA1-(X>_)Md3h`YYnZ
zb|KvfEa=<rErpPan8qfGCK)fpL`J!(VYwb?0|&lw$y&R0&TP|dr(nUN#5QE=$@S^i
z*2xx7YGksF*}`YK+Mx5O=FqHvdZ7;CE_yMsIiq0MpV=f;Xh)k-*-s!l3cC&IoZ)^c
zT${i6?DC~gO_?ojCnh04Cx(RIvSmaW=dvA6Ac?aY;wIlSo$wfShlOrQ`OjMXI4`d{
z0P-y>CXZ0gJ};SkH8Z6eP+~)<{6qn7REE&d3Rs0`>IElpt7-rAOj5Gwg|SEq?@)4g
z()s5%E&P6Oc<B<u9=phT&#Lth==0JMQEhTFaj28O?#UdWy;K(i<*HwvFTHR>39!&j
z);ZT3rB^sVnNGQ;m7E#*T%~^}B}5N6R*)EXoq1AHWygiM+_k7!56Nb)S+??Jm83K2
zGR-;g$ogx_YY{Y6t@BdYSk%zf0oQAd+ijeMu8AWWh98eGtQPjqy^_-xd4VJ^tu7pK
zK(jYG^UVCn+b0^xMVx)M)iT}74k53WLZLxGi6O#%KWSS<#=dhDMefEgc>x@BmbD-t
zCAO=dlbWsT5U*>iZV9>AMD~O$#>>s)ZRm?k+@9wZYQYI2Q?lHavN9pqY<l@rS1+bY
zSX7KLO1x$h^3?qK$0y=Jku$H<W4r4*e*QA&STb6g=;^)fEzDV)yxE+7!1bDzHKzOF
z{bb>3_4F^4V$$nM-I|qB;$4%#;yHZEbgusE;j1Qaxvh)mD0I|J+Ip89()KW=<RK2{
zk+U}CE59>w1`079kG>6KWJy+2``j%$Eh+;FJg^BVxjH<iq@;<9Q;I1rC<<><!xSDw
zk;#Uy`8Pe!zbEa5#8M#c*xbUYNIyzQ8LOKZ+B9PNC;j8+@GnbyEP*Tlr)#-9mjb~$
zp3U;Mp!Ctb51d%)L|ck5jK|CMP!}m3c$HYb$5;Vx&)aZebEcyM;ZID{PCn!6Gi{X!
zn@2@^NY-ZZT*0F@!1MI%&cVWxP97<||3G-TL4nb~?Tk64^x}J33@Q6@!s}w-@7!Xh
z9ZXUv!+&T-B&rQ>pBN2nWr)TlkUly7H5#6NR-<ECzmk!ysd+Im4B41XYlC-;KUqA(
zvg?T6WhsX*u`Vs2|FVafm}=-$pd>L4hyj1ca;pe~TNPAZf!tpAVtVx`S4pI*mu+1N
z%%$#nY)%OXtXzaTH@(GMfsc&DzY%0y<3;rgT3XJV#6{X1!vp~Dda?)E;j?N?suq1C
z`1`4$rs1==(wX<ojz5VWo60TlR?0IjaG+YVaJ{siUYfzybVPk>srNskgc%?0bV-Kl
z1$MtX$5uviZfyfNf^FEt_pznwaXJ-33sc+@$$6(ZPz_tzg9P=FZsor~!CtLYl{8FB
z2>P+LT|f&%n+Nc|@EsPc2m82K*1tB(C&WIIyVdz1)&3)5w(G<mCi~;#_xh#BSQ}Wo
ztJy&z$S`h&@+z9YwT@uHwMM+Li^_zO(b{vvIOdCde`DZuj9b@z{ze;x0V!K@nWIV{
z*3W5errEF1EJazocR~C=oJHHpa<T%uJ&3y_|47o{wmM+r642-L=ez$<L<`SO{h7Zd
zi%BD3aKgjKQ?C9}#L4^!CEL$wVp8iPuD=gu4u9YOpl_x3tsS<uCAMwNCuA40gvtf+
zsoi0j_WkYyDhVoMBpW^zY}SdT;{Ny1*tYntu&$WM_azEcf+P=*_$3S{4BH%VBVd>y
zY$g$}1uNhY;iSqp&&1o!B6qeNzlx9yM~|`u94s~3{^IN|m{ckM-RrDinX7GC1Mikx
zu#yO_!%2(cM?HD;hskSH6Nk?4)ZxdcbZPE48i7G5!=PmN=|>~U`WIHK%M#&j1brKy
zcG=cG$ppPQwP@UBe{;k|2vq8Q)Cjy{{*^-d<(FO+P=75?J{!{BabGx0GE6K?%7DF=
zdi4%#u=lH&=%9hHpqvkGZIhh-y@Z_!e+(%3vEb2N(RYzpCmEP9Ve4Ri_)I%$HBuH6
zGI(2kOBerabWuJ)J9;gqkTgonb7b7UR)O$VALYc?JQ}Alt#wN+MwA$Vr+DS)P3`lm
z_q!i}vjF3Wk#+o=vFkWuyMD6If4F@_T8_~VGy!7Korkljs|n-Yh!jy<GkBq<SDVUZ
zM|vTu2+bMYAT2bkLgImR1g}X$yF!1EM{GEj1*yJj!-bxQ9;S@bGsCkS8*=*Z@3R*}
zQ~sX-zzIM0W3-n#gq7+CBj1n8r|mNQSZ}V%SB6~Me_}jdd+oJmoPs@d@ah8B#~cJW
z?7@p%^)Xm+P0yO_1J~T+^0jBbtQQ6x>*qOVpJRAn6k@C~7LGjfNY7^LwGMO?V5Ab%
zCwf|Dd<6m>hQLx)?bV{Rbl%)p2=rmH_yw$rmpn}>?&#U1#(rX~y@1YQz-C5ZL-UK0
z3=+yXe{u6(5k?lLXX<C+<J}vc1fJJjcdadec&}LOc^8P6S-<q9FPWY!E@MCO346ho
zcU^c17aEKmWO16qsA5s@3q10nXVD_edu5*SSt5V2c=1s{9ve2s1^FzXY~K9kAe#@K
zAl{*1p~KkVT?yXNp$zYu7AP&|Y>Jc-FcAHzf0m70xQQO!+3<urUY&e}l8!#=Xln=F
zIt*6=x?%L<Q9=jarND?_fgPV;66PHtHu-!lX$v$wYzp3Ez$U<ZCK#s}B)rc;{frxo
z4%$he-v}(wc<k_4Vd!GykVb!WrM<kvL7&3QdmjWmG#JZ1z(Y9(9fs9ur=4bP;yoL@
ze+c<n+OVeo{(kA-(=#)=j7j9s54^(y4(LLC;D<qq7wYu<E+C!_wE-^_UI8{$crfzW
zxX_>aG0=D)jm?;G$a^*P9q$xkw5w0lSIEV%XKW1{I?UeD`r!|MXzzXT9u(toboQn&
zj+hfwfz1+q!HltoEXJR_eY8gy;vK@%f5Eud&lXTFy^v2mGV(~HKlL*vm?LMNd1f(I
znU@%nyxYb*QFuF;<FspyY-nQu@rNMHZ_Qg|f)77SfjsnO{Jk=-{?ioni2{8NuL8QE
z3x)+a^X?P+v5p{%H+&jqr(wtYjl7%0n4(RLPX*=?`eUqo<Rc$R&@xW0zo9-qf51fj
z#1lD6(-!(20|OlKT<b4=858_<G;0qZ3^%;rBZiMK40$h#IYfPUf*D8XLAw;lWBfDr
zIDq*6L2vq*fU(c|$bo`((3b?wHTsNq_VBLp?izvh4V?+RpT&EE7-;kX>koYg-%;7S
z%X-5c-eAKG(oc{2X&O4LUJr8^e>ta~daAXBxexyEVSMqPDp=xSWIYpZdRpc26$o?~
z0!=Tu&zbXLHbN%k3C7E*{qo}UOg`y7m!8d=+>9AB^Je#)Jtt1QFT1EmX3xb)n@D~!
z06#5M7-JY31i9APK$w&mKX^VkDG@l0lg8`C2E*dTwZUQeDgw_Cix_1ae{a08ozz&2
zcuAOv&r9WOg!w%gTV$c(^v{!pj!BMj$HK&Bz-G)QfWgHgQFTSg0)`>Lle*T<Cv@tg
zO|%ca(UW?4xtUEPzq3^6gCWHtiZ=uuFaX)mX+H}ef4u}IY$$j}SYSDg<EdlOgck1(
z3n#e9Tf!-o>jB}WO$>~{e@A`6hQxwMyII_6H#p_@l<btt%fRGgU?H2unyVQ$2o__!
z9<&X4l&v*-t+dL@s~8p-Se%sE4A7IlWW!_A*=OH<(spC&SA_8LL1(-V@Ia3t1}41R
zjt2pJxuT%I)LyWr-_Q*n0<ypcytuw$jF3nFp%d7$fnoGuU~mnCe`k^UkOeJ95gq{A
z$R-O;V8f=35yB~*jdavnqtd_u1I@EWIaew2lD&0{`U~}33B#u`MH_g5pRq;z_~VYz
zd5nOc*Ps5ws0BCZ=qGf-*yIId#sYctm#zrKPdgZc)Ws$Tt@;+3;0H$3%lKhjfC2I`
z!obLn6XXsaG}y+sf4qozU(k`~yWaIK!;0~W;e)<lh$n}a<>^2Af<PKP*|h0D<{*8G
zPP799oB4(e`jokgHwnGbiFVOGWHROn%zNoVA27xyOsM~y0qv5<hrR_rj9d;+$YlLM
z2lxrd22<ptCv%qh!F8B0gbrEgjefL42Tsz^fhBDLFX}-jf7%2cYYH#V3lpxHr{sCY
zykgx0H|9fr<I^zE_}5sFQO8^;bjh?BYqSF+lLHNX$sve7rd?pHCv9Zi<xoIAZGjhE
znNN7E$LGTohCbs5>@nKWnLp})pEUS_r`CrZvv(Myj5Q4}IDFs>4~Itjmhr+LFEH+?
z8!RIP0-cJ0fBlkso}YOl)K5C+pMPndcn{{u(RG>=I7}8M@z9||vWt25ya=*6GP$cK
z5wtx`u-?$9em%=Pcvo1QS-1$CAUVO|K`YZrM)_%14cVwHhcdrU`?%+8l@Cp;GUe-8
zruF&0teo%5h?fKJ6md<*W}$!#LRDXR`93b*-aI{@e~-gkPD`H8_i>e%pU@C`YD1Z?
zUAkOvyE<e@EU3IHeS0ITRXt^$ThUeJmw9{Aqo;D!QI@Ox^3&7#ICQP*D$|u^l7@yL
ztXuIYztvh`LMpy~cgpY5^23(5Ly0ezJfBD0=PRyfJKAztRk|#vr?g~vIv=N;G(q@T
zqVd(Le_uRJ!~=m&MZjKy(jkMB_P+b>ns#~D?CeSDZfpP&lMQ2L=+OF0jjfC;Xqk}E
z^Wii@Ag+AUnzT$*i|1<jwQrrsL{FI}vv@eEbMnJ$z%>h}Io#E}%!<c^;Oi$&fM0Tb
zxfM3Pq>pH!(}~Q>kxr5Wy?9g?G=wUCFH7{2e<ci*&$B0b(YBI-$4pm_Tn&I9`VxGb
zeY{+!(dJV%-nMRW`Y{{a{HK6?FVA=y{q5_v_TtBL{SU2ZB#+ZS_d-?p_<E}JCQtI9
zEz2N}Kt6QBk+}Gj=Xre`Ixk0hdwFH~o?mh5Azl@HJG?&SI^Zp1qIO6w`~>BTUV5lZ
ze{`gYOE>5hCtq@)BS<I3d8!V|#NUptl`iGFB#SzvuV{RlIG?gy_%wFCEb<9HPwUUT
zm*?4)E#>4<A9Bm>ftS2;K73VqRr%-)Ey3$z8Tm_c)V8X$*MqslJciEaOFsF02vwNT
z&iUw+%d2D<V|)by9g2W?u+(-xd6n1df60>EwS~5#diC;ocYt?jxN;c1_GtSR^#y6q
ztEcH}TNCfJaJ9jeY~b_S_C?gbWFWvhM;I4+DP9K2lF_<oMIaCeEGz;|1{OkeN@*{U
z6WZ&^yy~uP7!Tbs@i~EyM<e2az``Nm=aG*uoV4Hy1OkC234v|~*5cYY+}jGAe<0%&
zDKwg&TnTUm68JRZ5~)C7VG+QvBE+0pSOkMF5Lhx1SYiyUC9`{?Re?Yt5C{YUfj}Uz
zI3iH}2JPb5lF&I22m}IwKp+qZ1OkEA2?AkYy-qqJ)CdFufj}S-2m}IwB?o~pu$G*@
zjFtoffj}S-2m}Iw!0QBoFtA=HCmj)L1OkCTAP@)y0)fDigTVg*VUq^;%i8-W00000
LNkvXXu0mjfa)4s6

delta 35140
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
VrC8~Q*b)E$002ovPDHLkV1o8Ui=6-f


From e7375e8610584ab50e03e56fe44a0aa4b5a7a017 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 5 Jun 2024 16:22:24 +0600
Subject: [PATCH 53/75] pkp/plagiarism#52 added some precautionary checks

---
 IThenticate.inc.php      | 6 +++---
 PlagiarismPlugin.inc.php | 5 +++++
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 599ce39..383be16 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -747,13 +747,13 @@ protected function getApiPath($apiPathSegment) {
      * 
      * @param  string   $entity     The entity name (e.g. owner/submitter etc).
      * @param  mixed    $id         Entity id associated with requesting system.
-     * @param  bool     $silent     Silently return the passed `$id` is no matching entity mapping
-     *                              not found. Default to `true` and when set to `false`, will throw
+     * @param  bool     $silent     Silently return the passed `$id` if no matching entity mapping
+     *                              not found. Default to `false` and when set to `true`, will not throw
      *                              exception.
      * 
      * @return mixed
      */
-    protected function getGeneratedId($entity, $id, $silent = true) {
+    protected function getGeneratedId($entity, $id, $silent = false) {
         if (!in_array($entity, array_keys(static::ENTITY_ID_PREFIXES))) {
             if ($silent) {
                 return $id;
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index bac740e..bfe2361 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -558,6 +558,11 @@ public function stampEulaToSubmittingUser($context, $submission, $user = null) {
 		$request = Application::get()->getRequest();
 		$user ??= $request->getUser();
 
+		if (is_null($submission->getData('ithenticateEulaVersion'))) {
+			$submissionDao = DAORegistry::getDAO("SubmissionDAO"); /** @var SubmissionDAO $submissionDao */
+			$submission = $submissionDao->getById(1); /** @var Submission $submission */
+		}
+
 		$submissionEulaVersion = $submission->getData('ithenticateEulaVersion');
 
 		// If submission EULA version has already been stamped to user

From a0ad8d95b519afb822a5417170cad3522db8a812 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 7 Jun 2024 14:13:54 +0600
Subject: [PATCH 54/75] pkp/plagiarism#52 added better enable/disable control

---
 PlagiarismPlugin.inc.php | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index bfe2361..abeaae1 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -140,29 +140,29 @@ public function getDescription() {
 	 * @copydoc LazyLoadPlugin::getCanEnable()
 	 */
 	public function getCanEnable($contextId = null) {
-		if (!Config::getVar('ithenticate', 'ithenticate')) {
-			return false;
-		}
-
-		return !$this->getEnabled($contextId);
+		return !Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getCanDisable()
 	 */
 	public function getCanDisable($contextId = null) {
-		if (!Config::getVar('ithenticate', 'ithenticate')) {
-			return false;
-		}
-
-		return !$this->getEnabled($contextId);
+		return !Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**
 	 * @copydoc LazyLoadPlugin::getEnabled()
 	 */
 	public function getEnabled($contextId = null) {
-		return parent::getEnabled($contextId) && Config::getVar('ithenticate', 'ithenticate');
+		if (!Config::getVar('general', 'installed')) {
+			return false;
+		}
+
+		if (Config::getVar('ithenticate', 'ithenticate') && !parent::getEnabled($contextId)) {
+			$this->setEnabled(true);
+		}
+		
+		return parent::getEnabled($contextId) || Config::getVar('ithenticate', 'ithenticate');
 	}
 
 	/**

From 63e783a7f0a1db29ccd81777e35b9df03b9b3aad Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 12 Jun 2024 14:44:36 +0600
Subject: [PATCH 55/75] pkp/plagiarism#52 added all serach repos and removed
 viewer_permissions from viewer launch url create process

---
 IThenticate.inc.php | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 383be16..e166893 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -386,9 +386,7 @@ public function scheduleSimilarityReportGenerationProcess($submissionUuid, $sett
 
                     // section `generation_settings` settings
                     'generation_settings' => [
-                        'search_repositories' => $this->getEnabledFeature(
-                            'similarity.generation_settings.search_repositories'
-                        ) ?? [
+                        'search_repositories' => [
                             'INTERNET',
                             'SUBMITTED_WORK',
                             'PUBLICATION',
@@ -474,13 +472,6 @@ public function createViewerLaunchUrl($submissionUuid, $user, $locale, $viewerPe
                     'viewer_user_id' => $this->getGeneratedId('submitter', $user->getId()),
                     'locale' => $locale,
                     'viewer_default_permission_set' => $viewerPermission,
-                    'viewer_permissions' => [
-                        'may_view_submission_full_source' => true,
-                        'may_view_match_submission_info' => true,
-                        'may_view_flags_panel' => true,
-                        'may_view_document_details_panel' => true,
-                        'may_view_sections_exclusion_panel' => true,
-                    ],
                     'similarity' => [
                         'view_settings' => [
                             'save_changes' => $allowUpdateInViewer

From 9a401d3217934c24c273ff35e893a2e8e383f8eb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 12 Jun 2024 22:28:09 +0600
Subject: [PATCH 56/75] pkp/plagiarism#52 added check before manula similarity
 report scheduling

---
 IThenticate.inc.php                           | 27 +++++++++
 PlagiarismPlugin.inc.php                      | 10 ++++
 TestIThenticate.inc.php                       | 23 ++++++++
 ...PlagiarismIthenticateActionHandler.inc.php | 56 +++++++++++++++++++
 controllers/PlagiarismWebhookHandler.inc.php  |  4 ++
 locale/en_US/locale.po                        | 12 ++++
 6 files changed, 132 insertions(+)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index e166893..75a5011 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -360,6 +360,33 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
         return $response ? $response->getStatusCode() === 202 : false;
     }
 
+    /**
+     * Get the submission details
+     * @see https://developers.turnitin.com/docs/tca#get-submission-info
+     *
+     * @param string $submissionTacId   The submission UUID return back from service
+     * @return string|null              On successful retrieval of submission details it will return
+     *                                  details JSON data and on failure, will return null.
+     */
+    public function getSubmissionInfo($submissionUuid) {
+
+        $response = $this->makeApiRequest(
+            'GET',
+            $this->getApiPath("submissions/{$submissionUuid}"),
+            [
+                'headers' => $this->getRequiredHeaders(),
+                'verify' => false,
+                'exceptions' => false,
+            ]
+        );
+
+        if ($response->getStatusCode() === 200) {
+            return $response->getBody()->getContents();
+        }
+
+        return null;
+    }
+
     /**
      * Schedule the similarity report generation process
      * @see https://developers.turnitin.com/docs/tca#generate-similarity-report
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index abeaae1..44f8630 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -237,6 +237,16 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 			'validation' => ['nullable'],
 		];
 
+		$schema->properties->ithenticateSubmissionAcceptedAt = (object) [
+			'type' => 'string',
+			'description' => 'The timestamp at which this submission file successfully accepted at iThenticate service end',
+			'writeOnly' => true,
+			'validation' => [
+				'date:Y-m-d H:i:s',
+				'nullable',
+			],
+		];
+
 		return false;
 	}
 
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index e1d4ea1..b109b07 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -224,6 +224,29 @@ public function uploadFile($submissionTacId, $fileName, $fileContent) {
         return true;
     }
 
+    /**
+     * @copydoc IThenticate::getSubmissionInfo()
+     */
+    public function getSubmissionInfo($submissionUuid) {
+
+        return '{
+            "id": "'.$submissionUuid.'",
+            "owner": "a9c14691-9523-4f44-b5fc-4a673c5d4a35",
+            "title": "History 101 Final Esssay",
+            "status": "COMPLETE",
+            "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+            "page_count": 3,
+            "word_count": 145,
+            "character_count": 760,
+            "created_time": "2023-08-30T22:13:41Z",
+            "capabilities" : [
+                  "INDEX",
+                  "VIEWER",
+                  "SIMILARITY"
+              ]
+          }';
+    }
+
     /**
      * @copydoc IThenticate::scheduleSimilarityReportGenerationProcess()
      */
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index f5eaf14..9f37fb4 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -126,6 +126,62 @@ public function scheduleSimilarityReport($args, $request) {
 			...static::$_plugin->getServiceAccess($context)
 		);
 
+		// If no confirmation of submission file completed the processing at iThenticate service'e end
+		// we first need to check it's processing status to see has set to `COMPLETED`
+		// see more at https://developers.turnitin.com/turnitin-core-api/best-practice/retry-polling
+		if (!$submissionFile->getData('ithenticateSubmissionAcceptedAt')) {
+			$submissionInfo = $ithenticate->getSubmissionInfo($submissionFile->getData('ithenticateId'));
+			ray($submissionInfo);
+
+			// submission info not available to schedule report generation process
+			if (!$submissionInfo) {
+				$this->generateUserNotification(
+					$request,
+					NOTIFICATION_TYPE_ERROR,
+					__('plugins.generic.plagiarism.webhook.similarity.schedule.error', [
+						'submissionFileId' => $submissionFile->getId(),
+						'error' => __('plugins.generic.plagiarism.submission.status.unavailable'),
+					])
+				);
+				return $this->triggerDataChangedEvent($submissionFile);
+			}
+
+			$submissionInfo = json_decode($submissionInfo);
+
+			// submission has not completed yet to schedule report generation process
+			if ($submissionInfo->status !== 'COMPLETE') {
+				$similaritySchedulingError = '';
+
+				switch($submissionInfo->status) {
+					case 'CREATED' :
+						$similaritySchedulingError = __('plugins.generic.plagiarism.submission.status.CREATED');
+						break;
+					case 'PROCESSING' :
+						$similaritySchedulingError = __('plugins.generic.plagiarism.submission.status.PROCESSING');
+						break;
+					case 'ERROR' :
+						$similaritySchedulingError = property_exists($submissionInfo, 'error_code')
+							? __("plugins.generic.plagiarism.submission.status.{$submissionInfo->error_code}")
+							: __('plugins.generic.plagiarism.submission.status.ERROR');
+						break;
+				}
+
+				$this->generateUserNotification(
+					$request,
+					NOTIFICATION_TYPE_ERROR,
+					__('plugins.generic.plagiarism.webhook.similarity.schedule.error', [
+						'submissionFileId' => $submissionFile->getId(),
+						'error' => $similaritySchedulingError,
+					])
+				);
+
+				return $this->triggerDataChangedEvent($submissionFile);
+			}
+
+			$submissionFile->setData('ithenticateSubmissionAcceptedAt', Core::getCurrentDate());
+			$submissionFileDao->updateObject($submissionFile);
+		}
+
 		$scheduleSimilarityReport = $ithenticate->scheduleSimilarityReportGenerationProcess(
 			$submissionFile->getData('ithenticateId'),
 			static::$_plugin->getSimilarityConfigSettings($context)
diff --git a/controllers/PlagiarismWebhookHandler.inc.php b/controllers/PlagiarismWebhookHandler.inc.php
index ff1c86f..7817a2a 100644
--- a/controllers/PlagiarismWebhookHandler.inc.php
+++ b/controllers/PlagiarismWebhookHandler.inc.php
@@ -123,6 +123,10 @@ protected function handleSubmissionCompleteEvent($context, $payload, $event) {
 			);
 			return;
 		}
+
+		$submissionFile->setData('ithenticateSubmissionAcceptedAt', Core::getCurrentDate());
+		$submissionFileDao->updateObject($submissionFile);
+		$submissionFile = $submissionFileDao->getById($submissionFile->getId());
 		
 		if ((int)$submissionFile->getData('ithenticateSimilarityScheduled')) {
 			static::$_plugin->sendErrorMessage(
diff --git a/locale/en_US/locale.po b/locale/en_US/locale.po
index c82ed86..e724606 100644
--- a/locale/en_US/locale.po
+++ b/locale/en_US/locale.po
@@ -233,3 +233,15 @@ msgstr "Could not create the submission at iThenticate for submission file id :
 
 msgid "plugins.generic.plagiarism.ithenticate.file.upload.failed"
 msgstr "Could not complete the file upload at iThenticate for submission file id  : {$submissionFileId}"
+
+msgid "plugins.generic.plagiarism.submission.status.unavailable"
+msgstr "Submission details is unavailable."
+
+msgid "plugins.generic.plagiarism.submission.status.CREATED"
+msgstr "Submission has been created but no file has been uploaded"
+
+msgid "plugins.generic.plagiarism.submission.status.PROCESSING"
+msgstr "File contents have been uploaded and the submission is still being processed"
+
+msgid "plugins.generic.plagiarism.submission.status.ERROR"
+msgstr "An error occurred during submission processing."

From 2972f3d227d599843ad507fb11d1e0f60cff5703 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 12 Jun 2024 22:30:34 +0600
Subject: [PATCH 57/75] pkp/plagiarism#52 translation update

---
 controllers/PlagiarismIthenticateActionHandler.inc.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 9f37fb4..6426a89 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -131,7 +131,6 @@ public function scheduleSimilarityReport($args, $request) {
 		// see more at https://developers.turnitin.com/turnitin-core-api/best-practice/retry-polling
 		if (!$submissionFile->getData('ithenticateSubmissionAcceptedAt')) {
 			$submissionInfo = $ithenticate->getSubmissionInfo($submissionFile->getData('ithenticateId'));
-			ray($submissionInfo);
 
 			// submission info not available to schedule report generation process
 			if (!$submissionInfo) {
@@ -161,7 +160,7 @@ public function scheduleSimilarityReport($args, $request) {
 						break;
 					case 'ERROR' :
 						$similaritySchedulingError = property_exists($submissionInfo, 'error_code')
-							? __("plugins.generic.plagiarism.submission.status.{$submissionInfo->error_code}")
+							? __("plugins.generic.plagiarism.ithenticate.submission.error.{$submissionInfo->error_code}")
 							: __('plugins.generic.plagiarism.submission.status.ERROR');
 						break;
 				}

From 207361b19fab2a2c43d54d175491218199da7a11 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 14 Jun 2024 22:47:37 +0600
Subject: [PATCH 58/75] pkp/plagiarism#52 added comment for issue no 49 and
 install mode conflict

---
 PlagiarismPlugin.inc.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 44f8630..3f29710 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -154,10 +154,17 @@ public function getCanDisable($contextId = null) {
 	 * @copydoc LazyLoadPlugin::getEnabled()
 	 */
 	public function getEnabled($contextId = null) {
+		
+		// This check is required as plugin can be forced enable by setting `ithenticate` to `On`
+		// in the config file which cuase the hooks to run but unavailable
+		// in the installation mode by setting `installed` to `Off`
 		if (!Config::getVar('general', 'installed')) {
 			return false;
 		}
 
+		// This allow to force enable the plugin into the system if `ithenticate` set to `On` but the plugin
+		// itself still disable as in `plugin_setings` table, the `enabled` value not set or set to `0`
+		// for more details, see https://github.com/pkp/plagiarism/issues/49
 		if (Config::getVar('ithenticate', 'ithenticate') && !parent::getEnabled($contextId)) {
 			$this->setEnabled(true);
 		}

From 38cb063f418cfdeb6d4a7cdb3f0f27ca9aaf7391 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 19 Jun 2024 14:21:43 +0600
Subject: [PATCH 59/75] pkp/plagiarism#52 readme updated

---
 README.md                                      | 18 ++++++++++--------
 .../PlagiarismIthenticateActionHandler.inc.php |  9 +++------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index bb6e576..87a6cd7 100644
--- a/README.md
+++ b/README.md
@@ -4,24 +4,26 @@ For OJS/OMP/OPS 3.x
 
 ## Overview
 
-This plugin permits automatic submission of uploaded manuscripts to the [iThenticate service](http://www.ithenticate.com/) for plagiarism checking.
+This plugin permits automatic or manula submission of uploaded manuscripts to the [iThenticate service](http://www.ithenticate.com/) for plagiarism checking. 
+
 1. You need an account on ithenticate.com (costs involved)
    * paid via Crossref Similarity Check
    * or, paid directly to iThenticate
-2. Install the plugin via the Plugin Gallery
-3. Configure the plugin (see below)
+2. Configure the API credentials following this [guide](https://help.turnitin.com/ithenticate/administrator/api-custom.htm)
+3. Install the plugin via the Plugin Gallery
+4. Configure the plugin (see below)
    * Enable the iThenticate service from `config.inc.php` by setting `ithenticate` to `On`.
    * Enable the plugin from Plugin Gallery by clicking on the checkbox. 
    * ![Example Enabling Plugin](images/enable-plugin.png)
-   * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com
+   * Configure the plugin with the **API URL** and **API KEY** you get from ithenticate.com at plugin's setting page or in the config file.
    * ![Example Settings configuration](images/ithenticate-settings.png)
-4. The author logs in and makes a submission
+5. The author logs in and makes a submission
    * At Step 4 of the submission process, submitting user must confirm iThenticate's End User License Agreement to complete the submission.
    * The submission files will be sent to iThenticate in Step 4 of the submission process.
-5. The Editor logs in to OJS/OMP/OPS installation and opens the Submission workflow page.
+6. The Editor logs in to OJS/OMP/OPS installation and opens the Submission workflow page.
    * In the submission files grid view, the Editor can see the similarity scores if the similarity process has completed.
    * The Editor can also launch iThenticate's similarity viewer.
-6. If auto upload to iThenticate is disabled, the Editor can send each submission file to iThenticate from the workflow stage.
+7. If auto upload to iThenticate is disabled, the Editor can send each submission file to iThenticate from the workflow stage.
 
 ## Similarity Check Settings
 
@@ -73,7 +75,7 @@ ithenticate = On
 ; Other settings can be configured here; see README.md for all options.
 ```
 
-> NOTE : Changing the api credentails (api_url and/or api_key) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
+> NOTE : Changing the api credentails (`api_url` and/or `api_key`) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
 
 ## Restrictions
 1. The submitting user must confirm the iThenticate End User License Agreement to send files to iThenticate service for plagiarism checking.
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 6426a89..ab60bad 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -306,11 +306,8 @@ public function submitSubmission($args, $request) {
 	}
 
 	/**
-	 * Accept the EULA, stamp it to proper entity (Submission/User or both) and may run
-	 * one of following intended action
-	 * 	- Upload submission file
-	 * 	- Schedule similarity report generation process
-	 *  - Refresh the similarity report scores
+	 * Accept the EULA, stamp it to proper entity (Submission/User or both) and upload
+	 * submission file
 	 *
 	 * @param array $args
 	 * @param Request $request
@@ -355,7 +352,7 @@ public function acceptEulaAndExecuteIntendedAction($args, $request) {
 	}
 
 	/**
-	 * Show the EULA confirmation modal before the intended action
+	 * Show the EULA confirmation modal before the uploading submission file to iThenticate
 	 *
 	 * @param array $args
 	 * @param Request $request

From 450e03b1d31700ce4d47fbdb54f3fa1cb7a39bc7 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 20 Jun 2024 20:08:44 +0600
Subject: [PATCH 60/75] pkp/plagiarism#52 existing webook delete added before
 registering a new one

---
 IThenticate.inc.php                      | 21 +++++++++++++++++++++
 PlagiarismPlugin.inc.php                 |  2 +-
 PlagiarismSettingsForm.inc.php           | 19 +++++++++++--------
 TestIThenticate.inc.php                  |  8 ++++++++
 grids/SimilarityActionGridColumn.inc.php |  2 +-
 5 files changed, 42 insertions(+), 10 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 75a5011..d6d7f95 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -571,6 +571,9 @@ public function validateEulaVersion($version) {
      * Register webhook end point
      * @see https://developers.turnitin.com/docs/tca#create-webhook
      *
+     * NOTE :   with same webhook url, it will return response with status code 409(HTTP_CONFLICT)
+     *          So it's important to verify one before create a new one
+     * 
      * @param string $signingSecret
      * @param string $url
      * @param array  $events
@@ -601,6 +604,24 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
         return null;
     }
 
+    /**
+     * Delete webhook end point
+     * @see https://developers.turnitin.com/docs/tca#delete-webhook
+     *
+     * @param string $webhookId
+     * @return bool
+     */
+    public function deleteWebhook($webhookId) {
+
+        $response = $this->makeApiRequest('DELETE', $this->getApiPath("webhooks/{$webhookId}"), [
+            'headers' => $this->getRequiredHeaders(),
+            'verify' => false,
+            'exceptions' => false,
+        ]);
+
+        return $response && $response->getStatusCode() === 204;
+    }
+
     /**
      * Get the stored EULA details
      * 
diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 3f29710..6e9df77 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -367,7 +367,7 @@ public function confirmEulaAcceptance($hookName, $params) {
 			return false;
 		}
 
-		// If submission has EULA stamped and user has EULA stamped and both are save version
+		// If submission has EULA stamped and user has EULA stamped and both are same version
 		// so there is no need to confirm EULA again
 		if ($submission->getData('ithenticateEulaVersion') &&
 			$submission->getData('ithenticateEulaVersion') == $user->getData('ithenticateEulaVersion')) {
diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index b21b94a..922b332 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -132,16 +132,19 @@ public function execute(...$functionArgs) {
 
 		if (!empty(array_filter([$ithenticateApiUrl, $ithenticateApiKey]))) {
 
+			// access updated or new access entered, need to update webhook registration
 			if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||
 				$this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiKey') !== $ithenticateApiKey) {
-				
-				// access updated or new access entered, need to update webhook registration	
-				$this->_plugin->registerIthenticateWebhook(
-					$this->_plugin->initIthenticate(
-						$this->getData('ithenticateApiUrl'),
-						$this->getData('ithenticateApiKey')
-					)
-				);
+
+				$ithenticate = $this->_plugin->initIthenticate($ithenticateApiUrl, $ithenticateApiKey);
+
+				// If there is a already registered webhook for this context, need to delete it first
+				// before creating a new one as webhook URL remains same which will return 409(HTTP_CONFLICT)
+				if ($this->_context->getData('ithenticateWebhookId')) {
+					$ithenticate->deleteWebhook($this->_context->getData('ithenticateWebhookId'));
+				}
+
+				$this->_plugin->registerIthenticateWebhook($ithenticate);
 			}
 
 			$this->_plugin->updateSetting($this->_context->getId(), 'ithenticateApiUrl', $ithenticateApiUrl, 'string');
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index b109b07..08db832 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -319,6 +319,14 @@ public function registerWebhook($signingSecret, $url, $events = self::DEFAULT_WE
         return \Illuminate\Support\Str::uuid()->__toString();
     }
 
+    /**
+     * @copydoc IThenticate::deleteWebhook()
+     */
+    public function deleteWebhook($webhookId) {
+        error_log("ithenticate webhook with id : {$webhookId} removed");
+        return true;
+    }
+
     /**
      * @copydoc IThenticate::getEulaDetails()
      */
diff --git a/grids/SimilarityActionGridColumn.inc.php b/grids/SimilarityActionGridColumn.inc.php
index 072fb57..c2756f9 100644
--- a/grids/SimilarityActionGridColumn.inc.php
+++ b/grids/SimilarityActionGridColumn.inc.php
@@ -306,7 +306,7 @@ protected function isEulaConfirmationRequired($context, $submission, $user) {
 			return true;
 		}
 
-		// If no EULA is stamped with submission
+		// If no EULA is stamped with submitting user
 		// means user has never previously interacted with iThenticate process
 		if (!$user->getData('ithenticateEulaVersion')) {
 			return true;

From a6fa2b89e49de352c51387fff4d5d710df58e9af Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 24 Jun 2024 01:45:08 +0600
Subject: [PATCH 61/75] pkp/plagiarism#52 fixed webhook registration issue in
 settings form

---
 PlagiarismSettingsForm.inc.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index 922b332..d4ff924 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -130,7 +130,10 @@ public function execute(...$functionArgs) {
 		$ithenticateApiUrl = trim($this->getData('ithenticateApiUrl'), "\"\';");
 		$ithenticateApiKey = trim($this->getData('ithenticateApiKey'), "\"\';");
 
-		if (!empty(array_filter([$ithenticateApiUrl, $ithenticateApiKey]))) {
+		// if proper api url and api key provided and if there is no forced credentails defined in 
+		// `config.inc.php` at global or for this context
+		if (!empty(array_filter([$ithenticateApiUrl, $ithenticateApiKey])) &&
+			!$this->_plugin->hasForcedCredentials($this->_context->getId())) {
 
 			// access updated or new access entered, need to update webhook registration
 			if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||

From 5c493ac71c161e8e82991d0dbe0a7f279518debc Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 3 Jul 2024 19:31:27 +0600
Subject: [PATCH 62/75] pkp/plagiarism#52 added CLI tool update webhook on
 config creds change

---
 PlagiarismPlugin.inc.php   |  16 ++++--
 README.md                  |   5 +-
 tools/registerWebhooks.php | 111 +++++++++++++++++++++++++++++++++++++
 3 files changed, 125 insertions(+), 7 deletions(-)
 create mode 100644 tools/registerWebhooks.php

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 6e9df77..136f89e 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -675,7 +675,7 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 	 * @param IThenticate|TestIThenticate $ithenticate
 	 * @param Context|null 					$context
 	 * 
-	 * @return void
+	 * @return bool
 	 */
 	public function registerIthenticateWebhook($ithenticate, $context = null) {
 
@@ -683,7 +683,7 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 		$context ??= $request->getContext();
 
 		$signingSecret = \Illuminate\Support\Str::random(12);
-		$webhookUrl = $request->getDispatcher()->url(
+		$webhookUrl = Application::get()->getDispatcher()->url(
 			$request,
 			ROUTE_COMPONENT,
 			$context->getData('urlPath'),
@@ -697,9 +697,13 @@ public function registerIthenticateWebhook($ithenticate, $context = null) {
 				'ithenticateWebhookSigningSecret' => $signingSecret,
 				'ithenticateWebhookId' => $webhookId
 			], $request);
-		} else {
-			error_log("unable to complete the iThenticate webhook registration for context id {$context->getId()}");
+
+			return true;
 		}
+
+		error_log("unable to complete the iThenticate webhook registration for context id {$context->getId()}");
+
+		return false;
 	}
 
 	/**
@@ -838,7 +842,7 @@ public function retrieveEulaDetails($cache, $cacheId) {
 	public function initIthenticate($apiUrl, $apiKey) {
 
 		if (static::isRunningInTestMode()) {
-			$this->import('TestIThenticate');
+			import('plugins.generic.plagiarism.TestIThenticate');
 			return new TestIThenticate(
 				$apiUrl,
 				$apiKey,
@@ -847,7 +851,7 @@ public function initIthenticate($apiUrl, $apiKey) {
 			);
 		}
 
-		$this->import('IThenticate');
+		import('plugins.generic.plagiarism.IThenticate');
 
 		return new IThenticate(
 			$apiUrl,
diff --git a/README.md b/README.md
index 87a6cd7..9ef6962 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,9 @@ ithenticate = On
 ; api_url[Journal_or_Server_or_Press_path] = "https://some-ithenticate-account.com"
 ; api_key[Journal_or_Server_or_Press_path] = "YOUR_API_KEY"
 
+; To update webhook after changing the API URL or/both KEY defined in the config file,
+; run the command `php plugins/generic/plagiarism/tools/registerWebhooks.php`.
+
 ; To globally disable auto upload of submission files to iThenticate service, uncomment following line.
 ; disableAutoSubmission = On
 ; It is possible to disable auto upload at specific Journal/Server/Press level rather than globally
@@ -75,7 +78,7 @@ ithenticate = On
 ; Other settings can be configured here; see README.md for all options.
 ```
 
-> NOTE : Changing the api credentails (`api_url` and/or `api_key`) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process.
+> NOTE : Changing the api credentails (`api_url` and/or `api_key`) in the `config.inc.php` file will not update the webhook settings automatically and will require action from the submission workflow section to complete plagiarism similarity score generation process. However it is possible to use the command line tool to update it from CLI via command `php plugins/generic/plagiarism/tools/registerWebhooks.php` to update webhook for forced credentails.
 
 ## Restrictions
 1. The submitting user must confirm the iThenticate End User License Agreement to send files to iThenticate service for plagiarism checking.
diff --git a/tools/registerWebhooks.php b/tools/registerWebhooks.php
new file mode 100644
index 0000000..056fb6c
--- /dev/null
+++ b/tools/registerWebhooks.php
@@ -0,0 +1,111 @@
+<?php
+
+require(dirname(dirname(dirname(dirname(dirname(__FILE__))))) . '/tools/bootstrap.inc.php');
+
+import("plugins.generic.plagiarism.PlagiarismPlugin");
+
+class RegisterWebhooks extends CommandLineTool {
+
+    /**
+	 * The specific context path for which intend to update the iThenticate webhook details
+	 * 
+	 * @var string
+	 */
+	protected $contextPath = null;
+
+    /**
+	 * Constructor.
+	 * 
+	 * @param array $argv command-line arguments
+	 */
+	public function __construct($argv = []) {
+		
+		parent::__construct($argv);
+
+		if (isset($this->argv[0])) {
+			$this->contextPath = $this->argv[0];
+		}
+	}
+
+    /**
+	 * Print command usage information.
+	 */
+	public function usage() {
+		echo "Register Webhooks for iThenticate Account.\n\n"
+			. "Usage: {$this->scriptName} optional.context.path \n\n";
+	}
+
+	/**
+	 * Execute the specified migration.
+	 */
+	public function execute() {
+		try {
+
+			$plagiarismPlugin = new PlagiarismPlugin();
+
+			if ($this->contextPath) {
+				$contextDao = Application::getContextDAO(); /** @var ContextDAO $contextDao */
+				$context = $contextDao->getByPath($this->contextPath); /** @var Context $context */
+				if (!$context) {
+					throw new \Exception("No context found for given context path: {$this->contextPath}");
+				}
+				
+				$this->updateWebhook($context, $plagiarismPlugin);
+
+				return;
+			}
+
+			// check if there is a global level config e.g. one config for all context
+			// 		- Run webhook update for all contexts 
+			// If there is no global level config, then check if each context level config
+			// 		- Run webhook update only for those specific context
+			// if no global level or context level config defined, e.g. configs are managed via plugin setting from
+			//		- nothing to do as plugin's setting will handle webhook update on config update
+
+			$contextService = Services::get("context"); /** @var \APP\Services\ContextService $contextService */
+			foreach($contextService->getMany() as $context) { /** @var Context $context */
+				$this->updateWebhook($context, $plagiarismPlugin);
+			}
+
+		} catch (\Throwable $exception) {
+			echo 'EXCEPTION: ' . $exception->getMessage() . "\n\n";
+			exit(2);
+		}
+	}
+
+	/**
+	 * Update the webhook details for given context
+	 * 
+	 * @param Context 			$context
+	 * @param PlagiarismPlugin	$plagiarismPlugin
+	 * 
+	 * @return void
+	 */
+	protected function updateWebhook($context, $plagiarismPlugin) {
+		if (!$plagiarismPlugin->hasForcedCredentials($context)) {
+			echo "ERROR: No forced credentails defined for context path : {$context->getData('urlPath')}\n\n";
+			return;
+		}
+
+		/** @var IThenticate|TestIThenticate $ithenticate */
+		$ithenticate = $plagiarismPlugin->initIthenticate(
+			...$plagiarismPlugin->getForcedCredentials($context)
+		);
+
+		// If there is a already registered webhook for this context, need to delete it first
+		// before creating a new one as webhook URL remains same which will return 409(HTTP_CONFLICT)
+		$existingWebhookId = $context->getData('ithenticateWebhookId');
+		if ($existingWebhookId) {
+			$ithenticate->deleteWebhook($existingWebhookId);
+		}
+
+		$webhookUpdateStatus = $plagiarismPlugin->registerIthenticateWebhook($ithenticate, $context);
+
+		echo $webhookUpdateStatus
+			? "SUCCESS: updated the webhook for context path : {$context->getData('urlPath')}\n\n"
+			: "ERROR: unable to updated the webhook for context path : {$context->getData('urlPath')}\n\n";
+	}
+}
+
+$tool = new RegisterWebhooks(isset($argv) ? $argv : []);
+$tool->execute();

From 0e935692b9c0224808a1775c6694420653876ef4 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 8 Jul 2024 13:19:38 +0600
Subject: [PATCH 63/75] Update to version 1.0.6.2

---
 version.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/version.xml b/version.xml
index 5950b4c..b89e685 100644
--- a/version.xml
+++ b/version.xml
@@ -13,8 +13,8 @@
 <version>
 	<application>plagiarism</application>
 	<type>plugins.generic</type>
-	<release>1.0.6.0</release>
-	<date>2023-08-02</date>
+	<release>1.0.6.2</release>
+	<date>2024-07-08</date>
 	<lazy-load>1</lazy-load>
 	<class>PlagiarismPlugin</class>
 </version>

From fda3e40e148a28db194ce3ad14339c911ce5f4ea Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Mon, 8 Jul 2024 13:36:00 +0600
Subject: [PATCH 64/75] Update to version 1.0.7.0

---
 version.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/version.xml b/version.xml
index b89e685..b5bc580 100644
--- a/version.xml
+++ b/version.xml
@@ -13,7 +13,7 @@
 <version>
 	<application>plagiarism</application>
 	<type>plugins.generic</type>
-	<release>1.0.6.2</release>
+	<release>1.0.7.0</release>
 	<date>2024-07-08</date>
 	<lazy-load>1</lazy-load>
 	<class>PlagiarismPlugin</class>

From c642ad11ac555375990097bc45a7a7f1a1efc2d5 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 9 Aug 2024 12:22:13 +0600
Subject: [PATCH 65/75] pkp/plagiarism#52 fixed issue with settings update

---
 PlagiarismSettingsForm.inc.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/PlagiarismSettingsForm.inc.php b/PlagiarismSettingsForm.inc.php
index d4ff924..f58b2c9 100644
--- a/PlagiarismSettingsForm.inc.php
+++ b/PlagiarismSettingsForm.inc.php
@@ -133,7 +133,7 @@ public function execute(...$functionArgs) {
 		// if proper api url and api key provided and if there is no forced credentails defined in 
 		// `config.inc.php` at global or for this context
 		if (!empty(array_filter([$ithenticateApiUrl, $ithenticateApiKey])) &&
-			!$this->_plugin->hasForcedCredentials($this->_context->getId())) {
+			!$this->_plugin->hasForcedCredentials($this->_context)) {
 
 			// access updated or new access entered, need to update webhook registration
 			if ($this->_plugin->getSetting($this->_context->getId(), 'ithenticateApiUrl') !== $ithenticateApiUrl ||

From 0207f2e81ec9b8bbec64d02dc49fe6f2f08a0fb2 Mon Sep 17 00:00:00 2001
From: Alec Smecher <alec@smecher.bc.ca>
Date: Thu, 15 Aug 2024 12:00:42 -0700
Subject: [PATCH 66/75] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 9ef6962..76e58bf 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ For OJS/OMP/OPS 3.x
 
 ## Overview
 
-This plugin permits automatic or manula submission of uploaded manuscripts to the [iThenticate service](http://www.ithenticate.com/) for plagiarism checking. 
+This plugin permits automatic or manual submission of uploaded manuscripts to the [iThenticate service](http://www.ithenticate.com/) for plagiarism checking. 
 
 1. You need an account on ithenticate.com (costs involved)
    * paid via Crossref Similarity Check
@@ -35,7 +35,7 @@ There are several iThenticate similarity check settings that can be configured v
    * `excludeAbstract` -- Text in the abstract section of the submission will not count as similar content
    * `excludeMethods` -- Text in the method section of the submission will not count as similar content
    * `excludeCitations` -- The citations of the submission will be excluded from similarity check
-   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content. Mimimum value is 8.
+   * `excludeSmallMatches` -- Similarity matches that match less than the specified amount of words will not count as similar content. Minimum value is 8.
    * `allowViewerUpdate` -- Changes made in reports will be saved for the next time the report is viewed
    * ![Available Similarity Check Options](images/similarity-check-settings.png)
 2. Each of this settings can also be configured at global or Journal/Press/Server level from the `config.inc.php` file.

From 0b3fcd636aa5ddc6af65b894bd218871cd63658c Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 23 Aug 2024 19:40:57 +0600
Subject: [PATCH 67/75] pkp/plagiarism#52 added revision files history feature

---
 PlagiarismPlugin.inc.php | 67 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 136f89e..55e6f5f 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -102,6 +102,7 @@ public function register($category, $path, $mainContextId = null) {
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION, [$this, 'addPlagiarismCheckDataToSubmissionSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_SUBMISSION_FILE, [$this, 'addPlagiarismCheckDataToSubmissionFileSchema']);
 		HookRegistry::register('Schema::get::' . SCHEMA_CONTEXT, [$this, 'addIthenticateConfigSettingsToContextSchema']);
+		HookRegistry::register('SubmissionFile::edit', [$this, 'updateIthenticateRevisionHistory']);
 		
 		HookRegistry::register('userdao::getAdditionalFieldNames', [$this, 'handleAdditionalEulaConfirmationFieldNames']);
 
@@ -223,6 +224,13 @@ public function addPlagiarismCheckDataToSubmissionSchema($hookName, $params) {
 	public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params) {
 		$schema =& $params[0];
 
+		$schema->properties->ithenticateFileId = (object) [
+			'type' => 'integer',
+			'description' => 'The file id from the files table',
+			'writeOnly' => true,
+			'validation' => ['nullable'],
+		];
+
 		$schema->properties->ithenticateId = (object) [
 			'type' => 'string',
 			'description' => 'The iThenticate submission id for submission file',
@@ -254,6 +262,13 @@ public function addPlagiarismCheckDataToSubmissionFileSchema($hookName, $params)
 			],
 		];
 
+		$schema->properties->ithenticateRevisionHistory = (object) [
+			'type' => 'string',
+			'description' => 'The similarity check action history on the previous revisions of this submission file',
+			'writeOnly' => true,
+			'validation' => ['nullable'],
+		];
+
 		return false;
 	}
 
@@ -286,6 +301,57 @@ public function addIthenticateConfigSettingsToContextSchema($hookName, $params)
 		return false;
 	}
 
+	/**
+	 * Add plagiarism action history for revision files.
+	 * Only contains action history for files that has been sent for plagiarism check.
+	 * 
+	 * @param string $hookName `SubmissionFile::edit`
+	 * @param array $params
+	 * 
+	 * @return bool
+	 */
+	public function updateIthenticateRevisionHistory($hookName, $params) {
+		$submissionFile = & $params[0]; /** @var SubmissionFile $submissionFile */
+		$submissionFileDao = DAORegistry::getDAO('SubmissionFileDAO'); /** @var SubmissionFileDAO $submissionFileDao */
+		$currentSubmissionFile = $submissionFileDao->getById($submissionFile->getId()); /** @var SubmissionFile $currentSubmissionFile */
+
+		// Do not track for plagiarism revision history until marked for tracking
+		if (is_null($currentSubmissionFile->getData('ithenticateFileId'))) {
+			return false;
+		}
+
+		// If file has not changed, no change in plagiarism revision history
+		if ($currentSubmissionFile->getId() === $submissionFile->getData('fileId')) {
+			return false;
+		}
+
+		// new file revision added, so add/update itnenticate revision hisotry
+		$revisionHistory = json_decode($currentSubmissionFile->getData('ithenticateRevisionHistory') ?? '{}', true);
+		$submissionFile->setData('ithenticateFileId', $submissionFile->getData('fileId'));
+
+		// If the previous file not sent schedule for plagiarism check
+		// no need to store it's plagiarism revision history
+		if (is_null($currentSubmissionFile->getData('ithenticateId'))) {
+			return false;
+		}
+
+		array_push($revisionHistory, [
+			'ithenticateFileId' => $currentSubmissionFile->getData('ithenticateFileId'),
+			'ithenticateId' => $currentSubmissionFile->getData('ithenticateId'),
+			'ithenticateSimilarityResult' => $currentSubmissionFile->getData('ithenticateSimilarityResult'),
+			'ithenticateSimilarityScheduled' => $currentSubmissionFile->getData('ithenticateSimilarityScheduled'),
+			'ithenticateSubmissionAcceptedAt' => $currentSubmissionFile->getData('ithenticateSubmissionAcceptedAt'),
+		]);
+		
+		$submissionFile->setData('ithenticateRevisionHistory', json_encode($revisionHistory));
+		$submissionFile->setData('ithenticateId', null);
+		$submissionFile->setData('ithenticateSimilarityResult', null);
+		$submissionFile->setData('ithenticateSimilarityScheduled', 0);
+		$submissionFile->setData('ithenticateSubmissionAcceptedAt', null);
+
+		return false;
+	}
+
 	/**
 	 * Add additional fields for users to stamp EULA details
 	 * 
@@ -663,6 +729,7 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 		}
 
 		$submissionFile->setData('ithenticateId', $submissionUuid);
+		$submissionFile->setData('ithenticateFileId', $submissionFile->getData('fileId'));
 		$submissionFile->setData('ithenticateSimilarityScheduled', 0);
 		$submissionFileDao->updateObject($submissionFile);
 

From 8d210b934492a09a6c2660067ca614944d64bdfb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 3 Sep 2024 15:06:35 +0600
Subject: [PATCH 68/75] pkp/plagiarism#52 removed weird EULA determining from
 first submission and retrieved from API

---
 PlagiarismPlugin.inc.php | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 55e6f5f..0c58e9e 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -641,13 +641,18 @@ public function stampEulaToSubmittingUser($context, $submission, $user = null) {
 		$request = Application::get()->getRequest();
 		$user ??= $request->getUser();
 
-		if (is_null($submission->getData('ithenticateEulaVersion'))) {
-			$submissionDao = DAORegistry::getDAO("SubmissionDAO"); /** @var SubmissionDAO $submissionDao */
-			$submission = $submissionDao->getById(1); /** @var Submission $submission */
-		}
-
 		$submissionEulaVersion = $submission->getData('ithenticateEulaVersion');
 
+		if (is_null($submissionEulaVersion)) {
+			$eulaDetails = $this->getContextEulaDetails($context, [
+				$submission->getData('locale'),
+				$request->getSite()->getPrimaryLocale(),
+				IThenticate::DEFAULT_EULA_LANGUAGE
+			]);
+
+			$submissionEulaVersion = $eulaDetails['version'];
+		}
+
 		// If submission EULA version has already been stamped to user
 		// no need to do the confirmation and stamping again
 		if ($user->getData('ithenticateEulaVersion') === $submissionEulaVersion) {

From 62d3ccd6f0efc06ac7757788be9d3421724d3f9f Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 10 Sep 2024 08:29:28 +0600
Subject: [PATCH 69/75] pkp/plagiarism#52 fixed bug preserving plagiarism
 history

---
 PlagiarismPlugin.inc.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index 0c58e9e..f9c5229 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -321,7 +321,7 @@ public function updateIthenticateRevisionHistory($hookName, $params) {
 		}
 
 		// If file has not changed, no change in plagiarism revision history
-		if ($currentSubmissionFile->getId() === $submissionFile->getData('fileId')) {
+		if ($currentSubmissionFile->getData('fileId') === $submissionFile->getData('fileId')) {
 			return false;
 		}
 
@@ -1096,8 +1096,10 @@ public function hasAutoSubmissionDisabled() {
 		$context = Application::get()->getRequest()->getContext(); /** @var Context $context */
 		$contextPath = $context ? $context->getPath() : 'index';
 
-		return $this->getForcedConfigSetting($contextPath, 'disableAutoSubmission')
-			?? $this->getSetting($context->getId(), 'disableAutoSubmission');
+		return (bool)(
+			$this->getForcedConfigSetting($contextPath, 'disableAutoSubmission')
+				?? $this->getSetting($context->getId(), 'disableAutoSubmission')
+		);
 	}
 
 	/**

From e17e29965fb2314b02879a6c7853ebe5f6a5d1f3 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 12 Sep 2024 11:05:56 +0600
Subject: [PATCH 70/75] pkp/plagiarism#52 PHP 7.4 compatibility

---
 IThenticate.inc.php     | 27 ++++++++++++++++++---------
 TestIThenticate.inc.php | 11 ++++++++---
 2 files changed, 26 insertions(+), 12 deletions(-)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index d6d7f95..4c05a86 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -182,21 +182,28 @@ public function getEnabledFeature($feature = null) {
         static $result;
 
         if (!isset($result) && !$this->validateAccess($result)) {
-            return $this->suppressApiRequestException
-                ? []
-                : throw new \Exception('unable to validate access details');
+            if ($this->suppressApiRequestException) {
+                return [];
+            }
+
+            throw new \Exception('unable to validate access details');
         }
 
         if (!$feature) {
             return json_decode($result, true);
         }
 
+        $self = $this;
         return data_get(
             json_decode($result, true),
             $feature,
-            fn () => $this->suppressApiRequestException
-                ? null
-                : throw new \Exception("Feature details {$feature} does not exist")
+            function () use ($self, $feature) {
+                if ($self->suppressApiRequestException) {
+                    return null;
+                }
+
+                throw new \Exception("Feature details {$feature} does not exist");
+            }
         );
     }
 
@@ -684,9 +691,11 @@ public function makeApiRequest($method, $url, $options = []) {
                 )
             );
 
-            $this->suppressApiRequestException
-                ? error_log($exception->__toString())
-                : throw $exception;
+            if ($this->suppressApiRequestException) {
+                error_log($exception->__toString());
+            } else {
+                throw $exception;
+            }
         }
 
         return $response;
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index 08db832..a116332 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -170,12 +170,17 @@ public function getEnabledFeature($feature = null) {
             return json_decode($result, true);
         }
 
+        $self = $this;
         $featureStatus = data_get(
             json_decode($result, true),
             $feature,
-            fn () => $this->suppressApiRequestException
-                ? null
-                : throw new \Exception("Feature details {$feature} does not exist")
+            function () use ($self, $feature) {
+                if ($self->suppressApiRequestException) {
+                    return null;
+                }
+
+                throw new \Exception("Feature details {$feature} does not exist");
+            }
         );
 
         error_log("iThenticate specific enable feature details {$featureStatus}");

From 27b723d29695c1f9d60f6bb213a9d8e75d2c028f Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Wed, 18 Sep 2024 13:40:37 +0600
Subject: [PATCH 71/75] pkp/plagiarism#52 added error log if ithenticate
 creating submission failed

---
 IThenticate.inc.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/IThenticate.inc.php b/IThenticate.inc.php
index 4c05a86..85062d1 100644
--- a/IThenticate.inc.php
+++ b/IThenticate.inc.php
@@ -333,6 +333,8 @@ public function createSubmission($site, $submission, $user, $author, $authorPerm
         if ($response && $response->getStatusCode() === 201) {
             $result = json_decode($response->getBody()->getContents());
             return $result->id;
+        } else {
+            error_log((string)$response->getBody()->getContents());
         }
 
         return null;

From c5c817e719a6802fd3e4d624a7ac2091b282baf8 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Thu, 19 Sep 2024 10:47:03 +0600
Subject: [PATCH 72/75] pkp/plagiarism#52 moved default eula lang details under
 the checking of eula required and validation passes

---
 PlagiarismPlugin.inc.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index f9c5229..b58bd76 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -875,7 +875,7 @@ public function retrieveEulaDetails($cache, $cacheId) {
 		//     'url' => '',
 		//   ],
 		//   ...
-		if ($eulaDetails['require_eula'] === true &&
+		if ($eulaDetails['require_eula'] == true &&
 			$ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION)) {
 
 			foreach($context->getSupportedSubmissionLocaleNames() as $localeKey => $localeName) {
@@ -884,14 +884,14 @@ public function retrieveEulaDetails($cache, $cacheId) {
 					'url' 		=> $ithenticate->getApplicableEulaUrl($localeKey),
 				];
 			}
-		}
 
-		// Also store the default iThenticate language version details
-		if (!isset($eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE])) {
-			$eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE] = [
-				'version' 	=> $ithenticate->getApplicableEulaVersion(),
-				'url' 		=> $ithenticate->getApplicableEulaUrl($ithenticate::DEFAULT_EULA_LANGUAGE),
-			];
+			// Also store the default iThenticate language version details
+			if (!isset($eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE])) {
+				$eulaDetails[$ithenticate::DEFAULT_EULA_LANGUAGE] = [
+					'version' 	=> $ithenticate->getApplicableEulaVersion(),
+					'url' 		=> $ithenticate->getApplicableEulaUrl($ithenticate::DEFAULT_EULA_LANGUAGE),
+				];
+			}
 		}
 
 		$cache->setEntireCache([$cacheId => $eulaDetails]);

From c5dae25d71e6c776c9dab90096a42a7f0aca524c Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 20 Sep 2024 12:00:27 +0600
Subject: [PATCH 73/75] pkp/plagiarism#52 Better handling of EULA non required
 case

---
 PlagiarismPlugin.inc.php                      |  5 ++++-
 TestIThenticate.inc.php                       | 20 +++++++++++++++----
 ...PlagiarismIthenticateActionHandler.inc.php | 13 ++++++++++--
 3 files changed, 31 insertions(+), 7 deletions(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index b58bd76..fb8f627 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -530,7 +530,10 @@ public function submitForPlagiarismCheck($hookName, $args) {
 			$this->registerIthenticateWebhook($ithenticate, $context);
 		}
 
-		$ithenticate->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'));
+		// Only set applicable EULA if EULA required
+		if ($this->getContextEulaDetails($context, 'require_eula') == true) {
+			$ithenticate->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'));
+		}
 
 		// Check EULA stamped to submission or submitter only if it is required
 		if ($this->getContextEulaDetails($context, 'require_eula') !== false) {
diff --git a/TestIThenticate.inc.php b/TestIThenticate.inc.php
index a116332..889084d 100644
--- a/TestIThenticate.inc.php
+++ b/TestIThenticate.inc.php
@@ -17,7 +17,7 @@ class TestIThenticate {
     /**
      * @copydoc IThenticate::$eulaVersion
      */
-    protected $eulaVersion = 'v1beta';
+    protected $eulaVersion = null;
 
     /**
      * @copydoc IThenticate::$eulaVersionDetails
@@ -105,7 +105,17 @@ class TestIThenticate {
      * @copydoc IThenticate::__construct()
      */
     public function __construct($apiUrl, $apiKey, $integrationName, $integrationVersion, $eulaVersion = null) {
-        error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$eulaVersion}");
+        
+        // These following 2 conditions are to facilitate the mock the EULA requirement
+        if ($eulaVersion) {
+            $this->eulaVersion = $eulaVersion;
+        }
+
+        if (!$eulaVersion) {
+            $this->eulaVersion = Config::getVar('ithenticate', 'test_mode_eula', true) ? 'v1beta' : null;
+        }
+
+        error_log("Constructing iThenticate with API URL : {$apiUrl}, API Key : {$apiKey}, Integration Name : {$integrationName}, Integration Version : {$integrationVersion} and EUlA Version : {$this->eulaVersion}");
     }
 
     /**
@@ -122,7 +132,9 @@ public function withoutSuppressingApiRequestException() {
      */
     public function getEnabledFeature($feature = null) {
         
-        static $result = '{
+        static $result;
+
+        $result = '{
             "similarity": {
                 "viewer_modes": {
                     "match_overview": true,
@@ -154,7 +166,7 @@ public function getEnabledFeature($feature = null) {
                 }
             },
             "tenant": {
-                "require_eula": true
+                "require_eula": '.($this->eulaVersion ? "true" : "false").'
             },
             "product_name": "Turnitin Originality",
             "access_options": [
diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index ab60bad..05bbf7e 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -13,6 +13,8 @@
  * @brief Handle the different iThenticate service related actions
  */
 
+use Illuminate\Support\Arr;
+
 import("plugins.generic.plagiarism.controllers.PlagiarismComponentHandler");
 import('lib.pkp.classes.core.JSONMessage'); 
 import('lib.pkp.classes.db.DAORegistry');
@@ -77,11 +79,18 @@ public function launchViewer($args, $request) {
 			...static::$_plugin->getServiceAccess($context)
 		);
 
+		// If EULA is required and submission has EULA stamped, we set the applicable EULA
+		// Otherwise get the current EULA from default one and set the applicable
+		// Basically we need to retrieve the available langs details from EULA details
+		static::$_plugin->getContextEulaDetails($context, 'require_eula') == true &&
+		$submission->getData('ithenticateEulaVersion')
+			? $ithenticate->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'))
+			: $ithenticate->validateEulaVersion($ithenticate::DEFAULT_EULA_VERSION);
+
 		$locale = $ithenticate
-			->setApplicableEulaVersion($submission->getData('ithenticateEulaVersion'))
 			->getApplicableLocale(
 				collect([$submission->getData("locale")])
-					->merge($user->getData("locales"))
+					->merge(Arr::wrap($user->getData("locales")))
 					->merge([$context->getPrimaryLocale(), $site->getPrimaryLocale()])
 					->unique()
 					->toArray()

From d859cfe8ce205b31a731a69e354e498f8d8a3872 Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Fri, 20 Sep 2024 15:51:40 +0600
Subject: [PATCH 74/75] pkp/plagiarism#52 Better handling submission file name
 for multi lang

---
 PlagiarismPlugin.inc.php | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/PlagiarismPlugin.inc.php b/PlagiarismPlugin.inc.php
index fb8f627..791035b 100644
--- a/PlagiarismPlugin.inc.php
+++ b/PlagiarismPlugin.inc.php
@@ -718,10 +718,19 @@ public function createNewSubmission($request, $user, $submission, $submissionFil
 		if (in_array($file->mimetype, $this->uploadRestrictedArchiveMimeTypes)) {
 			return true;
 		}
+		
+		$submissionFileName = $submissionFile->getData("name", $publication->getData("locale"))
+			?? collect([$context->getPrimaryLocale()])
+				->merge($context->getData("supportedSubmissionLocales") ?? [])
+				->merge([$request->getSite()->getPrimaryLocale()])
+				->unique()
+				->map(fn ($locale) => $submissionFile->getData("name", $locale))
+				->filter()
+				->first();
 
 		$uploadStatus = $ithenticate->uploadFile(
 			$submissionUuid, 
-			$submissionFile->getData("name", $publication->getData("locale")),
+			$submissionFileName,
 			$pkpFileService->fs->read($file->path),
 		);
 

From a675e7b39a4f12a9d995b784f342601d4c04bbeb Mon Sep 17 00:00:00 2001
From: Touhidur Rahman <abir.ruet@gmail.com>
Date: Tue, 24 Sep 2024 17:02:56 +0600
Subject: [PATCH 75/75] pkp/plagiarism#52 score value escape

---
 controllers/PlagiarismIthenticateActionHandler.inc.php | 1 +
 templates/similarityScore.tpl                          | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/controllers/PlagiarismIthenticateActionHandler.inc.php b/controllers/PlagiarismIthenticateActionHandler.inc.php
index 05bbf7e..82d61ff 100644
--- a/controllers/PlagiarismIthenticateActionHandler.inc.php
+++ b/controllers/PlagiarismIthenticateActionHandler.inc.php
@@ -93,6 +93,7 @@ public function launchViewer($args, $request) {
 					->merge(Arr::wrap($user->getData("locales")))
 					->merge([$context->getPrimaryLocale(), $site->getPrimaryLocale()])
 					->unique()
+					->filter()
 					->toArray()
 			);
 
diff --git a/templates/similarityScore.tpl b/templates/similarityScore.tpl
index 31ed882..f675e63 100644
--- a/templates/similarityScore.tpl
+++ b/templates/similarityScore.tpl
@@ -9,7 +9,7 @@
             alt="{translate key="plugins.generic.plagiarism.similarity.match.title"}"
         />
     </a>
-    <span>{$score}%</span>
+    <span>{$score|escape}%</span>
 </span>
 
 <style>