Anty Spam

Dokumentacja CC WordPress Anty Spam

1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Panel zarządzania
5. Ochrona komentarzy
6. Ochrona rejestracji użytkowników
7. Integracja z formularzami zewnętrznymi
8. System blokowania IP
9. Zarządzanie logami
10. Statystyki i raporty
11. Zadania automatyczne (CRON)
12. Ustawienia zaawansowane
13. Rozwiązywanie problemów
14. FAQ

1. Wprowadzenie

• Ochronę komentarzy WordPress przed spamem
• Zabezpieczenie formularzy rejestracji użytkowników
• Integrację z Contact Form 7 i Gravity Forms
• Zaawansowany system blokowania adresów IP (czasowe i stałe)
• Pole honeypot niewidoczne dla użytkowników
• Sprawdzanie czasu wypełniania formularzy
• Filtrowanie treści na podstawie zakazanych słów
• Szczegółowe logowanie wszystkich aktywności anty-spam
• System cache sprawdzeń IP dla lepszej wydajności
• Automatyczne zadania czyszczące (CRON)
• Białą listę dozwolonych adresów IP
• Statystyki i raporty aktywności
• System zarządzania licencjami

2. Instalacja

• WordPress 5.0 lub nowszy
• PHP 7.4 lub nowszy
• Baza danych MySQL 5.6 lub nowszy
• Uprawnienia do tworzenia tabel w bazie danych
• Dostęp do ustawień CRON (opcjonalny)

1. Pobierz plik ZIP wtyczki z oficjalnej strony cocos.codes
2. Zaloguj się do panelu administracyjnego WordPress
3. Przejdź do: Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer
4. Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
5. Po zakończeniu instalacji kliknij „Aktywuj wtyczkę”
6. Wtyczka automatycznie utworzy niezbędne tabele w bazie danych
7. Przejdź do Ustawienia → CC Anty Spam aby skonfigurować wtyczkę

3. Aktywacja licencji

1. Po instalacji przejdź do Ustawienia → CC AntySpam
2. Wybierz zakładkę „Licencja”
3. Wprowadź klucz licencyjny otrzymany po zakupie
4. Kliknij „Aktywuj licencję”
5. Po pomyślnej aktywacji zostanie wyświetlony komunikat potwierdzający
6. Wszystkie funkcje wtyczki zostaną odblokowane

4. Panel zarządzania

• Ustawienia – konfiguracja wszystkich funkcji ochrony anty-spam
• Logi – przeglądanie logów aktywności z filtrowaniem i paginacją
• Statystyki – szczegółowe raporty i statystyki blokad

• Dokumentacja – link do pełnej instrukcji online
• Licencja – zarządzanie licencją wtyczki
• Wtyczki – informacje o innych rozszerzeniach COCOS
• Wsparcie – dostęp do pomocy technicznej

5. Ochrona komentarzy

• Pole honeypot – niewidoczne pole, które wypełniają tylko boty
• Sprawdzanie czasu wypełniania – blokada zbyt szybko lub zbyt wolno wypełnianych formularzy
• Filtrowanie treści – sprawdzanie zakazanych słów w treści komentarza
• Ograniczenie liczby linków – blokada komentarzy z nadmierną liczbą URL
• Sprawdzanie IP – weryfikacja czy adres IP nie jest zablokowany

1. W zakładce „Ustawienia” zaznacz „Chroń komentarze przed spamem”
2. Ustaw minimalny czas wypełniania formularza (domyślnie 3 sekundy)
3. Określ maksymalną liczbę linków w komentarzu (domyślnie 2)
4. Dodaj zakazane słowa (jedno w każdej linii)
5. Zapisz ustawienia

6. Ochrona rejestracji użytkowników

• Pole honeypot – jak w komentarzach, niewidoczne dla prawdziwych użytkowników
• Sprawdzanie czasu rejestracji – minimalny czas wypełniania formularza (domyślnie 5 sekund)
• Walidacja pól użytkownika – sprawdzanie nazwy użytkownika, emaila i URL pod kątem podejrzanych wzorców
• Filtrowanie tymczasowych emaili – blokada znanych serwisów tymczasowych emaili

