Az alkalmazást az adminisztrátor frissíti a Beállítások → Frissítések fülön. A frissítéseket a gyártó szerveréről töltheted le. Az új kiadásokat egy kattintással telepítheted (automatikus telepítő, általában FTP nélkül). FTP-n keresztül a fájlokat az alkalmazás első telepítésekor töltik fel; frissítéskor akkor hasznos a technikai támogatás, ha a szerver nem engedi, hogy az alkalmazás felülírja a saját fájljait. Ha a letöltött csomagban nincs automatikus telepítő, az alkalmazás megjeleníti az FTP-n keresztüli feltöltés útmutatóját.

A frissítések letöltéséhez aktív licenc szükséges (ugyanaz, amely feloldja a mentést az alkalmazásban). A gyártó szervere a verziólistát csak az adott telepítés domainjéhez rendelt kulcs számára teszi elérhetővé. Amikor lejár a kulcsban tárolt frissítési jogosultság, az új verzió gombja Letiltva állapotba kerül, az ok pedig a verziószám alatt és a gombra mutatva is látható.

Dátumhoz kötött frissítésekkel rendelkező licenc esetén a verzió megjelenési dátuma számít (ez minden verziónál látható a listán): a licenc a jogosultság lejártáig megjelent verziókra vonatkozik, az annál újabbakra nem. A program tovább működik - csak az újabb kiadásokat nem tudod letölteni, amíg meg nem újítod a jogosultságot (új kulcs a szolgáltatótól, lásd a licencről szóló fejezetet). A jogosultsági időszak utolsó frissítését érdemes még a lejárat előtt telepíteni: a gyártó szervere általában csak a legújabb kiadást teszi elérhetővé, így e dátum után előfordulhat, hogy a régebbit már nem mutatja.

Automatikus ellenőrzés és értesítés

Az alkalmazás automatikusan ellenőrzi a frissítések elérhetőségét - nem kell minden alkalommal belépni a beállításokba:

  • bejelentkezés után (az alkalmazásba lépéskor),
  • időnként, amíg az alkalmazás nyitva marad,
  • a böngészőfülhöz való visszatéréskor (ha az utolsó ellenőrzés óta eltelt egy kis idő).

Amikor új kiadás jelenik meg, az adminisztrátor rövid értesítést lát („Elérhető frissítés - a(z) X.Y.Z verzió telepítésre kész”) egy Megjelenítés gombbal, amely azonnal megnyitja a Beállítások → Frissítések fület. Az értesítés verziónként egyszer jelenik meg (nem zavar be minden belépéskor) - a következő kiadásról újat kapsz.

Ha az új verziót nem lehet telepíteni (pl. lejárt a frissítési jogosultság), az értesítés ezt egyértelműen közli: „A(z) X.Y.Z verzió elérhető, de nem telepíthető: …” az okkal együtt. Amikor a frissítések a licenckulcs miatt nem érhetők el (nincs kulcs, a kulcs ismeretlen, visszavont, másik domainhez rendelt vagy a szerver számára ismeretlen), az adminisztrátor egyetlen Frissítések nem elérhetők figyelmeztetést kap magyarázattal - a következőt csak akkor, ha a probléma megszűnik, majd újra jelentkezik.

Új verzió jelzője

Az értesítéstől függetlenül, ha újabb verzió érhető el, az adminisztrátor piros pontot lát a fogaskerék ikonon (⚙) a felső menüben, a beállítások megnyitása után pedig ugyanilyen pontot a Frissítések fül mellett. A pont automatikusan eltűnik a legújabb verzió telepítése után. A jelzőt (és az értesítést) kizárólag az adminisztrátorok látják.

Elérhető verziók ellenőrzése

  1. Kattints a fogaskerék ikonra (⚙) → Frissítések fül.

