Editing User:King of Herdaz/Toolbar customization

The editing toolbar is a versatile and very useful tool that can be used to make working on the wiki much easier. While the basic version (which is an option in your [[Special:Preferences#mw-prefsection-editing|preferences]]) has some use, the main benefit comes when you customize your toolbar. In this guide there are tested premade elements that you can use as well as guides to creating and modifying your own buttons, booklets, and dropdowns.

While modifying your toolbar can seem scary, once you get the hang of it, it really isn't a big deal. Also, anything you do can be easily undone so feel free to play around and experiment with different things. You do not need any knowledge of how the system works to use the premade elements on this page, simply copy-paste them into your toolbar and you are good to go.

== Basic ==
Before you can customize your toolbar you need to have the "Enable the editing toolbar" option in your [[Special:Preferences#mw-prefsection-editing|preferences]] enabled. Once you have done this you are ready to begin.

First, add the following to your <code>/common.js</code> page:

<pre>
//customize toolbar
var customizeToolbar = function() {
  /* Your code goes here */
</pre>

Followed by this:

<pre>
};
/* 
 * Check if view is in edit mode and that the required modules are available. Then, customize the toolbar...
 * Don't touch below this line!
 */
if (['edit', 'submit'].indexOf(mw.config.get('wgAction')) !== -1) {
  mw.loader.using('user.options').then(function() {
    // This can be the string "0" if the user disabled the preference ([[phab:T54542#555387]])
    if (mw.user.options.get('usebetatoolbar') == 1) {
      $.when(
        mw.loader.using('ext.wikiEditor'), $.ready
      ).then(customizeToolbar);
    }
  });
}
</pre>

You must place all modifications to the toolbar that you make between these two sections.

== Premade Elements ==
All of the pieces of code in this section have been tested extensively and are ready to be used as presented here. If you want to add one of these items simply copy-paste the code for that item into your <code>/common.js</code> page between the two [[#Basic]] sections to add it to your toolbar. 

To learn how the syntax works and how you can modify and create your own code for your toolbar see [[#Customization]].

=== Premade Buttons ===
Buttons are the simplest type of element in the toolbar. Buttons appear in the toolbar as icons that will perform one [[#Actions|action]] when it is clicked. Examples of buttons in the default toolbar configuration include the Bold button and the Italics button.

The buttons presented here will be added to the left side of the <code>main</code> section of your toolbar (which is the top row that is always showing).

==== Image template ====
Clicking this button will paste the {{t|image}} template onto the page, encapsulating your cursor or whatever you have highlighted.

For example, if you have <code><nowiki>Shallan.jpg</nowiki></code> highlighted when you press the button it will result in this: <code><nowiki>{{image|Shallan.jpg|side=|width=|caption}}</nowiki></code>

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding image template button to the "main" section
  $('#wpTextbox1').wikiEditor('addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
      "image": {
        label: 'Image template',
        type: 'button',
        icon: '//upload.wikimedia.org/wikipedia/commons/d/d8/Vector_toolbar_insert_image_button.png',
        action: {
          type: 'encapsulate',
          options: {
            pre:  '{' + '{image|',
            post: '|side=|width=|caption}}'
          }
        }
      }
    }
  });
</pre>
|}

==== Category ====
This button will paste <code><nowiki>[[Category:</nowiki></code> and <code><nowiki>]]</nowiki></code> around your highlighted text.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding category button to the "main" section
  $('#wpTextbox1').wikiEditor('addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
      "category": {
        label: 'Category',
        type: 'button',
        icon: '//upload.wikimedia.org/wikipedia/commons/2/2d/Button_clipboard_category.png',
        action: {
          type: 'encapsulate',
          options: {
            pre:  "[[Category: ",
            post: "]]"
          }
        }
      }
    }
  });
</pre>
|}

==== Wikipedia Link ====
This button will paste <code><nowiki>[[Wikipedia: </nowiki></code> and <code><nowiki>|]]</nowiki></code> around your highlighted text. This generates a link to that Wikipedia page and hides the prefix. For example, if you highlight <code>Brandon Sanderson</code> and click this button it will generate this: <code><nowiki>[[Wikipedia: Brandon Sanderson|]]</nowiki></code> which produces [[Wikipedia: Brandon Sanderson| Brandon Sanderson]] on the page.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //  Adding Wikipedia link button to the "main" section
  $('#wpTextbox1').wikiEditor('addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
      "wikipedia": {
        label: 'Wikipedia',
        type: 'button',
        icon: '//upload.wikimedia.org/wikipedia/commons/c/cb/Button_wikipedia.png',
        action: {
          type: 'encapsulate',
          options: {
            pre:  "[[Wikipedia: ",
            post: "|]]"
          }
        }
      }
    }
  });
</pre>
|}

==== Break Tag ====
Inserts <code><nowiki><br /></nowiki></code> into the page which is the preferred syntax on the Coppermind for creating line breaks.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding <br/> button to the "main" section
  $('#wpTextbox1').wikiEditor('addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
      "break": {
        label: 'Break tag',
        type: 'button',
        icon: '//upload.wikimedia.org/wikipedia/commons/1/13/Button_enter.png',
        action: {
          type: 'encapsulate',
          options: {
            pre:  '<' + 'br />',
          }
        }
      }
    }
  });
