Custom Request Intake: konfiguracja i pomoc

Wymagania

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.

Przed przyjmowaniem zapytań sprawdź te usługi:

• HTTPS dla strony zapytania i punktu przesyłania formularza.
• Włączone przesyłanie plików w PHP, Fileinfo i działającą kontrolę obrazów.
• OpenSSL i mbstring do przechowywania danych kontaktowych klientów i przetwarzania tekstu.
• Katalog var/mprcustomrequest/uploads/ w katalogu głównym sklepu, z prawem zapisu i ochroną przed bezpośrednim dostępem publicznym.
• Działającą drogę wysyłki poczty sklepu i poprawną tożsamość nadawcy.
• Harmonogram uruchamiający codzienne czyszczenie w kontekście cron.

Moduł akceptuje JPEG, PNG, WebP, HEIC i PDF. Limity hostingu muszą umożliwiać przesłanie każdego pliku oraz szkicu i plików pomocniczych łącznie. Dostosuj upload_max_filesize, post_max_size i limity żądań serwera WWW do wybranego limitu modułu. Pliki klientów są przechowywane poza katalogiem modułu, więc wymiana plików modułu nie zastępuje plików klientów.

Nie potrzebujesz zewnętrznego konta usługi zapytań. Klienci mogą wysyłać zapytania bez rejestracji. U zalogowanych klientów pola imienia i nazwiska oraz e-mail są wstępnie wypełnione.

Zainstaluj i otwórz konfigurację

1. Prześlij ZIP przez "Modules > Module Manager > Upload a module" i zainstaluj go.
2. Otwórz "Custom Requests > Settings > Configuration" lub kliknij "Configure" przy module w "Module Manager".
3. W multistore wybierz jeden sklep. W kontekście grupy lub wszystkich sklepów nie można edytować tych ustawień.
4. Skonfiguruj "Basic", "Surfaces" i "Privacy and retention", a następnie kliknij "Save".

Moduł tworzy własne tabele zapytań, rejestruje obsługiwane hooki i zadanie retencji, dodaje kolejkę "Custom Requests" i instaluje adres osobnej strony. Zmiany konfiguracji wymagają uprawnień do edycji.

Limity poczty, plików i zapytań

Próba jest liczona po przejściu wstępnych kontroli formularza, przed przesłaniem plików i zapisaniem zapytania. Błąd przesyłania lub zapisu może więc zużyć próbę. Obietnica odpowiedzi nie oblicza terminu, nie przydziela pracowników, nie wysyła przypomnień ani nie wykonuje oceny.

Po zmianie tych wartości kliknij "Save".

Karta "Surfaces"

Przełączniki umiejscowienia sterują każdym miejscem jako całością. Ten ekran nie zawiera listy wyboru produktów ani kreatora własnych pól.

Zapytania o niestandardowy rozmiar produktu

Przy wyłączonym trybie ofertowym każda strona produktu używa Potrzebujesz innego rozmiaru? Wyślij nam szkic i wymaga szkicu. Produkt dostępny do zamówienia nadal korzysta z tego formularza, nawet gdy tryb ofertowy jest włączony.

Zapytanie o produkt zachowuje powiązanie z produktem. Nie zapisuje wybranej kombinacji ani niezmiennej historycznej kopii nazwy i indeksu produktu. Podczas oceny pracownicy odczytują aktualne informacje o produkcie.

Prośby o ofertę produktu

Włącz Prośby o ofertę dla produktów niedostępnych do zamówienia tylko wtedy, gdy chcesz stosować ten alternatywny proces. W tym samym sklepie oznacz wybrany produkt katalogowy jako niedostępny do zamówienia. Otwórz jego stronę i sprawdź Poproś o ofertę.

