Import / eksport

• Komunikacja możliwa jest w obie strony, tzn. możliwy jest zarówno eksport danych ze sklepu do pliku CSV (który można zapisać na lokalnym dysku i następnie wczytać np. do popularnego arkusza kalkulacyjnego), jak i import danych z przygotowanego pliku CSV do bazy danych sklepu.
• Import pliku do sklepu wywołuje skutek w postaci zmian w bazie danych sklepu – po imporcie zmianie mogą ulec parametry produktów, w tym ich ceny.

Plik w formacie CSV jest plikiem tekstowym, w którym w każdym wierszu podawanych jest kilka wartości oddzielonych separatorem (np. przecinkiem czy średnikiem). Każda taka wartość w wierszu odpowiada pewnemu parametrowi, np. nazwie produktu, cenie, stawce VAT. Kolejny wiersz pliku zawiera kolejne dane zgodne z przyjętym schematem (np. wartości dotyczące kolejnego produktu). Wyjątek stanowi pierwszy wiersz pliku, który nie zawiera wartości, a jedynie nagłówek tekstowy, w którym wypisane są kolejne nazwy parametrów.

Pliki w formacie CSV są obsługiwane między innymi przez popularne arkusze kalkulacyjne, a opisany format pliku najłatwiej wyobrazić sobie właśnie w postaci arkusza zawierającego kolumny (w pliku: wartości oddzielone separatorem) oraz wiersze (np. kolejne produkty).

Import produktów

Sekcja Import/eksport -> Import produktów służy do wczytywania do bazy danych sklepu przygotowanego pliku w formacie CSV, który znajduje się na naszym lokalnym dysku.

Plik taki musi spełniać opisane wcześniej wymogi, czyli powinien zawierać w kolejnych wierszach informacje o kolejnych produktach. W każdym wierszu takiego pliku muszą być zapisane parametry produktu – każdy taki parametr oddzielony jest od kolejnego znakiem separatora (np. przecinkiem czy tabulatorem).

Przed wykonaniem importu możliwe jest zadanie parametrów tej operacji.

Konfiguracja importu obejmuje trzy kwestie:

• Mapowanie kolumn – ustalenie znaczenia parametrów zapisanych w pliku importu, czyli przypisanie odpowiednich „kolumn” znajdujących się w pliku do odpowiednich parametrów produktów w bazie danych sklepu
• Parametry importu – ustalenie, jakie operacje zostaną wykonane podczas wczytywania danych
• Ustawienia pliku – ustawienie parametrów pliku (kodowanie i separatory tekstu)

• Administrator może skonfigurować import dokonując ustaleń dla wszystkich trzech wyżej wymienionych kwestii.
• Każda dokonana parametryzacja importu może zostać zapisana w systemie pod zadaną nazwą, dzięki czemu administrator przed dokonaniem importu może wczytać wybraną, zapisaną wcześniej konfigurację.
• Ponieważ w systemie może istnieć wiele zapisanych konfiguracji importu, administrator może w łatwy sposób dokonywać importu plików o różnych formatach, które zostały zapisane w systemie.

Konfiguracja importu i zapisanie takiej konfiguracji w systemie możliwe jest w sekcji Import/Eksport -> Konfiguracja importu produktów, która została omówiona w kolejnym rozdziale instrukcji. Oprócz zapisanych przez administratora konfiguracji importu w systemie zawsze istnieje konfiguracja standardowa zapisana pod nazwą [standardowa].

Po kliknięciu w sekcję Import/Export -> Import produktów na ekranie wyświetla się formularz z parametrami importu. Formularz ten podzielony jest na 3 sekcje: Plik importu, Określ parametry importu, Ustawienia pliku.

W sekcji Plik importu wskazujemy lokalizację pliku na lokalnym dysku, który posłuży do wykonania importu. Wybór dokonany w polu Konfiguracji importu wczytuje zapisaną wcześniej konfigurację importu (w związku z czym zmieniają się pola w formularzach z sekcji Określ parametry importu, Ustawienia pliku). Jeżeli zaznaczymy checkbox Wykonaj import testowy (bez zapisu do bazy danych), wówczas po zatwierdzeniu wykonania importu system dokona wyłącznie sprawdzenia poprawności pliku, ale żadne dane nie zostaną zapisane do bazy danych.

W wyświetlonych poniżej sekcjach: Określ parametry importu, Ustawienia pliku możemy w ramach wybranej konfiguracji importu zmienić wybrane ustawienia dla konkretnej pojedynczej operacji importu.

W tym miejscu nie ma jednak możliwości zmiany mapowania kolumn, która to operacja jest możliwa wyłącznie w sekcji Import/Eksport -> Konfiguracja importu produktów. Formularze z sekcji Określ parametry importu oraz Ustawienia pliku są identyczne z ich odpowiednikami z sekcji Import/Eksport -> Konfiguracja import produktów, dlatego w celu zapoznania się ze znaczeniami pól w tych formularzach prosimy o przejście do lektury sekcji konfiguracji importu.

Na dole ekranu zamieszczone są 2 przyciski: Pobierz pola importu oraz Wykonaj import.