Fejlesztői verzió. Ha az alkalmazás fejlesztői módban fut (a kód közvetlenül a tárolóból), a frissítés-ellenőrzés ki van kapcsolva: nincs piros pont, sem értesítés, a fül pedig egyértelműen közli, hogy fejlesztői verzión dolgozol.

  1. Kattints Frissítések ellenőrzése. Ezeket fogod látni:
    • Telepített verzió - a szerveren futó verzió,
    • Kód verziója - az alkalmazás fájljainak verziója,
    • Elérhető verziók - az újabb kiadások listája, mindegyikhez Változásnaplóval (changelog).

A verziókat sorban kell telepíteni - mindig csak a következő verzió gombja aktív. A többi az előző feltöltése után válik elérhetővé.

Task Manager: a Frissítések fül verziólistával és telepítés gombbal.
Frissítések fül: a szerveren lévő verzió, az újabb kiadások és a változásnaplók listája.

Csomag letöltése

  1. A legközelebbi elérhető verziónál kattints a Letöltés gombra.
  2. Megjelenik egy figyelmeztetés a biztonsági mentésről - frissítés előtt készíts mentést az adatbázisról és a mellékletek mappájáról (uploads/). Erősítsd meg a folytatáshoz.
  3. A szerver letölti a csomagot, és ellenőrzi az ellenőrzőösszegét (SHA-256). Innentől a csomag típusától függően:
    • Automatikus telepítős csomag - megjelenik a Telepítés gomb (leírás lejjebb). Nem kell semmit feltöltened FTP-n keresztül.
    • Manuálisan feltöltendő csomag - a böngésző elmenti a .zip fájlt a gépedre (szükség esetén újra letöltheted a Csomag mentése (.zip) gombbal), és megjelenik az FTP-s útmutató.

Telepítés egy kattintással (auto-telepítő)