W tym trybie Szkic (opcjonalnie) zastępuje wymagany szkic. Wymiary (jeśli je znasz) i Zdjęcia miejsca montażu lub inne pliki (opcjonalnie, do 4) pozwalają dodać kontekst. Imię i nazwisko, e-mail, opis i zgoda nadal są wymagane. Przycisk wysyłki to Wyślij prośbę o ofertę.

Moduł ponownie sprawdza ustawienie i aktualny stan produktu przy wysyłce. Tryb zależy od dostępności do zamówienia, a nie wyłącznie od ilości na stanie. Formularze kontaktowy i osobnej strony nadal są zwykłymi zapytaniami indywidualnymi z wymaganym szkicem.

Formularze osobnej strony i kontaktu

Otwórz osobną stronę przez link w stopce. Dodając link do menu sklepu, użyj wygenerowanego adresu URL w danym języku. Zapytania z tej strony i sekcji kontaktowej mogą wpływać bez produktu referencyjnego.

Sprawdź motyw

Przetestuj miejsca na stronie produktu, kontaktu i osobnej stronie w aktywnym motywie. Element otwierający i okno produktu pochodzą z oddzielnych hooków; okno wymaga wyjścia w stopce. Element otwierający może być widoczny bez działającego okna, jeśli własny motyw pomija to wyjście.

Formularz produktu zawiera układ dla PrestaShop 1.6 i jest przygotowywany przed wyświetleniem strony.

Karta "Privacy and retention"

Sprawdź link prywatności w każdym języku. Jeśli wyłączysz Osobna strona, ustaw odrębny dostępny "Privacy policy URL". Informacja zastępcza nie może służyć jako dostępna strona polityki, gdy jej strona jest wyłączona.

Każde zapytanie przechowuje treść zgody, jej skrót z kluczem i czas wyrażenia zgody. Imiona i nazwiska oraz e-maile korzystają ze wspólnego szyfrowanego magazynu kontaktów; dane telefonu też są szyfrowane. Tekst wiadomości, wymiary, pliki i całe zapytanie nie są w całości szyfrowane. Uwzględnij tę różnicę w procedurach prywatności i kopii zapasowych.

Ustawienia i codzienny dostęp do kolejki dotyczą wybranego sklepu. Usuwanie przy odinstalowaniu celowo ma szerszy zakres.

Wyślij formularz

Użyj czystej sesji klienta. Otwórz każde włączone miejsce i prześlij:

• Imię i nazwisko oraz E-mail.
• Czego potrzebujesz? z jasnym opisem.
• Szkic dla zwykłego zapytania indywidualnego.
• Opcjonalny telefon, przybliżone wymiary i maksymalnie cztery pliki pomocnicze.
• Zgodę na ocenę i kontakt.

Opis ma limit 10000 znaków, telefon 64, a wymiary 255. Zwykłe zapytanie indywidualne wymaga jednego szkicu. Opisany wyżej tryb oferty produktu pozwala całkowicie go pominąć.

Dla panelu na wymiar przykładowy opis wygląda tak:

What do you need?: A panel to fit the recess shown in my sketch.
Rough dimensions: Measurements are marked on the attached drawing.
Sketch: recess-sketch.pdf
Extra file: recess-photo.jpg

Moduł sprawdza podpisany token formularza, włączone miejsce, pola wymagane, zgodę i limity plików. Ukryta kontrola botów i ograniczanie częstotliwości działają przed zapisem. Standardowe przyjęte zapytanie zaczyna ze statusem Nowe, otrzymuje numer taki jak REQ-2026-00001 i jest zapisywane przed próbami wysłania e-maili. Numery korzystają z rocznego licznika dla każdego sklepu.

Osobno potwierdź przyjęcie i pocztę

Sprawdź komunikat powodzenia i numer zapytania. Następnie otwórz kolejkę i znajdź ten sam numer. Osobno sprawdź potwierdzenie dla klienta i powiadomienie sklepu. Zapisane zapytanie pozostaje dostępne, gdy któraś wiadomość zostanie odrzucona lub jej wysyłka się nie uda.