Kliknięcie w pierwszy z nich pobiera wzorcowy plik zawierający 1 wiersz nagłówkowy, który zawiera parametry oddzielone od siebie separatorami. Wykaz parametrów na liście jest zgodny z wybraną konfiguracją importu. Plik taki można pobrać i wczytać np. do arkusza kalkulacyjnego tworząc szablon zawierający kolumny zgodne z wybraną konfiguracją importu.

Kliknięcie w przycisk Wykonaj import inicjuje proces importu – kolejne wiersze z pliku będą odczytywane, a odczytane dane będą zapisywane w bazie danych zgodnie ze zdefiniowaną konfiguracją importu.

Konfiguracja importu produktów

Zgodnie z opisem zawartym w poprzednim dziale konfiguracja importu obejmuje trzy kwestie:

• Mapowanie kolumn – ustalenie znaczenia parametrów zapisanych w pliku importu, czyli przypisanie odpowiednich „kolumn” znajdujących się w pliku do odpowiednich parametrów produktów w bazie danych sklepu
• Parametry importu – ustalenie, jakie operacje zostaną wykonane podczas wczytywania danych
• Ustawienia pliku – ustawienie parametrów pliku (kodowanie i separatory tekstu)

Zostaną one teraz opisane szczegółowo.

Po kliknięciu w pozycję menu Import/Eksport -> Konfiguracja importu produktów na ekranie wyświetla się lista zapisanych konfiguracji. Dla każdej pozycji na liście można wykonać następujące operacje: Edytuj, Usuń oraz Pobierz pola importu. Wybór pobrania pól importu zapisuje na lokalnym dysku wzorcowy plik zawierający 1 wiersz nagłówkowy z parametrami, które oddzielone są od siebie separatorami. Wykaz parametrów na liście jest zgodny z wybraną konfiguracją importu. Plik taki można pobrać i wczytać np. do arkusza kalkulacyjnego tworząc szablon zawierający kolumny zgodne z wybraną konfiguracją importu. Na liście zapisanych konfiguracji zawsze widnieje pozycja [standardowa], której nie można edytować w zakresie mapowania kolumn. Pozycji tej nie można również usunąć z listy.

Formularz edycji konfiguracji jest analogiczny do formularza dodawania nowej konfiguracji, dlatego obie te funkcjonalności zostaną omówione wspólnie.

Aby dodać nową konfigurację należy kliknąć w przycisk Dodaj konfigurację importu, który dostępny jest na samej górze ekranu. W nowym okienku pojawia się formularz, w którym należy wskazać Plik importu, który zostanie odczytany jako wzorzec. Jednocześnie można również zadać parametry: Kodowanie znaków, Separator kolumn, Separator tekstu (omówione w dalszej części opisu). Po wskazaniu ścieżki do pliku należy kliknąć Zatwierdź.

System odczyta nagłówek pliku importu (parametry), a następnie wyświetli formularz dodawania/edycji konfiguracji importu. U góry ekranu formularza widnieje pole Nazwa konfiguracji – jest to nazwa, która będzie wyświetlana administratorowi podczas wybierania zapisanej konfiguracji przed wykonaniem importu. Dalsza część formularza dodawania/edycji konfiguracji podzielona jest na 2 zakładki: Parametry importu oraz Mapowanie kolumn. Poniżej zostały opisane znaczenia poszczególnych pól formularza.

Zakładka: Parametry importu

Zakładka: Mapowanie kolumn

Kliknięcie przycisku Zatwierdź dopisuje zapisaną konfigurację na liście. Zapisaną konfigurację można edytować w pełnym zakresie, przy edycji nie jest jednak dostępne ponowne wczytanie wzorca pliku importu.

Eksport produktów

• Wygenerowany plik zawiera wszystkie produkty z bazy danych sklepu.
• W każdym wierszu (dla każdego produktu) podawane są następujące informacje: Grupa towarowa, Indeks towarowy, Nazwa produktu, Jednostka miary, Opis skrócony, Opis pełny, Ilość, Dokładność zakupu, Serie, Połączone, Warianty, Podprodukty, Stawka VAT, Stara cena (wspólna dla wszystkich poziomów cenowych) oraz ceny dla wszystkich istniejących poziomów cenowych oraz wartości słowników dla wszystkich istniejących słowników w sklepie. Są to więc wszystkie wartości, które występują przy parametryzacji mapowania kolumn dla pliku importu.

Przed wykonaniem eksportu należy wypełnić formularz, który zawiera następujące pola:

