Dokumentacja sklepu DIVShop.pro

1.wprowadzenie #

DIVShop.pro to sklep o otwartym kodzie źródłowym, pisany z myślą o serwerach Minecraft.

1.1.instalacja-divshop #

Chcesz skorzystać ze sklepu DIVShop.pro? Świetnie! Wystarczy, że wrzucisz pliki na serwer, a następnie przejdziesz przez proces instalacji! Instalator sam wykryje, że chcesz zainstalować sklep, co widać na załączonym niżej obrazku.

Instalator sklepu został wykryty
Instalator sklepu został wykryty

 

Po kliknięciu przycisku o treści „Przejdź do instalatora”, zostaniesz przywitany przez nasz instalator.

Strona powitalna instalatora
Strona powitalna instalatora DIVShop

Kiedy przejdziesz już dalej, instalator przystąpi do sprawdzenia plików i modułów, potrzebnych do instalacji DIVShop.pro.

Sprawdzanie wymaganych plików przez instalator
Sprawdzenie plików i modułów przez instalator

Gdy instalator sprawdzi już poprawność wszystkich plików, czas przystąpić do połączenia instalatora z bazą danych. Zrobisz to, wpisując dane w odpowiednie pola.

Łączenie z bazą danych - puste pola
Łączenie z bazą danych – puste pola
Łączenie z bazą danych - pola wypełnione
Łączenie z bazą danych – pola wypełnione

Po wypełnieniu wszystkich pól odpowiednimi danymi, pora przejść do tworzenia konta administratora, co jest równie łatwe.

Tworzenie konta administratora - puste pola
Tworzenie konta administratora – puste pola
Tak jak wcześniej, należy tu wypełnić pola odpowiednimi danymi.
Tworzenie konta administratora - pola wypełnione
Tworzenie konta administratora – pola wypełnione
Instalator wykona wszystkie potrzebne kroki automatycznie, dzięki czemu Ty możesz siedzieć i o nic się nie martwić. 🙂
Instalacja sklepu
Instalacja sklepu
To wszystko co jest potrzebne, by zacząć przygodę z DIVShop.pro!

1.2.aktualizowanie-divshop #

Aby zaktualizować sklep DIVShop.pro, należy się najpierw zalogować na konto Administratora w Panelu Administratora.

Jeżeli tego się nie zrobi, zastanie nas komunikat o braku uprawnień do aktualizowania sklepu.

Brak uprawnień do aktualizacji sklepu
Komunikat o braku uprawnień do aktualizacji sklepu DIVShop.pro

Warto zatem pamiętać o zalogowaniu się do Panelu Administratora.

Po zalogowaniu się, ukaże się komunikat o dostępnej aktualizacji.

Dostępna aktualizacja sklepu DIVShop.pro
Komunikat o dostępnej aktualizacji sklepu DIVShop.pro

Wystarczy kliknąć „Aktualizuj”, by aktualizator wykonał całą robotę za Ciebie. 🙂

UWAGA! Przed aktualizacją wykonaj kopię zapasową plików sklepu i bazy danych!

Aktualizowanie sklepu DIVShop.pro
Aktualizowanie sklepu DIVShop.pro

2.konfiguracja-sklepu #

2.1.konfiguracja-ustawien-platnosci #

Aby umożliwić zakup usług, niezbędna jest konfiguracja płatności. Poniżej znajdują się kroki jak skonfigurować płatności SMS Premium, PayPal oraz Przelewów

2.1.1.konfiguracja-sms-premium #

Aby skonfigurować płatności SMS Premium należy zalogować się do Panelu Administratora, a następnie z menu po lewej stronie wybrać Płatności. Ukaże się lista pól do wypełnienia. W przypadku konfiguracji płatności SMS Premium powinny Cię interesować dwa górne pola – Operator płatności SMS oraz ID Użytkownika MicroSMS

Lista ustawień płatności SMS
Lista ustawień płatności SMS

