Wirtualne produkty Pro - pliki do pobrania dla każdej kombinacji, wersje i synchronizacja z GitHub

Problem PrestaShop 9, który ten moduł rozwiązuje

W PrestaShop 9 "Produkt wirtualny" i "Produkt z kombinacjami" to wzajemnie wykluczające się typy produktu. Nie stanowi to problemu, dopóki nie sprzedajesz oprogramowania, e-booków, próbek czy licencji w więcej niż jednym wariancie — Standard i Pro, jedno stanowisko i zespół, Windows i macOS — bo w momencie, w którym potrzebujesz kombinacji, wbudowane pole pliku produktu wirtualnego przestaje być dostępne.

Ten moduł zarządza plikami do pobrania poza systemem produktów wirtualnych PrestaShop. Utwórz produkt jako Produkt z kombinacjami, zdefiniuj warianty i wgraj plik do każdego z nich. Każda kombinacja otrzymuje własny plik, własny numer wersji i własny dziennik zmian.

Jedna strona zamiast jednego produktu naraz

Pliki całego katalogu znajdują się na jednym ekranie. Rozwiń produkt, zobacz jego kombinacje, wgraj lub podmień plik, ustaw wersję, wpisz dziennik zmian. Siedem liczników na górze pokazuje stan rzeczy w jednym spojrzeniu — Pliki wirtualne, Produkty, Pliki kombinacji, Proste pliki, Brakujące pliki, Łączna liczba pobrań i Klienci — więc produkt, do którego nigdy nie wgrano pliku, świeci się tam na czerwono, zamiast zostać odkryty przez klienta.

Każdy plik ma też własny limit Pobrań, liczbę Dni ważności i datę wygaśnięcia, więc licencję można ograniczyć w czasie, a nie przekazywać bezterminowo. Działa każdy format do pobrania: ZIP, PDF, MP3, FLAC, EPUB i wszystko inne, co sprzedajesz.

Połącz kombinację z GitHub i przestań wgrywać pliki

Każda kombinacja działa w jednym z dwóch trybów: Prześlij plik albo Repozytorium GitHub. Przełącz ją na GitHub, podaj owner/repo oraz opcjonalnie gałąź lub tag, a jeden przycisk Pobierz / Synchronizuj z GitHub pobierze plik, wersję i dziennik zmian razem — pakując wydanie, wyodrębniając wersję i wczytując tematy ostatnich commitów po stronie serwera, a nie tylko wypełniając pole w przeglądarce.

Repozytoria prywatne są obsługiwane przez Personal Access Token. Ustaw Domyślny GitHub Personal Access Token raz dla całego sklepu i nadpisz go przy produkcie, gdy inne repozytorium wymaga innych danych uwierzytelniających.

Tabela Recent Sync Log (dziennik ostatnich synchronizacji) zapisuje, co faktycznie się stało w każdym przebiegu — produkt, kombinacja, status, komunikat i data — pokazując przejście ze starej wersji na nową albo wprost "no version change", gdy przebieg nie znalazł nic nowego. Nad nią widnieje znacznik czasu Last automatic run (ostatni automatyczny przebieg), więc od razu widzisz, czy zaplanowana synchronizacja rzeczywiście się uruchomiła, czy nie zadziałała ani razu.

Jedna uczciwa uwaga: synchronizacja godzinowa opiera się na systemie zadań cron samego PrestaShop, który wymaga prawdziwego zewnętrznego crona na Twoim serwerze. Dopóki nie zostanie on skonfigurowany, ręczny przycisk Pobierz / Synchronizuj z GitHub wykonuje to samo zadanie na żądanie — a wiersz Last automatic run będzie nadal pokazywał never, co jest dokładnie powodem, dla którego jest wyświetlany.

Powiedz klientom, że jest aktualizacja

Każda kombinacja ma własny przycisk Powiadom klientów, który wysyła e-mail do klientów, którzy kupili ten produkt, z informacją o dostępności nowej wersji. W przypadku wszystkiego, co sprzedaje się jako licencja lub narzędzie, ten jeden przycisk decyduje o różnicy między klientem, który zaktualizuje produkt, a takim, który zapomni, że go posiada.

Klienci dostają porządną sekcję pobrań

Kupujący widzą swoje pliki na swoim koncie i na stronie szczegółów zamówienia, wraz z wersją, do której mają prawo. To zwykłe doświadczenie konta PrestaShop, rozszerzone tak, by objęło pliki przypisane do poszczególnych kombinacji, których rdzeń systemu nie potrafi odwzorować.

Co naprawiła wersja 1.5.x

Wersja 1.5.2 usunęła zestaw rzeczywistych usterek, o których warto wiedzieć, bo są to takie błędy, które potrafią ukrywać się miesiącami.

