| 14 | | 1. Launch the [[Image(source:/trunk/images/preference.png,15)]] **Preferences** dialog. |
| 15 | | 1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**. |
| 16 | | 1. Click on [[Image(source:trunk/images/download.png,15)]] **Download list** to download the list of available plugins. |
| 17 | | 1. Tick the checkbox for every plugin you want to install. |
| 18 | | 1. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] **Update plugins**. |
| | 34 | === Manual installation === |
| | 35 | If 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. |
| | 36 | Now restart and the plugins should show up in the plugin list. |
| | 37 | Tick the checkboxes of these manually placed plugins for finally installing them. |
| 22 | | == Manually updating plugins == |
| 23 | | 1. Launch the [[Image(source:trunk/images/preference.png,15)]] **Preferences** dialog. |
| 24 | | 1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**. |
| 25 | | 1. Click on [[Image(source:trunk/images/download.png,15)]] **Download list** do download the list of available plugins. |
| 26 | | 1. Tick the checkbox for every plugin you want to update. |
| 27 | | 1. Click on [[Image(source:trunk/images/dialogs/refresh.png,15)]] **Update plugins**. |
| | 40 | == Plugin update policy == #PluginUpdatePolicy |
| | 41 | === Updating plugins === #AutomaticUpdate |
| | 42 | [[Image(automatic-update.png,link=,right,margin-left=10,margin-bottom=10)]] |
| | 43 | On start-up, JOSM attempts to update the plugins |
| 35 | | JOSM checks at startup whether the currently active plugins should be updated and offers to update them. 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 newer JOSM version and that they might either fail to load or fail to work as expected. |
| 36 | | |
| 37 | | [[Image(wiki:Plugins:automatic-update.png)]] |
| 38 | | |
| 39 | | Select **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 dialogue any more. |
| 40 | | |
| 41 | | JOSM attempts to update the plugins |
| 42 | | * if JOSM itself has been updated since the last plugin update. This is called the **version based update mode**. |
| 43 | | * if a certain periode of time has elapsed since the last plugin update. This is called the **time based updated mode**. |
| 44 | | |
| 45 | | In the preferences you can define the policy for both updating plugins modes. |
| 46 | | |
| 47 | | 1. Launch the [[Image(source:trunk/images/preference.png,15)]] **Preferences** dialog. |
| 48 | | 1. Select the tab [[Image(source:trunk/images/preferences/plugin.png,15)]] **Plugins**. |
| 49 | | 1. Click the tab **Plugin update policy**. |
| 50 | | |
| 51 | | [[Image(plugin_update_policy_preferences.png,450)]] |
| 52 | | |
| 53 | | * Select the radio button **Ask before updating** if JOSM shall ask before updating plugins in version and/or time based update mode. |
| | 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. |
| 62 | | * Under **Windows**, this is in {{{C:\Documents and Settings\}}}''username''{{{\Application Data\JOSM\plugins}}}. |
| 63 | | * Under **Vista**, the plugins are located in {{{C:\Users\}}}''username''{{{\AppData\Roaming\JOSM\plugins}}}. |
| 64 | | * On a **Mac** you will find the JOSM directory in the user directory {{{/Users/}}}''username''{{{/.josm/plugins}}}. The point "." in front of ".josm" indicates that this folder is invisible. To show the contents of this hidden folder, use the Finders Go to folder menu command ({{{Cmd+Shift+G}}}), and enter "~/.josm") in the dialog that pops up. Drag any plugins you'd like to install into the {{{plugins}}} folder.[[BR]] (You can also copy the plugin files using the command line.) |
| 65 | | * On a **Linux** system you will find the JOSM directory in the user directory {{{/home/}}}''username''{{{/.josm/plugins}}}. The point "." in front of ".josm" indicates that this folder is invisible. To show the contents of this hidden folder, use the file manager and enter "~/.josm" in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut ''Ctrl+H''. Drag any plugins you'd like to install into the {{{plugins}}} folder.[[BR]] (You can also copy the plugin files using the command line.) |
| 67 | | Now restart JOSM and the plugins should show up in the plugin list under **''Edit -> Preferences -> [[Image(source:trunk/images/preferences/plugin.png,15)]] [wiki:Help/Preferences/Plugins Plugins]''**.[[BR]] Activate the Plugins, click on [[Image(source:/trunk/images/ok.png,15)]] **OK** to save the preferences and restart JOSM once more. |
| | 63 | === Manually updating plugins === |
| | 64 | 1. Launch the [[JOSMImage(preference)]] **Preferences** dialog. |
| | 65 | 1. Select the tab [[JOSMImage(preferences/plugin,24,middle,link=)]] **Plugins**. |
| | 66 | 1. Click on [[JOSMImage(download)]] **Download list** to download the list of available plugins. |
| | 67 | 1. Your installed plugins are already selected at the checkboxes |
| | 68 | 1. Click on [[JOSMImage(dialogs/refresh)]] **Update plugins**. |
| | 69 | |
| | 70 | JOSM will update the selected plugins. You have to [[JOSMImage(restart)]] [wikitr:/Help/Action/Restart restart] JOSM to complete the update process. |