Pole Operator płatności SMS ma domyślnie ustawionego operatora którym jest MicroSMS.pl. W polu ID Użytkownika MicroSMS należy wpisać ID Użytkownika z serwisu MicroSMS, które znajduje się w panelu bocznym po lewej stronie (oznaczone czerwonym prostokątem na poniższym zdjęciu)

ID Użytkownika MicroSMS.pl
ID Użytkownika MicroSMS.pl

Po wprowadzeniu tych danych wystarczy kliknąć Zapisz ustawienia

2.1.1.1.tworzenie-nowej-uslugi-sms-w-microsms #

Aby utworzyć nową usługę SMS Premium w MicroSMS.pl w pierwszej kolejności należy zalogować się do Panelu Klienta MicroSMS.pl, a następnie z menu po lewej stronie wybrać SMS Premium > Nowa usługa SMS. Pojawi się lista wyboru typu kanału SMS. Należy wybrać SMS PREMIUM STANDARD.

Kanał MicroSMS Premium Standard
Kanał MicroSMS Premium Standard

Pojawi się lista pól do wypełnienia:

  • Treść SMS-a – Treść SMSa jaką kupujący będzie wysyłał pod wybrany numer (od 1 do 10 znaków, bez polskich oraz specjalnych znaków)
  • Typ kodu – Ile razy kod z SMS-a może zostać wykorzystany
  • Generowanie kodu – W jaki sposób mają być generowane kody SMS (automatycznie generowane losowe kody lub generowanie paczki gotowych kodów )
  • Odpowiedź zwrotna – Treść zwrotna do wysłanego SMS-a (pełna dowolność, ale należy pamiętać o zmiennej [kod])
  • Strona WWW – Po prostu Adres URL do Twojego sklepu, np. https://demo.divshop.pro/
  • Link do regulaminu – Link do regulaminu płatności SMS w Twoim sklepie (w tym celu można użyć moduł stron)
  • Typ serwisu – Jaki to jest typ serwisu (niestety nie ma pola Gry itp., dlatego zalecamy wybranie Rozrywka)
  • Opis usługi – Opis dla Administratorów MicroSMS.pl na czym ma polegać Twoja sprzedaż
  • Numery SMS – Lista numerów, które zwrócą SMS z kodem (Pamiętaj, że jeżeli odznaczysz numer SMS w MicroSMS, to nie zniknie on z Twojego sklepu przy tworzeniu nowej usługi. Dlatego zalecamy nie odznaczanie żadnego numeru SMS)
Dodawanie nowego kanału SMS w MicroSMS.pl - Pola wypełnione
Dodawanie nowego kanału SMS w MicroSMS.pl – Pola wypełnione

Po uzupełnieniu tych pól można kliknąć Dodaj konto. Następnie trzeba poczekać na zatwierdzenie kanału przez Administratora MicroSMS.pl

2.1.2.konfiguracja-paypal #

Aby skonfigurować płatności PayPal należy zalogować się do Panelu Administratora, a następnie z menu po lewej stronie wybrać Płatności. Ukaże się lista pól do wypełnienia. W przypadku konfiguracji płatności PayPal powinno Cię interesować jedno środkowe pole – Adres e-mail PayPal

Lista ustawień płatności PayPal
Lista ustawień płatności PayPal

W polu Adres e-mail PayPal należy wpisać adres e-mail, który jest powiązany z kontem PayPal (na ten adres e-mail będą wysyłane pieniądze). Po wprowadzeniu tych danych wystarczy kliknąć Zapisz ustawienia

 

Kolejnym krokiem będzie ustawienie adresu do odbierania informacji o płatności (Instant Payment Notification – IPN). Nie jest to rzecz wymagana, ale warto to zrobić, aby płatności PayPal były szybciej przetwarzane. Dlatego należy zalogować się do PayPal. Po zalogowaniu przechodzimy do ⚙️ (prawa górna strona ekranu) > Narzędzia sprzedającego > Błyskawiczne powiadamianie o płatności > Przycisk „Zaktualizuj” > Żółty przycisk „Wybierz ustawienia BPP”.