• Ceny w pliku eksportu to – ceny netto / ceny brutto – w zależności od dokonanego wyboru w pliku zostaną zapisane wyłącznie ceny netto albo ceny brutto
• Rozmiar pojedynczego pakietu (liczba elementów) – określa liczbę produktów eksportowanych w jednym pakiecie. Wykonywanie eksportu do pliku podzielone jest na pakiety zawierające określoną liczbę produktów. Ustawienie dużego rozmiaru pakietu może powodować błędy wynikające ze zbyt małej wydajności serwera. Rozmiar pakietu należy więc ustawić na niższą wartość w przypadku korzystania z mniej wydajnych serwerów. W przypadku wystąpienia błędu wynikającego z wydajności, plik importu nie zostanie wygenerowany.
• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku eksportu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "Grupa towarowa".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Separator grup towarowych (separator poszczególnych grup towarowych w ścieżce) – domyślnie jest to znak |. Separator ten ma znaczenie w przypadku, gdy grupy towarowe w systemie sklepu tworzą wiele poziomów (hierarchię). W takim przypadku w bazie danych występują grupy główne oraz grupy podrzędne (na wielu poziomach).
  Np. może istnieć grupa główna „Sprzęt AGD” (poziom 1), do której podpięta jest podgrupa „Piekarniki” (poziom 2), w obrębie której istnieje kolejna podgrupa „Piekarniki elektryczne” (poziom 3). Plik eksportu w polu odpowiadającym grupie towarowej będzie zawierać pełną informację o grupie, do której przypisany jest produkt, z uwzględnieniem całej hierarchii danej grupy. W podanym przypadku, gdy produkt jest przypisany do podgrupy „Piekarniki elektryczne” (na ostatnim, trzecim poziomie), parametr odpowiadający grupie towarowej będzie mieć postać: Sprzęt AGD|Piekarniki|Piekarniki elektryczne. Jak widać, kolejne poziomy podgrup będą oddzielone opisywanym separatorem.
• Separator ścieżek grup towarowych – domyślnie jest to znak przecinka. Istnieje możliwość przypisania pojedynczego produktu do kilku grup towarowych jednocześnie. W takim przypadku w pliku eksportu w polu odpowiadającym grupie towarowej będzie podanych kilka wartości oddzielonych opisywanym separatorem. Np. jeżeli produkt jest przypisany do 2 grup towarowych: Sprzęt AGD|Piekarniki| Piekarniki elektryczne oraz do grupy Zestawy czyszczące w polu tym pojawi się: Sprzęt AGD|Piekarniki|Piekarniki elektryczne,Zestawy czyszczące.
• Separator elementów (separator słów w słownikach, serii) – domyślnie jest to znak przecinka. Plik importu/eksportu może zawierać pola odpowiadające słownikom oraz seriom, do których produkt jest przypisany. Jeżeli produkt posiada wpisanych kilka słów w danym słowniku bądź jest przypisany do kilku serii jednocześnie, wówczas w polu odpowiedzialnym za dany słownik lub w polu odpowiadającym przypisaniu do serii znajdzie się kilka wartości tekstowych, które będą oddzielone omawianym separatorem (domyślnie przecinkiem). Jeżeli w systemie istnieje np. słownik o nazwie „Przeznaczenie”, a dany produkt w tym słowniku będzie miał wpisane wartości: „Dla domu”, „Dla biura”, wówczas w polu odpowiadającym słownikowi Przeznaczenie będzie zapisana wartość Dla domu, Dla biura.
• Eksportuj opisy (Tak/Nie)

Przycisk Eksportuj plik, który dostępny jest pod formularzem, rozpoczyna pobieranie pliku eksportu, który można zapisać na lokalnym dysku.

Import cen

Plik importu jest plikiem w formacie CSV i zawiera on następujące informacje: Indeks towarowy, Dostępność/Ilość, Stawka VAT, Stara cena oraz kolejno ceny i ceny promocyjne dla wszystkich poziomów cenowych, które istnieją w bazie danych sklepu. Wzór pliku (plik zawierający nagłówek z parametrami) może zostać pobrany po kliknięciu w przycisk Pobierz pola importu, który znajduje się pod formularzem parametrów importu.

Identyfikatorem produktu jest jego indeks towarowy. Jest to jedyny wyróżnik produktu stosowany przez oprogramowanie sklepu.

Po wybraniu opcji Import cen na ekranie wyświetla się formularz z następującymi polami:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to,że każdy parametr w pliku ma być otoczony tym znakiem, np. "Stawka VAT".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Rozmiar pojedynczego pakietu (liczba elementów) – import pliku podzielony jest na pakiety zawierające określoną liczbę wierszy (informacji o cenach dla kolejnych produktów). W przypadku wykrycia błędu w pliku podczas wykonywania importu, system przerywa dalszy import. Nie oznacza to jednak, że żaden produkt w takim przypadku nie zostanie zaktualizowany w bazie danych. Jeżeli import zostanie przerwany, wówczas do bazy danych trafią wszystkie dane zawarte w dotychczas poprawnie zaimportowanych pełnych pakietach. Jeżeli plik importu zawiera przykładowo 1500 pozycji (informacji o cenach dla 1500 produktów), a parametr Rozmiar pojedynczego pakietu jest ustawiony na 100, wówczas operacja importu będzie podzielona na 15 pakietów po 100 pozycji każdy. Jeżeli błąd podczas importu wystąpi przy imporcie 531 pozycji (wiersza z pliku), wówczas dalszy import zostanie przerwany, ale pierwszych 5 pakietów (500 informacji o cenach) zostanie poprawnie zapisanych w bazie danych.
• Zakres importu:

• Tylko stany magazynowe / dostępność – import aktualizuje wyłącznie informacje o stanach magazynowych lub dostępności produktów (nie aktualizuje cen)
• Stany magazynowe / dostępność oraz ceny – import aktualizuje informacje o stanach magazynowych lub dostępności produktów oraz informacje o cenach

