Integracja Feedu Pinterest: konfiguracja i pomoc

Szybki start

  1. Prześlij i zainstaluj ZIP mprpinterestintegration w Moduły > "Module Manager".
  2. Kliknij "Configure". W Połączenie z Pinterest pozostaw Aktywuj moduł ustawione na Tak.
  3. Wpisz publiczne Adresy URL pinów, po jednym w wierszu. Alternatywnie wpisz URL tablicy lub URL kanału RSS.
  4. Opcjonalnie wpisz Nazwa użytkownika Pinterest dla linków profilu i obserwowania.
  5. W Ustawienia wyświetlania wybierz displayHome jako Hook wyświetlania. W Układ i wygląd na potrzeby pierwszego testu pozostaw Tryb układu ustawiony na grid.
  6. Kliknij Zapisz, a następnie otwórz stronę sklepu renderującą wybrany hook.
  7. Sprawdź, czy miniatury pinów się pojawiają i otwierają właściwe piny Pinterest w nowej karcie.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.

Instrukcja konfiguracji

Instalacja i pierwsza konfiguracja

W starszych wersjach PrestaShop użyj odpowiedniej strony instalacji modułów. Aby wrócić do ustawień tego modułu, otwórz go przez "Configure".

Połączenie z Pinterest

Ustawienie Domyślnie Co zrobić
Aktywuj moduł Tak Włącz lub wyłącz niezależny kanał.
Nazwa użytkownika Pinterest Puste Wpisz nazwę użytkownika używaną w linkach profilu i obserwowania. Nie wybiera ona źródła kanału.
Adresy URL pinów Puste Wpisz jeden publiczny adres URL pinu Pinterest w każdym wierszu. Serwer pobiera tytuł, miniaturę i dostępne dane autora przez Pinterest oEmbed.
URL tablicy Puste Wpisz publiczny adres URL tablicy. Moduł usuwa końcowy ukośnik i dodaje .rss, zachowując parametry lub fragment.
URL kanału RSS Puste Wpisz bezpośredni adres URL RSS. Jeśli nie jest pusty, ma pierwszeństwo przed URL tablicy.

Ustawienia wyświetlania

Ustawienie Domyślnie Co zrobić
Hook wyświetlania displayHome Wybierz displayHome, displayFooterBefore, displayFooter, displayLeftColumn lub displayRightColumn. Twój motyw musi renderować wybrany hook.
Tytuł sekcji Puste Ustaw nagłówek kanału. Pozostaw puste, aby go ukryć.
Pokaż przycisk Obserwuj Tak Pokaż link do profilu pod kanałem, gdy nazwa użytkownika jest ustawiona.
Tekst przycisku Obserwuj Follow Ustaw tekst przed nazwą użytkownika. Jest on dołączany bezpośrednio do nazwy użytkownika.
Pokaż na urządzeniach mobilnych Tak Zezwól na kanał dla odwiedzających rozpoznanych przez PrestaShop jako użytkownicy urządzeń mobilnych.

Link do profilu lub kanału w nagłówku jest zagnieżdżony w bloku tytułu sekcji. Ustaw Tytuł sekcji, jeśli chcesz wyświetlić ten link w nagłówku. Osobny przycisk obserwowania lub subskrypcji ma własny przełącznik.

Układ i wygląd

Ustawienie Domyślnie Co zrobić
Tryb układu grid Wybierz grid, slider lub list. Opcja list wyświetla jedną kartę w wierszu, z miniaturą obok podpisu, jeśli jest wyświetlany.
Liczba artykułów 6 Ustaw dodatnią liczbę. Po pobraniu kanał jest ograniczany do tej liczby elementów.
Kolumny 3 Wybierz 2-6 kolumn siatki lub widocznych elementów slidera na komputerach.
Kolumny mobilne 1 Wybierz 1 lub 2 kolumny siatki lub widoczne elementy slidera poniżej 768px.
Odstęp między postami (px) 16 Ustaw odstępy siatki i slidera, również wartość zerową.
Zaokrąglenie (px) 8 Ustaw zaokrąglenie rogów kart.
Efekt najechania elevate Wybierz elevate, glow, border lub none. Dołączony arkusz stylów unosi kartę, dodaje poświatę, obrysowuje ją albo pozostawia bez wybranego efektu.

Siatka i slider używają trzech kolumn od 768px do 991px oraz ustawienia mobilnego poniżej 768px. Tryb listy zawsze używa jednej kolumny.