</pre>
|}

==== Simple Link ====
Simply encases the highlighted text within <code><nowiki>[[</nowiki></code> and <code><nowiki>]]</nowiki></code> to generate a normal link.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding link button to the "main" section
  $('#wpTextbox1' ).wikiEditor( 'addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
     "link": {
	label: 'Link',
	type: 'button',
	icon: '//upload.wikimedia.org/wikipedia/commons/9/97/Button_int_link.png',
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: "[[",
	    post: "]]"
	  }
	}
      }
    }
  });
</pre>
|}

==== Hidden Text ====
Encases the highlighted text between <code><nowiki><!--</nowiki></code> and <code><nowiki>--></nowiki></code> to prevent it from appearing in the viewable page.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding hidden text button to the "main" section
  $('#wpTextbox1' ).wikiEditor( 'addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
     "hidden": {
	label: 'Hidden text',
	type: 'button',
	icon: '//upload.wikimedia.org/wikipedia/commons/1/1b/Button_hide_wiki_tag.png',
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: "<!--",
	    post: "-->"
	  }
	}
      }
    }
  });
</pre>
|}

==== Columns ====
Encases your text, which should a bulleted (<code><nowiki>*</nowiki></code>) or numbered (<code><nowiki>#</nowiki></code>) list, inside of the {{t|columns}} template to columnize the list.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding columns button to the "main" section
  $('#wpTextbox1' ).wikiEditor( 'addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
     "columns": {
	label: 'Columns',
	type: 'button',
	icon: '//upload.wikimedia.org/wikipedia/commons/2/25/Vector_toolbar_bulleted_list_button.png',
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: '{' + '{columns|' + '\n',
	    post: '\n' + '}}'
	  }
	}
      }
    }
  });
</pre>
|}

==== <nowiki><code></nowiki> ====
Encases your highlighted text between <code><nowiki><code></nowiki></code> and <code><nowiki></code></nowiki></code>.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Adding a <code> button to the "main" section
  $('#wpTextbox1' ).wikiEditor( 'addToToolbar', {
    section: 'main',
    group: 'insert',
    tools: {
     "code": {
	label: 'Code',
	type: 'button',
	icon: '//upload.wikimedia.org/wikipedia/commons/2/23/Button_code.png',
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: '<' + 'code>',
	    post: '</' + 'code>'
	  }
	}
      }
    }
  });
</pre>
|}

