File Downloader

A Magento 2 webáruházak termékeihez és szolgáltatásaihoz sok esetben kapcsolódnak különféle használati utasítások, kézikönyvek, katalógusok, esettanulmányok és egyéb dokumentációk. A modul lehetővé teszi ezen fájlok megjelenítését mind a termékoldalakon, mind összesített formában egy központi gyűjtőoldalon, mely kényelmes elérhetőséget biztosít ezen fájlok letöltéséhez a magánszemélyek és B2B partnerek számára egyaránt.

Vissza a modulokhoz

A modul működése

A modul segítségével kétféleképpen tudunk feltölteni fájlokat webáruházunkba: egyrészt a Magento2 admin felületen keresztül, az Oander/Oander File Downloader menüpont alatt. Ezen funkció azonban egyidejűleg csak egy fájl feltöltését teszi lehetővé. Amennyiben több fájlt szeretnénk feltölteni, arra is van lehetőségünk FTP-n keresztül.


Admin beállítások

Admin oldalon az Oander/Oander File Downloader menüpont alatt érjük el a modul beállításait. 

A Files menüpont a következőket tartalmazza:

  • Listázásra kerül az összes letölthető állomány a következő információkkal, melyek egyben szűrési opcióként is szolgálnak a frontend felületen:

  • Fájl neve

  • Termék neve, amelyhez kapcsolódik

  • Fájl típusa (pl. kép, case study, katalógus, használati utasítás)

  • Fájl nyelve

  • Fájl formátuma (pl. PDF, jpeg, zip)

  • Fájl mérete

  • Státusza (Disabled/Enabled)

  • Fájl feltöltésének dátuma

  • A kiválasztott fájlok egyénileg vagy csoportosan eltávolíthatóak az “Action” gombok alatt található műveletek kiválasztásával

  • Amennyiben új fájlt szeretnénk feltölteni, az “Add New File” gombra kell kattintanunk. Az előzőekben felsorolt paramétereken túl (fájl neve, kategória stb.) itt megadható az is, hogy store view szinten hova tartozzon a feltöltött állomány.


A Categories menüpont alatt vehetjük fel a fájl típusokat, melyek pozíciója meghatározza, hogy milyen sorrendben listázódjanak ki az adott termékhez tartozó letölthető állományok mind termékoldalon, mind a központi gyűjtőoldalon.

Languages menüpont alatt vehetőek fel a fájlokhoz társított nyelvek.

Settings menüpontban elérhető beállítások:

General Settings:

  • Enable: Yes/No

  • Folder of downloadable files: alapértelmezetten, amennyiben üresen hagyjuk ezt a mezőt, az FTP media/oander/filedownloader/file mappájából tudjuk feltölteni a fájlokat a webáruházba. Amennyiben másik mappából szeretnénk feltölteni fájlokat, akkor ide írjuk be annak a mappának a nevét (jellemzően a weboldal neve). Frontend megjelenésben ennek az a szerepe, hogy amikor letöltünk egy fájlt, a képernyő alján a fájl URL-jében ez fog szerepelni. Tehát alapértelmezetten az oander, míg más mappa és elnevezés esetén az adott név.

  • Add category name to file path: Yes/ No értékeket tud felvenni. Bekapcsolva azt eredményezi, hogy ha adminon töltünk fel egy fájlt, amit besorolunk adott kategóriához, akkor ez a fájl FTP-n is bekerül ebbe az almappába. “No” értékkel, default beállításként minden fájlt, ami elérhető a weboldalon, ömlesztve tesz be az FTP File nevű mappájába.

  • Select download page pager size: kiválasztható, hogy hány találatot szeretnénk megjeleníteni a központi gyűjtőoldal táblázatában

  • Group by file names: Amennyiben egy fájl több termékhez is tartozik, lehetőségünk van ezeket csoportosan megjeleníteni frontenden is. Ez jelenleg fejlesztés alatt álló funkció.

  • XML Importer Settings:
  • XML-ből tudunk feltölteni adatokat, így ez a CSV feltöltéssel azonos funkció, projektspecifikusan készült el a modulhoz


File Watchlist Settings:

  • Tesztelés alatt álló funkció, mely lehetővé teszi, hogy a felhasználó bekövessen egy terméket, és amennyiben ehhez a termékhez új fájlt töltünk fel vagy módosítjuk a korábbi fájlokat, akkor erről értesítést kap a user
  • Ez a funkció a downloads modulon belül ki/ és bekapcsolható, tehát kiegészíti az alapmodult, illetve admin felületen meghatározható, hogy a frontend felületen hol jelenjen meg a Watchlist gomb (termékoldal és/vagy kategóriaoldal)
  • Külön engedélyezhetjük az új fájl feltöltéséhez kapcsolható email értesítést, valamint a fájlok módosítása után küldött emailt