Ustawienia kolumn i odstępów dotyczą siatki i karuzeli. Karuzela używa też skonfigurowanej liczby kolumn mobilnych i zaokrąglenia rogów kart. Po zmianie ustawień sprawdź jej nawigację przy szerokościach sklepu na komputerze, tablecie i telefonie.

Informacje o pinie

Ustawienie Domyślnie Co zrobić
Pokaż podpis Tak Pokaż skrócony tytuł pinu/RSS i wiersz autora, jeśli jest dostępny. Podpisy są skracane do 120 znaków przed wyświetleniem w szablonie.

Suwak i wydajność

Ustawienie Domyślnie Co zrobić
Leniwe ładowanie obrazów Tak Wczytuj miniatury i obrazy multimediów przez JavaScript w pobliżu widocznego obszaru. Wyłącz, jeśli takie wczytywanie jest blokowane.
Automatyczne przewijanie (Slider) Nie Automatycznie przesuwaj karuzelę. Nie ma to wpływu na widok siatki ani listy.
Prędkość przewijania 5000 Ustaw interwał karuzeli w milisekundach. Dostępne wartości to 2000, 3000, 5000, 8000 i 10000.
Czas trwania cache 3600 Ponownie używaj pobranych danych przez tyle sekund. Dostępne wartości to 1800, 3600, 7200, 21600, 43200 i 86400.

Źródła kanału i działanie w sklepie

Do wyświetlenia kanału nie potrzebujesz tokenu API Pinterest. Twój serwer musi móc pobrać publiczną odpowiedź RSS lub oEmbed Pinterest. Przetwarzanie RSS wymaga PHP SimpleXML.

Moduł wybiera bezpośredni adres URL RSS, jeśli jest podany. W przeciwnym razie tworzy adres URL RSS z URL tablicy. Jeśli wybrane żądanie RSS nie zwraca wpisów, próbuje Adresy URL pinów przez https://www.pinterest.com/oembed.json?url=.... Nie łączy wszystkich źródeł ani nie przechodzi z niedziałającego bezpośredniego adresu RSS do URL tablicy. Wpisy RSS bez obrazu w opisie są pomijane.

Kanał pojawia się tylko w wybranym hooku. Każda karta otwiera oryginalny adres URL pinu w nowej karcie. Tytuł, link profilu, podpis i przycisk obserwowania zależą od ustawień oraz zwróconych metadanych. Jest to jeden skonfigurowany kanał.

Pamięć podręczna i odświeżanie

Moduł zapisuje pobrane elementy w:

modules/mprpinterestintegration/mprpinterest_feed_cache.json

Proces serwera WWW musi móc zapisywać ten plik w katalogu modułu. Zachowaj normalne uprawnienia właściciela i grupy dla swojego hostingu. Do wyświetlania kanału nie potrzebujesz zadania cron. Żądanie sklepu pobiera dane po wygaśnięciu pamięci podręcznej. Zapisanie głównego formularza kanału czyści pamięć podręczną. Plik jest współdzielony między kontekstami sklepów tego modułu, zamiast osobnego pliku dla każdego sklepu.

W tej wersji nie ma przycisku "Refresh Pinterest Cache". Zapisz ustawienia kanału, aby wyczyścić pamięć podręczną, lub poproś administratora o usunięcie wyłącznie pliku pamięci podręcznej. Następne kwalifikujące się żądanie sklepu pobierze dane. Jeśli podany bezpośredni adres RSS nie działa, moduł korzysta z ręcznie podanych pinów; nie próbuje następnie adresu tablicy.

Zapisywane są tylko niepuste wyniki pobierania. Puste lub nieudane pobranie ukrywa kanał i może zostać ponowione przy kolejnych żądaniach sklepu. Jeśli elementy wyglądają na nieaktualne, po sprawdzeniu źródła wyczyść pamięć podręczną. Tytuły i adresy URL obrazów pochodzą z odpowiedzi zapisanej w pamięci podręcznej, a nie z subskrypcji na żywo w przeglądarce.

Automatyczne publikowanie na Pinterest

Ekran zawiera Włącz automatyczne publikowanie, domyślnie Nie, oraz Szablon podpisu, domyślnie:

{title}

{excerpt}

Read more: {url}

Dostępne symbole zastępcze obejmują {title}, {excerpt}, {url} i {shop_name}. Powiązany panel Wpisy na blogu wymaga danych MPR Blog Revolution. Publikowanie używa Pinterest API v5 i wymaga tokenu dostępu OAuth, identyfikatora tablicy oraz obrazu.

