Expand all

mw.ForeignStructuredUpload

Upload to another MediaWiki site using structured metadata.

This subclass uses a structured metadata system similar to (or identical to) the one on Wikimedia Commons. See https://commons.wikimedia.org/wiki/Commons:Structured_data for a more detailed description of how that system works.

TODO: This currently only supports uploads under CC-BY-SA 4.0, and should really have support for more licenses.

Classes

BookletLayout

Encapsulates the process of uploading a file to MediaWiki using the mw.ForeignStructuredUpload model.

Extends

Constructor

new mw.ForeignStructuredUpload([target], [apiconfig]) #

Used to represent an upload in progress on the frontend.

Parameters:

Name Type Attributes Description
target string optional
apiconfig Object optional
Source:

Methods

finishStashUpload() → {jQuery.Promise} #

Finish a stash upload.

Inherited from:
Source:

Returns:

Type
jQuery.Promise
Finish a stash upload.

getApi() → {jQuery.Promise.<mw.Api>} #

Get the mw.Api instance used by this Upload object.

Inherited from:
Source:

Returns:

Type
jQuery.Promise.<mw.Api>
Get the mw.Api instance used by this Upload object.

getBasename(path) → {string} #

Gets the base filename from a path name.

Parameters:

Name Type Description
path string
Inherited from:
Source:

Returns:

Type
string
Gets the base filename from a path name.

getComment() → {string} #

Get the current value of the edit comment for the upload.

Inherited from:
Source:

Returns:

Type
string
Get the current value of the edit comment for the upload.

getFile() → {HTMLInputElement|File|Blob} #

Get the file being uploaded.

Inherited from:
Source:

Returns:

Type
HTMLInputElement | File | Blob
Get the file being uploaded.

getFilename() → {string} #

Get the filename, to be finalized on upload.

Inherited from:
Source:

Returns:

Type
string
Get the filename, to be finalized on upload.

getImageInfo() → {Object|undefined} #

Get the imageinfo object for the finished upload. Only available once the upload is finished! Don't try to get it beforehand.

Inherited from:
Source:

Returns:

Type
Object | undefined
Get the imageinfo object for the finished upload.

getState() → {mw.Upload.State} #

Gets the state of the upload.

Inherited from:
Source:

Returns:

Type
mw.Upload.State
Gets the state of the upload.

getStateDetails() → {string} #

Gets details of the current state.

Inherited from:
Source:

Returns:

Type
string
Gets details of the current state.

getText() → {string} #

Get the text of the file page, to be created on file upload.

Inherited from:
Source:

Returns:

Type
string
Get the text of the file page, to be created on file upload.

getWatchlist() → {boolean} #

Get the boolean for whether the file will be watchlisted after upload.

Inherited from:
Source:

Returns:

Type
boolean
Get the boolean for whether the file will be watchlisted after upload.

setComment(comment) #

Set the edit comment for the upload.

Parameters:

Name Type Description
comment string
Inherited from:
Source:
Set the edit comment for the upload.

setFile(file) #

Set the file to be uploaded.

Parameters:

Name Type Description
file HTMLInputElement | File | Blob
Inherited from:
Source:
Set the file to be uploaded.

setFilekey(filekey) #

Set the stashed file to finish uploading.

Parameters:

Name Type Description
filekey string
Inherited from:
Source:
Set the stashed file to finish uploading.

setFilename(filename) #

Set the filename, to be finalized on upload.

Parameters:

Name Type Description
filename string
Inherited from:
Source:
Set the filename, to be finalized on upload.

setFilenameFromFile() #

Sets the filename based on the filename as it was on the upload.

Inherited from:
Source:
Sets the filename based on the filename as it was on the upload.

setState(state, stateDetails) #

Sets the state and state details (if any) of the upload.

Parameters:

Name Type Description
state mw.Upload.State
stateDetails Object
Inherited from:
Source:
Sets the state and state details (if any) of the upload.

setText(text) #

Set the text of the file page, to be created on file upload.

Parameters:

Name Type Description
text string
Inherited from:
Source:
Set the text of the file page, to be created on file upload.

setWatchlist(watchlist) #

Set whether the file should be watchlisted after upload.

Parameters:

Name Type Description
watchlist boolean
Inherited from:
Source:
Set whether the file should be watchlisted after upload.

upload() → {jQuery.Promise} #

Upload the file directly.

Inherited from:
Source:

Returns:

Type
jQuery.Promise
Upload the file directly.

uploadToStash() → {jQuery.Promise} #

Upload the file to the stash to be completed later.

Inherited from:
Source:

Returns:

Type
jQuery.Promise
Upload the file to the stash to be completed later.