Zaawansowane rabaty WooCommerce

Dokumentacja CC Discounts

Kompleksowa dokumentacja dla wtyczki cc_discounts

Spis treści
1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Konfiguracja podstawowa
5. Grupy rabatowe
6. Zarządzanie klientami
7. Zarządzanie produktami
8. Zarządzanie kategoriami i markami
9. Harmonogramowanie rabatów
10. Ustawienia zaawansowane
11. Logi rabatów
12. Rozwiązywanie problemów
13. FAQ
14. Uzupełnienie dokumentacji

1. Wprowadzenie

CC Discounts to profesjonalna wtyczka dla WooCommerce umożliwiająca zarządzanie rabatami w sklepie internetowym. Pozwala na tworzenie elastycznych grup rabatowych, które można przypisać do określonych klientów, produktów, kategorii lub marek, z możliwością harmonogramowania okresów obowiązywania rabatów.

Wtyczka pozwala na pełną kontrolę nad:

• tworzeniem grup rabatowych dla różnych scenariuszy
• przypisywaniem rabatów do konkretnych klientów
• definiowaniem produktów objętych rabatem
• filtrowaniem rabatów według kategorii i marek
• ustawianiem okresów obowiązywania rabatów
• monitorowaniem historii zastosowanych rabatów

2. Instalacja

Wymagania systemowe

• WordPress 5.0 lub nowszy
• WooCommerce 3.0 lub nowszy
• PHP 7.0 lub nowszy

Proces instalacji

1. Pobierz plik ZIP wtyczki z oficjalnego sklepu
2. Zaloguj się do panelu administracyjnego WordPress
3. Przejdź do: Wtyczki > Dodaj nową > Wyślij wtyczkę
4. Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
5. Po zakończeniu instalacji kliknij „Włącz wtyczkę”

3. Aktywacja licencji

Przed rozpoczęciem korzystania z wtyczki konieczna jest aktywacja licencji:

Po instalacji przejdź do: COCOS. > Licencja cc_discounts
Wprowadź klucz licencyjny otrzymany po zakupie
Kliknij „Aktywuj licencję”
Po pomyślnej aktywacji zobaczysz komunikat potwierdzający

4. Konfiguracja podstawowa

Aby skonfigurować podstawowe ustawienia wtyczki:

1. Przejdź do: Rabaty > Ustawienia
2. Skonfiguruj następujące opcje:

Automatyczne naliczanie rabatów
Włącz tę opcję, aby rabaty były naliczane automatycznie dla kwalifikujących się produktów znajdujących się w koszyku. Jeśli wyłączysz tę opcję, rabaty nie będą naliczane nawet dla kwalifikujących się produktów.

Ukryj oryginalną cenę
Włącz tę opcję, aby ukryć oryginalną cenę w karcie produktu, pokazując tylko cenę po rabacie. Jest to przydatne, gdy nie chcesz, aby klienci widzieli, że produkt jest przeceniony.

5. Grupy rabatowe

Grupy rabatowe to główny element wtyczki, który pozwala na organizację i zarządzanie rabatami.

Aby utworzyć nową grupę rabatową:

1. Przejdź do: Rabaty > Dodaj nowy rabat
2. Wprowadź nazwę grupy rabatowej
3. Wypełnij wszystkie meta boxy opisane w kolejnych sekcjach
4. Kliknij „Opublikuj”, aby aktywować grupę rabatową

Każda grupa rabatowa zawiera następujące elementy:

• Szczegóły rabatu (typ i wartość)
• Lista klientów, którzy mogą korzystać z rabatu
• Lista produktów objętych rabatem
• Lista kategorii produktów objętych rabatem
• Lista marek objętych rabatem
• Harmonogram obowiązywania rabatu

6. Zarządzanie klientami

W meta boxie „Klienci” możesz wybrać, którzy klienci będą mieli dostęp do rabatu:

1. Użyj pola wyszukiwania, aby znaleźć klientów (minimum 3 znaki)
2. Kliknij przycisk „Szukaj”, aby wyświetlić wyniki
3. Wybierz klientów z wyników wyszukiwania, klikając w przycisk „Dodaj”
4. Wybrani klienci pojawią się na liście „Wybrani klienci”
5. Aby usunąć klienta z listy, kliknij przycisk „×” obok jego nazwy

7. Zarządzanie produktami

W meta boxie „Produkty” możesz wybrać, które produkty będą objęte rabatem:

