Changes between Version 15 and Version 51 of Help/Preferences/Plugins


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Plugins

    v15 v51  
    11[[TranslatedPages]]
    2 = Preferences > Plugins=
     2[[PageOutline(2-10,Table of contents)]]
    33
    4 Plugins extend the core functionality of JOSM. The list of JOSM plugins explains which plugins are available and with what kind of functionality they extend JOSM.   
     4= Preferences > Plugins =
     5[[JOSMImage(preferences/plugin,48,link=,middle,margin-right=20,margin-bottom=10)]] **Configure available plugins.** \\
     6This register of the Preferences dialog has two tabs to [#Plugins install plugins] and to configure the policy [#PluginUpdatePolicy automatic updates].
    57
    6 Most JOSM users don't work with the bare JOSM core only. They usually install at a set of at least 3-5 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.
    711
    8 '''Note:''' Please, install only the plugins you need. Plugins will probably rise the chance of code errors and some combinations might even not been tested.
    9 Installing plugins
     12== Installing plugins ==#Plugins
     131. (Optionally) Click on [[JOSMImage(download)]] **Download list** to download the list of available plugins (if nothing was shown).
     141. (Optionally) Use the checkboxes and the Search text field on top to filter the list.
     151. Tick the checkbox for every plugin you want to install.
     161. Click on  **OK**.
    1017
    11 == Installing plugins ==
     18JOSM will download and install the plugins.\\
     19Some plugins require a restart of JOSM to get fully installed.
     20A confirmation will appear if needed.
    1221
    13  1. Launch the [[Image(source:/trunk/images/preference.png,15)]] '''Preferences''' dialog. (''F12'')
    14  2. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] '''Plugins'''.
    15  3. Click on [[Image(source:trunk/images/download.png,15)]] '''Download list''' to download the list of available plugins.
    16  4. Tick the checkbox for every plugin you want to install.
    17  5. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] '''Update plugins'''.
     22||  [#TextFilter Filter by text]  ||\
     23||  [#List Plugin list]  ||\
     24||  [#StatusFilter Filter by status]  ||
     25|||||| [[Image(PreferencesPluginsPlugins.png,link=​)]] ||
     26||  Reload list \\ data from server  ||\
     27||  Update the selected \\ plugins manually  ||\
     28||  Only visible in \\ [wikitr:/Help/ExpertMode Expert mode]  ||
    1829
    19 JOSM will download and install the plugins. You have to restart JOSM to '''load and activate''' the newly downloaded plugins.
     30Please, install only the plugins you need.
     31Plugins will probably rise the chance of code errors and some combinations might even not been tested.
     32As a plugin could be a file from ''Somewhere in the Internet'' keep the security related issues in mind.
    2033
    21 == Manually updating plugins ==
    22  1. Launch the [[Image(source:trunk/images/preference.png,15)]] '''Preferences''' dialog. (''F12'')
    23  2. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] '''Plugins'''
    24  3. Click on [[Image(source:trunk/images/download.png,15)]] '''Download list''' do download the list of available plugins
    25  4. Tick the checkbox for every plugin you want to update
    26  5. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] '''Update plugins'''
     34=== Manual installation ===
     35If 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.
     36Now restart and the plugins should show up in the plugin list.
     37Tick the checkboxes of these manually placed plugins for finally installing them.
    2738
    28 JOSM will download and install the most recent version of the selected plugins. You have to restart JOSM to '''load and activate''' the newly downloaded plugins.
    2939
    30 == Automatically updating plugins == #AutomaticUpdate
    31 JOSM checks at startup whether the currently active plugins should be updated. JOSM attempts to update the plugins
    32 * if JOSM itself has been updated since the last plugin update. This is called the '''version based update mode'''.
    33 * if a certain periode of time has elapsed since the last plugin update. This is called the '''time based updated mode'''.
     40== Plugin update policy == #PluginUpdatePolicy
     41=== Updating plugins === #AutomaticUpdate
     42[[Image(automatic-update.png,link=,right,margin-left=10,margin-bottom=10)]]
     43On start-up, JOSM attempts to update the plugins
    3444
    35 In the preferences you can define the policy for both updating plugins modes.
     45* if JOSM itself has been updated since the last plugin update. This is called the **version based update mode**.
     46* if a certain period of time has elapsed since the last plugin update. This is called the **time based updated mode**.
    3647
    37  1. Launch the [[Image(source:trunk/images/preference.png,15)]] '''Preferences''' dialog (''{{{F12}}}'')
    38  2. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] '''Plugins'''
    39  3. Click the tab '''Plugin update policy'''
     48In both cases, JOSM offers to update the currently active plugins and you are advised to run the updates by clicking on **Update plugins**. You may also skip updating, but be warned, that installed plugins could be incompatible with the new JOSM version and that they might either fail to load or fail to work as expected.
    4049
    41 [[Image(plugin_update_policy_preferences.png,450)]]
     50Select **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.
    4251
    43  * Select the radio button '''Ask before updating''' if JOSM shall ask before updating plugins in version and/or time based update mode.
    44  * Select the radio button '''Always update without asking''' if JOSM shall automatically update plugins without asking.
    45  * Select the radio button '''Never update''' to disable version or time based automatic update. JOSM will skip automatic update at startup if this policy is selected.
     52==== Options ====
     53[[Image(plugin_update_policy_preferences.png,link=,right,,margin-left=20,margin-bottom=10)]]
     54* Select the radio button **Ask before updating** if JOSM shall ask before updating plugins in version and/or time-based update mode.
     55* Select the radio button **Always update without asking** if JOSM shall automatically update plugins without asking.
     56* Select the radio button **Never update** to disable version or time based automatic update. JOSM will skip automatic update at startup if this policy is selected.
    4657
    47 The interval in days for the '''time based updated mode''' can be set below the radio buttons (''default=60'').
     58The interval in days for the **time based updated mode** can be set below the radio buttons (''default=30'').
     59
     60**Note:** There will be not restart required if plugins are updated on start-up.
     61
     62
     63=== Manually updating plugins ===
     641. Launch the [[JOSMImage(preference)]] **Preferences** dialog.
     651. Select the tab [[JOSMImage(preferences/plugin,24,middle,link=)]] **Plugins**.
     661. Click on [[JOSMImage(download)]] **Download list** to download the list of available plugins.
     671. Your installed plugins are already selected at the checkboxes
     681. Click on [[JOSMImage(dialogs/refresh)]] **Update plugins**.
     69
     70JOSM will update the selected plugins. You have to [[JOSMImage(restart)]] [wikitr:/Help/Action/Restart restart] JOSM to complete the update process.
     71
    4872
    4973== See also ==
    50 * [wiki:Plugins List of JOSM plugins]
    51 * [wiki:Help/Plugins Plugin Help]
     74* [wikitr:/Plugins Plugins for JOSM] as list
     75* [wikitr:/Help/Plugins Plugin Help]
     76* [[JOSMImage(preference)]] [wikitr:/Help/Preferences Preferences Overview]
    5277
    5378----
    54 Back to [wiki:Help/Action/Preferences Preferences][[BR]]
    55 Back to [wiki:Help/Plugins Plugin Help][[BR]]
    56 Back to [wiki:/Help Main Help]
     79Back to [wikitr:/Help/Action/Preferences Preferences Dialog] \\
     80Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     81Back to [wikitr:/Help Main Help]