Plugin:PluginUpdater/en: Difference between revisions

From Miranda NG
Plugin:PluginUpdater/en
Jump to navigation Jump to search
No edit summary
(Updating to match new version of source page)
Line 1: Line 1:
{{PluginCard}}
<languages/>{{PluginCard}}
{{Note|This plugin should not be confused with {{Plugin|IM Updater}} plugin for '''Miranda IM'''.}}
{{TNT|Note|This plugin should not be confused with {{Plugin|IM Updater}} plugin for '''Miranda IM'''.}}


Installs and updates plugins and other Miranda NG components (icon and {{GlossLink|Language pack|language packs}}).
Installs and updates plugins and other Miranda NG components (icon and {{GlossLink|Language pack|language packs}}).


__TOC__
__TOC__


== Version choice ==
== Version choice ==
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:
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''' is released "when it is ready", about once in 1–2 months.
Line 13: Line 13:
* '''Development version with debug symbols''' – use this one if you are going to make a [[Crash reports|crash report]].
* '''Development version with debug symbols''' – use this one if you are going to make a [[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.
* '''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.


[[File:PluginUpdater 01.png|200px|thumb|Component list]]
[[File:PluginUpdater 01.png|200px|thumb|Component list]]
== Adding plugins and components ==
== Adding plugins and components ==
PluginUpdater allows to download and install several plugins at once.
PluginUpdater allows to download and install several plugins at once.
* Go to {{Menu|Main menu|Available components list}}.
* Go to {{Menu|Main menu|Available components list}}.
Line 22: Line 22:
* Click ''Download'' button.
* Click ''Download'' button.


== How it works ==


== How it works ==
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.
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.


Line 30: Line 30:
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.
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 ==


== Tips and tricks ==
# 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. <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.
# 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. <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 <tt>{{L10n:DBTypes|byte|lang={{PageLangCode}}}}</tt> type {{DBKey|PluginUpdater|RestartCurrentProfile|0}}, the plugin will restart Miranda to [[Profile management|Profile manager]] ({{Rev|3346|revision 3346}}). PluginUpdater restarts Miranda to current profile by default.
# If you set the key of <tt>BYTE</tt> type {{DBKey|PluginUpdater|RestartCurrentProfile|0}}, the plugin will restart Miranda to [[Profile management|Profile manager]] ({{Rev|3346|revision 3346}}). PluginUpdater restarts Miranda to current profile by default.


{{PluginGroups}}
{{PluginGroups}}

Revision as of 14:14, 31 December 2017

Plugin updater
Plugin updater
Filename PluginUpdater.dll
Authors Mataes, George Hazan
Download links
Stable version: 32-bit, 64-bit
Development version: 32-bit, 64-bit

Note
This plugin should not be confused with IM Updater plugin for Miranda IM.

Installs and updates plugins and other Miranda NG components (icon and language packs).

Version choice

You can choose among stable and development version in 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.
  • 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 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.
Component list

Adding plugins and components

PluginUpdater allows to download and install several plugins at once.

  • Go to 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 Download button.

How it works

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.

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.

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

  1. 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. Proto_Jabber.dll) 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.
  2. If you set the key of Byte type PluginUpdater/RestartCurrentProfile = 0, the plugin will restart Miranda to Profile manager (revision 3346). PluginUpdater restarts Miranda to current profile by default.