Instalacja
Połącz sklep Sylius z Fullmetrix krok po kroku, od pobrania kodu do potwierdzenia połączenia, razem z opisem tego, co robi każde polecenie.
Ta strona podąża za rzeczywistą kolejnością połączenia. Fragmenty oznaczone dla Twojego programisty możesz przekazać mu w niezmienionej postaci. Dodanie wtyczki zajmuje kilka minut, plus czas Twojego zwykłego procesu wdrożeniowego. Import historii zależy potem od wielkości Twojego sklepu.
Przygotuj dwie rzeczy
Dane osoby, która rozwija Twój projekt Sylius (programista lub agencja), oraz konto administratora Sylius. Sprawdź też zgodność swojego sklepu.
Pobierz swój kod połączenia
Kod połączenia łączy Twój sklep z Twoją organizacją w Fullmetrix. Wygląda jak FMTX-7K4M-Q2HD-9WXR. Działa tylko raz. Gdy sklep go przyjmie, nie można go użyć nigdzie indziej.
W kreatorze konfiguracji
Utwórz organizację i ustaw podstawy
Na ekranie Witamy w Fullmetrixie wpisz nazwę w polu Nazwa sklepu, a potem kliknij Utwórz i kontynuuj. Na ekranie Podstawowe ustawienia wybierz Strefę czasową i Walutę, a potem kliknij Zapisz i kontynuuj albo Pomiń ten krok, aby zrobić to później w Ustawieniach ogólnych.
Wybierz Sylius
Na ekranie Połącz swój sklep kliknij wiersz Sylius, oznaczony jako Sylius 1.13+ / 2.0. Fullmetrix przez sekundę pokazuje Generuję kod połączenia....

Skopiuj polecenie i kod
Ekran pokazuje dwie ponumerowane ramki.
- Zainstaluj rozszerzenie zawiera polecenie Composera. Przycisk po prawej stronie kopiuje je i pokazuje Polecenie skopiowane.
- Połącz swój sklep zawiera Twój kod połączenia. Jedno kliknięcie kopiuje go i pokazuje skopiowane.
Pod tymi ramkami panel Oczekiwanie na połączenie wtyczki prosi o pozostawienie strony otwartej. Aktualizuje się sam, gdy tylko Twój sklep przyjmie kod.
Możesz zamknąć stronę i wrócić później. Gdy zalogujesz się ponownie do Fullmetrix, kreator wznawia się w tym samym miejscu z tym samym kodem. Link Zmień platformę przenosi Cię z powrotem do listy, jeśli wybrano złą platformę.
Z Ustawień
Jeśli kreator masz już za sobą albo dodajesz sklep, otwórz Ustawienia, a potem zakładkę Integracje. W kategorii E-commerce kliknij Połącz na karcie Sklep internetowy albo kafelek Dodaj sklep, jeśli jakiś sklep jest już połączony. W oknie Podłącz platformę wybierz Sylius.
Okno pokazuje Kod połączenia z przyciskiem kopiowania, polecenie instalacji i link Wyślij instrukcje do mojego programisty.
Przekaż instalację programiście
Wyślij instrukcje e-mailem
W oknie Podłącz platformę kliknij Wyślij instrukcje do mojego programisty. Wpisz jego adres w polu Adres e-mail programisty, a potem kliknij Wyślij instrukcje. Komunikat Instrukcje wysłane do i adres potwierdzają wysłanie.
Twój programista otrzymuje e-mail z krokami instalacji, Twoim kodem połączenia i ścieżką do menu Fullmetrix w Sylius. Ten link nie jest oferowany w kreatorze konfiguracji. W trakcie kreatora skopiuj polecenie i kod, a potem wyślij je sam, razem z linkiem do tej strony.
Kod jest poufny
Każdy, kto ma Twój kod, może połączyć z nim sklep. Wysyłaj go tylko osobie instalującej wtyczkę i nigdy nie umieszczaj go w repozytorium kodu, publicznym zgłoszeniu ani na udostępnianym zrzucie ekranu.
Dodaj wtyczkę do projektu (dla Twojego programisty)
Wtyczka to pakiet Composera fullmetrix/sylius-plugin. Dodaje się go jako bundle Symfony. Zainstaluj go w środowisku deweloperskim, sprawdź, a potem wdroż zwykłym procesem. Przed uruchomieniem migracji produkcyjnej wykonaj kopię zapasową bazy danych.
Zainstaluj pakiet
W katalogu głównym projektu uruchom poniższe polecenie.
composer require fullmetrix/sylius-pluginPobiera wtyczkę i dodaje ją do composer.json i composer.lock.
Zarejestruj bundle
Sprawdź, czy config/bundles.php zawiera ten wiersz, i dodaj go, jeśli Composer tego nie zrobił.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Mówi Symfony, aby ładowało wtyczkę w każdym środowisku. Wtyczka ma własną konfigurację, więc nie trzeba dodawać żadnego pliku konfiguracyjnego.
Zaimportuj trasy
Utwórz plik config/routes/fullmetrix.yaml o tej zawartości.
fullmetrix:
resource: '@FullmetrixPlugin/Resources/config/routing.yaml'Te trasy otwierają stronę Fullmetrix w panelu administracyjnym, adresy /fullmetrix/api/, które Fullmetrix wywołuje, aby odczytać sklep, oraz link pozwalający kupującemu wznowić porzucony koszyk.
Utwórz tabele wtyczki
bin/console doctrine:migrations:migrateMigracja tworzy dwie małe tabele, jedną na ustawienia połączenia i jedną na dziennik aktywności pokazywany w panelu administracyjnym. Nie dotyka żadnej tabeli Sylius.
Wyczyść pamięć podręczną
bin/console cache:clearWyczyść pamięć podręczną w tym samym środowisku co działająca witryna, zwykle APP_ENV=prod. Polecenie, które kończy się bez błędów, potwierdza, że Symfony ładuje wtyczkę.
Wtyczka nie wymaga żadnego zaplanowanego zadania. Wysyła zmiany do Fullmetrix zaraz po wysłaniu każdej odpowiedzi do odwiedzającego.
Jeśli witryna działa na kilku serwerach, wdróż tę samą wersję wszędzie, uruchom migrację tylko raz i wyczyść pamięć podręczną na każdym serwerze.
Wklej kod w Sylius
Ta część odbywa się w panelu administracyjnym Sylius. Możesz ją wykonać sam, gdy wtyczka jest wdrożona. Strona Fullmetrix w panelu administracyjnym jest po angielsku, niezależnie od języka panelu.
Otwórz stronę Fullmetrix
Otwórz panel administracyjny Sylius pod publicznym adresem HTTPS swojego sklepu, tym, którego używają Twoi klienci. Wtyczka zapisuje ten adres podczas łączenia. W lewym menu kliknij Marketing, a potem Fullmetrix. W zależności od wersji Sylius pozycja może pojawiać się też bezpośrednio w menu głównym. Zawsze prowadzi pod adres /admin/fullmetrix.
Wklej kod i połącz
Strona podsumowuje trzy kroki połączenia. Wklej swój kod w polu Connection code, a potem kliknij Connect. Wielkość liter i spacje wokół kodu nie mają znaczenia.