• Ceny w pliku importu to – ceny netto / ceny brutto – w zależności od dokonanego wyboru moduł importu dokona stosownych przeliczeń cen
• Zakres importu:

• Aktualizuj wszystkie produkty (niezdefiniowane w pliku importu zostaną oznaczone jako niedostępne) – system aktualizuje wszystkie produkty, których indeksy towarowe występują w pliku importu cen. Pozostałe produkty (których indeksy towarowe nie występują w pliku importu cen) są oznaczane jako niedostępne dla kupujących
• Aktualizuj tylko produkty zdefiniowane w pliku importu – system aktualizuje tylko produkty, których indeksy towarowe występują w pliku importu. Pozostałe produkty (których indeksy towarowe nie występują w pliku importu cen) pozostają niezmienione

• Plik importu – pole służące do wskazania ścieżki dostępu do pliku importu cen na dysku lokalnym

Przycisk Wykonaj import rozpoczyna proces importu.

Eksport cen

• Wygenerowany plik zawiera ceny i oznaczenia, czy dany produkt jest dostępny dla kupujących.
• W pliku zapisana jest informacja dla wszystkich produktów z bazy danych sklepu.
• Jeżeli Twój sklep posiada obsługę stanów magazynowych, zamiast oznaczenia, czy dany produkt jest dostępny, eksportowana jest ilość produktów, która aktualnie znajduje się na stanie.

Plik eksportu w każdym wierszu zawiera następujące informacje: Indeks towarowy, Dostępność/Ilość, Stawka VAT oraz kolejno ceny (zwykłe) dla wszystkich poziomów cenowych, które istnieją w bazie danych sklepu. W zależności od wyboru administratora, w pliku mogą się znaleźć również informacje o starej cenie (wspólnej dla wszystkich poziomów cenowych) oraz cenie promocyjnej dla wszystkich poziomów cenowych.

Przed wykonaniem eksportu cen należy wypełnić formularz, który zawiera następujące pola:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku eksportu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "Stawka VAT".
Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Rozmiar pojedynczego pakietu (liczba elementów) – określa liczbę produktów eksportowanych w jednym pakiecie. Wykonywanie eksportu do pliku podzielone jest na pakiety zawierające określoną liczbę pozycji (cen produktów). Ustawienie dużego rozmiaru pakietu może powodować błędy wynikające ze zbyt małej wydajności serwera. Rozmiar pakietu należy więc ustawić na niższą wartość w przypadku korzystania z mniej wydajnych serwerów. W przypadku wystąpienia błędu wynikającego z wydajności, plik importu nie zostanie wygenerowany.
• Ceny w pliku eksportu to – ceny netto / ceny brutto – w zależności od dokonanego wyboru w pliku zostaną zapisane wyłącznie ceny netto albo ceny brutto
• Eksportuj również:

• Stara cena – system eksportuje również pole „Stara cena” dla każdego produktu (wspólne dla wszystkich poziomów cenowych)
• Cena promocyjna – system eksportuje również ceny promocyjne produktu (osobno dla wszystkich poziomów cenowych)

Przycisk Eksportuj plik, który dostępny jest pod formularzem, rozpoczyna pobieranie pliku eksportu, który można zapisać na lokalnym dysku.

Import zdjęć

Każdy produkt może mieć przypisane 3 zdjęcia:

• miniaturę wyświetlaną na liście produktów,
• duże zdjęcie wyświetlane w opisie produktu (większa wersja miniatury),
• zdjęcie wyświetlane w okienku popup po kliknięciu w zdjęcie w szczegółowym opisie produktu (może to być zupełnie inne zdjęcie niż miniatura i duże zdjęcie).

Każdy produkt może mieć dodatkowo galerię zdjęć, która pojawia się pod szczegółowym opisem produktu.

W sekcji Import / Eksport -> Import zdjęć dostępne są trzy sposoby importu:

• z serwera FTP na podstawie pliku importu (zakładka Importuj na podstawie danych z pliku CSV),
• z serwera FTP o podanej lokalizacji katalogu (zakładka Importuj z FTP),
• z dysku na lokalnym komputerze (zakładka Masowy upload zdjęć).

Poniżej zostały omówione wszystkie trzy sposoby.

1. Import na podstawie danych z pliku CSV

Przed rozpoczęciem importu należy przygotować plik importu i zapisać go na lokalnym dysku. Jest to plik tekstowy w formacie CSV, gdzie w kolejnych wierszach zapisane są informacje o importowanych plikach graficznych. Każdy wiersz zawiera informację o jednym zdjęciu (pliku).

Wyjaśnienia wymaga, w jaki sposób należy przygotować parametr „YYY” (ścieżkę do pliku).

Możliwe są następujące przypadki:

• Importowane pliki zlokalizowane są na serwerze FTP innym niż serwer, na którym zainstalowany jest sklep
  W takim przypadku dla każdego pliku powinniśmy podać pełen adres zgodnie z formatem: „ftp://user:haslo@adres_serwera/katalog/nazwa_pliku”.
  Przykład: „ftp://uzytkownik:haslo@ftp.mojsklepaptus.pl/pliki/zdjecie.jpg”
• Pliki są zapisane na tym samym serwerze, co oprogramowanie sklepu
  W takim przypadku dla każdego pliku wystarczy podać ścieżkę dostępu na tym serwerze, np. „./../katalog/nazwa_pliku”.
  Przykład: „./../pliki/zdjecie.jpg”