=== Premade Dropdowns ===
Dropdowns are lists of options that drop down (hence the name) from the toolbar when your cursor passes over its spot on the toolbar. Each option, when clicked, performs an [[#Actions|action]] the same way buttons do. The list of headings on the left side of the default toolbar is an example of a dropdown.

The dropdowns presented here will be added to the <code>advanced</code> section of your toolbar on the right hand side.

==== Reference Templates ====
This dropdown contains a list of commonly used reference templates. When you click one of the options in this dropdown the selected reference template will be pasted into the page, encapsulating your cursor or whatever text you have highlighted.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //Add new references dropdown to the "advanced" section
  $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
	  section: 'advanced',
	  groups: {
		  list: {
			  tools: {
				  references: {
					  label: 'references',
					  type: 'select',
					  list: {
						  'book-ref': {
							  label: '{' + '{book ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{book ref|',
									  post: '}}'
								  }
							  }
						  },
						  'wob-ref': {
							  label: '{' + '{wob ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{wob ref|',
									  post: '}}'
								  }
							  }
						  },
						  'ref-plaintext': {
							  label: '{' + '{ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{ref|text=',
									  post: '}}'
								  }
							  }
						  },
						  'epigraph-ref': {
							  label: '{' + '{epigraph ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{epigraph ref|',
									  post: '}}'
								  }
							  }
						  },
						  'au-ref': {
							  label: '{' + '{au ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{au ref|',
									  post: '}}'
								  }
							  }
						  },
						  'msh-ref': {
							  label: '{' + '{msh ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{msh ref|',
									  post: '}}'
								  }
							  }
						  },
						  'tes-ref': {
							  label: '{' + '{tes ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{tes ref|',
									  post: '}}'
								  }
							  }
						  },
						  'file-ref': {
							  label: '{' + '{file ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{file ref|',
									  post: '}}'
								  }
							  }
						  },
						  'map-ref': {
							  label: '{' + '{map ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{map ref|',
									  post: '}}'
								  }
							  }
						  },
						  'url-ref': {
							  label: '{' + '{url ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{url ref|url=',
									  post: '|text=|date=|site=}}'
								  }
							  }
						  },
						  '17s-ref': {
							  label: '{' + '{17s ref}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{17s ref|topic/news/post',
									  post: '|id#|description|date=}}'
								  }
							  }
						  }
					  }
				  }
			  }
		  }
	  }
  } );
</pre>
|}

==== Build-a-Box ====
This dropdown helps you quickly and easily create {{t|character}} infoboxes. This dropdown, combined with next two dropdowns on this list, is very useful for creating new pages.

It contains <code><nowiki>{{character</nowiki></code> followed by a list of parameters commonly used in character infoboxes. Each parameter you click will be inserted on a new line.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //Add new build-a-box dropdown to the "advanced" section
  $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
	  section: 'advanced',
	  groups: {
		  list: {
			  tools: {
				  simplecharacterinfobox: {
					  label: 'build-a-box',
					  type: 'select',
					  list: {
						  'start': {
							  label: '{' + '{character',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '{' + '{character'
								  }
							  }
						  },
						  'residence': {
							  label: '|residence=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|residence='
								  }
							  }
						  },
						  'imageparam': {
							  label: '|image=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|image='
								  }
							  }
						  },
						  'profession': {
							  label: '|profession=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|profession='
								  }
							  }
						  },
						  '#profession': {
							  label: '|#profession=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|#profession='
								  }
							  }
						  },
						  'skills': {
							  label: '|skills=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|skills='
								  }
							  }
						  },
						  'species': {
							  label: '|species=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|species='
								  }
							  }
						  },
						  'abilities': {
							  label: '|abilities=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|abilities='
								  }
							  }
						  },
						  'ethnicity': {
							  label: '|ethnicity=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|ethnicity='
								  }
							  }
						  },
						  'born': {
							  label: '|born=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|born='
								  }
							  }
						  },
						  'died': {
							  label: '|died=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|died='
								  }
							  }
						  },
						  'nationality': {
							  label: '|nationality=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|nationality='
								  }
							  }
						  },
						  'bonded': {
							  label: '|bonded=',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|bonded='
								  }
							  }
						  }
					  }
				  }
			  }
		  }
	  }
  } );
