Digital Revolution: konfiguracja i pomoc

Prześlij i zainstaluj ZIP Digital Revolution w Moduły > "Module Manager". Otwórz "Sell" > Produkty cyfrowe > "Settings" > Konfiguracja.

Wybierz właściwy sklep. Sprawdź Integralność i usuń ostrzeżenia o aktualizacji bazy przed operacjami licencyjnymi. Moduł dodaje obszary "Catalog", "Licensing", Wsparcie, "Analytics" i "Settings" w Produkty cyfrowe.

Sprawdź panel Klucze podpisywania przed opublikowaniem pobierania. Instalacja próbuje przygotować klucze podpisu, ale niepowodzenie pozostaje widoczne. Dopóki klucze nie będą gotowe do użycia, nie można aktywować licencji, pobierać chronionych modułów ani tworzyć wymaganych podpisanych odpowiedzi API licencyjnego.

Użyj produktu i zamówienia testowego przed dodaniem reszty katalogu. Procesy PHP/CLI wymagają dostępu do przesłanych źródeł, przygotowanych wydań i tymczasowego miejsca budowania. Pakowanie ZIP wymaga ZipArchive, a kryptografia funkcji używanych przez usługi podpisywania i szyfrowania.

Otwórz "Settings" > Konfiguracja > Ogólny.

Przykładowe wzorce i adresy wewnętrzne:

@yourcompany.com,*.dev.example.com,staging.example.com

127.0.0.1
192.168.1.0/24
10.0.

Wpisany e-mail lub domena to wyłącznie klasyfikacja raportowa. Nie upoważnia do omijania limitów pobrań, częstotliwości ani blokad. Kontrola zaufanych żądań wewnętrznych korzysta ze skonfigurowanego wewnętrznego IP.

Przełączniki powiadomień e-mail demo dla administratorów i klientów nie są dostępne w konfiguracji.

W Klucze podpisywania sprawdź status, ID klucza, odcisk i adres wystawcy. Nowe pakiety ufają wystawcy tego sklepu i jego publicznej tożsamości podpisującej.

W nowym sklepie bez kluczy użyj "Set up signing keys". Wyeksportuj zaszyfrowaną kopię z hasłem i przechowuj ją poza sklepem. "Download public key" udostępnia publiczny klucz podpisu odpowiedzi, gdy jest gotowy. "Import backup" przywraca istniejącą tożsamość; import przez przeglądarkę ma limit 4 MB.

Jeśli skonfigurowano _MPR_DIGITAL_SIGNING_KEY_DIR_, operator serwera zarządza kluczami w tym folderze. W odpowiednich przypadkach panel pokazuje "Use the keys in the operator folder". Przywróć skonfigurowany folder i pliki, jeśli ten backend stanie się niedostępny.

Jeśli sklep już wydawał pakiety, przywróć kopię kluczy przed rozważeniem wymiany. Wymiana nadaje nową tożsamość; dostarczone moduły mogą przestać jej ufać do czasu ponownego pobrania przez klientów. Unieważnij wcześniejszy klucz tylko wtedy, gdy chcesz odrzucać to, co podpisał. Formularz wymaga wyraźnego potwierdzenia wymiany i unieważnienia.

Ta sama usługa jest dostępna z katalogu głównego sklepu, przy użyciu tożsamości serwera WWW:

php modules/mprdigitalrevolution/scripts/signing_keys.php status

Narzędzie obsługuje też konfigurację, szyfrowany eksport/import, wymianę i unieważnienie. Odczytuje hasło kopii z MPR_SIGNING_BACKUP_PASSWORD. Używaj udokumentowanych argumentów zamiast wypisywać klucze prywatne lub ręcznie zmieniać ich rekordy.

Otwórz "Catalog" > Produkty i dodaj produkt. Powiąż go ze zwykłym produktem PrestaShop przez Produkt sklepu. Powiązany produkt natywny dostarcza kontekstu handlowego sklepu.

Użyj "Localized Roadmap Content" do tłumaczonych pól Nazwa wyświetlana, Slug SEO, Notatki gałęzi, Opis Showcase, Obraz Showcase, Funkcje Showcase, Tagi Showcase i Uwaga o niedostępności zamówienia. Puste treści językowe same nie tworzą kompletnej publicznej strony w danym języku.

Dla planowanego wydania wypełnij Oczekiwane wydanie i odpowiednio wybierz Powiadom przy wydaniu. Obszar Subskrybenci pokazuje zainteresowanych odwiedzających. Te pola nie zastępują przesłania aktywnego wydania.

