Plugin ten służy do zapisywania informacji o otrzymanych i wysłanych wiadomościach, a także opcjonalnie zmianach statusu użytkowników z listy kontaktów.
Aby skorzystać z pluginu, należy ustawić zmienną
logsqlite:log na 1. Dane będą
logowane do pliku, który jest określony przez zmienną logsqlite:path
- domyślnie ~/.ekg2/logsqlite.db. Jeśli ten plik nie
istnieje, to zostanie stworzony, razem z odpowiednią strukturą. Po
ustawieniu opcji logsqlite:log_status logowane będą
także zmiany statusów osób z listy użytkowników.
Odpowiednie ustawienie zmiennej logsqlite:path pozwala
na logowanie do różnych plików zależnie od daty i od sesji. Jest to
przydatna opcja, ponieważ baza może szybko urosnąć, spowalniając
działanie pluginu. W ścieżce wystarczy umieścić odpowiednie znaki, które
zostaną podmienione na generowane na bieżąco wartości.
%S zostanie podmienione na nazwę sesji, a
%Y, %M i %D
zostanie podmienione na odpowiednio rok, miesiąc i dzień odebrania
wiadomości lub statusu.
ekg2 nie zapewnia możliwości przeszukiwania stworzonej bazy danych,
oprócz polecenia logsqlite:last. Wyświetla ono
ostatnio zalogowane wiadomości - domyślną ilość wyświetlanych wiadomości
określa zmienna logsqlite:last_limit. Opcjonalnie, do polecenia można
podać parametr -n [liczba] określający na bieżąco
ile wierszy ma być wyświetlone. Drugi opcjonalny parametr to
identyfikator użytkownika lub nazwa użytkownika z bieżącej sesji, którego
wiadomości mają być wyświetlane.
Domyślnie polecenie logsqlite:last wyświetla
wiadomości w bieżącym oknie. Można to zmienić przez ustawienie opcji
logsqlite:last_in_window i
logsqlite:last_open_window. Pierwsza z tych zmienny
określa, czy wiadomości wyświetlane przez
logsqlite:last mają być wyświetlane w okienku z
rozmową z danym użytkownikiem (wiadomości bez wskazania użytkownika będą
wyświetlane w oknie statusu). Po ustawieniu drugiej zmiennej na
1 ekg2 będzie otwierało okno z rozmową z danym
użytkownikiem jeśli ono nie istnieje.
session text - nazwa sesji
uid text - id użytkownika, który wysłał wiadomość bądź ją odbierze
nick text - pseudonim
type text - typ wiadomości ("chat", "msg", "sys")
sent boolean - czy wiadomość jest wysyłana czy odbierana
ts timestamp - czas odebrania wiadomości
sentts timestamp - czas wysłania wiadomości
body text - treść wiadomości