Dokumentacja dataBAS

Wymagania i instalacja

Wymagania serwera

• PHP 8.1 lub nowszy z rozszerzeniem PDO (pdo_sqlite albo pdo_mysql) oraz mbstring.
• Baza danych: SQLite (plik — nie potrzeba serwera bazy) albo MySQL / MariaDB.
• Do aktywacji licencji: rozszerzenie sodium lub openssl (standardowo włączone) i dostęp serwera do internetu.
• Bez Composera, npm i zewnętrznych bibliotek — wystarczy zwykły hosting z PHP.

Instalacja krok po kroku

1. Wgraj katalog databas/ na serwer, np. do public_html/databas/.
2. Upewnij się, że PHP może zapisywać w katalogu aplikacji (jednorazowo, dla config.php) oraz w katalogach data/ i uploads/.
3. Otwórz w przeglądarce https://twoja-domena/databas/install.php.
4. Wybierz bazę (SQLite lub MySQL) i podaj dane administratora. Możesz zaznaczyć przykładową aplikację „Biblioteka szkolna”.
5. Po instalacji usuń install.php. Instalator i tak blokuje się sam, gdy istnieje config.php.

Jeśli wskażesz istniejącą bazę MySQL, instalator od razu wykryje jej tabele.

Serwer nginx

Pliki .htaccess chronią katalogi systemowe tylko na serwerze Apache. Na nginx dodaj do konfiguracji:

location ~ ^/databas/(app|views|data|uploads|custom)/ { deny all; }
location ~ ^/databas/(config.php|config.sample.php|README.md)$ { deny all; }

Bezpieczniej trzymać plik SQLite poza katalogiem publicznym — zmień sqlite_path w config.php.

Pierwsza aplikacja

Nowa tabela

Wejdź w Kreator → Tabele i pola → Nowa tabela. Podaj nazwę i dodaj kolumny. dataBAS sam tworzy kolumnę id, a na życzenie także kolumny systemowe: kiedy utworzono, kiedy zmieniono i kto jest autorem rekordu. Po zapisaniu tabela pojawia się w menu z gotową listą, formularzem i widokiem szczegółów.

Typy pól

• tekst i tekst długi, liczba całkowita i dziesiętna,
• data oraz data i godzina, pole tak/nie,
• lista wyboru,
• powiązanie z inną tabelą — wybór rekordu z innej tabeli, z etykietą złożoną z kilku pól (np. imię i nazwisko),
• e-mail, adres WWW, plik i obrazek.

Konfiguracja pól

Dla każdego pola ustawisz etykietę, kolejność (przeciąganiem), widoczność na liście, w formularzu i w szczegółach, udział w wyszukiwaniu, wymagalność, tryb tylko do odczytu, podpowiedź i wartość domyślną. Wartości domyślne mogą zawierać znaczniki {today}, {now} i {user}.

Walidacja

Wszystkie reguły sprawdza serwer: pola wymagane, typy, zakres min/max, długość, wyrażenie regularne z własnym komunikatem, istnienie powiązanego rekordu oraz typ i rozmiar pliku.

Gotowe szablony aplikacji

Kreator → Szablony aplikacji tworzy całą aplikację jednym kliknięciem: wypożyczalnię, inwentaryzację sprzętu, wycieczki szkolne, ewidencję zgód RODO, zapisy na zajęcia, rejestr pism albo faktury. Dostajesz powiązane tabele z ustawionymi polami, formułami, przyciskami akcji, raportami i — jeśli chcesz — przykładowymi danymi. Wybierz grupę, która ma dostać uprawnienia. Ten sam szablon zainstalujesz drugi raz z innym przedrostkiem nazw tabel (np. dla drugiej szkoły w zespole). Potem wszystko dopasujesz w Kreatorze. Kolejne gotowe aplikacje dokupisz jako moduły.

Faktury

Szablon aplikacji Faktury tworzy tabele: Dane sprzedawcy, Nabywcy, Faktury i Pozycje faktur. Najpierw uzupełnij dane sprzedawcy (nazwa, NIP, adres, numer konta) — trafią na każdą fakturę. Nabywcy wpisz adres e-mail do faktur. Na fakturze dodaj pozycje: nazwę, ilość, cenę netto i stawkę VAT; wartości, sumy, termin płatności i kwota słownie policzą się same. Numer faktury musi być unikalny.

