1. Po co to jest
Domyślnie FIRECRUX crawluje Twoje strony: pobiera HTML, parsuje meta i treść,
buduje graf linków. Wtyczka WordPress to najprostsza alternatywa — zamiast crawlowania
wtyczka czyta treści wprost z WordPressa i wysyła je do panelu. Bez budowania API,
bez czasu developera: instalujesz, aktywujesz, parujesz i gotowe.
Zakres: wtyczka zastępuje crawl treści Twoich stron. Dane z Google Search Console / Analytics
oraz wolumeny wyszukiwań pozostają w naszych integracjach — wtyczka ich nie dotyka.
Wolisz wystawić własne endpointy zamiast instalować wtyczkę? Skorzystaj z
przewodnika integracji API — te same dane, wystawione przez Twoje własne endpointy.
2. Wymagania
- WordPress 5.6+ z PHP 7.4+ i dostępem administratora.
- HTTPS na stronie (połączenia wychodzące do panelu używają TLS).
- Opcjonalnie: WooCommerce — gdy jest, produkty i kategorie produktów są wykrywane automatycznie.
- Opcjonalnie: wspierana wtyczka SEO (Rank Math, Yoast lub SEOPress) — wtyczka przejmuje tytuł SEO i meta description z tej wtyczki; gdy ich brak, używa tytułu wpisu i wyciągu (excerpt).
3. Pobierz wtyczkę
Pobierz najnowszą paczkę wtyczki (.zip) — ten plik wgrasz w WordPressie w kolejnym kroku.
↓ Pobierz wtyczkę FIRECRUX (.zip)
Wersja: … · Data builda: …
SHA-256: …
Jeśli przycisk nie rozpocznie pobierania, skopiuj adres linku i otwórz go w nowej karcie przeglądarki.
4. Instalacja i aktywacja
- W WordPress: Wtyczki → Dodaj nową → Wgraj wtyczkę.
- Wybierz pobrany
.zip i kliknij Zainstaluj teraz.
- Kliknij Aktywuj.
W menu administratora WordPress pojawi się pozycja najwyższego poziomu Firecrux (z podstronami
Projects / Data / Settings).
5. Sparuj z panelem
Parowanie wiąże tę stronę WordPress z Twoim klientem w panelu — raz na klienta.
Wszystkie crawl targety tego klienta korzystają potem z jednego połączenia (nie parujesz osobno dla każdego targetu).
- W panelu otwórz ustawienia brandu → zakładka Integrations → sekcja WordPress plugin i kliknij Wygeneruj token.
- W WordPress (wp-admin) otwórz zakładkę Firecrux i wybierz opcję „Mam token parowania".
- Wklej token z panelu (URL backendu jest zwykle wypełniony automatycznie) i zatwierdź parowanie.
- Sekcja w panelu zaktualizuje się automatycznie na Sparowany po udanym parowaniu.
Token autoryzuje wyłącznie tę stronę do wysyłania treści dla tego klienta.
Możesz go wygenerować ponownie z panelu w dowolnej chwili (Repair / regenerate token) — stary przestaje działać natychmiast.
Klient może też usunąć parowanie (Remove pairing) lub rozłączyć w samej wtyczce.
6. Klasyfikacja treści i podpinanie crawlowania
Po sparowaniu wskazujesz w panelu, co ma być pobierane i dokąd mają trafiać strony.
Wszystko dzieje się w zakładce Integrations, w sekcji Content classification:
- Ustaw klasyfikację — każdemu typowi treści i taksonomii WordPress przypisz
kind
(Post / Product / Post category / Product category / Other) i zapisz zmiany.
Pozycje bez klasyfikacji są pomijane.
- Przy każdym sklasyfikowanym wierszu zobaczysz ikonę spinacza:
pomarańczowa = crawlowanie niepodpięte,
zielona = aktywne. Kliknij ją, aby
podpiąć pobieranie do kategorii — wybierz istniejącą kategorię tego samego typu
albo utwórz nową (nazwa proponowana od typu). Jedna kategoria może mieć
najwyżej jeden crawl config WP Plugin. Z tego samego okna
wyłączysz crawlowanie danego typu.
- Dane spłyną ręcznie — Integrations → Crawl targets → Synchronize —
albo automatycznie podczas nocnej synchronizacji (następnego wieczora).
- Jeśli klient miał wcześniej skonfigurowane inne źródła (np. crawl HTML tych samych stron),
zdeaktywuj lub usuń stare crawl data configi, żeby nie dublować danych.
Zmiana klasyfikacji odpina crawlowanie: gdy zmienisz kind wiersza, który ma już
podpięty crawl, zapis wyłączy jego pobieranie (panel ostrzeże przed zapisem) — po zapisaniu podepnij
wiersz ponownie ikoną spinacza.
7. Co pobieramy
Po sparowaniu wtyczka raportuje, jakie typy treści wystawia Twoja strona, i wysyła — dla każdej strony:
| Typ treści | Mapowane na kind | Źródło |
|---|
| Wpisy (posts) | POST | wpisy WordPress |
| Strony (pages) | OTHER | strony WordPress |
| Produkty | PRODUCT | WooCommerce (jeśli zainstalowany) |
| Kategorie / taksonomie | POST_CATEGORY / PRODUCT_CATEGORY | klasyfikowane w panelu (Integrations) |
Dla każdej strony wtyczka wysyła te same pola, których oczekuje kontrakt: id, url, title,
h1, główną treść jako HTML, meta_description, canonical_url,
modified_at, status i kind. Nawigacja, header i footer są usuwane — wysyłana jest tylko
treść merytoryczna. Szczegóły pól znajdziesz w przewodniku integracji API.
8. Synchronizacja przyrostowa
Wtyczka nie wysyła wszystkiego za każdym razem. Śledzi datę ostatniej modyfikacji każdej strony i wysyła tylko to,
co się zmieniło od poprzedniej synchronizacji, a dodatkowo raportuje usunięcia, by panel mógł skasować nieistniejące strony.
Ciężka treść (content_html) jest wysyłana tylko dla stron, które faktycznie się zmieniły.
9. Bezpieczeństwo
- Tylko ruch wychodzący: wtyczka wysyła do panelu po HTTPS; panel nie potrzebuje dostępu przychodzącego do Twojej strony.
- Token o wąskim zakresie: autoryzuje synchronizację treści dla tego jednego klienta i niczego więcej.
- Rotacja: wygeneruj token ponownie z panelu kiedy chcesz; wklej nowy w wtyczce.
- Tylko opublikowane: szkice, treści prywatne i z kosza nigdy nie są wysyłane — wyłącznie
published.
- Udostępnianie danych wymaga zgody (wtyczka 1.2.6+): statystyki zgód cookie i log dostępu są po instalacji wyłączone. Włączasz je w Firecrux → Ustawienia → Udostępnianie danych; przy każdym przełączniku jest napisane, co, dokąd i po co jest wysyłane, i w każdej chwili możesz je wyłączyć. Wtyczka podsuwa też gotowy tekst do Twojej polityki prywatności w Ustawienia → Prywatność WordPressa.
- Dokumenty: Informacja o prywatności wtyczki · Regulamin wtyczki (po angielsku).
10. Rozwiązywanie problemów
| Objaw | Rozwiązanie |
|---|
| Status utrzymuje się na Czeka na wtyczkę | Sprawdź URL backendu i token w Firecrux → Settings, po czym ponownie kliknij Paruj teraz. |
| Status pokazuje Błąd | Wygeneruj token ponownie w panelu (Repair / regenerate token) i wklej nowy. |
| Brak produktów na liście | WooCommerce musi być aktywny. Po aktywacji przeładuj taksonomie w panelu (Integrations). |
| Brak kategorii | Sklasyfikuj odpowiednie taksonomie w panelu (Integrations → klasyfikacja) — niesklasyfikowane są pomijane. |
11. Lista kontrolna
- WordPress 5.6+ na HTTPS z dostępem administratora
- Wtyczka
.zip pobrana (§3) i wgrana przez Wtyczki → Dodaj nową → Wgraj wtyczkę
- Wtyczka aktywowana
- Token wygenerowany w panelu (Integrations → WordPress plugin) i wklejony we wtyczce („Mam token parowania")
- Parowanie zatwierdzone — panel pokazuje Sparowany
- Klasyfikacja ustawiona i zapisana w Integrations (§6)
- Crawlowanie podpięte ikoną spinacza przy każdym typie, który ma być pobierany (ikony zielone)
- Synchronizacja odpalona ręcznie (Crawl targets → Synchronize) albo zaplanowana na noc
- Stare crawl data configi klienta zdeaktywowane, jeśli dublowały te same strony