Biegun.Studio — Dokumentacja wtyczek v1.0.0
BStudio Plugin

Social Share

Wersja: 1.0.0 Autor: Biegun.Studio Wymaga: WordPress 6.0+, PHP 8.0+, WooCommerce 8.0+

Przyciski udostępnienia produktu w mediach społecznościowych — Facebook, X (Twitter), LinkedIn i kopiowanie linku. Konfigurowalne z poziomu panelu, bez obciążania strony zewnętrznymi SDK.

Co robi ta wtyczka?

Wtyczka dodaje na stronie produktu WooCommerce zestaw przycisków share. Kliknięcie otwiera dialog udostępnienia wybranej sieci w nowym oknie — użytkownik nie opuszcza sklepu. Przycisk "Kopiuj link" korzysta z nowoczesnego Clipboard API (z fallbackiem dla starszych przeglądarek).

Podgląd przycisków

Facebook X (Twitter) LinkedIn Kopiuj link

Funkcje

4 sieci do wyboru

SiećOpis zachowania
FacebookOtwiera sharer.php z URL produktu w nowym oknie
X (Twitter)Otwiera intent/tweet z URL i tytułem produktu
LinkedInOtwiera share-offsite z URL produktu
Kopiuj linkKopiuje URL do schowka (Clipboard API). Przycisk zmienia kolor i tekst na "Skopiowano!" przez 2 sekundy

Konfigurowalny panel

W Ustawienia → BS Social Share możesz:

Pozycja na stronie produktu

Przyciski renderowane są przez hook woocommerce_single_product_summary z priorytetem 50 — na końcu sekcji summary, po przycisku "Dodaj do koszyka". Nie kolidują z żadnym standardowym elementem WooCommerce.

Responsywność

Na ekranach mniejszych niż 480px ukrywane są etykiety tekstowe przycisków — widoczne są tylko ikony SVG. Przyciski zachowują wygodny obszar dotykowy.

Brak zewnętrznych SDK

Wtyczka nie ładuje żadnych zewnętrznych bibliotek JavaScript (Facebook SDK, Twitter Widget.js itp.). Używa wyłącznie natywnych URL-i do dialogów udostępnienia — szybciej, bezpieczniej, bez wpływu na GDPR.

Konfiguracja

  1. Przejdź do Ustawienia → BS Social Share.
  2. Zaznacz sieci, które mają być widoczne.
  3. Ustaw treść etykiety (lub odznacz "Pokaż etykietę").
  4. Kliknij Zapisz zmiany.

Instalacja

  1. Skopiuj folder bstudio-social-share do /wp-content/plugins/.
  2. Aktywuj wtyczkę w panelu Wtyczki.
  3. Przyciski są widoczne natychmiast na wszystkich stronach produktów z domyślną konfiguracją (wszystkie 4 sieci).

Usunięcie wtyczki

  1. Dezaktywuj i usuń wtyczkę przez panel Wtyczki.
  2. Ustawienia (opcja bstudio_share_settings) pozostają w tabeli wp_options i można je usunąć ręcznie przez phpMyAdmin.

Struktura plików

bstudio-social-share/
├── bstudio-social-share.php ← Główny plik, deklaracja HPOS
├── includes/
│ └── class-bstudio-share-core.php ← Enqueue + render przycisków na stronie produktu
├── admin/
│ └── class-bstudio-share-admin.php ← Panel Ustawienia → BS Social Share
├── public/assets/
│ ├── css/social-share.css ← Style przycisków (kolory sieci, responsywność)
│ └── js/social-share.js ← Logika "Kopiuj link" z Clipboard API
└── docs/

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