WYSYŁANIE

Dokumentacja wtyczki Wiadomości

Wprowadzenie

Wtyczka Wiadomości to zaawansowane narzędzie dla WordPress, które umożliwia zdalne dodawanie wiadomości do wielu stron WordPress z jednego, centralnego panelu administracyjnego. Dzięki temu rozwiązaniu, administratorzy mogą błyskawicznie komunikować się z klientami lub użytkownikami na wszystkich zarządzanych stronach, bez konieczności logowania się do każdej z nich osobno.

Wtyczka składa się z dwóch komponentów:

  1. Wiadomości – wtyczka odbiorcza, instalowana na stronach docelowych
  2. Dodawanie Wiadomości – wtyczka nadawcza, instalowana na stronie głównej (centralnej)

Wymagania systemowe

Aby zapewnić prawidłowe działanie wtyczki, upewnij się, że Twój system spełnia następujące wymagania:

  • WordPress w wersji 5.0 lub nowszej
  • PHP w wersji 8.1 lub nowszej
  • Aktywne i dostępne REST API WordPress na wszystkich stronach
  • Zalecane (choć niewymagane) połączenie HTTPS dla bezpiecznej komunikacji

Instalacja

Instalacja komponentu odbiorczego (Wiadomości)

  1. Pobierz plik wtyczki wiadomosci.zip
  2. Zaloguj się do panelu administracyjnego WordPress na stronie docelowej
  3. Przejdź do sekcji Wtyczki → Dodaj nową → Wyślij wtyczkę
  4. Wybierz pobrany plik wiadomosci.zip i kliknij „Zainstaluj teraz”
  5. Po zakończeniu instalacji, kliknij „Włącz wtyczkę”

Instalacja komponentu nadawczego (Dodawanie Wiadomości)

  1. Pobierz plik wtyczki dodawanie-wiadomosci.zip
  2. Zaloguj się do panelu administracyjnego WordPress na stronie głównej (centralnej)
  3. Przejdź do sekcji Wtyczki → Dodaj nową → Wyślij wtyczkę
  4. Wybierz pobrany plik dodawanie-wiadomosci.zip i kliknij „Zainstaluj teraz”
  5. Po zakończeniu instalacji, kliknij „Włącz wtyczkę”

Konfiguracja

Konfiguracja komponentu odbiorczego

  1. Po instalacji i aktywacji wtyczki „Wiadomości”, przejdź do sekcji Ustawienia → Wiadomości
  2. Na tej stronie znajdziesz wygenerowany unikalny klucz API dla Twojej strony
  3. Zapisz ten klucz – będzie on potrzebny podczas konfiguracji wtyczki nadawczej
  4. W razie potrzeby możesz zregenerować klucz API, klikając przycisk „Zregeneruj klucz API”

Konfiguracja komponentu nadawczego

  1. Po instalacji i aktywacji wtyczki „Dodawanie Wiadomości”, w menu bocznym pojawi się nowa pozycja „Dodaj Wiadomość”
  2. Kliknij „Zarządzaj stronami” w podmenu
  3. W formularzu dodaj adresy stron docelowych wraz z ich kluczami API w formacie: Copyhttps://strona1.pl|kluczAPI123 https://strona2.pl|innyKluczAPI456
  4. Każda strona powinna być w nowej linii
  5. Kliknij „Zapisz strony”, aby zapisać konfigurację

Korzystanie z wtyczki

Wysyłanie wiadomości

  1. W panelu WordPress na stronie głównej przejdź do Dodaj Wiadomość
  2. W edytorze WordPress stwórz wiadomość, którą chcesz wysłać do stron docelowych
    • Możesz korzystać z pełnej funkcjonalności edytora WordPress, w tym formatowania tekstu, dodawania obrazów itp.
  3. Sprawdź, czy pod edytorem wyświetla się prawidłowa liczba skonfigurowanych stron
  4. Kliknij „Wyślij wiadomość”
  5. System wyświetli podsumowanie, ile stron otrzymało wiadomość pomyślnie, a ile nie

Wyświetlanie wiadomości

Wiadomości są automatycznie wyświetlane w kokpicie WordPress na stronach docelowych w widżecie „Dane kontaktowe i wiadomości”. Administratorzy stron docelowych zobaczą wiadomość po zalogowaniu się do panelu WordPress.

Funkcje