• Pliki są zlokalizowane na serwerze WWW dostępnym publicznie
  W takim przypadku dla każdego pliku podajemy jego adres zgodnie z formatem: „http://adres_serwera_www/katalog/nazwa_pliku”.
  Przykład: „http://www.mojsklepaptus.pl/pliki/zdjecie.jpg”

W formularzu importu zadaje się kolejno Plik importu oraz parametry związane z formatem informacji zapisanej w pliku importu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "Cennik do pobrania".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Dla zdjęcia rozmiaru pop-up – określa, czy zdjęcie pop-up będzie tworzone ze zdjęcia głównego, czy też zostanie ono podane osobno (jako kolejny parametr w wierszu importu) lub w ogóle nie będzie zdjęcia pop-up.
  Dostępne opcje:

• utwórz zdjęcie rozmiaru pop-up ze zdjęcia głównego
• utwórz zdjęcie rozmiaru pop-up z zdjęcia (zdjęcie z trzeciej kolumny)
• nie twórz zdjęcia o rozmiarze pop-up

• Dla produktów, w których znajdziesz zdjęcia do galerii – w polu tym możemy określić, co ma się stać z istniejącą galerią zdjęć dla danego produktu w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się również zdjęcia do galerii danego produktu.
  Do wyboru są następujące opcje:

• Kasuj poprzednie galerie produktu – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria zostanie w całości usunięta.
• Nie kasuj poprzednich galerii produktu (dodaj nowe zdjęcia) – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria nie zostanie usunięta, a nowe zdjęcia galerii zostaną do niej dopisane.

Po wypełnieniu formularza należy kliknąć przycisk Rozpocznij import, który inicjuje operację przetwarzania zdjęć z serwera FTP.

2. Import z FTP

W jaki sposób następuje identyfikacja zdjęć i przypisanie ich do odpowiednich produktów?

Wyróżnikiem produktu jest pole „Indeks towarowy” - jest to jego unikalny identyfikator. Zdjęcia umieszczone w katalogu serwera FTP, z którego dokonywany będzie import muszą mieć nazwy zgodne z indeksami towarowymi produktów, do których te pliki będą przypisywane.

Formularz importu zdjęć zawiera następujące pola:

• Ścieżka do zdjęć – wskazanie adresu serwera FTP, na którym przechowywane są zdjęcia, z jednoczesnym podaniem katalogu oraz loginu i hasła do serwera. Parametr ten ma następującą postać: ftp://user:haslo@adres_serwera/katalog
• Separator rozdzielający w nazwie pliku indeks towarowy i numer zdjęcia w galerii (domyślnie jest to znak podkreślenia „_”) – określa znak, który w nazwie pliku graficznego oddziela indeks towarowy od numeru zdjęcia w galerii. Jeżeli wczytujemy galerię zdjęć do produktu o indeksie towarowym „agd223”, a znak separatora zdefiniujemy jako znak podkreślenia, wówczas kolejne pliki wczytywane do galerii muszą być zadane zgodnie z podanym schematem: „agd223_1.jpg”, „agd223_2.jpg”, „agd223_3.jpg” itd.
• Dla zdjęcia rozmiaru pop-up – w polu tym możemy określić, w jaki sposób ma zostać tworzone bądź importowane zdjęcie pop-up.
  Do wyboru są następujące opcje:

• utwórz zdjęcie rozmiaru pop-up ze zdjęcia głównego – zdjęcie pop-up zostanie utworzone z tego samego pliku, co zdjęcie duże i miniaturka. Będziemy więc mieli miniaturkę, zdjęcie duże i zdjęcie pop-up, które będą wyglądać tak samo – jedyna różnica będzie w rozmiarze zdjęcia.
• utwórz zdjęcie rozmiaru pop-up ze zdjęcia o nazwie "xxxx_popup", gdzie xxxx oznacza indeks towarowy – wybranie tej opcji spowoduje, że z katalogu serwera FTP zostanie pobrany plik graficzny, którego nazwa składa się z indeksu towarowego zakończonego frazą „_popup”. W naszym przykładzie byłby to plik „agd223_popup.jpg”
• nie twórz zdjęcia o rozmiarze pop-up – jeżeli wybierzemy tę opcję, zdjęcie pop-up zostanie pominięte.

• Dla produktów, w których znajdziesz zdjęcia do galerii – w polu tym możemy określić, co ma się stać z istniejącą galerią zdjęć dla danego produktu w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się również zdjęcia do galerii danego produktu.
  Do wyboru są następujące opcje:

• Kasuj poprzednie galerie produktu – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria zostanie w całości usunięta.
• Nie kasuj poprzednich galerii produktu (dodaj nowe zdjęcia) – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria nie zostanie usunięta, a nowe zdjęcia galerii zostaną do niej dopisane.

Po wypełnieniu formularza należy kliknąć przycisk Rozpocznij import, który inicjuje operację przetwarzania zdjęć z serwera FTP.

3. Masowy upload zdjęć

W jaki sposób następuje identyfikacja zdjęć i przypisanie ich do odpowiednich produktów?

