Integracja postów Facebook: konfiguracja i pomoc

Szybki start

  1. Prześlij plik ZIP modułu w "Modules > Module Manager" i otwórz "Configure".
  2. Wprowadź Token dostępu strony i ID strony właściwego konta.
  3. Ustaw Nazwa strony i pozostaw kanał włączony.
  4. Wybierz Hook wyświetlania obsługiwany przez szablon, np. displayHome.
  5. Ustaw Tryb układu, kolumny i widoczną zawartość, a następnie zapisz.
  6. Użyj "Force sync now", jeśli zastępujesz zawartość pamięci podręcznej.
  7. Otwórz wybrany obszar sklepu, potwierdź ładowanie mediów i sprawdź linki do postów oraz obserwowania.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.

Instrukcja konfiguracji

Instalacja i połączenie

  1. Prześlij plik ZIP Facebook Posts Integration przez "Modules > Module Manager".
  2. Otwórz "Configure".
  3. Wprowadź Token dostępu strony, ID strony i Nazwa strony.
  4. Wybierz rzeczywisty Hook wyświetlania obsługiwany przez szablon, a następnie zapisz.
  5. Użyj Force sync now, a następnie otwórz wybrany obszar sklepu. Posty prowadzą do połączonej strony.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.

Ustawienia połączenia

Ustawienie Wartość domyślna po instalacji Co zrobić
Włącz moduł Tak Włącza kanał w sklepie. To ustawienie jest niezależne od Włącz automatyczne publikowanie.
Token dostępu strony Puste Wklej token autoryzowany dla Twojej strony. Formularz połączenia wymaga pages_read_engagement i pages_read_user_content do odczytu. Zapisanie nie testuje tokenu; wczytaj kanał lub opublikuj wpis testowy, aby sprawdzić, czy pozwala odczytywać i publikować.
ID strony Puste Wprowadź liczbowy ID strony, a nie nazwę użytkownika ani URL.
Nazwa strony Puste Wprowadź nazwę używaną w nagłówku i obszarze autora postu.

Moduł wysyła żądanie do https://graph.facebook.com/v21.0/PAGE_ID/posts. Pobiera wiadomość, daty, pełny obraz, link bezpośredni, udostępnienia, podsumowania reakcji/komentarzy, załączniki, typ statusu i dane publikacji. Wyświetla kanał jednej strony naraz.

Akcja obserwowania w sklepie otwiera Facebook; reakcje i komentarze odbywają się tam, a nie w PrestaShop.

Wyświetlanie i układ

Umiejscowienie

Ustawienie Wartość domyślna po instalacji Działanie
Hook wyświetlania displayHome Wybierz displayHome, displayFooterBefore, displayFooter, displayLeftColumn lub displayRightColumn.
Tytuł sekcji Obserwuj nas na Facebooku Nagłówek nad kanałem.
Pokaż przycisk obserwuj Tak Wyświetla link do strony w nagłówku kanału.
Tekst przycisku Obserwuj Obserwuj Tekst przed skonfigurowaną nazwą strony.
Pokaż na urządzeniach mobilnych Tak Wyłącz, aby pomijać kanał dla odwiedzających wykrytych przez PrestaShop jako mobilni.

Kanał wyświetla tylko wybrany standardowy hook. Szablon musi go wywoływać. Do pierwszego testu możesz użyć strony głównej, a następnie przenieść kanał do hooka stopki lub kolumny obsługiwanego przez szablon.

Układ

Ustawienie Wartość domyślna po instalacji Działanie
Tryb układu grid Wybierz grid, slider lub list.
Kolumny 3 Kolumny na komputerach lub widoczne elementy slidera.
Kolumny mobilne 1 Kolumny na urządzeniach mobilnych lub widoczne elementy slidera.
Liczba artykułów 6 Maksymalna liczba wyświetlanych postów. Żądanie pobiera przed filtrowaniem do dwukrotności tej liczby, maksymalnie 100.
Szablon light Wybierz light lub dark.
Efekt najechania elevate Wybierz elevate, glow, border lub none.
Odstęp (px) 16 Odstęp między kartami w pikselach.
Zaokrąglenie krawędzi (px) 8 Zaokrąglenie narożników kart.

Dla siatki na stronie głównej zacznij od sześciu postów, trzech kolumn na komputerach, jednej na urządzeniach mobilnych, odstępu 16px i promienia 8px. Dla kompaktowego slidera w stopce wybierz displayFooterBefore i slider, a następnie sprawdź przewijanie i szerokość na urządzeniach mobilnych.

Zawartość postów i wydajność

Widoczna zawartość

