Globalne atrybuty produktów: konfiguracja i pomoc

Prześlij ZIP w Moduły > "Module Manager" i zainstaluj go. Otwórz "Improve" > Global Attributes > Szablony.

Przygotuj natywne grupy atrybutów i wartości w sekcji "Attributes & Features" PrestaShop. Do pierwszej synchronizacji użyj małej rodziny produktów testowych. Przed zastąpieniem istniejących wariantów wykonaj kopię zapasową bazy danych.

Ten moduł generuje rzeczywiste warianty PrestaShop. Przed zastąpieniem istniejących wariantów sprzedawcy tworzy ich migawkę i może je przywrócić, gdy produkt przestanie być zarządzany przez moduł. Zanim zastosujesz szablon na szeroką skalę, sprawdź wynikowy stan magazynowy, numery referencyjne i ceny na pierwszym produkcie.

Otwórz Global Attributes > Ustawienia > Konfiguracja.

Te wykluczenia obowiązują dodatkowo, poza selektorem produktów danego szablonu. Produkt może pasować do szablonu i nadal być tutaj wykluczony z synchronizacji.

Starszy przełącznik "Dynamic storefront options" nie jest dostępny w tym formularzu konfiguracji. Korzystaj z opisanego poniżej procesu z natywnymi wariantami.

Utwórz szablon i otwórz Konfiguracja.

Przeciągaj znaczniki wybranych grup, aby ustawić ich kolejność. Edytor używa tej kolejności do wygenerowanej struktury opcji i prezentacji na stronie produktu. Selektor grup odczytuje istniejące natywne grupy atrybutów; nie zastępuje zarządzania atrybutami katalogu PrestaShop.

Otwórz Wartości. Wartości każdej wybranej grupy pojawią się w tabeli. Zwykła kolejność początkowa odpowiada kolejności wartości natywnych; użyj kontrolek kolejności w edytorze, gdy potrzebujesz innego porządku.

Ustaw Sufiks referencji grupy dla grupy i Sufiks referencji dla jej wartości. Jeśli nie podasz własnego sufiksu, automatyczny sufiks zostanie wygenerowany z nazwy. Ustaw jedną wartość Domyślny w każdej grupie. Pierwsza wartość jest początkową wartością domyślną.

W Zmiana ceny wybierz procent lub stałą kwotę w wybranej walucie. Nowe reguły wartości mają domyślnie zerowy procent. Stałe kwoty domyślnie używają waluty sklepu, chyba że wybierzesz inną. Przeliczanie walut odbywa się podczas synchronizacji.

Procent to wpływ na cenę obliczany od ceny bazowej. Na przykład reguła 15 procent dodaje 15 procent odpowiedniej podstawy, a stała reguła 20 dodaje przeliczoną kwotę. Wpływy wybranych wartości są sumowane, chyba że nadpisanie dla dokładnego wariantu zastąpi tę sumę.

Możesz wybrać kilka wartości i użyć Ustaw cenę, aby zastosować wspólną zmianę ceny. Następnie sprawdź poszczególne wiersze.

Przed synchronizacją otwórz Warianty.

Dokładne zestawy są identyfikowane przez posortowane natywne identyfikatory atrybutów. Zapisany klucz może wyglądać jak 12-31-44; identyfikuje ten dokładny zestaw wyborów, a nie identyfikator produktu.

Sufiksy numerów referencyjnych są oczyszczane. Przykładowe obsługiwane formy sufiksów to BLK, -XL, .MAT i OAK_120. Przy bazowym numerze referencyjnym produktu CHAIR-A i odpowiednim ciągu sufiksów BLK, XL wynikowa forma to CHAIR-A-BLK-XL. Sufiksy grup oraz każde nadpisanie wariantu również wpływają na końcowy numer referencyjny, dlatego potwierdź go w podglądzie.

Automatyczne skróty obejmują BLACK do BLK, WHITE do WHT, SILVER do SLV, NATURAL do NAT i OAK do OAK.

Limit synchronizacji wynosi 500 wygenerowanych wariantów na produkt. Jeśli przewidywana macierz przekroczy limit, moduł zapisze błąd i pominie generowanie dla tego produktu. Przed ponowną próbą zmniejsz liczbę wybranych grup lub wartości.

Otwórz Produkty. Użyj selektorów produktów i wykluczeń, aby wskazać właściwe pozycje katalogu. Dostępne metody wyboru mogą obejmować wybrane produkty, kategorie, producentów, cechy, atrybuty, stan magazynowy i cenę.

Pusty zapisany selektor obejmuje szeroki zakres kwalifikujących się produktów. Do pierwszego testu jawnie wybierz jeden produkt. Globalne wykluczenia produktów wirtualnych i identyfikatorów nadal obowiązują.

W konfiguracji deweloperskiej opartej na kategoriach dane selektora mogą mieć następującą postać:

{
  "products":{
    "groups":[{"include":{"method":"by_category","values":[3,8]}}],
    "excludes":[{"method":"specific","values":[42]}]
  }
}

Obejmuje to kategorie 3 i 8 z wykluczeniem produktu 42. Zastąp przykładowe identyfikatory i potwierdź podgląd pasujących produktów zamiast bezpośrednio edytować zapisany JSON.

