User:Subh83/JavaScriptTools/RightclickMenus

Look inside individual scripts used by this utility: Entry Point: Individual menus: Libraries used: Auxiliary files:
 * User:Subh83/JavaScriptTools/RightclickMenus.js
 * User:Subh83/JavaScriptTools/selectRightclickMenu.js
 * User:Subh83/JavaScriptTools/refRightclickMenu.js
 * User:Subh83/JavaScriptTools/textareaRightclickMenu.js
 * User:Subh83/JavaScriptTools/RightclickMenus_maintain.js
 * User:Subh83/JavaScriptTools/utilsCommunications.js
 * User:Subh83/JavaScriptTools/utilsDOMdynamics.js
 * User:Subh83/JavaScriptTools/utilsMenu.js
 * User:Subh83/JavaScriptTools/utils1.js
 * User:Subh83/JavaScriptTools/Menus.css
 * User:Subh83/JavaScriptTools/SymbolsAndMarkups

More details at User:Subh83/Javascripts.

= Description =

Adds right-click menus to different components on a Wikipedia page. See the "Menus" section below for description of the individual menus.

The scripts have been tested on Google Chrome and Firefox browsers.

If you found this tool useful, and would like further development of this, please leave a comment in the talk page indicating that.

= Installation =

In the page User:/common.js  add the following line: importScript('User:Subh83/JavaScriptTools/RightclickMenus.js');

Using ctrl, shift or alt key along with right-click to show menu
Just before the  line, you can set the variable   to one of the values from ,   or   to enforce pressing the corresponding key for the right-click menu to appear. For example, var RightClickMenuKey = 'ctrl';

Using different CSS styles for the menus & floating panels
The default CSS style sheet used for the menus and floating panels is User:Subh83/JavaScriptTools/Menus.css. You can use your own style sheet by setting the value of the  javascript variable. For example, right before the  line, you can add, var FloatingMenusStyleFile = "User:/myMenuStyles.css";

Customize contents of "Insert symbols & markups" panel
See below.

= Menus =

Below is a description of all the menus currently available through this script.

Selected text Right-click menu


The menu appears when you right-click on a selected text on a Wikipedia page.

Currently, available items in this menu:
 * Edit this text: Opens edit box/form with the corresponding wiki-text highlighted. Useful when the section you are editing is long and hence it's difficult to locate the particular portion of the text you are trying to edit. This works with the secedit script as well.
 * Trace history on WikiBlame: Search WikiBlame for tracing the origin of the selected text. (opens in a pop-up window - so pop-up shouldn't be blocked in the browser.)
 * Search Google for this text: Searches Google with the selected text and opens results in a new window.

References Right-click menu


The menu appears when you right click on a reference on a Wikipedia page (one like [1] ).

Currently available items in this menu:
 * Name and summery of the reference.
 * A list of external links in the reference as it appears in the bibliography (created using 'reflist' template).

Textarea Right-click menu


The menu appears when you right-click on a textarea (edit box) when editing the wikitext.

Currently available items in this menu:
 * Trace history on WikiBlame: Search WikiBlame for tracing the origin of the selected text. (opens in a pop-up window - so pop-up shouldn't be blocked in the browser.)
 * Insert symbols & markups: Opens up a floating dragable panel containing various markups and special characters that can be inserted in the textarea.
 * Search Google for this text: Searches Google with the selected text and opens results in a new window.

Customizing the contents of "Insert symbols & markups" panel


The floating panel with symbol & markups is highly customizable. By default it uses a list of symbols from User:Subh83/JavaScriptTools/SymbolsAndMarkups.

You can use a different symbols & markup list to create your own custom panel contents. For doing this, you'll need to set the  javascript variable to point to the file/page of your choice. The page above with the default list describes the syntax.

For example, you can add the following line of code before the  line in your   file var FloatingMovableMenuSource = "User:/myCustomSymbolsAndMarkups";

= Troubleshoot =

FAQs
Q: I changed the  variable or changed the contents of the Markup & Symbols page. But the changes are not showing up. Q: I have set some of the customization variable, but the change is not showing.
 * Make sure you have set the variable before the  line.
 * Also, refresh your browser's cache. See Bypass_your_cache and follow the instructions under completely clear the cache section.

Q: "Edit this text" menu item not working.
 * Make sure that cookies are enables in your browser.

Q: WikiBlame is not working.
 * Make sure pop-up windows from wikipedia.org are not blocked by your browser

Q: I use Internet Explorer. The script does not work for me. Q: When I click "edit this text" I get an error message "Sorry, the wiki-text could not be located...".
 * See the "known issues" below.

Known Issues

 * The script does not work well with Internet Explorer browser. It has been tested in Google Chrome and Firefox browsers.
 * The "Edit this text" menu item uses several heuristics to locate the corresponding wiki-texts and highlight that upon opening the edit-box. While it works for most cases, there can be situations when the script will fail to do so. This happens more if parts of the selected text is created using some template.

Discussions, Suggestions, Feature requests and Bug reports
Please use the talk page.

= For developers =

There are a host of useful javascript utilities I have written up while working on this project. You can find a complete list at User:Subh83/Javascripts.

= Upcoming features =


 * Native Javascript version of Wikiblame to be added.
 * Page statistics menu item.