Moved some of the functionality from mediawiki.legacy.prefs into mediawiki.specials...
[lhc/web/wiklou.git] / includes / specials / SpecialUpload.php
index 965c3bf..24081ff 100644 (file)
@@ -1,18 +1,38 @@
 <?php
 /**
+ * Implements Special:Upload
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
  * @file
  * @ingroup SpecialPage
  * @ingroup Upload
- *
+ */
+
+/**
  * Form for handling uploads and special page.
  *
+ * @ingroup SpecialPage
+ * @ingroup Upload
  */
-
 class SpecialUpload extends SpecialPage {
        /**
         * Constructor : initialise object
         * Get data POSTed through the form and assign them to the object
-        * @param WebRequest $request Data posted.
+        * @param $request WebRequest : data posted.
         */
        public function __construct( $request = null ) {
                global $wgRequest;
@@ -23,32 +43,38 @@ class SpecialUpload extends SpecialPage {
        }
 
        /** Misc variables **/
-       protected $mRequest;                    // The WebRequest or FauxRequest this form is supposed to handle
-       protected $mSourceType;
-       protected $mUpload;
-       protected $mLocalFile;
-       protected $mUploadClicked;
+       public $mRequest;                       // The WebRequest or FauxRequest this form is supposed to handle
+       public $mSourceType;
+       public $mUpload;
+       public $mLocalFile;
+       public $mUploadClicked;
 
        /** User input variables from the "description" section **/
-       protected $mDesiredDestName;    // The requested target file name
-       protected $mComment;
-       protected $mLicense;
+       public $mDesiredDestName;       // The requested target file name
+       public $mComment;
+       public $mLicense;
 
        /** User input variables from the root section **/
-       protected $mIgnoreWarning;
-       protected $mWatchThis;
-       protected $mCopyrightStatus;
-       protected $mCopyrightSource;
+       public $mIgnoreWarning;
+       public $mWatchThis;
+       public $mCopyrightStatus;
+       public $mCopyrightSource;
 
        /** Hidden variables **/
-       protected $mForReUpload;                // The user followed an "overwrite this file" link
-       protected $mCancelUpload;               // The user clicked "Cancel and return to upload form" button
-       protected $mTokenOk;
+       public $mDestWarningAck;
+       public $mForReUpload;           // The user followed an "overwrite this file" link
+       public $mCancelUpload;          // The user clicked "Cancel and return to upload form" button
+       public $mTokenOk;
+       public $mUploadSuccessful = false;      // Subclasses can use this to determine whether a file was uploaded
+
+       /** Text injection points for hooks not using HTMLForm **/
+       public $uploadFormTextTop;
+       public $uploadFormTextAfterSummary;
 
        /**
         * Initialize instance variables from request and create an Upload handler
         *
-        * @param WebRequest $request The request to extract variables from
+        * @param $request WebRequest: the request to extract variables from
         */
        protected function loadRequest( $request ) {
                global $wgUser;
@@ -56,21 +82,23 @@ class SpecialUpload extends SpecialPage {
                $this->mRequest = $request;
                $this->mSourceType        = $request->getVal( 'wpSourceType', 'file' );
                $this->mUpload            = UploadBase::createFromRequest( $request );
-               $this->mUploadClicked     = $request->wasPosted() 
-                       && ( $request->getCheck( 'wpUpload' ) 
+               $this->mUploadClicked     = $request->wasPosted()
+                       && ( $request->getCheck( 'wpUpload' )
                                || $request->getCheck( 'wpUploadIgnoreWarning' ) );
 
                // Guess the desired name from the filename if not provided
                $this->mDesiredDestName   = $request->getText( 'wpDestFile' );
-               if( !$this->mDesiredDestName )
-                       $this->mDesiredDestName = $request->getText( 'wpUploadFile' );
+               if( !$this->mDesiredDestName && $request->getFileName( 'wpUploadFile' ) !== null ) {
+                       $this->mDesiredDestName = $request->getFileName( 'wpUploadFile' );
+               }
                $this->mComment           = $request->getText( 'wpUploadDescription' );
                $this->mLicense           = $request->getText( 'wpLicense' );
 
 
+               $this->mDestWarningAck    = $request->getText( 'wpDestFileWarningAck' );
                $this->mIgnoreWarning     = $request->getCheck( 'wpIgnoreWarning' )
                        || $request->getCheck( 'wpUploadIgnoreWarning' );
-               $this->mWatchthis         = $request->getBool( 'wpWatchthis' );
+               $this->mWatchthis         = $request->getBool( 'wpWatchthis' ) && $wgUser->isLoggedIn();
                $this->mCopyrightStatus   = $request->getText( 'wpUploadCopyStatus' );
                $this->mCopyrightSource   = $request->getText( 'wpUploadSource' );
 
@@ -89,6 +117,9 @@ class SpecialUpload extends SpecialPage {
                } else {
                        $this->mTokenOk = $wgUser->matchEditToken( $token );
                }
+
+               $this->uploadFormTextTop = '';
+               $this->uploadFormTextAfterSummary = '';
        }
 
        /**
@@ -96,8 +127,8 @@ class SpecialUpload extends SpecialPage {
         * Handle permission checking elsewhere in order to be able to show
         * custom error messages.
         *
-        * @param User $user
-        * @return bool
+        * @param $user User object
+        * @return Boolean
         */
        public function userCanExecute( $user ) {
                return UploadBase::isEnabled() && parent::userCanExecute( $user );
@@ -107,7 +138,7 @@ class SpecialUpload extends SpecialPage {
         * Special page entry point
         */
        public function execute( $par ) {
-               global $wgUser, $wgOut, $wgRequest;
+               global $wgUser, $wgOut;
 
                $this->setHeaders();
                $this->outputHeader();
@@ -120,13 +151,14 @@ class SpecialUpload extends SpecialPage {
 
                # Check permissions
                global $wgGroupPermissions;
-               if( !$wgUser->isAllowed( 'upload' ) ) {
+               $permissionRequired = UploadBase::isAllowed( $wgUser );
+               if( $permissionRequired !== true ) {
                        if( !$wgUser->isLoggedIn() && ( $wgGroupPermissions['user']['upload']
                                || $wgGroupPermissions['autoconfirmed']['upload'] ) ) {
                                // Custom message if logged-in users without any special rights can upload
                                $wgOut->showErrorPage( 'uploadnologin', 'uploadnologintext' );
                        } else {
-                               $wgOut->permissionRequired( 'upload' );
+                               $wgOut->permissionRequired( $permissionRequired );
                        }
                        return;
                }
@@ -145,76 +177,120 @@ class SpecialUpload extends SpecialPage {
 
                # Unsave the temporary file in case this was a cancelled upload
                if ( $this->mCancelUpload ) {
-                       if ( !$this->unsaveUploadedFile() )
+                       if ( !$this->unsaveUploadedFile() ) {
                                # Something went wrong, so unsaveUploadedFile showed a warning
                                return;
+                       }
                }
 
                # Process upload or show a form
-               if ( $this->mTokenOk && !$this->mCancelUpload
-                               && ( $this->mUpload && $this->mUploadClicked ) ) {
+               if (
+                       $this->mTokenOk && !$this->mCancelUpload &&
+                       ( $this->mUpload && $this->mUploadClicked )
+               )
+               {
                        $this->processUpload();
                } else {
+                       # Backwards compatibility hook
+                       if( !wfRunHooks( 'UploadForm:initial', array( &$this ) ) ) {
+                               wfDebug( "Hook 'UploadForm:initial' broke output of the upload form" );
+                               return;
+                       }
+                       
+
                        $this->showUploadForm( $this->getUploadForm() );
                }
 
                # Cleanup
-               if ( $this->mUpload )
+               if ( $this->mUpload ) {
                        $this->mUpload->cleanupTempFile();
+               }
        }
 
        /**
-        * Show the main upload form and optionally add the session key to the
-        * output. This hides the source selection.
+        * Show the main upload form
         *
-        * @param string $message HTML message to be shown at top of form
-        * @param string $sessionKey Session key of the stashed upload
+        * @param $form Mixed: an HTMLForm instance or HTML string to show
         */
        protected function showUploadForm( $form ) {
                # Add links if file was previously deleted
-               if ( !$this->mDesiredDestName )
+               if ( !$this->mDesiredDestName ) {
                        $this->showViewDeletedLinks();
+               }
+
+               if ( $form instanceof HTMLForm ) {
+                       $form->show();
+               } else {
+                       global $wgOut;
+                       $wgOut->addHTML( $form );
+               }
 
-               $form->show();
        }
 
        /**
         * Get an UploadForm instance with title and text properly set.
         *
-        * @param string $message HTML string to add to the form
-        * @param string $sessionKey Session key in case this is a stashed upload
+        * @param $message String: HTML string to add to the form
+        * @param $sessionKey String: session key in case this is a stashed upload
+        * @param $hideIgnoreWarning Boolean: whether to hide "ignore warning" check box
         * @return UploadForm
         */
        protected function getUploadForm( $message = '', $sessionKey = '', $hideIgnoreWarning = false ) {
                global $wgOut;
-               
+
                # Initialize form
                $form = new UploadForm( array(
-                       'watch' => $this->watchCheck(), 
-                       'forreupload' => $this->mForReUpload, 
+                       'watch' => $this->getWatchCheck(),
+                       'forreupload' => $this->mForReUpload,
                        'sessionkey' => $sessionKey,
                        'hideignorewarning' => $hideIgnoreWarning,
+                       'destwarningack' => (bool)$this->mDestWarningAck,
+
+                       'texttop' => $this->uploadFormTextTop,
+                       'textaftersummary' => $this->uploadFormTextAfterSummary,
+                       'destfile' => $this->mDesiredDestName,
                ) );
                $form->setTitle( $this->getTitle() );
 
                # Check the token, but only if necessary
-               if( !$this->mTokenOk && !$this->mCancelUpload
-                               && ( $this->mUpload && $this->mUploadClicked ) )
+               if(
+                       !$this->mTokenOk && !$this->mCancelUpload &&
+                       ( $this->mUpload && $this->mUploadClicked )
+               )
+               {
                        $form->addPreText( wfMsgExt( 'session_fail_preview', 'parseinline' ) );
+               }
+
+               # Give a notice if the user is uploading a file that has been deleted or moved
+               # Note that this is independent from the message 'filewasdeleted' that requires JS
+               $desiredTitleObj = Title::newFromText( $this->mDesiredDestName, NS_FILE );
+               $delNotice = ''; // empty by default
+               if ( $desiredTitleObj instanceof Title && !$desiredTitleObj->exists() ) {
+                       LogEventsList::showLogExtract( $delNotice, array( 'delete', 'move' ), 
+                               $desiredTitleObj->getPrefixedText(),
+                               '', array( 'lim' => 10,
+                                          'conds' => array( "log_action != 'revision'" ),
+                                          'showIfEmpty' => false,
+                                          'msgKey' => array( 'upload-recreate-warning' ) )
+                       );
+               }
+               $form->addPreText( $delNotice );
 
                # Add text to form
-               $form->addPreText( '<div id="uploadtext">' . wfMsgExt( 'uploadtext', 'parse' ) . '</div>');
+               $form->addPreText( '<div id="uploadtext">' . 
+                       wfMsgExt( 'uploadtext', 'parse', array( $this->mDesiredDestName ) ) . 
+                       '</div>' );
                # Add upload error message
                $form->addPreText( $message );
-               
+
                # Add footer to form
                $uploadFooter = wfMsgNoTrans( 'uploadfooter' );
                if ( $uploadFooter != '-' && !wfEmptyMsg( 'uploadfooter', $uploadFooter ) ) {
                        $form->addPostText( '<div id="mw-upload-footer-message">'
                                . $wgOut->parse( $uploadFooter ) . "</div>\n" );
                }
-               
-               return $form;           
+
+               return $form;
 
        }
 
@@ -226,16 +302,19 @@ class SpecialUpload extends SpecialPage {
 
                $title = Title::makeTitleSafe( NS_FILE, $this->mDesiredDestName );
                // Show a subtitle link to deleted revisions (to sysops et al only)
-               if( $title instanceof Title && ( $count = $title->isDeleted() ) > 0 && $wgUser->isAllowed( 'deletedhistory' ) ) {
-                       $link = wfMsgExt(
-                               $wgUser->isAllowed( 'delete' ) ? 'thisisdeleted' : 'viewdeleted',
-                               array( 'parse', 'replaceafter' ),
-                               $wgUser->getSkin()->linkKnown(
-                                       SpecialPage::getTitleFor( 'Undelete', $title->getPrefixedText() ),
-                                       wfMsgExt( 'restorelink', array( 'parsemag', 'escape' ), $count )
-                               )
-                       );
-                       $wgOut->addHTML( "<div id=\"contentSub2\">{$link}</div>" );
+               if( $title instanceof Title ) {
+                       $count = $title->isDeleted();
+                       if ( $count > 0 && $wgUser->isAllowed( 'deletedhistory' ) ) {
+                               $link = wfMsgExt(
+                                       $wgUser->isAllowed( 'delete' ) ? 'thisisdeleted' : 'viewdeleted',
+                                       array( 'parse', 'replaceafter' ),
+                                       $wgUser->getSkin()->linkKnown(
+                                               SpecialPage::getTitleFor( 'Undelete', $title->getPrefixedText() ),
+                                               wfMsgExt( 'restorelink', array( 'parsemag', 'escape' ), $count )
+                                       )
+                               );
+                               $wgOut->addHTML( "<div id=\"contentSub2\">{$link}</div>" );
+                       }
                }
 
                // Show the relevant lines from deletion log (for still deleted files only)
@@ -253,49 +332,60 @@ class SpecialUpload extends SpecialPage {
         * essentially means that UploadBase::VERIFICATION_ERROR and
         * UploadBase::EMPTY_FILE should not be passed here.
         *
-        * @param string $message HTML message to be passed to mainUploadForm
+        * @param $message String: HTML message to be passed to mainUploadForm
         */
-       protected function recoverableUploadError( $message ) {
+       protected function showRecoverableUploadError( $message ) {
                $sessionKey = $this->mUpload->stashSession();
                $message = '<h2>' . wfMsgHtml( 'uploadwarning' ) . "</h2>\n" .
                        '<div class="error">' . $message . "</div>\n";
-               
+
                $form = $this->getUploadForm( $message, $sessionKey );
                $form->setSubmitText( wfMsg( 'upload-tryagain' ) );
                $this->showUploadForm( $form );
        }
        /**
-        * Stashes the upload, shows the main form, but adds an "continue anyway button"
+        * Stashes the upload, shows the main form, but adds an "continue anyway button".
+        * Also checks whether there are actually warnings to display.
         *
-        * @param array $warnings
+        * @param $warnings Array
+        * @return boolean true if warnings were displayed, false if there are no
+        *      warnings and the should continue processing like there was no warning
         */
-       protected function uploadWarning( $warnings ) {
-               global $wgUser;
+       protected function showUploadWarning( $warnings ) {
+               # If there are no warnings, or warnings we can ignore, return early.
+               # mDestWarningAck is set when some javascript has shown the warning
+               # to the user. mForReUpload is set when the user clicks the "upload a
+               # new version" link.
+               if ( !$warnings || ( count( $warnings ) == 1 && 
+                       isset( $warnings['exists'] ) && 
+                       ( $this->mDestWarningAck || $this->mForReUpload ) ) )
+               {
+                       return false;
+               }
 
                $sessionKey = $this->mUpload->stashSession();
 
-               $sk = $wgUser->getSkin();
-
                $warningHtml = '<h2>' . wfMsgHtml( 'uploadwarning' ) . "</h2>\n"
                        . '<ul class="warning">';
                foreach( $warnings as $warning => $args ) {
-                               $msg = '';
-                               if( $warning == 'exists' ) {
-                                       $msg = self::getExistsWarning( $args );
-                               } elseif( $warning == 'duplicate' ) {
-                                       $msg = self::getDupeWarning( $args );
-                               } elseif( $warning == 'duplicate-archive' ) {
-                                       $msg = "\t<li>" . wfMsgExt( 'file-deleted-duplicate', 'parseinline',
-                                                       array( Title::makeTitle( NS_FILE, $args )->getPrefixedText() ) )
-                                               . "</li>\n";
-                               } else {
-                                       if ( is_bool( $args ) )
-                                               $args = array();
-                                       elseif ( !is_array( $args ) )
-                                               $args = array( $args );
-                                       $msg = "\t<li>" . wfMsgExt( $warning, 'parseinline', $args ) . "</li>\n";
+                       $msg = '';
+                       if( $warning == 'exists' ) {
+                               $msg = "\t<li>" . self::getExistsWarning( $args ) . "</li>\n";
+                       } elseif( $warning == 'duplicate' ) {
+                               $msg = self::getDupeWarning( $args );
+                       } elseif( $warning == 'duplicate-archive' ) {
+                               $msg = "\t<li>" . wfMsgExt( 'file-deleted-duplicate', 'parseinline',
+                                               array( Title::makeTitle( NS_FILE, $args )->getPrefixedText() ) )
+                                       . "</li>\n";
+                       } else {
+                               if ( $args === true ) {
+                                       $args = array();
+                               } elseif ( !is_array( $args ) ) {
+                                       $args = array( $args );
                                }
-                               $warningHtml .= $msg;
+                               $msg = "\t<li>" . wfMsgExt( $warning, 'parseinline', $args ) . "</li>\n";
+                       }
+                       $warningHtml .= $msg;
                }
                $warningHtml .= "</ul>\n";
                $warningHtml .= wfMsgExt( 'uploadwarning-text', 'parse' );
@@ -306,14 +396,17 @@ class SpecialUpload extends SpecialPage {
                $form->addButton( 'wpCancelUpload', wfMsg( 'reuploaddesc' ) );
 
                $this->showUploadForm( $form );
+
+               # Indicate that we showed a form
+               return true;
        }
 
        /**
         * Show the upload form with error message, but do not stash the file.
         *
-        * @param string $message
+        * @param $message HTML string
         */
-       protected function uploadError( $message ) {
+       protected function showUploadError( $message ) {
                $message = '<h2>' . wfMsgHtml( 'uploadwarning' ) . "</h2>\n" .
                        '<div class="error">' . $message . "</div>\n";
                $this->showUploadForm( $this->getUploadForm( $message ) );
@@ -326,28 +419,47 @@ class SpecialUpload extends SpecialPage {
        protected function processUpload() {
                global $wgUser, $wgOut;
 
-               // Verify permissions
-               $permErrors = $this->mUpload->verifyPermissions( $wgUser );
-               if( $permErrors !== true )
-                       return $wgOut->showPermissionsErrorPage( $permErrors );
-
                // Fetch the file if required
                $status = $this->mUpload->fetchFile();
-               if( !$status->isOK() )
-                       return $this->showUploadForm( $this->getUploadForm( $wgOut->parse( $status->getWikiText() ) ) );
+               if( !$status->isOK() ) {
+                       $this->showUploadError( $wgOut->parse( $status->getWikiText() ) );
+                       return;
+               }
+
+               // Deprecated backwards compatibility hook
+               if( !wfRunHooks( 'UploadForm:BeforeProcessing', array( &$this ) ) ) {
+                       wfDebug( "Hook 'UploadForm:BeforeProcessing' broke processing the file.\n" );
+                       // Return without notifying the user of an error. This sucks, but 
+                       // this was the previous behaviour as well, and as this hook is
+                       // deprecated we're not going to do anything about it.
+                       return;
+               }
+
 
                // Upload verification
                $details = $this->mUpload->verifyUpload();
-               if ( $details['status'] != UploadBase::OK )
-                       return $this->processVerificationError( $details );
+               if ( $details['status'] != UploadBase::OK ) {
+                       $this->processVerificationError( $details );
+                       return;
+               }
+               
+               // Verify permissions for this title
+               $permErrors = $this->mUpload->verifyPermissions( $wgUser );
+               if( $permErrors !== true ) {
+                       $code = array_shift( $permErrors[0] );
+                       $this->showRecoverableUploadError( wfMsgExt( $code,
+                                       'parseinline', $permErrors[0] ) );
+                       return;
+               }
 
                $this->mLocalFile = $this->mUpload->getLocalFile();
 
                // Check warnings if necessary
                if( !$this->mIgnoreWarning ) {
                        $warnings = $this->mUpload->checkWarnings();
-                       if( count( $warnings ) )
-                               return $this->uploadWarning( $warnings );
+                       if( $this->showUploadWarning( $warnings ) ) {
+                               return;
+                       }
                }
 
                // Get the page text if this is not a reupload
@@ -358,13 +470,15 @@ class SpecialUpload extends SpecialPage {
                        $pageText = false;
                }
                $status = $this->mUpload->performUpload( $this->mComment, $pageText, $this->mWatchthis, $wgUser );
-               if ( !$status->isGood() )
-                       return $this->uploadError( $wgOut->parse( $status->getWikiText() ) );
+               if ( !$status->isGood() ) {
+                       $this->showUploadError( $wgOut->parse( $status->getWikiText() ) );
+                       return;
+               }
 
                // Success, redirect to description page
+               $this->mUploadSuccessful = true;
                wfRunHooks( 'SpecialUploadComplete', array( &$this ) );
                $wgOut->redirect( $this->mLocalFile->getTitle()->getFullURL() );
-
        }
 
        /**
@@ -377,15 +491,15 @@ class SpecialUpload extends SpecialPage {
                        if ( $license != '' ) {
                                $licensetxt = '== ' . wfMsgForContent( 'license-header' ) . " ==\n" . '{{' . $license . '}}' . "\n";
                        }
-                       $pageText = '== ' . wfMsgForContent ( 'filedesc' ) . " ==\n" . $comment . "\n" .
-                         '== ' . wfMsgForContent ( 'filestatus' ) . " ==\n" . $copyStatus . "\n" .
-                         "$licensetxt" .
-                         '== ' . wfMsgForContent ( 'filesource' ) . " ==\n" . $source ;
+                       $pageText = '== ' . wfMsgForContent( 'filedesc' ) . " ==\n" . $comment . "\n" .
+                               '== ' . wfMsgForContent( 'filestatus' ) . " ==\n" . $copyStatus . "\n" .
+                               "$licensetxt" .
+                               '== ' . wfMsgForContent( 'filesource' ) . " ==\n" . $source;
                } else {
                        if ( $license != '' ) {
-                               $filedesc = $comment == '' ? '' : '== ' . wfMsgForContent ( 'filedesc' ) . " ==\n" . $comment . "\n";
-                                $pageText = $filedesc .
-                                        '== ' . wfMsgForContent ( 'license-header' ) . " ==\n" . '{{' . $license . '}}' . "\n";
+                               $filedesc = $comment == '' ? '' : '== ' . wfMsgForContent( 'filedesc' ) . " ==\n" . $comment . "\n";
+                                       $pageText = $filedesc .
+                                       '== ' . wfMsgForContent( 'license-header' ) . " ==\n" . '{{' . $license . '}}' . "\n";
                        } else {
                                $pageText = $comment;
                        }
@@ -404,7 +518,7 @@ class SpecialUpload extends SpecialPage {
         * Note that the page target can be changed *on the form*, so our check
         * state can get out of sync.
         */
-       protected function watchCheck() {
+       protected function getWatchCheck() {
                global $wgUser;
                if( $wgUser->getOption( 'watchdefault' ) ) {
                        // Watch all edits!
@@ -426,7 +540,7 @@ class SpecialUpload extends SpecialPage {
        /**
         * Provides output to the user for a result of UploadBase::verifyUpload
         *
-        * @param array $details Result of UploadBase::verifyUpload
+        * @param $details Array: result of UploadBase::verifyUpload
         */
        protected function processVerificationError( $details ) {
                global $wgFileExtensions, $wgLang;
@@ -435,28 +549,27 @@ class SpecialUpload extends SpecialPage {
 
                        /** Statuses that only require name changing **/
                        case UploadBase::MIN_LENGTH_PARTNAME:
-                               $this->recoverableUploadError( wfMsgHtml( 'minlength1' ) );
+                               $this->showRecoverableUploadError( wfMsgHtml( 'minlength1' ) );
                                break;
                        case UploadBase::ILLEGAL_FILENAME:
-                               $this->recoverableUploadError( wfMsgExt( 'illegalfilename',
+                               $this->showRecoverableUploadError( wfMsgExt( 'illegalfilename',
                                        'parseinline', $details['filtered'] ) );
                                break;
-                       case UploadBase::OVERWRITE_EXISTING_FILE:
-                               $this->recoverableUploadError( wfMsgExt( $details['overwrite'],
-                                       'parseinline' ) );
-                               break;
                        case UploadBase::FILETYPE_MISSING:
-                               $this->recoverableUploadError( wfMsgExt( 'filetype-missing',
+                               $this->showRecoverableUploadError( wfMsgExt( 'filetype-missing',
                                        'parseinline' ) );
                                break;
 
                        /** Statuses that require reuploading **/
                        case UploadBase::EMPTY_FILE:
-                               $this->showUploadForm( $this->getUploadForm( wfMsgHtml( 'emptyfile' ) ) );
+                               $this->showUploadError( wfMsgHtml( 'emptyfile' ) );
+                               break;
+                       case UploadBase::FILE_TOO_LARGE:
+                               $this->showUploadError( wfMsgHtml( 'largefileserver' ) );
                                break;
                        case UploadBase::FILETYPE_BADTYPE:
                                $finalExt = $details['finalExt'];
-                               $this->uploadError(
+                               $this->showUploadError(
                                        wfMsgExt( 'filetype-banned-type',
                                                array( 'parseinline' ),
                                                htmlspecialchars( $finalExt ),
@@ -471,7 +584,7 @@ class SpecialUpload extends SpecialPage {
                        case UploadBase::VERIFICATION_ERROR:
                                unset( $details['status'] );
                                $code = array_shift( $details['details'] );
-                               $this->uploadError( wfMsgExt( $code, 'parseinline', $details['details'] ) );
+                               $this->showUploadError( wfMsgExt( $code, 'parseinline', $details['details'] ) );
                                break;
                        case UploadBase::HOOK_ABORTED:
                                if ( is_array( $details['error'] ) ) { # allow hooks to return error details in an array
@@ -482,7 +595,7 @@ class SpecialUpload extends SpecialPage {
                                        $args = null;
                                }
 
-                               $this->uploadError( wfMsgExt( $error, 'parseinline', $args ) );
+                               $this->showUploadError( wfMsgExt( $error, 'parseinline', $args ) );
                                break;
                        default:
                                throw new MWException( __METHOD__ . ": Unknown value `{$details['status']}`" );
@@ -491,15 +604,16 @@ class SpecialUpload extends SpecialPage {
 
        /**
         * Remove a temporarily kept file stashed by saveTempUploadedFile().
-        * @access private
-        * @return success
+        *
+        * @return Boolean: success
         */
        protected function unsaveUploadedFile() {
                global $wgOut;
-               if ( !( $this->mUpload instanceof UploadFromStash ) )
+               if ( !( $this->mUpload instanceof UploadFromStash ) ) {
                        return true;
+               }
                $success = $this->mUpload->unsaveUploadedFile();
-               if ( ! $success ) {
+               if ( !$success ) {
                        $wgOut->showFileDeleteError( $this->mUpload->getTempPath() );
                        return false;
                } else {
@@ -513,42 +627,42 @@ class SpecialUpload extends SpecialPage {
         * Formats a result of UploadBase::getExistsWarning as HTML
         * This check is static and can be done pre-upload via AJAX
         *
-        * @param array $exists The result of UploadBase::getExistsWarning
-        * @return string Empty string if there is no warning or an HTML fragment
-        * consisting of one or more <li> elements if there is a warning.
+        * @param $exists Array: the result of UploadBase::getExistsWarning
+        * @return String: empty string if there is no warning or an HTML fragment
         */
        public static function getExistsWarning( $exists ) {
-               global $wgUser, $wgContLang;
+               global $wgUser;
 
-               if ( !$exists )
+               if ( !$exists ) {
                        return '';
+               }
 
                $file = $exists['file'];
                $filename = $file->getTitle()->getPrefixedText();
-               $warning = array();
+               $warning = '';
 
                $sk = $wgUser->getSkin();
 
                if( $exists['warning'] == 'exists' ) {
                        // Exact match
-                       $warning[] = '<li>' . wfMsgExt( 'fileexists', 'parseinline', $filename ) . '</li>';
+                       $warning = wfMsgExt( 'fileexists', 'parseinline', $filename );
                } elseif( $exists['warning'] == 'page-exists' ) {
                        // Page exists but file does not
-                       $warning[] = '<li>' . wfMsgExt( 'filepageexists', 'parseinline', $filename ) . '</li>';
+                       $warning = wfMsgExt( 'filepageexists', 'parseinline', $filename );
                } elseif ( $exists['warning'] == 'exists-normalized' ) {
-                       $warning[] = '<li>' . wfMsgExt( 'fileexists-extension', 'parseinline', $filename,
-                               $exists['normalizedFile']->getTitle()->getPrefixedText() ) . '</li>';
+                       $warning = wfMsgExt( 'fileexists-extension', 'parseinline', $filename,
+                               $exists['normalizedFile']->getTitle()->getPrefixedText() );
                } elseif ( $exists['warning'] == 'thumb' ) {
                        // Swapped argument order compared with other messages for backwards compatibility
-                       $warning[] = '<li>' . wfMsgExt( 'fileexists-thumbnail-yes', 'parseinline',
-                               $exists['thumbFile']->getTitle()->getPrefixedText(), $filename ) . '</li>';
+                       $warning = wfMsgExt( 'fileexists-thumbnail-yes', 'parseinline',
+                               $exists['thumbFile']->getTitle()->getPrefixedText(), $filename );
                } elseif ( $exists['warning'] == 'thumb-name' ) {
                        // Image w/o '180px-' does not exists, but we do not like these filenames
                        $name = $file->getName();
                        $badPart = substr( $name, 0, strpos( $name, '-' ) + 1 );
-                       $warning[] = '<li>' . wfMsgExt( 'file-thumbnail-no', 'parseinline', $badPart ) . '</li>';
+                       $warning = wfMsgExt( 'file-thumbnail-no', 'parseinline', $badPart );
                } elseif ( $exists['warning'] == 'bad-prefix' ) {
-                       $warning[] = '<li>' . wfMsgExt( 'filename-bad-prefix', 'parseinline', $exists['prefix'] ) . '</li>';
+                       $warning = wfMsgExt( 'filename-bad-prefix', 'parseinline', $exists['prefix'] );
                } elseif ( $exists['warning'] == 'was-deleted' ) {
                        # If the file existed before and was deleted, warn the user of this
                        $ltitle = SpecialPage::getTitleFor( 'Log' );
@@ -561,17 +675,17 @@ class SpecialUpload extends SpecialPage {
                                        'page' => $filename
                                )
                        );
-                       $warning[] = '<li>' . wfMsgWikiHtml( 'filewasdeleted', $llink ) . '</li>';
+                       $warning = wfMsgWikiHtml( 'filewasdeleted', $llink );
                }
 
-               return implode( "\n", $warning );
+               return $warning;
        }
 
        /**
         * Get a list of warnings
         *
-        * @param string local filename, e.g. 'file exists', 'non-descriptive filename'
-        * @return array list of warning messages
+        * @param $filename String: local filename, e.g. 'file exists', 'non-descriptive filename'
+        * @return Array: list of warning messages
         */
        public static function ajaxGetExistsWarning( $filename ) {
                $file = wfFindFile( $filename );
@@ -580,51 +694,32 @@ class SpecialUpload extends SpecialPage {
                        // if there isn't an exact match...
                        $file = wfLocalFile( $filename );
                }
-               $s = '&nbsp;';
+               $s = '&#160;';
                if ( $file ) {
                        $exists = UploadBase::getExistsWarning( $file );
                        $warning = self::getExistsWarning( $exists );
                        if ( $warning !== '' ) {
-                               $s = "<ul>$warning</ul>";
+                               $s = "<div>$warning</div>";
                        }
                }
                return $s;
        }
 
-       /**
-        * Render a preview of a given license for the AJAX preview on upload
-        *
-        * @param string $license
-        * @return string
-        */
-       public static function ajaxGetLicensePreview( $license ) {
-               global $wgParser, $wgUser;
-               $text = '{{' . $license . '}}';
-               $title = Title::makeTitle( NS_FILE, 'Sample.jpg' );
-               $options = ParserOptions::newFromUser( $wgUser );
-
-               // Expand subst: first, then live templates...
-               $text = $wgParser->preSaveTransform( $text, $title, $wgUser, $options );
-               $output = $wgParser->parse( $text, $title, $options );
-
-               return $output->getText();
-       }
-
        /**
         * Construct a warning and a gallery from an array of duplicate files.
         */
        public static function getDupeWarning( $dupes ) {
                if( $dupes ) {
                        global $wgOut;
-                       $msg = "<gallery>";
+                       $msg = '<gallery>';
                        foreach( $dupes as $file ) {
                                $title = $file->getTitle();
                                $msg .= $title->getPrefixedText() .
-                                       "|" . $title->getText() . "\n";
+                                       '|' . $title->getText() . "\n";
                        }
-                       $msg .= "</gallery>";
-                       return "<li>" .
-                               wfMsgExt( "file-exists-duplicate", array( "parse" ), count( $dupes ) ) .
+                       $msg .= '</gallery>';
+                       return '<li>' .
+                               wfMsgExt( 'file-exists-duplicate', array( 'parse' ), count( $dupes ) ) .
                                $wgOut->parse( $msg ) .
                                "</li>\n";
                } else {
@@ -642,49 +737,63 @@ class UploadForm extends HTMLForm {
        protected $mForReUpload;
        protected $mSessionKey;
        protected $mHideIgnoreWarning;
-       
+       protected $mDestWarningAck;
+       protected $mDestFile;
+
+       protected $mTextTop;
+       protected $mTextAfterSummary;
+
        protected $mSourceIds;
 
        public function __construct( $options = array() ) {
-               global $wgLang;
-
                $this->mWatch = !empty( $options['watch'] );
                $this->mForReUpload = !empty( $options['forreupload'] );
-               $this->mSessionKey = isset( $options['sessionkey'] ) 
+               $this->mSessionKey = isset( $options['sessionkey'] )
                                ? $options['sessionkey'] : '';
                $this->mHideIgnoreWarning = !empty( $options['hideignorewarning'] );
+               $this->mDestWarningAck = !empty( $options['destwarningack'] );
+               $this->mDestFile = isset( $options['destfile'] ) ? $options['destfile'] : '';
+
+               $this->mTextTop = isset( $options['texttop'] )
+                       ? $options['texttop'] : '';
+
+               $this->mTextAfterSummary = isset( $options['textaftersummary'] )
+                       ? $options['textaftersummary'] : ''; 
 
                $sourceDescriptor = $this->getSourceSection();
                $descriptor = $sourceDescriptor
                        + $this->getDescriptionSection()
                        + $this->getOptionsSection();
 
-               wfRunHooks( 'UploadFormInitDescriptor', array( $descriptor ) );
+               wfRunHooks( 'UploadFormInitDescriptor', array( &$descriptor ) );
                parent::__construct( $descriptor, 'upload' );
 
                # Set some form properties
                $this->setSubmitText( wfMsg( 'uploadbtn' ) );
                $this->setSubmitName( 'wpUpload' );
+               # Used message keys: 'accesskey-upload', 'tooltip-upload'
                $this->setSubmitTooltip( 'upload' );
                $this->setId( 'mw-upload-form' );
 
                # Build a list of IDs for javascript insertion
                $this->mSourceIds = array();
                foreach ( $sourceDescriptor as $key => $field ) {
-                       if ( !empty( $field['id'] ) )
+                       if ( !empty( $field['id'] ) ) {
                                $this->mSourceIds[] = $field['id'];
+                       }
                }
 
        }
 
        /**
-        * Get the descriptor of the fieldset that contains the file source 
+        * Get the descriptor of the fieldset that contains the file source
         * selection. The section is 'source'
-        * 
-        * @return array Descriptor array
+        *
+        * @return Array: descriptor array
         */
        protected function getSourceSection() {
                global $wgLang, $wgUser, $wgRequest;
+               global $wgMaxUploadSize;
 
                if ( $this->mSessionKey ) {
                        return array(
@@ -704,30 +813,42 @@ class UploadForm extends HTMLForm {
                $selectedSourceType = strtolower( $wgRequest->getText( 'wpSourceType', 'File' ) );
 
                $descriptor = array();
-               $descriptor['UploadFile'] = array(
-                               'class' => 'UploadSourceField',
+               if ( $this->mTextTop ) {
+                       $descriptor['UploadFormTextTop'] = array(
+                               'type' => 'info',
                                'section' => 'source',
-                               'type' => 'file',
-                               'id' => 'wpUploadFile',
-                               'label-message' => 'sourcefilename',
-                               'upload-type' => 'File',
-                               'radio' => &$radio,
-                               'help' => wfMsgExt( 'upload-maxfilesize',
-                                               array( 'parseinline', 'escapenoentities' ),
-                                               $wgLang->formatSize(
-                                                       wfShorthandToInteger( ini_get( 'upload_max_filesize' ) )
-                                               )
-                                       ) . ' ' . wfMsgHtml( 'upload_source_file' ),
-                               'checked' => $selectedSourceType == 'file',
+                               'default' => $this->mTextTop,
+                               'raw' => true,
+                       );
+               }
+
+               $descriptor['UploadFile'] = array(
+                       'class' => 'UploadSourceField',
+                       'section' => 'source',
+                       'type' => 'file',
+                       'id' => 'wpUploadFile',
+                       'label-message' => 'sourcefilename',
+                       'upload-type' => 'File',
+                       'radio' => &$radio,
+                       'help' => wfMsgExt( 'upload-maxfilesize',
+                                       array( 'parseinline', 'escapenoentities' ),
+                                       $wgLang->formatSize(
+                                               wfShorthandToInteger( min( 
+                                                       wfShorthandToInteger(
+                                                               ini_get( 'upload_max_filesize' )
+                                                       ), $wgMaxUploadSize
+                                               ) )
+                                       )
+                               ) . ' ' . wfMsgHtml( 'upload_source_file' ),
+                       'checked' => $selectedSourceType == 'file',
                );
                if ( $canUploadByUrl ) {
-                       global $wgMaxUploadSize;
                        $descriptor['UploadFileURL'] = array(
                                'class' => 'UploadSourceField',
                                'section' => 'source',
                                'id' => 'wpUploadFileURL',
                                'label-message' => 'sourceurl',
-                               'upload-type' => 'Url',
+                               'upload-type' => 'url',
                                'radio' => &$radio,
                                'help' => wfMsgExt( 'upload-maxfilesize',
                                                array( 'parseinline', 'escapenoentities' ),
@@ -747,11 +868,10 @@ class UploadForm extends HTMLForm {
                return $descriptor;
        }
 
-
        /**
         * Get the messages indicating which extensions are preferred and prohibitted.
-        * 
-        * @return string HTML string containing the message
+        *
+        * @return String: HTML string containing the message
         */
        protected function getExtensionsMessage() {
                # Print a list of allowed file extensions, if so configured.  We ignore
@@ -759,7 +879,6 @@ class UploadForm extends HTMLForm {
                global $wgLang, $wgCheckFileExtensions, $wgStrictFileExtensions,
                $wgFileExtensions, $wgFileBlacklist;
 
-               $allowedExtensions = '';
                if( $wgCheckFileExtensions ) {
                        if( $wgStrictFileExtensions ) {
                                # Everything not permitted is banned
@@ -787,8 +906,8 @@ class UploadForm extends HTMLForm {
        /**
         * Get the descriptor of the fieldset that contains the file description
         * input. The section is 'description'
-        * 
-        * @return array Descriptor array
+        *
+        * @return Array: descriptor array
         */
        protected function getDescriptionSection() {
                global $wgUser, $wgOut;
@@ -805,6 +924,9 @@ class UploadForm extends HTMLForm {
                                'id' => 'wpDestFile',
                                'label-message' => 'destfilename',
                                'size' => 60,
+                               'default' => $this->mDestFile,
+                               # FIXME: hack to work around poor handling of the 'default' option in HTMLForm
+                               'nodata' => strval( $this->mDestFile ) !== '',
                        ),
                        'UploadDescription' => array(
                                'type' => 'textarea',
@@ -815,21 +937,35 @@ class UploadForm extends HTMLForm {
                                        : 'fileuploadsummary',
                                'cols' => $cols,
                                'rows' => 8,
-                       ),
+                       )
+               );
+               if ( $this->mTextAfterSummary ) {
+                       $descriptor['UploadFormTextAfterSummary'] = array(
+                               'type' => 'info',
+                               'section' => 'description',
+                               'default' => $this->mTextAfterSummary,
+                               'raw' => true,
+                       );
+               }
+
+               $descriptor += array(
                        'EditTools' => array(
                                'type' => 'edittools',
                                'section' => 'description',
-                       ),
-                       'License' => array(
+                       )
+               );
+
+               if ( $this->mForReUpload ) {
+                       $descriptor['DestFile']['readonly'] = true;
+               } else {
+                       $descriptor['License'] = array(
                                'type' => 'select',
                                'class' => 'Licenses',
                                'section' => 'description',
                                'id' => 'wpLicense',
                                'label-message' => 'license',
-                       ),
-               );
-               if ( $this->mForReUpload )
-                       $descriptor['DestFile']['readonly'] = true;
+                       );
+               }
 
                global $wgUseCopyrightUpload;
                if ( $wgUseCopyrightUpload ) {
@@ -851,22 +987,25 @@ class UploadForm extends HTMLForm {
        }
 
        /**
-        * Get the descriptor of the fieldset that contains the upload options, 
+        * Get the descriptor of the fieldset that contains the upload options,
         * such as "watch this file". The section is 'options'
-        * 
-        * @return array Descriptor array
+        *
+        * @return Array: descriptor array
         */
        protected function getOptionsSection() {
-               global $wgOut;
+               global $wgUser;
 
-               $descriptor = array(
-                       'Watchthis' => array(
-                               'type' => 'check',
-                               'id' => 'wpWatchthis',
-                               'label-message' => 'watchthisupload',
-                               'section' => 'options',
-                       )
-               );
+               if ( $wgUser->isLoggedIn() ) {
+                       $descriptor = array(
+                               'Watchthis' => array(
+                                       'type' => 'check',
+                                       'id' => 'wpWatchthis',
+                                       'label-message' => 'watchthisupload',
+                                       'section' => 'options',
+                                       'default' => $wgUser->getOption( 'watchcreations' ),
+                               )
+                       );
+               }
                if ( !$this->mHideIgnoreWarning ) {
                        $descriptor['IgnoreWarning'] = array(
                                'type' => 'check',
@@ -876,8 +1015,21 @@ class UploadForm extends HTMLForm {
                        );
                }
 
-               return $descriptor;
+               $descriptor['wpDestFileWarningAck'] = array(
+                       'type' => 'hidden',
+                       'id' => 'wpDestFileWarningAck',
+                       'default' => $this->mDestWarningAck ? '1' : '',
+               );
+               
+               if ( $this->mForReUpload ) {
+                       $descriptor['wpForReUpload'] = array(
+                               'type' => 'hidden',
+                               'id' => 'wpForReUpload',
+                               'default' => '1',
+                       );
+               }
 
+               return $descriptor;
        }
 
        /**
@@ -890,43 +1042,35 @@ class UploadForm extends HTMLForm {
 
        /**
         * Add upload JS to $wgOut
-        * 
-        * @param bool $autofill Whether or not to autofill the destination
-        *      filename text box
         */
-       protected function addUploadJS( ) {
-               global $wgUseAjax, $wgAjaxUploadDestCheck, $wgAjaxLicensePreview;
-               global $wgEnableFirefogg, $wgEnableJS2system;
+       protected function addUploadJS() {
+               global $wgUseAjax, $wgAjaxUploadDestCheck, $wgAjaxLicensePreview, $wgEnableAPI, $wgStrictFileExtensions;
                global $wgOut;
 
                $useAjaxDestCheck = $wgUseAjax && $wgAjaxUploadDestCheck;
-               $useAjaxLicensePreview = $wgUseAjax && $wgAjaxLicensePreview;
+               $useAjaxLicensePreview = $wgUseAjax && $wgAjaxLicensePreview && $wgEnableAPI;
 
                $scriptVars = array(
-                       'wgAjaxUploadDestCheck' => $wgUseAjax && $wgAjaxUploadDestCheck,
-                       'wgAjaxLicensePreview' => $wgUseAjax && $wgAjaxLicensePreview,
-                       'wgEnableFirefogg' => (bool)$wgEnableFirefogg,
-                       'wgUploadAutoFill' => !$this->mForReUpload,
+                       'wgAjaxUploadDestCheck' => $useAjaxDestCheck,
+                       'wgAjaxLicensePreview' => $useAjaxLicensePreview,
+                       'wgUploadAutoFill' => !$this->mForReUpload &&
+                               // If we received mDestFile from the request, don't autofill
+                               // the wpDestFile textbox
+                               $this->mDestFile === '',
                        'wgUploadSourceIds' => $this->mSourceIds,
+                       'wgStrictFileExtensions' => $wgStrictFileExtensions,
+                       'wgCapitalizeUploads' => MWNamespace::isCapitalized( NS_FILE ),
                );
 
                $wgOut->addScript( Skin::makeVariablesScript( $scriptVars ) );
-               
-               // For <charinsert> support; not provided by js2 yet
-               $wgOut->addScriptFile( 'edit.js' );
-               
-               if ( $wgEnableJS2system ) {
-                       // JS2 upload scripts
-                       $wgOut->addScriptClass( 'uploadPage' );
-               } else {
-                       // Legacy upload javascript
-                       $wgOut->addScriptFile( 'upload.js' );
-               }
+
+               // For <charinsert> support
+               $wgOut->addModules( array( 'mediawiki.legacy.edit', 'mediawiki.legacy.upload' ) );
        }
 
        /**
         * Empty function; submission is handled elsewhere.
-        * 
+        *
         * @return bool false
         */
        function trySubmit() {
@@ -939,9 +1083,9 @@ class UploadForm extends HTMLForm {
  * A form field that contains a radio box in the label
  */
 class UploadSourceField extends HTMLTextField {
-       function getLabelHtml() {
+       function getLabelHtml( $cellAttributes = array() ) {
                $id = "wpSourceType{$this->mParams['upload-type']}";
-               $label = Html::rawElement( 'label', array( 'for' => $id ), $this->mLabel  );
+               $label = Html::rawElement( 'label', array( 'for' => $id ), $this->mLabel );
 
                if ( !empty( $this->mParams['radio'] ) ) {
                        $attribs = array(
@@ -950,13 +1094,15 @@ class UploadSourceField extends HTMLTextField {
                                'id' => $id,
                                'value' => $this->mParams['upload-type'],
                        );
-                       if ( !empty( $this->mParams['checked'] ) )
+                       if ( !empty( $this->mParams['checked'] ) ) {
                                $attribs['checked'] = 'checked';
+                       }
                        $label .= Html::element( 'input', $attribs );
                }
 
-               return Html::rawElement( 'td', array( 'class' => 'mw-label' ), $label );
+               return Html::rawElement( 'td', array( 'class' => 'mw-label' ) + $cellAttributes, $label );
        }
+
        function getSize() {
                return isset( $this->mParams['size'] )
                        ? $this->mParams['size']