Integracja Feedu YouTube: konfiguracja i pomoc

W starszych wersjach PrestaShop użyj odpowiedniej strony instalacji modułów. Otwieraj ten moduł przez "Configure", gdy chcesz wrócić do jego ustawień.

Link do profilu/kanału w nagłówku jest zagnieżdżony w bloku tytułu sekcji. Ustaw Tytuł sekcji, aby go wyświetlić. Osobny przycisk obserwowania/subskrypcji ma własny przełącznik.

Ustawienia kolumn i odstępów dotyczą układu feedu. Sprawdź karuzelę przy szerokościach sklepu na komputerach i urządzeniach mobilnych.

Dla ręcznie dodawanych filmów użyj tych formatów URL z rzeczywistym 11-znakowym identyfikatorem filmu YouTube:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

Przykładowy identyfikator jest symbolem zastępczym. Zastąp go dostępnym filmem. Parser wyodrębnia identyfikator i tworzy URL oglądania, osadzania oraz miniatury img.youtube.com. Pobiera tytuł i autora przez YouTube oEmbed. Poprawnie odczytany identyfikator tworzy kartę nawet przy błędzie oEmbed, ale tytuł/autor mogą być puste, a miniatura/odtwarzacz mogą nie działać.

Dla źródła automatycznego wpisz Klucz API YouTube oraz ID playlisty lub ID kanału. Gdy ustawiono playlistę, moduł używa endpointu playlistItems. W przeciwnym razie używa search dla filmów kanału uporządkowanych według daty. Następnie pobiera szczegóły videos dotyczące czasu trwania i statystyk. Wynik jest ograniczony do 25 na żądanie API. Jeśli API nie zwróci filmów, używa ręcznych adresów URL. Po nieudanym żądaniu playlisty nie ponawia próby z ID kanału.

Tryb ręczny nie ma czasu trwania, liczby wyświetleń ani daty publikacji. Wyświetlanie daty z API używa daty podanej przez wybrane źródło. Wyświetlasz jeden skonfigurowany feed; moduł nie przypisuje filmów do poszczególnych produktów. Strona produktu może pokazywać ten sam feed, jeśli jej motyw renderuje wybrany hook.

W Tryb odtwarzacza embed JavaScript modułu przechwytuje link miniatury i otwiera lightbox. Uzupełnia URL iframe YouTube o autoplay=1&rel=0. Zamknij przyciskiem, kliknięciem tła lub klawiszem Escape. Zamknięcie czyści źródło iframe i zatrzymuje odtwarzanie.

W trybie newtab link otwiera stronę oglądania YouTube w nowej karcie. Bez JavaScript link miniatury również prowadzi do YouTube, ale miniatury ładowane leniwie przez JavaScript mogą pozostać niezaładowane. Moduł nie kontroluje dostępności zdalnego odtwarzacza, reklam ani ograniczeń konta/filmu. Przetestuj konkretne filmy, których chcesz użyć.

Pamięć podręczna feedu używa tego lokalnego pliku:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Dane feedu są zapisywane w jednym lokalnym pliku JSON na instalację modułu. Sklepy korzystające z tego samego katalogu współdzielą plik. Żądanie w sklepie pobiera filmy, gdy pamięć podręczna nie istnieje lub wygasła. Feed nie jest odświeżany przez zaplanowane zadanie w tle.

Użyj Clear Cache, aby usunąć plik pamięci podręcznej. Zapis głównych ustawień również go czyści. Następne żądanie w sklepie pobiera nowe filmy; dotychczasowa zawartość nie pozostaje widoczna podczas tego żądania.

Zapisywane są tylko niepuste wyniki. Jeśli pobieranie nie powiedzie się lub nie zwróci filmów, to żądanie nie pokaże feedu, a kolejne żądania ponowią próbę. Wygasły plik może pozostać na serwerze, ale jego stare filmy nie są wyświetlane. Liczniki API i daty względne odpowiadają zapisanej odpowiedzi.

Poniższe przykłady opisują wartości do wpisania w formularzach zaplecza. Nie są to polecenia powłoki. Zastąp nazwy kont, identyfikatory pinów/filmów i dane uwierzytelniające rzeczywistymi wartościami. Hook motywu musi odpowiadać Hook wyświetlania.

Ręczna siatka prezentacji produktów bez klucza API:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_VIDEO_URLS=https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/LMNOPQRSTUV
https://www.youtube.com/shorts/WXYZabcdefg
MPRYOUTUBE_DISPLAY_HOOK=displayHome
MPRYOUTUBE_LAYOUT=grid
MPRYOUTUBE_POST_COUNT=3
MPRYOUTUBE_COLUMNS=3
MPRYOUTUBE_PLAYER_MODE=embed

Slider playlisty z pobieraniem przez API i pamięcią podręczną:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_API_KEY=AIza...
MPRYOUTUBE_PLAYLIST_ID=PL...
MPRYOUTUBE_DISPLAY_HOOK=displayFooterBefore
MPRYOUTUBE_LAYOUT=slider
MPRYOUTUBE_POST_COUNT=6
MPRYOUTUBE_AUTO_SCROLL=1
MPRYOUTUBE_SCROLL_SPEED=4000
MPRYOUTUBE_CACHE_DURATION=3600

Obsługiwane formaty ręcznych adresów URL:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

Jeśli motyw nie wyświetla wybranego hooka, dodaj odpowiednie wywołanie hooka PrestaShop we właściwym szablonie Smarty:

{hook h='displayFooterBefore'}

CSS motywu może używać klas modułu w sklepie:

.mprfeed-youtube .mprfeed-title {
  font-size: 20px;
}

.mprfeed-youtube .mprfeed-follow-youtube {
  background: #cc0000;
}

.mprfeed-youtube .mprfeed-caption {
  min-height: 2.8em;
}

Pamięć podręczna feedu używa tego lokalnego pliku:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Zmiany CSS i szablonów przechowuj w motywie.

• Jeśli brakuje sekcji, sprawdź Aktywuj moduł, pola źródeł, Pokaż na urządzeniach mobilnych i wybrany hook. Moduł nie zwraca sekcji, gdy nie ma dostępnych elementów.
• Sprawdź, czy motyw wywołuje displayHeader do załadowania arkusza stylów i JavaScript oraz renderuje wybrany hook wyświetlania.
• Jeśli obrazy pozostają puste, sprawdź błędy sieciowe przeglądarki. Spróbuj wyłączyć leniwe ładowanie i sprawdź adresy URL obrazów.
• Jeśli układ jest nieprawidłowy, najpierw przetestuj siatkę, a następnie karuzelę przy szerokościach komputerowych i mobilnych.
• Jeśli w MPR Social Revolution włączono YOUTUBE_ACTIVE, ten niezależny feed jest ukrywany. Kontrola odczytuje zapisaną flagę; nie wymaga, aby Social Revolution był obecnie włączony jako moduł.

Otwórz stronę "Integrity" modułu, aby sprawdzić konfigurację i hooki. Licencja, Wsparcie i Aktualizuj to strony utrzymania modułu. Po zmianie identyfikatorów kont lub źródeł feedu przetestuj rzeczywiste adresy docelowe.

Ustaw Aktywuj moduł na Nie i zapisz, aby ukryć feed, zachowując konfigurację. Odinstaluj przez menedżer modułów, aby usunąć konfigurację, lokalną pamięć podręczną i pozycje menu administracyjnego tego modułu.