View source for Plugin:PluginUpdater

<languages/>{{PluginCard}}
{{TNT|Note|<translate><!--T:1--> This plugin should not be confused with {{Plugin|IM Updater}} plugin for '''Miranda IM'''.</translate>}}

{{TNT|Important|<translate> <!--T:14--> Windows XP users should not enable "Use HTTPS" option if {{Plugin|OpenSSL}} plugin is not installed .</translate>}}

<translate>
<!--T:2-->
Installs and updates plugins and other Miranda NG components (icon and {{GlossLink|Language pack|language packs}}).
</translate>

__TOC__

<translate>
== Version choice == <!--T:3-->

<!--T:4-->
You can choose among {{GlossLink|Stable version|stable}} and {{GlossLink|development version}} in {{Menu|Options|Services|Plugin Updater}} under ''Files source'' section. There are the following settings there:
* '''Stable version''' is released "when it is ready", about once in 1–2 months.
* '''Stable version with debug symbols''' – use this one if you are going to make a {{Ll|Crash reports|crash report}}.
* '''Development version (less stable)''' is updated more often so you'll be able to take advantage of new features sooner.
* '''Development version with debug symbols''' – use this one if you are going to make a {{Ll|Crash reports|crash report}}.
* '''Custom version''' is for pack creators: if you distribute '''your own''' Miranda pack, select this one and set your URL for PluginUpdater to download updates from. In this case you become responsible for keeping your repository of plugins up-to-date.
</translate>

[[File:PluginUpdater 01.png|200px|thumb|<translate><!--T:5--> Component list</translate>]]
<translate>
== Adding plugins and components == <!--T:6-->

<!--T:7-->
PluginUpdater allows to download and install several plugins at once.
* Go to {{Menu|Main menu|Available components list}}.
* Select additional plugins, a langpack or icon sets to install (see the screenshot). Clicking on "Information" icon will open the plugin's wiki page in your browser.
* Click {{Button|Download}} button.

== How it works == <!--T:8-->

<!--T:9-->
This plugin compares hashes of the installed plugins with those on the server and if they differ, downloads archived updates and replaces the local copy.

<!--T:10-->
It should be noted that PluginUpdater doesn't check plugins' versions nor their compilation dates. So if you compile a plugin by yourself (or somebody does and shares it with you), PluginUpdater will still download its "older" version from the server. This was done on purpose to avoid problems with plugins from doubtful sources.

<!--T:11-->
Special algorithm for calculating plugins' hashes ignores information about DLL compilation time (which is also written to DLL). Thus a plugin compiled from the same source code with the same compiler but at different time will have the same hash for PluginUpdater but different one for ordinary MD5 calculation tools.

== Tips and tricks == <!--T:12-->

<!--T:13-->
# PluginUpdater remembers user's choice of the components in the list of updates. If you have a custom langpack or an icon set (e.g., <tvar|icon_file><tt>Proto_Jabber.dll</tt></>) which you don't want to update, uncheck the corresponding items in the list. You need to do this once, those components will remain unchecked during the next updates and thus won't get updated.
# If you set the key of <tvar|Byte_type><tt>{{L10n:DBTypes|byte|lang={{PageLangCode}}}}</tt></> type <tvar|db_key>{{DBKey|PluginUpdater|RestartCurrentProfile|0}}</>, the plugin will restart Miranda to [[Profile management|Profile manager]] (revision <tvar|rev>{{Rev|aa4bd180f90414716025391d5e3aa8a5512dc071|aa4bd180f9}}</>). PluginUpdater restarts Miranda to current profile by default.
# If you set the key of <tvar|Byte_type><tt>{{L10n:DBTypes|byte|lang={{PageLangCode}}}}</tt></> type <tvar|db_key2>{{DBKey|PluginUpdaterFiles|path\to\filename|2}}</>, PluginUpdater will hide the specified component from the list of updates and will not download it. Path is relative to Miranda root folder (e.g. "mdbx_dump.exe" or "icons\toolbar_icons.dll").
</translate>

{{PluginGroups}}