Wtyczka WordPress

Zainstalujesz wtyczkę, połączysz ją tokenem API z kontem SemanticHub i ustalisz, co ma powstawać z każdej dostawy: szkic czy opublikowany wpis.

Wtyczka niczego nie generuje. Jest odbiorcą: co kilkanaście minut pyta SemanticHuba o gotowe wyniki, zapisuje je we własnej kolejce i zakłada z nich wpisy.

Ten opis dotyczy wtyczki w wersji 0.11.0.

#Zainstaluj wtyczkę

1. Wgraj wtyczkę SemanticHub w Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer.
2. Włącz ją. Po pojedynczej aktywacji WordPress od razu otworzy ekran SemanticHub → Start.
3. Jeśli ekran się nie otworzy (na przykład przy aktywacji kilku wtyczek naraz), wejdź w menu SemanticHub → Start.

Adresu API nie wpisujesz. Jest zapisany w kodzie wtyczki i w ustawieniach widnieje tylko do odczytu.

#Połącz z kontem

Ekran Start prowadzi przez trzy kroki i za każdym razem liczy ich stan od nowa, ze stanu instalacji. Skasowany token cofa ekran do właściwego kroku.

Połączenie uznajemy za gotowe dopiero wtedy, gdy meldunek zdolności dotarł do co najmniej jednego celu. Wtedy pozycja Start znika z menu, choć sama strona dalej działa pod zapisanym adresem.

#Meldunek zdolności

Wtyczka wysyła do każdego Twojego celu listę tego, co ta konkretna instalacja WordPressa umie złożyć: bloki (akapit, nagłówek, obraz, lista, cytat, tabela, osadzenie, separator), sekcję seo obsługiwaną natywnie oraz wersję wtyczki. Lista bloków jest przecięciem tego, co wtyczka renderuje, z tym, co jest zarejestrowane w Twojej instalacji.

Meldunek idzie automatycznie: raz po aktywacji, potem raz na dobę i przy każdym zapisaniu tokenu. Możesz go wymusić przyciskiem na ekranie Start albo w SemanticHub → Ustawienia → Zgodność treści.

Dopóki SemanticHub nie zna zdolności tej instalacji, generuje treść pod zestaw domyślny, a nie pod Twojego WordPressa.

#Co się dzieje po zgłoszeniu

• Pierwsze zgłoszenie ustala kontrakt treści celu, jeśli cel jeszcze go nie ma — nie musisz konfigurować go ręcznie.
• Kolejne zgłoszenia, także codzienne powtórzenie bez zmian, tylko zapisują możliwości tej instalacji. Zgłoszenie nigdy nie wstrzymuje dostawy.
• Sekcja, której wtyczka nie renderuje sama, trafia do wpisu w formie zapasowej jako zwykłe bloki treści.
• Raz w tygodniu dostajesz e-mail, jeśli ręcznie ustawiony kontrakt rozjechał się z możliwościami tej instalacji albo wtyczka przestała się zgłaszać.

#Skąd biorą się dostawy

Wtyczka sama pobiera treści — SemanticHub niczego do niej nie wysyła, więc nie potrzebuje adresu Twojej strony ani otwartego wejścia z zewnątrz.

Pobiera wyłącznie gotowe teksty. Cel, który wysyła surowe tematy bez wygenerowanego artykułu, nie ma czego tu dostarczyć: taka dostawa jest odrzucana i widać ją w SemanticHubie jako nieudaną. Jeśli chcesz odbierać wpisy we WordPressie, cel musi mieć włączone generowanie treści.

Wtyczka pobiera feed z SemanticHuba co 15 minut, zadaniem cyklicznym WordPressa. Jednorazowo bierze do 50 wyników, zapisuje je w kolejce i potwierdza odbiór, żeby nie dostać ich ponownie. Wynik, którego nie da się zapisać, nie jest potwierdzany i przyjdzie w kolejnym pobraniu.

Odebrane wyniki zobaczysz w menu SemanticHub → Treści, w zakładkach Do importu, Zaimportowane, Pominięte i Nieudane. Każdy wpis możesz opublikować albo pominąć. Przycisk Pobierz teraz w ustawieniach wykonuje pobranie od ręki, bez czekania na harmonogram.

Cykliczne zadania WordPressa wyzwalają się ruchem na stronie. Na serwisie bez odwiedzin pobranie może się opóźnić.

#Domyślne ustawienia publikacji

W SemanticHub → Ustawienia → Domyślne dla publikacji ustalasz cztery rzeczy.

• Domyślny autor — użytkownik przypisany do tworzonych wpisów. Bez wyboru autorem zostaje redaktor, który kliknął publikację. Przy pobraniu z harmonogramu nikt nie jest zalogowany, więc bez ustawionego autora wpis powstaje bez sprawdzania uprawnień.
• Domyślna kategoria — kategoria nadawana wpisom tworzonym z kolejki.
• Wymagaj kategorii z SemanticHuba: opis w sekcji Wymagana kategoria.
• Automatyczna publikacja — co ma powstać z dostawy.

Tryby automatycznej publikacji:

• Respektuj ustawienie celu w SemanticHub (domyślny) — decyduje cel. Cel z włączoną automatyczną wysyłką daje wpis opublikowany, pozostałe dostawy dają szkic.
• Zawsze szkic — ustawienie celu jest ignorowane, zawsze powstaje szkic do ręcznego przejrzenia.
• Zawsze publikuj — każda dostawa idzie na żywo, również ta bez flagi celu.

Po utworzeniu wpisu wtyczka odsyła do SemanticHuba jego adres: publiczny odnośnik dla wpisu opublikowanego, a dla szkicu i wpisu oczekującego — link do edytora.

Jeden wynik to zawsze ten sam wpis. Nowa wersja wyniku aktualizuje wpis utworzony z pierwszej wersji. Ta sama wersja pobrana drugi raz nie tworzy kopii.

#Wymagana kategoria

W SemanticHub → Ustawienia → Domyślne dla publikacji, pod domyślną kategorią, jest pole Wymagaj kategorii z SemanticHuba. Z fabryki jest wyłączone.

Kategoria wpisu wybierana jest w tej kolejności:

1. Kategoria przesłana z SemanticHuba razem z dostawą, jeśli taka kategoria istnieje w Twoim WordPressie.
2. Domyślna kategoria z ustawień wtyczki.
3. Brak kategorii. Przy wyłączonym wymogu wpis powstaje bez kategorii ustawionej przez wtyczkę.

Wtyczka zgłasza SemanticHubowi listę kategorii tej instalacji i to, czy kategoria jest wymagana. Po zmianie tego pola, domyślnej kategorii albo listy kategorii zgłoszenie idzie samo, około 30 sekund później.

Przy włączonym wymogu dostawa bez kategorii i bez kategorii domyślnej nie tworzy wpisu:

• pozycja trafia do zakładki Nieudane w SemanticHub → Treści;
• wtyczka zgłasza tę porażkę do SemanticHuba.

Gdy ustawisz domyślną kategorię, opublikuj taką pozycję przyciskiem Ponów w zakładce Nieudane. Jeśli ponowienie znowu się nie uda, przyczynę pokaże komunikat na górze strony. Jeśli ten sam wynik przyjdzie ponownie z kategorią, wtyczka opublikuje go sama.

Wymóg dotyczy nowego wpisu. Nowa wersja wyniku, która aktualizuje istniejący wpis, przechodzi bez kategorii i nie zmienia kategorii wpisu. Po pierwszej publikacji kategorią zarządza redakcja.

Każda inna porażka zapisu wpisu też trafia do zakładki Nieudane i jest zgłaszana do SemanticHuba.

#Kategoria z SemanticHuba

Po zgłoszeniu listy kategorii ustawisz kategorię po stronie SemanticHuba, w jednym z dwóch miejsc:

• w kroku Akcja celu, w sekcji Pola odbiorcy, jako kategorię domyślną dla każdego wyniku;
• w wyniku, w zakładce Dostawa, w karcie Pola odbiorcy. Ta wartość zastępuje domyślną tylko dla tego wyniku. Zapisujesz ją przyciskiem Zapisz pola.

Wybrana kategoria jedzie razem z dostawą i ma pierwszeństwo przed Domyślną kategorią z ustawień wtyczki.

#Brak kategorii wstrzymuje wynik

Przy włączonym wymogu SemanticHub sprawdza kategorię przed wysyłką. Wynik bez kategorii nie trafia do WordPressa:

• wynik wraca do statusu Do akceptacji z komunikatem „Dostawa wstrzymana: odbiorca wymaga uzupełnienia pól";
• przycisk Przejdź do Dostawy prowadzi do karty Pola odbiorcy.

Uzupełnij kategorię w zakładce Dostawa albo w kroku Akcja i kliknij Akceptuj i wyślij. Dostawa trafi do tej samej pozycji w kolejce wtyczki, więc we WordPressie nie powstanie druga pozycja ani drugi wpis.

#Porażka publikacji wraca do SemanticHuba

Wtyczka zgłasza każdą porażkę publikacji. W SemanticHubie kanał wtyczki w zakładce Dostawa dostaje wtedy status Błąd z przyczyną podaną przez WordPressa. Wynik, któremu zabrakło kategorii, wraca do statusu Do akceptacji.

Kanał wtyczki ma w SemanticHubie dwa etapy:

• Wysłano do wtyczki: pozycja czeka w kolejce wtyczki, wpisu jeszcze nie ma;
• Dostarczony: wtyczka zgłosiła utworzenie wpisu i odesłała jego adres.

Kanał, który ponad dobę czeka na zgłoszenie wpisu, pokazuje ostrzeżenie i przycisk Ponów.

#Wersja w drugim języku

Wtyczka może dostać wynik w dwóch językach naraz. W SemanticHubie, w kroku Akcja na kafelku Integracja, włącz pole Wersja w drugim języku i wskaż język tekstu źródłowego.

• Tytuł, zajawkę i treść tłumaczymy przy dostawie.
• Obie wersje przychodzą razem albo nie przychodzi żadna. Błąd tłumaczenia zatrzymuje dostawę i widać go w SemanticHubie jako nieudaną.
• Jeden język to jeden wpis. Para języków to dwa wpisy połączone w Polylang jako tłumaczenia.
• Przy aktywnym Polylang wpis w jednym języku też dostaje swój język.
• Bez Polylang wtyczka tworzy wpis tylko w języku źródłowym.

#Co robić, gdy nie działa

Ekran Start zatrzymuje się na kroku trzecim. Najczęściej na koncie nie ma jeszcze żadnego celu. Utwórz cel w SemanticHub i kliknij Zgłoś zdolności i sprawdź cele.

Komunikat „Nieprawidłowy token (401)”. Token został wpisany z błędem albo usunięty w SemanticHub. Wygeneruj nowy i zapisz go ponownie. Pole tokenu w ustawieniach jest puste także wtedy, gdy token jest zapisany — wpisanie pustej wartości niczego nie kasuje.

Komunikat „Błąd połączenia” z innym statusem. WordPress nie dosięga API SemanticHuba. Sprawdź, czy serwer ma wyjście na zewnątrz i czy zapora albo wtyczka bezpieczeństwa nie blokuje żądań wychodzących.

Nic nie przychodzi, choć połączenie działa. Sprawdź w ustawieniach czas ostatniego pobrania i kliknij Pobierz teraz. Jeśli kolejka nadal jest pusta, przyczyna jest po stronie celu: brak zaakceptowanych wyników albo włączony tryb testowy.

Pozycja jest w zakładce „Nieudane”. Przy wymaganej kategorii przyczyną jest zwykle brak kategorii w dostawie i brak kategorii domyślnej. Ustaw domyślną kategorię i kliknij Ponów. Możesz też uzupełnić kategorię w SemanticHubie i wysłać wynik ponownie: trafi do tej samej pozycji.

Wpisy powstają jako „Oczekuje na przegląd” zamiast opublikowanych. Domyślny autor nie ma uprawnienia publish_posts. Wskaż innego autora albo publikuj ręcznie z listy Treści.