fullmetrixDocs

Rozwiązywanie problemów

Napraw problemy z wtyczką Sylius, od nieudanej instalacji po import, który się nie kończy.

Zawsze zaczynaj od kontroli, które niczego nie zmieniają. Nie klikaj Disconnect w Sylius ani w Fullmetrix, żeby „zacząć od nowa”. W Sylius odłączenie przerywa powiązanie, a kodu nie można użyć ponownie. W Fullmetrix usuwa zaimportowane dane.

Kilka kontroli na tej stronie dotyczy kodu projektu. Przekaż je swojemu programiście, razem z godziną i dokładnym komunikatem problemu.

Composer odmawia zainstalowania wtyczki

Programista uruchamia to polecenie, aby sprawdzić, co blokuje instalację.

composer why-not fullmetrix/sylius-plugin '*'

Zwykłe przyczyny to wersja PHP niższa niż 8.1, brakujące rozszerzenie cURL lub JSON albo wersja Sylius, Symfony lub Doctrine spoza listy w Zgodności. Programista rozwiązuje zależności na swoim komputerze, a potem wdraża powstały plik composer.lock. Kopiowanie folderu vendor/ z jednego komputera na drugi to zły pomysł, jeśli wersje PHP się różnią.

Symfony nie ładuje wtyczki

Jeśli bin/console cache:clear kończy się błędem albo nie istnieje żadna trasa Fullmetrix, sprawdź, czy config/bundles.php zawiera ten wiersz.

Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],

Programista uruchamia następnie composer dump-autoload i czyści pamięć podręczną w tym samym środowisku co działająca witryna. Przy kilku serwerach sprawdza każdy z nich.

Strona Fullmetrix nie pojawia się w panelu administracyjnym

  1. Otwórz bezpośrednio adres /admin/fullmetrix swojego sklepu na koncie administratora. Jeśli strona się pojawia, brakuje tylko menu, często z powodu niestandardowego menu administracyjnego lub motywu.
  2. Jeśli adres zwraca błąd 404, trasy nie są zaimportowane. Programista sprawdza plik config/routes/fullmetrix.yaml, a potem uruchamia bin/console debug:router fullmetrix_admin_connection, co musi pokazać trasę.
  3. Czyści pamięć podręczną, a Ty odświeżasz stronę.

Migracja kończy się błędem

  • Wykonaj kopię zapasową bazy danych, zanim spróbujesz ponownie.
  • Programista sprawdza bin/console doctrine:migrations:status i pierwszy wyświetlony błąd.
  • Sprawdza, czy użytkownik bazy danych ma prawo tworzyć tabele.
  • Nie tworzy tabel ręcznie i nie oznacza migracji jako wykonanej bez zrozumienia błędu.

Komunikaty o błędach połączenia

Gdy połączenie się nie powiedzie, strona pokazuje Connection failed, a po nim powód. Niektóre powody wracają po francusku. Cytujemy je poniżej tak, jak się pojawiają.

Wyświetlony powódCo oznaczaCo zrobić
invalid_code_formatKod nie ma formatu FMTX-XXXX-XXXX-XXXXSkopiuj go ponownie z Fullmetrix. Nigdy nie zawiera liter O i I ani cyfr 0 i 1.
storage_failedWtyczka nie zdołała zapisać swoich ustawieńMigracja prawdopodobnie nie została uruchomiona. Programista uruchamia bin/console doctrine:migrations:migrate.
Code de connexion introuvableTen kod nie istnieje w FullmetrixSkopiuj ponownie kod wyświetlony w Twojej organizacji, bez dodatkowych znaków
Plateforme incorrecte pour ce codeKod został utworzony dla innej platformyW Fullmetrix wróć do wyboru platformy, wybierz Sylius, a potem skopiuj wyświetlony kod i spróbuj ponownie
Ce code est déjà associé à un autre siteJakiś sklep już przyjął ten kodZobacz następną sekcję
Trop de tentatives, réessayez dans quelques minutes.Zbyt wiele prób w krótkim czasiePoczekaj dziesięć minut, zanim spróbujesz ponownie
Cette boutique est déjà connectée à une autre Organization.Sklep należy już do innej organizacji FullmetrixUżyj tej organizacji albo najpierw usuń z niej sklep
Cette boutique a déjà bénéficié d'un essai Fullmetrix...Bezpłatny okres próbny został już wykorzystany dla tego sklepuWymagana jest subskrypcja, zobacz Rozliczenia
invalid_response, register_failed albo komunikat sieciowySerwer nie zdołał prawidłowo połączyć się z FullmetrixProgramista sprawdza, czy PHP może otwierać wychodzące połączenia HTTPS do fullmetrix.com (zapora, proxy, DNS, certyfikaty)