• Nazwa użytkownika: wzorce typu „user123”, bardzo krótkie/długie nazwy, słowa związane ze spamem
• Email: adresy z serwisów 10minutemail, tempmail, guerrillamail, domeny .tk/.ml/.ga/.cf
• URL: skracacze linków, domeny związane z hazardem/krypto, podejrzane parametry

7. Integracja z formularzami zewnętrznymi

• Automatyczne dodawanie pól honeypot do wszystkich formularzy
• Sprawdzanie czasu wypełniania (domyślnie min. 2 sekundy)
• Filtrowanie treści wiadomości na podstawie zakazanych słów
• Walidacja przed wysyłką z odpowiednimi komunikatami błędów

• Dodawanie pól honeypot do tagów formularzy
• Kontrola czasu wypełniania (domyślnie min. 3 sekundy)
• Filtrowanie pól tekstowych formularza
• Oznaczanie formularza jako nieprawidłowy z komunikatami

1. Wtyczka automatycznie wykrywa aktywne wtyczki formularzy
2. W sekcji „Ochrona formularzy zewnętrznych” włącz ochronę dla wykrytych wtyczek
3. Ustaw minimalne czasy wypełniania dla każdego typu formularza
4. Włącz filtrowanie treści wiadomości
5. Zapisz ustawienia

8. System blokowania IP

• Blokady czasowe – automatyczne wygaśnięcie po określonym czasie (30 min – 24h)
• Blokady stałe – trwałe blokady wymagające ręcznego usunięcia
• Biała lista – dozwolone IP nigdy nie będą zablokowane
• Blokady automatyczne – system automatycznie blokuje IP po przekroczeniu progu spam

• Pojedyncze adresy IPv4: 192.168.1.100
• Pojedyncze adresy IPv6: 2001:db8::1
• Zakresy CIDR IPv4: 192.168.1.0/24
• Zakresy CIDR IPv6: 2001:db8::/32

1. Włącz „Automatycznie blokuj IP po wielokrotnych próbach spamu”
2. Ustaw próg blokady (domyślnie 5 prób w ciągu 24h)
3. Wybierz typ automatycznej blokady (czasowa/stała)
4. System będzie automatycznie blokować IP po przekroczeniu progu

# Przykładowa lista blokad IP
192.168.1.100
10.0.0.0/8
2001:db8::1
suspicious-domain.com (nieobsługiwane - tylko IP)

9. Zarządzanie logami

• Typ formularza – filtrowanie według typu chronionego formularza
• Powód blokady – filtrowanie według przyczyny wykrycia spamu
• Adres IP – wyszukiwanie aktywności konkretnego IP
• Zakres dat – ograniczenie do określonego okresu
• Paginacja – przegląd dużych zbiorów logów (50 rekordów na stronę)

• Automatyczne czyszczenie – domyślnie logi starsze niż 30 dni są usuwane
• Limit logów – maksymalnie 5000 logów w bazie (najstarsze są usuwane)
• Ręczne czyszczenie – możliwość wyczyszczenia wszystkich logów
• Eksport danych – wszystkie dane dostępne przez panel administracyjny

10. Statystyki i raporty

• Stałe blokady – liczba trwale zablokowanych adresów IP
• Aktywne blokady czasowe – liczba IP z aktywnymi blokadami czasowymi
• Dozwolone IP – liczba adresów na białej liście
• Wygasłe blokady – liczba blokad czasowych, które wygasły

• Ranking adresów IP według liczby prób spam w ostatnich 30 dniach
• Ostatnia próba spam dla każdego IP
• Aktualny status IP (aktywny/zablokowany czasowo/zablokowany stale)
• Możliwość szybkiego dodania IP do blokad lub białej listy

• Podział prób spam według typu formularza (komentarze, rejestracja, kontakt)
• Najczęstsze powody blokad (honeypot, time_check, content_filter)
• Trend dzienny – aktywność spam w ostatnich 7 dniach
• Porównanie z poprzednimi okresami

• Lista 10 najnowszych blokad z czasem wygaśnięcia
• Typ blokady (czasowa/stała) i powód
• Pozostały czas dla blokad czasowych
• Bezpośrednie linki do zarządzania blokadami

