LotusNotify plugin by MaKaRSoFT adapted by me.

plugin from: http://maciej.wycik.pl/p_lotusnotify.php
base sources from: https://code.google.com/p/makarplugins/
- Miranda NG version
- unicode support
- many fixes and code reworks

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

1 files changed, 80 insertions, 0 deletions

diff --git a/plugins/LotusNotify/docs/install.txt b/plugins/LotusNotify/docs/install.txt
new file mode 100644
index 0000000000..0d59f2fdb9
--- /dev/null
+++ b/plugins/LotusNotify/docs/install.txt
@@ -0,0 +1,80 @@
+EN

+1.With 0.0.11.19 version plugin use lotus API dynamicly (Set PATH environment to Lotus Notes bins directory is now not required). If plugin can't load propertly nnotes.dll that must be found in Lotus Client location (stored in HCLM/Software/Lotus/Notes/Path registry value by installer), plugin will not load. 

+2.Installation:

+  Unpack lotusnotify.dll plugin in plugins directory.

+  In options find plugins->LotusNotify page.

+  Click button try detect - it will read settings from your lotus.ini.

+  Enter your lotus password into password field, then click button autoregister to add plugin as trusted in Lotus Notes.

+3.To show popups plugin requires popups option (yapp.dll plugin M->popups->enable popups) enabled 

+4.If you wish, to open note in Lotus Notes Client by click it with left mouse button:

+	-Open Lotus Notes Client

+	-Open database that should be opened

+	-Open any document (eMail)

+	-In document properties go to tag <+>

+	-In identifier field you can find link to this document build as: notes://server/database/view/document