W polu Adres URL dla powiadomień należy wpisać pełny adres swojej strony ze sklepem, dodając na końcu

/payments/paypal/ipn

Adres URL ma wyglądać w ten sposób:

https://demo.divshop.pro/payments/paypal/ipn

Gdzie https://demo.divshop.pro należy wpisać swój adres sklepu
Następnie należy zaznaczyć opcję Odbieram powiadomienia BPP (włączone).

Ustawienia IPN
Ustawienia IPN

Po uzupełnieniu pól kliknij Zapisz. I to tyle 🙂 Twoje płatności PayPal są już skonfigurowane

2.1.3.konfiguracja-przelewow #

Aby skonfigurować płatności Przelewami należy zalogować się do Panelu Administratora, a następnie z menu po lewej stronie wybrać Płatności. Ukaże się lista pól do wypełnienia. W przypadku konfiguracji płatności Przelewami powinny Cię interesować trzy ostatnie pola – ID SklepuID Użytkownika MicroSMS oraz Hash sklepu.

Lista ustawień płatności Przelewami
Lista ustawień płatności Przelewami

W polu ID Użytkownika MicroSMS należy wpisać ID Użytkownika z serwisu MicroSMS, które znajduje się w panelu bocznym po lewej stronie (oznaczone czerwonym prostokątem na poniższym zdjęciu)

ID Użytkownika MicroSMS.pl
ID Użytkownika MicroSMS.pl

Następnie w polu ID Sklepu należy wpisać ID sklepu, które znajduje się w informacjach o sklepie (Przelewy internetowe > Sklepy)

ID Sklepu MicroSMS.pl
ID Sklepu MicroSMS.pl

W polu Hash sklepu należy wpisać specjalny hash, który służy do tworzenia podpisów transakcji. Można go uzyskać klikając na ikonę zarządzania sklepem (🔧). Typ kodowania musi być ustawiony na sha256.

Hash sklepu i typ kodowania
Hash sklepu i typ kodowania

Po wprowadzeniu tych danych w ustawieniach płatności wystarczy kliknąć Zapisz ustawienia

2.1.3.1.tworzenie-nowego-sklepu-w-microsms #

Aby utworzyć nowy sklep do płatności przelewami w MicroSMS.pl w pierwszej kolejności należy zalogować się do Panelu Klienta MicroSMS.pl, a następnie z menu po lewej stronie wybrać Przelewy internetowe > Sklepy. Pojawi się lista sklepów. Należy kliknąć przycisk Dodaj nowy kanał.

Pojawi się lista pól do wypełnienia:

  • Strona internetowa – Po prostu Adres URL do Twojego sklepu
  • Adres regulaminu – Link do regulaminu płatności Przelewami w Twoim sklepie (w tym celu można użyć moduł stron)
  • Nazwa odbiorcy – Nazwa odbiorcy, która jest wyświetlana kupującemu w momencie płatności
Dodawanie nowego sklepu w MicroSMS.pl - Pola wypełnione
Dodawanie nowego sklepu w MicroSMS.pl – Pola wypełnione

I to tyle. Po uzupełnieniu tych pól można kliknąć Dodaj kanał. W tym przypadku nie trzeba czekać na weryfikację przez Administratora MicroSMS.pl, lecz mogą w późniejszym czasie weryfikować czy Adres URL do strony lub regulaminu jest prawidłowy.

3.zarzadzanie-sklepem #

3.1.konfiguracja-discordowego-webhooka #

Chcesz otrzymywać na swoim serwerze Discord powiadomienie, że ktoś coś kupił w Twoim sklepie? Nie ma problemu!

Aby ustawić powiadomienia o zakupie należy zalogować się do Panelu Administratora, a następnie z menu po lewej stronie wybrać Ustawienia. Po załadowaniu strony z jej górnej części wybierz Ustawienia Webhooka.

