Formularze Dedykowane

---

1. Wprowadzenie

Czym jest moduł Formularze Dedykowane?

Moduł Formularze Dedykowane (ExternalForms) pozwala na tworzenie dedykowanych formularzy, które mogą być osadzone na zewnętrznych stronach internetowych. Dzięki temu możesz:

• Zbierać dane od klientów - formularze kontaktowe, ankiety, formularze rejestracyjne
• Automatycznie tworzyć klientów w systemie - na podstawie danych z formularza
• Automatycznie tworzyć użytkowników - nowe konta w systemie
• Otrzymywać powiadomienia - e-mail i powiadomienia push o nowych zgłoszeniach
• Kontrolować dostęp - określać kto może edytować formularz i przeglądać zgłoszenia

Główne funkcje

Funkcja	Opis
Formularze podstawowe	Proste formularze jedno-stronnicowe
Formularze etapowe	Formularze wielokrokowe z nawigacją
Akcje automatyczne	Automatyczne tworzenie klientów/użytkowników
Stylowanie	Personalizacja kolorów, fontów i wyglądu
ReCaptcha	Ochrona przed botami i spamem
Kontrola domen	Ograniczenie gdzie formularz może być osadzony

---

Spis treści

1. Wprowadzenie
2. Wymagania i uprawnienia
3. Nawigacja do modułu
4. Tworzenie nowego formularza
5. Edycja formularza - dodawanie pól
6. Typy pól formularza
7. Formularze etapowe (wielokrokowe)
8. Ustawienia formularza
9. Akcje automatyczne
10. Osadzanie formularza na stronie
11. Przeglądanie zgłoszeń
12. Udostępnianie formularzy
13. Powiadomienia
14. Bezpieczeństwo
15. Rozwiązywanie problemów

---

2. Wymagania i uprawnienia

Uprawnienia dostępu

Do korzystania z modułu potrzebujesz odpowiednich uprawnień. Oto lista dostępnych uprawnień:

Uprawnienie	Opis
Podgląd formularzy	Przeglądanie listy formularzy
Tworzenie formularzy	Tworzenie nowych formularzy
Edycja formularzy	Modyfikacja istniejących formularzy
Usuwanie formularzy	Kasowanie formularzy
Podgląd zgłoszeń	Przeglądanie wysłanych odpowiedzi
Usuwanie zgłoszeń	Kasowanie zgłoszeń
Dostęp do wszystkich formularzy	Pełny dostęp do wszystkich formularzy
Udostępnianie formularzy	Możliwość udostępniania innym użytkownikom
Edycja zapisanego zgłoszenia	Modyfikacja danych w zgłoszeniach

Uwaga: Jeśli nie widzisz modułu w menu, skontaktuj się z administratorem w celu nadania odpowiednich uprawnień.

---

3. Nawigacja do modułu

Jak dostać się do modułu?

1. Zaloguj się do systemu
2. W menu głównym znajdź pozycję Formularze dedykowane
3. Kliknij, aby przejść do listy formularzy

Ekran główny - Lista formularzy

Po wejściu do modułu zobaczysz listę wszystkich dostępnych formularzy:

• Nazwa - nazwa formularza
• Status - aktywny/nieaktywny
• Typ - podstawowy/etapowy
• Data utworzenia - kiedy formularz został stworzony
• Akcje - przyciski edycji, duplikowania, usunięcia

---

4. Tworzenie nowego formularza

Krok po kroku

Krok 1: Na liście formularzy kliknij przycisk „Utwórz nowy formularz"

Krok 2: W oknie modalnym wypełnij:

Pole	Opis	Wymagane
Nazwa formularza	Nazwa wyświetlana w systemie	Tak
Typ formularza	Podstawowy lub Etapowy	Tak
Opis	Krótki opis przeznaczenia formularza	Nie

Krok 3: Kliknij „Utwórz"

Krok 4: Zostaniesz automatycznie przeniesiony do edytora formularza

Typy formularzy

Formularz podstawowy:

• Wszystkie pola wyświetlane są na jednej stronie
• Użytkownik widzi cały formularz od razu
• Idealne dla krótkich formularzy (3-10 pól)

Formularz etapowy:

• Pola podzielone na etapy (kroki)
• Użytkownik przechodzi przez kolejne etapy
• Nawigacja: Wstecz / Dalej
• Idealne dla długich formularzy lub procesów wymagających podziału

---

5. Edycja formularza - dodawanie pól

Interfejs edytora

Edytor formularza składa się z dwóch głównych sekcji:

Sekcja lewa - Paleta pól:

• Lista dostępnych typów pól
• Kliknij na typ, aby dodać pole do formularza

Sekcja prawa - Podgląd formularza:

• Lista dodanych pól
• Możliwość sortowania (drag & drop)
• Edycja i usuwanie pól

Dodawanie pola

Krok 1: W palecie pól (po lewej stronie) kliknij na typ pola, które chcesz dodać

Krok 2: Otworzy się okno edycji pola. Wypełnij:

Pole	Opis	Przykład
Etykieta	Tekst wyświetlany nad polem	"Imię i nazwisko"
Placeholder	Tekst wskazówki w polu	"Wpisz swoje imię..."
Tekst pomocy	Dodatkowa informacja pod polem	"Wpisz pełne imię i nazwisko"
Wartość domyślna	Wstępnie wypełniona wartość	-
Wymagane	Czy pole musi być wypełnione	Tak/Nie
Pokaż w liście	Czy wyświetlać w liście zgłoszeń	Tak/Nie
Szerokość	Jak szerokie ma być pole	Pełna/Połowa/Trzecia/Ćwierć

Krok 3: Kliknij „Zapisz"

Sortowanie pól

• Chwyć pole za ikonę "uchwytu" (⋮⋮) po lewej stronie
• Przeciągnij w górę lub w dół
• Upuść w nowej pozycji
• Kolejność zapisuje się automatycznie

Edycja istniejącego pola

• Kliknij ikonę ołówka (✏️) przy polu
• Wprowadź zmiany w oknie modalnym
• Kliknij „Zapisz"

Usuwanie pola

• Kliknij ikonę kosza (🗑️) przy polu
• Potwierdź usunięcie w oknie dialogowym

Duplikowanie pola

• Kliknij ikonę kopiowania przy polu
• Zostanie utworzona kopia z tymi samymi ustawieniami

---

6. Typy pól formularza

Dostępne typy pól

Typ	Opis	Zastosowanie
Pole tekstowe	Krótki tekst (jedna linia)	Imię, nazwisko, tytuł
Email	Adres e-mail z walidacją	Adresy e-mail
Liczba	Tylko wartości numeryczne	Wiek, ilość, cena
Telefon	Numer telefonu	Numery kontaktowe
Pole tekstowe wieloliniowe	Długi tekst (wiele linii)	Opisy, komentarze, wiadomości
Lista rozwijana	Wybór jednej opcji z listy	Kategorie, kraje, działy
Radio buttons	Wybór jednej opcji (widoczne wszystkie)	Płeć, typ zgłoszenia
Checkboxy	Wybór wielu opcji	Zainteresowania, zgody
Data	Wybór daty z kalendarza	Data urodzenia, termin
Czas	Wybór godziny	Preferowana godzina kontaktu

Konfiguracja opcji (dla Lista rozwijana, Radio, Checkboxy)

Dla pól z opcjami wyboru musisz zdefiniować dostępne opcje:

1. W oknie edycji pola znajdź sekcję „Opcje"
2. Wpisz każdą opcję w nowej linii
3. Format: wartość lub wartość|etykieta

Przykład:

męska|Mężczyzna
żeńska|Kobieta
inna|Inna / Nie chcę podawać

Ustawienia walidacji

Każde pole może mieć dodatkowe reguły walidacji:

Reguła	Opis	Przykład użycia
Wymagane	Pole musi być wypełnione	Obowiązkowe dane
Email	Musi być poprawny adres e-mail	Pola e-mail
URL	Musi być poprawny adres URL	Strony internetowe
Minimum	Minimalna wartość/długość	Min. 18 lat
Maximum	Maksymalna wartość/długość	Max. 500 znaków
Tylko litery	Tylko znaki alfabetu	Imiona
Alfanumeryczne	Litery i cyfry	Kody, identyfikatory

---

7. Formularze etapowe (wielokrokowe)

