Nowy system modyfikacji XML w PriceWars II 5.2.0

W wersji PriceWars II 5.2.0 wprowadziliśmy nowy system modyfikowania generowanego XML za pomocą funkcji oraz hooków.

To rozwiązanie powstało z myślą o sklepach, które potrzebują większej kontroli nad finalnym plikiem XML — bez konieczności pracy na wewnętrznych obiektach modułu.

Większa kontrola nad finalnym XML

Najważniejsza zmiana polega na tym, że nowy system pozwala modyfikować gotowy fragment XML.

W praktyce oznacza to, że można pracować bezpośrednio na strukturze, która trafi do pliku wynikowego. Dzięki temu łatwiej:

• dodać własny tag,
• usunąć niepotrzebny element,
• zmienić wartość istniejącego pola,
• dopasować XML do wymagań konkretnej porównywarki lub marketplace’u,
• przygotować osobne reguły dla różnych feedów.

To szczególnie przydatne tam, gdzie standardowy XML wymaga drobnych, ale istotnych korekt pod zewnętrzny system.

Prostsze wdrożenia niestandardowe

W starszym systemie modyfikacje opierały się głównie na wewnętrznym obiekcie produktu. Dla prostych zmian było to wystarczające, ale przy bardziej indywidualnych wdrożeniach wymagało znajomości struktury modułu.

Nowy system jest bardziej bezpośredni: otrzymujesz wygenerowany XML i możesz go zmienić przed dodaniem do pliku wynikowego.

Dzięki temu niestandardowe modyfikacje są czytelniejsze, łatwiejsze do testowania i prostsze do utrzymania.

Dwa sposoby rozszerzania działania modułu

Nowy mechanizm obsługuje dwa podejścia.

Pierwsze to funkcje, które można dodać w pliku custom_functions.php. To wygodne rozwiązanie przy prostych zmianach wykonywanych bezpośrednio w sklepie.

Drugie to hooki PrestaShop, które można wykorzystać we własnych modułach. To lepsze podejście przy większych wdrożeniach, integracjach lub rozwiązaniach, które mają być przenoszone między sklepami.

Dzięki temu można dobrać sposób pracy do skali modyfikacji.

Modyfikacja produktu, nagłówka i stopki

Nowy system pozwala wpływać na trzy główne części generowanego XML:

• nagłówek pliku,
• stopkę pliku,
• pojedynczy wpis produktu.

Daje to większą elastyczność niż modyfikowanie tylko danych produktu przed wygenerowaniem XML. Można dopasować zarówno całą strukturę pliku, jak i pojedyncze elementy oferty.

Bezpieczna kontynuacja starszych wdrożeń

Dotychczasowe mechanizmy pricewars2_product oraz actionPricewarsBeforeOutput nadal działają i nie planujemy obecnie ich usuwania.

Oznacza to, że istniejące wdrożenia nie wymagają natychmiastowych zmian po aktualizacji modułu.

Nowy system traktujemy jako zalecany kierunek dla nowych integracji i przyszłych modyfikacji, ponieważ daje większe możliwości oraz lepiej odpowiada na potrzeby niestandardowych feedów XML.

Dla kogo jest ta zmiana?

Nowy system będzie szczególnie przydatny dla sklepów, które:

• korzystają z wielu plików XML,
• przygotowują feedy pod różne marketplace’y,
• potrzebują niestandardowych tagów,
• chcą modyfikować strukturę XML bez zmiany danych produktu w sklepie,
• mają własne moduły lub indywidualne integracje,
• potrzebują większej kontroli nad eksportem danych.

Nowe mechanizmy ułatwią pracę zarówno właścicielom sklepów, jak i developerom odpowiedzialnym za integracje.

Dokumentacja

Szczegółowy opis nowych funkcji, hooków oraz przykłady użycia znajdują się w dokumentacji modułu.

Nowy system modyfikacji XML jest dostępny od wersji PriceWars II 5.2.0.

https://docs.seigi.eu/Price_Wars_II/Zaawansowana_konfiguracja/pshook_custom_functions.html