</pre>
|}

==== Infobox Endings ====
This dropdown contains a list of buttons that insert the last three lines of an infobox for you. There is one button for each series/world. This goes hand in hand with the previous dropdown on this list as once you are finished with that step you simply click the relevant option from this dropdown and then you are done with the infobox.

With the exception of the <code>Skyward</code> option, all of the options in this dropdown paste the <code>world=</code>, <code>universe=</code>, and <code>books=</code> parameters onto the page on separate lines and fill them with the relevant information followed by <code>}}</code>. With the <code>Skyward</code> option, due to the fact that the [[Skyward (series)|Skyward series]] takes place on multiple worlds, the <code>world=</code> parameter is left empty and your cursor is placed after that parameter so you can fill it with the relevant world's name.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //Add new infobox endings dropdown to the "advanced" section
  $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
	  section: 'advanced',
	  groups: {
		  list: {
			  tools: {
				  endings: {
					  label: 'ends',
					  type: 'select',
					  list: {
						  'sa': {
							  label: 'Stormlight',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Roshar' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[The Stormlight Archive]]' + '\n' + '}}'
								  }
							  }
						  },
						  'mbe1': {
							  label: 'MB Era 1',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Scadrial' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[Mistborn Era 1]]' + '\n' + '}}'
								  }
							  }
						  },
						  'mbe2': {
							  label: 'MB Era 2',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Scadrial' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[Mistborn Era 2]]' + '\n' + '}}'
								  }
							  }
						  },
						  'wb': {
							  label: 'Warbreaker',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Nalthis' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[Warbreaker]]' + '\n' + '}}'
								  }
							  }
						  },
						  'ela': {
							  label: 'Elantris',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Sel' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[Elantris (book)|Elantris]]' + '\n' + '}}'
								  }
							  }
						  },
						  'alc': {
							  label: 'Alcatraz',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|earth=Alcatraz' + '\n' + '|books=[[Alcatraz Versus the Evil Librarians (series)|Alcatraz Versus the Evil Librarians]]' + '\n' + '}}'
								  }
							  }
						  },
						  'ws': {
							  label: 'White Sand',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=Taldain' + '\n' + '|universe=[[Cosmere]]' + '\n' + '|books=[[White Sand]]' + '\n' + '}}'
								  }
							  }
						  },
						  'skyward': {
							  label: 'Skyward',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '|world=',
									  post: '\n' + '|universe=[[Cytoverse]]' + '\n' + '|books=[[Skyward (series)]]' + '\n' + '}}'
								  }
							  }
						  }
					  }
				  }
			  }
		  }
	  }
  } );
</pre>
|}

==== Page Endings ====
This dropdown follows the previous two on this list and makes the rest of page creation quick and easy. After selecting the relevant option from the Infobox Ends dropdown simply click the first three items in this dropdown followed by the relevant completion template and navbar template. Everything is inserted with the proper spacing and all that is left for you to do is to write the text of the article.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //Add new page ends dropdown to the "advanced" section
  $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
	  section: 'advanced',
	  groups: {
		  list: {
			  tools: {
				  bottoms: {
					  label: 'bottoms',
					  type: 'select',
					  list: {
						  'pagename': {
							  label: '{' + '{SUBST:PAGENAME}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '\'\'\'{' + '{SUBST:PAGENAME}}\'\'\''
								  }
							  }
						  },
						  'notes': {
							  label: '== Notes ==',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n\n' + '== Notes =='
								  }
							  }
						  },
						  'refsection': {
							  label: '<' + 'references/>',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '<' + 'references />'
								  }
							  }
						  },
						  'stub': {
							  label: '{' + '{stub}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{stub}}'
								  }
							  }
						  },
						  'partial': {
							  label: '{' + '{partial}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{partial}}'
								  }
							  }
						  },
						  'complete': {
							  label: '{' + '{complete}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{complete}}'
								  }
							  }
						  },
						  'alcatraz': {
							  label: '{' + '{Alcatraz}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Alcatraz}}'
								  }
							  }
						  },
						  'elantris': {
							  label: '{' + '{Elantris}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Elantris}}'
								  }
							  }
						  },
						  'mbera1': {
							  label: '{' + '{Mistborn|Era 1}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Mistborn|Era 1}}'
								  }
							  }
						  },
						  'mbera2': {
							  label: '{' + '{Mistborn|Era 2}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Mistborn|Era 2}}'
								  }
							  }
						  },
						  'reckoners': {
							  label: '{' + '{Reckoners}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Reckoners}}'
								  }
							  }
						  },
						  'sky': {
							  label: '{' + '{Skyward}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Skyward}}'
								  }
							  }
						  },
						  'storm': {
							  label: '{' + '{Stormlight}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Stormlight}}'
								  }
							  }
						  },
						  'warbreaker': {
							  label: '{' + '{Warbreaker}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{Warbreaker}}'
								  }
							  }
						  },
						  'whitesand': {
							  label: '{' + '{White Sand}}',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: '\n' + '{' + '{White Sand}}'
								  }
							  }
						  }
					  }
				  }
			  }
		  }
	  }
  } );
