Drop Shipping - wtyczka dla aplikacji "Sklep"

Instrukcje dotyczące korzystania z wtyczki

Ta wtyczka pomaga łatwo importować produkty z cenników XML do sklepu.

Profile

Wtyczka obsługuje nieograniczoną liczbę profili z niezależną konfiguracją. Dodanie nowego profilu jest bardzo proste - wystarczy kliknąć zakładkę ze znakiem plus w ustawieniach wtyczki:

Usunięcie profilu jest również bardzo proste - wystarczy kliknąć odpowiedni przycisk w ustawieniach wtyczki. Należy pamiętać, że tylko ręcznie dodane profile mogą zostać usunięte, domyślny profil zawsze pozostanie:

Plik

Wtyczka obsługuje 3 podstawowe sposoby przesyłania pliku XML, z którego będą importowane produkty:

• Bezpośredni link - umożliwia przesłanie dowolnego pliku XML poprzez określenie bezpośredniego linku do niego za pośrednictwem http/https/ftp. Obsługiwana jest podstawowa autoryzacja http (basic http auth) i autoryzacja FTP:

  

  
  

• Pobranie z komputera - umożliwia pobranie dowolnego pliku z komputera:

  

  
  

• Wybór pliku z serwera - umożliwia wybór pliku XML z bieżącego serwera, na którym znajduje się instalacja Web Systems Pro + Sklep. W takim przypadku plik musi zostać przesłany na serwer, gdzieś w folderze wa-data (względem folderu głównego witryny):

  

Uwaga - plik musi zostać przesłany wyłącznie w katalogu wa-data lub dowolnym jego podkatalogu. W chmurze plik można przesłać za pośrednictwem menedżera plików aplikacji "Witryna".

Zgodność

Wtyczka "Drop Shipping" oferuje bardzo innowacyjną metodę importu katalogu produktów, po wgraniu pliku XML musimy określić zgodność parametrów z pliku, z parametrami w sklepie. Innymi słowy, musimy określić, co i gdzie należy przesłać.

Ustawianie zgodności odbywa się w "Menedżerze zgodności" wtyczki, który otwiera się, klikając przycisk "Ustaw zgodność" pod opcjami przesyłania plików:

Po kliknięciu pojawi się okno dialogowe. Przy pierwszym kliknięciu wtyczka wygeneruje ogólny schemat produktu z pliku, który będzie zawierał wszystkie unikalne tagi i atrybuty z pliku. Pewnego rodzaju mapa pliku. Generowanie schematu może nastąpić szybko lub zająć kilka minut, w zależności od rozmiaru pliku.

Końcowym rezultatem będzie coś podobnego do tego:

Po utworzeniu schematu należy określić typy parametrów. Najpierw wybieramy podstawowe typy: Produkt, Kategoria:

Na podstawie powyższego przykładu określiliśmy, że tag <cat w pliku reprezentuje kategorię, a tag <o reprezentuje produkt:

Oznacza to, że cała zawartość tych tagów będzie traktowana jako potencjalne parametry z informacjami o produktach i/lub kategoriach.

Następnie konieczne jest wybranie zgodności parametrów z pliku parametrów (nazwa, cena, obrazy, cechy itp.). Każdy produkt musi koniecznie posiadać jeden unikalny parametr, który będzie zewnętrznym identyfikatorem (Zewnętrzny ID):

Minimalna konfiguracja do importowania produktów: Zewnętrzny ID, Nazwa.

Przykłady i zalecenia dotyczące generowania plików XML do importu

Ta wtyczka umożliwia importowanie produktów i kategorii z różnych plików XML, z różnymi stylami reprezentacji danych. Ponieważ XML jest rozszerzalnym językiem znaczników, istnieje nieskończona liczba odmian struktur cenników.

Z tego powodu nie możemy zagwarantować, że wtyczka będzie w stanie zaimportować katalog z uwzględnieniem dokładnie tych pomysłów, które miał na myśli autor pliku (dotyczy to złożonych struktur XML). Jednak w 99% przypadków wtyczce udaje się poprawnie odczytać plik i wyodrębnić dane.

Podstawowe zasady tworzenia dokumentów XML

Każdy dokument XML musi zawierać opis wersji XML i typ dokumentu (DOCTYPE).
Cała zawartość dokumentu musi być zawarta w jednym znaczniku głównym.
Wszystkie znaki specjalne w tekście muszą być reprezentowane jako kody HTML.

Poniżej znajdują się różne przykłady plików XML do poprawnego importu katalogu produktów ze wszystkimi danymi i kategoryzacją, a także przykłady plików z produktami w trybie wyboru cech.

Import kategorii

Wtyczka obsługuje 3 sposoby odczytu struktury kategorii z plików XML:

Strumieniowy - jest to zalecany sposób wyświetlania kategorii w pliku XML, gdy powinny być one wymienione niezależnie od siebie.

Plik musi spełniać następujące wymagania:

