Telepítés és rendszer-ellenőrzés – Felhasználói útmutató

A doliBIT telepítője az OpenCart bővítmény-telepítése után, a modul bekapcsolásakor a telepítő super adminnak egy rendszer-ellenőrző listát mutat: minden, a működéshez szükséges feltételt zöld / sárga / piros jelzéssel, és a hiányzó elemekhez lépésről lépésre útmutatót. A doliBIT telepítése gomb csak akkor aktív, ha minden kötelező feltétel teljesül.

1. Mikor jelenik meg, mit mutat

1. Bővítmények → Telepítő: töltse fel a dolibit.ocmod.zip csomagot, és telepítse (zöld + ikon).
2. Bővítmények → Bővítmények → Modulok: a doliBIT soron a zöld + (Telepítés), majd a kék ceruza (Szerkesztés).
3. Megnyílik a Rendszer-ellenőrzés és telepítés fül. Telepítés előtt csak ez a fül látszik; a többi beállító fül a telepítés után jelenik meg.

A lista csoportjai: PHP (verzió, kiterjesztések, php.ini, letiltott függvények), tárhely és írható mappák, a doliBIT csomag tartalma, külső könyvtárak (Composer), külső programok (Ghostscript, Poppler, qpdf, Tesseract, ImageMagick), adatbázis (verzió, jogok, karakterkészlet), kimenő kapcsolatok és — telepítés után — a futásidejű ellenőrzések (HTTPS, séma-teljesség, cron, cron-titok).

A listát csak a telepítési jog birtokosa látja: super admin (Administrator csoport) és a modul módosítási joga.

2. A színek jelentése

• OK Zöld — rendben.
• Figyelem Sárga — ajánlott vagy opcionális elem hiányzik. A doliBIT működik, egy funkció korlátozott (pl. Tesseract nélkül nincs OCR, a beszkennelt PDF szövege nem olvasható ki).
• Hiányzik Piros — kötelező elem hiányzik; amíg van piros sor, a telepítés gomb nem aktív.

Minden sor jobb szélén a lenyitó (⌄) ikon mutatja, mire kell az elem, és hogyan pótolható — cPanel és VPS (SSH) esetre külön.

3. A telepítés lépésről lépésre

Ha nincs piros sor, a doliBIT telepítése (letöltés ikon) gomb aktív. Megerősítés után a lépések egymás után, külön-külön futnak, és mindegyik mellett látszik az eredmény:

1. Kötelező feltételek ellenőrzése — a szerver újra ellenőriz (a felület elrejtése önmagában nem védelem).
2. Külső könyvtárak — ha hiányoznak, egy gombnyomásra telepíti (5. fejezet).
3. Adatbázis-séma — az alapséma (install/schema/baseline.sql) tábláit hozza létre; meglévő táblához és adathoz nem nyúl.
4. Adatbázis-migrációk — a verziózott módosítások.
5. Alapbeállítások — az alapértékek (aszinkron keret, dokumentum-gyorsítótár, feltöltési mód, NAV-szinkron, cron-titok…), csak a még nem létező kulcsokra.
6. Események, cron-feladatok, indítás — az OpenCart események, az ütemezett feladatok és a doliBIT indító (admin + catalog startup) bejegyzése; ami már létezik, az nem duplikálódik.
7. Befejezés és integritás-ellenőrzés — ha a séma hiányos, a záró üzenet megnevezi a hiányzó táblákat.

A telepítés megismételhető (Telepítés újrafuttatása (javítás)): minden lépés idempotens, meglévő adat nem törlődik.

4. Hiányzó elem pótlása

Nyissa le a piros vagy sárga sort (⌄). A leírás pontosan megmondja, hol kell beállítani — példák:

• PHP-verzió: cPanel → Select PHP Version / MultiPHP Manager → 8.2.
• PHP-kiterjesztés (pl. soap): cPanel → Select PHP Version → Extensions → pipa.
• php.ini érték (pl. max_input_vars): cPanel → MultiPHP INI Editor.
• Külső program (pl. Ghostscript): VPS-en apt install ghostscript; osztott tárhelyen a szolgáltató telepíti.

Pótlás után az Újraellenőrzés (körbeforgó nyíl ikon) gomb frissíti a listát; a Ellenőrzés kapcsolatokkal (földgömb ikon) a NAV, Google és MNB elérhetőségét is megnézi.

5. Külső könyvtárak (Composer) — egy gombnyomásra