Podgląd, wydruk i wysyłka

Najedź myszą na fakturę na liście — pojawi się podgląd z przyciskami Drukuj i Wyślij na adres nabywcy. Na telefonie i z klawiatury podgląd otwiera przycisk 🧾 przy fakturze. Fakturę wyślesz też z paska wydruku albo z menu „Drukuj” na karcie faktury. Nabywca dostaje wiadomość z fakturą i krótkim wstępem (numer, kwota, termin płatności); status faktury zmienia się na „Wysłana”. Przycisk Pobierz PDF zapisuje fakturę jako plik PDF, a wysłana faktura ma plik PDF w załączniku.

Moduły — dodatkowe szablony aplikacji

Moduł to kolejna gotowa aplikacja (np. Rezerwacje sal i sprzętu), którą kupujesz osobno w sklepie dataBAS. Po instalacji pojawia się na liście szablonów aplikacji z oznaczeniem „moduł” i tworzysz z niego aplikację tak samo jak z wbudowanego szablonu. Wymaga dataBAS 2.9 lub nowszego.

Zakup

Otwórz Kreator → Szablony aplikacji → Moduły i kliknij Kup moduł — strona sklepu otworzy się z wpisanym kluczem Twojej licencji. Moduł kupisz też bezpośrednio na stronie Moduły dataBAS, podając klucz licencji. Kupiony moduł jest przypisany do klucza, więc działa na wszystkich domenach tej licencji. Po płatności dostajesz e-mail z linkiem do pliku modułu.

Instalacja

1. Jednym kliknięciem: w sekcji Moduły kliknij Odśwież, a potem Zainstaluj przy kupionym module. Serwer dataBAS potrzebuje połączenia z internetem.
2. Z pliku: kliknij Wgraj moduł z pliku i wskaż plik .dbsmod z e-maila — przydaje się na serwerze bez dostępu do internetu.

Po instalacji wybierz moduł na liście szablonów i kliknij Utwórz aplikację (przedrostek nazw tabel, grupa z uprawnieniami, przykładowe dane — jak przy każdym szablonie).

Aktualizacja i usuwanie

Gdy pojawi się nowa wersja, przy module zobaczysz przycisk Zaktualizuj do …. Aktualizacja zmienia sam szablon — aplikacje utworzone wcześniej, ich tabele i dane zostają bez zmian. Usuń moduł usuwa tylko szablon; utworzone z niego tabele i rekordy zostają.

Bezpieczeństwo

Moduł zawiera wyłącznie opis tabel, pól, formuł, raportów, akcji i wydruków — nigdy kodu PHP. dataBAS sprawdza podpis sprzedawcy, sumę kontrolną zawartości i to, czy moduł został kupiony dla Twojego klucza licencji. Plik zmieniony, podpisany cudzym kluczem albo wystawiony dla innej licencji zostanie odrzucony. Formuły z modułu przechodzą tę samą kontrolę co formuły wpisane w Kreatorze.

Dla twórców modułów

Moduł zbudujesz z gotowej aplikacji poleceniem php tools/module.php z-tabel <id> "<Nazwa>" tabela1,tabela2 [--dane] albo z istniejącego szablonu (z-szablonu). Polecenie sprawdz pokazuje, co zawiera paczka i czy jest poprawna. Plik wgrywa się do sklepu (Licencje dataBAS → Moduły), który podpisuje go przy każdym pobraniu. Do testów niepodpisanych modułów włącz w config.php ustawienie 'modules_dev' => true — tylko na serwerze testowym.

Formularze publiczne

Kreator → Formularze publiczne tworzy formularz bez logowania, który dodaje rekord do wybranej tabeli — np. zapisy na zajęcia, zgłoszenia usterek albo wnioski rodziców. Wybierasz pola, ich kolejność i etykiety, a wartości ukryte (np. status „nowe”) ustawiają się same. Walidacja, listy wyboru, pola warunkowe i kontrola duplikatów działają jak w aplikacji.

Udostępnianie

