Przejdź do głównej zawartości

Korzystanie z odliczania

Ten przewodnik pokazuje dwa źródła dat dla odliczania i to, co faktycznie widzą klienci oraz użytkownicy czytników ekranu.

Jeśli już prowadzisz promocje w WooCommerce, pracy prawie nie ma:

  1. W WooCommerce > Klepsidro zostaw Źródło odliczania na Data zakończenia promocji WooCommerce (domyślnie).
  2. Na produkcie ustaw Dane produktu > Ogólne > Daty ceny promocyjnej > Do na przyszłą datę.

Produkt musi być w promocji i mieć datę Do. Odliczanie na żywo pojawia się wtedy samo i biegnie do końca promocji. Każdy produkt z końcem promocji dostaje własny licznik, bez ustawiania Klepsidro na każdym produkcie.

Gdy cały sklep ma jeden termin (koniec Black Friday, flash sale):

  1. Ustaw Źródło odliczania na Stała data zakończenia kampanii.
  2. Wpisz Datę zakończenia kampanii w ustawieniach Klepsidro (w strefie czasowej witryny).

Każdy produkt odlicza wtedy do tego jednego momentu, bez względu na własne daty promocji.

Zostaw źródło na Data zakończenia promocji WooCommerce i ustaw datę kampanii. Produkt z własną datą końca promocji odlicza do niej, a produkty bez niego odliczają do daty kampanii. Termin dla całego sklepu obejmuje więc większość oferty, a wybrane produkty mają własne zegary. (Źródło Stała data zakończenia kampanii całkowicie pomija daty promocji produktów.)

  • Wybierz umiejscowienie. Najmocniej działa przy formularzu dodawania do koszyka, a domyślne jest podsumowanie produktu.
  • Wybierz format: dhms dla długich okien, compact, żeby przy kampaniach na kilka dni nie tykały sekundy.
  • Dodaj nagłówek (na przykład Pospiesz się, oferta wkrótce się kończy!) i komunikat po wygaśnięciu.
  • Produkt, dla którego da się wyliczyć czas zakończenia, pokazuje licznik z napisem Promocja kończy się za, który zmienia się co sekundę.
  • Sekundy mają formę tarczy stopera: pierścień opróżnia się w ciągu minuty, a cyfra przeskakuje z każdym tyknięciem, więc upływ czasu widać nawet bez dźwięku.
  • Gdy odliczanie dojdzie do zera, zegar znika, a pojawia się Twój komunikat po wygaśnięciu. Nigdy nie zostaje zamrożone 00:00:00.
  • Produkt bez czasu zakończenia (bez końca promocji i bez daty kampanii) nie pokazuje nic.

Wygaśnięcie może nastąpić na dwa sposoby. Jeśli czas zakończenia minął przed załadowaniem strony, serwer od razu renderuje komunikat. Jeśli strona jest otwarta, gdy zegar przekroczy zero, skrypt ukrywa zegar, pokazuje komunikat i raz ogłasza go przez region na żywo, bez przeładowania.

Własne lub zaplanowane czasy zakończenia (dla deweloperów)

Dział zatytułowany „Własne lub zaplanowane czasy zakończenia (dla deweloperów)”

Koniec odliczania można zmienić filtrem. ticker/end_timestamp zwraca dla produktu znacznik Unix UTC jako liczbę całkowitą. Inna wartość, także null, zostawia czas wyliczony przez wtyczkę:

add_filter( 'ticker/end_timestamp', function ( $ts, $product, $settings ) {
// Licznik produktów z jednej kategorii do stałego terminu.
if ( has_term( 'flash-sale', 'product_cat', $product->get_id() ) ) {
return strtotime( '2026-11-29 23:59:00' );
}
return $ts;
}, 10, 3 );

To ten sam punkt rozszerzeń, z którego Klepsidro Pro korzysta przy datach zakończenia dla poszczególnych produktów i zaplanowanych oknach kampanii. Żeby ukryć licznik na wybranym produkcie, zwróć false z filtra ticker/active.

Licznik jest objęty elementem role="group" z etykietą Odliczanie do końca promocji. Widoczny zegar ma role="timer", ale jest ukryty przed technologiami asystującymi (aria-hidden), bo ogłaszanie zmian co sekundę zalałoby czytnik ekranu. Zamiast tego osobny region na żywo (role="status", aria-live="polite") odzywa się tylko co pełną minutę i przy wygaśnięciu, składając zdanie (na przykład Wyprzedaż kończy się za 2 godz. 5 min) z przetłumaczonych już nazw jednostek.

Serwer renderuje znaczniki z polami cyfr o ustalonym rozmiarze, więc liczby trafiają w zarezerwowane miejsce i nie ma przesunięć układu (CLS). Jedyny skrypt to pojedynczy plik bez zależności, ładowany w stopce z defer. Obsługuje wszystkie liczniki na stronie jednym wspólnym interwałem i wyłącza go, gdy wszystkie wygasną. Animacja tarczy sekund respektuje prefers-reduced-motion. Opróżniający się pierścień zostaje, bo niesie informację, a nie jest ozdobą.

Przy przedsprzedaży Rezervo z przyszłą datą premiery klient widzi “Releases in” i czas do dnia premiery, a nie odliczanie promocji. Produkt zmienny odlicza do najwcześniejszej przyszłej premiery wśród wariantów w przedsprzedaży, a wariant bez własnej daty bierze datę produktu nadrzędnego. Po dojściu do zera licznik pokazuje “The release date has arrived.”.