WP:refToolbar

File:RefTools rework.ogv

RefToolbar refers to a series of JavaScript/jQuery scripts that help editors add citation templates to articles. It works in conjunction with the MediaWiki extension WikiEditor. The Reftoolbar implementation is scattered across several scripts (see, for example, this, this or this prefix search). The newest version, RefToolbar 2.0 is turned on by default for new users.

Originally an opt-in Wikipedia Gadget, Reftoolbar was moved to a site-wide script on February 25, 2011, and to an opt-out gadget in April 2014.See the "Proposal - Turn on RefTools gadget by default" discussion at Village pump (proposals) Archive 68.Implementation details for the default gadget It comes in two versions, depending on the settings at {{myprefs|3|Editor}}.

Versions

=VisualEditor =

Note that RefToolbar is not used in VisualEditor. If you are logged in and your toolbar looks like this:

{{wide image|VisualEditor toolbar-en.png|850px||alt=VisualEditor toolbar}}

File:WikiEditor-choosing_the_editor-en.png

then you are using the rich-text VisualEditor.

VisualEditor also has a similar Cite button, but this is NOT RefToolbar. It instead uses an autofilling citoid service. If you want to learn how to use that Cite menu, please refer to the VisualEditor user guide.

You can switch between visual editing and source editing (where RefToolbar is used) using the pencil icon.

= Default =

The default for all users, logged in or not, is WikiEditor or Wikitext Editor, that includes refToolbar 2.0.

Click on the version number for more information about each refToolbar implementation (Cite item on right in all them):

class="wikitable"

! Enable enhanced... !! RefToolbar
version !!style="width:400px;" |RefToolbar style !! Script

Off

RefToolbar 1.0

400px
Cite icon on right

MediaWiki:RefToolbarLegacy.js

|RefToolbar 2.0

50%
Cite menu item on right

MediaWiki:RefToolbar.js

In 2.0, clicking in the Cite menu, you can choose: the template ( {{tl|cite web}}, {{tl|cite news}}, {{tl|cite book}} or {{tl|cite journal}}, they are not automatically filled, so you must fill them ), named references and error check.

Table headings are abbreviations of the names seen at {{myprefs|Editing}}:

Enable enhanced... will say {{int:wikieditor-toolbar-preference}}.

The RefToolbar style column indicates the widget that activates the cite mechanism.

Before 2017, there were three versions of Refoolbar: 1.0, 2.0a and 2.0b. Version 2.0a was removed on June 14, 2017, since it was no longer needed.

Related scripts

MediaWiki:Gadgets-definition — this defines the module "ext.gadget.refToolbar" (loaded for everybody), responsible by loading the appropriated components of the RefToolbar, such as the module "ext.gadget.refToolbarBase"
MediaWiki:Gadget-refToolbar.js — this is the main script that generates the editing window and is where RefToolbar gets included
MediaWiki:Gadget-refToolbarBase.js — common variables and functions for all scripts
MediaWiki:RefToolbarMessages-en.js — English UI translations
MediaWiki:RefToolbarMessages-de.js — German UI translations
MediaWiki:RefToolbarConfig.js
[https://github.com/alexz-enwp/reftoolbar/blob/master/lookup.php toollabs:reftoolbar/lookup.php] Provides the autofill capability used to auto-complete forms based on ISBN, DOI, and PMID values.