Nie udostępniaj aktywnego kodu

Kod jest tajny. Jeśli wysyłasz zrzut ekranu strony Fullmetrix w Sylius, całkowicie zasłoń pole Connection code.

Kod jest „już powiązany z inną witryną”

Kod działa tylko raz. Komunikat Ce code est déjà associé à un autre site pojawia się, gdy ponawiasz próbę z kodem, który został już przyjęty, na przykład po kliknięciu Disconnect w Sylius albo gdy pierwsza użyła go inna instalacja (na przykład witryna testowa).

Jeśli karta sklepu w Fullmetrix nadal działa, nie trzeba nic robić. Jeśli sklep został odłączony w Sylius i chcesz go połączyć ponownie, potrzebujesz nowego kodu. Otwórz Ustawienia, potem Integracje, kliknij Odłącz na karcie Sylius, potwierdź, a następnie dodaj sklep ponownie, aby otrzymać świeży kod. To kasuje dane zaimportowane do Fullmetrix, które są potem importowane ponownie z Twojego sklepu.

Połączono, ale import się nie kończy

  1. W Sylius otwórz Marketing, potem Fullmetrix i spójrz na ramkę Sync activity. Zanotuj, czy pokazuje Waiting for sync, Sync in progress czy Sync complete.
  2. Przeczytaj ramkę Recent activity. Wiersz sync_error zawiera przyczynę błędu. Zanotuj ją, zanim klikniesz Clear logs.
  3. W Fullmetrix przeczytaj kartę Sylius w Ustawieniach, w zakładce Integracje. Komunikat Ostatnia synchronizacja nie mogła dotrzeć do Twojego sklepu oznacza, że Fullmetrix nie zdołał wywołać Twojej witryny.
  4. Programista sprawdza, czy adresy /fullmetrix/api/ przechodzą przez proxy, pamięć podręczną i zaporę. Jeśli korzystasz z Cloudflare, postępuj zgodnie z Cloudflare i zapory.
  5. Sprawdza logi PHP i serwera WWW z czasu wystąpienia problemu oraz to, czy każdy serwer uruchamia tę samą wersję wtyczki.

Po błędzie przycisk Synchronizuj ustępuje miejsca przyciskom Wznów i Resetuj. Gdy przyczyna zostanie usunięta, kliknij Wznów, aby kontynuować od miejsca, w którym import się zatrzymał. Jeśli Wznów nie jest oferowany, kliknij Resetuj, co zeruje postęp i uruchamia synchronizację ponownie bez kasowania zamówień, które już zaimportowano. Pozostałe stany karty opisuje Stan synchronizacji.

Adres sklepu w Fullmetrix jest błędny

Karta pokazuje adres wysłany przez wtyczkę podczas łączenia. Jeśli to adres wewnętrzny, adres HTTP albo inna domena, panel administracyjny został otwarty pod tym adresem albo Symfony nie ufa proxy stojącemu przed witryną. Programista poprawia konfigurację proxy. Aby zapisać właściwy adres, sklep trzeba potem połączyć ponownie z nowym kodem, jak wyjaśniono wyżej.

Śledzenie odwiedzających nic nie odbiera

  • Sprawdź, czy strona Fullmetrix w Sylius nadal pokazuje Connected.
  • Testuj na publicznej stronie sklepu, a nie w panelu administracyjnym.
  • Wyczyść wszelką pamięć podręczną stron stojącą przed witryną.
  • Wykonaj test po zaakceptowaniu plików cookie, jeśli działa baner zgody.
  • Sprawdź dostarczanie w Skrypcie śledzenia.

Skontaktuj się z pomocą techniczną

Jeśli problem nie ustępuje, skontaktuj się z nami i podaj poniższe informacje.

  • Publiczny adres sklepu i nazwę Twojej organizacji w Fullmetrix.
  • Wersje Sylius, wtyczki, PHP, Symfony i Doctrine.
  • Dokładny komunikat, godzinę jego pojawienia się i strefę czasową.
  • Wynik bin/console debug:router fullmetrix_admin_connection.
  • Zrzut ekranu ramek Sync activity i Recent activity, z zasłoniętym kodem.

Nigdy nie wysyłaj hasła, kodu połączenia ani fragmentu produkcyjnej bazy danych.

Na tej stronie