Greasemonkey Manual:Monkey Menu

From GreaseSpot Wiki
Revision as of 12:26, 15 December 2007 by Marti (talk | contribs) (Moved heading levels down here)
Jump to navigationJump to search

Greasemonkey Manual
Using Greasemonkey
Installing Scripts
Monkey Menu
Getting Help
User Script Authoring
Editing
Environment
API

The Monkey

Early versions of Greasemonkey provided an image of a monkey in the status bar. Clicking on the monkey would toggle the global enabled status of Greasemonkey. When enabled, the monkey is displayed in color; when disabled, it is greyed out, and no user scripts will run.

The Menu

Greasemonkey's "Monkey Menu"

Later versions of Greasemonkey added a menu to this, and it was dubbed the monkey menu. This menu largely mirrors that menu which is available under the Tools menu.

The Manage User Scripts... menu item will open the manage dialog as described earlier. The New User Script... menu item is used to write a new user script, from scratch. It is described in more detail in the editing section of this manual.

Finally, the User Script Commands... sub-menu lists the menu items for individual scripts which have been added via the GM_registerMenuCommand API. The presence and/or contents (as well as the possible actions) of this sub-menu depend completely on which scripts you have installed. It is common for this sub-menu to be unavailable and greyed out.

In addition, though, this menu provides a list of the scripts whose include and exclude rules match the current page. Each script listed here functions as a checkbox control, and the scripts can be individually enabled or disabled by clicking on them here.

The monkey menu also adds a menu item to explicitly display, as well as control, the global enabled status.

Shortcuts

There are a few other "hidden" shortcuts in the monkey menu. First, a middle-click (your scroll wheel usually functions as a middle button, if your mouse has one) on the monkey icon will open the manage dialog. Second, a right-click on a script in the list will fire up your editor (see the edit button above) on the script that you clicked on.

These shortcuts (especially the latter) are designed for advanced users. However, if you can remember them, and have a need for them, they can be very handy!