1. Użyj pola wyszukiwania, aby znaleźć produkty (minimum 3 znaki)
2. Kliknij przycisk „Szukaj”, aby wyświetlić wyniki
3. Wybierz produkty z wyników wyszukiwania, klikając w przycisk „Dodaj”
4. Wybrane produkty pojawią się na liście „Wybrane produkty”
5. Aby usunąć produkt z listy, kliknij przycisk „×” obok jego nazwy

8. Zarządzanie kategoriami i markami

W meta boxach „Kategorie” i „Marki” możesz wybrać, które kategorie i marki produktów będą objęte rabatem:

Kategorie

1. Zaznacz kategorie na liście, klikając odpowiednie pola wyboru
2. Wszystkie produkty należące do wybranych kategorii będą objęte rabatem

Marki

1. Zaznacz marki na liście, klikając odpowiednie pola wyboru
2. Wszystkie produkty należące do wybranych marek będą objęte rabatem

9. Harmonogramowanie rabatów

W meta boxie „Harmonogram” możesz ustawić okres obowiązywania rabatu:

1. Ustaw datę początkową w polu „Data początkowa”
2. Ustaw godzinę początkową w polu „Godzina początkowa”
3. Ustaw datę końcową w polu „Data końcowa”
4. Ustaw godzinę końcową w polu „Godzina końcowa”

Rabat będzie aktywny tylko w określonym okresie. Po upływie daty końcowej rabat automatycznie przestanie być naliczany.

10. Ustawienia zaawansowane

Aby skonfigurować zaawansowane ustawienia wtyczki:

1. Przejdź do: Rabaty > Ustawienia
2. Przejdź do zakładki „Wyświetlanie”, „Wartości domyślne” lub „Zaawansowane”

Wyświetlanie

• Pokaż odznakę rabatu – Włącz tę opcję, aby wyświetlać odznakę na produktach objętych rabatem
• Tekst odznaki – Wprowadź tekst, który będzie wyświetlany na odznace (domyślnie „Rabat!”)
• Kolor odznaki – Wybierz kolor tła odznaki za pomocą selektora kolorów
• Pozycja odznaki – Wybierz pozycję odznaki na obrazku produktu (prawy górny róg, lewy górny róg, prawy dolny róg, lewy dolny róg)

Wartości domyślne

• Domyślny typ rabatu – Wybierz, czy nowe grupy rabatowe mają mieć domyślnie rabat procentowy czy wartościowy
• Domyślna wartość rabatu – Ustaw domyślną wartość rabatu dla nowych grup rabatowych

Zaawansowane

• Włącz logowanie – Włącz tę opcję, aby zapisywać logi zastosowanych rabatów
• Okres przechowywania logów (dni) – Ustaw liczbę dni, przez które logi będą przechowywane
• Tryb debugowania – Włącz tę opcję, aby aktywować dodatkowe informacje pomocne w rozwiązywaniu problemów

Narzędzia

• Eksport ustawień – Wyeksportuj bieżącą konfigurację wtyczki do pliku JSON
• Import ustawień – Zaimportuj konfigurację wtyczki z pliku JSON
• Resetuj ustawienia – Przywróć wszystkie ustawienia wtyczki do wartości domyślnych

11. Logi rabatów

Logi rabatów pozwalają na monitorowanie historii zastosowanych rabatów:

1. Przejdź do: Rabaty > Logi
2. Przeglądaj historię rabatów zawierającą następujące informacje:
   • Data i czas zastosowania rabatu
   • Użytkownik, który otrzymał rabat
   • Produkt, dla którego zastosowano rabat
   • Cena przed i po rabacie
   • Wartość rabatu (kwotowo i procentowo)
   • Grupa rabatowa, z której pochodzi rabat

Filtrowanie logów
Możesz filtrować logi według:

• Użytkownika – wprowadź login użytkownika
• Produktu – wprowadź nazwę produktu
• Daty – wybierz konkretną datę

Zarządzanie logami

• Logi są automatycznie usuwane po upływie okresu przechowywania ustawionego w konfiguracji
• Możesz ręcznie usunąć wszystkie logi, klikając przycisk „Usuń wszystkie logi”

12. Rozwiązywanie problemów

Rabaty nie są naliczane

• Sprawdź, czy wtyczka jest aktywna
• Upewnij się, że licencja jest aktywna
• Sprawdź, czy opcja „Automatycznie naliczaj rabaty” jest włączona
• Zweryfikuj, czy produkty, kategorie lub marki są poprawnie przypisane do grupy rabatowej
• Sprawdź, czy harmonogram rabatu jest poprawnie ustawiony i czy rabat jest aktywny w bieżącym czasie
• Sprawdź, czy strefa czasowa w WordPress jest ustawiona prawidłowo
• Upewnij się, że użytkownik, dla którego rabat nie działa, jest na liście wybranych klientów (jeśli lista jest ograniczona)