Formularz ma własny link i kod QR do wydrukowania na plakat. Kod do wklejenia osadzi go na dowolnej stronie, np. w WordPressie w bloku „Własny HTML” — ramka sama dopasuje wysokość. Osadzanie możesz ograniczyć do wybranych domen.

Zgody, potwierdzenia, limity

Włącz zgodę na przetwarzanie danych z linkiem do klauzuli informacyjnej, potwierdzenie e-mailem dla zgłaszającego i powiadomienie dla sekretariatu. Ustaw termin otwarcia i zamknięcia oraz limit zgłoszeń (np. liczbę miejsc). Formularz chroni się przed spamem sam: sprawdza czas wypełniania, ma ukryte pole-pułapkę i limit zgłoszeń z jednego adresu.

Przypomnienia e-mail

Kreator → Przypomnienia wysyła wiadomości same, raz dziennie o wybranej godzinie. Wybierz tabelę z datą (np. Wypożyczenia — termin zwrotu), określ, kiedy wysłać (np. 3 dni przed terminem, w dniu terminu albo 1 dzień po nim), dodaj warunki (np. status „wypożyczona”) i odbiorców.

Odbiorcy i treść

Adres może pochodzić z pola rekordu albo z rekordu powiązanego — np. e-mail czytelnika z tabeli Czytelnicy. Możesz też dodać stałe adresy, użytkowników z wybranych grup i autora rekordu. Każdy odbiorca dostaje osobną wiadomość. W treści użyj znaczników: {termin}, {dni}, {link}, {nazwa_pola} albo {czytelnik_id.imie} (pole rekordu powiązanego). Lista zbiorcza ({lista}, {liczba}) to jeden e-mail z wykazem wszystkich pasujących rekordów — np. codzienny raport zaległości.

Powtarzanie i podgląd

Domyślnie przypomnienie przychodzi raz na rekord i termin; zmiana terminu w rekordzie oznacza nowe przypomnienie. Możesz też powtarzać je co kilka dni, dopóki rekord spełnia warunki. Edytor pokazuje, kto dostanie wiadomość dziś, a przycisk „wyślij próbę do mnie” wysyła przykład na Twój adres. Wysyłka korzysta z ustawień poczty (Kreator → Ustawienia → E-mail).

Harmonogram (cron)

Przypomnienia i kopie zapasowe uruchamia harmonogram. Najlepiej dodaj w panelu hostingu zadanie cron co 15 minut — gotowa linia z poprawną ścieżką jest w Kreatorze, z przyciskiem „Kopiuj”. Bez crona dataBAS uruchamia zadania przy wejściach na stronę (najwyżej co 5 minut, bez spowalniania strony); gdy nikt nie wchodzi, zadania poczekają.

Kopie zapasowe

Kreator → Kopie zapasowe tworzy kopię całej aplikacji w jednym pliku: wszystkie tabele z danymi, konta i uprawnienia, ustawienia, raporty, formularze i — jeśli chcesz — przesłane pliki. Kopie mogą powstawać same, codziennie lub co tydzień o wybranej godzinie; najstarsze kopie automatyczne są usuwane.

Pobieranie i przywracanie

Pobieraj kopie co jakiś czas na komputer albo dysk — kopia na tym samym serwerze nie pomoże, gdy padnie cały serwer. Przywrócenie (po wpisaniu słowa PRZYWRÓĆ) cofa całą aplikację do stanu z kopii; wcześniej dataBAS zawsze tworzy kopię bezpieczeństwa obecnego stanu. Kopię możesz też wgrać z dysku, np. na nowy serwer z tą samą bazą. Kopia nie zawiera pliku config.php z hasłem do bazy — zachowaj go osobno. Do przenoszenia między MySQL a SQLite służy Eksport i import.

Eksport i import

Kreator → Eksport i import przenosi aplikację na inną instalację dataBAS — np. z wersji testowej na produkcyjną albo z SQLite na MySQL — i robi kopie wybranych tabel.

Eksport

