summaryrefslogtreecommitdiff
path: root/plugins/LotusNotify/docs/install.txt
blob: 9f21df91791d64dc3686db79c0f0f1283ddb0ed3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
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.