first commit

wp-content/plugins/platnosci-online-blue-media/README.md

@@ -0,0 +1,109 @@
+# Instrukcja modułu Autopay dla platformy WooCommerce
+
+## Podstawowe informacje
+
+Autopay to moduł płatności umożliwiający realizację transakcji bezgotówkowych w sklepie opartym na platformie WordPress (WooCommerce). Jeżeli jeszcze nie masz wtyczki, możesz ją pobrać [tutaj.](https://github.com/bluepayment-plugin/autopay-payments/releases)
+
+Należy zawsze pobierać najnowsze wydanie oznaczone etykietą "latest" (plik z ikonką paczki, zobacz poniższy screen).
+
+![Instrukcja pobierania archiwum z wtyczką](/assets/img/screenshot_3.png)
+<em>Instrukcja pobierania archiwum z wtyczką<em>
+
+
+### Główne funkcje
+
+Do najważniejszych funkcji modułu zalicza się:
+- realizację płatności online poprzez odpowiednie zbudowanie startu transakcji
+- obsługę powiadomień o statusie transakcji (notyfikacje XML)
+- obsługę zakupów bez rejestracji w serwisie
+- obsługę dwóch trybów działania – testowego i produkcyjnego (dla każdego z nich wymagane są osobne dane kont, po które zwróć się do nas)
+- obsługę popularnych metod płatności, które pozwalają Twoim klientom płacić za zakupy w wygodny sposób
+- możliwość korzystania z BLIKA
+- wybór banku po stronie sklepu i bezpośrednie przekierowanie do płatności w wybranym banku
+
+### Wymagania
+
+- WordPress – przetestowane na wersjach od 6.0 do 6.3.2
+- Wtyczka WooCommerce – przetestowano na wersjach od 7.0 do 8.2.1
+- PHP minimum 7.3
+
+## Instalacja modułu
+1. Pobierz wtyczkę.
+2. Zaloguj się do swojego panelu administracyjnego w serwisie WordPress – używając loginu i hasła.
+3. W menu po lewej stronie wybierz Wtyczki ➝ Dodaj nową.
+4. Zainstaluj wtyczkę wybierając jedną z poniższych metod.
+
+### Instalacja wtyczki
+
+1. Kliknij Wyślij wtyczkę na serwer.
+2. Wybierz plik z wtyczką z rozszerzeniem .zip
+3. Kliknij Zainstaluj teraz, żeby wgrać wtyczkę do systemu.
+
+## Konfiguracja
+
+1. Przejdź do zakładki WooCommerce ➝ Ustawienia ➝ Płatności.
+2. Wybierz Autopay, żeby przejść do konfiguracji.
+
+### Konfiguracja podstawowych pól wtyczki
+
+1.	Przy nazwie Autopay ustaw Włącz, dzięki temu Twoi klienci będą mogli już korzystać z płatności internetowych.
+2.	Zaznacz pole: “Pokazuj metody płatności w sklepie”
+3. 	W polu “tryb działania” Zaznacz “włącz tryb testowy” aby włączyć tryb sandbox.
+4. 	W polu “Testowy identyfikator serwisu” wpisz Twój testowy identyfikator serwisu.
+5. 	W polu “Testowy Klucz konfiguracyjny (hash)” wpisz Twój testowy Klucz konfiguracyjny (hash).
+6. 	W polu “Identyfikator serwisu” wpisz identyfikator serwisu.
+7. 	W polu “Klucz konfiguracyjny (hash)” wpisz Klucz konfiguracyjny (hash).
+
+Powyższe pola uzupełnisz danymi, które otrzymasz od Autopay S.A. Jeśli jeszcze ich nie masz - skontaktuj się z nami.
+W momencie, gdy skończysz już sprawdzać, czy wszystko działa prawidłowo – wyłącz tryb testowy, wówczas płatności na Twojej stronie będą w 100% aktywne.
+Po uzupełnieniu wszystkich pól – wybierz: Zapisz zmiany i gotowe.
+
+![Widok pól do uzupełnienia](/assets/img/screenshot_12.jpg)
+<em>Widok pól do uzupełnienia<em>
+
+
+![Dostępne metody płatności](/assets/img/screenshot_5.jpg)
+
+<em>Dostępne metody płatności</em>
+
+### Konfiguracja adresów URL
+
+Upewnij się, że w panelach administracyjnych Autopay https://oplacasie.bm.pl oraz https://oplacasie-accept.bm.pl poniższe pola zawierają poprawne adresy sklepu.
+
+●	Konfiguracja adresu powrotu do płatności
+{URL Twojego sklepu}/?bm_gateway_return
+
+Przykład: https://mój-sklep.com/?bm_gateway_return
+
+●	Konfiguracja adresu, na który jest wysyłany ITN
+{URL Twojego sklepu}/?wc-api=wc_gateway_bluemedia
+
+Przykład: https://mój-sklep.com/?wc-api=wc_gateway_bluemedia
+
+### Rozszerzona Analityka Google Analytics 4
+
+Dzięki temu rozwiązaniu, możesz dokładniej analizować ścieżkę zakupową Twoich klientów.
+
+Po dokonaniu poniższej konfiguracji, Google Analytics zacznie zbierać szczegółowe dane na temat zachowań użytkowników
+
+Moduł dodaje obsługę dodatkowych zdarzeń w Google Analytics 4:
+- view_item_list – użytkownik zobaczył produkt na liście,
+- view_item – użytkownik wyświetlił stronę produktu,
+- add_to_cart – użytkownik dodał produkt do koszyka,
+- remove_from_cart – użytkownik usunął produkt z koszyka,
+- begin_checkout – użytkownik rozpoczął proces zamówienia (koszyk i/lub wybór metody dostawy),
+- checkout_progress – użytkownik przeszedł do drugiego kroku zamówienia (wybór metody płatności),
+- set_checkout_option – użytkownik uzupełnił dane zamówienia,
+- purchase – użytkownik złożył zamówienie oraz opłacił je poprzez płatność Autopay (oznaczenie jako konwersja).
+
+### Konfiguracja Google Analytics
+
+Wpisz Klucz śledzący Google Analytics oraz pozostałe dane GA4 we wskazane pola i zapisz zmiany.
+
+![Konfiguracja Google Analytics](/assets/img/screenshot_6.jpg)
+
+### Statusy płatności
+
+Nowa funkcja wyboru i dopasowania statusów płatności pozwala na automatyczną zmianę statusu zamówienia Woocoemmerce w momencie zmiany statusu płatności.
+
+![Konfiguracja statusów](/assets/img/screenshot_4.jpg)