Zaznacz tabele i to, co ma trafić do paczki: automatyzację tabel (przyciski akcji, powiadomienia, filtry wierszy, duplikaty), grupy i uprawnienia, raporty, pulpity i szablony wydruku, wygląd i menu, dane oraz przesłane pliki. Dostajesz paczkę ZIP ze strukturą w pliku structure.json i danymi w plikach CSV (po jednym na tabelę). Każdą tabelę pobierzesz też osobno: „Struktura JSON” i „Dane CSV” — także na stronie konfiguracji tabeli. Konta użytkowników i hasła, klucz licencji i klucz API nie są eksportowane.

Import

Wgraj paczkę ZIP, plik JSON albo CSV. Najpierw zobaczysz podgląd: które tabele powstaną, które już istnieją i jakie kolumny zostaną do nich dodane oraz ile rekordów jest w pliku. Dane możesz dodać (rekordy o istniejącym identyfikatorze są pomijane), zastąpić albo pominąć. Grupy są dopasowywane po nazwie, a raport po imporcie pokazuje, co zostało zrobione i co wymaga uwagi. Przed importem do działającej aplikacji zrób kopię zapasową bazy.

Istniejąca baza danych

dataBAS może pracować na bazie, którą już masz. Kreator → Tabele i pola → Synchronizuj ze strukturą bazy wykrywa tabele, kolumny, klucze główne i obce oraz dobiera typy pól: klucz obcy staje się powiązaniem, tinyint(1) polem tak/nie, a date kalendarzem.

Filtr przedrostków

Jeśli w tej samej bazie są tabele innych programów, w Ustawieniach wpisz przedrostki tabel, które ma widzieć dataBAS, np. szkola_. Przedrostek można ukryć w nazwach i automatycznie dodawać do nowych tabel. Konfiguracja tabel ukrytych filtrem zostaje zachowana.

Zmiana nazwy tabeli

W Konfiguruj → Ustawienia tabeli zmienisz nazwę tabeli w bazie. dataBAS przeniesie pola, uprawnienia, powiązania i pliki.

Listy, formularze i eksport

Lista danych

Szybkie wyszukiwanie działa także po etykietach powiązań, bez rozróżniania wielkości liter i polskich znaków. Do tego filtry (zakresy liczb i dat, tak/nie, listy), sortowanie po każdej kolumnie, stronicowanie i usuwanie wielu rekordów naraz.

Formularze

Dodawanie, edycja i szczegóły rekordu. Przycisk „Zapisz i dodaj kolejny” przyspiesza wprowadzanie serii danych, a ostrzeżenie o niezapisanych zmianach chroni przed przypadkowym wyjściem z formularza.

Powiązane rekordy

Tabele połączone polem „Powiązanie z tabelą” są wykrywane automatycznie. Pod listą, np. uczniów, kliknięcie wiersza pokazuje rekordy podrzędne, np. oceny, bez przeładowania strony. Panele można włączyć także w szczegółach rekordu (Konfiguruj → Ustawienia tabeli).

Eksport CSV

Plik CSV otwiera się poprawnie w polskim Excelu (średnik, przecinek dziesiętny, polskie znaki). Eksport uwzględnia bieżące wyszukiwanie i filtry.

Użytkownicy i uprawnienia

Konta i grupy

W Kreator → Użytkownicy zakładasz konta, przypisujesz grupy i blokujesz dostęp. Użytkownik ma grupę główną i może należeć do dowolnej liczby dodatkowych — uprawnienia się sumują.

Uprawnienia do tabel

Macierz grupa × tabela: przeglądanie, szczegóły, dodawanie, edycja, usuwanie i eksport, a także „tylko własne rekordy”. Wiersz „Nowe tabele” to szablon uprawnień dla tabel tworzonych w przyszłości.

Filtry wierszy

W zakładce Automatyzacja tabeli ograniczysz, które wiersze widzi grupa, np. nauczyciele widzą tylko uczniów swojej klasy: klasa równa się {user.klasa}. Atrybuty użytkownika (np. klasa = 5b) ustawiasz w jego profilu. Filtr działa wszędzie: na liście, w eksporcie, raportach, API i wtyczce WordPress.

Dostęp bez logowania

W Ustawieniach możesz pozwolić gościom przeglądać wybrane tabele (grupa „Goście” w Uprawnieniach). Goście mają wyłącznie odczyt, sprawdzany przez serwer.

