Przejdź do głównej zawartości

Korzystanie z paska ogłoszeń

Ta strona opisuje codzienne zadania: komunikat o promocji, przycisk CTA i zamykanie paska, a potem zachowanie paska na froncie sklepu i filtry dla programistów, gdy jeden pasek to za mało.

Otwórz WooCommerce > Pasek ogłoszeń i wpisz tekst. Możesz użyć dozwolonego HTML, na przykład pogrubić ofertę i dodać link do szczegółów:

<strong>Darmowa wysyłka powyżej 200 zł</strong>, zobacz <a href="/wysylka">szczegóły</a>.

Dozwolone znaczniki to <strong>, <b>, <em>, <i>, <br>, <span> i <a> (z atrybutami href, title, target, rel). Resztę wtyczka usuwa przy zapisie. W miarę możliwości trzymaj się jednej linii, pasek to baner, nie akapit.

Wpisz etykietę przycisku oraz adres URL przycisku i zdecyduj, czy link ma się otwierać w nowej karcie. Przycisk pojawia się tylko wtedy, gdy wypełnisz oba pola. Linki otwierane w nowej karcie automatycznie dostają rel="noopener noreferrer". Przycisk ma wypełnienie w kolorze akcentu, więc przy głównym działaniu, jak Kup w promocji, wyróżnia się bardziej niż link w treści.

Ustaw kolory tła, tekstu i akcentu w podglądzie na żywo. Domyślne kolory są czytelne na każdym motywie, zmień je, jeśli chcesz dopasować pasek do marki. Kolor akcentu steruje też linkami w komunikacie i małą kropką sygnałową. Pasek jest zawsze przyklejony u góry okna, wyboru umiejscowienia nie ma.

Darmowa edycja nie ma harmonogramu w panelu: pasek włączasz i wyłączasz ręcznie. Warunek czasowy dopiszesz w kodzie filtrem notice/bar_active (przykład niżej), na przykład tak, żeby baner Black Friday sam zgasł po weekendzie. Daty startu i końca ustawiane w panelu dodaje Anonco PRO.

Zostaw włączoną opcję Możliwość zamknięcia (domyślnie jest włączona), żeby klienci mogli zamknąć pasek, i ustaw w polu Pamiętaj przez (dni), ile dni obowiązuje zamknięcie (0 = na zawsze). Wybór jest zapisywany w przeglądarce odwiedzającego przez localStorage, bez ciasteczek i bez danych osobowych.

Nic się nie wyświetla, dopóki nie zaznaczysz Wyświetlaj pasek ogłoszeń w sklepie w polu Włącz pasek i nie zapiszesz zmian. Potem otwórz dowolną stronę sklepu i sprawdź, czy pasek jest na samej górze.

Gdy zmienisz tekst komunikatu, Anonco pokazuje pasek ponownie wszystkim, także klientom, którzy zamknęli poprzedni. Zamknięcie jest zapamiętywane pod kluczem zawierającym skrót komunikatu, więc nowy komunikat nie pasuje do starego klucza i pasek wraca bez ręcznego resetu.

  • Pasek jest wyświetlany w haku wp_body_open i przyklejony (position: sticky) do góry okna.
  • Pasek, który można zamknąć, trafia na stronę z atrybutem hidden. Skrypt odsłania go dopiero po sprawdzeniu, czy odwiedzający już go nie zamknął, więc pasek, który powinien być ukryty, nie mignie na ekranie.
  • Przycisk zamknięcia przenosi fokus na <body>, więc użytkownik klawiatury nie zostaje na kontrolce, która właśnie zniknęła. Potem pasek zwija swoją wysokość i znika z DOM.
  • Gdy localStorage jest niedostępny (tryb prywatny, brak miejsca), pasek po prostu zostaje widoczny, a przycisk zamknięcia ukrywa go tylko na czas oglądania bieżącej strony.
  • Przy ustawieniu prefers-reduced-motion pulsująca kropka, błysk przy pierwszym pokazaniu i animacja zwijania są wyłączone, a pasek po prostu się pokazuje i znika.

Pasek ma role="region" z etykietą aria-label Ogłoszenie witryny. Przycisk zamknięcia ma etykietę Zamknij ogłoszenie, widoczne obramowanie fokusu i w pełni działa z klawiatury.

Anonco nie ma shortcode’u ani bloku. Pasek jest umieszczany automatycznie u góry strony przez wp_body_open, w treści nie trzeba niczego osadzać.

CSS ładuje się tylko wtedy, gdy pasek jest aktywny, a skrypt zamykania dodatkowo tylko wtedy, gdy pasek można zamknąć. Wyłączony pasek nie dodaje nic do strony. Znaczniki to zwykły HTML bez frameworka front-endowego, a układ strony przesuwa się tylko o wysokość samego paska.

Anonco wyświetla to, co zwróci filtr notice/bars. Domyślnie jest to jeden pasek o identyfikatorze default z Twoimi zapisanymi ustawieniami. Kolejny pasek dodasz, dopisując go do listy. Każdy potrzebuje unikalnego id i tablicy settings z tymi samymi kluczami co notice_settings:

add_filter( 'notice/bars', function ( array $bars ): array {
$bars[] = [
'id' => 'sale-2026',
'settings' => [
'enabled' => true,
'message' => 'Wiosenna wyprzedaż, <strong>20% taniej</strong> na wszystko.',
'link_label' => 'Kup teraz',
'link_url' => home_url( '/sale/' ),
'link_new_tab' => false,
'bg_color' => '#0b3d2e',
'text_color' => '#ffffff',
'link_color' => '#ffd166',
'dismissible' => true,
'dismiss_days' => 3,
],
];
return $bars;
} );

Każdy pasek nadal przechodzi sprawdzenie aktywności (włączony i z niepustym komunikatem), dostaje własny klucz zamknięcia zbudowany z id i komunikatu i jest wyświetlany w kolejności z listy. Kolejne paski układają się jeden nad drugim.

notice/bar_active decyduje, czy dany pasek wyświetli się przy bieżącym żądaniu. Działa po podstawowym sprawdzeniu, czy pasek jest włączony i ma komunikat. Filtr dostaje wartość logiczną, ustawienia paska i jego identyfikator. Użyj go, żeby ograniczyć pasek do wybranych stron, ról albo grup klientów:

add_filter( 'notice/bar_active', function ( bool $active, array $settings, string $bar_id ): bool {
// Ukryj pasek wyprzedaży przed zalogowanymi klientami hurtowymi.
if ( 'sale-2026' === $bar_id && current_user_can( 'wholesale' ) ) {
return false;
}
return $active;
}, 10, 3 );

Po wyświetleniu każdego paska wtyczka wywołuje akcję notice/bar_rendered z identyfikatorem paska i jego ustawieniami, więc dodatek może na przykład zliczać wyświetlenia bez zmiany szablonu.

notice_sanitize_settings działa na oczyszczonej tablicy ustawień tuż przed zapisem, więc możesz wymusić albo znormalizować wartości:

add_filter( 'notice_sanitize_settings', function ( array $clean, array $raw ): array {
// Wymuś tło w kolorze marki niezależnie od przesłanej wartości.
$clean['bg_color'] = '#0b3d2e';
return $clean;
}, 10, 2 );