Contact Form - Dokumentacja modułu Magento 2

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.

Image 14

Image 4

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ść

Image 3

  • Email list - stwórz listę e-maili z których użytkownik wybierze odpowiedni dla pytania

Image 3

  • 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).

Image 6

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.

Image 5

Aby skonfigurować Nadawcę oraz Odbiorcę formularza kontaktowego, przejdź do Panelu Admina Stores > Configuration > General > Contacts > Email Options.

Email Options En

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

Instalacja modułu

Instalacja przez Composer

  1. Dodaj repozytorium do pliku composer.json:
"repositories": [
    ...
    {
        "type": "vcs",
        "url": "git@git.auroracreation.com:aurora-modules/aurora-contact.git"
    }
    ...
],
  1. Zmodyfikuj plik composer.json:
"require": {
    ...
    "aurora/contact-form": "*"
    ...
},
  1. W folderze głównym Magento wykonaj następujące polecenia:
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:
{Magento root}
└── app/
    └── code
  1. W folderze głównym Magento wykonaj następujące polecenia:
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