Wyróżnikiem produktu jest pole „Indeks towarowy” - jest to jego unikalny identyfikator. Zdjęcia, które wskażemy do importu z lokalnego dysku muszą mieć nazwy zgodne z indeksami towarowymi produktów, do których te pliki będą przypisywane.

Formularz importu zawiera następujące pola:

• Separator rozdzielający w nazwie pliku indeks towarowy i numer zdjęcia w galerii (domyślnie jest to znak podkreślenia „_”) – określa znak, który w nazwie pliku graficznego oddziela indeks towarowy od numeru zdjęcia w galerii. Jeżeli wczytujemy galerię zdjęć do produktu o indeksie towarowym „agd223”, a znak separatora zdefiniujemy jako znak podkreślenia, wówczas kolejne pliki wczytywane do galerii muszą być zadane zgodnie z podanym schematem: „agd223_1.jpg”, „agd223_2.jpg”, „agd223_3.jpg” itd.
• Dla zdjęcia rozmiaru pop-up – określa, czy zdjęcie pop-up będzie tworzone ze zdjęcia głównego, czy też zostanie ono podane osobno (jako kolejny parametr w wierszu importu) lub w ogóle nie będzie zdjęcia pop-up.
  Dostępne opcje:

• utwórz zdjęcie rozmiaru pop-up ze zdjęcia głównego
• utwórz zdjęcie rozmiaru pop-up ze zdjęcia o nazwie "xxxx_popup", gdzie xxxx oznacza indeks towarowy
• nie twórz zdjęcia o rozmiarze pop-up

• Dla produktów, w których znajdziesz zdjęcia do galerii – w polu tym możemy określić, co ma się stać z istniejącą galerią zdjęć dla danego produktu w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się również zdjęcia do galerii danego produktu.
  Do wyboru są następujące opcje:

• Kasuj poprzednie galerie produktu – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria zostanie w całości usunięta.
• Nie kasuj poprzednich galerii produktu (dodaj nowe zdjęcia) – w przypadku, gdy w katalogu, z którego importujemy zdjęcia znajdują się pliki galerii zdjęć dla danego produktu, poprzednia galeria nie zostanie usunięta, a nowe zdjęcia galerii zostaną do niej dopisane.

Import załączników do produktów

Wykonanie importu plików wymaga posiadania serwera FTP. Nie jest możliwe wczytywanie plików z dysku na lokalnym komputerze. Na serwerze w określonym katalogu muszą zostać zapisane pliki, które następnie zostaną zaimportowane do bazy danych sklepu.

Przed rozpoczęciem importu należy przygotować plik importu i zapisać go na lokalnym dysku. Jest to plik tekstowy w formacie CSV, gdzie w kolejnych wierszach zapisane są informacje o importowanych plikach. Każdy wiersz zawiera informację o jednym załączniku (pliku).

Wzór pliku (plik zawierający nagłówek z parametrami) może zostać pobrany po kliknięciu w przycisk Pobierz pola importu, który znajduje się pod formularzem parametrów importu.

Wyjaśnienia wymaga, w jaki sposób należy przygotować parametr „YYY” (ścieżkę do pliku).

Możliwe są następujące przypadki:

• Importowane pliki zlokalizowane są na serwerze FTP innym niż serwer, na którym zainstalowany jest sklep
  W takim przypadku dla każdego pliku powinniśmy podać pełen adres zgodnie z formatem: „ftp://user:haslo@adres_serwera/katalog/nazwa_pliku”.
  Przykład: „ftp://uzytkownik:haslo@ftp.mojsklepaptus.pl/pliki/cennik.pdf”
• Pliki są zapisane na tym samym serwerze, co oprogramowanie sklepu
  W takim przypadku dla każdego pliku wystarczy podać ścieżkę dostępu na tym serwerze, np. „./../katalog/nazwa_pliku”.
  Przykład: „./../pliki/cennik.pdf”
• Pliki są zlokalizowane na serwerze WWW dostępnym publicznie
  W takim przypadku dla każdego pliku podajemy jego adres zgodnie z formatem: „http://adres_serwera_www/katalog/nazwa_pliku”.
  Przykład: „http://www.mojsklepaptus.pl/pliki/cennik.pdf”

W formularzu importu zadaje się kolejno Plik importu oraz parametry związane z formatem informacji zapisanej w pliku importu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "Cennik do pobrania".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

Import newslettera

Plik importu jest plikiem tekstowym. Może on zawierać tylko jeden wiersz, w którym wypisane są kolejne adresy e-mail, oddzielone od siebie znakiem separatora (Separator kolumn). Wierszy w pliku może być jednak dowolna ilość.

Przed wykonaniem importu należy wypełnić formularz zawierający następujące pola:

• Plik importu – wskazanie ścieżki dostępu do pliku importu na lokalnym dysku
• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (kolejnych adresów e-mail) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (adres e-mail) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy adres e-mail w pliku ma być otoczony tym znakiem, np. "jan@mojafirma.pl".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Grupy tematyczne do których zostaną przydzielone adresy email – importowane adresy e-mail zostaną przypisane do zaznaczonych grup tematycznych

Po wypełnieniu formularza należy kliknąć przycisk Importuj, który rozpocznie wykonywanie operacji.

