Konfiguracja
Anonco konfigurujesz na jednym ekranie: WooCommerce > Pasek ogłoszeń. Podgląd na żywo pokazuje pasek w trakcie edycji. Wszystkie wartości trafiają do jednej opcji w formie tablicy, notice_settings. Wartości domyślne pochodzą z pliku config/defaults.php w paczce wtyczki i uzupełniają to, co zapiszesz, więc brakujący klucz zawsze ma bezpieczną wartość.
Do zapisu wystarczy uprawnienie manage_woocommerce, więc pasek mogą edytować także kierownicy sklepu, nie tylko administratorzy. Przy zapisie kolory przechodzą przez sanitize_hex_color, komunikat przez wp_kses, pola tekstowe przez sanitize_text_field, a adres URL przez esc_url_raw.
Komunikat
Dział zatytułowany „Komunikat”Włącz pasek
Dział zatytułowany „Włącz pasek”enabled (wartość logiczna, domyślnie wyłączona). Główny przełącznik. Gdy jest wyłączony, na froncie sklepu nic się nie wyświetla i nie ładuje się żaden plik CSS ani JavaScript. Pasek nie pojawi się też wtedy, gdy jest włączony, ale komunikat jest pusty.
Treść ogłoszenia
Dział zatytułowany „Treść ogłoszenia”message (tekst, domyślnie pusty). Tekst, który widzą klienci. Przy zapisie i przy wyświetlaniu obowiązuje ta sama krótka lista dozwolonego HTML: <strong>, <b>, <em>, <i>, <br>, <span> oraz <a> (z atrybutami href, title, target, rel). Wszystko spoza listy jest usuwane, więc komunikat zawsze można bezpiecznie wyświetlić u góry każdej strony.
Wezwanie do działania
Dział zatytułowany „Wezwanie do działania”Opcjonalny przycisk za komunikatem. Wyświetla się tylko wtedy, gdy ustawisz jednocześnie etykietę i adres URL. Jedno pole bez drugiego jest ignorowane.
link_label(tekst), napis na przycisku, np. Kup w promocji. Puste pole oznacza brak przycisku.link_url(tekst), adres docelowy, zapisywany przezesc_url_raw. Podaj pełny adres razem zhttps://.link_new_tab(wartość logiczna), otwieranie w nowej karcie. Gdy jest włączone, link automatycznie dostajetarget="_blank"irel="noopener noreferrer".
Bez etykiety i adresu dostajesz pasek z samym komunikatem.
Trzy kolory w zapisie szesnastkowym. Każdy przechodzi przez sanitize_hex_color, a gdy jest pusty albo niepoprawny, wraca do wartości domyślnej:
bg_color, tło paska, domyślnie#1e1e1e.text_color, tekst komunikatu, domyślnie#ffffff.link_color, kolor akcentu, domyślnie#ffd166. Używają go linki w komunikacie i wypełnienie przycisku CTA.
Kolory trafiają do elementu paska jako zmienne CSS ustawione bezpośrednio na elemencie: --notice-bg, --notice-fg i --notice-link, więc nadpiszesz je w arkuszu stylów motywu bez walki ze specyficznością selektorów. Ze zmiennej --notice-link pochodzi też kolor sygnałowej kropki “na antenie”.
Domyślna paleta (prawie czarny pasek, biały tekst, bursztynowy akcent) jest czytelna na każdym motywie.
Umiejscowienie
Dział zatytułowany „Umiejscowienie”Pasek jest zawsze przyklejony (position: sticky) i zostaje przypięty u góry okna, gdy klient przewija stronę. Nie ma ustawienia umiejscowienia ani wariantu statycznego.
Harmonogram
Dział zatytułowany „Harmonogram”Darmowa edycja nie ma harmonogramu. Pasek włączasz i wyłączasz ręcznie, a warunek czasowy dopiszesz w kodzie filtrem notice/bar_active. Okna start/koniec ustawiane z panelu dodaje Anonco PRO.
Zamykanie
Dział zatytułowany „Zamykanie”dismissible(wartość logiczna, domyślnie włączona). Dodaje przycisk zamknięcia. Wybór klienta jest zapisywany w jego przeglądarce przezlocalStorage, bez ciasteczek i bez danych osobowych. Gdy opcja jest wyłączona, pasek nie ma przycisku zamknięcia, a skrypt zamykania w ogóle się nie ładuje.dismiss_days(liczba całkowita, domyślnie7, nie mniej niż0). Pole Pamiętaj przez (dni): ile dni zamknięcie obowiązuje, zanim pasek może wrócić.0oznacza zapamiętanie na zawsze.
Automatyczne ponowne pokazanie po zmianie komunikatu
Dział zatytułowany „Automatyczne ponowne pokazanie po zmianie komunikatu”Klucz w localStorage zawiera pierwsze osiem znaków skrótu MD5 tekstu komunikatu (notice_dismissed_{id-paska}_{skrót}). Zmiana komunikatu zmienia klucz, więc zapamiętane zamknięcie przestaje pasować i nowe ogłoszenie widzą wszyscy, bez ręcznego resetu.
Kiedy pasek jest aktywny
Dział zatytułowany „Kiedy pasek jest aktywny”SettingsRepository::isActive() zwraca true, gdy co najmniej jeden pasek jest włączony, ma niepusty komunikat (po usunięciu znaczników i białych znaków) i przechodzi przez filtr notice/bar_active. Renderer i ładowanie zasobów korzystają z tego sprawdzenia. Podgląd w panelu pokazuje wygląd paska niezależnie od przełącznika włączenia. Gdy pasek nie jest aktywny, front-end niczego nie ładuje.
Jak wyświetla się pasek
Dział zatytułowany „Jak wyświetla się pasek”Pasek pojawia się na samej górze każdej strony front-endu przez hak motywu wp_body_open (priorytet 5), który obsługuje większość nowoczesnych motywów. CSS ładuje się tylko wtedy, gdy pasek jest aktywny, a skrypt zamykania dodatkowo tylko wtedy, gdy pasek można zamknąć. Wyłączony pasek nie dokłada więc nic do strony, a znaczniki to zwykły HTML bez frameworka JavaScript.
Przechowywanie danych i usuwanie
Dział zatytułowany „Przechowywanie danych i usuwanie”Wszystkie ustawienia są w notice_settings. Nic nie opuszcza Twojej bazy danych, Anonco nie wysyła żadnych zapytań na zewnątrz. Usunięcie wtyczki z ekranu Wtyczki uruchamia uninstall.php, który kasuje opcje notice_settings i notice_db_version. Wtyczka nie zapisuje danych wpisów ani danych klientów. Poza opcjami zapisuje tylko meta użytkownika notice_pro_banner_dismissed, gdy administrator zamknie baner PRO na ekranie ustawień. To pojedyncza flaga na administratora, bez informacji o treściach sklepu czy klientach, i uninstall.php też ją usuwa. W sieci multisite procedura usuwania kasuje opcje na każdej witrynie.
Wygląd i dostępność
Dział zatytułowany „Wygląd i dostępność”CSS paska opiera się na zmiennych --notice-*. Ma widoczne obramowanie fokusu, małą pulsującą kropkę “na antenie”, jednorazowy błysk światła przy pierwszym pokazaniu i animację zwijania po zamknięciu. Przy ustawieniu prefers-reduced-motion wszystkie animacje są wyłączone, a pasek po prostu się pokazuje i znika. Pasek to region ARIA z przyciskiem zamknięcia obsługiwanym z klawiatury. Nic z tego nie wymaga konfiguracji. Zachowanie na froncie sklepu i filtry dla programistów opisuje strona Korzystanie z paska ogłoszeń.