Biegun.Studio — Dokumentacja wtyczek v1.0.0
BStudio Plugin

Category H1

Wersja: 1.0.0 Autor: Biegun.Studio Wymaga: WordPress 6.0+, PHP 8.0+, WooCommerce 8.0+

Umożliwia ustawienie własnego nagłówka H1 dla każdej kategorii produktów WooCommerce — oddzielnie od nazwy kategorii używanej w menu, URL i breadcrumbs. Kluczowe narzędzie do optymalizacji SEO.

Co robi ta wtyczka?

W WooCommerce nazwa kategorii spełnia jednocześnie kilka ról: pojawia się w menu nawigacyjnym, w breadcrumbs, w URL (slug) i jako nagłówek H1 na stronie archiwum. Problem polega na tym, że krótka nazwa menu (np. "Wtyczki SEO") rzadko jest optymalnym nagłówkiem SEO.

Bez wtyczki

Nazwa kategorii: "Wtyczki SEO"
H1 na stronie: "Wtyczki SEO"

Z wtyczką

Nazwa kategorii: "Wtyczki SEO"
H1 na stronie: "Najlepsze wtyczki SEO dla WooCommerce — Biegun.Studio"

Menu, URL i breadcrumbs pozostają niezmienione. Tylko nagłówek H1 na stronie archiwum wyświetla rozbudowaną frazę kluczową.

Funkcje

Niestandardowy nagłówek H1

Pole tekstowe w edycji kategorii. Gdy wypełnione — zastępuje standardową nazwę kategorii w tagu H1 na stronie archiwum. Gdy puste — WooCommerce wyświetla oryginalną nazwę (brak ryzyka utraty treści).

Opis SEO pod H1

Opcjonalny akapit wyświetlany bezpośrednio pod nagłówkiem na stronie kategorii. Przydatny do dodania tekstu z frazami kluczowymi bez ingerencji w standardowy opis kategorii WooCommerce (który pojawia się w innym miejscu lub jest używany przez pluginy SEO).

Kolumna w liście kategorii

W tabeli Produkty → Kategorie pojawia się dodatkowa kolumna "Niestandardowy H1", dzięki czemu w jednym miejscu widzisz, które kategorie mają już ustawiony własny nagłówek.

Jak używać

  1. Przejdź do Produkty → Kategorie.
  2. Kliknij Edytuj przy wybranej kategorii.
  3. Przewiń do pola "Nagłówek H1 (BStudio)" i wpisz docelowy tytuł SEO.
  4. Opcjonalnie wypełnij "Opis SEO pod H1" — pojawi się jako akapit pod nagłówkiem.
  5. Kliknij Aktualizuj.
  6. Wejdź na stronę kategorii w przeglądarce i sprawdź nagłówek H1.
Wskazówka SEO: Warto włączyć podgląd w narzędziu jak Google Search Console lub SEO Spider, by sprawdzić czy crawler widzi nowy H1. Zmiany obowiązują od razu po zapisie.

Instalacja

  1. Skopiuj folder bstudio-category-h1 do /wp-content/plugins/.
  2. W panelu WordPress aktywuj BStudio Category H1.
  3. Przejdź do Produkty → Kategorie i zacznij uzupełniać pola.

Usunięcie wtyczki

  1. Dezaktywuj i usuń wtyczkę przez panel Wtyczki.
  2. Pola z niestandardowymi H1 pozostają jako meta dane kategorii w tabeli wp_termmeta (klucze _bstudio_cath1_title i _bstudio_cath1_desc). Bez wtyczki są ignorowane — H1 wraca do domyślnej nazwy kategorii.
  3. Aby całkowicie wyczyścić bazę, usuń te wpisy przez phpMyAdmin lub narzędzie do zarządzania bazą.

Jak to działa technicznie

Filtr WordPressCo robi
woocommerce_page_titleZmienia tytuł używany przez WooCommerce na stronach archiwum
get_the_archive_titleZmienia tytuł archiwum dla natywnych szablonów WP
woocommerce_product_archive_descriptionPodmienia opis pod nagłówkiem kategorii

Filtry działają tylko gdy is_product_category() zwraca true — nie wpływają na inne strony.

Struktura plików

bstudio-category-h1/
├── bstudio-category-h1.php ← Główny plik
├── includes/
│ └── class-bstudio-cath1-core.php ← Filtry frontendowe (H1 + opis)
├── admin/
│ └── class-bstudio-cath1-admin.php ← Pola w edycji kategorii + kolumna w tabeli
└── docs/

Wsparcie i zgłoszenia

Masz pytanie, napotkałeś problem albo chcesz rozwinąć to rozwiązanie pod swój sklep? Pomożemy.

Pomoc techniczna

Problemy z instalacją, konfiguracją lub działaniem wtyczki — opisz zgłoszenie, a wrócimy z rozwiązaniem.

Zgłoszenie (ticket)

Wyślij e-mail na shop@biegun.studio. W temacie podaj nazwę wtyczki i krótki opis. Dołącz wersje WordPressa, WooCommerce i PHP oraz kroki odtworzenia problemu.

Rozwój i modyfikacje

Potrzebujesz dodatkowej funkcji albo integracji? Realizujemy rozszerzenia i wdrożenia na zamówienie — napisz na shop@biegun.studio.

Pełna oferta wtyczek: biegun.studio/sklep