Istnieje również możliwość wstępnego sprawdzenia poprawności pliku importu bez dokonywania zapisu do bazy danych. W tym celu należy kliknąć w przycisk Sprawdź plik.

Działanie modułu Newsletter oraz opis grup tematycznych znajduje się w poprzedniej części niniejszej instrukcji (w sekcji Newsletter).

Import SEO oraz Eksport SEO

• Każdy produkt, grupa towarowa oraz promocja posiada własne atrybuty dotyczące SEO, które można ręcznie edytować.
• Są to tytuł strony oraz słowa kluczowe i opis, a także adres kanoniczny, które prezentowane są robotom wyszukiwarek (tagi HTML: title, keywords, description, canonical).
• W skład atrybutów SEO wchodzi również nagłówek strony oraz inne metadane w formie HTML.

Plik importu/eksportu jest plikiem w formacie CSV i zawiera on w kolejnych kolumnach następujące dane: Identyfikator, Nazwa (nie importowana), Adres (nie importowana), Tytuł, Nagłówek, Adres kanoniczny, Słowa kluczowe, Opis, Inne metadane. Identyfikator dotyczy produktów, grup towarowych lub promocji (w zależności od dokonanego w formularzu wyboru).

W formularzu importu/eksportu zadaje się, czy plik importu/eksportu ma zawierać dane grup towarowych, promocji czy produktów.
Dodatkowo podaje się parametry związane z formatem informacji zapisanej w pliku importu/eksportu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "Słowa kluczowe".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Rozmiar pojedynczego pakietu (liczba elementów) – określa liczbę wpisów importowanych / eksportowanych w jednym pakiecie.
  Wykonywanie importu/eksportu z/do pliku podzielone jest na pakiety zawierające określoną liczbę pozycji. Ustawienie dużego rozmiaru pakietu może powodować błędy wynikające ze zbyt małej wydajności serwera. Rozmiar pakietu należy więc ustawić na niższą wartość w przypadku korzystania z mniej wydajnych serwerów. W przypadku wystąpienia błędu wynikającego z wydajności, plik eksportu nie zostanie wygenerowany. W przypadku wykrycia błędu w pliku podczas wykonywania importu, system przerywa dalszy import. Nie oznacza to jednak, że żaden wpis w takim przypadku nie zostanie zaimportowany do bazy danych. Jeżeli import zostanie przerwany, wówczas do bazy danych trafią wszystkie dane zawarte w dotychczas poprawnie zaimportowanych pełnych pakietach.

Import słowników oraz Eksport słowników

W zakładce Eksport słowników można dokonać eksportu danych (pobrania pliku CSV) zawierających produkty wraz z wykazem słowników i przypisanych słów z tych słowników. Plik taki można następnie przetworzyć na lokalnym dysku i wczytać z powrotem poprzez zakładkę Import słowników.

Plik importu/eksportu jest plikiem w formacie CSV i zawiera on w kolejnych kolumnach najpierw podstawowe informacje o produkcie, a następnie wszystkie istniejące w bazie danych słowniki.

Pierwsze pięć kolumn pliku zawiera następujące dane: Identyfikator wewnętrzny, Kod producenta, Indeks towarowy, EAN, Nazwa.

Kolejne kolumny w pliku importu/eksportu, występujące po pierwszych pięciu kolumnach informacyjnych, odpowiadają kolejnym słownikom. Z kolei wartości wpisane w tych kolumnach przy konkretnym produkcie oznaczają słowa, które są przypisane do tego produktu.
Np. załóżmy, że produkt o nazwie „Kosiarka spalinowa” będzie miał wpisaną wartość „do trawy” w kolumnie „Zastosowanie”. Oznacza to, że słowo „do trawy”, które występuje w słowniku „Zastosowanie”, jest przypisane do produktu o nazwie „Kosiarka spalinowa”.

W formularzu importu/eksportu zadaje się parametry związane z formatem informacji zapisanej w pliku importu/eksportu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "do trawy".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Separator słów – domyślnie jest to znak |. Separator ten ma znaczenie w przypadku, gdy do tego samego produktu z danego słownika przypisanych jest kilka słów. W omawianym wyżej przypadku, jeżeli produkt „Kosiarka spalinowa” ma zastosowanie (słownik) określone jako „do trawy” i „do ogrodu”, wówczas w pliku importu/eksportu przy tym produkcie w kolumnie „Zastosowanie” znajdzie się wartość do trawy|do ogrodu.

Import tabeli cech oraz Eksport tabeli cech

Tabele cech przypisywane są do produktów w sekcji Produkty, w zakładce „Cechy” definicji produktu i mają układ parametrów Cecha -> Wartość.

W zakładce Eksport tabeli cech można dokonać eksportu danych (pobrania pliku CSV) zawierających tabele cech dla poszczególnych produktów. Plik taki można następnie przetworzyć na lokalnym dysku i wczytać z powrotem poprzez zakładkę Import tabeli cech.

Plik importu/eksportu jest plikiem w formacie CSV. Pierwsze pięć kolumn pliku zawiera następujące dane: Identyfikator wewnętrzny, Kod producenta, Indeks towarowy, EAN, Nazwa.

