<!-- TITLE: Contact Form - Dokumentacja modułu Magento 2 --> <!-- SUBTITLE: Autor: Marek Milewski --> # Contact Form ## Opis modułu Contact Form pozwala na tworzenie własnego, w pełni konfigurowalnego formularza kontaktowego. Co więcej nie potrzeba przy tym żadnej wiedzy programistycznej - wszystko wykonasz w Panelu Admina. Możesz stworzyć bazę pól do formularza i samemu decydować kiedy i jakie stosować. ## Zgodność modułu Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.2** and **2.3**. ## Sposób działania Po instalacji modułu, domyślne pola formularza **Contact Us** dostarczane przez Magento 2 zostały usunięte. Aby dodać swoje nowe spersonalizowane **pola**, przejdź Panelu Admina i dalej **Content > Form Fields**. Naciśnij **Add New Field** by dodać własne.   **Enable** – włącz lub wyłącz widoczność pola **Label** – ustaw nazwę dla pola **Type** – wybierz rodzaj wstawianych wartości: * Text - krótki tekst * Textarea - dłuższy tekst * Select - stwórz własne opcje, z których użytkownik będzie mógł wybrać wartość  * Email list - stwórz listę e-maili z których użytkownik wybierze odpowiedni dla pytania  * Reply to - pozwala użytkownikowi zdefiniować e-mail na który ma być dostarczona wiadomość * Subject - pozwala dodać tytuł wiadomości **Required** – ustaw czy dane pole musi być wypełnione **Validation Type** - ustaw rodzaj walidacji **Sort Order** - pozwala na organizację rozkładu pól **Store View** – sklep/widok sklepu w którym dostępne będzie pole Twoje nowo stworzone pola będą widoczne w miejscu poprzedniego formularza **Contact Us** (in homepage/contact).  Moduł jest w pełni kompatybilny z Magento 2, więc bez problemy dodasz captcha do stworzonego przez Ciebie formularza **Stores > Configuration > Customers > Customer Configuration > Captcha**.  Aby skonfigurować Nadawcę oraz Odbiorcę formularza kontaktowego, przejdź do Panelu Admina **Stores > Configuration > General > Contacts > Email Options**.  **Send Emails To** - adres e-mail, na który powinien zostać wysłany Formularz Kontaktowy (Odbiorca) **Email Sender** - adres e-mail, z którego powinien zostać wysłany Formularz Kontaktowy (Nadawca) ## Demo demo1.magecreation.com ## Instalacja modułu ### Instalacja przez Composer 1. Dodaj repozytorium do pliku composer.json: ```text "repositories": [ ... { "type": "vcs", "url": "git@git.auroracreation.com:aurora-modules/aurora-contact.git" } ... ], ``` 2. Zmodyfikuj plik composer.json: ```text "require": { ... "aurora/contact-form": "*" ... }, ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text composer update aurora/contact-form php bin/magento module:enable Aurora_Contact php bin/magento setup:upgrade ``` ### Instalacja manualna 1. Rozpakuj archiwum 2. Przenieś pliki modułu na serwer do lokalizacji: ```text {Magento root} └── app/ └── code ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text php bin/magento module:enable Aurora_Contact php bin/magento setup:upgrade ``` ### Dziękujemy za zainteresowanie naszymi modułami! ## Dziennik zmian ### v1.1.19 - Update gitlab ci - Poprawienie walidacji ReCaptcha - Poprawienie walidacji w js - Poprawienie PSR ### v1.1.18 - Poprawa kontrolerów - Dodanie tłumaczonej nazwy przycisku Dodaj Pole/ Edytuj Pole - Poprawienie PSR - Poprawienie informacji o błędach - Poprawienie logiki wysyłania zapytania kontaktowego - Popravienie walidacji wysyłanych danych ### v1.1.17 - Poprawa DataProvider'a ### v1.1.16 - Poprawa kontrolera tworzenia/edycji pola - Poprawa DataProvider'a ### v1.1.15 - Poprawa listy pól formularza kontaktowego- usunięcie uicomponent context ### v1.1.14 - Naprawa błędu dot. wyświetlania pól formularza ### v1.1.13 - Poprawa listy pól formularza kontaktowego - użycie uicomponent context ### v1.1.13 - Poprawa walidacji pól niewymaganych ### v1.1.12 - Obniżenie wymaganej wersji Magento ### v1.1.11 - Poprawa walidacji pól niewymaganych ### v1.1.10 - Update umożliwiający działanie na Magento 2.4 - Poprawienie PSR - Dodanie TypeHint - Dodanie strict_types - Poprawienie copyrights ### v1.1.9 - Dodanie opcji: tytuł i opis strony kontaktowej konfigurowalny dla każdego storeview ### v1.1.8 - Poprawienie praw autorskich - Dodanie opcji: Umieszczenie informacji o polityce prywatności w formularzu kontaktowym - Dodanie opcji: Zgoda na przetwarzanie danych jako select - Dodanie opcji: Treść informacji o zgodzie na przetwarzanie danych - Dodanie informacji o polach wymaganych - Dodanie tłumaczeń ### v1.1.7 - Poprawienie praw autorskich w readme ### v1.1.6 - Poprawienie typów kolumn w db_schema ### v1.1.5 - Zmiana sposobu tworzenia tabeli w bazie - użycie db_schema ### v1.1.4 - Poprawienie PSR ### v1.1.3 - Poprawienie PSR - Poprawienie wyświetlania formularza kontaktowego - Dodanie serializer interface - Poprawienie UnitTestów ### v1.1.2 - Poprawienie UnitTestu - Poprawienie PSR ### v1.1.1 - Zmiana praw autorskich ### v1.0.5 - Update umożliwiający działanie na Magento 2.3 ### v1.0.4 - Dodanie wyświetlania informacji o błędzie ### v1.0.3 - Refaktoring formularza dodawania pola