Pola "Minimum Protection Generation", "Blocked Build IDs" i "Legacy Protection Compatibility Until" to ustawienia operatora dotyczące akceptowania klientów/pakietów. Przed zmianą przejrzyj wdrożone generacje klientów; nie są wymagane przy pierwszej zwykłej konfiguracji produktu.

Edytor zawiera też obszary Wydania, Cennik licencji, Cennik wsparcia, Usługi i Warianty. Skonfiguruj rzeczywiste opcje i ceny, które chcesz oferować, następnie sprawdź ich wybór w sklepie i metadane zamówienia. Nie zakładaj, że nazwa produktu lub stary przykład JSON automatycznie ustawia te opcje.

Bezpłatne pobrania wymagają uprawnienia do bezpłatnego pobrania i powiązanego produktu o cenie zero. Formularz produktu nie ma osobnego przełącznika tego uprawnienia. Po ustawieniu ceny sprawdź cały proces bezpłatnego pozyskiwania.

Otwórz "Catalog" > Wydania lub obszar Wydania produktu.

Używaj czystych pakietów źródłowych. Jeśli moduł ładuje vendor/autoload.php, dołącz zależności produkcyjne i autoloader. Narzędzie pakujące sprawdza ścieżki archiwum, katalog główny i plik główny modułu, następnie przygotowuje wydanie. Nie przesyłaj jako źródła chronionego ZIP już spersonalizowanego dla klienta.

Sam rekord wydania nie potwierdza gotowości dostarczenia. Uruchom dostępne kontrole Gotowość modułu i wykonaj rzeczywiste kontrolowane pobranie. Chroniony pakiet jest certyfikowany po stronie serwera przed podaniem; nieudana certyfikacja blokuje dostarczenie i zgłasza błąd.

Obecne pakiety mogą zawierać zaszyfrowane dane licencji, .mpr_license.json, lokalny dla modułu .mpr_wm, kod integralności wystawcy/środowiska i komentarz archiwum MPR:<watermark ID>. Szczegóły plików zależą od trybu dostarczenia. Minimalny stary pomocniczy JSON nie jest wzorem do kopiowania do nowych wydań.

Złóż zamówienie testowe powiązanego produktu. Hooki walidacji i statusu zamówienia przydzielają oraz uzgadniają uprawnienia. Oczekująca licencja nie oznacza opłaconego aktywnego dostępu. Potwierdź kwalifikujący się stan opłacony/logable i sprawdź "Licensing" > Licencje.

Zaloguj się jako klient testowy i otwórz /licenses, używając wygenerowanego przez sklep linku w odpowiednim języku. Sprawdź kartę licencji i pobierz przysługujące wydanie.

Pierwsze płatne pobranie z karty licencji może być podpisanym pakietem, który nie jest jeszcze powiązany z domeną sklepu. Aktywacja podczas instalacji wiąże go ze sklepem. Aktualizacje istniejącej aktywacji korzystają ze sklepu już powiązanego z licencją.

Dla już zainstalowanego demo użyj działania Aktywuj klienta, zaloguj się do portalu wystawcy i potwierdź licencję. Samo posiadanie klucza licencji nie wystarcza do nowego powiązania przez wycofane działania rejestracji sklepu/automatycznego przypisania.

Sprawdź status aktywacji modułu, powiązany sklep, własność licencji i sprawdzanie aktualizacji. Przejrzyj "Licensing" > Domeny oraz "Installs". Używaj obsługiwanych działań przenoszenia/zmiany domeny w portalu; nie zmieniaj bezpośrednio rekordów powiązań.

Trasa płatnego pobierania z tokenem:

/release-download/{token}

Omija fizyczny katalog download/ PrestaShop. Token płatnego żądania ma domyślnie 30 minut i jest zużywany przy realizacji. Osobna usługa tokenów przygotowanych artefaktów ma TTL 300 sekund. To różne etapy tokenów. Uzyskaj świeży link z portalu po wygaśnięciu lub wykorzystaniu poprzedniego.

Logi pobrań łączą produkt, wydanie, klienta, IP, informacje o powiązaniu, skróty i tożsamość znaku wodnego, jeśli dostępne.

