MediaWiki:Gadget-friendlytalkback.js

//

(function($) {

/* **************************************** *** friendlytalkback.js: Talkback module **************************************** * Mode of invocation:    Tab ("TB") * Active on:             Existing user talk pages * Config directives in:  FriendlyConfig */

Twinkle.talkback = function {

if (!mw.config.get('wgRelevantUserName')) { return; }

Twinkle.addPortletLink(Twinkle.talkback.callback, 'TB', 'friendly-talkback', 'Easy talkback'); };

Twinkle.talkback.callback = function { if (mw.config.get('wgRelevantUserName') === mw.config.get('wgUserName') && !confirm("Is it really so bad that you're talking back to yourself?")) { return; }

var Window = new Morebits.simpleWindow(600, 350); Window.setTitle('Talkback'); Window.setScriptName('Twinkle'); Window.addFooterLink('About ', 'Template:Talkback'); Window.addFooterLink('Twinkle help', 'WP:TW/DOC#talkback');

var form = new Morebits.quickForm(callback_evaluate);

form.append({ type: 'radio', name: 'tbtarget',		list: [			{				label: 'Talkback: my talk page',				value: 'mytalk',				checked: 'true'			},			{				label: 'Talkback: other user talk page',				value: 'usertalk'			},			{				label: 'Talkback: other page',				value: 'other'			},			{				label: '"Please see"',				value: 'see'			},			{				label: 'Noticeboard notification',				value: 'notice'			},			{				label: "\"You've got mail\"",				value: 'mail'			}		],		event: callback_change_target	});

form.append({		type: 'field',		label: 'Work area',		name: 'work_area'	});

form.append({ type: 'submit' });

var result = form.render; Window.setContent(result); Window.display;

// We must init the var evt = document.createEvent('Event'); evt.initEvent('change', true, true); result.tbtarget[0].dispatchEvent(evt);

// Check whether the user has opted out from talkback var query = { action: 'query', prop: 'extlinks', titles: mw.config.get('wgPageName'), elquery: 'userjs.invalid/noTalkback', ellimit: '1' };	var wpapi = new Morebits.wiki.api('Fetching talkback opt-out status', query, Twinkle.talkback.callback.optoutStatus); wpapi.post; };

Twinkle.talkback.optout = null;

Twinkle.talkback.callback.optoutStatus = function(apiobj) { var xml = apiobj.getXML; var $el = $(xml).find('el');

if ($el.length) { Twinkle.talkback.optout = mw.config.get('wgRelevantUserName') + ' prefers not to receive talkbacks'; var url = $el.text; if (url.indexOf('reason=') > -1) { Twinkle.talkback.optout += ': ' + decodeURIComponent(url.substring(url.indexOf('reason=') + 7)) + '.'; } else { Twinkle.talkback.optout += '.'; }	} else { Twinkle.talkback.optout = false; }

var $status = $('#twinkle-talkback-optout-message'); if ($status.length) { $status.append(Twinkle.talkback.optout); } };

var prev_page = ''; var prev_section = ''; var prev_message = '';

var callback_change_target = function(e) { var value = e.target.values; var root = e.target.form; var old_area = Morebits.quickForm.getElements(root, 'work_area')[0];

if (root.section) { prev_section = root.section.value; }	if (root.message) { prev_message = root.message.value; }	if (root.page) { prev_page = root.page.value; }

var work_area = new Morebits.quickForm.element({		type: 'field',		label: 'Talkback information',		name: 'work_area'	});

switch (value) { case 'mytalk': /* falls through */ default: work_area.append({				type: 'div',				label: '',				style: 'color: red',				id: 'twinkle-talkback-optout-message'			}); work_area.append({				type: 'input',				name: 'section',				label: 'Linked section (optional)',				tooltip: 'The section heading on your talk page where you left a message. Leave empty for no section to be linked.',				value: prev_section			}); break; case 'usertalk': work_area.append({				type: 'div',				label: '',				style: 'color: red',				id: 'twinkle-talkback-optout-message'			}); work_area.append({				type: 'input',				name: 'page',				label: 'User',				tooltip: 'The username of the user on whose talk page you left a message.',				value: prev_page			});

work_area.append({				type: 'input',				name: 'section',				label: 'Linked section (optional)',				tooltip: 'The section heading on the page where you left a message. Leave empty for no section to be linked.',				value: prev_section			}); break; case 'notice': var noticeboard = work_area.append({				type: 'select',				name: 'noticeboard',				label: 'Noticeboard:',				event: function(e) {					if (e.target.value === 'afchd') {						Morebits.quickForm.overrideElementLabel(e.target.form.section, 'Title of draft (excluding the prefix): ');						Morebits.quickForm.setElementTooltipVisibility(e.target.form.section, false);					} else {						Morebits.quickForm.resetElementLabel(e.target.form.section);						Morebits.quickForm.setElementTooltipVisibility(e.target.form.section, true);					}				}			}); noticeboard.append({				type: 'option',				label: "WP:AN (Administrators' noticeboard)",				value: 'an'			}); noticeboard.append({				type: 'option',				label: "WP:AN3 (Administrators' noticeboard/Edit warring)",				value: 'an3'			}); noticeboard.append({				type: 'option',				label: "WP:ANI (Administrators' noticeboard/Incidents)",				selected: true,				value: 'ani'			}); // let's keep AN and its cousins at the top noticeboard.append({				type: 'option',				label: 'WP:AFCHD (Articles for creation/Help desk)',				value: 'afchd'			}); noticeboard.append({				type: 'option',				label: 'WP:COIN (Conflict of interest noticeboard)',				value: 'coin'			}); noticeboard.append({				type: 'option',				label: 'WP:DRN (Dispute resolution noticeboard)',				value: 'drn'			}); noticeboard.append({				type: 'option',				label: 'WP:HD (Help desk)',				value: 'hd'			}); noticeboard.append({				type: 'option',				label: 'WP:OTRS/N (OTRS noticeboard)',				value: 'otrs'			}); noticeboard.append({				type: 'option',				label: 'WP:THQ (Teahouse question forum)',				value: 'th'			}); work_area.append({				type: 'input',				name: 'section',				label: 'Linked thread',				tooltip: 'The heading of the relevant thread on the noticeboard page.',				value: prev_section			}); break; case 'other': work_area.append({				type: 'div',				label: '',				style: 'color: red',				id: 'twinkle-talkback-optout-message'			}); work_area.append({				type: 'input',				name: 'page',				label: 'Full page name',				tooltip: "The full page name where you left the message. For example: 'Wikipedia talk:Twinkle'.",				value: prev_page			});

work_area.append({				type: 'input',				name: 'section',				label: 'Linked section (optional)',				tooltip: 'The section heading on the page where you left a message. Leave empty for no section to be linked.',				value: prev_section			}); break; case 'mail': work_area.append({				type: 'input',				name: 'section',				label: 'Subject of email (optional)',				tooltip: 'The subject line of the email you sent.'			}); break; case 'see': work_area.append({				type: 'input',				name: 'page',				label: 'Full page name',				tooltip: "The full page name of where the discussion is being held. For example: 'Wikipedia talk:Twinkle'.",				value: prev_page			}); work_area.append({				type: 'input',				name: 'section',				label: 'Linked section (optional)',				tooltip: "The section heading where the discussion is being held. For example: 'Merge proposal'.",				value: prev_section			}); break; }

if (value !== 'notice') { work_area.append({ type: 'textarea', label: 'Additional message (optional):', name: 'message', tooltip: 'An additional message that you would like to leave below the talkback template. Your signature will be added to the end of the message if you leave one.' }); }

work_area = work_area.render; root.replaceChild(work_area, old_area); if (root.message) { root.message.value = prev_message; }

if (Twinkle.talkback.optout) { $('#twinkle-talkback-optout-message').append(Twinkle.talkback.optout); } };

var callback_evaluate = function(e) {

var tbtarget = e.target.getChecked('tbtarget')[0]; var page = null; var section = e.target.section.value; var fullUserTalkPageName = mw.config.get('wgFormattedNamespaces')[mw.config.get('wgNamespaceIds').user_talk] + ':' + mw.config.get('wgRelevantUserName');

if (tbtarget === 'usertalk' || tbtarget === 'other' || tbtarget === 'see') { page = e.target.page.value;

if (tbtarget === 'usertalk') { if (!page) { alert('You must specify the username of the user whose talk page you left a message on.'); return; }		} else { if (!page) { alert('You must specify the full page name when your message is not on a user talk page.'); return; }		}	} else if (tbtarget === 'notice') { page = e.target.noticeboard.value; }

var message; if (e.target.message) { message = e.target.message.value; }

Morebits.simpleWindow.setButtonsEnabled(false); Morebits.status.init(e.target);

Morebits.wiki.actionCompleted.redirect = fullUserTalkPageName; Morebits.wiki.actionCompleted.notice = 'Talkback complete; reloading talk page in a few seconds';

var talkpage = new Morebits.wiki.page(fullUserTalkPageName, 'Adding talkback'); var tbPageName = tbtarget === 'mytalk' ? mw.config.get('wgUserName') : page;

var text; if (tbtarget === 'notice') { switch (page) { case 'afchd': text = '\n\n' + section + ' ~'; talkpage.setEditSummary('You have replies at the Articles for Creation Help Desk' + Twinkle.getPref('summaryAd')); break; case 'an': text = '\n\n== ' + Twinkle.getFriendlyPref('adminNoticeHeading') + ' ==\n'; text += ' ~";				talkpage.setEditSummary("Notice of discussion at Administrators' noticeboard" + Twinkle.getPref('summaryAd'));				break;			case 'an3':				text = '\n\n' + section + ' ~';				talkpage.setEditSummary("Notice of discussion at Administrators' noticeboard/Edit warring" + Twinkle.getPref('summaryAd'));				break;			case 'ani':				text = '\n\n== ' + Twinkle.getFriendlyPref('adminNoticeHeading') + ' ==\n';				text += ' ~"; talkpage.setEditSummary("Notice of discussion at Administrators' noticeboard/Incidents" + Twinkle.getPref('summaryAd')); break; case 'coin': text = '\n\n ~'; talkpage.setEditSummary('Notice of discussion at Conflict of interest noticeboard' + Twinkle.getPref('summaryAd')); break; case 'drn': text = '\n\n ~'; talkpage.setEditSummary('Notice of discussion at Dispute resolution noticeboard' + Twinkle.getPref('summaryAd')); break; case 'hd': text = '\n\n== Your question at the Help desk ==\n'; text += ''; talkpage.setEditSummary('You have replies at the Wikipedia help desk' + Twinkle.getPref('summaryAd')); break; case 'otrs': text = '\n\n'; talkpage.setEditSummary('You have replies at the OTRS noticeboard' + Twinkle.getPref('summaryAd')); break; case 'th': text = "\n\n== Teahouse talkback: you've got messages! ==\n';				talkpage.setEditSummary('You have replies at the Teahouse question board' + Twinkle.getPref('summaryAd'));				break;			default:				throw 'Twinkle.talkback, function callback_evaluate: default case reached';		}

} else if (tbtarget === 'mail') { text = '\n\n==' + Twinkle.getFriendlyPref('mailHeading') + "==\n';

if (message) { text += '\n' + message.trim + ' ~'; } else if (Twinkle.getFriendlyPref('insertTalkbackSignature')) { text += '\n~'; }

talkpage.setEditSummary("Notification: You've got mail" + Twinkle.getPref('summaryAd'));

} else if (tbtarget === 'see') { text = '\n\n'; talkpage.setEditSummary('Please check the discussion at ' + tbPageName +			(section ? '' + Twinkle.getPref('summaryAd'));

} else { // tbtarget one of mytalk, usertalk, other // clean talkback heading: strip section header markers that were erroneously suggested in the documentation text = '\n\n==' + Twinkle.getFriendlyPref('talkbackHeading').replace(/^\s*=+\s*(.*?)\s*=+$\s*/, '$1') + '==\n';

if (message) { text += '\n' + message.trim + ' ~'; } else if (Twinkle.getFriendlyPref('insertTalkbackSignature')) { text += '\n~'; }

var editSummary = 'Talkback (';		if (tbtarget !== 'other' && !/^\s*user talk:/i.test(tbPageName)) {			editSummary += 'User talk:';		}		editSummary += tbPageName + (section ? ')'; talkpage.setEditSummary(editSummary + Twinkle.getPref('summaryAd')); }

talkpage.setAppendText(text); talkpage.setCreateOption('recreate'); talkpage.setMinorEdit(Twinkle.getFriendlyPref('markTalkbackAsMinor')); talkpage.setFollowRedirect(true); talkpage.append; };

})(jQuery);

//