Formuły, pola warunkowe i przyciski akcji

Pola wyliczane

W opcjach pola wpisz formułę. Wynik zapisuje się w kolumnie, więc działa sortowanie, filtrowanie i eksport, a w formularzu widać go na żywo podczas pisania.

Gdy zmieni się rekord podrzędny, rekord nadrzędny przelicza się sam. Formuły wykonuje własny interpreter dataBAS — bez dostępu do kodu PHP i haseł. Pełna ściąga funkcji jest w opcjach pola.

Pola warunkowe

„Pokaż pole tylko gdy…” i „Pole wymagane gdy…”, np. {status} = "wypozyczona". Warunek działa na żywo w formularzu i jest sprawdzany przez serwer; wartość ukrytego pola nie jest zapisywana.

Przyciski akcji

Jedno kliknięcie ustawia wybrane pola, np. przycisk „Zwrócona” wpisuje status = "zwrocona" i data_zwrotu = TODAY(). Przycisk może też otworzyć kopię rekordu. Ustawisz warunek widoczności, pytanie potwierdzające i grupy, które go widzą.

Kontrola danych i powiadomienia

Dziennik zmian

Kreator → Dziennik zmian zapisuje każde dodanie, zmianę i usunięcie: kto, kiedy, z jakiego adresu IP i jakie były wartości przed zmianą i po niej. W szczegółach rekordu przycisk „Przywróć stan sprzed” cofa wybraną zmianę, a usunięty rekord można przywrócić z dziennika.

Blokada edytowanego rekordu

Gdy ktoś edytuje rekord, pozostali widzą komunikat „Ten rekord edytuje teraz…” i nie mogą go zapisać. Blokada wygasa po 15 minutach bez aktywności (czas można zmienić). Niezależnie od niej działa kontrola wersji: jeśli rekord zmienił się w trakcie edycji, zapis zostanie wstrzymany zamiast nadpisać cudze zmiany.

Duplikaty

W opcjach pola ustawisz „wartość musi być unikalna” (blokada) albo „ostrzegaj” (z przyciskiem „Zapisz mimo to”). W zakładce Automatyzacja — kombinacje kilku pól, np. imię, nazwisko i data urodzenia.

Powiadomienia e-mail

Po dodaniu, zmianie lub usunięciu rekordu dataBAS może wysłać e-mail do stałych adresów, grup, autora rekordu albo na adres zapisany w rekordzie. W treści użyjesz znaczników {nazwa_pola}, {akcja}, {uzytkownik}, {zmiany} i {link}. Wysyłka przez serwer albo SMTP — Ustawienia → E-mail, z przyciskiem testu.

Raporty i pulpity

Raporty i wykresy

W menu Raporty wybierz tabelę, wartość (liczba rekordów, suma, średnia, minimum lub maksimum pola) i grupowanie — dla dat także po dniach, miesiącach, kwartałach i latach. Wynik to wykres (kolumny, słupki, linia, pierścień) i tabela przestawna z sumami, z eksportem do CSV i wydrukiem. Raport możesz też zrobić z bieżącej listy: Lista → Więcej → Raport / wykres.

Wykresy powstają na serwerze, bez zewnętrznych usług, w jasnym i ciemnym motywie. Raporty uwzględniają uprawnienia i filtry wierszy.

Pulpity

Pulpit składa się z kafelków z liczbą (np. „Dostępne książki”), zapisanych raportów i list ostatnich rekordów. Pulpit można ustawić jako stronę startową aplikacji.

Import i wydruki

Import z CSV i Excela

Lista → Więcej → Import. Kodowanie i separator CSV rozpoznają się same; z pliku XLSX czytany jest pierwszy arkusz. Kolumny dopasowują się po nazwach. Powiązania możesz podać nazwą, listy wyboru etykietą, a kwoty np. jako „24,50 zł”.

1. Kliknij Sprawdź — dataBAS zwaliduje cały plik bez zapisu i pokaże błędy z numerami wierszy.
2. Popraw plik i kliknij Importuj.

Tryb „aktualizuj istniejące, dodawaj nowe” rozpoznaje rekordy po wybranym polu. Jednorazowo można zaimportować do 5000 wierszy.

