﻿ ______________________________________________________________________________
|                                                                              |
|   VirusTotal v0.02                   (c) 2019+ Pepak, https://www.pepak.net  |
|______________________________________________________________________________|

Ta wtyczka pozwala programowi FAR Manager na szybką weryfikację statusu
pliku wykonywalnego na portalu VirusTotal.com. Po uruchomieniu, wtyczka
łączy się z serwerem i jeżeli istnieje już raport dla tego pliku - wyświetla go;
w przeciwnym wypadku wysyła plik na portal i czeka na wygenerowanie nowego
raportu, po czym go wyświetla.



INSTALACJA
------------

Przed użyciem wtyczki, należy spełnić dwa warunki:

1) Wtyczka wymaga OpenSSL w wersji 1.0 lub nowszej, który musi być wgrany
   do folderu, z którego wtyczka może skorzystać. Powinien być to folder
   główny Menedżera FAR (%FARHOME%), folder systemu Windows (C:\WINDOWS\SYSTEM32,
   C:\WINDOWS\SYSWOW64) lub folder wpisany do systemowej zmiennej PATH.
   Sugeruję folder FAR. Uwaga: folder wtyczki nie będzie prawidłowy, jeżeli
   nie będzie wpisany do zmienej PATH!

   Jeżeli te wymagania nie zostaną spełnione, po uruchomieniu pojawi się błąd
   "SSL/TLS support is not compiled!" ("Obsługa SSL/TLS nie jest dostępna").

2) Musisz mieć aktualny klucz API ze strony VirusTotal. Można go bezpłatnie
   otrzymać na stronie https://www.virustotal.com/gui/join-us.
   Jest to wymagane przez VirusTotal, bez tego klucza nie można użyć usług
   VirusTotal we własnych aplikacjach. Klucz można wprowadzić w opcjach
   konfiguracji wtyczki, gdzie można też ustawić różne limity dotyczące
   korzystania z serwisu. Domyślnie ustawione parametry są odpowiednie
   dla bezpłatnej wersji klucza API zgodnie z aktualną dokumentacją
   (stan na listopad 2019r., może zostać zmieniona bez wcześniejszej
   informacji). Możliwe, że możesz otrzymać prywatny klucz API z mniejszymi
   limitami niż ustawione we wtyczce.



UŻYCIE
-----

Aby poprawnie zweryfikować plik w serwisie VirusTotal, wybierz (zaznacz) plik
w aktywnym panelu i uruchom wtyczkę. Zostanie obliczona suma kontrolna pliku
i wysłana na serwery VirusTotal. Jeżeli raport dla tej sumy kontrolnej
już istnieje, zostanie on wyświetlony. Jeżeli nie ma raportu, plik zostanie
wysłane na serwery VirusTotal i zostanie on włączony na listę plików do skanowania;
po zeskanowaniu zostanie wyświetlony raport. Weź pod uwagę, że kolejka plików
może być długa i trzeba będzie dłużej poczekać na sprawdzenie pliku, z mojego
doświadczenia może to zająć kilka minut.

W widoku raportu, programy które wykryły problemy (wirusy) zostaną wyświetlone
alfabetycznie na początku listy; następnie (także alfabetycznie) programy,
które nie wykryły infekcji w plikach. Możesz przeszukać listę po nazwie
programu antywirusowego lub po nazwie wirusa. Możesz także ponowić skanowanie
pliku wybierając przycisk ponowienia (lub klawisz F5). Domyślnie, plik zostanie
ponownie wysłany na serwer, ale można próbować włączyć funkcję API ponownego
skanowania pliku; niestety, nigdy nie udało mi się uruchomić tej funkcji, mój
klucz API zawsze był odrzucany z powodu niewystarczających uprawnień.



LICENCJA
-------

Wtyczka jest rozpowszechniania ze zmodyfikowaną (punkt 3) licencją BSD.
Szczegóły w pliku licence.txt (po angielsku).



KOMPILACJA WTYCZKI
-------------------

Musisz posiadać Delphi w wersji przynajmniej XE2. Starsze wersje nie są obsługiwane.
W nowszych nie powinno być problemu.

Upewnij się, że wybrany folder BIN Delphi jest wpisany do zmiennej PATH,
przejdź do folderu ze źródłami wtyczki i uruchom BUILD. Powinieneś zobaczyć
nowy plik Filters.dll w folderze BIN.

Możesz użyć kilku opcji linii poleceń przy uruchamianiu BUILD. Najważniejsze
z nich to:

    FAR2 ........ Wersja dla FAR2.
    FAR3 ........ Wersja dla FAR3 (domyślnie).
    X86 ......... 32-bitowa wersja wtyczki (domyślnie).
    X64 ......... 64-bitowa wersja wtyczki.



KONTAKT
-------

Jeżeli masz jakiekolwiek pytania lub sugestie dotyczące nowych funkcji, możesz skorzystać
z angielskiego forum FAR Manager ( https://forum.farmanager.com ),
lub mojego forum ( https://forum.pepak.net ).
Uwaga: proszę pisać po angielsku.