Każda kategoria jest reprezentowana przez osobny tag
Wszystkie tagi kategorii są zlokalizowane niezależnie od siebie.
Każda kategoria w pliku musi zawierać minimum: ID zewnętrzne i nazwę.
Tagi podkategorii muszą zawierać ID zewnętrzne kategorii nadrzędnej.
Kategorie nadrzędne muszą być zawsze umieszczane przed kategoriami podrzędnymi.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <categories>
    <category id="123">Salon</category>
    <category id="124" parentId="123">Meble pod telewizor</category>
    <category id="125" parentId="124">Stoliki pod telewizor</category>

    <category id="126">Kuchnia</category>
    <category id="127" parentId="126">Lodówki</category>
    <category id="128" parentId="127">Wbudowane</category>
  </categories>
</feed>

Rekursywny - ta metoda zakłada, że kategorie w pliku XML są reprezentowane jako zagnieżdżona struktura tagów.

Plik musi być zgodny z następującymi zasadami:

Każda kategoria nadrzędna jest reprezentowana przez oddzielny tag
Każda kategoria musi mieć co najmniej: nazwę i ID zewnętrzne.
Podkategorie muszą być zagnieżdżone w kategorii głównej.
Nie jest konieczne określanie ID zewnętrznego kategorii nadrzędnej dla kategorii podrzędnych.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<price>
  <categories>
    <category id="1181" name="Laptopy, tablety">
      <subcategory id="1191" name="Laptopy"/>
      <subcategory id="1211" name="Akcesoria do laptopów">
        <subcategory id="1213" name="Zasilacze"/>
        <subcategory id="1471" name="Podstawki pod laptopa"/>
        <subcategory id="1466" name="Myszy"/>
        <subcategory id="1228" name="Huby USB"/>
     </subcategory>

      <subcategory id="1192" name="Tablety"/>
        <subcategory id="7981" name="Akcesoria do tabletów">
        <subcategory id="7982" name="Zasilacze"/>
        <subcategory id="8136" name="Podstawka pod tablet"/>
      </subcategory>

      <subcategory id="1194" name="Czytniki e-booków"/>
      <subcategory id="1107" name="Konsole do gier"/>
    </category>
  </categories>
</price>

Zwykły - kategorie są określone w tagu produktu, jako nazwy.

Plik musi być zgodny z następującymi zasadami:

Kategorie są określone w głównym tagu produktu
Tag kategorii musi zawierać tylko nazwę
Kategorie są określane jedna po drugiej zgodnie z poziomem zagnieżdżenia.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product prodID="1">
        <categories>
          <category1>Meble</category1>
          <category2>Kuchnia</category2>
          <category3>Kuchenki</category3>
        </categories>
        <name>Koszulka</name>
    </product>
</products>

Należy zwrócić uwagę: główne tagi produktów i kategorii nie mają ograniczeń co do nazwy, głębokości zagnieżdżenia lub ilości i nie muszą występować jeden po drugim. Jeśli w jednym pliku kategorie lub produkty są rozmieszczone za pomocą różnych tagów (na przykład: dla kategorii tag: category; dla podkategorii tag: subcategory), można je załadować bez problemów, ustawiając każdy z tagów typu "Główny -> Kategoria" w menedżerze zgodności.

Import produktów

Wtyczka jest w stanie importować produkty z dowolnych tagów w pliku. Produkty mogą być ładowane zarówno w trybie zwykłym, jak i w trybie wyboru cech, w zależności od stylu tworzenia pliku XML.

Aby zaimportować produkty, plik musi spełniać następujące wymagania:

• Każdy produkt musi być określony w osobnym tagu.
• Wszystkie dane muszą być określone w głównym tagu produktu.
• Wszystkie dane produktu muszą być określone w osobnych tagach i/lub atrybutach.
• Każdy produkt musi mieć ID zewnętrzne.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<products>
   <product id="1">
     <price>934</price>
     <sku>45554</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>15</quantity>
     <description>test</description>
     <name>Koszulka</name>
   </product>

   <product id="2">
     <price>1234</price>
     <sku>45556</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>8</quantity>
     <description>test</description>
     <name>Koszulka</name>
   </product>

   <product id="3">
     <price>1532</price>
     <sku>45555</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>3</quantity>
     <description>test</description>
     <name>Koszulka</name>
   </product>
</products>

Istnieją 2 opcje importowania produktów w trybie wyboru cech:

Jeden tag = jeden wariant zakupu - metoda ta zakłada, że każdy wariant zakupu zostanie opisany w pliku w osobnym tagu (jako osobny produkt). Aby te warianty zakupu mogły zostać połączone w jeden produkt, muszą mieć prawie taką samą strukturę, z pewnymi różnicami:

• Wszystkie warianty jednego produktu powinny mieć wspólny parametr (ID grupy)
• Każdy wariant zakupu musi zawierać informacje o cechach, z których należy utworzyć artykuł.
• Wartości cech, na podstawie których zostaną utworzone artykuły, muszą być różne dla każdego wariantu zakupu.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<products>
   <product id="1" group_id="901">
     <price>934</price>
     <sku>45554</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>15</quantity>
     <description>test</description>
     <name>Koszulka</name>
     <size>S</size>
   </product>

   <product id="2" group_id="901">
     <price>1234</price>
     <sku>45556</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>8</quantity>
     <description>test</description>
     <name>Koszulka</name>
     <size>M</size>
   </product>

   <product id="3" group_id="901">
     <price>1532</price>
     <sku>45555</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>3</quantity>
     <description>test</description>
     <name>Koszulka</name>
     <size>L</size>
   </product>
</products>

Jeden tag = jeden produkt (z wieloma wariantami zakupu) - ta metoda jest prostsza i bardziej ekonomiczna pod względem rozmiaru pliku, ale ma pewną wadę: obecnie cena i dostępność wszystkich wariantów może być taka sama.

W przypadku tej metody należy przestrzegać następujących zasad:

• Każdy produkt jest reprezentowany przez oddzielny tag
• Wszystkie opcje zakupu są opisane w osobnych tagach w ramach każdego produktu.

Przykład:

<?xml version="1.0" encoding="UTF-8"?>
<products>
   <product id="100">
     <price>1934</price>
     <sku>45455</sku>
     <image>https://site.com/image.jpg</image>
     <quantity>25</quantity>
     <description>Pełny opis produktu</description>
     <short>Krótki opis produktu</short>
     <name>Czerwona koszulka</name>

     <sizes>
      <size>S</size>
      <size>M</size>
      <size>L</size>
      <size>XL</size>
     </sizes>

     <color>Czerwony</color>
   </product>
</products>

1.7.4.1.wsp 1 lutego 2024

• Dodanie języka polskiego.

1.7.4 29 listopada 2023

• Wyeliminowano wyjście błędów 500
• Usunięto błąd znikania kodów artykułów
• Inne drobne poprawki

1.7.3 7 listopada 2023

• Rozwiązano problem z importowaniem plików z komputera

1.7.2 1 grudnia 2021

• Naprawiono błąd podczas obsługi plików z przestrzenią nazw

1.7.1 4 sierpnia 2020

• Krytyczna poprawka

1.7.0 31 lipca 2020

• Krytyczna poprawka

1.6.9 31 lipca 2020

• Naprawiono problem z instalacją RRC

1.6.8 24 lipca 2020

• Poprawiono funkcjonalność importowania wartości do dodatkowych pól wtyczek i aplikacji

1.6.7 19 czerwca 2020

• Naprawiono błąd ładowania obrazów ze znakiem zapytania w linku

1.6.6 18 czerwca 2020

• Naprawiono błąd wartości domyślnej dla przyrostowej marży

1.6.5 5 czerwca 2020

• Naprawiono błąd stopniowej marży

1.6.4 19 lipca 2019

• Naprawiono błąd dostępu do pliku przez login i hasło

1.6.3 5 lipca 2019

• Naprawiono błąd z nieprawidłowym wyświetlaniem menedżera dopasowań, gdy atrybuty zawierają kod HTML

1.6.2 1 lipca 2019

• Naprawiono błąd odczytu linków z loginem i hasłem

1.6.1 29 czerwca 2019

• Możliwość formowania nazw produktów z dowolnych tagów
• Naprawiono błędy importowania obrazów

1.6.0 12 czerwca 2019

• Błądy z cenami i zdjęciami
• Zaimplementowano ładowanie cech ze złożonych struktur tagów
• Zaimplementowano pobieranie opcji zakupu z kompleksowych struktur w ramach jednego tagu produktu (tryb opcji zakupu)
• Zmieniono projekt i kolorystykę (eksperymentalnie)
• Inne drobne ulepszenia

1.5.2 25 lutego 2019

• Aktualizacja systemu

1.5.1 18 lutego 2019

• Zmiany systemowe

1.5 14 lutego 2019

• Zoptymalizowany proces importu towarów w trybie wyboru cech
• Ulepszone przetwarzanie obrazu
• Dodano załączanie obrazu do artykułu w trybie wyboru funkcji

1.4 31 stycznia 2019

• Poprawiono wyświetlanie dopasowań jeśli tagi mają wiele atrybutów
• Dodano możliwość importowania struktury kategorii określonej rekurencyjnie lub jako tagi z nazwami kategorii w ramach tagu produktu
• Inne drobne ulepszenia

1.3 11 grudnia 2018

• Naprawiono błąd odczytu znacznika czasu
• Dodano możliwość odczytu linków do obrazów oddzielonych przecinkiem (lub innym znakiem)

1.2 28 listopada 2018

• Poprawiono zaokrąglanie cen
• Poprawiono zmianę Protokołu w linkach do obrazów

1.1 7 listopada 2018

• Naprawiono błąd podczas tworzenia schematu dopasowania
• Naprawiono błąd usuwania plików pobranych z komputera

1 listopada 2018

• Wydanie pierwszej wersji.