Aplikację aktualizuje administrator w zakładce Ustawienia → Aktualizacje. Aktualizacje pobiera się z serwera producenta. Nowe wydania instaluje się jednym kliknięciem (auto‑instalator, zwykle bez FTP). Przez FTP wgrywa się pliki przy pierwszej instalacji programu; przy aktualizacji pomoc techniczna przyda się wtedy, gdy serwer nie pozwala aplikacji nadpisać jej plików. Gdyby pobrana paczka nie miała auto-instalatora, aplikacja pokaże instrukcję wgrania przez FTP.

Pobranie aktualizacji wymaga aktywnej licencji (tej samej, która odblokowuje zapis w aplikacji). Listę wersji serwer producenta udostępnia tylko dla klucza przypisanego do domeny tej instalacji. Gdy skończy się uprawnienie do aktualizacji zapisane w kluczu, przycisk nowej wersji ma stan Zablokowane, a powód widać pod numerem wersji i po najechaniu na przycisk kursorem.

Przy licencji z aktualizacjami do daty liczy się data opublikowania wersji (widoczna przy każdej wersji na liście): licencja obejmuje wersje opublikowane do końca uprawnienia, nowszych nie. Program działa dalej - nie pobierzesz tylko nowszych wydań, dopóki nie odnowisz uprawnienia (nowy klucz od dostawcy, patrz rozdział o licencji). Ostatnią aktualizację z okresu uprawnienia najlepiej zainstalować przed jego końcem: serwer producenta udostępnia zwykle tylko najnowsze wydanie, więc po tej dacie starszego może już nie pokazać.

Automatyczne sprawdzanie i powiadomienie

Aplikacja sama sprawdza dostępność aktualizacji - nie trzeba już za każdym razem wchodzić w ustawienia:

  • po zalogowaniu (przy wejściu do aplikacji),
  • co jakiś czas, gdy aplikacja pozostaje otwarta,
  • po powrocie do karty przeglądarki (jeśli od ostatniego sprawdzenia minęło trochę czasu).