W sekcji Połączenie z Pinterest wpisz Token dostępu do publikowania (ACCESS_TOKEN) i ID tablicy do publikowania (BOARD_ID), a następnie zapisz. Oba pola są domyślnie puste i wymagane tylko do publikowania. Użyj tokenu z uprawnieniem do tworzenia pinów oraz liczbowego ID tablicy docelowej. W tej wersji zapis głównego formularza kanału nadal resetuje osobny przełącznik automatycznego publikowania i szablon podpisu. Po zmianie ustawień kanału zapisz ponownie formularz publikowania.

Po skonfigurowaniu mechanizm publikowania obsługuje kwalifikujące się obiekty opublikowanych wpisów bloga przez hooki dodawania i aktualizacji. Używa obrazu wyróżniającego i szablonu podpisu. Nie publikuje produktów ani stron CMS. Wspólne rekordy kolejki i historii śledzą publikację. Moduł blokuje własne publikowanie, gdy aktywna jest zapisana flaga przejęcia Pinterest przez Social Revolution. Hosty deweloperskie, testowe lub nierozpoznane hosty sklepu mogą być blokowane przez politykę wychodzących operacji zapisu; panel publikowania pokazuje przyczynę.

Przykłady konfiguracji i dostosowania motywu

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

Ręczne źródło pinów:

MPRPINTEREST_PIN_URLS =
https://www.pinterest.com/pin/1234567890
https://www.pinterest.com/pin/9876543210

Źródło tablicy:

MPRPINTEREST_BOARD_URL = https://www.pinterest.com/yourusername/summer-products/

Moduł żąda tego kanału:

https://www.pinterest.com/yourusername/summer-products.rss

Bezpośrednie źródło RSS:

MPRPINTEREST_RSS_URL = https://www.pinterest.com/yourusername/summer-products.rss

Siatka z sześcioma pinami na stronie głównej:

MPRPINTEREST_DISPLAY_HOOK = displayHome
MPRPINTEREST_LAYOUT = grid
MPRPINTEREST_POST_COUNT = 6
MPRPINTEREST_COLUMNS = 3
MPRPINTEREST_MOBILE_COLUMNS = 1
MPRPINTEREST_GAP = 16
MPRPINTEREST_BORDER_RADIUS = 8

Slider w stopce z automatycznym przewijaniem:

MPRPINTEREST_DISPLAY_HOOK = displayFooterBefore
MPRPINTEREST_LAYOUT = slider
MPRPINTEREST_AUTO_SCROLL = 1
MPRPINTEREST_SCROLL_SPEED = 5000

Szablon podpisu publikacji na Pinterest:

{title}

{excerpt}

Read more: {url}

{shop_name}

Dostępne symbole zastępcze publikowania:

{title}
{excerpt}
{url}
{shop_name}

Ścieżki nadpisania w motywie dla kodu sklepu:

themes/your_theme/modules/mprpinterestintegration/views/templates/hook/feed.tpl
themes/your_theme/modules/mprpinterestintegration/views/templates/hook/post_item.tpl

Selektory CSS do pliku custom.css motywu:

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

.mprfeed-pinterest .mprfeed-item {
  box-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);
}

.mprfeed-pinterest .mprfeed-caption {
  font-size: 14px;
}

Opcjonalne zmiany motywu dla wbudowanych efektów najechania:

.mprfeed-pinterest[data-hover="elevate"] .mprfeed-item:hover {
  transform: translateY(-3px);
}

.mprfeed-pinterest[data-hover="glow"] .mprfeed-item:hover {
  box-shadow: 0 0 0 2px rgba(230, 0, 35, 0.18);
}

.mprfeed-pinterest[data-hover="border"] .mprfeed-item:hover {
  outline: 2px solid #e60023;
}

W przypadku karuzeli sprawdź nawigację po zmianie kolumn i odstępów. Zachowaj zmiany CSS i szablonów w motywie.

Weryfikacja i rozwiązywanie problemów

  • Jeśli sekcja jest nieobecna, 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, aby wczytać arkusz 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 potem sprawdź karuzelę przy szerokościach komputerowych i mobilnych.
  • Jeśli MPR Social Revolution ma włączone ustawienie PINTEREST_ACTIVE, ten niezależny kanał jest blokowany. To sprawdzenie 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 konserwacji. Po zmianie identyfikatorów kont lub źródeł kanału sprawdź docelowe strony odnośników.

