Integracja Feedu X (Twitter): 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ń.

Menu Hook wyświetlania oferuje też Niestandardowy widget (użyj {widget} w szablonach), ale ta wersja nie obsługuje tego sposobu wyświetlania. Wybierz standardowy hook, także przy umieszczaniu feedu w szablonie motywu.

Ustawienia kolumn dotyczą siatki i karuzeli. Przy szerokości od 768px do 991px karuzela i siatki z co najmniej dwoma postami używają dwóch kolumn; siatka z jednym postem pozostaje jednokolumnowa. Poniżej 768px używają ustawienia Kolumny mobilne. Siatki zawierające tylko jeden lub dwa posty mają na komputerach odpowiednio jedną lub dwie kolumny, a na urządzeniach mobilnych jedną kolumnę. Odstępy i zaokrąglenie narożników dotyczą każdego układu, w tym karuzeli.

Serwer ustala puste ID użytkownika X przez https://api.x.com/2/users/by/username/{username}. Pobiera oś czasu przez https://api.x.com/2/users/{user_id}/tweets, wraz z datami utworzenia, publicznymi statystykami, załącznikami multimedialnymi i danymi autora. Skonfigurowane konto i dostęp do API muszą zezwalać na te żądania. Moduł nie pobiera ściany hashtagów ani nie łączy wielu kont.

Logika pobierania ogranicza żądaną liczbę wyświetlanych elementów do 20. Pobiera maksymalnie trzykrotność tej liczby, a następnie zachowuje wymaganą liczbę wyników. Utrzymuj liczbę dodatnią. Tekst jest skracany do Maks. długość tekstu podczas pobierania; użyj 0 dla pełnego tekstu. Przełączniki metadanych sterują wyświetlaniem kart, a przełączniki wykluczeń zmieniają żądanie API.

Wybrany standardowy hook renderuje siatkę, karuzelę lub listę. Przycisk obserwowania w nagłówku otwiera https://x.com/{username}. Każda karta otwiera https://x.com/{author_handle}/status/{post_id} w nowej karcie. Filmy pozostają podglądami, bez osadzonego odtwarzacza.

Przy zmianie konta zmień Nazwa użytkownika X i ręcznie wyczyść ID użytkownika X przed zapisaniem. Niepusty identyfikator jest używany ponownie nawet po zmianie nazwy użytkownika. Następnie użyj Synchronizuj teraz.

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

modules/mprxintegration/mprx_feed_cache.json

Ustawienia feedu i ten plik są współdzielone przez sklepy korzystające z tej samej instalacji modułu. Żądania w sklepie używają go, dopóki jest ważny, i pobierają posty z X, gdy pliku brakuje lub upłynął jego czas ważności. Zapis głównego formularza usuwa plik; ta wersja nie ma zaplanowanego zadania odświeżania feedu w tle.

Synchronizuj teraz wymaga tokenu bearer i ustalonego ID użytkownika X, a następnie usuwa pamięć podręczną i od razu pobiera aktualne posty. Wyczyść pamięć podręczną tylko usuwa plik; następne żądanie w sklepie pobierze nowe dane. Jeśli następujące po tym żądanie API nie powiedzie się lub nie zwróci postów, w pamięci podręcznej nie pozostaną żadne posty. Sprawdź oś czasu, dane dostępu i dostęp do API, a następnie ponów próbę.

Zapisywane są tylko niepuste wyniki z API. Przy nieudanym pobieraniu wygasły plik nie jest używany jako źródło zastępcze, więc feed może zniknąć do czasu powodzenia kolejnego żądania. Liczniki API i daty względne odzwierciedlają zapisaną odpowiedź.

Skonfiguruj cztery pola danych uwierzytelniających OAuth 1.0a w Połączenie X (Twitter), jeśli potrzebujesz publikowania z bloga. Sam Token bearer tylko do odczytu nie konfiguruje tej ścieżki publikowania. Następnie użyj osobnego formularza "Auto-Publish to X":

