# DataFirefly Custom Textile Printing: nadruk na odzieży w PrestaShop

> Przegląd Moduł dodaje blok znakowania pod przyciskiem dodania do koszyka wybranych produktów. Klient wpisuje ilości dla każdego rozmiaru, zaznacza miejsca, wybiera technikę i liczbę kolorów, przesyła plik i widzi cenę…

- Strona: <https://www.datafirefly.com/pl/documentation/dftextileprint/>
- Język: pl
- Zaktualizowano: 2026-09-24
- Inne języki: [fr](https://www.datafirefly.com/documentation/dftextileprint/index.md), [en](https://www.datafirefly.com/en/documentation/dftextileprint/index.md), [es](https://www.datafirefly.com/es/documentation/dftextileprint/index.md), [de](https://www.datafirefly.com/de/documentation/dftextileprint/index.md), [it](https://www.datafirefly.com/it/documentation/dftextileprint/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftextileprint/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftextileprint/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Przegląd

Moduł dodaje blok znakowania pod przyciskiem dodania do koszyka wybranych produktów. Klient wpisuje ilości dla każdego rozmiaru, zaznacza miejsca, wybiera technikę i liczbę kolorów, przesyła plik i widzi cenę liczoną na żywo. Szczegóły znakowania trafiają do zamówienia i na fakturę dzięki natywnej personalizacji PrestaShop. Po zamówieniu obieg statusów obsługuje przesyłanie plików, proof i produkcję.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wyślij plik ZIP `dftextileprint`.
2. Moduł tworzy swoje tabele, ukryty produkt `DF-TEXTILE-SETUP` na koszty przygotowania oraz menu **Katalog > Znakowanie tekstyliów**.
3. Tworzone są dane demo: sitodruk, haft i flex z tabelami oraz sześć miejsc (lewa pierś, przód, plecy, kark, dwa rękawy). Możesz je dowolnie zmieniać lub usuwać.

Nie usuwaj produktu `DF-TEXTILE-SETUP`. Jeśli zniknie, moduł utworzy go ponownie przy zapisie ustawień.

## Ustawienia

W zakładce **Ustawienia** modułu:

- **Koszty przygotowania w koszyku**: osobna pozycja (jedna na znakowanie) lub rozłożone w cenie za sztukę. Dotyczy nowych znakowań.
- **Reguła podatkowa kosztów**: podatek produktu kosztów.
- **Grupa atrybutów rozmiaru**: zostaw automatyczne wykrywanie, jeśli grupa nazywa się Rozmiar, Size, Taille, Größe itp.
- **Maksymalny rozmiar pliku** i **akceptowane typy**. Faktyczny limit ogranicza konfiguracja PHP serwera (upload_max_filesize, post_max_size); jeśli Twoja wartość jest wyższa, pojawi się ostrzeżenie.
- **Plik obowiązkowy**: bez tej opcji klient może zamówić i przesłać plik później.
- **Znakowanie tekstem**: dostępne czcionki i kolory tekstu (jeden na linię w formacie Nazwa=#hex).
- **Po zamówieniu**: obsługa proofów na koncie klienta, termin automatycznego przypomnienia, automatyczne statusy zamówień, e-mail powiadomień pracowni.

## Techniki i tabele cen

Każda technika ma:

- **tabelę cen netto za sztukę**: jeden wiersz na próg ilościowy („od 10”, „od 25”...) i jedną kolumnę na liczbę kolorów;
- **minimalną ilość** (na przykład 10 sztuk dla sitodruku);
- **tryb kosztów przygotowania**: za kolor (sita), za projekt (program hafciarski, plik wycinania) lub brak;
- **tabelę kosztów** malejących wraz z ilością.

Liczy się suma wszystkich rozmiarów i kolorów produktu w znakowaniu. Ceny wpisuje się netto w walucie domyślnej, a moduł przelicza je automatycznie.

## Miejsca nadruku

Miejsce ma nazwę, stronę (przód lub tył), położenie na podglądzie, maksymalny rozmiar nadruku w milimetrach, opcjonalną dopłatę za sztukę i listę dozwolonych technik (brak zaznaczenia oznacza wszystkie). Ustaw je myszką w edytorze: przeciągnij prostokąt, a róg, aby zmienić rozmiar.

Opcja **Znakowanie tekstem** pozwala klientowi wpisać ten sam tekst na wszystkie sztuki lub jedną linię na sztukę (imiona i numery), zamiast pliku lub dodatkowo.

## Produkty i kategorie

Znakowanie włącza się regułami dla produktu lub kategorii. Reguła produktu ma pierwszeństwo przed regułami kategorii, a nieaktywna reguła produktu wyłącza znakowanie dla tego produktu. Dla każdej reguły:

- **Kształt odzieży**: koszulka, bluza z kapturem, torba lub czapka;
- **Znakowanie obowiązkowe**: ukrywa natywny przycisk koszyka, klient zawsze przechodzi przez blok znakowania;
- **Dostępne miejsca i techniki**: w razie potrzeby zawęź listę;
- **Podgląd**: sylwetka w kolorze kombinacji lub zdjęcia produktu.

### Podgląd na zdjęciach i kalibracja stref

W trybie zdjęć podaj pozycję zdjęcia przodu i tyłu w kolejności zdjęć produktu (0 zostawia sylwetkę dla tyłu). Zdjęcia przypisane do kombinacji mają pierwszeństwo, więc każdy kolor pokazuje swoje zdjęcie. Następnie ustaw każdą strefę na zdjęciu w edytorze; dla reguły kategorii wybierz przykładowy produkt sfotografowany tak jak pozostałe.

## Ścieżka klienta

1. Klient wpisuje ilości dla rozmiarów. Inne wpisane wcześniej kolory pozostają na liście „Również w tym zamówieniu”.
2. Zaznacza jedno lub kilka miejsc, wybiera technikę i liczbę kolorów, sprawdza ceny progowe.
3. Przesyła plik przyciskiem lub przeciągając, a potem przesuwa i skaluje logo na podglądzie. Wskaźnik rozdzielczości ostrzega, gdy plik jest za słaby do danego rozmiaru nadruku.
4. Podsumowanie pokazuje odzież, znakowanie, koszty przygotowania i sumę, z podpowiedzią o następnym progu. Klient może **pobrać wycenę** lub **dodać do koszyka**.

Uwzględniane są natywne rabaty ilościowe produktu i sztuki już w koszyku. Jeśli ten sam plik jest już w koszyku na innym produkcie, w tym samym miejscu, z tą samą techniką i liczbą kolorów, próg liczony jest od sumy, a koszt przygotowania naliczany tylko raz.

## Koszyk, zamówienie i faktura

Każda pozycja rozmiaru i koloru zawiera cenę znakowania za sztukę i jego podsumowanie. Pozycja kosztów przygotowania jest zablokowana na jednej sztuce i nie da się jej usunąć osobno; znika razem ze znakowaniem. Jeśli produkt ma promocję procentową, moduł ją kompensuje, aby znakowanie kosztowało tyle, ile w Twojej tabeli.

## Po zamówieniu: pliki, proofy i statusy

Każde zamówione znakowanie ma status: oczekiwanie na plik, plik otrzymany, proof do akceptacji, poproszono o zmiany, proof zaakceptowany, w produkcji, zakończone.

- **Po stronie klienta**: ze szczegółów zamówienia lub z bezpiecznego linku w e-mailu (działa też dla gości) klient przesyła brakujący plik, otwiera proof, akceptuje go lub prosi o zmiany z komentarzem i może jednym kliknięciem zamówić to samo znakowanie ponownie.
- **Po stronie sklepu**: panel **Znakowanie tekstyliów** na stronie zamówienia pokazuje podgląd, podział na rozmiary, pliki, uwagi i historię. Tam wysyłasz proof (obraz lub PDF) i zmieniasz status, opcjonalnie z e-mailem do klienta.
- **Przypomnienia**: e-mail z przypomnieniem wychodzi raz, gdy proof lub plik czeka dłużej niż wybrany termin. Działają przy ruchu w sklepie; możesz też wywoływać adres cron podany w Ustawieniach.
- **Status zamówienia**: wybierz status PrestaShop ustawiany, gdy wszystkie znakowania są w produkcji, a potem zakończone.

## Zakładka Produkcja i karta produkcyjna

Zakładka **Produkcja** pokazuje wszystkie zamówione znakowania według pilności, z filtrem statusu i wyszukiwaniem po zamówieniu, kliencie lub produkcie. Zaznacz kilka wierszy, aby zmienić ich status naraz lub wydrukować karty. **Karta produkcyjna** zawiera podgląd, podział na rozmiary z polami wyboru, miejsca, miniaturę pliku, uwagi i listę imion. Listy imion można też wyeksportować do CSV z zamówienia.

## Rozwiązywanie problemów

- **Blok się nie pojawia**: sprawdź, czy aktywna reguła obejmuje produkt i czy dostępne jest co najmniej jedno aktywne miejsce i technika.
- **Rozmiary nie są wykrywane**: wybierz grupę atrybutów rozmiaru w Ustawieniach.
- **Przesyłanie pliku się nie udaje**: porównaj rozmiar pliku z pokazanym limitem; w razie potrzeby zwiększ upload_max_filesize i post_max_size u dostawcy hostingu.
- **Zmiany szablonów nie widać po aktualizacji**: wyczyść pamięć podręczną w **Zaawansowane > Wydajność**.
- **Pracownik nie może wysłać proofu**: potrzebuje uprawnień edycji zamówień lub modułu.