Pokaże się lista pól do wypełnienia:

  • Adres URL Webhooka – Adres URL, który jest przypisany do Twojego webhooka na kanale Discord (o tym niżej)
  • Nazwa Bota wysyłającego wiadomości – Po prostu jak ma się nazywać Bot, który wysyła wiadomości
  • Treść wiadomości – Wiadomość jaką ma wysyłać Bot. Można wpisać też zmienne:
    • {BUYER} – Nazwa/Nick kupującego (Automatycznie zamieniane)
    • {SERVICE} – Nazwa usługi, która została zakupiona (Automatycznie zamieniane)
  • Kolor osadzenia – Kolor lewego paska w wiadomości wysłanej przez Bota
  • Webhook włączony – Przełącznik, który zmienia status czy wiadomości mają być wysyłane, czy też nie
Ustawienia Webhooka - Pola wypełnione
Ustawienia Webhooka – Pola wypełnione

Po uzupełnieniu tych pól wystarczy kliknąć Zapisz ustawienia

 

A teraz dodawanie webhooka na kanale na Discordzie.

Aby dodać webhooka na Discordzie należy przejść na interesujący Cię serwer, a następnie kliknąć ⚙️ (Edytuj kanał) obok nazwy kanału na którym chcesz dodać webhooka. Następnie Integracje > Tworzenie webhooka (jeżeli istnieje już jakiś webhook należy kliknąć Nowy webhook).

Pokaże się lista ustawień webhooka:

  • Nazwa – Nazwa webhooka (to nie nazwa bota wysyłającego wiadomości)
  • Kanał – Na jakim kanale mają być wysyłane wiadomości

Aby uzyskać Adres URL webhooka wystarczy kliknąć Skopiuj adres URL webhooka. Ten link trzeba wkleić do pola Adres URL Webhooka w ustawieniach Webhooka

4.konfiguracja-pluginow #

4.1.konfiguracja-divsantybot #

Chcesz weryfikować graczy przed wejściem na Twój serwer? Nie ma problemu! Dzięki pluginowi DIVSAntybot możesz zrobić weryfikację graczy na stronie ze sklepem.

Aby to zrobić pobierz plugin DIVSAntybot z naszej strony. Następnie wrzuć go do katalogu plugins na swoim serwerze. Wymagane jest przeładowanie serwera lub po prostu restart. Po przeładowaniu utworzy się folder DIVSAntybot, a w nim plik z configiem config.yml. Musisz ten plik edytować w jakimś edytorze kodu, np. Notepad++ lub Visual Studio Code

DIVSAntybot - Plik config.yml - Puste
DIVSAntybot – Plik config.yml – Puste

Plugin należy podłączyć do bazy danych ze sklepem:

  • host – Host bazy danych, np. localhost
  • user – Użytkownik z dostępem do bazy danych sklepu
  • pass – Hasło użytkownika do bazy danych
  • name – Nazwa bazy danych do sklepu, np. jeżeli baza danych podpięta do skryptu sklepu nazywa się divshop, to w pliku configu trzeba uzupełnić tym samym
  • local_saving – Czy dane graczy (zweryfikowany/niezweryfikowany) mają być zapisywane lokalnie na dysku serwera
  • messages > verify – Wiadomość, która pojawia się dla gracza gdy nie jest zweryfikowany

Poprawnie uzupełniony config.yml powinien wyglądać mniej więcej tak:

DIVSAntybot - Plik config.yml - Poprawnie uzupełniony
DIVSAntybot – Plik config.yml – Poprawnie uzupełniony

Po uzupełnieniu configu należy przeładować serwer. Jeżeli dane do bazy zostały uzupełnione poprawnymi danymi to plugin uruchomi się bez problemu. W przeciwnym razie wyłączy się.

UWAGA! W sklepie musi być włączony moduł AntyBot