Ważność licencji i zakres wsparcia są osobne. Przy aktywnym wsparciu usługa może wybrać najnowsze aktywne wydanie. Po wygaśnięciu wybiera wydanie opublikowane w przysługującym oknie wsparcia. Ważna licencja wieczysta nie daje automatycznie każdego nowego wydania. Zakres usług i pakietów może narzucać własną datę graniczną wydań.

Używaj Cennik wsparcia i obsługiwanej integracji zamówienia do przedłużeń lub cyklicznego wsparcia. Sprawdź rzeczywiście oferowaną umowę i opcje wsparcia.

W Konfiguracja > Usługi pole "Demo Orchestrator Admin Token" jest początkowo puste. Uzyskaj token z administracji skonfigurowanego orkiestratora demo. Ten formularz go nie generuje. Hostowane demo wymaga zewnętrznego orkiestratora oraz flagi produktu.

Domyślne notatki usług:

Notatki mogą używać {module_name}, {service_name} i {service_type}. Sprawdź flagę widoczności dla klienta podczas aktualizowania zamówienia usługi. Moduł udostępnia zamówienia usług, umowy i integrację zgłoszeń; sprawdź Wsparcie i odpowiednie strony licencji/administracji wybranego klienta.

Dla pakietu katalogowego włącz Pakiet, wybierz Skład pakietu, Moduły dodane później i ewentualne Liczba miesięcy na nowe moduły. Nowy pakiet domyślnie ma skład z listy i dodawanie bezterminowe. Zapisz go jako niedostępny do zamówienia, następnie edytuj i zapisz Identyfikatory produktów w pakiecie przed uruchomieniem sprzedaży. Sprawdź uprawnienia produktów składowych zamówieniem testowym.

Obecna karta "Stripe" udostępnia Sekret webhooka, domyślnie puste. Nie udostępnia starych pól "Stripe Mode", "Test Secret Key" ani "Live Secret Key". Cykliczne płatności/wsparcie nadal wymagają zgodnej integracji płatności/subskrypcji i poprawnych danych dostępowych.

Moduł rejestruje /webhook/stripe. Skonfiguruj właściwy sekret podpisu dla tego punktu końcowego. W Kolejka ponownego wysyłania webhooków usuń przyczynę błędu zdarzenia, użyj Ponownie dodaj zdarzenie do kolejki, następnie "Resend" w Stripe. Tą akcją nie można ponawiać zakończonych zdarzeń.

W Bezpieczeństwo opcja "Require Signed Support API Requests" jest domyślnie wyłączona. Włącz ją po dotarciu zgodnych podpisujących klientów do modułów klientów. Tajny klucz API jest generowany przy instalacji i w formularzu służy tylko do zapisu. Ponowne generowanie zmienia dane uwierzytelniania serwera; wcześniej przejrzyj zależnych klientów i tokeny.

Panel "Shared sign-in credentials" pojawia się tylko wtedy, gdy inny zainstalowany moduł oferuje obsługiwane dane OAuth. Sprawdź właściciela/odcisk i przyznaj lub cofnij ponowne użycie w tym sklepie. To nie miejsce na wklejanie dowolnych kluczy Stripe.

Trasy API używają /mpr-api/license/{action}. Starszy punkt walidacji przyjmuje klucz licencji i domenę, na przykład:

curl -X POST 'https://yourshop.example/mpr-api/license/validate' \
  -H 'Content-Type: application/json' \
  -H 'X-License-Key: YOUR_TEST_LICENSE_KEY' \
  -d '{"domain":"example.com","module":"yourmodule","module_version":"1.2.5","ps_version":"8.2.1","php_version":"8.2"}'

Użyj rzeczywistego testowego powiązania licencji/domeny. To wywołanie walidacji nie tworzy powiązania aktywacji. Inne operacje mają własne wymagania uwierzytelniania, podpisu lub tokenów o określonym zakresie. Użyj dostarczonego klienta licencji do pełnego protokołu aktualizacji i aktywacji.

Powiązane produkty mogą dodawać opcje licencji, wsparcia, usług i demo przez hooki produktu. Historia zmian może pojawiać się przez obsługiwane integracje kart produktu. Sprawdź hooki displayProductAdditionalInfo, kart i dodatkowej treści w motywie.

Publiczne trasy obejmują /roadmap, /roadmap/{slug}, /demos, /demo/{slug} i procesy /live-demo, jeśli włączone. /demos/{slug} pozostaje starszą trasą strony demo i przekierowuje przez obecny proces katalogowy; nie traktuj każdego starego URL jako osobnej samodzielnej strony.

