first commit

lib/pkp/js/controllers/grid/users/reviewer/form/AddReviewerFormHandler.js

@@ -0,0 +1,123 @@
+/**
+ * @file js/controllers/grid/users/reviewer/form/AddReviewerFormHandler.js
+ *
+ * Copyright (c) 2014-2021 Simon Fraser University
+ * Copyright (c) 2000-2021 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class AddReviewerFormHandler
+ * @ingroup js_controllers_grid_users_reviewer_form
+ *
+ * @brief Handle the Add Reviewer form (and template for message body).
+ */
+(function($) {
+
+
+	/**
+	 * @constructor
+	 *
+	 * @extends $.pkp.controllers.grid.users.reviewer.form.EditReviewFormHandler
+	 *
+	 * @param {jQueryObject} $form the wrapped HTML form element.
+	 * @param {Object} options form options.
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.
+			AddReviewerFormHandler = function($form, options) {
+
+		this.parent($form, options);
+
+		// Set the URL to retrieve templates from.
+		if (options.templateUrl) {
+			this.templateUrl_ = options.templateUrl;
+		}
+
+		// Attach form elements events.
+		$form.find('#template').change(
+				this.callbackWrapper(this.selectTemplateHandler_));
+	};
+	$.pkp.classes.Helper.inherits(
+			$.pkp.controllers.grid.users.reviewer.form.
+					AddReviewerFormHandler,
+			$.pkp.controllers.grid.users.reviewer.form.
+					EditReviewFormHandler);
+
+
+	//
+	// Private properties
+	//
+	/**
+	 * The URL to use to retrieve template bodies
+	 * @private
+	 * @type {string?}
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.
+			AddReviewerFormHandler.prototype.templateUrl_ = null;
+
+
+	//
+	// Protected methods
+	//
+	/**
+	 * Show the "no files" warning.
+	 * @protected
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.AddReviewerFormHandler.
+			prototype.showWarning = function() {
+		// Call the parent showWarning to show the warning
+		this.parent('showWarning');
+
+		// Ask the reviewer form footer handler to expand the file
+		// list extras-on-demand if it isn't already expanded.
+		this.getHtmlElement().find('#reviewerFormFooter')
+				.trigger('expandFileList');
+	};
+
+
+	//
+	// Private methods
+	//
+	/**
+	 * Respond to an "item selected" call by triggering a published event.
+	 *
+	 * @param {HTMLElement} sourceElement The element that
+	 *  issued the event.
+	 * @param {Event} event The triggering event.
+	 * @private
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.
+			AddReviewerFormHandler.prototype.selectTemplateHandler_ =
+					function(sourceElement, event) {
+
+		var $form = this.getHtmlElement();
+		$.post(this.templateUrl_, $form.find('#template').serialize(),
+				this.callbackWrapper(this.updateTemplate), 'json');
+	};
+
+
+	/**
+	 * Internal callback to replace the textarea with the contents of the
+	 * template body.
+	 *
+	 * @param {HTMLElement} formElement The wrapped HTML form.
+	 * @param {Object} jsonData The data returned from the server.
+	 * @return {boolean} The response status.
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.
+			AddReviewerFormHandler.prototype.updateTemplate =
+					function(formElement, jsonData) {
+
+		var $form = this.getHtmlElement(),
+				processedJsonData = this.handleJson(jsonData),
+				$textarea = $form.find('textarea[name="personalMessage"]'),
+				editor =
+				tinyMCE.EditorManager.get(/** @type {string} */ ($textarea.attr('id')));
+
+		if (processedJsonData !== false) {
+			if (processedJsonData.content !== '') {
+				editor.setContent(processedJsonData.content);
+			}
+		}
+		return processedJsonData.status;
+	};
+
+}(jQuery));

lib/pkp/js/controllers/grid/users/reviewer/form/EditReviewFormHandler.js

@@ -0,0 +1,109 @@
+/**
+ * @defgroup js_controllers_grid_users_reviewer_form
+ */
+/**
+ * @file js/controllers/grid/users/reviewer/form/EditReviewFormHandler.js
+ *
+ * Copyright (c) 2014-2021 Simon Fraser University
+ * Copyright (c) 2000-2021 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @class EditReviewFormHandler
+ * @ingroup js_controllers_grid_users_reviewer_form
+ *
+ * @brief Handle the limit reviewer files form. Also used as a base class
+ *  for the add reviewer form handler.
+ */
+(function($) {
+
+	/** @type {Object} */
+	$.pkp.controllers.grid.users.reviewer.form =
+			$.pkp.controllers.grid.users.reviewer.form || {};
+
+
+
+	/**
+	 * @constructor
+	 *
+	 * @extends $.pkp.controllers.form.UserFormHandler
+	 *
+	 * @param {jQueryObject} $form the wrapped HTML form element.
+	 * @param {Object} options form options.
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.
+			EditReviewFormHandler = function($form, options) {
+
+		this.parent($form, options);
+
+		// When the form changes, check to see if a warning is necessary
+		// (if all reviewer files are unchecked)
+		$form.change(this.callbackWrapper(this.handleFormChange));
+
+		// When the reviewer files list loads, trigger the above check
+		this.bind('urlInDivLoaded', this.handleFileListLoad_);
+	};
+	$.pkp.classes.Helper.inherits(
+			$.pkp.controllers.grid.users.reviewer.form.
+					EditReviewFormHandler,
+			$.pkp.controllers.form.UserFormHandler);
+
+
+	//
+	// Protected methods.
+	//
+	/**
+	 * Handle a form change event.
+	 * @protected
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.EditReviewFormHandler.
+			prototype.handleFormChange = function() {
+		if (this.getHtmlElement()
+				.find('input[name="selectedFiles[]"]:checked').length) {
+			this.hideWarning();
+		} else {
+			this.showWarning();
+		}
+	};
+
+
+	/**
+	 * Hide the "no files" warning.
+	 * @protected
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.EditReviewFormHandler.
+			prototype.hideWarning = function() {
+		this.getHtmlElement().find('#noFilesWarning').hide(250);
+	};
+
+
+	/**
+	 * Show the "no files" warning.
+	 * @protected
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.EditReviewFormHandler.
+			prototype.showWarning = function() {
+		this.getHtmlElement().find('#noFilesWarning').show(250);
+	};
+
+
+	//
+	// Private methods.
+	//
+	/**
+	 * Handle the loading of the reviewer files list.
+	 * @private
+	 * @param {HTMLElement} sourceElement The element that
+	 *  issued the event.
+	 * @param {Event} event The triggering event.
+	 * @param {?string} data additional event data.
+	 */
+	$.pkp.controllers.grid.users.reviewer.form.EditReviewFormHandler.
+			prototype.handleFileListLoad_ =
+			function(sourceElement, event, data) {
+
+		// Trigger a form change event to display the "no files
+		// selected" warning, if necessary.
+		this.getHtmlElement().change();
+	};
+
+}(jQuery));