Product Image Synchronization Settings:

  • Amennyiben termékképeket töltenek fel, akkor ezen funkció segítségével, automatikusan elérhetőek lesznek ezek a képek a File Downloader gyűjtőoldalon is, illetve a termékoldal File Downloads tabján is, tehát le tudjuk tölteni a termékképeket (Ez manuálisan is történhet a File Downloader/Files/Synchronize Product Images gombbal. Ebben az esetben a korábban létrejött termékképeket is átmenti.)
  • Továbbá hozzárendelhetjük ezeket külön kategóriához is, pl. Product Pictures, és így FTP-n is elérhetővé válnak külön almappában.



FTP-n keresztüli csoportos fájlfeltöltés

A modul lehetővé teszi, hogy FTP-n keresztül csoportosan töltsünk fel fájlokat, illetve almappákba rendszerezzük ezeket a könnyebb kezelhetőség és átláthatóság érdekében.Ennek a feltöltésnek a folyamata a következőképpen zajlik:

Az FTP kliensen belül a media/oander/filedownloader/file mappában érhetjük el és tölthetjük fel a fájlokat. Lehetőség van arra is, hogy projektenként külön mappát hozzunk létre.

Ezeket a mappákat tetszőlegesen tovább bonthatjunk almappákra, amik megegyezhetnek pl. az adminban lévő kategóriákkal (pl. Documents, Blueprints stb.) Ezekbe az almappákba kell betölteni a fájlokat Ezt követően egy CSV fájl segítségével tudjuk felvinni a fájlokhoz tartozó adatokat az adminra

A CSV helyes kitöltése a következőképpen néz ki: fájl elnevezése (ahogy szeretnénk, hogy megjelenjen frontenden), fájl neve (ahogyan ténylegesen el van nevezve az FTP mappában is), kategória neve, nyelv, státusza (hogy megjelen-e), dátum, store view, product ids (azon termékek ID-ja, melyekre vonatkozik) - ez látható a screenshoton is

A CSV fájl adminban a System/ Data Transfer/ Import menüpont alatt tudjuk feltölteni. Természetesen Entity Type-nál a lenyíló menüben a File Downloader opciót válasszuk. Az Import Behavior beállítása határozza meg, hogy mit szeretnénk csinálni a fájlokkal: tehát hozzáadni/módosítani vagy éppen törölni. A Choose File gombra kattintva válasszuk ki a CSV-t.

Fontos megjegyzés: Az FTP-n feltöltött fájlok nevének és a CSV-ben felvitt adatok között a File oszlopnak kell azonosnak lennie, mert ez alapján azonosítja és párosítja a rendszer a fájlokat.

Fájlok hozzárendelése termékhez

A feltöltött fájlokat az adott termék szerkesztő oldalán tudjuk hozzárendelni a termékhez, melyet az Admin/Products/Catalog menüpontból érünk el. A File Downloader - Linked Files pont alatt tudjuk hozzáadni a kiválasztott fájlokat. Továbbá fontos, hogy ezen kapcsolódó termékek kódja a CSV fájlban is szerepeljen, lásd csatolt screenshot.

Frontend megjelenés

Frontend oldalon elsősorban két helyen jelenítjük meg a letölthető állományokat:

Termékoldalon: A modul termékoldalon létrehoz egy tabot, mely táblázat formájában tartalmazza az adott termékhez kapcsolódó dokumentumokat, és egyéb letölthető fájlokat kategóriánként csoportosítva. Ezen kategóriák sorrendje adminban meghatározható, így a legfontosabb fájltípusok kerülnek a táblázat tetejére.

Saját menüpont alatt (központi gyűjtőoldalon): A központi gyűjtőoldalon egy táblázatban érhetjük el az összes letölthető állományt, mely feltöltésre került a weboldalra. A szűrők segítségével szűkíthetjük a találatokat termék név, fájl név, fájl nyelve, valamint a feltöltés dátuma alapján. A szűrőket használva a találati lista ajaxosan frissül.

Ezen kívül külön kereső is tartozik a modulhoz, mellyel közvetlenül a fájl nevére tudunk rákeresni. (Amennyiben termékre szeretnénk szűrni, ahhoz használjuk a “Select Product” szűrőt.)

A Downloads All gomb használatával lehetőségünk van az összes találat egyidejű, zip fájlban tömörített letöltésére. Ez kiváltképp hasznos lehet B2B partnerek számára, hiszen több termékhez tartozó állományt is le tudnak tölteni egyszerre, akár a frissítés időpontjától számítva is.

A Downloads All gombot érdemes korlátozni, hiszen amennyiben sok fájl érhető el a weboldalon, azok egyidejű letöltése túl nagy szerver oldali kapacitást igényel, így akár az oldal le is állhat. Projektenként és a fájlok átlagos méretének függvényében érdemes meghatározni egy keretet.












A következő hibajegyek tartoznak EasyRedmine-ban a termékhez: