Panel „Global settings” – konfiguracja podstawowa
Panel FAQ Schema Generator – Global settings służy do ustawienia ogólnego działania wtyczki na całej stronie. Wszystkie pokazane na ekranie opcje wpływają na to, z jakiej treści powstanie FAQ, gdzie pojawi się skrypt oraz kiedy zostanie wygenerowany.
Sekcja „FAQ JSON-LD generation”
Ta sekcja decyduje, jak wtyczka buduje kod JSON-LD FAQPage na froncie. Ustawienia dotyczą zarówno wyboru źródła pytań i odpowiedzi, jak i sposobu wstrzykiwania skryptu na stronie.
Plugin status – włączenie lub wyłączenie wtyczki
Plugin status to główny przełącznik działania. Zaznaczenie pola Enable FAQ Schema Generator functionality oznacza, że wtyczka generuje kod FAQ wszędzie tam, gdzie nie została wyłączona innymi regułami. Odznaczenie pola całkowicie wyłącza generowanie FAQ, bez konieczności dezaktywacji wtyczki.
Generate from dl, dt, dd elements – FAQ z list definicji
Opcja Generate from <code>dl, dt, dd</code> elements z polem Enable parsing pozwala używać klasycznych list definicji jako źródła FAQ. Każda para <dt> (pytanie) i <dd> (odpowiedź) jest zamieniana na osobny element JSON-LD.
Użyj tego, jeśli posiadasz już rozbudowane bloki FAQ zbudowane na <dl>, albo korzystasz z motywu lub innej wtyczki, która taką strukturę generuje.
Exclude post types – wykluczanie typów treści
W polu Exclude post types zaznaczysz typy treści, na których w ogóle nie chcesz widzieć FAQ JSON-LD (np. załączniki lub produkty). Zaznaczone typy są całkowicie pomijane – nawet jeśli spełniają inne warunki generowania FAQ.
- Zaznacz typy treści, które mogą generować duplikaty FAQ lub nie są istotne dla SEO (np. Media (attachment)).
- Zostaw odznaczone te, na których FAQ ma być generowane (najczęściej: wpisy blogowe, strony statyczne, wpisy z bazy wiedzy).
Heading levels to scan – pytania z nagłówków
Grupa pól Heading levels to scan definiuje, które poziomy nagłówków (H2–H6) będą skanowane w poszukiwaniu pytań. Wtyczka traktuje nagłówki kończące się znakiem „?” jako pytania, a pierwszy sensowny akapit pod spodem jako odpowiedź.
- Zaznacz interesujące Cię poziomy (np. H2, H3, H4), aby wtyczka szukała w nich pytań.
- Upewnij się, że pytania w treści wpisów rzeczywiście kończą się „?” – dzięki temu unikniesz błędnych dopasowań.
- Domyślnie wtyczka ignoruje nagłówki oznaczone klasą
faq-question-exclude.
Akapit wykorzystywany jako odpowiedź to pierwszy <p> pod nagłówkiem, który nie ma klasy faq-answer-exclude. Dodatkowo fragmenty tekstu wewnątrz odpowiedzi oznaczone klasą faq-answer-part-exclude nie są uwzględniane w JSON-LD.
Use headings without question mark – wymuszenie znaków zapytania
Po zaznaczeniu opcji Use headings without question mark wtyczka może traktować wszystkie skanowane nagłówki jak pytania, nawet jeśli nie kończą się „?”. Jeśli nagłówek kończy się kropką, wykrzyknikiem lub dwukropkiem, wtyczka usunie ten znak i doda „?”.
Włącz tę funkcję tylko wtedy, gdy masz pewność, że wybrane nagłówki rzeczywiście są pytaniami. W przeciwnym razie w FAQ mogą pojawić się zbędne lub dziwnie sformułowane pytania.
Script injection position – gdzie wstrzykiwany jest kod FAQ
Ustawienie Script injection position decyduje, gdzie na stronie zostanie dodany skrypt JSON-LD z FAQ:
- Header (wp_head) – skrypt pojawia się w sekcji
<head>. Przydatne, jeśli chcesz, aby kod był dostępny możliwie wcześnie. - Footer (wp_footer) – skrypt ląduje w stopce strony. To bezpieczny wybór, minimalnie obciążający ładowanie strony (domyślne ustawienie).
Wait for Google Tag Manager – opóźnienie generowania FAQ
Po włączeniu opcji Wait for Google Tag Manager wtyczka czeka na inicjalizację Google Tag Managera (GTM), zanim wygeneruje kod FAQ. Dzięki temu skrypt nie „ściga się” z innymi tagami, co zmniejsza ryzyko konfliktów przy zaawansowanych konfiguracjach analitycznych.
Jeśli nie korzystasz z GTM lub nie masz specjalnych wymagań, tę opcję możesz zostawić wyłączoną. Wtyczka i tak posiada wbudowany bezpieczny limit czasu.
Data cleanup – sprzątanie danych wtyczki
Ustawienie Data cleanup z polem Delete plugin options on uninstall decyduje, czy przy odinstalowaniu wtyczki jej ustawienia zostaną usunięte z bazy danych WordPress. Zaznacz, jeśli chcesz zostawić po sobie „czysty” system po definitywnym usunięciu wtyczki.
Ustawienia na poziomie pojedynczego wpisu lub strony
W edytorze blokowym WordPress wtyczka dodaje w panelu bocznym (po prawej stronie) sekcję FAQ Schema (BeeClear). To ustawienie dotyczy wyłącznie bieżącego wpisu lub strony.
Na przedstawionym zrzucie ekranu widzisz jedyną opcję dostępną w panelu per-post:
- Exclude this page/post from FAQ script — po zaznaczeniu wtyczka nie wygeneruje danych strukturalnych FAQ JSON-LD dla tego konkretnego wpisu, nawet jeśli występują w nim nagłówki z pytaniami lub sekcje <dl>.
To rozwiązanie przydaje się m.in. wtedy, gdy wpis ma nietypową strukturę, generuje kolizję z innym schematem (np. HowTo, Product), albo jego treść nie powinna tworzyć rozszerzonego wyniku FAQ w Google.
Najczęściej zadawane pytania
- Włączyłem Internal & External Link Manager, dodałem frazy, ale na froncie nie pojawia się żaden link. Co sprawdzić?
- Najpierw upewnij się, że treść ma minimalną długość ustawioną w „Minimum content length” (domyślnie 200 znaków po wycięciu HTML). Wtyczka działa tylko na postach z typów zaznaczonych w „Process INTERNAL post types” i domyślnie tylko na pojedynczych wpisach (listy/archiwa – dopiero po włączeniu „Process INTERNAL links on archives”). Dla linków wewnętrznych frazy muszą być zapisane jako reguły w metaboxie posta-celu i ten post musi być opublikowany; bieżący wpis nie zalinkuje sam do siebie. Jeśli zaznaczyłeś „Disable autolinking from this post”, linki nie będą wstrzykiwane w jego treści. Dodatkowo wykluczenia w „Skip elements (INTERNAL/EXTERNAL)” mogą blokować linki w nagłówkach czy listach.
- W jednym artykule wtyczka tworzy za dużo linków albo w dziwnych miejscach. Jak ograniczyć agresywność linkowania?
- Gęstość linków kontrolujesz globalnie w ustawieniach: „Max links per INTERNAL target (per page)” ogranicza liczbę odnośników prowadzących do jednego posta, a „Max TOTAL links injected per page” ustawia łączny limit dla linków wewnętrznych i zewnętrznych (0 = brak limitu). Jeśli linki pojawiają się w nagłówkach, listach lub innych wrażliwych miejscach, wpisz odpowiednie tagi HTML w „Skip elements (INTERNAL)” i „Skip elements (EXTERNAL)”, np. h2, h3, li. Gdy zauważysz linkowanie przez wytłuszczenia/pochylenia typu „WordPress”, możesz wyłączyć opcję „Cross-inline (formatting tags)”, żeby frazy nie były składane przez b/strong, i/em, u czy mark.
- Po zapisaniu reguł w „External linking” część wierszy znika albo linki zewnętrzne w ogóle się nie pojawiają. Dlaczego?
- Podczas zapisu wtyczka czyści reguły i pomija te, które są niepoprawne, więc po odświeżeniu panelu problematyczne wiersze po prostu znikają. Najczęstsza przyczyna to puste pole „Phrase” lub „Destination URL”, albo URL, którego WordPress nie uzna za poprawny adres (po sanitizacji robi się pusty). Jeśli zaznaczysz „Regex”, fraza musi być prawidłowym wyrażeniem regularnym – błędny regex zostanie odrzucony i reguła nie zadziała. Puste pole „Post types” oznacza „wszystkie typy”, więc jego wyczyszczenie nie blokuje działania. Pamiętaj też, że obowiązują globalne limity długości treści oraz „Skip elements (EXTERNAL)”, które mogą uniemożliwić wstrzyknięcie linku.
- Jak całkowicie wyłączyć automatyczne linkowanie w pojedynczym wpisie albo dla całego rodzaju treści?
- Dla pojedynczego wpisu użyj opcji w metaboxie „Internal Link Phrases/Rules (BeeClear)”. Zaznaczenie „Disable autolinking from this post (no outgoing links)” powoduje, że w treści tego konkretnego wpisu wtyczka nie wstrzyknie żadnych linków – ani wewnętrznych, ani zewnętrznych – choć inne artykuły nadal mogą linkować do niego jako celu. Jeżeli chcesz, aby dany typ posta w ogóle nie był przetwarzany, w globalnych ustawieniach odznacz go w sekcji „Process INTERNAL post types”. Wtedy ILM nie będzie ani tworzył linków w treściach tego typu, ani brał ich pod uwagę przy budowaniu indeksu fraz.
- Kiedy używać „Rebuild index now”, a kiedy „Clear data & rebuild index” lub „Purge database (ILM)” w sekcji Maintenance?
- „Rebuild index now” wystarczy po większych zmianach w sieci linków, gdy chcesz ręcznie odświeżyć indeks – choć wtyczka i tak przebudowuje go automatycznie przy zapisie fraz, publikacji, usuwaniu posta czy imporcie ustawień. „Clear data & rebuild index” dodatkowo czyści dane runtime (index i linkmap – licznik wejść), co przydaje się po większych porządkach w treściach lub gdy statystyki źródeł wydają się nieaktualne. „Purge database (ILM)” to opcja „atomowa”: usuwa reguły wewnętrzne zapisane w meta postów, wszystkie reguły zewnętrzne, liczniki i indeks, a następnie buduje pusty indeks. Używaj jej tylko, jeśli chcesz zacząć konfigurację od zera.