# Formularz Dostawy Towarów Ciężkich: przewodnik instalacji i konfiguracji

> Moduł Formularz Dostawy Towarów Ciężkich i Wielkogabarytowych wyświetla na etapie przewoźnika w checkoucie ankietę warunków dostępu (piętro, winda, schody, wąskie przejścia, przeszkody) dla produktów ciężkich lub wielkogabarytowych: mebli, AGD, telewizorów…

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

Moduł **Formularz Dostawy Towarów Ciężkich i Wielkogabarytowych** wyświetla na etapie przewoźnika w checkoucie ankietę warunków dostępu (piętro, winda, schody, wąskie przejścia, przeszkody) dla produktów ciężkich lub wielkogabarytowych: mebli, AGD, telewizorów dużego formatu, wyposażenia biurowego czy medycznego. Pola są w pełni konfigurowalne z panelu administracyjnego, bez pisania choćby linii kodu.

Moduł jest rozwijany dla PrestaShop 8.0 do 9.x, zgodny z multisklepem i wielojęzyczny. Nie używa żadnych zależności zewnętrznych: czysty JavaScript, bez jQuery i bez Composera.

## Instalacja

1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów** i kliknij **Zainstaluj moduł**.
2. Wybierz plik `dfdeliveryform.zip` i uruchom instalację.
3. Po zakończeniu instalacji kliknij **Konfiguruj**, aby przejść do ustawień.

Podczas instalacji moduł automatycznie tworzy tabele, rejestruje hooki i wstępnie instaluje zestaw **17 gotowych pól** (godziny obecności, dojazd samochodu ciężarowego, odległość parkowania, piętro, winda, schody, wąskie przejścia, przeszkody, potwierdzenie poprawności danych). Możesz je zachować, zmodyfikować albo zacząć od zera.

## Ustawienia ogólne

Strona konfiguracji dzieli się na dwie strefy: **ustawienia** (na górze) i **kreator pól** (na dole).

- **Włącz moduł**: pokazuje lub ukrywa formularz po stronie sklepu.
- **Blokuj checkout do czasu wypełnienia**: gdy włączone, klient nie może zatwierdzić etapu dostawy przed wysłaniem formularza. Gdy wyłączone, formularz pozostaje opcjonalny.
- **Tryb wyzwalania**: określa, kiedy formularz się pojawia (patrz następna sekcja).
- **E-mail powiadomienia**: adres, który otrzymuje wypełniony formularz przy walidacji zamówienia. Pozostaw puste, aby użyć adresu sklepu.
- **Tytuł formularza** oraz **Tekst wprowadzający**: personalizowane per język.

## Tryby wyzwalania

Formularz powinien pojawiać się tylko przy zamówieniach, których dotyczy. Dostępne są cztery tryby:

- **Wszystkie zamówienia**: formularz wyświetla się zawsze.
- **Próg wagi produktu**: formularz pojawia się, gdy dowolny produkt w koszyku osiągnie zdefiniowaną wagę (domyślnie 30 kg). Idealne dla AGD i mebli. Używana jest waga jednostkowa produktu wpisana na jego karcie.
- **Konkretne produkty**: wpisz listę identyfikatorów produktów rozdzielonych przecinkami (np. `12,45,102`).
- **Konkretne kategorie**: wpisz listę identyfikatorów kategorii rozdzielonych przecinkami. Każdy produkt należący do jednej z tych kategorii wyzwala formularz.

Formularz pokazuje klientowi listę produktów z jego koszyka, których dotyczy, aby rozumiał, dlaczego zadawane są mu te pytania.

## Kreator pól

Kreator, umieszczony pod ustawieniami, wypisuje wszystkie pola formularza. Każde pole możesz przestawić (strzałki góra/dół), włączyć lub wyłączyć, edytować albo usunąć.

### Dodawanie lub edycja pola

Kliknij **Dodaj pole** albo ikonę ołówka przy istniejącym polu. Edytor oferuje:

- **Typ**: 7 dostępnych typów: nagłówek sekcji, tekst, liczba, tekst długi, przełącznik, Tak/Nie, lista rozwijana.
- **Etykieta** i **tekst pomocy**: wpisywane per język. Etykieta w języku domyślnym jest obowiązkowa; języki pozostawione puste przejmują tę etykietę.
- **Opcje** (tylko typ lista rozwijana): jedna opcja na linię, niezależnie dla każdego języka.
- **Pokaż tylko jeśli**: warunek wyświetlania (patrz niżej).
- **Obowiązkowe** oraz **Aktywne**.

Kod techniczny pola jest generowany automatycznie z etykiety przy tworzeniu i pozostaje potem stabilny, nawet jeśli zmienisz etykietę.

### Typy pól

- **Nagłówek sekcji**: separator wizualny, bez wpisywania danych.
- **Tekst**: jednoliniowe pole tekstowe.
- **Liczba**: wpis numeryczny (odległość, szerokość, liczba stopni…).
- **Tekst długi**: wieloliniowe pole tekstowe na opisy.
- **Przełącznik**: stylizowany suwak tak/nie, idealny do potwierdzeń.
- **Tak / Nie**: dwa wykluczające się przyciski, często rodzic pola warunkowego.
- **Lista rozwijana**: wybór spośród opcji definiowanych per język.

## Pola warunkowe

Pole może wyświetlać się tylko w zależności od odpowiedzi na pole nadrzędne typu **Tak/Nie** lub **przełącznik**.

1. W edytorze pola podrzędnego otwórz listę **Pokaż tylko jeśli** i wybierz pole nadrzędne.
2. Wybierz oczekiwaną wartość: **= Tak / zaznaczone** albo **= Nie / odznaczone**.

Przykład: pole „Szerokość drzwi windy" pojawia się tylko wtedy, gdy pytanie „Winda / dźwig towarowy" jest zaznaczone; pole „Liczba stopni" pojawia się tylko przy zaznaczonych „Schodach". Pole ukryte przez warunek nigdy nie jest wymagane, nawet jeśli oznaczono je jako obowiązkowe.

## Po stronie klienta

Na etapie przewoźnika klient widzi kartę ze statusem formularza (_Do wypełnienia_ / _Wypełniony_) i przycisk otwierający. Formularz otwiera się w nowoczesnym oknie: karty wyboru, przełączniki, przyciski Tak/Nie, walidacja pól obowiązkowych na żywo.

- Odpowiedzi są zapisywane per koszyk: powracający klient widzi swoje odpowiedzi wstępnie uzupełnione.
- W trybie blokującym przycisk zatwierdzenia etapu dostawy automatycznie ponownie otwiera formularz, dopóki nie zostanie wypełniony.

## Podgląd odpowiedzi

Odpowiedzi klienta są dostępne w trzech miejscach:

- **E-mail powiadomienia**: przy walidacji zamówienia na skonfigurowany adres (dział logistyki, przewoźnik lub magazynier) wysyłany jest e-mail HTML z podsumowaniem wszystkich odpowiedzi. Szablony FR i EN są dołączone.
- **Karta zamówienia**: dedykowany panel wyświetla zestawienie pytanie/odpowiedź w zamówieniu, w panelu administracyjnym.
- **Baza danych**: odpowiedzi są przechowywane, powiązane z koszykiem, a następnie z zatwierdzonym zamówieniem.

## Odinstalowanie

Odinstalowanie z Menedżera modułów czysto usuwa tabele modułu (pola, odpowiedzi) i jego konfigurację.

## Najczęstsze pytania

### Formularz się nie wyświetla

Sprawdź, czy moduł jest włączony, czy tryb wyzwalania odpowiada testowemu koszykowi (na przykład czy jakiś produkt faktycznie osiąga próg wagi) i czy co najmniej jedno pole jest aktywne.

### Czy mogę przetłumaczyć etykiety?

Tak. Każdą etykietę, tekst pomocy i opcję listy wpisuje się per język bezpośrednio w kreatorze pól. Tytuł i wprowadzenie formularza również są wielojęzyczne.

### Czy moduł jest zgodny z PrestaShop 9 i multisklepem?

Tak, moduł jest przeznaczony dla PrestaShop 8.0 do 9.x i działa w kontekście multisklepu.