</pre>
|}

=== Premade Booklets ===
A <code>booklet</code> is a type of section within the editing toolbar. Unlike a <code>toolbar</code> section which can contain buttons and dropdowns, booklet section instead contain <code>pages</code>. The <code>Special characters</code> and <code>Help</code> sections of the default toolbar are examples of booklets.

Booklets and dropdowns perform similar functions and which of the two you choose to use is mainly a matter of personal preference.

This premade booklet section contains four pages, each of which corresponds to one of the sample dropdowns in the previous section:

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
//add new section to editing toolbar
 $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
  'sections': {
    'useful-stuff': {
      'type': 'booklet',
      'label': 'Useful Stuff',
      'pages': {
        //Page of commonly used reference templates
        'section-refs': {
          'label': 'References',
          'layout': 'characters',
          'characters': [
            '{' + '{book ref|}}',
            '{' + '{wob ref|}}',
            '{' + '{ref|text=}}',
            '{' + '{epigraph ref|}}',
            '{' + '{au ref|}}',
            '{' + '{msh ref|}}',
            '{' + '{tes ref|}}',
            '{' + '{file ref|}}',
            '{' + '{map ref|}}',
            //These next two reference templates are very long so they are done differently
            {
              'action': {
                'type': 'encapsulate',
		   options: {
		     pre: '{' + '{url ref|url=',
		     post: '|text=|date=|site=}}'
                }
              },
              'label': '{' + '{url ref}}'
            },
            {
              'action': {
                'type': 'encapsulate',
		   options: {
		     pre: '{' + '{17s ref|topic/news/post',
		     post: '|id#|description|date=}}'
                }
              },
              'label': '{' + '{17s ref}}'
            },
          ]
        },
        //Page to quickly build character infoboxes
        'section-Build-a-Box': {
          'label': 'Build-a-Box',
          'layout': 'characters',
          'characters': [
            '{' + '{character',
            '\n' + '|image=',
            '\n' + '|residence=',
            '\n' + '|profession=',
            '\n' + '|#profession=',
            '\n' + '|species=',
            '\n' + '|abilities=',
            '\n' + '|ethnicity=',
            '\n' + '|born=',
            '\n' + '|died=',
            '\n' + '|nationality=',
            '\n' + '|residence=',
          ]
        }, 
        //Page of infobox endings
        'section-end': {
          'label': 'Endings',
          'layout': 'characters',
          'characters': [
            '\n' + '|world=Scadrial',
            '\n' + '|world=Roshar',
            '\n' + '|world=Nalthis',
            '\n' + '|world=Taldain',
            '\n' + '|earth=Alcatraz',
            '\n' + '|universe=[[Cosmere]]',
            '\n' + '|books=[[Mistborn Era 1]]',
            '\n' + '|books=[[Mistborn Era 2]]',
            '\n' + '|books=[[The Stormlight Archive]]',
            '\n' + '|books=[[Warbreaker]]',
            //Alcatraz is very long so it has to be done differently
            {
              'action': {
                'type': 'encapsulate',
                'options': {
                  'pre': '\n' + '|books=[[Alcatraz Versus the Evil Librarians (series)|Alcatraz Versus the Evil Librarians]]'
                }
              },
              'label': '|books=Alcatraz'
            },
          ]
        }, 
        //Page of stuff to finish a page after making the infobox
        'section-bottom': {
          'label': 'Bottom of Page',
          'layout': 'characters',
          'characters': [
	    '\n' + '\'\'\'{' + '{SUBST:PAGENAME}}\'\'\'',
            '\n\n' + '== Notes ==',
            '\n' + '<' + 'references/>',
            '\n' + '{' + '{stub}}',
            '\n' + '{' + '{partial}}',
            '\n' + '{' + '{complete}}',
            '\n' + '{' + '{Alcatraz}}',
            '\n' + '{' + '{Elantris}}',
            '\n' + '{' + '{Mistborn|Era 1}}',
            '\n' + '{' + '{Mistborn|Era 2}}',
            '\n' + '{' + '{Reckoners}}',
            '\n' + '{' + '{Skyward}}',
            '\n' + '{' + '{Stormlight}}',
            '\n' + '{' + '{Warbreaker}}',
            '\n' + '{' + '{White Sand}}',
          ]
        }
      }
    }
  }
 });
