/*!
* VisualEditor MediaWiki Initialization CollabTarget class.
*
* @copyright 2011-2016 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* MediaWiki mobile article target.
*
* @class
* @extends ve.init.mw.Target
*
* @constructor
* @param {mw.Title} title Page sub-title
* @param {rebaserUrl} string Rebaser server URL
* @param {Object} [config] Configuration options
* @cfg {mw.Title} [importTitle] Title to import
*/
ve.init.mw.CollabTarget = function VeInitMwCollabTarget( title, rebaserUrl, config ) {
config = config || {};
config.toolbarConfig = $.extend( {
shadow: true,
actions: true,
floatable: true
}, config.toolbarConfig );
this.title = title;
this.rebaserUrl = rebaserUrl;
this.importTitle = config.importTitle || null;
// Parent constructor
ve.init.mw.CollabTarget.super.call( this, config );
// HACK: Disable history commands until supported (T185706)
ve.ui.commandRegistry.unregister( 'undo' );
ve.ui.commandRegistry.unregister( 'redo' );
// HACK: Disable references until supported (T194838)
ve.ui.commandRegistry.unregister( 'reference' );
ve.ui.commandRegistry.unregister( 'referencesList' );
ve.ui.commandRegistry.unregister( 'citefromid' );
this.$originalContent = $( '
' ).addClass( 've-init-mw-desktopArticleTarget-originalContent' );
this.$editableContent = $( '#mw-content-text' );
// Initialization
this.$element.addClass( 've-init-mw-articleTarget ve-init-mw-desktopArticleTarget ve-init-mw-collabTarget' ).append( this.$originalContent );
};
/* Inheritance */
OO.inheritClass( ve.init.mw.CollabTarget, ve.init.mw.Target );
/* Static Properties */
ve.init.mw.CollabTarget.static.name = 'collab';
ve.init.mw.CollabTarget.static.trackingName = 'collab';
ve.init.mw.CollabTarget.static.toolbarGroups = ve.copy( ve.init.mw.CollabTarget.static.toolbarGroups );
ve.init.mw.CollabTarget.static.toolbarGroups.splice( 4, 0, {
name: 'commentAnnotation',
include: [ 'commentAnnotation' ]
} );
// HACK: Disable references until supported (T194838)
ve.init.mw.CollabTarget.static.toolbarGroups = ve.init.mw.CollabTarget.static.toolbarGroups.filter( function ( group ) {
return group.name !== 'reference';
} );
ve.init.mw.CollabTarget.static.actionGroups = [
{
name: 'help',
include: [ 'help' ]
},
{
name: 'pageMenu',
type: 'list',
icon: 'menu',
indicator: null,
title: ve.msg( 'visualeditor-pagemenu-tooltip' ),
include: [ 'changeDirectionality', 'findAndReplace' ]
},
{
name: 'authorList',
include: [ 'authorList' ]
}
];
/* Methods */
/**
* Page modifications after editor load.
*/
ve.init.mw.CollabTarget.prototype.transformPage = function () {
this.$originalContent.append( this.$element.siblings() );
};
/**
* Page modifications after editor teardown.
*/
ve.init.mw.CollabTarget.prototype.restorePage = function () {
this.$element.parent().append( this.$originalContent.children() );
$( '#contentSub' ).empty();
};
/**
* @inheritdoc
*/
ve.init.mw.CollabTarget.prototype.surfaceReady = function () {
var exportButton,
surfaceView = this.getSurface().getView(),
toolbar = this.getToolbar();
// Parent method
ve.init.mw.CollabTarget.super.prototype.surfaceReady.apply( this, arguments );
this.getSurface().getView().focus();
exportButton = new OO.ui.ButtonWidget( {
icon: 'wikiText',
label: ve.msg( 'visualeditor-savedialog-review-wikitext' ),
flags: [ 'progressive', 'primary' ]
} );
exportButton.connect( this, { click: 'onExportButtonClick' } );
toolbar.$actions.append( exportButton.$element );
toolbar.initialize();
surfaceView.focus();
};
/**
* Handle click events from the export button
*/
ve.init.mw.CollabTarget.prototype.onExportButtonClick = function () {
var surface = this.getSurface(),
windowAction = ve.ui.actionFactory.create( 'window', surface );
windowAction.open( 'mwExportWikitext', { surface: surface } );
};
/**
* @inheritdoc
*/
ve.init.mw.CollabTarget.prototype.attachToolbar = function () {
this.toolbar.$element.addClass(
've-init-mw-desktopArticleTarget-toolbar ve-init-mw-desktopArticleTarget-toolbar-open ve-init-mw-desktopArticleTarget-toolbar-opened'
);
this.$element.prepend( this.toolbar.$element );
this.toolbar.initialize();
};
/**
* @inheritdoc
*/
ve.init.mw.CollabTarget.prototype.setSurface = function ( surface ) {
var synchronizer, surfaceView,
importDeferred = $.Deferred(),
target = this;
if ( surface !== this.surface ) {
this.$editableContent.after( surface.$element );
surfaceView = surface.getView();
synchronizer = new ve.dm.SurfaceSynchronizer(
surface.getModel(),
this.title.toString(),
{
server: this.rebaserUrl,
// TODO: server could communicate with MW (via oauth?) to know the
// current-user's name. Disable changing name if logged in?
// Communicate an I-am-a-valid-user flag to other clients?
defaultName: mw.user.isAnon() ? mw.user.getName() : undefined
}
);
synchronizer.once( 'initDoc', function () {
var surfaceModel, initPromise, title;
if ( target.importTitle && !surface.getModel().getDocument().getCompleteHistoryLength() ) {
initPromise = mw.libs.ve.targetLoader.requestParsoidData( target.importTitle.toString(), { targetName: 'collabpad' } ).then( function ( response ) {
var doc, dmDoc, fragment,
data = response.visualeditor;
if ( data && data.content ) {
doc = target.constructor.static.parseDocument( data.content );
dmDoc = target.constructor.static.createModelFromDom( doc );
fragment = surface.getModel().getLinearFragment( new ve.Range( 0, 2 ) );
fragment.insertDocument( dmDoc );
target.etag = data.etag;
target.baseTimeStamp = data.basetimestamp;
target.startTimeStamp = data.starttimestamp;
target.revid = data.oldid;
// Store the document metadata as a hidden meta item
fragment.collapseToEnd().insertContent( [
{
type: 'alienMeta',
attributes: {
importedDocument: {
title: target.importTitle.toString(),
etag: target.etag,
baseTimeStamp: target.baseTimeStamp,
startTimeStamp: target.startTimeStamp,
revid: target.revid
}
}
},
{ type: '/alienMeta' }
] );
surface.getModel().selectFirstContentOffset();
} else {
// Import failed
return $.Deferred().reject( 'No content for ' + target.importTitle ).promise();
}
} );
} else {
// No import, or history already exists
initPromise = $.Deferred().resolve().promise();
// Look for import metadata in document
surfaceModel = target.getSurface().getModel();
surfaceModel.getMetaList().getItemsInGroup( 'misc' ).some( function ( item ) {
var importedDocument = item.getAttribute( 'importedDocument' );
if ( importedDocument ) {
target.importTitle = mw.Title.newFromText( importedDocument.title );
target.etag = importedDocument.etag;
target.baseTimeStamp = importedDocument.baseTimeStamp;
target.startTimeStamp = importedDocument.startTimeStamp;
target.revid = importedDocument.revid;
return true;
}
} );
}
initPromise.fail( function ( err ) {
setTimeout( function () {
throw new Error( err );
} );
} );
initPromise.always( function () {
surface.getModel().selectFirstContentOffset();
// Resolve progress bar
importDeferred.resolve();
if ( ( title = target.getImportTitle() ) ) {
$( '#contentSub' ).html(
ve.htmlMsg(
'collabpad-import-subtitle',
$( '
' ).attr( 'href', title.getUrl() ).text( title.getMainText() )
)
);
ve.targetLinksToNewWindow( $( '#contentSub' )[ 0 ] );
} else {
$( '#contentSub' ).empty();
}
} );
} );
surfaceView.setSynchronizer( synchronizer, importDeferred.promise() );
}
// Parent method
ve.init.mw.CollabTarget.super.prototype.setSurface.apply( this, arguments );
};
/**
* Get the title of the imported document, if there was one
*
* @return {mw.Title|null} Title of imported document
*/
ve.init.mw.CollabTarget.prototype.getImportTitle = function () {
return this.importTitle;
};
/**
* @inheritdoc
*/
ve.init.mw.CollabTarget.prototype.getPageName = function () {
return this.getImportTitle() || this.pageName;
};
/* Registration */
ve.init.mw.targetFactory.register( ve.init.mw.CollabTarget );