Kolejne dwie kolumny w pliku to Nazwa cechy i Wartość cechy.

W formularzu importu/eksportu zadaje się parametry związane z formatem informacji zapisanej w pliku importu/eksportu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "do trawy".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

W przypadku eksportu można zdefiniować dodatkowo:

• Zakres eksportowanych produktów – dostępne są opcje:

• Tylko z definicjami tabeli cech – wówczas w pliku eksportu pojawią się tylko te produkty, które posiadają tabelę cech;
• Wszystkie – w pliku eksportu pojawią się wszystkie produkty, również te, które nie posiadają tabeli cech.

Import oraz Eksport powiązań produkt / grupy towarowe

Każdy produkt może być przypisany do wielu grup towarowych. W panelu administracyjnym takiego przypisania dokonuje się w sekcji Produkty, w zakładce „Grupy towarowe” w definicji produktu.

W zakładce Eksport powiązań produkt / grupy towarowe można dokonać eksportu danych (pobrania pliku CSV) zawierających przypisania do grup towarowych dla poszczególnych produktów. Plik taki można następnie przetworzyć na lokalnym dysku i wczytać z powrotem poprzez zakładkę Import powiązań produkt / grupy towarowe.

Plik importu/eksportu jest plikiem w formacie CSV. Pierwsze dwie kolumny pliku zawiera następujące dane: Indeks towarowy, Nazwa.

Kolejne kolumny w pliku zawierają przypisania do grup towarowych. Każda kolejna grupa towarowa, do której przypisany jest dany produkt znajduje się w kolejnej kolumnie.

Import przekierowań (404)

Przekierowania można definiować ręcznie w sekcji Ustawienia -> Błędy 404. W omawianej zakładce można dokonać importu takich przekierowań, które zostały wstępnie przygotowane w pliku w formacie CSV.

Plik importu jest plikiem w formacie CSV. Każdy jego wiersz zawiera dwie kolumny: Błędny adres oraz Adres przekierowania.

W formularzu importu zadaje się parametry związane z formatem informacji zapisanej w pliku importu:

• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "do trawy".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Rozmiar pojedynczego pakietu (liczba elementów) – określa liczbę wpisów importowanych w jednym pakiecie. Wykonywanie importu z pliku podzielone jest na pakiety zawierające określoną liczbę pozycji. Ustawienie dużego rozmiaru pakietu może powodować błędy wynikające ze zbyt małej wydajności serwera. Rozmiar pakietu należy więc ustawić na niższą wartość w przypadku korzystania z mniej wydajnych serwerów. W przypadku wykrycia błędu w pliku podczas wykonywania importu, system przerywa dalszy import. Nie oznacza to jednak, że żaden wpis w takim przypadku nie zostanie zaimportowany do bazy danych. Jeżeli import zostanie przerwany, wówczas do bazy danych trafią wszystkie dane zawarte w dotychczas poprawnie zaimportowanych pełnych pakietach.
• Ignoruj pierwszą linię pliku – zaznaczenie opcji spowoduje pominięcie pierwszej linii pliku, która może zawierać np. nagłówki kolumn.

Import i eksport pól opisowych

W pliku importu / eksportu (format CSV) w każdym wierszu zapisane są kolejno indeks towarowy produktu i lista pól opisowych dla tego produktu.

W formularzu importu / eksportu zadaje się parametry związane z formatem informacji zapisanej w pliku importu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "do trawy".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

Import / eksport przeliczników pojemności

Jeden ze słowników w sklepie powinien być określony jako słownik pojemności (przypisania dokonuje się w sekcji Ustawienia -> Konfiguracja, zakładka „Słowniki”).

Dla każdego ze słów w takim słowniku można określać parametry Podziel cenę przez, Pomnóż cenę przez, Cena za (Jednostka docelowa). Więcej informacji na ten temat znajduje się w sekcji Słowniki.

W omawianej zakładce można dokonać importu tych parametrów dla konkretnych słów w słowniku pojemności – import odbywa się z pliku w formacie CSV.

Każdy wiersz pliku importu zawiera pięć kolumn: ID (identyfikator słowa), Słowo, Podziel cenę przez, Pomnóż cenę przez, Cena za (Jednostka docelowa).

W formularzu importu zadaje się parametry związane z formatem informacji zapisanej w pliku importu:

• Kodowanie znaków – rodzaj kodowania znaków w pliku importu – do wyboru UTF-8, CP-1250, ISO-8859
• Separator kolumn – określa znak, który służy do separacji kolumn (parametrów) w pliku importu.
  Opcje do wyboru:

• Tabulator [Tab]
• Przecinek [,]
• Średnik [;]

• Separator tekstu – określa sposób, w jaki tekst jest grupowany w obrębie pojedynczego parametru. Separator ten otacza pojedynczą kolumnę (parametr) na początku i końcu tekstu. Jeżeli wybierzemy jako separator cudzysłów ("), oznacza to, że każdy parametr w pliku ma być otoczony tym znakiem, np. "10 ml".
  Dostępne opcje:

• [Brak]
• Cudzysłów ["]
• Apostrof [']

• Ignoruj pierwszą linię pliku – zaznaczenie opcji spowoduje pominięcie pierwszej linii pliku, która może zawierać np. nagłówki kolumn.