- added ChangeClientNotify

- CommonLibs finally became common ;)

git-svn-id: http://svn.miranda-ng.org/main/trunk@118 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

1 files changed, 81 insertions, 0 deletions

diff --git a/plugins/ClientChangeNotify/ccn_readme.txt b/plugins/ClientChangeNotify/ccn_readme.txt
new file mode 100644
index 0000000000..a365ce067c
--- /dev/null
+++ b/plugins/ClientChangeNotify/ccn_readme.txt
@@ -0,0 +1,81 @@
+ClientChangeNotify plugin for Miranda IM.

+(c) Chervov Dmitry aka Deathdemon.

+

+This plugin shows a notification when someone in your contact list changes his client.

+It requires Popup or YAPP plugin.

+

+"Ignore these clients" setting is a list of substrings separated by semicolons; if ClientChangeNotify finds one of these substrings in a new client name, it doesn't show the notification.

+Also it's possible to use regular expressions, but it requires pcre.dll or pcre3.dll in your miranda directory.

+PCRE is available from http://www.pcre.org/ (Binaries for Windows are here: http://gnuwin32.sourceforge.net/downlinks/pcre-bin-zip.php )

+When PCRE library is installed successfully, ClientChangeNotify will show "you can use regular expressions here" under the "Ignore these clients" field in the options.

+

+Regular expressions are detected by '/' symbol at the start of the substring. The same symbol must be at the end of the substring, possibly followed by pattern modifier characters. I.e. "gmail;/[0-9A-F]{8}(\W|$)/i;skype" has two usual substrings and one regexp substring with an "i" modifier (caseless).

+

+There are several solutions to filter jgmail client changes:

+1) Disable notification about client version changes

+(Miranda options -> Popups -> ClientChangeNotify -> "Notify also when just client version changes" checkbox, turn it off).

+This solution is somewhat easier, but ClientChangeNotify won't notify you of any client version changes.

+2) Disable client change notifications for separate contacts

+3) Install PCRE library (see the download link above), and make sure that substring "/[0-9A-F]{8}(\W|$)/" is present in the "Ignore these clients" field of the ClientChangeNotify options. If the substring is not there, add it.

+This solution is the most correct.

+

+ClientChangeNotify supports per-contact notification setting. There are two ways to use it: either by using ContactSettings plugin that adds a GUI to easily modify this setting, or by modifying the database directly:

+Contact/ClientChangeNotify/Notify (BYTE) =

+ 0 - completely disable notifications for this contact

+ 1 - show notifications always, except when ClientChangeNotify popups are turned off

+ 2 - show notifications always, even when ClientChangeNotify popups are turned off

+ 3 (default) - use global settings (the plugin will examine the following two checkboxes before deciding whether to show the notification: "Notify also when just client version changes" and "Don't notify for contacts with disabled status notification")

+

+Changelog

+=========

+

+v0.1.1.2 (build 61; Jan 12, 2008)

+--------

+ - workaround for contact lists bug with multiple submenu items when using a localization file

+

+v0.1.1.1 (build 60; Jan 2, 2008)

+--------

+ - added an item to the Popups submenu of the main menu to toggle client change notifications

+ - fixed regexp to ignore jgmail clients

+ - improved pcre library detection

+ - changed notification text formatting

+ - changes in ContactSettings API

+

+v0.1.1.0 (build 54; Sep 17, 2007)

+--------

+ - added support for Miranda 0.8. CCN interface is {E9D1F0D4-D65D-4840-87BD-59D7B4702C47}

+ - moved logging features to a separate plugin - LogService

+ - added possibility to ignore certain clients, also using regular expressions

+ - added per-contact setting to turn notifications on/off, and support for ContactSettings plugin

+ - some other minor improvements

+

+v0.1.0.9 (build 29; Jul 3, 2006)

+--------

+ - fixed non-working preview on some profiles

+ - fix to log unique ID of every protocol, not only ICQ UIN

+

+v0.1.0.8 (build 27; Jul 2, 2006)

+--------

+ - disabled notification for new contacts

+ - implemented unicode logging correctly

+

+v0.1.0.7 (build 24; May 2, 2006)

+--------

+ - unicode support

+ - some minor fixes

+

+v0.1.0.6 (build 22; Apr 15, 2006)

+--------

+ - fixed disappearing client icons in popups

+

+v0.1.0.5 (build 18; Apr 15, 2006)

+--------

+ - fixed a crash with some "unusual" clients

+

+v0.1.0.4 (build 17; Apr 14, 2006)

+--------

+ - Added a check whether Fingerprint plugin is installed or not. Now ClientChangeNotify can work without it, but with a limited functionality. It's still highly recommended to install Fingerprint.

+

+v0.1.0.2 (build 15; Apr 14, 2006)

+--------

+ - First public release.
\ No newline at end of file