Wikipedia:FRIENDLY

Be advised that even when using these scripts, you take full responsibility for any action done using them. You must understand the Wikipedia policies and use this tool within that policy, or risk being blocked for its misuse.

Welcome to Friendly.

What is Friendly?

Friendly is a collection of JavaScripts that provide an interface similar to Twinkle (by using the morebits JavaScript library) for Wikipedia's more friendly, collaboration-oriented tasks.

Currently, the implemented features are welcome templates, shared IP address, tagging, and article space templates, provided via tabs labeled "welcome" and "shared ip" when on a user talk page and "tag" when in article space. A "welcome" link is also placed on diff pages next to users that have empty talk pages.

More features are always in the pipeline and Friendly is under ongoing development, so be sure to report any bugs or request new features on Friendly's talk page.

Notes

• All scripts on this page are only tested on Mozilla Firefox 3. They may not work on other browsers.
• The script is compatible with Twinkle, and will add additional Twinkle style function tabs.
• If using Windows, ZoneAlarm might break these scripts.
• Norton Internet Security (specifically, AntiSpam) will hijack the HTTP stream and append data, with the result that the data is malformed XML (the XML standard requires one root node only), breaking Friendly. This can be fixed by disabling popup blocking.

Functionality

Friendly adds additional features to various parts of Wikipedia. Each tab's ID is given to assist with further customization via additional user CSS or JavaScript.

User Talk Namespace

"welcome" Tab

Friendly's welcome functionality.

The welcome tab will welcome the user with selected template.

If an article is specified in the input field, and the template supports an article link, Friendly will automatically link the template to the article you specified. All templates that support this are marked with an asterisk ("*"). In the case of normal welcome templates, the article would be one that the user contributed positively to. In the case of problem user welcome templates, the article would be one that the user vandalized or did not contribute positively to. This input field is automatically populated if the vanarticle URL parameter is found, which is populated by Twinkle after doing a rollback.

Friendly is now capable of supporting a custom list of templates that displays below the standard set of Welcome templates. If you have installed Friendly, you can add a list of templates that you would like to be added to the Welcome dialogue by properly defining the customWelcomeList parameter in Friendly's configuration. Any templates added to this list, when selected, will simply be placed on the user's talk page with no heading, no arguments, and will be followed by your signature.

Tab element ID: friendly-welcome

"welcome" from Diff

Friendly's welcome option displayed in diff.

A welcome link will appear next to a user in a diff view if the user's talk page is empty. This allows you to quickly welcome the user with the template specified in the quickWelcomeTemplate parameter (by default) or easily open the user's talk page with Friendly's welcome dialogue already visible (if the quickWelcomeMode parameter is set to semiauto). This feature is available when viewing any diff across all namespaces.

"shared ip" Tab

Friendly's shared IP functionality.

The shared ip tab will tag the IP as a shared IP address.

Most of the Shared IP templates require that the name of the organization that owns or operates the IP address be input. If one of these templates is selected, Friendly will require that you fill in the "Organization name" input field, which does support wikitext.

Tab element ID: friendly-shared

Article Namespace

"tag" tab

Friendly's tag functionality.

The tag tab will tag the article with the template(s) of your choice.

All templates that are checked will be added to the article in their proper respective locations. Templates that support it will automatically be added with the date parameter populated to the current month and year. If the "Group into {{articleissues}} if possible" checkbox is ticked, Friendly will group supported templates into an {{articleissues}} template, if there are four or more. All other selected templates are then added to the article normally. If there are three or fewer selected templates that are supported by the {{articleissues}} template, the setting is ignored, and all templates are added to the article normally.

Four templates in the list, {{globalize}}, {{notability}}, {{current}}, and {{future}}, allow you to select from a list of subcategories of the respective templates. The standard template is the default, and selecting a subcategory is not required, but it does place a more specific version of the template on the article. If a {{globalize}} subcategory is selected and templates are being grouped into {{articleissues}}, the subcategory is ignored as {{articleissues}} only supports the standard {{globalize}} template. The {{notability}} subcategories are ignored in the same way when grouping.

If the redirect URL parameter is set to "no" and there is no rcid URL parameter, the tag tab will assume that you are viewing a redirect page. Instead of presenting you with a normal set of article tags, the tab will present you with a set of redirect categorization tags, from Category:Redirect templates.

Tab element ID: friendly-tag

Installation

To install all Friendly modules, including all future updates and additions:

1. copy the text below and paste it into the bottom of your monobook.js file:

   importScript('User:Ioeth/friendly.js');
   

2. save the new monobook.js page, and
3. completely refresh your browser by bypassing your cache (hit Control-Shift-R in Firefox).

You may wish to re-configure Friendly's default settings after installation. See below for instructions.

Individual Modules

If you just want to use one or more of the individual modules, here they are listed with their dependencies. The line importScript('User:AzaToth/morebits.js'); is only needed once in your monobook.js, and Twinkle already includes it (so you don't need it if you're a Twinkle user already). It is recommended that you do not import any script more than once, as it would just be a duplicate, but the importScript(); function has a check to make sure that a script is not imported more than once.

For the welcome functionality, add:

importScript('User:AzaToth/morebits.js');
importScript('User:Ioeth/friendlywelcome.js');

For the shared IP tagging functionality, add:

importScript('User:AzaToth/morebits.js');
importScript('User:Ioeth/friendlyshared.js');

For the tagging functionality, add:

importScript('User:AzaToth/morebits.js');
importScript('User:Ioeth/friendlytag.js');

