Dokumentacja CC Free Shipping
Kompleksowa dokumentacja dla pluginu CC Free Shipping dla WooCommerceSpis treści
1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Konfiguracja podstawowa
5. Ustawienia komunikatów
6. Lokalizacje wyświetlania
7. Stylizacja wyglądu
8. Ustawienia zaawansowane
9. Obsługa wielu walut
10. Rozwiązywanie problemów
11. FAQ
Uzupełnienie dokumentacji CC Free Shipping
12. Korzystanie ze shortcode
13. Integracja z Gutenbergiem
14. Rozwiązywanie problemów ze shortcode
1. Wprowadzenie
CC Free Shipping to profesjonalny plugin dla WooCommerce umożliwiający konfigurację darmowej wysyłki po przekroczeniu określonego progu zamówienia oraz wyświetlanie spersonalizowanych komunikatów zachęcających klientów do zwiększenia wartości koszyka.Plugin pozwala na pełną kontrolę nad:
- progiem darmowej wysyłki
- treścią komunikatów
- miejscami wyświetlania
- stylem wizualnym powiadomień
- zaawansowanymi opcjami obliczania progu
2. Instalacja
Wymagania systemowe- WordPress 5.0 lub nowszy
- WooCommerce 3.0 lub nowszy
- PHP 7.0 lub nowszy
- Pobierz plik ZIP pluginu z oficjalnego sklepu
- Zaloguj się do panelu administracyjnego WordPress
- Przejdź do: Wtyczki > Dodaj nową > Wyślij wtyczkę
- Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
- Po zakończeniu instalacji kliknij „Włącz wtyczkę”
3. Aktywacja licencji
Przed rozpoczęciem korzystania z pluginu konieczna jest aktywacja licencji:Po instalacji przejdź do: COCOS. > Licencja cc_free_shipping
Wprowadź klucz licencyjny otrzymany po zakupie
Kliknij „Aktywuj licencję”
Po pomyślnej aktywacji zobaczysz komunikat potwierdzający
Wskazówka
Bez aktywnej licencji plugin będzie działał w trybie podglądu, bez możliwości edycji ustawień.
4. Konfiguracja podstawowa
Aby skonfigurować podstawowe ustawienia pluginu:- Przejdź do: WooCommerce > Ustawienia > Wysyłka > Darmowa wysyłka
- Ustaw następujące opcje:
Określ minimalną kwotę zamówienia, po przekroczeniu której klient otrzyma darmową wysyłkę. Wartość podawana jest w domyślnej walucie sklepu.
Uwzględnianie kuponów rabatowych
Włącz tę opcję, jeśli chcesz, aby wartość kuponów rabatowych była odejmowana od wartości koszyka przed sprawdzeniem progu darmowej wysyłki.
Uwzględnianie opłat dodatkowych
Włącz, aby opłaty dodatkowe o wartości ujemnej (obniżające wartość koszyka) były uwzględniane przy obliczaniu progu darmowej wysyłki.
Wyłączenie stylów CSS
Zaznacz tę opcję, jeśli chcesz całkowicie wyłączyć domyślne style CSS i używać wyłącznie własnych stylów.
5. Ustawienia komunikatów
W tej sekcji możesz dostosować treść komunikatów wyświetlanych klientom:Komunikat poniżej progu
Tekst wyświetlany, gdy klient nie osiągnął jeszcze progu darmowej wysyłki. Użyj {remaining}, aby wyświetlić brakującą kwotę.
Komunikat powyżej progu
Tekst wyświetlany, gdy klient osiągnął próg darmowej wysyłki.
Komunikat przy kasie (poniżej progu)
Specjalny komunikat wyświetlany na stronie kasy, gdy klient nie osiągnął progu.
Komunikat przy kasie (powyżej progu)
Specjalny komunikat wyświetlany na stronie kasy, gdy klient osiągnął próg.
Tekst przy metodzie wysyłki
Tekst wyświetlany przy metodzie wysyłki, która została objęta darmową dostawą.
6. Lokalizacje wyświetlania
Wybierz, gdzie komunikaty o darmowej wysyłce mają być pokazywane:Koszyk
Wyświetlanie komunikatu na stronie koszyka.
Strona zamówienia
Wyświetlanie komunikatu na stronie zamówienia (checkout).
Przed metodami płatności
Wyświetlanie komunikatu bezpośrednio przed wyborem metod płatności.
7. Stylizacja wyglądu
Pełna kontrola nad wyglądem komunikatów:Kolory tekstu
Oddzielne ustawienia dla komunikatów poniżej i powyżej progu.
Kolory tła
Tło komunikatów dla obu stanów (poniżej/powyżej progu).
Kolory obramowania
Kolor ramki dla obu typów komunikatów.
Rozmiar obramowania
Grubość obramowania w pikselach.
Zaokrąglenie obramowania
Promień zaokrąglenia narożników w pikselach.
Rozmiar czcionki
Rozmiar tekstu w pikselach.
8. Ustawienia zaawansowane
Własny CSSWprowadź własny kod CSS, aby precyzyjnie dostosować wygląd komunikatów do swojego motywu. CSS będzie aktywny nawet jeśli wyłączysz domyślne style pluginu.
Przykładowy kod CSS:
.ccfs-message {
margin: 15px 0;
font-weight: bold;
}
.ccfs-message.below-threshold {
border-style: dashed !important;
}
.ccfs-message.above-threshold {
text-transform: uppercase;
}
9. Obsługa wielu walut
CC Free Shipping obsługuje najpopularniejsze pluginy walutowe:- WOOCS – WooCommerce Currency Switcher
- Aelia Currency Switcher
- WPML + WooCommerce Multilingual
- WooCommerce Multi-Currency
- Currency Switcher for WooCommerce by WP Desk
10. Rozwiązywanie problemów
Komunikaty nie są wyświetlane- Sprawdź, czy WooCommerce jest poprawnie skonfigurowany
- Upewnij się, że licencja jest aktywna
- Sprawdź, czy włączone są odpowiednie lokalizacje wyświetlania
- Zweryfikuj, czy nie ma konfliktów z innymi pluginami
- Sprawdź, czy wartość progu jest poprawnie ustawiona
- Jeśli używasz wielu walut, upewnij się, że kursy wymiany są aktualne
- Sprawdź ustawienia dotyczące uwzględniania kuponów i opłat
- Sprawdź, czy Twój motyw nie nadpisuje stylów pluginu
- Spróbuj dodać własny CSS w sekcji zaawansowanej
- Rozważ wyłączenie domyślnych stylów i zaimplementowanie własnych
11. FAQ
Czy plugin działa z dowolną metodą wysyłki?Tak, CC Free Shipping jest kompatybilny ze wszystkimi metodami wysyłki dostępnymi w WooCommerce.
Czy mogę mieć różne progi dla różnych metod wysyłki?
Nie, plugin obecnie obsługuje jeden globalny próg darmowej wysyłki dla wszystkich metod.
Czy plugin wpływa na wydajność strony?
CC Free Shipping został zaprojektowany z myślą o wydajności i ma minimalny wpływ na szybkość ładowania strony.
Czy komunikaty są responsywne?
Tak, wszystkie komunikaty są w pełni responsywne i dobrze wyglądają na urządzeniach mobilnych.
Czy plugin obsługuje tłumaczenia?
Tak, wszystkie teksty pluginu można tłumaczyć używając standardowych narzędzi WordPress, takich jak Loco Translate czy WPML.
Jak często aktualizowany jest plugin?
Plugin jest regularnie aktualizowany, aby zapewnić kompatybilność z najnowszymi wersjami WordPress i WooCommerce.
Co jeśli potrzebuję wsparcia?
Wsparcie techniczne jest dostępne po zakupie licencji. Skontaktuj się z nami przez stronę wsparcia.
Uzupełnienie dokumentacji CC Free Shipping
12. Korzystanie ze shortcode
CC Free Shipping oferuje wygodny shortcode, który pozwala na umieszczanie komunikatów o darmowej wysyłce w dowolnym miejscu w sklepie, w tym w treści stron, postów oraz w widgetach.Podstawowe użycie shortcode
Podstawowy shortcode wyświetla standardowy komunikat o darmowej wysyłce:
[cc_free_shipping]Dostosowanie typu komunikatu
Shortcode pozwala na określenie typu wyświetlanego komunikatu za pomocą parametru type:
[cc_free_shipping type="checkout"]- cart – standardowy komunikat z koszyka (domyślny) –
- checkout – komunikat wyświetlany na stronie kasy –
- payment – komunikat wyświetlany przed metodami płatności
Przykłady zastosowania:
1. Dodanie komunikatu o darmowej wysyłce na stronie głównej:
[cc_free_shipping] 2. Dodanie komunikatu z kasy w widgecie na pasku bocznym:
[cc_free_shipping type="checkout"]3. Dodanie komunikatu o płatności w treści strony produktu:
[cc_free_shipping type="payment"]Wskazówka
Komunikaty wyświetlane przez shortcode są automatycznie aktualizowane po zmianach w koszyku dzięki AJAX, tak samo jak standardowe komunikaty.
13. Integracja z Gutenbergiem
Ważne
Jeśli korzystasz z edytora Gutenberg, komunikaty o darmowej wysyłce muszą być dodawane za pomocą shortcode, ponieważ dynamiczne hooki WooCommerce nie działają automatycznie w blokach Gutenberga.
- Edytuj stronę lub post w edytorze Gutenberg
- Dodaj blok „Shortcode” (znajdź go w wyszukiwarce bloków lub w sekcji „Widgety”)
- W polu bloku wpisz odpowiedni shortcode: [cc_free_shipping] lub z wybranym typem, np. [cc_free_shipping type=”checkout”]
- Zapisz i opublikuj stronę
Dodawanie w WooCommerce Blocks
Jeśli korzystasz z WooCommerce Blocks (np. Koszyk lub Kasa w formie bloków), możesz dodać komunikat o darmowej wysyłce używając:
- Bloku „HTML niestandardowy” w odpowiednim miejscu w układzie koszyka/kasy
- W polu bloku wpisz shortcode w formacie HTML:
<!-- wp:shortcode -->
[cc_free_shipping]
<!-- /wp:shortcode -->
Porada
Dla najlepszej integracji z blokami WooCommerce, zalecamy umieszczenie shortcode w bloku „HTML niestandardowy” raczej niż w standardowym bloku „Shortcode”.
<!-- wp:woocommerce/cart -->
<div class="wp-block-woocommerce-cart is-loading">
<!-- wp:html -->
[cc_free_shipping]
<!-- /wp:html -->
<!-- wp:woocommerce/cart-items-block -->
...
<!-- /wp:woocommerce/cart-items-block -->
</div>
<!-- /wp:woocommerce/cart -->
14. Rozwiązywanie problemów ze shortcode
Jeśli komunikat wyświetlany przez shortcode nie pojawia się lub nie aktualizuje prawidłowo: - Sprawdź, czy koszyk WooCommerce jest aktywny – shortcode wymaga aktywnego obiektu koszyka.
- Włącz debugowanie JavaScript – sprawdź konsolę przeglądarki pod kątem błędów AJAX.
- Upewnij się, że identyfikator shortcode jest unikalny – unikaj umieszczania wielu shortcodów tego samego typu na jednej stronie.
- Sprawdź, czy nie ma konfliktów z innymi pluginami – niektóre pluginy mogą przechwytywać zdarzenia AJAX.
Informacja
Shortcode działa tylko na stronach front-end. Nie będzie działać w panelu administracyjnym ani w podglądzie edytora Gutenberg.