A doliBIT külső könyvtárai (Google Drive API, PDF-olvasó, FPDI/FPDF, TCPDF, TNEF) az OpenCart saját könyvtár-mappájába (storage/vendor/) kerülnek, a gyári könyvtárak mellé — külön doliBIT vendor-mappa nincs. A gyári könyvtárakat (Guzzle, Twig…) a doliBIT soha nem írja felül.

• Teljes csomag: a könyvtárakkal épített dolibit.ocmod.zip telepítésekor az OpenCart magától a helyükre másolja őket.
• Egy gombnyomásra: a Könyvtárak telepítése (doboz ikon) gomb akkor látszik, ha van mit telepíteni — a frissítéssel érkezett könyvtárakat másolja, vagy ha a szerveren van Composer, azzal telepít.
• Parancssorból (cPanel → Terminal): php <OpenCart>/extension/dolibit/install/composer/install.php <storage mappa>.

Ha egy új fejlesztés új könyvtárat igényel, az a következő frissítéssel együtt érkezik; a frissítő a helyére teszi (GYIK).

6. Ütemezett feladatok (cron) beállítása cPanelen

A telepítés beírja a doliBIT ütemezett feladatait (háttér-sor, NAV, számla-feldolgozás, GPT-worker, FoxPost…) az OpenCart Bővítmények → Ütemezett feladatok listájába. Ahhoz, hogy fussanak, a tárhelyen percenként el kell indítani az OpenCart cronját:

1. A beállító lapon a Cron-parancs (óra ikon) gomb → OpenCart cron.php (ajánlott). A parancs a vágólapra kerül (a képernyőn nem jelenik meg).
2. cPanel → Cron Jobs → Common Settings: Once Per Minute → Command: beillesztés → Add New Cron Job.
3. Néhány perc múlva Újraellenőrzés: a „Cron fut" sor zöld lesz.

Ha a tárhely csak URL-hívást enged ütemezni, válassza a Worker URL (titokkal) változatot. Az URL egy titkos kulcsot tartalmaz — a telepítés generálja —, ezért kívülről, a kulcs nélkül senki nem indíthatja el a háttérfeladatokat. A kulcsot ne ossza meg.

7. Alapbeállítások és telepítés-saját beállítások

Telepítés után megjelennek a beállító fülek (Általános, NAV, Számla, Dokumentumok). Az alapértékeket a telepítés már beírta — csak azt kell módosítani, ami eltér. A Telepítés-saját beállítások fül (csak super admin) a telepítéshez tartozó, a csomagba nem kerülő adatokat kezeli (pl. levelező-fiókok JSON-ban, jelszavakkal) — ezek soha nem kerülnek a kódba vagy a frissítő csomagba.

8. Magyar nyelvi csomag — mikor telepítsük?

Javasolt sorrend: 1) OpenCart core telepítése → 2) magyar nyelvi csomag (hungarian.ocmod.zip: Telepítő, majd Bővítmények → Nyelvek, és a Rendszer → Beállítások alatt az admin nyelve) → 3) doliBIT telepítése. Így már a rendszer-ellenőrző lista és a telepítő is magyarul jelenik meg.

Fordított sorrendben is működik: a doliBIT a saját magyar (és német) szövegeit a saját mappájából tölti, a nyelvi csomagtól függetlenül — a nyelvi csomag az OpenCart core feliratait fordítja. A doliBIT frissítése ezért nem igényli a nyelvi csomag újratelepítését.

9. Gyakori kérdések

• A telepítés gomb szürke. Van piros sor — nyissa le, és kövesse a leírást, majd Újraellenőrzés.
• „Adatbázis-séma teljessége" piros telepítés után. Az alapséma egy táblája hiányzik; a Telepítés újrafuttatása (javítás) pótolja. A sárga „Csak a kódban hivatkozott táblák" sor tájékoztató: régi kódágak, a rendszer nélkülük működik.
• Mi kerül az exportba? A táblák szerkezete és a működéshez szükséges rendszer-törzsadat (fizetési módok, számlatípusok, ÁFA-kulcsok, számlatükör, naptárak, jogosultság- és csomag-katalógus) — ügyfél-, partner-, számla- és személyes adat nem.
• Megvan az indító (startup) a catalog oldalon? Igen: Bővítmények → Indítás alatt két sor (admin + catalog). A telepítő csak hiányzó sort vesz fel.
• Új könyvtárat igényel egy fejlesztés. A frissítés hozza; a frissítő a közös vendor-mappába másolja, a rendszer-ellenőrzés „A kiadással érkezett könyvtárak telepítve" sora mutatja.