Order Attachment dla Magento 2

MAGENTO 2 · CHECKOUT · PLIKI · ZAMÓWIENIA

Kowal Order Attachment

Dodaj do checkoutu pole zdjęcia lub PDF, widoczne dla wszystkich zamówień albo wybranych produktów. Powiąż załącznik z zakupem i udostępnij go uprawnionej obsłudze w panelu Magento.

JPG, PNG i PDF · Walidacja backendowa · Pliki poza pub/media

JAK TO DZIAŁA W PRAKTYCE

Order Attachment to praktyczny moduł Magento 2 dla sklepów, które potrzebują zbierać od klientów dodatkowe pliki powiązane z zamówieniem. Rozszerzenie sprawdza się szczególnie tam, gdzie do realizacji zakupu potrzebne są zdjęcia, skany, dokumenty PDF, projekty graficzne, potwierdzenia, recepty, formularze lub inne materiały przekazywane przez klienta.

Moduł dodaje bezpieczne pole załącznika w checkout i zapisuje plik razem z zamówieniem. Formularz może być widoczny dla wszystkich zamówień albo tylko wtedy, gdy koszyk zawiera produkt oznaczony jako wymagający załącznika. Dzięki temu sklep nie wymusza uploadu tam, gdzie nie jest potrzebny, a jednocześnie może precyzyjnie obsłużyć produkty wymagające dodatkowych danych.

Najważniejszą zaletą modułu jest kontrola nad momentem i bezpieczeństwem przesyłania pliku. Załącznik jest walidowany po stronie backendu, przechowywany poza publicznym katalogiem oraz udostępniany administratorom wyłącznie przez zabezpieczone akcje panelu Magento. To ogranicza ryzyko przypadkowego ujawnienia plików klientów i eliminuje problem publicznych linków do prywatnych dokumentów.

Po złożeniu zamówienia administrator widzi załącznik bezpośrednio w podglądzie zamówienia. Może pobrać plik albo otworzyć jego podgląd, jeżeli format jest obsługiwany. Obsługiwane są popularne formaty zdjęć oraz PDF, a dozwolone rozszerzenia i maksymalny rozmiar pliku można skonfigurować w panelu administracyjnym.

• Globalne włączenie lub wyłączenie modułu w konfiguracji Magento.
• Warunkowe wyświetlanie pola uploadu w checkout.
• Obsługa konfiguracji per produkt przez atrybut produktu.
• Możliwość wymagania załącznika tylko dla wybranych SKU.
• Upload zdjęć i plików PDF.
• Backendowa walidacja rozszerzenia, MIME type i rozmiaru pliku.
• Bezpieczny zapis plików poza katalogiem publicznym.
• Powiązanie załącznika z konkretnym zamówieniem.
• Link do pobrania pliku w panelu administracyjnym.
• Podgląd obsługiwanych plików w widoku zamówienia.
• Automatyczne czyszczenie starych plików tymczasowych.

Moduł jest przeznaczony dla sklepów Magento 2, które sprzedają produkty lub usługi wymagające dodatkowego pliku od klienta, np.:

• produkty personalizowane,
• druk i poligrafia,
• usługi graficzne,
• produkty medyczne lub optyczne wymagające dokumentów,
• zamówienia wymagające zdjęcia referencyjnego,
• produkty B2B wymagające potwierdzeń lub formularzy.

• Mniej ręcznej komunikacji mailowej po złożeniu zamówienia.
• Mniejsze ryzyko zgubienia pliku, ponieważ załącznik trafia bezpośrednio do zamówienia.
• Lepszy proces obsługi produktów wymagających dodatkowych danych.
• Większa kontrola nad bezpieczeństwem plików klientów.
• Prostsza praca zespołu administracyjnego w panelu Magento.

Administrator może ustawić w panelu:

• czy moduł jest aktywny,
• kiedy pole załącznika ma być widoczne,
• czy załącznik jest wymagany,
• jakie rozszerzenia plików są dozwolone,
• jaki jest maksymalny rozmiar pliku,
• czy załącznik ma być widoczny w podglądzie zamówienia,
• czy dostępny jest podgląd pliku.

Moduł został zaprojektowany z założeniem, że każdy przesłany plik jest niezaufany. Dlatego pliki są walidowane po stronie serwera, otrzymują bezpieczne nazwy techniczne i nie są publikowane jako bezpośrednie URL-e w pub/media. Pobieranie i podgląd odbywają się przez kontrolery administracyjne chronione uprawnieniami Magento.

Stores → Configuration → Sales → Order Attachments pozwala ustawić widoczność, wymaganie, tytuł, opis, formaty, limit oraz podgląd. Domyślnie moduł jest wyłączony, formularz dotyczy wybranych produktów, a limit wynosi 10 MB.

Obsługiwane rozszerzenia to jpg, jpeg, png i pdf. requires_order_attachment oznacza produkt wymagający pola; koszyk sprawdza także produkty potomne. Widoczność formularza i obowiązek dodania pliku są osobnymi ustawieniami.

Aktualny checkout obsługuje jeden plik, jego usunięcie i ponowny upload. Walidator odrzuca pusty lub za duży plik, sprawdza rozszerzenie i MIME z zawartości, a dla PDF także sygnaturę %PDF-.

Nazwa z więcej niż jedną kropką jest odrzucana, np. projekt.wersja.pdf. Lista konfiguracji nie rozszerza obsługi na formaty bez mapy MIME w module. Te kontrole nie zastępują dodatkowego skanera plików, jeśli wymaga go proces sklepu.

Upload jest przypisany do quote i zapisywany tymczasowo poza publicznym katalogiem. Po utworzeniu zamówienia plik jest przenoszony do jego lokalizacji, a cron usuwa stare pliki tymczasowe.

Podgląd i pobieranie wymagają uprawnienia View Order Attachments oraz dostępu do zamówienia. Configuration modułu jest osobnym uprawnieniem. Można też wejść przez kowal.store → Modules → Order Attachments → Configuration.

Formularz jest komponentem standardowego checkoutu Magento. Hyvä, alternatywny checkout oraz headless wymagają sprawdzenia i własnej integracji interfejsu uploadu.

Wymaganie jest kontrolowane również podczas quote submit, więc zamówienia przez API lub inne ścieżki muszą zapewnić zgodne powiązanie załącznika. Nie należy zakładać, że brak formularza w danym interfejsie wyłącza walidację backendu.

Pakiet kowal/module-order-attachment, moduł Kowal_OrderAttachment. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.

1. Ustalasz widoczność i wymaganie
Konfigurujesz tryb oraz oznaczasz wybrane produkty.

2. Klient przesyła plik
Backend sprawdza format, zawartość i rozmiar.

3. Obsługa otrzymuje załącznik
Po zakupie plik trafia do widoku zamówienia.

Produkt oznaczasz atrybutem Requires Order Attachment. Przy takim koszyku klient widzi pole uploadu i przesyła zdjęcie przed zakupem.

Po złożeniu zamówienia uprawniony administrator może pobrać plik lub otworzyć obsługiwany podgląd. Materiał pozostaje powiązany z konkretnym zamówieniem.