11. Zadania automatyczne (CRON)

• Usuwanie wygasłych blokad IP czasowych
• Egzekwowanie limitu 5000 logów w bazie
• Usuwanie logów starszych niż 90 dni
• Szybkie operacje bez wpływu na wydajność

• Zaawansowane czyszczenie logów z priorytetyzacją typów
• Ograniczanie logów per IP (max 100 na IP)
• Optymalizacja struktur bazy danych
• Generowanie raportu czyszczenia

// Wtyczka automatycznie dodaje niestandardowy interwał "weekly"
add_filter('cron_schedules', 'cc_anti_spam_add_weekly_cron_schedule');
// Harmonogram: 604800 sekund = 7 dni
$schedules['weekly'] = array(
'interval' => 604800,
'display' => 'Co tydzień'
);

12. Ustawienia zaawansowane

• Sprawdzaj IP tylko przy POST – ogranicza sprawdzenie IP do wysyłki formularzy
• Pomijaj zalogowanych użytkowników – wyłącza sprawdzanie anty-spam dla zalogowanych
• Cache sprawdzeń IP – przechowuje wyniki sprawdzeń IP w pamięci cache (30-300 sekund)

1. Włącz „Cache sprawdzeń IP” dla lepszej wydajności
2. Ustaw czas cache (domyślnie 60 sekund)
3. Cache zmniejsza obciążenie bazy danych przy wielokrotnych żądaniach z tego samego IP
4. Cache jest automatycznie unieważniany przy zmianie statusu IP

• Wykrywanie IP przez proxy – obsługa nagłówków HTTP_CF_CONNECTING_IP, HTTP_X_FORWARDED_FOR
• Walidacja formatów IP – sprawdzanie poprawności IPv4, IPv6 i zakresów CIDR
• Filtrowanie IP prywatnych – wykluczenie zakresów prywatnych z blokad

13. Rozwiązywanie problemów

1. Sprawdź, czy wtyczka ma aktywną licencję w zakładce „Licencja”
2. Upewnij się, że ochrona jest włączona w ustawieniach ogólnych
3. Sprawdź, czy konkretne typy formularzy są włączone w ochronie
4. Zweryfikuj, czy poziom ochrony nie jest ustawiony zbyt nisko
5. Sprawdź logi w poszukiwaniu informacji o blokadach
6. Upewnij się, że IP spamera nie jest na białej liście

1. Zmniejsz poziom ochrony z „Wysoki” na „Średni” lub „Niski”
2. Zwiększ minimalne czasy wypełniania formularzy
3. Sprawdź listę zakazanych słów – usuń zbyt ogólne terminy
4. Dodaj IP prawidłowych użytkowników do białej listy
5. Wyłącz walidację pól użytkownika jeśli blokuje prawdziwe konta
6. Przejrzyj logi aby zidentyfikować przyczyny blokad

1. Włącz cache sprawdzeń IP (60 sekund)
2. Włącz „Sprawdzaj IP tylko przy POST”
3. Włącz „Pomijaj zalogowanych użytkowników”
4. Zmniejsz czas retencji logów do 7-14 dni
5. Zwiększ częstotliwość zadań czyszczących CRON
6. Sprawdź limity PHP (memory_limit, max_execution_time)

1. Sprawdź, czy WordPress CRON jest włączony
2. Zweryfikuj ustawienia serwera – czy CRON może wykonywać zadania
3. Sprawdź logi błędów PHP w poszukiwaniu problemów
4. Upewnij się, że WP_CRON nie jest wyłączony w wp-config.php
5. Rozważ użycie rzeczywistego CRON systemowego zamiast WP_CRON

1. Upewnij się, że Contact Form 7 lub Gravity Forms są aktywne
2. Sprawdź, czy ochrona dla konkretnej wtyczki jest włączona
3. Wyczyść cache wtyczek i przeglądarki
4. Sprawdź konsole błędów przeglądarki w poszukiwaniu konfliktów JavaScript
5. Przetestuj z wyłączonymi innymi wtyczkami dla wykrycia konfliktów

14. FAQ