Configuration

Optionally, to configure Friendly, copy the text below called FriendlyConfig, and paste it in your monobook.js file. (Per temporal disalignment it should not matter if you put the config before or after the includes). Each line in the object contains a specific setting which is described below. When changing settings, make sure not to remove the comma from the end of each line, and remember that some browsers dislike a comma on the last line.

Default Configuration

This is the default configuration:

FriendlyConfig = {
	summaryAd			:	" using [[WP:FRIENDLY|Friendly]]",
	topWelcomes			:	false,
	watchWelcomes			:	true,
	markWelcomesAsMinor		:	true,
	insertHeadings			:	true,
	welcomeHeading			:	"== Welcome ==",
	insertUsername			:	true,
	insertSignature			:	true,
	quickWelcomeMode		:	"auto",
	quickWelcomeTemplate		:	"Welcome",
	maskTemplateInSummary		:	true,
	markSharedAsMinor		:	true,
	groupByDefault			:	true,
	watchTaggedPages		:	true,
	markTaggedPagesAsMinor		:	true
};

Custom Configuration

Alternatively, you may wish to only copy the settings you wish to change.

FriendlyConfig = {
	key	:	value,
	key	:	value,
	...
	key	:	value
};

Parameter Descriptions

summaryAd

Defines what summary Ad to be added.

Argument is a string, default to using [[WP:FRIENDLY|Friendly]].

topWelcomes

Defines if the welcome should be added to the top or bottom of the user's talk page.

Argument is a boolean, default to false.

watchWelcomes

Defines if adding a welcome should add page to watchlist.

Argument is a boolean, default to true.

groupByDefault

Defines if the checkbox for template grouping should be checked by default.

It is recommended that you not change this option.

Argument is a boolean, default to true.

markWelcomesAsMinor

Defines if adding a welcome should be marked as a minor edit.

Argument is a boolean, default to true.

insertHeadings

Defines whether a heading is added to a welcome template that does not already contain one.

Argument is a boolean, default to true.

welcomeHeading

Defines what heading is to be added to welcome templates if insertHeadings is true and the welcome template has no heading.

Argument is a string, default to == Welcome ==.

insertUsername

Defines if your username should be added to the template, if the template supports it. Example: {{welcome|Ioeth}}.

Argument is a boolean, default to true.

insertSignature

Defines whether a signature (~~~~) is added after the welcome template if the template has no signature.

It is recommended that you not change this option.

Argument is a boolean, default to true.

quickWelcomeMode

Defines which quick welcome mode Friendly will operate in when welcoming a new user directly from a historical diff page. Automatic mode will add the template defined in the quickWelcomeTemplate variable to the user's talk page with no user intervention. Semi-automatic mode will load the user's talk page and then prompt you with the welcome template list as if you clicked the "welcome" tab.

The value of this argument must either be auto or semiauto.

Argument is a string, default to auto.

quickWelcomeTemplate

Defines which welcome template Friendly will use when welcoming a new user directly from a historical diff page.

The value of this argument must exactly match one of the templates available from the "welcome" tab on a user talk page. Do not include the curly braces, only the template name, and make sure the capitalization matches.

Argument is a string, default to Welcome.

maskTemplateInSummary

Defines whether Friendly will reference the specific template you used in the edit summary. This is useful if you do not want welcomed users to see that you welcomed them with {{welcomevandal}}, for instance.

Argument is a boolean, default to true.

markSharedIPAsMinor

Defines if adding a shared IP template should be marked as a minor edit.

Argument is a boolean, default to true.

watchTaggedPages

Defines if adding a tag should add a page to watchlist.

Argument is a boolean, default to true.

markTaggedPagesAsMinor

Defines if adding a tag should be marked as a minor edit.

Argument is a boolean, default to true.

Custom Parameters

customWelcomeList

Friendly's welcome functionality now supports custom welcome templates which are provided to the script by adding the customWelcomeList parameter to FriendlyConfig. This functionality is somewhat complex to set up, so it is not recommended for users that are inexperienced with JavaScript. If you require assistance, please post a message on the talk page and someone will most likely come along to help you out.

To add custom template functionality to your Friendly welcome screen, insert the following code to the end of your FriendlyConfig, making sure to place a comma at the end of the previous current line:

customWelcomeList:	[
				{
					label: '{{CustomWelcome}}: Custom welcome template description',
					value: 'CustomWelcome' },
				{
					label: '{{CustomWelcome}}: Custom welcome template description',
					value: 'CustomWelcome' }
			]

Simply replace "CustomWelcome" with the name of the template that you would like to add to the script and either remove or replace the description on the "label" line. This section of your configuration can be extended to include as many custom welcome templates as you would like. Make sure to use a comma to separate each element in the array while not including one after the last element.

customTagList

This feature is currently not implemented for Friendly's tagging functions, but will probably be coming soon.

Troubleshooting

After installing Friendly, new tabs will be added to the top of the page. If there aren't, try installing each script separately (copy from User:Ioeth/friendly.js). Remember, this script won't work unless you're using Firefox.

Userboxes

Friendly users may add these userboxes to their userpage.

This user welcomes new users with Friendly!	This user welcomes new users with Friendly!	{{wikify}} This user tags articles for maintenance with Friendly!
{{User:NASCAR Fan24/Userboxes/Friendly}}	{{User:NASCAR Fan24/Userboxes/Friendly2}}	{{User:NASCAR Fan24/Userboxes/Friendly3}}