Przejdź do głównej zawartości

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.

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.

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.

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 przez esc_url_raw. Podaj pełny adres razem z https://.
  • link_new_tab (wartość logiczna), otwieranie w nowej karcie. Gdy jest włączone, link automatycznie dostaje target="_blank" i rel="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.

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.

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.

  • dismissible (wartość logiczna, domyślnie włączona). Dodaje przycisk zamknięcia. Wybór klienta jest zapisywany w jego przeglądarce przez localStorage, 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ślnie 7, nie mniej niż 0). Pole Pamiętaj przez (dni): ile dni zamknięcie obowiązuje, zanim pasek może wrócić. 0 oznacza zapamiętanie na zawsze.

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.

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.

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.

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.

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ń.