Gdy pojawi się nowe wydanie, administrator zobaczy krótkie powiadomienie („Dostępna aktualizacja - wersja X.Y.Z jest gotowa do zainstalowania") z przyciskiem Pokaż, który od razu otwiera Ustawienia → Aktualizacje. Powiadomienie pokazuje się raz na daną wersję (nie naprzykrza się przy każdym wejściu) - o kolejnym wydaniu dostaniesz nowe.

Jeśli nowej wersji nie da się zainstalować (np. skończyło się uprawnienie do aktualizacji), powiadomienie mówi to wprost: „Wersja X.Y.Z jest dostępna, ale nie można jej zainstalować: …” razem z powodem. Gdy aktualizacje są niedostępne z powodu klucza licencyjnego (brak klucza, klucz nierozpoznany, odwołany, przypisany do innej domeny albo nieznany serwerowi), administrator dostaje jedno ostrzeżenie Aktualizacje niedostępne z wyjaśnieniem - kolejne dopiero wtedy, gdy problem zniknie i wróci.

Wskaźnik nowej wersji

Niezależnie od powiadomienia, gdy dostępna jest nowsza wersja, administrator widzi czerwoną kropkę na ikonie koła zębatego (⚙) w górnym menu, a po otwarciu ustawień - taką samą kropkę obok zakładki Aktualizacje. Kropka znika automatycznie po zainstalowaniu najnowszej wersji. Wskaźnik (i powiadomienie) widzą wyłącznie administratorzy.

Sprawdzenie dostępnych wersji

  1. Kliknij ikonę koła zębatego (⚙) → zakładka Aktualizacje.

Wersja deweloperska. Jeśli aplikacja działa w trybie deweloperskim (kod wprost z repozytorium), sprawdzanie aktualizacji jest wyłączone: nie ma czerwonej kropki ani powiadomień, a zakładka mówi wprost, że pracujesz na wersji deweloperskiej.

  1. Kliknij Sprawdź aktualizacje. Zobaczysz:
    • Zainstalowana wersja - wersja działająca na serwerze,
    • Wersja kodu - wersja plików aplikacji,
    • Dostępne wersje - lista nowszych wydań z Listą zmian (changelog) każdego z nich.

Wersje instaluje się po kolei - aktywny jest tylko przycisk następnej wersji. Kolejne udostępnią się po wgraniu poprzedniej.

Task Manager: zakładka Aktualizacje z listą wersji i przyciskiem instalacji.
Zakładka Aktualizacje: wersja na serwerze, nowsze wydania i lista zmian.

Pobranie paczki

  1. Przy najbliższej dostępnej wersji kliknij Pobierz.
  2. Pojawi się ostrzeżenie o kopii zapasowej - przed aktualizacją wykonaj backup bazy danych oraz folderu załączników (uploads/). Potwierdź, aby kontynuować.
  3. Serwer pobierze paczkę i zweryfikuje jej sumę kontrolną (SHA‑256). Dalej zależnie od rodzaju paczki:
    • Paczka z auto‑instalatorem - pojawi się przycisk Zainstaluj (opis niżej). Nie musisz nic wgrywać przez FTP.
    • Paczka do wgrania ręcznego - przeglądarka zapisze plik .zip na Twój dysk (w razie potrzeby pobierzesz go ponownie przyciskiem Zapisz paczkę (.zip)) i pokaże instrukcję FTP.

Instalacja jednym kliknięciem (auto‑instalator)

Dla wydań wspierających auto‑instalację nie potrzebujesz FTP:

  1. Po pobraniu kliknij Zainstaluj.
  2. Pojawi się pasek postępu („Instalowanie…") pokazujący etapy: migracje bazy → kopiowanie plików → finalizacja.
  3. Po zakończeniu przycisk zmieni się w Odśwież aplikację - kliknij go, aby wczytać nową wersję (możesz też odświeżyć stronę Ctrl/Cmd + Shift + R).

Instalator nie rusza Twoich danych - pomija includes/config.php, uploads/, storage/ i logs/, oraz sam wykonuje ewentualne migracje bazy danych. Kopię zapasową i tak warto mieć (ostrzeżenie przy pobieraniu).

Uwaga: pasek postępu jest w pełni „na żywo" dopiero od momentu, gdy zainstalowana wersja zawiera już ten mechanizm. Przy instalacji ze starszej wersji pasek może pokazać postęp skokowo.

Instalacja przez FTP (paczki bez auto‑instalatora)

Gdy paczka nie wspiera auto‑instalacji, aplikacja pokaże instrukcję ręcznego wgrania:

  1. Wykonaj kopię zapasową bazy danych i folderu uploads/ (jeśli jeszcze tego nie zrobiłeś).
  2. Rozpakuj pobrany plik .zip.
  3. Połącz się z hostingiem przez FTP i wgraj zawartość paczki do katalogu aplikacji, nadpisując dotychczasowe pliki.
  4. NIE nadpisuj (zachowaj swoje):
    • includes/config.php - konfiguracja i sekrety,
    • uploads/ - załączniki i avatary,
    • storage/ - dane robocze,
    • logs/ - logi.
  5. Odśwież aplikację w przeglądarce (Ctrl/Cmd + Shift + R) i ponownie kliknij Sprawdź aktualizacje, aby potwierdzić nowy numer wersji.

Jeśli wydanie wprowadza zmiany w bazie danych, instrukcja danego wydania (changelog / nota wersji) wskaże dodatkowe kroki. W razie wątpliwości najpierw przywróć kopię zapasową i skontaktuj się z dostawcą.

Najczęstsze pytania

  • „Nie udało się połączyć z serwerem aktualizacji" - sprawdź połączenie z internetem oraz czy licencja jest ważna. Lista wersji jest udostępniana tylko instalacjom z ważnym kluczem. Techniczny opis błędu połączenia (np. „Could not resolve host…”) program dopisuje w nawiasie po słowie „szczegóły” - przyda się pomocy technicznej hostingu.
  • „Masz najnowszą wersję" - nie ma nowszego wydania niż zainstalowane. Ten komunikat pojawia się wyłącznie wtedy, gdy serwer uznał klucz - przy problemie z kluczem zobaczysz jeden z komunikatów niżej.
  • „Ta instalacja nie ma klucza licencyjnego…” - wpisz klucz w Ustawienia → Zaawansowane → Licencja; bez niego aplikacja w ogóle nie pyta serwera o wersje.
  • „Serwer aktualizacji nie rozpoznaje klucza licencyjnego…” - podpis klucza nie zgadza się z serwerem producenta (klucz uszkodzony albo z innego źródła). Wpisz klucz otrzymany od dostawcy albo skontaktuj się z nim.
  • „Klucza licencyjnego tej instalacji nie ma w bazie serwera aktualizacji…” - klucz jest poprawny, ale serwer producenta go nie zna. Dostawca musi go zarejestrować albo wystawić nowy.
  • „Klucz licencyjny… został odwołany…” - dostawca odwołał ten klucz (zwykle po wystawieniu nowego). Wpisz nowy klucz.
  • „Klucz licencyjny jest przypisany do innej domeny…” - klucz wystawiono na inny adres niż ten, pod którym działa program. Poproś dostawcę o klucz dla tej domeny.
  • „Wersja X.Y.Z jest dostępna, ale nie można jej zainstalować: Twoje uprawnienie do aktualizacji skończyło się DD.MM.RRRR…” - wersję opublikowano po końcu uprawnienia do aktualizacji. Program działa dalej; żeby ją zainstalować, odnów uprawnienie (nowy klucz od dostawcy). Starszej wersji z okresu uprawnienia lista wtedy zwykle nie pokazuje - serwer producenta udostępnia tylko najnowsze wydanie.
  • „Na serwerze brakuje rozszerzenia PHP „zip”…” - bez tego rozszerzenia aplikacja nie rozpakuje paczki. Włącz je w panelu hostingu (ustawienia PHP → rozszerzenia) i spróbuj ponownie. Aplikacja sprawdza to przed pobraniem paczki.
  • Wersja po wgraniu się nie zmieniła - upewnij się, że pliki trafiły do właściwego katalogu i odśwież stronę z pominięciem pamięci podręcznej (Ctrl/Cmd + Shift + R).
  • Komunikat o prawach zapisu (np. „Nie udało się nadpisać pliku … (prawa zapisu?)”) - serwer nie pozwala aplikacji zapisać jej plików. Popraw uprawnienia katalogu aplikacji w panelu hostingu albo przez FTP i ponów aktualizację. Migracje, które już się wykonały, nie zostaną powtórzone.
  • „Serwer aplikacji zwrócił nieoczekiwaną odpowiedź (HTTP …)” - program na Twoim serwerze zakończył się błędem, zanim zdążył odpowiedzieć (przy sprawdzaniu albo pobieraniu aktualizacji). Przyczynę zapisuje log błędów PHP na hostingu - przekaż go pomocy technicznej.
  • Przycisk „Zablokowane” - powód widać pod numerem wersji (i po najechaniu na przycisk kursorem): najpierw trzeba zainstalować wcześniejszą wersję, licencja nie obejmuje już tej aktualizacji (np. skończyło się uprawnienie do aktualizacji) albo wydanie nie ma ważnego podpisu wydawcy.