Powiadomienie sklepu może zawierać pliki klienta jako załączniki, do łącznych 10 MiB rzeczywistej zawartości. Brakujące, nieczytelne lub przekraczające limit pliki są oznaczane jako nie załączono i pozostają dostępne w zapytaniu, jeśli istnieją w magazynie. Lista załączników prowadzi do dostępu tylko dla pracowników, gdy znany jest katalog administracyjny sklepu. Potwierdzenie dla klienta i odpowiedzi pracowników nie dołączają tych plików.

Znajdź rekord

Otwórz "Custom Requests". Najnowsze zapytania pojawiają się pierwsze. Filtruj "ID", Numer, Status, "Product reference", "Has product", Źródło i Otrzymano. "Requester" pokazuje zamaskowany e-mail i nie jest kolumną umożliwiającą wyszukiwanie pełnego adresu.

Użyj "Has product > No", aby znaleźć zapytania do warsztatu bez produktu katalogowego. Indeksy produktów prowadzą do edytora katalogu. Otwórz akcję podglądu wiersza, aby sprawdzić szczegóły.

Sprawdź wymagania i pliki

Szczegóły obejmują dane kontaktowe, Czego potrzebuje klient, Przybliżone wymiary, kontekst produktu, Załączniki, Historia odpowiedzi i Historia statusów. JPEG, PNG i WebP mają podgląd. Pobierz HEIC i PDF do odpowiedniej przeglądarki. Pobieranie wymaga uprawnienia pracownika do podglądu i dotyczy wybranego sklepu.

Informacje o produkcie i zmienne w wiadomościach pracowników korzystają ze sklepu i języka zapytania. Jeśli nazwa produktu lub notatka nie jest dostępna do wyświetlenia, zostaje pominięta lub zastąpiona wyjaśnieniem zamiast niewypełnionej zmiennej.

Zmień status

Dostępne statusy to Nowe, W trakcie oceny, Rysunek wysłany, Wycenione, Zamknięte i Spam.

1. W Zmień status wybierz Status.
2. Opcjonalnie dodaj Notatka do historii, do 191 znaków.
3. Kliknij Zapisz status.

Rzeczywista zmiana zapisuje czas, pracownika i notatkę. Zapisanie tego samego statusu nie dodaje osobnej notatki ani nie odświeża daty retencji. Zmiany statusu wymagają uprawnień do edycji.

Przy pracy kilku osób pierwszy pracownik może wybrać W trakcie oceny i opisać ocenę w notatce. Następny może przejrzeć pliki i historię przed kontynuacją. Po zakończeniu status Zamknięte kwalifikuje zapytanie do czyszczenia po skonfigurowanym okresie. Spam nie podlega retencji zamkniętych zapytań.

Przygotuj wiadomość wychodzącą

1. W Wyślij odpowiedź wybierz Szablon lub Własna wiadomość.
2. Sprawdź i edytuj Temat oraz Wiadomość.
3. Wybierz Status po udanej wysyłce.
4. Kliknij Wyślij i zapisz odpowiedź.

Dostarczone teksty początkowe to Weryfikacja zapytania, Poproś o dodatkowe informacje, Rysunek gotowy i Wycena wysłana. Początkowo wybierają odpowiednio W trakcie oceny, W trakcie oceny, Rysunek wysłany i Wycenione. To edytowalne teksty wyjściowe odpowiedzi, a nie automatycznie generowane rysunki lub oferty.

Dostępne znaczniki zapytania:

{customer_name}
{request_reference}
{product_name}

Na przykład:

Hello {customer_name},

For request {request_reference}, please confirm the opening width shown in your sketch.

Thank you.

Usuń zbędne wzmianki o produkcie z zapytania bez produktu referencyjnego. Odpowiedzi klientów trafiają do zwykłej skrzynki pocztowej. Moduł nie importuje ich do tego rekordu i nie oferuje klientom portalu rozmów.