Az automatikus telepítést támogató kiadásokhoz nincs szükséged FTP-re:

  1. Letöltés után kattints a Telepítés gombra.
  2. Megjelenik egy folyamatjelző sáv („Telepítés…"), amely mutatja a szakaszokat: adatbázis-migrációk → fájlok másolása → véglegesítés.
  3. A befejezés után a gomb Alkalmazás frissítése felirattá változik - kattints rá az új verzió betöltéséhez (az oldalt is frissítheted a Ctrl/Cmd + Shift + R billentyűkombinációval).

A telepítő nem nyúl az adataidhoz - kihagyja a includes/config.php, uploads/, storage/ és logs/ fájlokat/mappákat, és maga végzi el az esetleges adatbázis-migrációkat. A biztonsági mentést így is érdemes elkészíteni (figyelmeztetés a letöltésnél).

Megjegyzés: a folyamatjelző sáv csak attól a pillanattól teljesen „élő", amikor a telepített verzió már tartalmazza ezt a mechanizmust. Régebbi verzióról indított telepítésnél a sáv ugrásszerűen mutathatja a folyamatot.

Telepítés FTP-n keresztül (auto-telepítő nélküli csomagok)

Ha a csomag nem támogatja az auto-telepítést, az alkalmazás megjeleníti a kézi feltöltés utasítását:

  1. Készíts biztonsági mentést az adatbázisról és az uploads/ mappáról (ha még nem tetted meg).
  2. Csomagold ki a letöltött .zip fájlt.
  3. Csatlakozz a tárhelyhez FTP-n keresztül, és töltsd fel a csomag tartalmát az alkalmazás könyvtárába, felülírva a meglévő fájlokat.
  4. NE írd felül (tartsd meg a sajátodat):
    • includes/config.php - konfiguráció és titkos adatok,
    • uploads/ - mellékletek és avatarok,
    • storage/ - munkaadatok,
    • logs/ - naplók.
  5. Frissítsd az alkalmazást a böngészőben (Ctrl/Cmd + Shift + R), majd kattints újra a Frissítések ellenőrzése gombra, hogy megerősítsd az új verziószámot.

Ha a kiadás változtatásokat vezet be az adatbázisban, az adott kiadás utasítása (changelog / verziómegjegyzés) jelzi a további lépéseket. Kétség esetén először állítsd vissza a biztonsági mentést, és vedd fel a kapcsolatot a szolgáltatóval.

Gyakori kérdések

  • „Nem sikerült csatlakozni a frissítési szerverhez” - ellenőrizd az internetkapcsolatot, valamint hogy érvényes-e a licenc. A verziólistát a rendszer csak érvényes kulccsal rendelkező telepítéseknek teszi elérhetővé. A kapcsolódási hiba technikai leírását (pl. „Could not resolve host…”) a program a „részletek” szó után, zárójelben adja meg - ez hasznos lehet a tárhelyszolgáltató ügyfélszolgálatának.
  • „A legújabb verziót használod” - nincs újabb kiadás a telepítettnél. Ez az üzenet csak akkor jelenik meg, ha a szerver elfogadta a kulcsot - kulcsprobléma esetén az alábbi üzenetek egyikét fogod látni.
  • „Ehhez a telepítéshez nincs licenckulcs…” - add meg a kulcsot itt: Beállítások → Speciális → Licenc; enélkül az alkalmazás egyáltalán nem kérdezi le a verziókat a szervertől.
  • „A frissítési szerver nem ismeri fel a licenckulcsot…” - a kulcs aláírása nem egyezik a gyártó szerverével (sérült kulcs vagy más forrásból származik). Add meg a szolgáltatótól kapott kulcsot, vagy vedd fel vele a kapcsolatot.
  • „Ennek a telepítésnek a licenckulcsa nem szerepel a frissítési szerver adatbázisában…” - a kulcs érvényes, de a gyártó szervere nem ismeri. A szolgáltatónak regisztrálnia kell, vagy újat kell kiállítania.
  • „A licenckulcsot… visszavonták…” - a szolgáltató visszavonta ezt a kulcsot (általában egy új kiállítása után). Add meg az új kulcsot.
  • „A licenckulcs másik domainhez van rendelve…” - a kulcsot más címre állították ki, mint amelyen a program fut. Kérj a szolgáltatótól kulcsot ehhez a domainhez.
  • „A(z) X.Y.Z verzió elérhető, de nem telepíthető: a frissítési jogosultságod ÉÉÉÉ.HH.NN-án lejárt…” - a verziót a frissítési jogosultság lejárta után tették közzé. A program továbbra is működik; a telepítéshez újítsd meg a jogosultságot (új kulcs a szolgáltatótól). A jogosultsági időszakból származó korábbi verziót a lista ilyenkor általában nem mutatja - a gyártó szervere rendszerint csak a legújabb kiadást teszi elérhetővé.
  • „A szerveren hiányzik a „zip” PHP-bővítmény…” - ennek a bővítménynek a hiányában az alkalmazás nem tudja kicsomagolni a csomagot. Kapcsold be a tárhely vezérlőpultján (PHP-beállítások → bővítmények), majd próbáld újra. Az alkalmazás ezt a csomag letöltése előtt ellenőrzi.
  • A verzió feltöltés után nem változott - győződj meg róla, hogy a fájlok a megfelelő könyvtárba kerültek, majd frissítsd az oldalt a gyorsítótár megkerülésével (Ctrl/Cmd + Shift + R).
  • Írási jogosultsággal kapcsolatos üzenet (pl. „Nem sikerült felülírni a fájlt … (írási jogosultság?)”) - a szerver nem engedi, hogy az alkalmazás elmentse saját fájljait. Javítsd ki az alkalmazás könyvtárának jogosultságait a tárhelykezelő panelen vagy FTP-n keresztül, majd ismételd meg a frissítést. A már lefutott migrációk nem futnak le ismét.
  • „Az alkalmazás szervere váratlan választ adott (HTTP …)” - a szervereden futó program hibával leállt, mielőtt válaszolni tudott volna (frissítés ellenőrzésekor vagy letöltésekor). Az okot a tárhelyeden lévő PHP hibanaplója rögzíti - add át azt a támogatásnak.
  • „Zárolva” gomb - az ok a verziószám alatt látható (és a gomb fölé húzott kurzorral is): előbb egy korábbi verziót kell telepíteni, a licenc már nem terjed ki erre a frissítésre (pl. lejárt a frissítési jogosultság), vagy a kiadásnak nincs érvényes kiadói aláírása.