Kiedy używać formularzy etapowych?

• Formularz ma więcej niż 8-10 pól
• Pola można logicznie pogrupować
• Chcesz prowadzić użytkownika krok po kroku
• Zbierasz dane w określonej kolejności

Tworzenie formularza etapowego

Krok 1: Przy tworzeniu formularza wybierz typ „Etapowy"

lub

Krok 1b: W istniejącym formularzu przejdź do Ustawienia → Podstawowe i zmień typ na „Etapowy"

Krok 2: W edytorze pojawi się sekcja „Etapy"

Krok 3: Kliknij „+ Dodaj etap"

Krok 4: Wypełnij dane etapu:

• Nazwa etapu - np. "Dane osobowe", "Adres", "Podsumowanie"
• Opis - opcjonalny opis wyświetlany użytkownikowi

Krok 5: Przypisz pola do etapów:

• W każdym polu wybierz etap z listy rozwijanej
• Pola bez przypisanego etapu nie będą wyświetlane

Sortowanie etapów

• Etapy można sortować metodą drag & drop
• Kolejność etapów określa kolejność wyświetlania

Jak działa formularz etapowy dla użytkownika?

1. Użytkownik widzi pierwszy etap z przypisanymi polami
2. Po wypełnieniu klika „Dalej"
3. System waliduje pola bieżącego etapu
4. Jeśli poprawne - przejście do następnego etapu
5. Przycisk „Wstecz" pozwala wrócić do poprzedniego etapu
6. Na ostatnim etapie przycisk „Wyślij"

---

8. Ustawienia formularza

Dostęp do ustawień

W edytorze formularza kliknij zakładkę „Ustawienia" (u góry)

Sekcje ustawień

8.1 Ustawienia podstawowe

Ustawienie	Opis
Nazwa formularza	Nazwa wyświetlana w systemie
Typ formularza	Podstawowy / Etapowy
Opis	Wewnętrzny opis formularza
Wiadomość po wysłaniu	Tekst wyświetlany po wysłaniu formularza
Formularz aktywny	Włącza/wyłącza formularz

8.2 Stylowanie

Personalizuj wygląd formularza:

Ustawienie	Opis	Domyślnie
Kolor główny	Kolor przycisków i akcentów	#3B82F6 (niebieski)
Kolor tła	Tło formularza	#FFFFFF (biały)
Kolor tekstu	Kolor etykiet i tekstu	#1F2937 (ciemny szary)
Tekst na przycisku	Napis na przycisku wysyłania	"Wyślij"
Zaokrąglone narożniki	Zaokrąglenie elementów	Włączone
Pozycja etykiet	Nad polem / Jako placeholder	Nad polem

8.3 Komunikaty walidacji

Dostosuj komunikaty błędów wyświetlane użytkownikowi:

Komunikat	Domyślna wartość
Błąd formularza	"Proszę poprawić błędy w formularzu."
Pole wymagane	":field jest wymagane."
Niepoprawny email	":field musi być poprawnym adresem email."
Niepoprawny URL	":field musi być poprawnym adresem URL."
Za krótka wartość	":field musi mieć minimum :min znaków."
Za długa wartość	":field może mieć maksymalnie :max znaków."

Wskazówka: Użyj :field jako placeholder dla nazwy pola, :min i :max dla wartości limitów.

---

9. Akcje automatyczne

Czym są akcje automatyczne?

Akcje automatyczne pozwalają na wykonanie określonych operacji po wysłaniu formularza. Obecnie dostępne są dwie akcje:

1. Dodaj klienta - automatycznie tworzy nowego klienta w systemie
2. Dodaj użytkownika - automatycznie tworzy nowe konto użytkownika

Ważne: Akcje „Dodaj klienta" i „Dodaj użytkownika" wzajemnie się wykluczają. Możesz włączyć tylko jedną z nich.

9.1 Akcja: Dodaj klienta

Ta akcja automatycznie tworzy nowego klienta na podstawie danych z formularza.

Konfiguracja:

Krok 1: Przejdź do Ustawienia → Akcje

Krok 2: Zaznacz checkbox „Dodaj klienta"

Krok 3: Wybierz ustawienia:

• Źródło - skąd pochodzi klient (wymagane) - np. "Formularz webowy"
• Status - początkowy status klienta (wymagane) - np. "Nowy"

Krok 4: Skonfiguruj mapowanie pól:

Pole docelowe	Wymagane	Opis
Imię	✅ Tak	Pole formularza z imieniem
Nazwisko	✅ Tak	Pole formularza z nazwiskiem
Email	✅ Tak	Pole formularza z adresem e-mail
Telefon	✅ Tak	Pole formularza z numerem telefonu
Ulica	Nie	Pole z nazwą ulicy
Numer budynku	Nie	Pole z numerem budynku
Numer lokalu	Nie	Pole z numerem lokalu
Miasto	Nie	Pole z nazwą miasta
Kod pocztowy	Nie	Pole z kodem pocztowym

Krok 5: Dla każdego pola docelowego wybierz odpowiadające pole z formularza

Co się dzieje po wysłaniu formularza:

1. System tworzy nowego klienta z podanymi danymi
2. Jeśli podano dane adresowe - tworzy adres klienta
3. Przypisuje wybrane źródło i status
4. Tworzy zadania powiązane ze statusem (jeśli skonfigurowane)
5. Klient jest oznaczony jako "z formularza zewnętrznego"

9.2 Akcja: Dodaj użytkownika

Ta akcja automatycznie tworzy nowe konto użytkownika w systemie.

Konfiguracja:

Krok 1: Przejdź do Ustawienia → Akcje

Krok 2: Zaznacz checkbox „Dodaj użytkownika"

Krok 3: Wybierz typ roli:

• Domyślna - jedna standardowa rola
• Niestandardowa - możliwość wyboru wielu ról

Krok 4: Wybierz role do przypisania

Krok 5: Skonfiguruj mapowanie pól:

Pole docelowe	Wymagane	Opis
Imię	✅ Tak	Pole formularza z imieniem
Nazwisko	✅ Tak	Pole formularza z nazwiskiem
Email	✅ Tak	Pole formularza z adresem e-mail
Telefon	✅ Tak	Pole formularza z numerem telefonu

Co się dzieje po wysłaniu formularza:

1. System tworzy nowe konto użytkownika
2. Generuje losowe hasło (użytkownik musi je zresetować)
3. Przypisuje wybrane role
4. Użytkownik jest oznaczony jako "z formularza zewnętrznego"

Uwaga: System blokuje tworzenie duplikatów - jeśli istnieje już użytkownik z podanym adresem e-mail, nowy nie zostanie utworzony.

---

10. Osadzanie formularza na stronie

Pobieranie kodu do osadzenia

Krok 1: Przejdź do edytora formularza

Krok 2: Kliknij Ustawienia → Kod do osadzenia

Krok 3: Skopiuj wygenerowany kod HTML

Format kodu

<iframe
    src="https://twoja-domena.pl/form/nazwa-formularza"
    width="100%"
    height="600px"
    frameborder="0"
    style="border: none;">
</iframe>

Jak osadzić na stronie?

1. Otwórz edytor HTML swojej strony
2. Znajdź miejsce, gdzie ma się pojawić formularz
3. Wklej skopiowany kod
4. Zapisz zmiany

Dostosowanie rozmiaru

Możesz zmienić parametry:

Parametr	Opis	Wartość
width	Szerokość formularza	"100%" lub "500px"
height	Wysokość formularza	"600px", "800px" itp.

Wskazówka: Formularz automatycznie dostosowuje się do szerokości kontenera. Wysokość możesz dostosować do ilości pól.

Wymagania dla strony docelowej

• Strona musi obsługiwać elementy iframe
• Domena musi być na liście dozwolonych (patrz: Bezpieczeństwo)
• Połączenie HTTPS jest zalecane

---

11. Przeglądanie zgłoszeń

Dostęp do listy zgłoszeń

Metoda 1: Na liście formularzy kliknij ikonę zgłoszeń przy formularzu

Metoda 2: W edytorze formularza kliknij „Zgłoszenia"

Metoda 3: Bezpośredni URL: /external-forms/submissions/{id_formularza}

Interfejs listy zgłoszeń

Lista zawiera:

• Data wysłania
• Wartości pól oznaczonych jako „Pokaż w liście"
• Status: Przeczytane / Nieprzeczytane
• Akcje: Podgląd, Edycja, Usuń

Filtrowanie zgłoszeń

Filtr	Opis
Status	Przeczytane / Nieprzeczytane / Wszystkie
Data od	Początek zakresu dat
Data do	Koniec zakresu dat
Wyszukiwanie	Szukaj w treści zgłoszeń

Podgląd szczegółów zgłoszenia

1. Kliknij na wiersz zgłoszenia
2. Otworzy się okno ze szczegółami
3. Zobaczysz wszystkie pola i ich wartości

Oznaczanie jako przeczytane

• Kliknij ikonę koperty przy zgłoszeniu
• Lub użyj przycisku „Oznacz wszystkie jako przeczytane"

Edycja zgłoszenia

Jeśli masz uprawnienie „Edycja zapisanego zgłoszenia":

1. Otwórz szczegóły zgłoszenia
2. Kliknij „Edytuj"
3. Zmień wartości pól
4. Kliknij „Zapisz zmiany"

Tworzenie klienta/użytkownika ze zgłoszenia

Jeśli akcja automatyczna nie została wykonana (np. brakowało danych):

1. Otwórz szczegóły zgłoszenia
2. Kliknij „Utwórz klienta" lub „Utwórz użytkownika"
3. System utworzy rekord na podstawie danych zgłoszenia

Usuwanie zgłoszeń

1. Kliknij ikonę kosza przy zgłoszeniu
2. Potwierdź usunięcie

Uwaga: Usunięte zgłoszenia można przywrócić (soft delete).

---

12. Udostępnianie formularzy

Po co udostępniać formularze?

• Pozwól innym użytkownikom edytować formularz
• Daj dostęp do przeglądania zgłoszeń
• Wspólna praca nad formularzem

Konfiguracja udostępniania

Krok 1: Przejdź do Ustawienia → Udostępnianie

Krok 2: W sekcji „Udostępnij rolom":

• Zaznacz role, które mają mieć dostęp
• Wszyscy użytkownicy z zaznaczonymi rolami uzyskają dostęp

Krok 3: W sekcji „Udostępnij użytkownikom":

• Zaznacz konkretnych użytkowników
• Dostęp indywidualny, niezależny od ról

Krok 4: Zmiany zapisują się automatycznie

Poziomy dostępu

Udostępnione osoby mogą:

• ✅ Przeglądać formularz
• ✅ Edytować formularz (jeśli mają uprawnienie „Edycja formularzy")
• ✅ Przeglądać zgłoszenia
• ❌ Usuwać formularz (tylko twórca lub admin)

---

13. Powiadomienia

Rodzaje powiadomień

1. Powiadomienie push (dzwonek) - widoczne w systemie
2. Powiadomienie e-mail - wysyłane na adres e-mail

Konfiguracja powiadomień

Krok 1: Przejdź do Ustawienia → Powiadomienia

Krok 2: Zaznacz „Włącz powiadomienia e-mail"

Krok 3: W sekcji „Powiadom role":

• Zaznacz role, które mają otrzymywać powiadomienia

Krok 4: W sekcji „Powiadom użytkowników":

• Zaznacz konkretnych użytkowników

Krok 5: Zmiany zapisują się automatycznie

Co zawiera powiadomienie?

Powiadomienie push:

• Tytuł: "Nowe zgłoszenie formularza"
• Treść: Nazwa formularza i informacja o nadawcy
• Link do zgłoszenia

Powiadomienie e-mail:

• Temat: "Nowe zgłoszenie - [Nazwa formularza]"
• Treść: Informacja o nowym zgłoszeniu
• Link do listy zgłoszeń

Uwaga: Powiadomienia e-mail są wysyłane tylko do użytkowników, którzy mają włączone powiadomienia e-mail w swoim profilu.

---

14. Bezpieczeństwo

14.1 ReCaptcha (ochrona przed botami)

Co to jest ReCaptcha? System Google'a chroniący przed automatycznym wysyłaniem formularzy przez boty.

Konfiguracja:

Krok 1: Uzyskaj klucze ReCaptcha v3 z Google reCAPTCHA

Krok 2: Przejdź do Ustawienia → Bezpieczeństwo

Krok 3: Zaznacz „Włącz ReCaptcha"

Krok 4: Wpisz:

• Site Key - klucz publiczny (widoczny na stronie)
• Secret Key - klucz prywatny (do weryfikacji)

Krok 5: Zapisz zmiany

Wskazówka: Używamy ReCaptcha v3, która działa w tle i nie wymaga od użytkownika rozwiązywania zagadek.

14.2 Dozwolone domeny

Ogranicz, na jakich stronach może być osadzony formularz:

Krok 1: Przejdź do Ustawienia → Bezpieczeństwo

Krok 2: W polu „Dozwolone domeny" wpisz:

• Domeny oddzielone przecinkami
• Lub jedna domena w linii

Przykład:

example.com
www.example.com
sklep.example.com

Krok 3: Zapisz zmiany

Uwaga: Jeśli pole jest puste, formularz może być osadzony na dowolnej stronie.

14.3 Aktywacja/deaktywacja formularza

• Nieaktywny formularz wyświetla komunikat błędu
• Deaktywuj formularz, gdy nie chcesz przyjmować zgłoszeń
• Przełącznik: Ustawienia → Podstawowe → „Formularz aktywny"

---

15. Rozwiązywanie problemów

Problem: Formularz nie wyświetla się na stronie

Możliwe przyczyny:

1. Formularz jest nieaktywny → Aktywuj w ustawieniach
2. Domena nie jest na liście dozwolonych → Dodaj domenę do listy
3. Błędny URL formularza → Sprawdź slug w kodzie osadzenia
4. Błąd iframe na stronie → Sprawdź czy strona obsługuje iframe

Problem: Formularz nie wysyła się

Możliwe przyczyny:

1. Błędy walidacji → Sprawdź komunikaty błędów
2. ReCaptcha nie przeszła → Sprawdź konfigurację kluczy
3. Błąd serwera → Sprawdź logi lub skontaktuj się z administratorem

Problem: Akcja „Dodaj klienta" nie działa

Możliwe przyczyny:

1. Nie wszystkie wymagane pola są zmapowane → Sprawdź mapowanie
2. Nie wybrano źródła lub statusu → Uzupełnij ustawienia akcji
3. Błąd walidacji → Sprawdź czy dane są poprawne (np. format email)

Problem: Nie otrzymuję powiadomień

Możliwe przyczyny:

1. Powiadomienia nie są włączone → Włącz w ustawieniach
2. Nie jesteś na liście odbiorców → Dodaj siebie do listy
3. Masz wyłączone powiadomienia e-mail w profilu → Włącz w ustawieniach profilu
4. Problem z kolejką zadań → Skontaktuj się z administratorem

Problem: Nie widzę formularza na liście

Możliwe przyczyny:

1. Brak uprawnień → Skontaktuj się z administratorem
2. Formularz nie jest udostępniony → Poproś właściciela o udostępnienie
3. Formularz został usunięty → Sprawdź z właścicielem

Problem: Użytkownik nie może wypełnić formularza

Co sprawdzić:

1. Czy formularz jest aktywny?
2. Czy wszystkie wymagane pola mają etykiety?
3. Czy walidacja nie jest zbyt restrykcyjna?
4. Czy ReCaptcha jest poprawnie skonfigurowana?
5. Czy połączenie HTTPS działa poprawnie?

---

Słownik pojęć

Pojęcie	Definicja
Slug	Unikalna nazwa formularza w URL (np. "formularz-kontaktowy")
Iframe	Element HTML pozwalający osadzić jedną stronę w drugiej
Mapowanie pól	Przypisanie pól formularza do pól docelowych (np. klienta)
ReCaptcha	System Google'a chroniący przed botami
Soft delete	Usunięcie z możliwością przywrócenia
Walidacja	Sprawdzenie poprawności wprowadzonych danych

---

Kontakt i wsparcie

W przypadku problemów lub pytań dotyczących modułu Formularze Dedykowane:

1. Skontaktuj się z administratorem systemu
2. Sprawdź dokumentację techniczną
3. Zgłoś błąd w systemie zgłoszeń

---

Dokument wygenerowany automatycznie. Wersja: 1.0 Data ostatniej aktualizacji: Grudzień 2025