Integracja postów Facebook: konfiguracja i pomoc
Szybki start
- Prześlij plik ZIP modułu w "Modules > Module Manager" i otwórz "Configure".
- Wprowadź Token dostępu strony i ID strony właściwego konta.
- Ustaw Nazwa strony i pozostaw kanał włączony.
- Wybierz Hook wyświetlania obsługiwany przez szablon, np. displayHome.
- Ustaw Tryb układu, kolumny i widoczną zawartość, a następnie zapisz.
- Użyj "Force sync now", jeśli zastępujesz zawartość pamięci podręcznej.
- 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
- Prześlij plik ZIP Facebook Posts Integration przez "Modules > Module Manager".
- Otwórz "Configure".
- Wprowadź Token dostępu strony, ID strony i Nazwa strony.
- Wybierz rzeczywisty Hook wyświetlania obsługiwany przez szablon, a następnie zapisz.
- 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
Zgodność z PHP 7.1
Nie można zapisać danych uwierzytelniających z okna konfiguracji
Ostrzeżenie konfiguracji pozostaje po zapisie
Wolna strona konfiguracji
Zgłoszenia funkcji
1
Zaimplementowane
Automatyczne publikowanie i planowanie na Facebook
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.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.