<!-- TITLE: Ask For Details Pro - Dokumentacja modułu Magento 2 --> <!-- SUBTITLE: Autor: Paweł Wasiluk --> # Moduł Ask For Details Pro ## Opis modułu Pomóż swoim klientom uzyskać więcej informacji na temat produktów. Pozwól im zadać dokładne pytanie na stworzonym przez Ciebie szablonie. Wersja Pro danje możliwość ustawienia Google reCaptcha. Miej pewność, że pytania odnosnie produktu wysyłają prawdziwi klienci i zabezpiecz się przed spamem od robotów. ## Zgodność modułu Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.2**, **2.3**, **2.4**. ## Sposób działania Po instalacji moduł jest domyślnie wyłączony, kieruj się do Panelu Admina by go aktywować. Przejdź do Stores > Configuration > Catalog > Ask For Details Pro. Znajdziesz tam dwie sekcje.  * Enable Ask For Details - włącz lub wyłącz moduł * Feedback For Customer - gdy włączony, klient otrzyma e-mail potwierdzający wysłanie zapytania * Form title - nadaj tytuł e-mailowi  * Sends E-mails To - ustaw e-mail na który będą wysyłane pytania * E-mail Sender - ustaw nadawcę e-maila * Store E-mail Template - wybierz szablon e-maila, możesz go edytować w Stores > Configuration > General > Store Email Addresses * Customer E-mail Template - pole pojawia się po włączeniu Feedback For Customer. Wybierz szablon e-maila, możesz go edytować w Stores > Configuration > General > Store Email Addresses > Ask For Details Pro  Gdy moduł został aktywowany, w panelu przejdź do Content > Form Fields. Aby dodać nowe pole do formularza, kliknij Add New Field.   * Enable Field – włącz lub wyłącz widoczność pola * Field Label – wpisz nazwę pola * Field Type – wybierz czy pole powinno być text lub textarea * Required – wybierz czy pole powinno być wymagane * Validation Type - ustaw rodzaj walidacji np. e-mail, Liczba, Url * Store View – sklep/widok sklepu w którym dostępne będzie pole Dodane pole pokaże się w tabeli Content > Form Fields. Aby przycisk Ask About Product był widoczny na stronie produktu należy dodać do produktu atrybut   Następnie pojawi nam się nowe pole w skecji Attributes na stronie edycji produktu o nazwie Show Ask for Details button. Włączamy i zapisujemy produkt. Moduł umożliwia również definiowanie adresów mailowych sprzedawców dla wybranych produktów poprzez atrybut set_seller, oddajemy go do produktu w ten sam sposób co poprzedni atrybut. W edycji atrybutu powinniśmy teraz zdefiniować sprzedawców wraz z ich mailami. Przycisk Ask About Product pokaże się na stronie produktu. Naciśnięty wyświetli modal z szablonem formularza.  Szablon zawiera pola, które zostały dodane w poprzednich krokach. Po kliknięciu send, użytkownik zostanie powiadomiony czy e-mail został wysłany poprawnie.  Po wysłaniu zapytania, przejdź do Reports > Ask For Details Pro > Mail. Tutaj ujrzysz tabelę która zawierać będzie wszystkie dotąd zadane zapytania.  By zobaczyć zawartość pytania, w kolumnie Action, zaznacz Select i wybierz View. Przykładowa treść została przedstawiona poniżej.  Aby ustawić google reCaptcha należy pamiętać o dodaniu Google API website key i Google API website key w Stores > Configration > Security > Google reCaptcha. Następnie przejdź do grupy "storefront" i włącz reCaptcha w formularzu.  ## 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/AskForDetailsPro.git" } ... ], ``` 2. Zmodyfikuj plik composer.json: ```text "require": { ... "aurora/module-ask-for-details-pro": "*" ... }, ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text composer update aurora/module-faq php bin/magento module:enable Aurora_AskForDetailsPro 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_AskForDetailsPro php bin/magento setup:upgrade ``` ## Dziennik zmian ### v.2.2.0 * Zmiana sposobu włączania zabezpieczenia reCaptcha w formularzu kontaktowym ### v.2.1.2 * Dodanie przycisku w konfiguracji włączającego atrybut na wszystkich produktach ### v.2.1.1 * Poprawa wyszukiwania "fulltext" na gridzie ### v.2.1.0 * Integracja z modułem Aurora_Base * Przeniesienie konfiguracji do zakładki "Aurora" * Poprawa jakości kodu ### v.2.0.16 * Poprawa i dodanie brakujących tłumaczeń ### v.2.0.15 * Poprawa zależności ### v.2.0.14 * Przystosowanie modułu pod Magento 2.4.0 ### v.2.0.12 * Poprawa pobierania waluty ### v.2.0.11 * Poprawa działania captchy ### v.2.0.10 * Poprawa błędów ### v.2.0.9 * Poprawa captchy ### v.2.0.8 * Poprawa recaptchy ### v.2.0.7 * Poprawa zależności ### v.2.0.6 * Poprawa kodu oraz praw autorskich ### v.2.0.5 * Poprawa kodu pod Magento 2.4 ### v.2.0.4 * Aktualizacja ReadMe ### v.2.0.3 * Poprawa typów kolumn ### v.2.0.2 * Dodanie whitelist.json ### v.2.0.1 * Dodanie dbschema ### v.2.0.0 * Poprawa JS ### Dziękujemy za zainteresowanie naszymi modułami!