( function () {
/**
* Posts messages to wikitext talk pages.
*
* @class mw.messagePoster.WikitextMessagePoster
* @classdesc An implementation of MessagePoster for wikitext talk pages.
* @extends mw.messagePoster.MessagePoster
* @type {mw.messagePoster.WikitextMessagePoster}
*
* @constructor
* @param {mw.Title} title Wikitext page in a talk namespace, to post to
* @param {mw.Api} api mw.Api object to use
*/
function WikitextMessagePoster( title, api ) {
this.api = api;
this.title = title;
}
OO.inheritClass(
WikitextMessagePoster,
mw.messagePoster.MessagePoster
);
/**
* @inheritdoc
* @param {string} subject Section title.
* @param {string} body Message body, as wikitext. Signature code will automatically be added unless the message already contains the string ~~~.
* @param {Object} [options] Message options:
* @param {string} [options.tags] [Change tags](https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Tags) to add to the message's revision, pipe-separated.
*/
WikitextMessagePoster.prototype.post = function ( subject, body, options ) {
var additionalParams;
options = options || {};
mw.messagePoster.WikitextMessagePoster.super.prototype.post.call( this, subject, body, options );
// Add signature if needed
if ( body.indexOf( '~~~' ) === -1 ) {
body += '\n\n~~~~';
}
additionalParams = { redirect: true };
if ( options.tags !== undefined ) {
additionalParams.tags = options.tags;
}
return this.api.newSection(
this.title,
subject,
body,
additionalParams
).then( function ( resp, jqXHR ) {
if ( resp.edit.result === 'Success' ) {
return $.Deferred().resolve( resp, jqXHR );
} else {
// mw.Api checks for response error. Are there actually cases where the
// request fails, but it's not caught there?
return $.Deferred().reject( 'api-unexpected' );
}
}, function ( code, details ) {
return $.Deferred().reject( 'api-fail', code, details );
} ).promise();
};
mw.messagePoster.factory.register( 'wikitext', WikitextMessagePoster );
mw.messagePoster.WikitextMessagePoster = WikitextMessagePoster;
}() );