Komponent odbiorczy (Wiadomości)

  • Bezpieczny odbiór wiadomości – dzięki autoryzacji za pomocą klucza API
  • Wyświetlanie wiadomości w kokpicie – wiadomości są wyświetlane w widżecie na pulpicie WordPress
  • Logowanie aktualizacji – system zapisuje informacje o każdej odebranej wiadomości
  • Automatyczne aktualizacje – wtyczka automatycznie sprawdza i instaluje aktualizacje

Komponent nadawczy (Dodawanie Wiadomości)

  • Centralny panel zarządzania – wysyłaj wiadomości do wielu stron z jednego miejsca
  • Pełnowartościowy edytor WordPress – twórz bogate komunikaty z formatowaniem
  • Zarządzanie stronami docelowymi – łatwe dodawanie, edycja i usuwanie stron docelowych
  • Raportowanie dostarczenia – informacje o statusie wysłania każdej wiadomości

Zabezpieczenia

Wtyczka „Wiadomości” została zaprojektowana z myślą o bezpieczeństwie:

  • Unikalne klucze API – każda strona posiada unikalny klucz do autoryzacji
  • Autoryzacja REST API – wszystkie żądania API wymagają poprawnego klucza API
  • Bezpieczne przetwarzanie HTML – treść wiadomości jest filtrowana przez wp_kses_post()
  • Ochrona przed atakami CSRF – wszystkie formularze są zabezpieczone tokenami nonce
  • Logowanie aktywności – system zapisuje informacje o każdej aktualizacji wraz z adresem IP
  • Czyszczenie danych – podczas deaktywacji wtyczki, wszystkie dane są usuwane z bazy danych

Rozwiązywanie problemów

Problem z wysyłaniem wiadomości

Objaw: Wiadomość nie jest dostarczana do stron docelowych.

Rozwiązanie:

  1. Sprawdź, czy adres URL strony docelowej jest poprawny (bez błędów literowych)
  2. Upewnij się, że klucz API jest prawidłowy
  3. Sprawdź, czy REST API jest aktywne na stronie docelowej
  4. Sprawdź, czy strona docelowa nie ma aktywnych firewalli blokujących żądania POST

Problem z wyświetlaniem wiadomości

Objaw: Wiadomość jest wysyłana, ale nie jest widoczna na stronie docelowej.

Rozwiązanie:

  1. Upewnij się, że wtyczka „Wiadomości” jest aktywna na stronie docelowej
  2. Sprawdź, czy widżet kokpitu nie został przypadkowo usunięty
  3. Wyczyść pamięć podręczną przeglądarki i odśwież stronę

Problem z aktualizacją wtyczki

Objaw: Automatyczne aktualizacje nie działają.

Rozwiązanie:

  1. Sprawdź, czy serwer ma dostęp do internetu
  2. Upewnij się, że folder wtyczki ma odpowiednie uprawnienia do zapisu
  3. Sprawdź, czy system automatycznych aktualizacji WordPress jest włączony

FAQ

Czy mogę wysyłać wiadomości do wybranych stron, a nie do wszystkich naraz?

Tak, wtyczka umożliwia wybór, które strony mają otrzymać daną wiadomość. W przyszłych wersjach planujemy dodanie funkcji tworzenia grup stron, co jeszcze bardziej ułatwi zarządzanie komunikacją.

Czy wtyczka jest kompatybilna z motywami i wtyczkami stron trzecich?

Tak, wtyczka została zaprojektowana, aby działać z szeroką gamą motywów i wtyczek WordPress. Komunikacja odbywa się poprzez standardowy interfejs API WordPress, co zapewnia maksymalną kompatybilność.

Jak działa system licencji?

Licencja określa maksymalną liczbę stron, na których można zainstalować wtyczkę odbiorczą. Wszystkie aktualizacje i wsparcie są dostępne przez 12 miesięcy od zakupu, z możliwością przedłużenia.

Co się stanie z wiadomościami po deaktywacji wtyczki?

Po deaktywacji wtyczki na stronie docelowej, wiadomości są usuwane z bazy danych. Jeśli wtyczka zostanie ponownie aktywowana, konieczne będzie ponowne wysłanie wiadomości.

Kontakt i wsparcie

W przypadku pytań lub problemów z wtyczką, skontaktuj się z nami:

Godziny wsparcia technicznego: poniedziałek-piątek, 8:00-16:00.