Pole dziennika zmian nigdy nie mogło zostać zaktualizowane przez synchronizację. Obie ścieżki synchronizacji pomijały changelog w instrukcji UPDATE, więc gdy wiersz kombinacji już istniał, pole zostawało zamrożone na tym, co ostatnio wpisano ręcznie — a żadna ze ścieżek nie pobierała treści dziennika zmian z GitHub po stronie serwera. Synchronizacja pobiera teraz tematy ostatnich commitów wskazanej referencji i zapisuje je w tej samej operacji, zarówno w trybie ręcznym, jak i automatycznym.

Ręczna i automatyczna ścieżka synchronizacji się rozeszły. Ręczny punkt końcowy niezależnie reimplementował wywołania GitHub, obsługę archiwum zip i wyodrębnianie wersji, więc poprawka zastosowana w jednym miejscu po cichu nie działała w drugim. Ręczna ścieżka korzysta teraz ze wspólnej klasy synchronizacji — nadal biorąc repozytorium i referencję z formularza, na który patrzysz, więc wypróbuj przed zapisaniem działa jak dawniej.

Synchronizacja godzinowa zawsze logowała "success" bez żadnych szczegółów, nawet gdy nic się nie zmieniło, co czyniło dziennik bezużytecznym przy odróżnianiu spokojnego przebiegu od cichej awarii. Ponadto świeże instalacje nigdy nie rejestrowały hooka cron — robił to tylko blok samonaprawy na stronie konfiguracji, więc synchronizacja godzinowa nie mogła się uruchomić, dopóki administrator przypadkiem nie otworzył tej strony. Instalacja rejestruje go teraz bezpośrednio.

Jedna rzecz, którą trzeba zaplanować

Ponieważ produkt nie jest oznaczony w PrestaShop jako wirtualny, nadal obowiązuje standardowe wyliczanie kosztów wysyłki. Aby te produkty pozostały wolne od opłat za wysyłkę, przypisz je do przewoźnika z regułą zerowego kosztu / darmowej wysyłki. To jednorazowa czynność konfiguracyjna, a strona konfiguracji modułu mówi o tym wprost, zamiast pozostawiać Cię z tym odkryciem przy rzeczywistym zamówieniu.

Kompatybilność

PrestaShop 1.7, 8 i 9, w ośmiu językach: niderlandzki, angielski, francuski, niemiecki, włoski, polski, hiszpański i turecki. Obsługa multistore. Odinstalowanie usuwa dane modułu oraz zarządzane przez niego pliki wirtualne, o czym potwierdzenie odinstalowania mówi otwarcie — więc zrób wcześniej kopię, jeśli zamierzasz instalować moduł ponownie.

Najczęściej zadawane pytania

Dlaczego potrzebuję tego w PrestaShop 9?

Ponieważ PS 9 czyni typy Produkt wirtualny i Produkt z kombinacjami wzajemnie wykluczającymi się. Jeśli sprzedajesz produkt do pobrania w kilku edycjach lub poziomach, rdzeń systemu nie potrafi przypisać każdemu wariantowi własnego pliku. Ten moduł potrafi.

Czy każda kombinacja może mieć inny plik i wersję?

Tak — własny plik, własny numer wersji i własny dziennik zmian. To właśnie sens tego modułu.

Jak działa synchronizacja z GitHub?

Przełącz kombinację w tryb Repozytorium GitHub, podaj owner/repo oraz opcjonalną gałąź lub tag i naciśnij Pobierz / Synchronizuj z GitHub — pobierze plik, wersję i dziennik zmian w jednym kroku. Repozytoria prywatne działają przez Personal Access Token, ustawiony raz jako domyślny dla sklepu i nadpisywalny przy produkcie. Automatyczna synchronizacja godzinowa wymaga dodatkowo systemu zadań cron PrestaShop uruchamianego prawdziwym cronem na Twoim serwerze.

Czy klienci dowiedzą się, gdy wydam aktualizację?

Tak, jeśli naciśniesz Powiadom klientów przy kombinacji — wyśle e-mail do klientów, którzy kupili ten produkt.

Czy te produkty będą obciążane kosztem wysyłki?

Mogą być, bo PrestaShop nie traktuje ich jako wirtualnych. Przypisz je do przewoźnika z regułą darmowej wysyłki i opłata zniknie.

Jakie formaty plików są obsługiwane?

ZIP, PDF, MP3, FLAC, EPUB i każdy inny format do pobrania.

Jak wykryć produkt, któremu brakuje pliku?

Liczniki na górze strony obejmują pozycję Brakujące pliki, więc luka widoczna jest tam, a nie w reklamacji klienta.

Co się stanie, jeśli odinstaluję moduł?

Dane modułu oraz zarządzane przez niego pliki wirtualne zostaną usunięte — potwierdzenie mówi o tym wprost. Zachowaj kopię wszystkiego, czego jeszcze będziesz potrzebować.