Odznaka rabatu nie jest wyświetlana

• Upewnij się, że opcja „Pokaż odznakę rabatu” jest włączona
• Sprawdź, czy motyw WordPress obsługuje odpowiednie hooki WooCommerce
• Wyczyść pamięć podręczną przeglądarki i sprawdź ponownie

Problemy z wyświetlaniem panelu administracyjnego

• Sprawdź, czy JavaScript w przeglądarce jest włączony
• Wyczyść pamięć podręczną przeglądarki i sprawdź ponownie
• Upewnij się, że wtyczka jest kompatybilna z używaną wersją WordPress i WooCommerce

Konflikty z innymi wtyczkami

• Tymczasowo wyłącz inne wtyczki i sprawdź, czy problem ustąpił
• Jeśli problem ustąpił, włączaj wtyczki pojedynczo, aby zidentyfikować konfliktującą wtyczkę

13. FAQ

Czy wtyczka działa z najnowszymi wersjami WooCommerce?
Tak, CC Discounts jest kompatybilna z najnowszymi wersjami WooCommerce i regularnie aktualizowana, aby zapewnić zgodność.

Czy mogę utworzyć rabat tylko dla określonych klientów?
Tak, w sekcji „Klienci” możesz wybrać konkretnych klientów, którzy będą mieli dostęp do rabatu.

Czy mogę ograniczyć rabat do określonych produktów?
Tak, możesz ograniczyć rabat do konkretnych produktów, kategorii lub marek.

Czy mogę utworzyć rabat aktywny tylko w określonym czasie?
Tak, w sekcji „Harmonogram” możesz ustawić dokładny okres obowiązywania rabatu, łącznie z godziną początkową i końcową.

Czy rabaty są widoczne w koszyku?
Tak, rabaty są naliczane i wyświetlane w koszyku oraz w procesie zamówienia.

Czy mogę użyć tej wtyczki razem z kuponami WooCommerce?
Tak, CC Discounts działa niezależnie od systemu kuponów WooCommerce i może być używany równocześnie.

Czy wtyczka obsługuje produkty z wariantami?
Tak, rabaty mogą być stosowane zarówno do produktów zwykłych , jak i z wariantami.

Czy mogę eksportować i importować ustawienia wtyczki?
Tak, w zakładce „Narzędzia” znajdziesz opcje eksportu i importu ustawień, co ułatwia przenoszenie konfiguracji między różnymi instalacjami.

Czy mogę zresetować ustawienia wtyczki do wartości domyślnych?
Tak, w zakładce „Narzędzia” znajduje się opcja resetowania wszystkich ustawień do wartości domyślnych.

Co jeśli potrzebuję wsparcia?
Wsparcie techniczne jest dostępne po zakupie licencji. Skontaktuj się z nami przez stronę wsparcia.

14. Uzupełnienie dokumentacji

Wersja 1.0.1 (09.04.2025)
W tej wersji wprowadzono następujące ulepszenia i poprawki:

Ulepszenia

• Wyszukiwanie produktów po ID – Zoptymalizowano funkcję wyszukiwania, umożliwiając teraz wyszukiwanie produktów bezpośrednio po ID. Wprowadzono minimalny próg 2 znaków dla identyfikatora produktu, co pozwala na szybsze odnajdywanie konkretnych pozycji w katalogu.
• Automatyczne oznaczanie wybranych elementów – Zaimplementowano funkcję, która automatycznie oznacza klientów i produkty, które zostały już wybrane z listy wyszukiwania. Dzięki temu użytkownik ma natychmiastową informację o tym, które elementy są już uwzględnione w konfiguracji rabatu.

Naprawy błędów

• Wyświetlanie liczby wyników wyszukiwania – Naprawiono błąd powodujący nieprawidłowe wyświetlanie liczby wyników podczas wyszukiwania produktów i klientów. Teraz licznik wyników pokazuje dokładną liczbę znalezionych elementów.
• Wyszukiwanie w grupach klientów – Rozwiązano problem z funkcjonalnością wyszukiwania w obrębie grup klientów, który powodował nieprawidłowe filtrowanie wyników. Dzięki tej poprawce wyszukiwanie klientów działa teraz sprawniej i zwraca dokładniejsze rezultaty.