Przeczytaj potwierdzenie
Strona ładuje się ponownie z plakietką Connected, kodem w trybie tylko do odczytu i przyciskiem Disconnect. Poniżej pojawiają się dwie ramki, Sync activity dla importu i Recent activity dla dziennika.
Jeśli zamiast tego pojawi się czerwony baner Connection failed, powód następuje zaraz po nim. Możliwe powody wyjaśniamy w Rozwiązywaniu problemów.
Śledź import
Wróć do Fullmetrix. W trakcie kreatora panel zmienia się w Wtyczka podłączona, a ekran sam przechodzi do Przygotowanie miejsca pracy. Pasek postępu śledzi import Twoich zamówień, produktów, klientów i historii przychodów. Przycisk Mimo to przejdź do panelu wpuszcza Cię do aplikacji bez czekania, a import działa dalej w tle.
Z Ustawień okno zamyka się z komunikatem Rozpoczęto importowanie, a karta Sylius pokazuje Import w toku z wartością procentową.
Po stronie Sylius ramka Sync activity pokazuje Waiting for sync, potem Sync in progress, a następnie Sync complete z liczbą zaimportowanych elementów każdego typu. Ramka Recent activity wymienia ostatnie 30 zdarzeń z datą (When), typem (Type), komunikatem (Message) i liczbą elementów (Count). Przycisk Clear logs opróżnia ten dziennik, nie dotykając połączenia.
Sprawdź, czy wszystko działa
- W Fullmetrix otwórz Ustawienia, a potem Integracje. Karta Sylius pokazuje adres sklepu, zieloną kropkę i wiersz Ostatnia synchronizacja.
- Złóż zamówienie testowe albo edytuj produkt. Zmiana pojawia się w Fullmetrix chwilę później.
- Otwórz swój sklep, przejrzyj kilka stron, a potem sprawdź dostarczanie zdarzeń w Skrypcie śledzenia.
Zaktualizuj wtyczkę
Gdy ukaże się nowa wersja, Twój programista pobiera ją za pomocą Composera, uruchamia ewentualne nowe migracje, czyści pamięć podręczną i wdraża.
composer update fullmetrix/sylius-plugin
bin/console doctrine:migrations:migrate
bin/console cache:clearPołączenie zostaje zachowane podczas aktualizacji. Nie trzeba ponownie wpisywać kodu.