Greasemonkey Manual:Monkey Menu: Difference between revisions

From GreaseSpot Wiki
Jump to navigationJump to search
(custom include and match entries are separately)
Line 41: Line 41:
* Enable or disable auto updating.
* Enable or disable auto updating.
* Manually check for updates now.
* Manually check for updates now.
* Add and remove custom include, @exclude, and @match entries.
* Add and remove custom @include, @exclude, and @match entries.
 
==== Custom entries ====
The custom entries are ''added'' into script, but not ''overwrite'' .
To overwrite default entries in script, you should enable ''only use these'' option.
 
Moreover, the custom @include and @match entries are separately,
so the ''only use these'' option of @match will not affect @include entry in script's meta block.
For example, if the script use <code>@include https://en.wikipedia.org/*</code> ,
the user custom ''match'' entry <code>https://wiki.greasespot.net/*</code> with ''only use these'' enabled
will not disable the script in <code>https://en.wikipedia.org/*</code> ,
because ''match'' will not overwrite ''include'' .

Revision as of 08:28, 12 December 2019


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

The Monkey Menu

Greasemonkey's "Monkey Menu"

As of Greasemonkey 4.0, the primary interface is through the "monkey menu", launched with the toolbar button. When enabled, the monkey is displayed in full color; when disabled, it is greyed out, and no user scripts will run.

The first item is a global enable/disable toggle for Greasemonkey as a whole. Disabling Greasemonkey with this control will stop all user script execution (on new pages).

Following this is a list of user scripts which are configured to run on this tab, if any, in alphabetical order by name. Enabled scripts display normally while disabled scripts will be greyed out. Below the scripts for this tab are listed, in the same manner, any remaining installed scripts. Click any script in this list to be brought to the script management view.

Beneath the script list is a shortcut for creating a new script, plus backup import and export items.

At the bottom several helpful links are also present.

The Script View

Script detail view

As mentioned above, all script management is also performed inside the monkey menu. Select any listed script in the main menu to open its detail view.

Here there are four options: toggle this script to be enabled (will run) or disabled (will not run), open the editor for this script, and uninstall this script. The fourth option opens a sub-menu for setting detailed options for this user script.

Finally, some of the user script's detailed information is displayed at the bottom. In this case: the description and currently installed version number, a link to the script home page, and the last time the script was (installed or) updated.

Script options view

Within a script's detailed options view you may:

  • Enable or disable auto updating.
  • Manually check for updates now.
  • Add and remove custom @include, @exclude, and @match entries.

Custom entries

The custom entries are added into script, but not overwrite . To overwrite default entries in script, you should enable only use these option.

Moreover, the custom @include and @match entries are separately, so the only use these option of @match will not affect @include entry in script's meta block. For example, if the script use @include https://en.wikipedia.org/* , the user custom match entry https://wiki.greasespot.net/* with only use these enabled will not disable the script in https://en.wikipedia.org/* , because match will not overwrite include .