Правила создания файлов price.txt menu.txt и их формат.

Формат файла price.txt

Сервис поддерживает текстовый формат указанной базы данных, где каждой строке соответствует одна запись (информация об одном товаре), а поля разделяются разделителями, специальными символами или целой комбинацией символов. Обычно разделителем служит символ ";" (точка с запятой). Такой формат баз данных называется CSV и конвертацию в него поддерживают практически все известные системы управления базами данных и Excel.

M-Shop позволяет Вам задавать практически любой символ в качестве разделителя полей и даже целую комбинацию символов. Так, например, если символ точки с запятой уже используется у Вас для описания товара, Вы, в качестве разделителя, можете использовать какую-нибудь редко встречаемую комбинацию, например "|#" или "@%" или даже " ~~". Мы часто используем "||" (две вертикальные черты). Количество символов-разделителей окраничено цепочкой из 5 символов.

Многие поля (а именно поля 2, 3, 8, 9, 10) поддерживают основные, но не все HTML-тэги. 
В этих полях разрешено использовать ссылку на другой ресурс Internet (например, более подробное описание товара) и изображения (тэг <IMG>). 

Вся поступающая на сервис M-Shop информация (включая содержание файлов price.txt и menu.txt) анализируется на предмет наличия опасных управляющих кодов. Наличие конструкций SSI, exec или им подобных, рассматривается администрацией как нарушение условий предоставления сервиса.

Описание полей файла price.txt

Формат файла menu.txt 

Формат служебной информации файла меню: 

Код товарной позиции = название на языке (LANG=1) = название на др. языке (LANG=2) и т.д. 

Первые позиции кода (слева направо) имеют больший приоритет, т.е. сначала определяется класс товара (самые первые позиции), далее секция или категория товара, потом вид товара и в самом конце (крайние правые позиции кода) – позиция данного конкретного товара в своей товарной группе. 

Поэтому красный шерстяной свитер производства фирмы "РиК" (код товарной позиции 01-22-33-444-model666-05) относиться к товарам народного потребления как классу (01-), секции трикотаж (22-), категория свитера (33-), далее – свитера фирмы "РиК" (444-), потом может идти порядковый номер модели (model666-) и, например, код цвета (05). 
Понятно, что для фирм, ориентированных в первую очередь на товары от конкретных производителей код фирмы "РиК" важнее, чем даже тип товара, поэтому он будет стоять левее, возможно самым первым, как определяющий код (например, 444-model666-05-01-22-33). 

В приведённом выше примере ни количество цифр, ни то, что код должен вообще состоять из цифр, ни тире-разделители не являются обязательными, т.е. формат кода является ПРОИЗВОЛЬНЫМ, принятым у Вас на фирме и должен лишь однозначно определять конкретный товар и, желательно, к какому виду, разделу или секции он принадлежит. 
 

Например, магазин торгует шариками.  Ниже приведён пример файла menu.txt  1 – это код шариков вообще  1 – это код красных шариков, а  2 – код синих шариков.  Последние три цифры кода, допустим, будут определять материал, из которого эти шарики изготовлены.  001 – каучук,  002 – латекс,  003 – полипропилен,  999 – сталь (а почему нет).  Тогда красный стальной шарик будет иметь код 11999, а синий полипропиленовый – 12003. Про код 1166666 мы можем лишь сказать, что это шарик (первая 1) красного цвета (вторая 1) из неизвестного материала и, возможно неизвестной модификации. А про код 99999 можно сказать, что это товар вообще не попадающий в нашу классификацию.  Поэтому файл меню может выглядеть следующим образом:  # Это просто комментарий  ; И это тоже комментарий. А след. пустая строка игнорируется 1=Все шарики=All balls=Alle Balls  11=красные шарики=red balls=rote Balls  12=синие шарики=blue balls=blaue Balls  =ВСЕ товары, имеющиеся в наличии!=ALL goods!=ALLE Warren!  А так будет выглядеть это выпадающее меню на виртуальной витрине магазина при разных параметрах LANG LANG=1 LANG=2 LANG=3 Все шарики красные шарики синие шарики ВСЕ товары, имеющиеся в наличии! All balls red balls blue balls ALL goods! Alle Balls rote Balls blaue Balls ALLE Warren!   Выбрав "Все шарики" клиент увидит предложения по шарикам всех цветов и материалов, включая наш товар с кодом 1166666. Он увидит этот конкретный товар также, если он выберет пункт "красные шарики". А, выбрав "ВСЕ товары, имеющиеся в наличии!", клиент увидит даже неизвестный нашей классификации товар с номером 99999.

Cервис M-Shop не поддерживает выборку по кодам из середины или конца списка. То есть в нашем примере нельзя выбрать только шарики из каучука (код 1?001) или латекса (код 1?002). 
Эта вынужденная плата за универсальность поддерживаемых товарных кодов и языков. Для M-Shop символы типа ? или * не более чем части кода товарной позиции. Этой особенности лишены локальные версии сервиса M-Shop, которые поставляются индивидуально под заказ за отдельную оплату.