Jeśli szablony się nakładają, sprawdź informacje o kierowaniu i przypisaniu. Jeden faktycznie nadrzędny szablon kontroluje strukturę wygenerowanych wariantów produktu; nie zakładaj, że nakładające się szablony zostaną połączone.

Zastępowanie istniejących wariantów jest włączone dla szablonów grupowanych. Jest to wewnętrzne zachowanie szablonu, a nie zwykły przełącznik w edytorze grupowanym. Moduł zachowuje migawkę, aby móc przywrócić produkt, gdy przestanie nim zarządzać.

Zapisz szablon. Moduł umieści synchronizację w kolejce. Strona administracyjna może przetwarzać zadanie przez AJAX, dopóki pozostaje otwarta. Obserwuj panel synchronizacji, aby śledzić postęp oraz liczby utworzonych, odświeżonych, usuniętych, pominiętych i błędnych pozycji.

Nowszy zapis może zastąpić starsze zadanie w kolejce. Jeśli panel zgłosi, że zadanie zostało zastąpione, śledź najnowsze zadanie zamiast ponawiać to nieaktualne.

Aby przetwarzać w tle po zamknięciu strony, skopiuj URL cron z Ustawienia > Konfiguracja > Synchronizacja w tle do harmonogramu zadań hostingu. Użyj wygenerowanego URL, ponieważ jego trasa i token zależą od sklepu.

Odpowiednik bez przepisywania URL ma następującą postać:

https://yourshop.example/index.php?fc=module&module=mprglobalattributes&controller=cron&token=YOUR_TOKEN&jobs=3&batch=5

Punkt końcowy zwraca JSON. Poprawna odpowiedź zawiera success, processed_jobs i results. Nieprawidłowy token zwraca HTTP 403. Panel przetwarzania w tle pokazuje Ostatnie wywołanie, Ostatni sukces, Łącznie wywołań, Zadania przetworzone przy ostatnim wywołaniu, Zadania oczekujące i ewentualny Ostatni błąd. Działające wywołanie cron nie oznacza, że zakończono przetwarzanie każdego produktu w kolejce; sprawdź również zadania oczekujące.

Po synchronizacji otwórz produkt docelowy w panelu administracyjnym. Ostrzeżenie o zarządzanych wariantach wskazuje, że Global Attributes kontroluje jego warianty. Zabezpieczenia tras administracyjnych uniemożliwiają ręczne zmiany wariantów, dopóki produkt jest zarządzany.

W witrynie sklepu sprawdź kolejność grup, wybrane wartości domyślne, dostępne warianty, wyświetlaną cenę, numer referencyjny, zachowanie stanów magazynowych i dodawanie do koszyka. Są to natywne warianty PrestaShop, a nie osobna ścieżka personalizacji koszyka.

Jeśli występują wiersze wariantów modułu, CSS motywu może je wskazywać tak:

.mpr-ga-front-option { margin-bottom: 1rem; }
.mpr-ga-front-choice-list { display: flex; flex-wrap: wrap; gap: .5rem; }
.mpr-ga-front-choice.is-disabled { cursor: not-allowed; opacity: .45; }

Aby wrócić do ręcznego zarządzania wariantami, usuń produkt z faktycznych produktów docelowych szablonu i pozwól synchronizacji zakończyć przywracanie jego stanu. Sprawdź przywrócenie przed ręczną edycją wariantów.

Jeśli żadne produkty nie są przetwarzane, sprawdź ustawienie Aktywny szablonu, zapisany selektor produktów, globalne wykluczenia i przypisanie szablonu. Produkty wirtualne są domyślnie wykluczone.

Jeśli zadanie pozostaje oczekujące, pozostaw edytor otwarty, aby je przetworzyć, lub sprawdź URL cron i status jego ostatniego wywołania. W przypadku niepowodzenia przeczytaj zgłoszony błąd przed ponownym zapisaniem. Macierz powyżej 500 wymaga mniejszego zestawu opcji.

Jeśli ceny różnią się od zamierzonej kwoty, sprawdź, czy reguła jest procentowa, czy kwotowa, jej walutę i ewentualne nadpisanie dokładnego wariantu. Podgląd służy do potwierdzenia ostatecznego wyboru reguły przed synchronizacją na szeroką skalę.

Jeśli ręczne zmiany są blokowane, sprawdź, czy produkt nadal jest przypisany do szablonu. Nie omijaj zabezpieczenia: następna synchronizacja może nadpisać bezpośrednie zmiany.

Otwórz Ustawienia > "Integrity", aby sprawdzić tabele modułu i instalację. Duże natywne macierze nadal tworzą rzeczywiste warianty i wymagają planowania katalogu; moduł nie eliminuje związanego z tym obciążenia.

Wykonaj kopię zapasową bazy danych i poczekaj na zakończenie aktywnych zadań. Odinstalowanie najpierw wywołuje usługę przywracającą stan zarządzanych produktów, a następnie usuwa pozycje menu modułu, preferencje, konfigurację i schemat modułu. Po odinstalowaniu sprawdź reprezentatywne produkty, aby potwierdzić przywrócenie ich oryginalnych wariantów i stanów magazynowych.

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.