BStudio Back to Top — Dokumentacja

Co robi ta wtyczka?

Wtyczka dodaje do każdej strony publicznej witryny okrągły przycisk ze strzałką. Przycisk jest niewidoczny na początku, a pojawia się (z animacją) gdy użytkownik przewinie stronę o ustawiony dystans. Kliknięcie płynnie przewija widok na samą górę strony.

Dlaczego warto? Długie strony produktów, artykuły blogowe czy strony z wieloma sekcjami — bez przycisku użytkownik musi ręcznie przewinąć do góry. Ten prosty element wyraźnie poprawia wygodę nawigacji.

Funkcje

Konfigurowalny wygląd

Wszystkie parametry wizualne ustawiasz w Ustawienia → BS Back to Top. Zmiany działają natychmiastowo — bez edycji kodu.

Parametr	Opis	Domyślna wartość
Kolor tła	Kolor wypełnienia przycisku	`#e63329` (czerwony Biegun)
Kolor ikony	Kolor strzałki SVG	`#ffffff`
Rozmiar	Szerokość i wysokość przycisku w px	`48`
Pozycja	`left` lub `right` — która strona ekranu	`right`
Offset przewijania	Ile px trzeba przewinąć, by przycisk się pojawił	`300`
Odległość od dołu	Margines od dolnej krawędzi okna (px)	`32`
Odległość od boku	Margines od lewej lub prawej krawędzi okna (px)	`24`

Animacja i dostępność

Przycisk pojawia się i znika z animacją fade + przesunięcie (CSS transition).
Posiada atrybut aria-label="Powrót na górę" dla czytników ekranowych.
Obsługuje :focus-visible — widoczny kontur przy nawigacji klawiaturą.
Scroll do góry używa window.scrollTo({ behavior: 'smooth' }).

Style przez CSS Custom Properties

Wygląd przycisku sterowany jest przez zmienne CSS (--btt-bg, --btt-size itd.) wstrzykiwane przez PHP na podstawie zapisanych ustawień. Nie powoduje konfliktów ze stylami motywu.

Instalacja

Skopiuj folder bstudio-back-to-top do /wp-content/plugins/ na serwerze.
W panelu WordPress przejdź do Wtyczki → Zainstalowane wtyczki.
Znajdź BStudio Back to Top i kliknij Aktywuj.
Przejdź do Ustawienia → BS Back to Top i dostosuj wygląd do swojej strony.

Usunięcie wtyczki

W panelu WordPress przejdź do Wtyczki → Zainstalowane wtyczki.
Kliknij Dezaktywuj przy BStudio Back to Top — przycisk natychmiast znika ze strony.
Kliknij Usuń, aby usunąć pliki wtyczki z serwera.

Uwaga: Ustawienia wtyczki są przechowywane w bazie danych jako opcja bstudio_btt_settings w tabeli wp_options. Usunięcie wtyczki przez panel WordPress nie usuwa tych danych. Aby usunąć ustawienia, przed deaktywacją możesz ręcznie usunąć ten rekord przez phpMyAdmin lub wtyczkę do zarządzania bazą danych.

Jak to działa — szczegóły techniczne

HTML przycisku

Przycisk renderowany jest przez PHP w hooku wp_footer — pojawia się na samym dole strony, tuż przed </body>, poza przepływem treści.

Logika JS

Skrypt nasłuchuje zdarzenia scroll (z opcją passive: true dla wydajności). Gdy window.scrollY przekroczy ustawiony offset, dodawana jest klasa is-visible, która przez CSS ujawnia przycisk. Kliknięcie wyzwala window.scrollTo({ top: 0, behavior: 'smooth' }).

Struktura plików

bstudio-back-to-top/
├── bstudio-back-to-top.php ← Główny plik wtyczki, autoloader, inicjalizacja
├── includes/
│ └── class-bstudio-btt-core.php ← Enqueue CSS/JS, renderowanie przycisku przez wp_footer
├── admin/
│ └── class-bstudio-btt-admin.php ← Panel Ustawienia → BS Back to Top
├── public/assets/
│ ├── css/back-to-top.css ← Style z CSS custom properties
│ └── js/back-to-top.js ← Logika scroll + smooth scroll to top
└── docs/

Wsparcie i zakup: W razie pytań napisz na shop@biegun.studio lub odwiedź sklep pod adresem biegun.studio/sklep.

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