Changes between Version 40 and Version 41 of Help/Preferences/Plugins


Ignore:
Timestamp:
2020-02-21T14:52:12+01:00 (6 years ago)
Author:
Hb---
Comment:

Links in headers trash the page display in the JOSM Help Browser, please check by yourself. Also a link to /Help/Preferences would contradict the tree structure. This register is only accessible from the Preferences dialog. The page for that dialog is at /Help/Action/Preferences. It is already listed as target in the "Back to" footer.

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Plugins

    v40 v41  
    33
    44= [wikitr:/Help/Preferences Preferences] > Plugins =
    5 Plugins extend the core functionality of JOSM. The [wikitr:/Plugins list of JOSM plugins] explains which plugins are available and with what kind of functionality they extend JOSM.   
     5Configure available plugins.
     6This register of the Preferences dialog has two tabs to [#Plugins install plugins] and to configure the policy [#PluginUpdatePolicy automatic updates].
    67
    7 Most JOSM users don't work with the bare JOSM core only. They usually install several plugins.
     8Plugins can extend the core functionality of JOSM.
     9The list [wikitr:/Plugins Plugins for JOSM] shows the official plugins and their kinds of functionality.
     10It is common that users install some plugins.
    811
    9 **Please, install only the plugins you need.** Plugins will probably rise the chance of code errors and some combinations might even not been tested.
    10 
    11 == Automatic installation via Preferences menu ==
     12== Plugins == #Plugins
     13{{{#!comment
     14Do we need the section below?
     15We already are in the appropriate subsection of the Preferences dialog!
     16}}}
     17=== Automatic installation via Preferences menu ===
    1218Common steps:
    13191. Launch the [[Image(source:/trunk/images/preference.png,16,middle)]] **Preferences** dialog.
    14201. Select the tab [[Image(source:trunk/images/preferences/plugin.png,16,middle)]] **Plugins**.
    1521
    16 === Installing plugins ===
     22==== Installing plugins ====
    17231. (Optionally) Click on [[Image(source:trunk/images/download.png,16,middle)]] **Download list** to download the list of available plugins (if nothing was shown).
    18 1. (Optionally) Use the checkboxes and the text field on top to filter the list.
     241. (Optionally) Use the checkboxes and the Search text field on top to filter the list.
    19251. Tick the checkbox for every plugin you want to install.
    20261. Click on  **OK**.
    2127
    2228JOSM will download and install the plugins.\\
    23 Some plugins require a restart of JOSM, you will be prompted if you need to.
     29Some plugins require a restart of JOSM to get fully installed.
     30A confirmation will appear if needed.
    2431
     32||  [#TextFilter Filter by text]  ||\
     33||  [#List Plugin list]  ||\
     34||  [#StatusFilter Filter by status]  ||
     35|||||| [[Image(PreferencesPluginsPlugins.png,link=​)]] ||
     36||  Reload list \\ data from server  ||\
     37||  Update the selected \\ plugins manually  ||\
     38||  Only visible in \\ [wikitr:/Help/ExpertMode Expert access]  ||
     39
     40Please, install only the plugins you need.
     41Plugins will probably rise the chance of code errors and some combinations might even not been tested.
     42As a plugin could be a file from ''Somewhere in the Internet'' keep the security related issues in mind.
     43
     44
     45=== Manual installation ===
     46==== Manually installing plugins ====
     47If a manual installation is really needed, you can put the .jar files in the `plugins` directory under JOSM [wikitr:/Help/Preferences#JOSMpreferencedatacachedirectories user-data] directory.
     48Now restart and the plugins should show up in the plugin list.
     49Tick the checkboxes of these manually placed plugins for finally insstalling them.
     50
     51
     52== Plugin update policy == #PluginUpdatePolicy
    2553=== Updating plugins === #AutomaticUpdate
    2654On start-up, JOSM attempts to update the plugins
    … …  
    3462Select **Do not ask again and remember my decision** if JOSM should always try the selected action without asking for confirmation. If you select this checkbox, JOSM won't display this dialog anymore.
    3563
    36 
    37 == Plugin update policy ==#PluginUpdatePolicy
    38 [[Image(plugin_update_policy_preferences_macOS.png)]]
     64[[Image(plugin_update_policy_preferences.png)]]
    3965
    4066* Select the radio button **Ask before updating** if JOSM shall ask before updating plugins in version and/or time-based update mode.
    … …  
    4369
    4470The interval in days for the **time based updated mode** can be set below the radio buttons (''default=30'').
    45 
    46 
    47 == Manual installation ==
    48 In most cases, users don't need to do this.
    49 
    50 === Manually installing plugins ===
    51 If the automatic way does not work, you can install plugins manually by putting the .jar files in the **plugins** directory under {{{josm}}} directory.
    52 
    53 {{{josm}}} location is explained under Preferences, see [wikitr:/Help/Preferences#JOSMpreferencedatacachedirectories JOSM preference/data/cache directories].
    54 
    55 Now restart JOSM and the plugins should show up in the plugin list under **''Edit -> Preferences -> [[Image(source:trunk/images/preferences/plugin.png,16,middle)]] [wikitr:/Help/Preferences/Plugins Plugins]''**.[[BR]]
    56 Activate the Plugins, click on [[Image(source:/trunk/images/ok.png,16,middle)]] **OK** to save the preferences and restart JOSM once more.
    5771
    5872=== Manually updating plugins ===
    … …  
    6680
    6781
    68 == See also ==
    69 * [wikitr:/Plugins List of JOSM plugins]
     82=== See also ===
     83* [wikitr:/Plugins Plugins for JOSM] as list
    7084* [wikitr:/Help/Plugins Plugin Help]
     85* [wikitr:/Help/Preferences Preferences Overview]
    7186
    7287----