Panel Wpisy na blogu wymaga MPR Blog Revolution i udostępnia ręczną publikację po skonfigurowaniu mechanizmu publikowania. Używa tytułu bloga, zajawki, URL i wyróżnionego obrazu, jeśli jest dostępny. Mechanizm obsługuje tekst oraz obrazy/GIF-y. Publikacja korzysta ze wspólnej kolejki i zapisów historii zapobiegających podwójnej obsłudze. Jeśli panel zgłasza błąd kolejki lub uzgadniania, przed ponowną próbą sprawdź istniejący wynik.

Wyświetlanie feedu i publikowanie mają osobne przełączniki, ale zapis głównego formularza feedu resetuje przełącznik publikowania i podpis, ponieważ tych pól nie ma w formularzu. Po każdym zapisie głównego formularza ponownie zapisz Włącz automatyczne publikowanie i podpis w osobnym formularzu publikowania.

Publikowanie jest wstrzymywane, gdy ustawiona jest flaga przejęcia X przez Social Revolution. Polityka zapisu wychodzącego może też blokować je na hoście deweloperskim/testowym lub z nierozwiązywalną nazwą. Interfejs podaje przyczynę. Inny zainstalowany moduł społecznościowy ładujący starszy wspólny pakiet publikowania może blokować wysyłkę; przy takim błędzie zaktualizuj zainstalowane moduły społecznościowe razem.

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

Wyświetl na stronie głównej siatkę sześciu postów, z trzema kolumnami na komputerze, jedną na urządzeniach mobilnych i tylko oryginalnymi postami:

MPRX_DISPLAY_HOOK=displayHome
MPRX_LAYOUT=grid
MPRX_POST_COUNT=6
MPRX_COLUMNS=3
MPRX_MOBILE_COLUMNS=1
MPRX_EXCLUDE_REPLIES=1
MPRX_EXCLUDE_RETWEETS=1

Użyj kompaktowej listy w prawej kolumnie, bez multimediów i liczników interakcji:

MPRX_DISPLAY_HOOK=displayRightColumn
MPRX_LAYOUT=list
MPRX_POST_COUNT=3
MPRX_SHOW_MEDIA=0
MPRX_SHOW_LIKES=0
MPRX_SHOW_RETWEETS=0
MPRX_SHOW_REPLIES=0
MPRX_TEXT_LENGTH=140

Użyj slidera z automatycznym przewijaniem co osiem sekund:

MPRX_LAYOUT=slider
MPRX_COLUMNS=3
MPRX_AUTO_SCROLL=1
MPRX_SCROLL_SPEED=8000

Dostosuj podpis wysyłany z Blog Revolution do X:

{title}

{excerpt}

Read more: {url}

Dostępne symbole zastępcze podpisu to:

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

Renderuj moduł przez standardowy hook PrestaShop w szablonie motywu, konfigurując moduł dla tego samego hooka:

{hook h='displayHome' mod='mprxintegration'}

Twórcy motywów mogą nadpisać szablony sklepu tutaj:

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

Przydatne selektory CSS do stylowania w motywie:

.mprx-section { margin-top: 32px; }
.mprx-title { font-size: 1.25rem; }
.mprx-item { border-radius: 8px; }
[data-theme="dark"] .mprx-item { background: #16181c; }
.mprx-follow-btn { text-transform: none; }

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

modules/mprxintegration/mprx_feed_cache.json

W przypadku karuzeli sprawdź ustawioną liczbę kolumn i odstępy przy szerokościach komputera, tabletu i telefonu. 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 X_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 ustawienia źródła i wyświetlania. Zapis głównego formularza resetuje przełącznik publikowania i podpis; sprawdź i zapisz potem osobny formularz publikowania, jeśli publikowanie ma być kontynuowane. Odinstaluj przez menedżer modułów, aby usunąć konfigurację, lokalną pamięć podręczną i pozycje menu administracyjnego tego modułu. Wspólne tabele mpr_social_publish i mpr_social_queue są oznaczone jako współdzielone i zachowywane przy odinstalowaniu. Odinstalowanie nie usuwa postów wysłanych już na platformę.