Osobno testuj pozyskanie demo, pobieranie jednym kliknięciem, akceptację warunków/prywatności, limity i aktywację pierwszej instalacji. Przydział demo/bezpłatny nie staje się płatną licencją tylko dlatego, że klient później się zaloguje. Sprawdź właściwe rekordy przydziału i własności w Pobierania demo oraz przestrzeni klienta.

Hook mapy witryny sprawdza współdzielony klucz niskiego poziomu INCLUDE_IN_SITEMAP, początkowo 1. Ustawienie 0 wyłącza dodawanie adresów modułu do mapy witryny. Nie jest widocznym ustawieniem Ogólny, a publiczna widoczność/indeksowalność nadal zależy od konkretnej treści i trasy.

CSS motywu może używać istniejących selektorów, takich jak .mpr-digital-variants, .mpr-demo-link, .mpr-btn-demo, .mpr-btn-demo-download, .mpr-license-selection i .mprdigital-changelog-tab. Sprawdź obecny kod HTML przed dodaniem nadpisań.

Instalacja rejestruje współdzielone zadania harmonogramu dla analityki, oczekujących płatnych licencji, dodatków do pakietów, cofania uprawnień, aktywacji/przypisywania wsparcia, porzuconych kompilacji i czyszczenia audytu demo. Skonfiguruj program uruchamiający rzeczywistym poleceniem/tokenem wygenerowanym przez zainstalowany moduł. Sprawdź aktywację zadań i poprawne wyniki; utworzenie produktu samo nie uruchamia wszystkich uzgodnień w tle.

W Konfiguracja opcja "Retention" > "Apply retention now" przetwarza ograniczone partie, do 50 zmienionych wierszy na zbiór danych i przebieg. Powtarzaj, dopóki wynik wskazuje "Repeat". Przejrzyj nierozstrzygnięte rekordy płatności, komunikatów dostępu i wykonania przed uznaniem historycznego czyszczenia za zakończone. Logi błędów PHP i zewnętrzne systemy zgłoszeń są poza tą usługą retencji.

Formularze klasyfikacji historycznej wymagają przejrzanych ID i odniesienia do zamknięcia dla każdego rekordu. Używaj rzeczywistego rekordu zamknięcia, a nie zgadywanej daty ostatniej edycji.

Jeśli aktywacja lub chronione pobieranie zawodzi, najpierw sprawdź Klucze podpisywania, wyświetlany URL wystawcy i Integralność. Potem sprawdź gotowość wydania, certyfikację pakietu, własność i opłacony stan zamówienia. Wygasłe okno wsparcia może zasadnie wykluczać nowsze wydanie.

Jeśli URL pobierania zwraca 403, potwierdź użycie wygenerowanego linku release-download zamiast /download/. Po wygaśnięciu lub zużyciu wygeneruj nowy z karty licencji. Jeśli kompilacja jest zajęta, użyj obsługiwanej procedury ponowienia tego żądania zamiast ciągle tworzyć nowe pobrania.

Jeśli opcje produktu się nie pojawiają, sprawdź Produkt sklepu, Aktywny, Możliwe do zamówienia, stan wydania, ceny/warianty i hooki motywu. Przy braku treści publicznej sprawdź pola językowe i "Indexable (SEO)". Gdy demo nie działa, sprawdź integrację orkiestratora, token, limity i dostępny protokół pakietów.

Używaj "Analytics" > Pobrania, "API Logs", Dema na żywo, Popularność produktu i Gotowość modułu, aby sprawdzić każdy obszar. Przy cyklicznym wsparciu sprawdź również integrację płatności i subskrypcji, nieudane webhooki i zaplanowany mechanizm uzgadniania.

Przed odinstalowaniem wykonaj kopię bazy, archiwów źródeł/wydań, kluczy podpisu i potrzebnych rekordów. Klucze podpisu pozostają po odinstalowaniu. Zachowaj ich zaszyfrowaną kopię oraz pliki zarządzane przez operatora. Odinstalowanie usuwa menu, zadania i zwykły schemat modułu, a czyszczenie pakietów współdzielonych zależy od innych zainstalowanych użytkowników. Może przerwać usługę licencji/aktualizacji pakietów już dostarczonych. Zaplanuj ciągłość ich wystawcy przed usunięciem tej usługi sklepu.

Wymaga PrestaShop 1.7.0 lub nowszego oraz PHP 7.1 lub nowszego.