Szablony wydruku

Kreator → Szablony wydruku: dokument HTML ze znacznikami {pole}, {autor_id.nazwisko}, {dzis} i pętlą po rekordach powiązanych {#oceny}…{/oceny}. Drukujesz z widoku rekordu albo dla całej listy (korespondencja seryjna — każdy rekord na nowej stronie). Plik PDF zapiszesz w oknie drukowania przeglądarki („Zapisz jako PDF”).

Wygląd i menu

Kreator → Wygląd i menu: nazwa aplikacji, logo, kolor przewodni i stopka. Własne menu ma do trzech poziomów — tabele, linki i grupy — z widocznością dla wszystkich, zalogowanych, gości albo administratorów.

Do wyboru jest sześć układów menu: z lewej, z prawej, górne z rozwijanymi listami, drzewo, kompaktowe ikony i wysuwane ☰. Na telefonie każdy układ działa spod przycisku ☰. Każdy użytkownik może pracować w jasnym albo ciemnym motywie.

Bezpieczeństwo i logowanie dwuetapowe

Jak dataBAS chroni dane

• Uprawnienia sprawdza serwer — ukryty przycisk to tylko wygoda, nie zabezpieczenie.
• Zapytania przygotowane (PDO); nazwy tabel i kolumn pochodzą wyłącznie z konfiguracji.
• Ochrona CSRF przy każdym zapisie, bezpieczne hasła, limit nieudanych logowań (8 prób w 15 minut).
• Przesyłane pliki: biała lista rozszerzeń, losowe nazwy i wydawanie wyłącznie po sprawdzeniu uprawnień.

Logowanie dwuetapowe (2FA)

Mój profil → Logowanie dwuetapowe. Zeskanuj kod QR aplikacją w telefonie (Google lub Microsoft Authenticator, Authy, 2FAS…) i wpisz kod. Kod QR powstaje na serwerze — klucz nie trafia do żadnej zewnętrznej usługi. Otrzymasz 10 jednorazowych kodów zapasowych na wypadek utraty telefonu.

W Ustawienia → Bezpieczeństwo wybierzesz, czy 2FA jest dobrowolne, wymagane dla administratorów, czy dla wszystkich. Administrator może zresetować 2FA użytkownikowi, który zgubił telefon.

Wersja demonstracyjna

Od wersji 2.1 dataBAS może działać jako publiczne demo: odwiedzający wchodzi jednym kliknięciem, może zmieniać dane, a co kilka godzin wszystko wraca do stanu początkowego.

1. Zainstaluj dataBAS z kontem administratora o innym loginie niż konto demo (np. wlasciciel).
2. W config.php dopisz:

   'demo' => [
       'enabled' => true,
       'logins' => [['label' => 'Wejdź jako gość', 'user' => 'admin', 'pass' => 'admin']],
       'reset_hours' => 3,
   ],

3. Utwórz zwykłego użytkownika admin z hasłem admin i nadaj jego grupie uprawnienia tylko do wybranych tabel.
4. Przygotuj przykładowe dane i zapisz je jako wzorzec: php tools/demo_reset.php zapisz.
5. Na stronie WWW ustaw przycisk wejścia na adres …/index.php?r=login&demo=1.

Konto demo nie ma dostępu do Kreatora ani importu, nie zmieni hasła ani logowania dwuetapowego i nie prześle plików. Poczta jest wyłączona. Przywracanie nie dotyka kont administratorów, klucza licencji ani kluczy API. Zamiast przywracania przy wejściu możesz użyć crona: php tools/demo_reset.php przywroc.

Język interfejsu

dataBAS działa po polsku i po angielsku. Język domyślny ustawisz w Ustawieniach, a każdy użytkownik może wybrać własny w profilu. Goście przełączą język dopiskiem ?lang=en. Panel Kreatora oraz nazwy tabel i pól pozostają w języku, w którym je utworzono.

WordPress i API

Wtyczka „dataBAS dla WordPress”

Wtyczka pokazuje listy, szczegóły i formularze z dataBAS na stronie WordPress. Użytkownicy logują się kontem dataBAS (także z kodem 2FA), a uprawnienia, formuły, pola warunkowe i przyciski akcji działają tak samo jak w aplikacji.

1. W dataBAS wejdź w Kreator → Ustawienia → Integracja z WordPress (API) i włącz API.
2. Skopiuj adres i klucz API.
3. W WordPressie zainstaluj wtyczkę, wklej adres i klucz w jej ustawieniach i wstaw tabelę na stronę.

API dla programistów

Każde żądanie do api.php zawiera nagłówek X-Databas-Key. Zalogowany użytkownik dodaje Authorization: Bearer <token> (token z akcji login). Bez tokenu API działa z uprawnieniami gości.

Licencja i aktywacja

Wersja próbna

Po instalacji dataBAS działa przez 14 dni z pełną funkcjonalnością. Administrator widzi baner z liczbą pozostałych dni. Po tym czasie aplikacja zostaje zablokowana do wpisania klucza.

Aktywacja

1. Klucz DBS-XXXXX-XXXXX-XXXXX-XXXXX otrzymasz e-mailem zaraz po zakupie. Pokazuje się też na stronie po płatności.
2. Zaloguj się do dataBAS jako administrator i wejdź w Kreator → Licencja.
3. Wklej klucz i kliknij Aktywuj.

Aktywacja wymaga połączenia serwera z internetem. Później licencja jest potwierdzana automatycznie co kilka dni; gdy serwer licencji jest chwilowo nieosiągalny, aplikacja działa jeszcze 14 dni.

Domeny i przenoszenie

Plan określa, na ilu domenach działa licencja. Domeny testowe nie zajmują limitu: localhost, adresy w sieci lokalnej, *.test, *.local oraz subdomeny staging., stage., test. i dev..

Aby przenieść dataBAS na inny serwer, kliknij Przenieś na inną domenę na stronie Licencja i aktywuj klucz w nowej instalacji. Domenę zwolnisz też w panelu Moja licencja na tej stronie — przydaje się, gdy stary serwer już nie działa.

Zmiana planu

W panelu Moja licencja możesz dopłacić do wyższego planu. Przy licencji jednorazowej płacisz różnicę cen, a klucz pozostaje ten sam. W dataBAS kliknij potem „Sprawdź teraz”, aby od razu zobaczyć nowy limit.

Kopie zapasowe i aktualizacja

Cała konfiguracja aplikacji — tabele, pola, uprawnienia, raporty, szablony — jest zapisana w bazie danych. Kopia zapasowa to więc kopia bazy (dla SQLite: pliku z katalogu data/) oraz katalogu uploads/ z przesłanymi plikami.

Aby zaktualizować dataBAS, zrób kopię zapasową i wgraj nowe pliki na stare, z wyjątkiem config.php, data/, uploads/ i custom/. Nowe tabele systemowe utworzą się same przy pierwszym uruchomieniu.

Aktualizacja

Cała konfiguracja aplikacji — tabele, pola, uprawnienia, raporty, szablony — jest zapisana w bazie danych. Najprościej zrobisz kopię w Kreator → Kopie zapasowe (opis wyżej). Ręcznie: kopia bazy (dla SQLite: pliku z katalogu data/) oraz katalogu uploads/ z przesłanymi plikami.

Aby zaktualizować dataBAS, zrób kopię zapasową i wgraj nowe pliki na stare, z wyjątkiem config.php, data/, uploads/ i custom/. Nowe tabele systemowe utworzą się same przy pierwszym uruchomieniu.

Dla programistów: haki PHP

Własną logikę dopiszesz w custom/hooks.php (wzór: custom/hooks.example.php). Hak może zmienić dane przed zapisem albo zablokować zapis z komunikatem:

Events::on('before_insert', 'uczniowie', function (array &$data, array $ctx) {
    $data['nazwisko'] = mb_convert_case($data['nazwisko'], MB_CASE_TITLE);
    if (DBS::count('uczniowie', ['pesel' => $data['pesel']])) return 'Uczeń o tym numerze PESEL już jest.';
});

Dostępne zdarzenia: before_ i after_ dla insert, update i delete oraz after_login. Haki działają także dla zapisów przez API i wtyczkę WordPress.