Edytor wysyła tekst bez funkcji dołączania plików. Przygotuj rysunki techniczne lub dokumenty ofertowe standardową drogą. Nie ma ekranu ustawień do zapisywania dodatkowych tekstów początkowych wielokrotnego użytku.

Zrozum wyniki wysyłki

Moduł zapisuje wiadomość wychodzącą i jej wynik. Gdy wysyłka się powiedzie, stosowany jest wybrany status; gdy się nie powiedzie, status pozostaje bez zmian. Zmienna treści lub wymagana nazwa produktu, której nie da się uzupełnić, odpowiedź nieprawidłowa po uzupełnieniu zmiennych albo brakująca lub błędna tożsamość nadawcy sklepu również zatrzymują wysyłkę i dodają nieudany wpis do historii.

Temat musi zmieścić się w 191 bajtach. Treść ma limit 20000 znaków oraz limit bajtów kolumny tekstowej bazy. Te limity są sprawdzane ponownie po rozwiązaniu zmiennych i znaczników.

Wynik "unconfirmed" oznacza, że wiadomość wyszła z niepotwierdzoną tożsamością nadawcy sklepu. Status zapytania pozostaje bez zmian. Nie wysyłaj wiadomości ponownie tylko z powodu tego wyniku; najpierw sprawdź, czy klient ją otrzymał. Wynik Wysłano oznacza, że sklep przekazał wiadomość serwerowi pocztowemu, a nie że dotarła do skrzynki lub została przeczytana.

Uruchom codzienne zadanie retencji

Zadanie "Purge retained closed custom requests" jest zaplanowane co 86400 sekund i działa przez cron. Skonfiguruj jego uruchamianie przez cron. Wizyty w sklepie i panelu administracyjnym go nie wykonują.

Użyj menedżera zadań, aby uruchamiać zarejestrowane zadania przez cron i monitorować błędy. Moduł nie ma adresu URL /module/mprcustomrequest/cron.

Administrator serwera może zamiast tego zaplanować publiczną metodę czyszczenia modułu raz dziennie. Zastąp ścieżkę sklepu i uruchom polecenie na koncie PHP z dostępem do sklepu i plików:

php -r 'require "/absolute/path/to/shop/config/config.inc.php"; $m = Module::getInstanceByName("mprcustomrequest"); if (!$m || !$m->active) {exit(1);} $r = $m->cronPurge(); echo json_encode($r), PHP_EOL; exit(empty($r["failed"]) ? 0 : 1);'

Sprawdź wynik, w tym deleted, attachments_deleted, failed i errors. Metoda czyszczenia przetwarza sklepy instalacji według ustawień retencji każdego z nich. Zaplanowane czyszczenie usuwa kwalifikujące się zapytania Zamknięte, pliki, odpowiedzi wychodzące i historię statusów. Zwalnia referencje kontaktów i zachowuje wspólny kontakt nadal potrzebny innemu rekordowi lub liście mailingowej. Czyści też wygasłe ograniczenia częstotliwości i osierocone referencje kontaktów.

Twórz kopie danych wykonawczych

Twórz wspólną kopię tabel zapytań, współdzielonych danych kontaktowych, wymaganych kluczy szyfrowania sklepu i var/mprcustomrequest/uploads/. Archiwum aktualizacji modułu nie zawiera plików klientów. Skonfiguruj serwer WWW tak, aby blokował bezpośredni dostęp do tego katalogu. Pliki blokad Apache działają tylko w Apache.

Brakuje formularza lub okna

Sprawdź przełącznik miejsca i wybrany sklep. Sprawdź hook produktu i wyjście stopki motywu. Osobna strona wymaga własnego przełącznika. Przy produkcie ofertowym sprawdź zarówno ustawienie ofert, jak i sklepową dostępność do zamówienia. Sam brak zapasu nie wybiera trybu ofertowego.