</pre>
|}

== Customization==
In this section we will present a guide to creating your own buttons, booklets and dropdowns for your toolbar. While there are other options and ways to do these things, for the sake of clarity and simplicity here we have limited this guide to the things that are the most useful and easiest to understand. For a more complete (though less clear) guide to the toolbar see [https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization Mediawiki's full guide].

=== General Guidelines ===
Here are some rules and tips for writing code on for your toolbar:

* If you are having trouble, look at the example elements presented above and use them as a guide. Or simply copy one of the sample elements and modify it following the steps presented in this guide.
* You should not reuse internal names within your entire toolbar. If you use the same internal name multiple times then either strange things will happen or the toolbar will simply break.
* To add a comment put <code>//</code> at the beginning of a line followed by the text of the comment. Whatever you write after a <code>//</code> will not affect your code.

* Inserting <code>' + '</code> between two pieces of text can have effects on your <code>common.js</code> page (as will be discussed below), but will not appear on a page when the action is called. For example, both <code><nowiki><br /></nowiki></code> and <code><nowiki><' + 'br /></nowiki></code> will produce the same result (<code><nowiki><br /></nowiki></code>) on the page when they are called.
* When writing out templates, whether for a label or an action, you must insert <code>' + '</code> between the first two curly brackets. For example, instead of writing <code><nowiki>{{Stormlight}}</nowiki></code> you should write <code><nowiki>{' + '{Stormlight}}</nowiki></code>. This prevents the template from applying categories to your <code>common.js</code> page and also prevents it from being listed on the relevant template's list of pages that use it.
* For the same reason you must also do this when writing category tags. For example, instead of writing <code><nowiki>[[Category: Stormlight]]</nowiki></code> you should write <code><nowiki>[' + '[Category: Stormlight]]</nowiki></code>.
* When writing code for substitutions this is even more important, since if you do not do it then the substitution will be performed when you save your <code>common.js</code> page. For example, instead of writing <code><nowiki>{{SUBST:PAGENAME}}</nowiki></code> you should write <code><nowiki>{' + '{SUBST:PAGENAME}}</nowiki></code>.

==== Actions ====
While there are other types of actions that you can do, in this guide we focus on the <code>encapsulate</code> action as it is the easiest to understand and use. This action pastes one snippet of text before the highlighted text (or you cursor) and a second snippet after the highlighted text. The second snippet (<code>post:</code>) can be deleted if you only want to insert one snippet of text.

The code for this action is as follows, and this format is the same for dropdowns, booklets and buttons.

<pre>
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: 'XXXX',
	    post: 'YYYY'
</pre>

<code>XXXX</code> is replaced by the snippet that goes before the highlighted text/cursor, and <code>YYYY</code> is replaced by the snippet that goes after the highlighted text/cursor.

* To have an action include a line break insert <code>\n</code> into the snippet at the place you want it to be. For stylistic reasons some people will put <code>' + '</code> between instances of <code>\n</code> and other text in their snippets, but this does not have any effect on the output of the action and can be omitted if you want.
* To have an action include an apostrophe (<code>'</code>) within the text that it inserts, place <code>\'</code> into your code at the place you want the apostrophe to go. If you do not include the backslash (<code>\</code>) and type additional apostrophes in your code it will cause the toolbar to break.

=== Creating Your Own Buttons ===
To create your own button paste the code at the end of this section into your <code>/common.js</code> page between the two [[#Basic]] sections and change the following things:

* Replace <code>AAAA</code> with the name of the section you would like to put the button. Unless you are adding new [[#Sections|sections]] to the toolbar this should be either <code>main</code> or <code>advanced</code>.
* Replace <code>BBBB</code> with the name of the part of that section where you would like your button to go. If it will be in the <code>main</code> section this should be <code>format</code> (though <code>insert</code> can also work). If it will be in the <code>advanced</code> section then this can be either <code>heading</code>, <code>format</code> (this will work best and is recommended), <code>size</code>, or <code>insert</code>.
* Replace <code>CCCC</code> with what you want to name the button internally. The text that you put here does not actually affect anything and only matters for stylistic purposes.
* Replace <code>DDDD</code> with what you want to name the button. Unlike the previous item, this actually makes a difference. The text you put here will be shown when you hover your cursor over this button's icon on your toolbar.
* Replace <code>EEEE</code> with a link to the file that you would like to use as the icon for your button. This needs to be a full link starting after  <code>https:</code>. For example, you can use <code>//upload.wikimedia.org/wikipedia/commons/2/23/Button_code.png</code>. While you can use any file as your icon it is recommended that you use one of the icons listed on Mediawiki's [https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_icons list of toolbar icons] since they are all of a size and shape that works.
* Replace <code>FFFF</code> and <code>GGGG</code> as you would with any other [[#Actions|action]].

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  // Optional Description
  $('#wpTextbox1' ).wikiEditor( 'addToToolbar', {
    section: 'AAAA',
    group: 'BBBB',
    tools: {
     "CCCC": {
	label: 'DDDD',
	type: 'button',
	icon: 'EEEE',
	action: {
	  type: 'encapsulate',
	  options: {
	    pre: 'FFFF',
	    post: 'GGGG'
	  }
	}
      }
    }
  });
</pre>
|}

=== Creating Your Own Dropdowns ===
To start add this code into your <code>/common.js</code> page between the two [[#Basic]] sections and change the following things:
* If you have created a new [[#Adding Sections|section]] in your toolbar and want to put your dropdown to go there then change <code>AAAA</code> to the name of your section, otherwise replace it with <code>advanced</code>.
* Replace <code>BBBB</code> with the internal name for the dropdown.
* Replace <code>CCCC</code> with the name for the dropdown that will be displayed on the page.
Repeat the following steps for each item you add to your dropdown:
* Replace <code>WWWW</code> with the internal name for the item
* Replace <code>XXXX</code> with the display name for the item. This is how it will appear on the list.
* Replace <code>YYYY</code> and <code>ZZZZ</code> as you would with any other [[#Actions|action]].

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
//Optional description
  $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
	  section: 'AAAA',
	  groups: {
		  list: {
			  tools: {
				  BBBB: {
					  label: 'CCCC',
					  type: 'select',
					  list: {
						  'WWWW': {
							  label: 'XXXX',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: 'YYYY',
									  post: 'ZZZZ'
								  }
							  }
</pre>
Insert your additional items here
<pre>
						  }
					  }
				  }
			  }
		  }
	  }
  } );
</pre>
|}

For each item you want to add to the dropdown add the following code into the space indicated above and change the <code>WWWW</code>, <code>XXXX</code>, <code>YYYY</code>, and <code>ZZZZ</code> as you did for the first action in the list.

{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
						  },
						  'WWWW': {
							  label: 'XXXX',
							  action: {
								  type: 'encapsulate',
								  options: {
									  pre: 'YYYY',
									  post: 'ZZZZ'
								  }
							  }
</pre>
|}

=== Creating Your Own Booklets ===
Here we will tell you how to create booklets that contain pages of characters (which can also be [[#Actions]]). For other things you can do with booklets see [https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization Mediawiki's guide].

Booklets and dropdowns perform similar functions and which of the two you choose to use is mainly a matter of personal preference.

To create a new booklet section add the following code to your <code>/common.js</code> page:

<pre>
//Optional description
 $( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
  'sections': {
    'AAAA': {
      'type': 'booklet',
      'label': 'BBBB',
      'pages': {
</pre>

Followed by this:

<pre>
      }
    }
  }
 });
</pre>

Pages you create for this booklet section will go between these two sections of code.

==== Pages ====
To create a new page for a booklet insert the following code 
<pre>
	//Optional description
        'section-CCCC': {
          'label': 'DDDD',
          'layout': 'characters',
          'characters': [
</pre>

Place the characters you want in this page here followed by this:

<pre>
          ]
        },
</pre>

=== Removing default elements ===
This can be a little tricky since in order to remove an element you need to know what it is named. To find the name you will have to comb through the page source or look through [https://phabricator.wikimedia.org/diffusion/EWED/browse/master/modules/jquery.wikiEditor.toolbar.config.js the code for the default version].

Fortunately, the names of many of the elements are known. Here are premade snippets of code for many of the elements in the default toolbar. Paste any one of them into your <code>Common.js</code> page within the two [[#Basic]] sections to remove that element.

==== <nowiki><ref></nowiki> Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //Remove the default <ref> button
   $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
 	  'section': 'main',
 	  'group': 'insert',
 	  'tool': 'reference'
   });</pre>
|}

==== Bulleted List Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove the bulleted list button
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'advanced',
        'group': 'format',
        'tool': 'ulist'
  });</pre>
|}

==== Numbered List Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove the numbered list button
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'advanced',
        'group': 'format',
        'tool': 'olist'
  });</pre>
|}

==== Default Break Tag Button (<nowiki><br></nowiki>) ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove the default <br> button (to replace it with a <br/> button which is preferred on the Coppermind)
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'advanced',
        'group': 'format',
        'tool': 'newline'
  });</pre>
|}

==== Table Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove table button
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'advanced',
        'group': 'insert',
        'tool': 'table'
  });</pre>
|}

==== <nowiki>[[File:]]</nowiki> Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove File button
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'main',
        'group': 'insert',
        'tool': 'file'
  });</pre>
|}

==== Fancy Link Button ====
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  //remove original link button
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'main',
        'group': 'insert',
        'tool': 'link'
  });</pre>
|}

==== Others ====
For elements not on this list take this code and replace <code>XXXX</code> with the name of the section the element is in, replace <code>YYYY</code> with the name of the group the element is part of, and replace <code>ZZZZ</code> with the name of the element. You can find these names by looking through [https://phabricator.wikimedia.org/diffusion/EWED/browse/master/modules/jquery.wikiEditor.toolbar.config.js the code for the default version].
{| class="mw-collapsible mw-collapsed" width=100%
|-
|
|-
|
<pre>
  $( '#wpTextbox1' ).wikiEditor( 'removeFromToolbar', {
        'section': 'XXXX',
        'group': 'YYYY',
        'tool': 'ZZZZ'
  });</pre>
|}