+	(f.e. Notes:///C125709600375164/01D6C45C67A7DC98C3256C70004F4814/94FDCE1037A90037C125726C004795DD where server is not given)

+	-copy part of this link without part containing document description that should be replaced with variable name %OID% This variable plugin will replace with note id

+		notes://server/database/view/%OID%

+	(in our example it will be Notes:///C125709600375164/01D6C45C67A7DC98C3256C70004F4814/%OID%)

+	-above build link set in plugin properties field: "Left button click cmd", and leave "Command parameters" field empty.

+5.With version 0.0.15.26 you can store your lotus password in miranda, and buildin authentication let miranda connect to Lotus API without prompt for password. You need to set some options before use this feature:

+	-add in your notes.ini file (Lotus Notes installation folder) line (you can do it automatic with button "autoregister" in plugin options dialog. If this option is checked, everytime plugin start, it verify (in depend of given answer) if appropriate entry in lotus.ini exists and modifies it if required):

+		EXTMGR_ADDINS=lotusnotify

+		or if EXTMGR_ADDINS line already exists, simply add new extension after comma f.e.:

+		EXTMGR_ADDINS=someextension, lotusnotify

+	-don't forget to set your Lotus password in plugin options!!!

+	Now you can (if need/want) set security option that I suggest to disable in second Anaswer of FAQ below.

+6. With version 0.0.14.25 added messages filter - for sender and subject fields (primitive spam remover). For me this function is used to disable notification about emails sent by me (it's same new entries in Lotus Notes database)

+

+FAQ:

+Q:Could i keep Notes Client runing on my machine or it should be closed?

+A:There's no problem with that I think (not yet :)).

+

+Q:It always ask my password for id-file when it tries to check for e-mails.

+A:This is Lotus Client security build in solution, and its possible to disabe it (it decrease safety): 

+It's somewhere like (have polish lotus client) menu File->Protection(or security)->User protection-> basic security data (first tab)->Don't ask for password in other Lotus Notes aplications.

+If I find on Lotus API some other solition it will be updated (And I found, see point 5 of installation instructions)

+

+Q:miranda start with the error, that nNotes.dll not found. What is the solution?

+A:nnotes.dll is placed in Lotus installation directory, and miranda have to know that. You can do it adding in PATH (my computer->properies->advanced->environment variables->system variables) 

+directory where lotus exist (where nnotes.dll can be find)

+

+

+

+PL

+1. Od wersji 0.0.11.19 plugin używa dynamicznego ładowania biblioteki API Lotusa (ustawienie zmiennej środowiskowej PATH uwzględniającej katalog gdzie zainstalowany został lotus (u mnie "C:\Program Files\lotus\notes\") nie jest już wymagane. Jeżeli plugin nie załaduje biblioteki nnotes.dll której szuka w lokalizacji (zapisanej przez instalatora Lotusa w rejestrze pod kluczem HKLM/Software/Lotus/Notes) , plugin nie zostanie załadowany.

+2.Instalacja:

+  Skopiuj plik lotusnotify.dll do folderu /Plugins/ Mirandy.

+  W opcjach mirandy przejdź do załadki Wtyczki->LotusNotify

+  Wybierz przycisk 'wykryj' aby odczytać ustawienia serwera Lotus z pliku lotus.ini

+  Uzupełnij swoje hasło, i wybierz 'Zarejestruj' aby dodać plugin jako zaufany w Lotus Notes.

+3. Aby pokazywać komunikaty o nowych wiadomościach, plugin wymaga włączonej opcji pokazywania komunikatów (plugin yapp.dll M->komunikaty->enable popups)

+4. Jeśli chcesz, aby po kliknięciu lewym klawiszem myszy otwierała się ta wiadomość w programie Lotus Notes:

+	-Otwórz klienta Lotus Notes

+	-Otwórz bazę która ma się otwierać

+	-Otwórz jeden z dokumentów (eMaili)

+	-We właściwościach dokumentu przejdż do piątej zakładki <+>

+	-W polu identyfikator znajduje się link do tego dokumentu w formacie notes://serwer/baza/widok/dokument

+	(np Notes:///C125709600375164/01D6C45C67A7DC98C3256C70004F4814/94FDCE1037A90037C125726C004795DD gdzie serwer nie został podany)

+	-skopiuj fragment adresu bez części dokument którą zamień na nazwę zmiennej %OID% za którą plugin wstawi id dokumentu

+		notes://serwer/baza/widok/%OID%

+	(w naszym przykładzie Notes:///C125709600375164/01D6C45C67A7DC98C3256C70004F4814/%OID%)

+	-tak skomponowany link wstaw w ustawieniach pluginu w polu: "Polecenie po kliknięciu", a pole "Argumenty polecenia" pozostaw puste.

+5.Począwszy od wersji 0.0.15.26 możliwe jest zapisanie hasła dostępu do bazy Lotus w ustawieniach pluginu. Pozwala to na autoryzację w API Lotusa bez podawania hasła przy każdym uruchomieniu. W celu użycia koniecznych jest kilka ustawień:

+	-dodanie do pliku notes.ini (w katalogu instalacyjnym Lotus Notes) linii (można to zrobić automatycznie za pomocą przycisku "autoregister" znajdującego się w opcjach wtyczki. Jeśli ta opcja jest zaznaczone, plugin przy starcie sprawdza czy istnieje stosowny wpis w pliku notes.ini oraz w zależności od potrzeby i wybranej opcji modyfikuje plik ini przed kontynuacją inicjalizacji Lotus API):

+		EXTMGR_ADDINS=lotusnotify

+		lub jeśli linia EXTMGR_ADDINS już istnieje, poprostu dodać po przecinku nowe rozszerzenie np.:

+		EXTMGR_ADDINS=someextension, lotusnotify

+	-nie zapomnij też o ustawieniu hasła w opcjach pluginu!!!

+	Teraz możesz (jeśli chcesz/powinieneś) ustawić opcję zabezpieczeń którą sugerowałem wyłączyć w drugiej odpowiedzi FAQ poniżej

+6. Wraz z wersją 0.0.14.25 dodany został prymitywny filtr antyspamowy. Możliwe jest definiowanie słów znajdujących się w polach OD i TEMAT maila których wystąpienie będzie skutkowało brakiem powiadomienia o tej wiadomości.

+

+FAQ:

+P: Czy klient Lotus Notes może być uruchomiony na komputerze?

+O: Nie zaobserwowałem jeszcze ubocznych skutków pracy plugina przy uruchomionym klientcie, dlatego nie widzę przeciwskazań.

+

+P: Plugin pyta o hasło do pliku id gdy próbuje sprawdzać pocztę.

+O: Jest to wbudowane w klienta rozwiązanie zabezpieczające krórego wyłączenie jest możliwe w jego właściwościach (kosztem obniżenia zabezpieczeń). Aby wyłączyć tą funkcjonalność należy zaznaczyć opcję "Nie pytaj o hasło w innych aplikacjach działających w praogramie Lotus Notes..." którą można znaleźć w zakładce "Podst. dane o zabezp" opcji Plik->Zabezpieczenia->Zabezpieczenia użytkownia. Ostatnie wersje pluginu posiadają wbudowany mechanizm autoryzacji i zmiana tej opcji nie jest wymagana. Konieczne jest jedynie ustawienie hasła odpowiedniego wpisu w konfiguracji lotusa (patrz pkt. 5 procedury instalacyjnej)

+

+P: Miranda uruchamia się z błędem że nie może znaleźć biblioteki nNotes.dll

+O: biblioteka nNotes.dll powinna znajdować się w katalogu instalacyjnym klienta lotusa, i plugin lotusnotify.dll powinien o tym wiedzieć. Aby go poinformować najlepiej jest dodać katalog instalacyjny lotusa (katalog gdzie znajduje się biblioteka nNotes.dll) do zmiennej środowiskowej PATH (Mój komputer->właściwości->zaawansowane->Zmienne środowiskowe->zmienne systemowe). Aktualne wersje nie powinny wymagać tego ustawienia.