Formularz wygasł lub jest zbyt wiele zapytań

Odśwież wygasły formularz. Tokeny są powiązane ze sklepem i językiem oraz wygasają po 48 godzinach. Jeśli pamięć podręczna strony nadal podaje stary formularz, odśwież właściwą pamięć podręczną. Przy komunikacie ograniczenia częstotliwości poczekaj na koniec bieżącego okna. Nieudane przesłania plików po przejściu wstępnych kontroli nadal mogą być liczone, a odwiedzający w tej samej sieci mogą dzielić limit.

Plik jest odrzucany

Użyj dozwolonego rozszerzenia zgodnego z zawartością. Sama zmiana nazwy nie wystarczy. Sprawdź limit rozmiaru plików ustawiony w module, limity upload/post PHP, limity żądań serwera i liczbę dodatkowych plików. Potwierdź Fileinfo, kontrolę obrazów i chroniony magazyn z prawem zapisu. Limit to jeden szkic i do czterech dodatkowych plików, z wyjątkiem szkicu w trybie ofertowym.

Zapytanie zapisane, ale brakuje poczty

Kolejka potwierdza przyjęcie niezależnie od poczty. Sprawdź "Recipient email override", ustawienia poczty sklepu i diagnostykę zapytania. Powiadomienia o nowych zapytaniach mogą pomijać pliki przekraczające łączny limit wiadomości. Użyj pobierania w rekordzie. Po instalacji otwórz raz konfigurację, aby moduł zapamiętał rzeczywisty katalog administracyjny do linków w powiadomieniach.

Odpowiedź nieudana lub nieoznaczona jako wysłana

Przeczytaj Historia odpowiedzi i błąd. Popraw zmienne treści, których nie dało się uzupełnić, długość tematu lub treści, tożsamość nadawcy sklepu albo drogę wysyłki poczty, zanim ponownie napiszesz odpowiedź. Dla "unconfirmed" sprawdź, czy pierwotna wiadomość dotarła, zanim wyślesz cokolwiek ponownie. Nieudana lub niepotwierdzona wysyłka nie zmienia statusu zapytania.

Link prywatności nie działa lub stare rekordy pozostają

Wyłączona osobna strona wymaga odrębnego działającego adresu polityki w każdym odpowiednim języku. Retencja obejmuje tylko rekordy Zamknięte, dla których od ostatniej zmiany statusu minął ustawiony okres. Otwarte rekordy i Spam pozostają. Potwierdź wykonanie zadania w kontekście cron i sprawdź błędy, w tym uprawnienia do usuwania plików.

Zatrzymaj nowe zgłoszenia

Wyłącz odpowiednie przełączniki "Product page block", "Contact page section" i Osobna strona, a następnie zapisz dla wybranego sklepu. Istniejące zapytania pozostają dostępne dla pracowników, dopóki moduł jest zainstalowany.

Zachowaj lub usuń rekordy

Przed odinstalowaniem lub resetem sprawdź "Purge requests when uninstalling". Początkowo jest wyłączone. W tym stanie tabele biznesowe zapytań i przesłane pliki są zachowywane; konfiguracja, menu modułu, rejestracja osobnej strony i zadania harmonogramu są usuwane.

Po włączeniu odinstalowanie próbuje usunąć rekordy zapytań i pliki modułu we wszystkich sklepach, a po udanym czyszczeniu usuwa tabele biznesowe. Wspólne kontakty potrzebne gdzie indziej pozostają zgodnie z regułami referencji kontaktów. Wykonaj wymaganą kopię przed włączeniem ustawienia. Reset wywołuje zachowanie odinstalowania, więc również może uruchomić to usuwanie.

Moduł zbiera i śledzi ocenę twojego zespołu. Nie oblicza indywidualnych cen, nie generuje rysunków ani dokumentu oferty, nie weryfikuje wymiarów i nie tworzy automatycznie zamówienia.