Integracja Feedu Pinterest: konfiguracja i pomoc
Szybki start
- Prześlij i zainstaluj ZIP
mprpinterestintegrationw Moduły > "Module Manager". - Kliknij "Configure". W Połączenie z Pinterest pozostaw Aktywuj moduł ustawione na Tak.
- Wpisz publiczne Adresy URL pinów, po jednym w wierszu. Alternatywnie wpisz URL tablicy lub URL kanału RSS.
- Opcjonalnie wpisz Nazwa użytkownika Pinterest dla linków profilu i obserwowania.
- W Ustawienia wyświetlania wybierz
displayHomejako Hook wyświetlania. W Układ i wygląd na potrzeby pierwszego testu pozostaw Tryb układu ustawiony nagrid. - Kliknij Zapisz, a następnie otwórz stronę sklepu renderującą wybrany hook.
- 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
Brakujące tłumaczenia
Zgodność ładowania z PHP 7.1
Panel administracyjny modułu mógł się nie otwierać
Zgłoszenia funkcji
2
Zaimplementowane
Publikowanie na Pinterest
Konfiguracja kanału Pinterest z przewodnikiem
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.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.