Wyłączenie lub odinstalowanie

Ustaw Aktywuj moduł na Nie i zapisz, aby ukryć kanał, zachowując jego konfigurację. Zapis tego głównego formularza resetuje też osobny przełącznik automatycznego publikowania i szablon podpisu. Aby publikowanie pozostało wyłączone, potwierdź, że Włącz automatyczne publikowanie ma wartość Nie w osobnym formularzu. Odinstaluj przez menedżer modułów, aby usunąć konfigurację tego modułu, lokalną pamięć podręczną i pozycje menu administracyjnego. Wspólne tabele mpr_social_publish i mpr_social_queue są oznaczone jako współdzielone i pozostają po odinstalowaniu. Odinstalowanie nie usuwa wpisów już wysłanych na platformę.

Pytania

2

Czy Pinterest Feed Integration jest tagiem reklamowym Pinterest?

Nie. mprpinterestintegration wyświetla kanał Pinterest w sklepie.

  • Wyświetlanie kanału: Publiczne dane RSS lub metadane pinów są wyświetlane jako miniatury z odnośnikami.
  • Pinterest Tag: Ta funkcja wymaga osobnego modułu śledzenia.

Wyświetlanie kanału nie wymaga tokenu API Pinterest.

Opcjonalne publikowanie dotyczy wpisów na blogu.

Moduł nie instaluje tagu reklamowego ani nie wysyła zdarzeń konwersji reklamowych; do tego służy mprpinteresttag.

Czy wyświetlanie kanału Pinterest powoduje żądania do zewnętrznych serwerów?

Serwer sklepu pobiera publiczne dane RSS lub dane oEmbed Pinterest. Karty kanału używają adresów URL miniatur z tych danych, więc podczas wczytywania obrazów przeglądarki odwiedzających również mogą wysyłać żądania do serwerów obrazów. Lazy Load Images opóźnia wczytywanie obrazów do chwili, gdy znajdą się blisko widocznego obszaru; to ustawienie nie zastępuje decyzji o zgodzie.

Znane problemy

4

Ostrzeżenie konfiguracji pozostawało po zapisaniu

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.18
Strona ustawień mogła nadal wyświetlać nieaktualne ostrzeżenie konfiguracji tuż po zapisaniu prawidłowych ustawień.

Brakujące tłumaczenia

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.18
Etykiety panelu administracyjnego są teraz wyświetlane w wybranym języku sklepu.

Zgodność ładowania z PHP 7.1

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.18
Moduł mógł się nie ładować na PHP 7.1, ponieważ dołączone wymagania ładowania były zbyt restrykcyjne.

Panel administracyjny modułu mógł się nie otwierać

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.14
Otwieranie panelu administracyjnego modułu mogło kończyć się błędem w sklepach bez wymaganej obsługi formatowania cen.

Zgłoszenia funkcji

2

Zaimplementowane

Publikowanie na Pinterest

Zaimplementowane
Publikuj wpisy blogowe jako piny Pinterest ręcznie z panelu administracyjnego lub automatycznie za pomocą ustawienia publikowania.

Konfiguracja kanału Pinterest z przewodnikiem

Zaimplementowane
Konfiguruj kanał z adresów URL pinów, adresu URL tablicy lub kanału RSS, z kontrolą brakujących źródeł.

Dziennik zmian

v1.0.132026-09-16

  • Addedcomplete FR/DE/ES/IT/PL translations
Starsze wersje

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-04

  • AddedPS 9 / Hummingbird theme compatibility
  • Addedlightbox overlay for pin detail view without leaving the shop
  • Improvedmasonry layout reflow on dynamic content load
  • Fixedboard embed not rendering when Pinterest account uses a custom vanity URL

v1.1.02025-07-15

  • Addedgrid/masonry layout selector in back office
  • Addedconfigurable pin count and board selector per CMS page widget
  • Fixedmissing pin images when Pinterest API returns CDN URLs with query strings

v1.0.02025-04-25

  • Initialrelease: Pinterest boards and pins display for PrestaShop
  • InitialResponsive grid layout with configurable column count
  • InitialBack-office configuration for Pinterest username and board selection
  • InitialCompatible with PS 1.7.x and PS 8.x

Demo

Przetestuj pełny moduł przed zakupem

Licencję kupisz później, a ustawienia zostaną.

  • Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
  • Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
  • Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Uruchom sklep demo

Pobierając, akceptujesz warunki dema i politykę prywatności.

Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.

Ładowanie...
Do góry