Ustawienie Wartość domyślna po instalacji Działanie
Pokaż tekst wpisu Tak Wyświetla treść postu.
Maks. długość tekstu 200 Skraca tekst postu. Ustaw 0, aby wyłączyć skracanie.
Pokaż media/obrazy Tak Wyświetla dostępne podglądy mediów.
Pokaż datę Tak Wyświetla datę postu lub czas względny.
Pokaż liczbę reakcji Tak Wyświetla zwróconą liczbę reakcji.
Pokaż liczbę udostępnień Tak Wyświetla zwróconą liczbę udostępnień.
Pokaż liczbę komentarzy Tak Wyświetla zwróconą liczbę komentarzy.
Pokaż autora Tak Wyświetla skonfigurowane dane autora strony.
Wyklucz udostępnione posty Nie Pomija posty oznaczone jako shared_story.

Posty z wieloma obrazami mogą pokazywać kompaktową siatkę z maksymalnie czterema podglądami. Mechanizm pobierania pomija elementy bez wiadomości lub full_picture, więc wyświetlana liczba może być niższa od żądanej.

Pamięć podręczna i slider

Ustawienie Wartość domyślna po instalacji Działanie
Automatyczne przewijanie (slider) Nie Automatycznie przesuwa slider.
Prędkość przewijania 5000 ms Opóźnienie między automatycznymi przesunięciami.
Leniwe ładowanie obrazów Tak Odkłada ładowanie obrazów kanału do momentu zbliżenia do widocznego obszaru.
Czas trwania cache 3600 sekund Wybierz 30 minut, 1, 2, 6, 12 lub 24 godziny.

Migawki kanału są zapisywane w bazie danych dla każdego sklepu i połączonej strony. Wizyty w sklepie wyświetlają zapisaną migawkę bez żądań do Meta. Zaplanowane odświeżanie lub synchronizacja pobiera nowe posty; nieudane odświeżenie zachowuje poprzednią migawkę.

Użyj "Force sync now", aby pobrać nowe posty. Nieudana synchronizacja zachowuje poprzednią migawkę; odczytaj wyświetlony status kanału. Leniwe ładowanie używa IntersectionObserver, a gdy jest niedostępny, ładuje obrazy od razu.

Opcjonalne publikowanie z Blog Revolution

Konfiguracja może pokazywać sekcję publikowania, gdy dostępny jest MPR Blog Revolution. Odczyt kanału i publikowanie to osobne operacje. Pozostaw Włącz automatyczne publikowanie wyłączone, zgodnie z domyślnym ustawieniem po instalacji, dopóki świadomie nie zechcesz, aby nowe opublikowane treści bloga tworzyły zdalne posty.

Domyślna wartość Szablon podpisu to:

{title}

{excerpt}

Read more: {url}

Możesz też użyć {shop_name}. Na przykład zmień ostatnią część na Read the article: {url} i dodaj {shop_name} w osobnym wierszu.

Automatyczne publikowanie reaguje na hooki dodawania/aktualizacji obiektów ze statusem publikacji 1 i skonfigurowanymi danymi dostępu. Mechanizm publikowania na Facebooku obsługuje posty tekstowe, z linkiem lub jednym zdjęciem. Ścieżka bloga przekazuje link, więc zwykle wybierany jest post z linkiem, nawet gdy istnieje obraz wyróżniający.

Ręczne przyciski w panelu ostatnich wpisów bloga także tworzą rzeczywiste treści zdalne. Przed ich użyciem sprawdź wybrany wpis, konto i podpis. Publikowanie działa tylko wtedy, gdy token ma uprawnienie do publikowania na tej stronie.

Próby publikacji są zapisywane we współdzielonych danych kolejki/historii, z kontrolą duplikatów i zapisami nieznanych wyników. Moduł podejmuje próbę publikacji w ramach żądania. Jeśli wynik jest nieznany lub wymaga uzgodnienia, przed kolejną próbą sprawdź zdalne konto i wynik w kolejce, aby uniknąć zduplikowanych postów.

Współdzielona polityka zapisu może blokować publikowanie na hoście deweloperskim/testowym lub gdy skonfigurowany host sklepu jest niepewny. Do diagnozy blokady użyj wyświetlanego wyniku i dzienników PrestaShop. Test odczytu kanału nie wymaga zmiany polityki publikowania.

Gdy platforma Facebook jest włączona w Social Revolution (mprsocialrevolution), ten moduł ukrywa własny kanał i zatrzymuje automatyczne publikowanie na Facebooku. Samo zainstalowanie Social Revolution nie powoduje tej zmiany.

Weryfikacja i rozwiązywanie problemów

  • Potwierdź zapis wymaganych danych dostępu, włączenie kanału i wykonywanie wybranego hooka w szablonie.
  • Zsynchronizuj kanał i otwórz wybrany obszar. Jeśli nic się nie pojawia, odczytaj status kanału oraz błędy PHP/API.
  • Sprawdź sterowanie siatką lub sliderem, widoczność na urządzeniach mobilnych, linki obserwowania i bezpośrednie linki do postów. Filtrowanie udostępnionych postów może zmniejszyć liczbę kart.
  • Jeśli uwierzytelnianie nie działa, sprawdź token, ID konta, wersję zdalnego API i uprawnienia. Zapisanie ustawień potwierdza jedynie zapis lokalny. Użyj liczbowego ID strony.
  • Jeśli publikowanie jest niedozwolone, sprawdź dostęp pracownika do modułu, dane konta, wynik polityki hosta, zgodność współdzielonych pakietów i stan poprzedniej próby. Nie ponawiaj wielokrotnie publikacji po niepewnej odpowiedzi.

Dostosowanie i odinstalowanie

Przechowuj nadpisania szablonów w motywie sklepu:

themes/your-theme/modules/mprfacebookpostsintegration/views/templates/hook/feed.tpl
themes/your-theme/modules/mprfacebookpostsintegration/views/templates/hook/post_item.tpl

CSS szablonu może wskazywać .mprfb-section, .mprfb-title, .mprfb-grid, .mprfb-slider, .mprfb-item i .mprfb-follow-btn. Dodatkowe punkty zaczepienia to .mprfb-header, .mprfb-list, .mprfb-media, .mprfb-text i .mprfb-footer.

Aby wstrzymać wyświetlanie, wyłącz Włącz moduł. Osobno wyłącz Włącz automatyczne publikowanie, aby zatrzymać automatyczne publikowanie. Przed odinstalowaniem zachowaj dane dostępu i zrób kopię potrzebnej historii publikacji. Odinstalowanie usuwa menu i ustawienia modułu, czyści jego pamięć podręczną i uruchamia czyszczenie schematu. Nie usuwa postów już utworzonych na Facebooku.

Pytania

1

Czy kanał ładuje Facebook Pixel i czy wszystkie żądania są wykonywane na serwerze?

Kanał pobiera posty przez żądania Graph API po stronie serwera i nie uruchamia Facebook Pixel ani SDK Facebooka. Obrazy postów i awatary strony mogą być ładowane z Meta w przeglądarce odwiedzającego. URL awatara strony zawiera zapisany token dostępu strony. Żądania zdalnych obrazów nie gwarantują przeglądania bez plików cookie.

Znane problemy

5

Brakujące lub uszkodzone tłumaczenia interfejsu

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.21
Niektóre etykiety modułu pozostawały po angielsku lub wyświetlały uszkodzony tekst po wybraniu innego języka sklepu.

Zgodność z PHP 7.1

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.21
Moduł mógł się nie ładować w sklepach działających na PHP 7.1.

Nie można zapisać danych uwierzytelniających z okna konfiguracji

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.21
Zapis danych uwierzytelniających Facebook z okna konfiguracji mógł kończyć się błędem zapisu konfiguracji.

Ostrzeżenie konfiguracji pozostaje po zapisie

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.21
Baner konfiguracji mógł nadal pokazywać poprzedni stan konfiguracji bezpośrednio po udanym zapisie.

Wolna strona konfiguracji

RozwiązaneZaktualizowano:
Naprawiono w: 1.0.14
Otwarcie strony konfiguracji mogło czekać na zdalne żądanie API Facebook.

Zgłoszenia funkcji

1

Zaimplementowane

Automatyczne publikowanie i planowanie na Facebook

Zaimplementowane
Skonfiguruj automatyczne publikowanie na Facebook z podpisem i korzystaj ze wspólnych narzędzi planowania postów.

Dziennik zmian

v1.0.152026-09-18

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedAvoid remote API call during config render
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

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • Addedsupport for Reels and video post thumbnails in the feed widget
  • Improvedresponsive grid layout — columns collapse gracefully on mobile
  • Fixedtoken expiry not refreshing automatically when using long-lived page tokens
  • Addedpost caption truncation with configurable character limit and 'Read more' toggle

v1.0.02025-12-02

  • Initialrelease: display your Facebook Page feed directly in your PrestaShop storefront
  • InitialConfigurable number of posts to fetch (up to 20) via Facebook Graph API
  • InitialResponsive masonry/grid layout with customizable column count
  • InitialOption to open posts in a lightbox or redirect to Facebook

v1.1.02025-08-19

  • Addedskeleton loading placeholder while feed is fetching from the API
  • Improvedcaching — feed data now stored in PrestaShop object cache (Redis-compatible)
  • Fixedfeed not updating after Facebook Page name change
  • Addedcolumn count selector (1–4 columns) for desktop and mobile breakpoints separately

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