| Server IP : 195.134.90.114 / Your IP : 216.73.216.86 Web Server : Apache/2.4.58 System : Linux nepub 6.8.0-88-generic #89-Ubuntu SMP PREEMPT_DYNAMIC Sat Oct 11 01:02:46 UTC 2025 x86_64 User : www-data ( 33) PHP Version : 8.2.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/public_html/lib/pkp/js/controllers/wizard/fileUpload/ |
Upload File : |
/**
* @defgroup controllers_wizard_fileUpload
*/
/**
* @file js/controllers/wizard/fileUpload/FileUploadWizardHandler.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 FileUploadWizardHandler
* @ingroup controllers_wizard_fileUpload
*
* @brief File uploader wizard handler.
*/
(function($) {
/** @type {Object} */
$.pkp.controllers.wizard.fileUpload =
$.pkp.controllers.wizard.fileUpload || { };
/**
* @constructor
*
* @extends $.pkp.controllers.wizard.WizardHandler
*
* @param {jQueryObject} $wizard The wrapped HTML form element.
* @param {Object} options Wizard options.
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler =
function($wizard, options) {
this.parent($wizard, options);
// Save action urls.
this.csrfToken_ = options.csrfToken;
this.deleteUrl_ = options.deleteUrl;
this.metadataUrl_ = options.metadataUrl;
this.finishUrl_ = options.finishUrl;
this.cancelUrl_ = options.cancelUrl;
// Bind events of the nested upload forms.
this.bind('fileUploaded', this.handleFileUploaded);
this.bind('filesRemoved', this.handleRemovedFiles);
// Initially disable the continue button.
this.disableContinueButton();
};
$.pkp.classes.Helper.inherits(
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler,
$.pkp.controllers.wizard.WizardHandler);
//
// Private properties
//
/**
* The CSRF token to use with a cancel event.
* @private
* @type {string}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.csrfToken_ = '';
/**
* The URL to be called when a delete event occurs.
* @private
* @type {string}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.deleteUrl_ = '';
/**
* The URL from which to load the meta-data form.
* @private
* @type {string}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.metadataUrl_ = '';
/**
* The URL from which to load the finish form.
* @private
* @type {string}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.finishUrl_ = '';
/**
* The URL to be called when a cancel event occurs.
* @private
* @type {string}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.cancelUrl_ = '';
/**
* Information about the uploaded file (once there is one).
* @private
* @type {{fileId: number}?}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.uploadedFile_ = null;
/**
* Information about the file being revised.
* @private
* @type {{fileId: number, name: string, uploaderUserId: number}}
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.originalFile_ = null;
//
// Public methods
//
/**
* @inheritDoc
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.tabsBeforeActivate = function(tabsElement, event, ui) {
// The last two tabs require a file to be uploaded.
if (ui.newTab.index() > 0) {
if (!this.uploadedFile_) {
throw new Error('Uploaded file missing!');
}
// Set the correct URLs.
var $wizard = this.getHtmlElement(), newUrl = '';
switch (ui.newTab.index()) {
case 1:
newUrl = this.metadataUrl_;
break;
case 2:
newUrl = this.finishUrl_;
break;
default:
throw new Error('Unsupported tab index.');
}
newUrl = newUrl + '&submissionFileId=' + this.uploadedFile_.id;
ui.newTab.find('.ui-tabs-anchor').attr('href', newUrl);
}
return /** @type {boolean} */ (
this.parent('tabsBeforeActivate', tabsElement, event, ui));
};
/**
* Overridden version of WizardHandler's wizardAdvance handler.
* This version allows a user to return to all tabs but the very
* first one (the actual file upload).
*
* @param {HTMLElement} wizardElement The wizard's HTMLElement on
* which the event was triggered.
* @param {Event} event The triggered event.
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.wizardAdvance = function(wizardElement, event) {
// The wizard can only be advanced one step at a time.
// The step cannot be greater than the number of wizard
// tabs and not less than 1.
var currentStep = this.getCurrentStep(),
lastStep = this.getNumberOfSteps() - 1,
targetStep = currentStep + 1,
$wizard = this.getHtmlElement(),
$continueButton;
// Do not advance beyond the last step.
if (targetStep > lastStep) {
throw new Error('Trying to set an invalid wizard step!');
}
// Enable the target step.
$wizard.tabs('enable', targetStep);
// Advance to the target step.
$wizard.tabs('option', 'active', targetStep);
// Disable the previous step if it is the first one.
if (currentStep === 0) {
$wizard.tabs('disable', currentStep);
}
// If this is the last step then change the text on the
// continue button to finish.
if (targetStep === lastStep) {
$continueButton = this.getContinueButton();
$continueButton.text(
/** @type {string} */ (this.getFinishButtonText()));
this.enableContinueButton();
}
};
/**
* @inheritDoc
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.tabsLoad = function(tabsElement, event, ui) {
var $wizard = this.getHtmlElement(),
$newFileButton,
$progressIndicator = this.getProgressIndicator();
// In the last step: Bind click a event to the button that re-starts
// the upload process.
if (ui.tab.index() === 2) {
$newFileButton = $('#newFile', $wizard);
// In some cases only a single file can be uploaded and no new
// file button appears
if ($newFileButton.length) {
$newFileButton.bind('click', this.callbackWrapper(this.startWizard));
}
}
$progressIndicator.hide();
return /** @type {boolean} */ (
this.parent('tabsLoad', tabsElement, event, ui));
};
/**
* @inheritDoc
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.formValid = function(formElement, event) {
// Ignore form validation events for the upload form.
if (this.getCurrentStep() === 0 &&
this.getHtmlElement().find('#uploadConfirmationForm').length === 0 &&
!this.uploadedFile_) {
return;
}
this.parent('formValid', formElement, event);
};
/**
* @inheritDoc
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.wizardCancelRequested = function(wizardElement, event) {
if (this.parent('wizardCancelRequested', wizardElement, event)) {
// If the user presses cancel after uploading a file then delete the file.
if (this.uploadedFile_) {
this.uploadedFile_.csrfToken = this.csrfToken_;
// Authorization policy expects to find the submissionFileId para
this.uploadedFile_.submissionFileId = this.uploadedFile_.id;
this.uploadedFile_.originalFile = this.originalFile_;
$.post(this.cancelUrl_, this.uploadedFile_,
$.pkp.classes.Helper.curry(this.wizardCancelSuccess, this,
wizardElement, event), 'json');
// The uploaded file is being dealt with; reset.
this.uploadedFile_ = null;
// Do not cancel immediately.
event.preventDefault();
} else {
return true;
}
return false;
} else {
// Stop the cancel request.
return false;
}
};
/**
* Callback triggered when the deletion of a file after clicking
* the cancel button was successful.
*
* @param {HTMLElement} wizardElement The wizard's HTMLElement on
* which the event was triggered.
* @param {Event} event The original event.
* @param {Object} jsonData The JSON data returned by the server on
* file deletion.
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.wizardCancelSuccess = function(wizardElement, event, jsonData) {
var processedJsonData = this.handleJson(jsonData);
if (processedJsonData !== false) {
// Cancel the wizard.
this.trigger('wizardCancel');
}
};
/**
* Handle the "file uploaded" event triggered by the
* file upload/revision confirmation forms whenever the
* uploaded file changed.
*
* @param {$.pkp.controllers.form.AjaxFormHandler} callingForm The form
* that triggered the event.
* @param {Event} event The upload event.
* @param {{fileId: number}} uploadedFile Information about the uploaded
* file.
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.handleFileUploaded = function(callingForm, event, uploadedFile) {
// Keep the original file data to restore if the wizard is canceled
if (this.originalFile_ === null) {
this.originalFile_ = uploadedFile.originalFile;
}
delete uploadedFile.originalFile;
// Save the uploaded file information.
this.uploadedFile_ = uploadedFile;
};
/**
* Handle the filesRemoved event triggered by the associated form. The
* original event is triggered by plupload and passed via
* FileUploadFormHandler.
*
* See the TODO note under FileUPloadFormHandler::handleFilesRemoved
*
* @param {$.pkp.controllers.form.AjaxFormHandler} callingForm The form
* that triggered the event.
* @param {Event} event The upload event.
* @param {Object} pluploader plupload component that fired the original
* event.
* @param {Array} file Array of files removed
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.handleRemovedFiles =
function(callingForm, event, pluploader, file) {
var i;
if (typeof file === 'undefined' || !file.length) {
return;
}
// There's no error handling done for the response because we don't
// really have an elegant way to handle or display a failed deletion
for (i in file) {
if (typeof file[i].storedData === 'undefined') {
return;
}
file[i].storedData.csrfToken = this.csrfToken_;
$.post(this.deleteUrl_, file[i].storedData);
}
};
//
// Protected methods
//
/**
* @inheritDoc
*/
$.pkp.controllers.wizard.fileUpload.FileUploadWizardHandler.
prototype.startWizard = function() {
// Reset the uploaded and original file.
this.uploadedFile_ = this.originalFile_ = null;
this.parent('startWizard');
};
}(jQuery));