Руководство Пользователя Mambo-phpShop

Sören Eberhardt

Russell Walker (www.netshinesoftware.com)

Авторское право © 2005 Sören Eberhardt

This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml
Revision 0.8 Initial Release
January 14, 2005

Оглавление

1. Предисловие
2. Введение
3. Установка
4. Первые шаги
5. Управление магазином
6. Известные проблемы
7. Список To Do
8. О документе

1. Вступление

The content of this document is related to mambo-phpShop.
mambo-phpShop is free Software, licensed under GNU/GPL; phpShop™ Parts: © 2000–2004 Edikon Corp.
mambo-phpShop [ http://www.mambo-phpshop.net ]
Conversion to Mambo and much more: © 2004 Sören Eberhardt
The Software 'mambo-phpShop' is intended for use in Mambo, version 4.5.1 and above.
(Mambo – свободное Программное обеспечение, лицензированное под GNU/GPL и доступное на www.mamboserver.com)

2. Вступление

2.1. Что можеть делать?

2.1.1. О продукте
Mambo-phpShop – это некоммерческий компонент для использования в системе управления содержанием известной как 'Mambo', который устанавливается совершенно легко через установку модулей и компонентов. Он предназначен для использования в малых и средних online-магазинах/компаниях. Любой пользователь, который захочет построить Online-магазин с различными товарами и продавать их клиентам, может использовать этот компонент.

2.1.2. Возможности

• добавлять неограниченное количество товаров и категорий
• продавать электронные (скачиваемые) товары
• добавлять полноразмерное изображение и его уменьшенную копию к каждому товару через броузер
• добавлять свойства, такие как размер или цвет к вашим товарам
• добавлять и назначать покупателей к различным группам покупателей
• назначать более чем одной цены на товар, для различных групп покупателей
• легко настраивать и управлять вашим магазином через полностью интегрированный в mambo интерфейс
• моментально видеть статистику магазина / сводка с количеством клиентов, количеством заказов и т.д.
• расширять магазин с помощью других модулей и функций
• управлять уровнем запаса для товаров
• оповещать покупателей о возобновлении запасов товаров
• использовать калькуляцию, основанную на налоговых зонах (город/штат или страна/регион)
• store owner based tax calculation (e.g. in european countries)
• добавлять перевозчиков и их тарифы
• назначать пользователей группам таким как “admin”, “storeadmin”, “shopper” или “demo”, чтобы позволить администрирование другими пользователями (назначать товар поставщикам и позволять этим поставщикам поддерживать только его товары)
• полное управление заказом с сохранением IP-адреса
• расширять предопределенные статусы заказов своими
• покупатели могут добавлять личные адреса доставки
• ваши клиенты легко могут найти товары через поисковую форму
• feature specific products by setting them on special
• ваши покупатели узнают, когда товар снова будет в продаже
• покупатели смогут видеть на странице информации о товаре в какое время он обычно продается (с красивыми картинками!)
• покупатели могут управлять своими пользовательскими записями
• покупатель может видеть все свои заказы (с детализацией)
• письмо подтверждения заказа (настриваемо!) посылается покупателю и сохраняется у владельца
• управление различными валютами, странами
• использование безопасной SSL-шифрации (128-bit)
• способность актуальной обработки кредитных кард
• использование authorize.net® payment шлюза
• ипользование PayPal IPN шлюза
• использование WorldPay, PayMate и NoChex....
• mambo-phpShop уже сожержит следующие хаки/твики/модули:
  • • • • Зональный модуль доставки от Zephware.com
        • Лист ожидания от Zephware.com
        • Исправления для phpShop 0.6.1b
        • Улучшенные Next-Prev ссылки для phpShop
        • Flypage Admin Link for phpShop
        • Последние товары для phpShop (as a seperate module)
        • Mini Cart for phpShop
        • Product Folders for phpShop
        • Произвольные товары для phpShop (as a seperate module)
        • Featured Products for phpShop (as a seperate module)
        • Special Products Manager for phpShop
        • Report Basic (for statistical purposes)
• CSV upload component mambo-phpShop has some extra features:
  • • • • can be used as a catalogue only
        • show prices including or excluding tax 
        • let your customers pay by PayPal
• Advanced shipping module from phpEuroshop additional mambo modules / sideblocks (show new, random or featured products) to enhance your shop
• and many more!

2.2. что не можеть делать?

Mambo-phpShop is a simple Online-Shop application. But it is surely no “out-of-the-box” killer application for absolutely professional companies. It's not tested in 100% secure environments. It's not meant to be 100% performant.
Be prepared to be confronted with bugs, which have currently not been found yet. mambo-phpShop has an active community and a forum where problems and questions can be discussed. (http://mambo-phpShop.net)

2.3. Screenshots (надо будет их сделать уже на локализованной версии)

Frontend Screenshots
Product Details Page
Product Details Page with Review Feature
Administrator Screenshots
Administration: Product List
Administration: Product List

3. Инсталляция

3.1. Процедура инсталляции

Когда соблюдены все требования, и Вы запускаете Mambo, Вы должны выбрать:

1. Автоматическая инсталляция с помощью инсталлятора элементов Mambo (компонентов, модулей, ботов...).
2. Инсталляция вручную.

Некоторые пользователи не могут использовать автоматическую инсталляцию из-за 'safe_mode=On' или по некоторым другим причинам.
В случае, возникновения проблем при автоматической инсталляции, попробуйте инсталлировать phpShop вручную.

3.2. Автоматическая инсталляция

Mambo-phpShop является составным скриптом. Наряду с компонентом необходим также и модуль. Он содержится в файле, называемом 'mambo-phpShop_x.x_COMPLETE_PACKAGE.zip'. Этот файл включает в себя и другие различные элементы для mambo-phpShop.

Важно
Этот файл не является установочным – это архив, содержащий установочные файлы-архивы и перед инсталляцией он должен быть вначале распакован.

Содержимое пакета:

• 1 компонент (com_phpShop_x.x.tar.gz)
• 1 главный модуль mambo-phpShop (mod_phpShop_x.x.tar.gz)
• 6 дополнительных модулей
• 2 мамбота (1 поисковый, 1 мамбот для обработки содержания страниц)

1. Распакуйте файл 'mambo-phpShop_x.x_COMPLETE_PACKAGE.zip' в локальную папку.
2. Войдите в бэк-енд Mambo (используйте URL ' http://mambourl/administrator') для доступа к административному интерфейсу.

Экран Бэк-енда
Вы должны иметь привилегии Администратора / Суперадминистратора для инсталляции элементов Mambo.

3. Нажмите 'Компоненты' -> 'Установка/Удаление' ('Components' -> 'Install/Uninstall') в верхнем меню.

Список установленных компонентов

В области 'Загрузить установочный пакет' ('Upload new component') выберите файл 'com_phpShop_x.x.tar.gz'. Это пакет, содержащий все файлы компонента mambo-phpShop, находится у Вас на компьютере (см. Шаг 1).
После кликните на кнопку 'Загрузить & Установить' ('Upload File & Install'). Так как файл архива tar.gz занимает около 1 MB, Вам будет необходимо немного подождать, пока он загрузится на сервер и будет распакован.
Если загрузка будет длиться слишком долго, попробуйте Шаг 4 или Инсталляцию Вручную.

4. Альтернатива: Вы можете распаковать содержимое 'com_phpShop_x.x.tar.gz' и закачать эти файлы в удаленную папку с помощью ftp-соединения. Тогда Вам надо будет указать папку на сервере, откуда Вы хотите установить необходимый элемент и нажать 'Установить' ('Install').

Замечание
Обычно файлы пакета – это упакованные ZIP или tar.gz папки с файлами, которые включают всю информацию для инсталляции. Главным файлом является XML документ, описывающий процесс инсталляции. Чтобы использовать его для инсталляции, Ваш web-сервер должен поддерживать расширение zlib. Вы можете это проверить в административной секции меню 'Система > Системная информация > Системная информация' (System > System Info > System Information).

5. Теперь можно инсталлировать компонент mambo-phpShop.

Вы видите «Экран Приветствия» с несколькими сообщениями, что Вам делать дальше.

Вы можете выбрать, инсталлировать ли Вам примеры данных (18 товаров с атрибутами в 5-ти категориях) чтобы посмотреть, как может быть настроен магазин. Или Вы можете выбрать 'Сразу перейти в магазин >>' ( 'go directly to the Shop >>') без инсталляции примеров данных.

Осторожно

Этот шаг опять занимает некоторое время – инсталлятор mambo-phpShop выполняет большое количество запросов к базам данных. Пожалуйста, будьте терпеливы!

6. Выберите в верхнем меню 'Модули -> Установить / Удалить?' ('Modules' -> 'Install/Uninstall') для того, чтобы установить главный модуль mambo-phpShop.
Выберите файл 'mod_phpshop_x.x.zip' в файловом диалоге (кнопка Browse) и нажмите кнопку 'Загрузить & Установить' ('Upload File & Install').
Повторите эти же действия для всех дополнительных модулей, которые Вы хотите установить для mambo-phpShop.
Публикация модулей.
Выберите в верхнем меню 'Модули' -> 'Модули сайта' ('Modules' -> 'Site Modules'). В списке инсталлированных модулей найдите модуль с названием 'mambo-phpShop Module'. Выберите его (нажмите на название) и отредактируйте его настройки. Также выберите, расположение модуля на Вашем Mambo-сайте. Для получения более детальной информации о модулях, пожалуйста, обратитесь к документации Mambo (http://help.ru-mambo.ru, http://mamboserver.com).

Важно
Где бы Вы не размещали модуль на сайте, ОН ДОЛЖЕН БЫТЬ ОПУБЛИКОВАН. Это делается потому, что вся навигация по категориям происходит с помощью этого модуля. Поэтому использовать компонент mambo-phpShop без модуля несколько 'сложно'.

7.Рекомендации по установке мамботов
Выберите в верхнем меню 'Мамботы' -> 'Установить/Удалить' ('Mambots' -> 'Install/Uninstall').
Поисковый бот: Выполняет поиск в таблице товаров и предоставляет результаты поиска для Mambo-поиска по сайту.
Выберите файл 'phpshop.searchbot_x.x.tar.gz' и нажмите кнопку 'Загрузить & Установить' ('Upload File & Install').
Мамбот Product Snapshot? (информация о товаре): Выводит картинку/цену/ссылку 'В корзину' в Mambo-контенте на сайте.
Выберите файл 'mosproductsnap_x.x.tar.gz' и нажмите кнопку 'Загрузить & Установить' ('Upload File & Install').
Публикация мамботов.
Для того, чтобы мамботы выполняли свои функции они должны быть ОПУБЛИКОВАНЫ. Выберите в верхнем меню 'Мамботы' -> 'Установить/Удалить' ('Mambots' -> 'Install/Uninstall'). В списке установленных мамботов найдите 'phpshop.searchbot' и 'mosproductsnap'. Выберите их поочередно (нажмите на название) и измените настройки. Не забудьте опубликовать их. Для получения более детальной информации о мамботах, пожалуйста, обратитесь к документации Mambo (http://help.ru-mambo.ru, http://mamboserver.com).

Теперь инсталляция mambo-phpShop элементов завершена.

3.3. Инсталляция вручную

Установка вручную немного сложнее, чем автоматическая установка. Вам надо будет скопировать необходимые файлы и запустить несколько SQL запросов. Для запуска SQL запросов, Вам необходимо приложение управления базами данных, например, phpmyadmin (включен в Denver) (http://www.phpmyadmin.net), который также доступен как компонент Mambo (http://mamboforge.net/projects/mosphpmyadmin/).

1. Распакуйте com_phpShop_x.x.tar.gz в локальную папку.
2. Распакуйте frontend_files.tar.gz.
3. Зайдите в папку /mambo/components на Вашем web-сервере и создайте там папку com_phpshop.
4. Скопируйте в эту папку следующие файлы:

5. Найдите файл phpshop.cfg-dist.php и переименуйте его в phpshop.cfg.php.
6. Зайдите в папку /mambo/administrator/components на Вашем web-сервере и создайте там папку com_phpshop.
7. Распакуйте admin_files.tar.gz.
8. Скопируйте распакованные файлы И ВСЕ ФАЙЛЫ ИЗ КОРНЯ АРХИВА com_phpshop_x.x.tar.gz в: /mambo/administrator/components/com_phpshop.
9. После откройте phpmyadmin (или ту утилиту, с помощью которойВы управляете базами данных) и выберите базу данных Mambo-сайта, на который Вы установили mambo-phpShop. В этой базе данных найдите таблицу “mos_components” (в phpMyAdmin в правом фрейме). Нажмите на ней, и перед Вами отобразится структура таблицы. Нажмите «Обзор» («Browse”) и Вы увидите все записи этой таблицы.

Нажмите ссылку 'Вставить новый ряд' ('Insert new row') и внесите следующие данные:
id – оставьте пустым – система сама вычислит ID
name – mambo-phpShop
link – option=com_phpshop
menuid – 0
parent – 0
admin_menu_link – option=com_phpshop
admin_menu_alt – Управление phpShop
option – оставьте пустым (ничего не вводите!)
ordering – 0
admin_menu_img – js/
iscore – 0
params – оставьте пустым (ничего не вводите!)

После ввода данных сохраните запись (возможно надо будет отметить Сохранить (Save) и/или нажать 'Пошел').
Теперь в бэк-енде Mambo, в верхнем меню, появится пункт Компонент => mambo-phpshop (Components => mambo-phpshop). После выбора этого пункта перед Вами появится экран приветствия, где Вы сможете выбрать инсталлировать ли демо-данные или сразу перейти в магазин. Выберите то, что соответствует Вашим требованиям...
Если перед Вами снова появляется экран приветсвия, удалите файл mambo/administrator/components/com_phpshop/install.php и все должно заработать.

10. Для инсталляции модулей и мамботов для mambo-phpShop, следуйте инструкциям Автоматической инсталляции, Шагов 6 и 7. Если автоматическая инсталляция для Вас невозможна, Вы можете вручную загрузить файлы.

Теперь Ваш mambo-phpShop установлен правильно.

3.4. FAQ по инсталляции

Q: Инсталлятор Mambo сообщает мне «ОШИБКА: В пакете не найден установочный XML файл» («ERROR: Could not find an XML setup file in the package»). Что не так?
A: Чаще всего эта проблема возникает из-за того, что Вы не распаковали архив mambo-phpShop_x.x_COMPLETE_PACKAGE.zip или пробуете загрузить/инсталлировать именно его, а не содержащиеся в нем установочные архивы.

Q: Инсталлятор Mambo сообщает мне «Какой-то компонент уже использует папку com_phpShop») («Another component is already using the directory com_phpShop»)
A: Пожалуйста, удалите папки /mambo/components/com_phpshop и /mambo/administrator/components/com_phpshop.

Q: Когда используется автоматическая инсталляция, ничего не происходит после нажатия «Загрузить & Установить» («Upload & Install»). В чем причина?
A: mambo-phpShop – большой компонент, его инсталляционный архив занимает более 1 Mb. Когда этот файл загружается на Ваш сервер, необходимо подождать некоторое время, пока файл полностью скопируется. Чтобы не было этой паузы, Вы также можете использовать Удаленный инсталлятор (Remote Installer) (http://mamboforge.net) для mambo-phpShop!

Q: После установки компонента я добавил ссылку на компонент phpShop в главном, но при переходе по этой ссылке на странице отображается только “Welcome to Washupito's.....”. Что не так?
A: mambo-phpShop – это не только компонент. Он программировался с учетом использования его совместно с соответствующим главным модулем. Без модуля Вам всегда будет выводится индексная страница компонента shop.index.

4. Первые шаги

Вы уже инсталлировали главный МОДУЛЬ mambo-phpShop?
Если нет, сделайте это прямо сейчас. Не забудьте опубликовать его в каком-либо месте Вашего сайта. Этот модуль предназначен для отображения всех категорий товаров и управления компонентом.

Замечание
Все последующие действия подразумевают использование горизонтального главного меню в администрировании mambo-phpShop!

Информация
mambo-phpShop предоставляет ПОЛНЫЙ ДОСТУП к панели администрирования из фронт-енда! Это означает, что Вам не надо входить в бэк-енд Вашего Mambo-сайта, чтобы сделать все необходимые изменения. Просто кликните «Администрирование» («Administration») в главном модуле phpShop. (у Вас должны быть права admin'a или storeadmin'a)

1. Зайдите в «Магазин» -> «Редактировать магазин» («Store» -> “Edit Store”) и измените все важные настройки на Ваши данные. Не забудте установить валюту, стиль отображения валюты и Ваш email адрес!
2. Зайдите в «Налог» -> «Добавить налоговую ставку» («Tax» -> “Add tax rate”) и добавте налоговую ставку, соответствующую местонахождению Вашего магазина (важно для европейских магазинов!).
3. Зайдите в «Компоненты» -> “mambo-phpShop” -> “Admin” -> «Конфигурация» («Components” -> “mambo-phpShop” -> “Admin” -> “Configuration”) и измените все данные на свои.
4. Зайдите в «Компоненты» -> “mambo-phpShop” -> «Товары» -> «Добавить категорию» («Components” -> “mambo-phpShop” -> “Products” -> “Add category”), создайте структуру категорий и настройте параметры всех категорий. Удостоверьтесь, что все категории опубликованы.
5. Зайдите в «Компоненты» -> “mambo-phpShop” -> «Товары» -> «Добавить товар» («Components” -> “mambo-phpShop” -> “Products” -> “Add Product”) и добавьте все необходимые товары, повторяя этот шаг.

4.1. Конфигурация Mambo

mambo-phpShop использует некоторые установки глобальной конфигурации Вашего сайта, которые Вы должны установить в «Сайт» -> «Глобальная конфигурация» в Mambo-меню.

Разрешить регистрацию юзеров – ДА

Пользователь/покупатель должен быть зарегистрирован, прежде, чем он сможет оформить заказ. mambo-phpShop имеет расширенную регистрационную форму, где покупатели могут указывать свои банковские реквизиты и адреса доставки. Когда покупатели используют эту форму, они автоматически добавляются в список пользователей Вашего Mambo-сайта.

Активация нового аккаунта – НЕТ

Покупатели должны иметь возможность закончить оформление заказа сразу же, а не возвращаться к оформлению заказа после активации своего нового аккаунта через email-письмо!

Конфигурация закладки «Почта»

mambo-phpShop отсылает письма, используя конфигурацию почты Mambo. Удостоверьтесь, что установки на закладке «Почта» соответствуют настройкам Вашего сервера.

Замечание
Если Вы не измените информацию о магазине и Ваш email-адрес, mambo-phpShop будет посылать письма о подтверждении заказа не Вам, а на адрес demo_order@phpshop.org.

Локализация / Язык
mambo-phpShop пытается найти в собственной языковой папке файл с таким же названием, как и языковой файл, указанный Вами в конфигурации Mambo:

• /mambo/administrator/components/com_phpshop/languages

Если такой файл не будет найден, то по умолчанию будет использоваться файл английского языка english.php

Дружественные для поисковых движков ссылки (Search Engine Friendly URLs)

• Рекомендуется выключить (Нет)

mambo-phpShop полностью совместим с дружественными ссылками, но, пожалуйста, помните, что некоторые SEF-ссылки, генерируемые SEF-модулем Mambo или другим модулем, иногда вызывают ошибку “URL redirection limit exceeded...”.

5. Руководство администратора

(предварительный вариант)

Это руководство поможет Вам легче настроить Ваш сайт, создать действующую политику управления Вашим магазином и углубленно пользоваться возможностями администратора через административный интерфейс mambo-phpShop.

Оно предполагает, что Вы уже инсталлировали mambo-phpShop и сконфигурировали Ваш сайт согласно руководству по инсталляции и «Первым шагам» (mambo-phpShop версии 1.2 и Mambo 4.5.х).

5.1. Конфигурация магазина

Панель конфигурации это наиболее важная часть mambo-phpShop. Она находится в “Admin” -> «Конфигурация» («Admin” -> “Configuration”).
Оглавление конфигурации
Помните, что к панели конфигурации имеют доступ только пользователи с правами “admin” (по умолчанию).
Панель конфигурации разделена на несколько частей, доступ к которым Вы можете получить кликая на закладках в оглавлении панели.

5.1.1. Глобал (Global)
Глобал I (Global I)

• Использовать только как каталог (Use only as catalogue) – Прячет кнопку «Добавить в корзину» («Add to Cart»).
• Показать цены (Show Prices) – Показывает/скрывает цены в магазине. (полезно при использовании магазина в качестве каталога). В магазине нет возможности для незарегистрированных пользователей скрыть цены, а для зарегистрированных показать. Только показывать вообще или не показывать!
• Показать цены включая налоги? (Show Prices including tax?) – (в последних версиях перенесена в группы покупателей «Покупатель»->"Отобразить группы покупателей"->...группа... («Shopper»->"List Shopper Group"->...group..)). Установка этого флага определяет, будут ли после цены отображаться надпись "(включая ХХ% налог)" ("(including XX% Tax)")
• Налог на 'виртуальные' товары (Virtual Tax) – Определяет, облагаются ли налогом товары с нулевым весом.
• Режим налоговой ставки на основании адреса (Tax mode) – Этот пункт определяет, какая налоговая ставка учитывается при расчёте налога: • ставка того региона, где находится покупатель. • или того, где расположен магазин .
• Разрешить разные налоговые ставки? (Enable multiple tax rates?) – Отметьте этот флажок, если у вас есть товары с разными налоговыми ставками (напр. 7% для книг и еды, 16% для других товаров).
• Вычитать скидку до прибавления налога/стоимости доставки? (Discount before tax/shipping?) – Установка этого флажка определяет, вычитать скидку для платежей ПЕРЕД (если отмечено) или ПОСЛЕ добавления налога и стоимости доставки.
• Ключ кодировки (ENCODE KEY) – Секретный ключ для шифрования Платежных Данных, таких, как номера кредиток, для хранения их зашифрованными в базе данных.

Глобал II (Global II)

• Разрешить использование купона (Enable Coupon Usage) – Если Вы разрешите использование купона, то клиенты смогут получать скидки на покупки по коду купона.
• Включить систему отзывов и рейтингов (Customer Review / Rating? System) – Если отмечено, то Вы разрешаете клиентам проводить рейтинг товаров, а также писать отзывы об этих продуктах. Таким образом клиетны смогут высказать своё мнение по поводу тех или иных товаров, что будет полезно для других пользователей.
• Дать возможность покупателям вносить банковские реквизиты? (Ask for Bank Account data?) – Отметьте, чтобы Ваши покупатели могли предоставить данные о своём банковском счёте при регистрации в магазине. Это полезно, если у Вас используется платежный метод, в котором используются банковские переводы.
• Покупатели могут выбирать область/район? (Customers can select a state/region?) – Включите, чтобы Ваши покупатели имели возможность выбирать область/район при регистрации в магазине в выпадающем списке.
• Обязательное согласие с условиями предоставления услуг? (Must agree to Terms of Service?) – Включите, чтобы покупатель обязательно соглашался с Условиями предоставления услуг до того, как зарегистрируется в магазине.
• Необходимо ли соглашаться с Условиями предоставления услуг при КАЖДОМ ЗАКАЗЕ? (Agree to T.o.S. on EVERY ORDER?) – Включите, если хотите, чтобы покупатель соглашался с Условиями предоставления услуг при каждом заказе, а не только при регистрации (перед завершением заказа).
• Проверять склад? (Check Stock?) – Установите, чтобы при добавлении покупателем товара в корзину проверялось количество этого товара на складе. Установка флажка запрещает покупателю добавлять в корзину больше товара, чем доступно на складе.
• Включить партнёрскую программу? (Enable Affiliate Program?) – Включение партнёрской программы во frontend'е магазина. Работает, если Вы добавили партнёров в backend.

Предупреждение
Раньше партнёрская программа полностью не работала. Для уточнения ее работоспособности в последних версиях обратитесь к документации и CHANGELOG (ИЗМЕНЕНИЯ) последних версий (mambo-phpshop.net).

• Формат письма-заказа (Order-mail format): – Определяет формат письма подтверждения заказа:
  как простой текст
  или как html-письмо с картинками.

• Разрешить администрирование Frontend'a для пользователей, не имеющих доступа к Backend'y? (Allow Frontend-Administration... for non-Backend Users?) – Этой установкой Вы разрешаете администрирование frontend'a пользователям, которые являются администраторами магазина, но не имеют доступ к backend'у Mambo (например Registered / Editor).

5.1.2. Пути и URL (Paths & URL)

Настройки Пути и URL используют настройки Mambo только пока конфигурация не будет сохранена первый раз. После этого эти настройки будут жёстко прописаны в конфигурационном файле.

Предупреждение
Помните, что эти настройки обязательно надо изменять при копировании/переходе на новый хостинг/домен.

• URL – Пример: http://www.mydomain.com/ – URL Вашего сайта. Обычно идентичный URL у Mambo (обязательно со слешем в конце!)
• SECUREURL – Пример: https://www.mydomain.com/ – Защищённый URL Вашего сайта. (обычно https – со слешем в конце!)

Предупреждение
Будьте внимательны при заполнении этого поля – у Mambo могут быть проблемы с Общими SSL доменами (Shared SSL Domains). Когда во время оформления заказа происходит переключение на другой домен (с Вашего обыкновенного на защищенный), текущая сессия теряется, и покупатель должен будет зайти со своими логином и паролем снова!

• COMPONENTURL – URL компонента mambo-phpShop (со слешем в конце!)
• IMAGEURL – URL к папке с картинками для компонента mambo-phpShop. (со слешем в конце!)
• ADMINPATH – Путь к папке компонента mambo-phpShop.
• CLASSPATH – Путь к папке классов 'classes' Вашего phpShop'a.
• PAGEPATH – Путь к папке 'html' Вашего phpShop'a.
• IMAGEPATH – Путь к папке 'shop_image' компонента phpSop.
• HOMEPAGE – Пример: shop.index – Страница, загружаемая во фронт-энде по умолчанию.
• ERRORPAGE – По умолчанию: shop.error – Эта страница загружается по умолчанию для отображения информации об ошибках.
• DEBUGPAGE – По умолчанию: shop.debug – Эта страница загружается по умолчанию для отображения отладочных сообщений.
• DEBUG? – Включение вывода отладочной информации. В этом режиме внизу каждой страницы появляется отладочная информация – DEBUGPAGE. Она очень полезна при разработке и отладке магазина, поскольку показывает содержимое корзин, значения полей форм и т.п.

5.1.3. Сайт (Параметы вывода)(Site – Display & Layout)
mambo-phpShop makes use of the Mambo Templates' CSS. It uses the Standard-CSS Classes defined for Mambo like sectiontableheader, sectiontableentry1, sectiontableentry2 and so on. You'll find some rows that are not CSS colored. These ones can be changed by Search Color 1 and 2.

Display

• PDF – Button – Show or Hide the PDF – Button in the Shop Frontend.
• FLYPAGE – По умолчанию: shop.flypage – This is the page used for displaying product details when no special flypage is set.

На заметку
You can change the Flypage for each category in its category form!

• Category Template – По умолчанию: browse_1 – This defines the category template for displaying products in a category when no special template is set. You can create new templates by customizing existing template files (which reside in the directory COMPONENTPATH/html/templates/ and begin with browse_).

На заметку
You can change the Category Template for each category in its category form!

• Default number of products in a row – This defines the number of products in a row. Пример: If you set it to 4, the default category template will display 4 products per row.

На заметку
You can change the Category's Number of products per row for each category in its category form!

• “no image” image – По умолчанию: /ps_image/noimage.gif – This image will be shown when no product image is available.
• SEARCH ROWS – Determines the number of rows per page when search results are displayed in a list.
• MAXIMUM ROWS – [deprecated] – Sets the number of rows to show in the order list select box of the Affiliate Module.
• Show footer “powered by...” ? – Displays a powered-by-mambo-phpShop footer image. Give credits back to the author!

Design

• Add-to-Cart Button Style – Here you can choose out of different images for displaying the Button “Add to Cart”.

Совет
You can customize this list by creating your own template images, renaming them to something beginning with add-to-cart_ and putting them into the directory /components/com_phpshop/shop_image/ps_image/.

• Dynamic Thumbnail Resizing? – If checked, you enable dynamic Image Resizing. This means that all Thumbnail Images are resized to fit the Sizes you provide below, using PHP's GD2 functions.

Совет
You can check if you have GD2 support by browsing to “System” -> “System Info” -> “PHP Info” -> gd.
The Thumbnail Image quality is much better than Images which were “resized” by the browser. The newly generated Images are put into the directory /shop_image/prduct/resized. If the Image has already been resized, this copy will be send to the browser, so no image is resized again and again.

• Thumbnail Image Width – The target width of the resized Thumbnail Image.
• Thumbnail Image Height – The target height of the resized Thumbnail Image.
• SEARCH COLOR 1 – По умолчанию: #f9f9f9 – Specifies the color of the odd numbered rows in a result list.
• SEARCH COLOR 2 – По умолчанию: #f0f0f0 – Specifies the color of the even numbered rows in a result list.

5.1.4. Shipping
In the Shipping section you can select one of the provided Shipping Modules.

Совет
You can configure Online Services (like UPS® or Intershipper®) in “Store” => “List Shipping Modules” => Service Name. Other Shipping methods like Standard Shipping or Zone Shipping must be configured through their own administrative interface: “Shipping” => Shipping Rates / Shippers or “Zone Shipping” => “Zone List”. The Free Shipping module can be configured by amount only in the Store Form.
The selected Shipping Module will list all available Shipping Rates on Checkout.

На заметку
If you want no Shipping Rate Selection, you must select “Disable Shipping method selection” AND a checkout process (next Tab) which doesn't include Shipping Method selection.

5.1.5. Checkout

• Enable the Checkout Bar – По умолчанию: Enabled – Check this, if you want the 'checkout-bar' to be displayed to the customer during checkout process ( 1 – 2 – 3 – 4 with graphics).

The selected process will be the unique Checkout Process for your whole Store.

5.1.6. Downloads

• Enable Downloads – Check to enable the Download Feature. Only If you want sell downloadable goods.
• “Enable download” Status – value: can be some Order Status (not cancelled ;-)). Select the order status at which the customer is notified about the download via e-mail.
• “Disable download” Order Status – Sets the order status at which the download is disabled for the customer.
• DOWNLOADROOT – The physical path to the files for the custumer download. (trailing slash at the end!)

Важно
Must be a physical path, no URL.

Предостережение
For your own shop's security: If you can, please use a directory ANYWHERE OUTSIDE OF THE WEBROOT

• Download Maximum – Sets the number of downloads which can be made with one Download-ID for one order.
• Download Expire – Sets the time range in seconds in which the download is enabled for the customer. This range begins with the first download! When the time range has expired, the download-ID is disabled.

Совет
86400s=24h

5.2. Getting Started

To access the configuration of mambo-phpShop, select «Components | mambo-phpShop» in the mambo administration interface.
If you see the mambo-phpShop “Welcome” page when you log into your mambo site admnistration interface, click “Go Directly to Shop”.
Navigating to the mambo-phpShop admin interface will bring up the “Store: Summary” page.
You may also access this page from within the mambo-phpShop interface under «Store | Summary»

5.3. Store Setup

To begin setting up your store, select «Store | Edit Store» from the mambo-phpShop admin interface.
The information from the Store Information form is displayed in various locations on the shopping site. This is your store's primary identity – essentially a specialized “master” vendor.

• Full Image – Required – Displays the currently configured store logo.
• Upload Image – Optional – Browse to your company logo. This will be uploaded when you click on the “Save” icon.
• Currency – The Store's global / default Currency
• Minimum Purchase Order Value – This is the amount which is the minimum Order Value for Checkout.
• Minimum Amount for Free Shipping – This is the amount, from which on Shipping is free.
• Currency symbol – This is the currency symbol which will be used when displaying prices.
• Decimals – Number of decimals.
• Decimal symbol – Can be somethin like ., or empty.
• Thousands separator
• Positive format – Display Order / Style for positive numbers.
• Negative format – Display Order / Style for negative numbers.
• Description – This is your Store's Description which is shown on the page shop.index.
• Terms of Service – This is the complete text for your Terms of Service that is displayed to the customer.
• Store Name – Required – The name of the Store.
• Store Company Name – Required – The name of your company.
• URL – The Store's Internet Address.
• Address 1 – Address Line 1
• Address 2 – Address Line 2
• City – The City where your Store is located.
• State / Province / Region? – The State / Region where your Store is located.
• Country – The Country where your Store is located.
• Zip / Postal? Code – The ZIP of your Store's location.
• Phone – Your Store's Phone Number
• Last, First & Middle Name – The Name of your Contact Person.
• Title – The title of the Contact Person.
• Phone 1 & 2 – Your contact's Phone number.
• Fax – The Fax number for the Contact.
• Email Address – Primary store contact email address

Click on the “Save” icon. Now you're ready to begin adding Categories, Products and Manufacturers.

5.4. Manufacturer Administration

Manufacturers are associated with products, providing web site, contact, and descriptive information. Each product that is created is associated with a Manufacturer.
For stores where manufacturer information is not necessarily relevant, a default manufacturer is created upon installation.
It is not necessary to create manufacturers prior to creating your catalog. Products can be re-associated to manufacturers after all the product records have been created. However, creating the manufacturers first can save a lot of extra work if you already know that you will be using this information.

5.4.1. Manufacturer Categories
Manufacturer Categories are used to group Manufacturers into different categories.
mambo-phpShop creates the manufacturer category name “-default-» upon installation. It is not necessary to change this.
To create a new manufacturer category, select «Manufacturer | Add Manufacturer Category».

• Category Name – The name of the Manufacturer category.
• Category Description – A description of the Manufacturer category (optional).

Click on the “Save” icon. You will be redirected to the “Manufacturer Category List” page, showing the “-default-» category, and the new category you just entered.
To edit an existing manufacturer category, select «Manufacturer | List Manufacturer Categories» in the mambo-phpShop admin menu. This will return a list of existing manufacturer categories.
Click on the name of the manufacturer category you want to edit, make any necessary changes to the fields (listed above), and click on the “Save” icon.
You will be returned to the Manufacturer Category List.

Deleting Manufacturer Categories
Before deleting an existing manufacturer category, all manufacturers associated to that category must be removed through either deletion or re-association to a different manufacturer category. mambo-phpShop will not allow the deletion of a manufacturer category while manufacturers still exist for that manufacturer category. See below under “Manufacturers” for information on re-association and deletion of a manufacturer.
Once the manufacturers have been removed, select «Manufacturers | List Manufacturer Categories» from the mambo-phpShop admin menu. Click on the name of the manufacturer category you want to delete. In the Manufacturer Category Form, click on the “Remove” icon. Click “OK” to confirm that you are sure you want to delete this category. You will be returned to the Manufacturer Category List.
Note that the manufacturer category you deleted is no longer listed. To recover this record, you must create a new manufacturer category, and re-associate any manufacturers that belong in that manufacturer category.

5.4.2. Manufacturers
Adding Manufacturers
To create a new manufacturers, select «Manufacturer | Add Manufacturer» in the mambo-phpShop admin menu.
Edit the following fields in the Manufacturer Information Form:

• Manufacturer Name – The manufacturer's name or company name.
• URL – http://www.example.com – The manufacturer's fully qualified web address.
• Manufacturer Category – The manufacturer category this manufacturer will be associated with.
• Email – The manufacturer contact's email address.
• Description – Information promoting or about the manufacturer.

Click the “Save” icon to create your new manufacturer.

Editing Manufacturers

To edit an existing manufacturer, select «Manufacturer | List Manufacturers» to see a list of all manufacturers. You may also get to this screen by clicking on the linked text, “Manufacturer List”, in the Manufacturers column on the Manufacturer Category List screen.
Click on the name of the manufacturer you would like to edit, or click on the linked text “update” in the Admin column – either will take you to the same Manufacturer Add Information form. Make your changes in the Manufacturer “Add Information” form (described above), and click on the “Save” icon. You will be returned to the Manufacturer List screen.

Deleting Manufacturers
Before deleting an existing manufacturer, all products associated to that manufacturer must be removed through either deletion or re-association to another manufacturer. mambo-phpShop will not allow the deletion of a manufacturerwhile these child records still exist for that manufacturer.
Once these child records have been removed, select «Manufacturer | List Manufacturers» to see a list of all manufacturer. Then click on the name of the manufacturer you would like to delete. In the Manufacturer Add Information form, click on the “Remove” icon. You will be returned to the Manufacturer List screen.
Once this manufacturer has been deleted, it is removed from the system. To recover this manufacturer, you must re-create the manufacturer information, and re-associate all appropriate products.

5.5. Product Administration

mambo-phpShop offers the ability to categorize products not only by vendor, but also by product category. Product categories may also contain subcategories enabling storekeepers manage their products in as much detail as possible. Because products and product categories are associated to a particular vendor, it is important to create your vendor records before creating the product and product category records. When creating your product records, it is important to make a distinction as to whether the product that is being created can be uniquely identified by its nature or name (e.g. Compact Disks, Video Cassettes, Books, etc.), or is one of many similar items that are uniquely identified by their attributes (e.g. Apparel, Furniture, Automobiles, etc.). The reason this distinction needs to be made, is because the methods for creating, editing and deleting differ for each. Items require the creation of Item Attributes, but products do not.

5.5.1. Product Categories
Adding Product Categories
mambo-phpShop includes the ability to associate products to product categories and subcategories to enable better site management. To create a new product category, open the Product Category Form: “Products” => “Add Category”.

Product Category Fields

• Publish? – Used to specify whether the category will be published on the site.
• Category Name – The name that will be used to identify the category.
• Category Description – The description that will be displayed for the category.
• List Order? – The Place of this category in a list with other categories.
• Parent – The parent category with which this category will be associated. If the category is to be a top level category, leave the Parent drop down list with the Default Top Level selected.If the category is to be a sub category of an existing category, choose the appropriate parent category from the Parent drop down list.
• Category Browse Page – Пример: browse_1 – The template file for displaying the products of this category in a list.
• Show x products per row – The number of products per row when displaying products of this category.

На заметку
The Browse Page usually has to be adjusted when the number of products per row has been changed. You can use browse_2 for 2 products per row, browse_3 for 3 products per row and so on (maximum per По умолчанию: 5).

• Category Flypage – Syntax: shop.flypage – This is the template file for displaying the Product Details of a product in this category. You can create your own templates by modifiying existing templates (in the directory /html/templates). The file for preparing the display of the Flypage is /html/shop.product_details.php. Some of the details that you can't find in the Flypage template can be found there.

На заметку
You should leave this field empty when you're not sure what to fill in.

Editing Product Categories
To edit an existing product category, you have to access the Category Tree: “Products” => “List Categories”. Now click on the name of the product category you want to edit to display the product category entry form for that product category. Make your changes and click the Save button at the top of the form to update the product category.

Deleting Product Categories
Before deleting an existing product category, all sub categories associated to the product category must be removed through either deletion or re-association. mambo-phpShop will not allow the deletion of a product category while subcategories still exist for that product category. Once all subcategories have been removed, access the Category List via “Product” => “List Categories”. Either you click on the Trash Bin icon in the last column of the category you want to delete OR you click on the name of the product category that you want to delete to display the product category entry form for that product category. Then click on the Delete button at the top of the form to delete the product category.

5.5.2. Products
Adding / Updating? Products
To create a new product, click on “Products” => “Add Product” to display the product form. Complete the product entry form and click the Save button in the top right corner to save the new product.
When Updating a product, just click on the Product Name in the Product List to display to Product Form of that product.

Product Form

• Publish? – Used to specify whether the product will be published on the site.
• SKU – Means Article Number. Stock keeping unit ( SKU) is an identification, usually alphanumeric, of a particular product that allows it to be tracked for inventory purposes.
• Name – The name that will be used to identify the product.
• URL – A URL that can be displayed with a product. Usually used as a link to the product vendor or manufacturer.
• Category – The product categories with which this product will be associated.
• Vendor – The vendor with which the product will be associated.
• Manufacturer – The manufacturer with which the product will be associated.
• Retail Price – The price for the default Shopper Group. Just fill in a decimal number. Select the Product Currency from the drop-down list at the right.
• VAT ID – The ID of the tax rate that will be applied to this product. Here you can select a specific tax rate for this product. If you don't want that this product is taxed, fill in a zero weight at “product weight” and Disable “Virtual Tax”.
• Short Description – The short description that will be displayed on the browse (overview) page for a category or search result.
• Flypage Description – This is the details description that will be displayed on the Flypage (=details page) of this specific product.
• Quantity in Stock – The current quantity in stock for the item. Used for shipping and inventory purposes.
• Availability Date – When the current quantity in stock is available for distribution. Used for shipping and inventory purposes.
• Availability Text / Image – This is used to display it on the product details page. E.g.: “48 hrs.” or “On Order”. Alternatively you can select an availability image from the drop-down list below.

Совет
You can use your own images here! Just copy them to the direcory /shop_image/availability and then you can select them here.

• On Special? (Featured?) – Used to indicate whether there are any specials running for the product. When checked, this product will be displayed on the “Featured Products Module”.
• Discount Type – The type of special being run on the product. Select a discount from the discount list. When there are no discounts, create one using the Product Discont Form.
• Advanced Attribute List – Syntax: Size,XL[+1.99],M,S[-2.99];Colour,Red,Green,Yellow,Expensive Color?[=24.00];And So On?,..,.. – Adds easy attributes to the product. These are attributes which can be selected by a customer. This does not create items for each attribute value! If you want to check the stock on each item (e.g. green, red and black T-Shirts...use the Attribute Form to add Attributes and after that Items for each Attribute Value using the Item Form.
• Custom Attribute List – Syntax: Attribute 1?;Attribute 2?;Attribute 3? – Adds custom attributes to the product. These are attributes which can be selected by a customer. This does not create items for each attribute value! If you want to check the stock on each item (e.g. green, red and black T-Shirts...use the Attribute Form to add Attributes and after that Items for each Attribute Value using the Item Form.
• Length – The length of the product. Used for shipping purposes.
• Width – The width of the product. Used for shipping purposes.
• Height – The height of the product. Used for shipping purposes
• Unit of Measure – Dimensions – The unit of measure used in determining the LWH of a product. Used for shipping purposes.
• Weight – The weight of the product. For shipping purposes.
• Unit of Measure -Weight – The unit of measure used in determining the weight of a product. Used for shipping purposes.

Важно
Allowed UOM are

• po / pound(s)
• kg /kilogram(m)(s)
• ou / ounces
• lb / LB

• Downloadable Product? – When this is a downloadable Product (a file...), just check the box and fill in the File Name (without path!) OR Upload a File.
• Filename – Here you can specify a Filename for this product. The file has to be uploaded manually via ftp!
• Upload a file – Here you can upload a file.

Важно
The Filename (previous Field) overrides this Field!

• Thumbnail – A thumbnail image that can be displayed along with the product.
• Full Image – A larger image that can be displayed along with the product.

На заметку
If you have enabled Dynamic Thumbnail Resizing, the Thumbnail here won't be automatically created from the Full Image!

Now you're done. Just click on “Save” and you're Product Add / Update Results are shown on the next page:

Deleting Products
To delete an existing product, click on “Products” -> “List Producs” at the top of the mambo-phpShop Administration pages to display a list of product categories. Now click on the Trash Icon in the row of the product you want to delete and confirm that you “want to delete this record”.

5.5.3. Product Attributes
Adding Product Attributes
To create a new product attribute, click on “Products” => “List Products” to display a list of all products. Then click on the name of the product for which the attribute is being created to display the product entry form for that parent item. Then click on the “Add Attribute” button on the top of the screen. A new window will open displaying the attribute entry form. Complete the attribute entry form and click the Save button at the top of the form to save the new item attribute. Next, you need to define the new attribute for the items. Click on the name of an item to display the product entry form for that item. Populate the new item attribute field in the product entry form and click on the Save button at the end of the form to save the new item attribute definition.

Product Attributes Form Fields

• Name – The name used to identify the attribute.
• Number in List – The order in which the attribute is listed.

Editing product Attributes
To edit an existing product attribute, click on “Products” => “List Products” to display the list of products. Then click on the name of the parent product for which the attribute is being edited to display the product entry form for that parent product. Then click on “Products” => “Current Product” => “List Attributes” in the top menu. A new window will open displaying a list of product attributes assigned to the product selected. Click on the name of the attribute you want to edit to display the attribute entry form for that attribute. Complete the attribute entry form and click the Save button at the top of the form to update the item attribute.

Deleting Product Attributes
To edit an existing product attribute, click on “Products” => “List Products” to display the list of products. Then click on the name of the parent product for which the attribute is being edited to display the product entry form for that parent product. Then click on “Products” => “Current Product” => “List Attributes” in the top menu. A new window will open displaying a list of product attributes assigned to the product selected. To delete an attribute, click on the Trash Bin icon in the last column of the row of the attribute you want to delete.

5.5.4. Items
Going back now to offering variations on a product: If you want to offer a fixed list of variations for your customer to choose from, rather than allowing them to pick and mix attributes as they please, you need to create some ‘items’. Note: These are different from the content ‘items’ in Mambo itself. An item in mambo-phpShop is a pre-defined variation on the main product. In order to create an item, you have to set up at least one attribute first. Hence, it is only after you have added an attribute that the ‘New Item’ toolbar button and its related menu option appear.

Adding Items
To create a new item, a parent product must exist / be created first. When completing the form, keep in mind that the product information, product dimensions, and product images entered here are the ones that will be displayed initially for all items. Once a specific item is selected by the customer, the product information, product dimensions, and product images for that item will be displayed. Next, the attributes that will be used to identify the items need to be created. Open the Product Form of the Parent Item you create in the first step.
Click on “Add Attribute” and a new window will open displaying the attribute entry form. Complete the attribute entry form and click the Save button at the end of the form to save the new item attribute. Once all item attributes have been defined, it is time to create the individual items. Click on the Add Items button on the left side of the screen to display the product entry form for the specific item. This form is the same as previous product entry forms only the vendor and category fields have been populated for you, and item attribute fields for the attributes you have defined are now available. Complete the product entry form and click the Save button at the end of the form to save the new item.

Editing Items
To edit an existing item, open the product List and click on the “Item Information” Link behind a Product. You will be presented a List of all Child Items of that product. If you want to make changes to a specific item, click on the name of the item you want to edit to display the item entry form for that item. Make your changes and click the save button at the end of the form to update the item. Click on the Return to Parent Product link at the top of the page to edit another item.

Deleting Items
To delete an item, List the Product's Items like in the previous section. Then click on the basket at the end of the row of the item you want to delete. If you want to delete all items, you must delete each item before deleting the parent item.Once all items have been deleted, click on the Delete button at the end of the product entry form of the parent item to delete the parent item.

5.5.5. Product Discounts
Discounts in mambo-phpShop must be created in the Product Discount Form before being able to assign a Product to a specific Discount.

Предостережение
When updating a discount, your changes apply to all products which are assigned to this discount.

Adding / Updating a Discount
Go to “Product” -> "Add / Edit? Product Discount”.

Now fill in the details for this Discount Record:

• Discount Amount – required – This is the amount of discount you want to have subtracted (added) from the product price. – Has the syntax: 000.0000 (no comma!)
• Discount Type – required – The Discount Type specifies how the amoung is handled: either as a percantage or as a total amount. If you select “Percentage”, the amount will mean that you give a Discount of XX % to the Product Price. If “Total” is selected, the amount will be substracted (added) from the Product Price.
• Start Date – optional – By clicking on “..." you can specify a date from the calendar, which will be the first day, the Discount is calculated and shown to the customer. The Start Date is no must. You can also only have an End Date or leave this field blank when this discount shall begin instantly.
• End Date – optional – If you have specified a Start Date, you'll surely want an End Date – that would be something like “Sale”. So click on “..." and specify the last Day of the Sale from the calendar. You can also only have an Start Date or leave this field blank when this discount is not limited.

When you're done, don't forget to “Save” your information.

Deleting a Discount
You can easily delete a discount. Note that this removes the Discount from all products which are assigned to it.
Just go to the Product Discount List and click on the Trash Icon of the row of the Discount you want to delete at the right side of the List. Confirm that you “want to delete this record” and done.

5.6. User Management

mambo-phpShop offers the ability to not only manage users by vendor, but also by shopper group. This enables storekeepers to create shopper groups for whatever need (e.g. site access, customer rating, etc.). These shopper groups can then be used to provide special services, discounts, or access to a specific group of users. Because users and shopper groups are associated to a particular vendor, it is important to create your vendor records before creating the user and shopper group records.
mambo-phpShop also provides the ability to create any number of addresses for a particular user. Not only can a user have separate bill to and ship to addresses, but addresses for home and business as well.

5.6.1. Shopper Groups

5.6.2. Users

5.6.3. Shopper Groups

5.7. Order Administration

Your shop is online, your catalogue is bursting at the seams, you’ve run all of your payment processing tests, and you’re ready to go live! Well, maybe not quite. You need to know what to do when those orders come flooding in. When someone orders a product through your mambo-phpShop website, a record is created in the system with the details of the order.
The order record has a ‘status’ to indicate where the order is in the stream of events – for example, whether it has been paid for, shipped, or cancelled. The actual values you use for status are up to you, but by default you are given status values of Pending, Confirmed, Cancelled, Refunded, and Shipped. If you want to define your own status values, you can do so by selecting ‘List Order Status Types’ from the ‘Order Status’ sub-menu of the ‘Orders’ menu.
To view all of the orders in the system, click on ‘List Orders’ on the ‘Orders’ menu. This takes you to the Order List which is illustrated in the next figure.

5.7.1. The Order Status List
Order List
When you click on an order number, you are given the full details of the order as shown in the next figure. You also have the ability to scroll through all of the order details using the ‘prev’ and ‘next’ links at the top of the page. The rest is up to you!

5.7.2. The Order Details

5.8. Vendor Administration

Warning
THIS PART OF MAMBO-PHPSHOP STILL IS NOT COMPLETE. IT'S NOT RECOMMENDED TO USE THIS FEATURE.

Vendors and Vendor Categories represent the top most tier of mambo-phpShop administration. Through vendor administration, the store keeper is able to manage products, users, and orders by vendor or supplier.

TODO – heirarchial drawing
For simple stores where there are only a few products offered, vendor administration is not necessarily needed, but for larger more complex stores, such as an online mall, vendor administration can be essential.
Since all products, product categories, users, and orders are associated to the vendor record, establishing the vendor and vendor category structure is the first step to building the online store.
Note that it is not necessary to create the vendor categories first. Vendors can be re-associated to vendor categories after all the vendor records have been created. However, creating the vendor category records first can save some extra work if you already know how you want to categorize your vendors.

5.8.1. Vendor Categories
Vendor categories are a way to classify the types of goods and services that vendors offer on your site. For example, you may have an online mall for buying and selling furniture. You may want to create vendor categories such as “Antiques”, “Office Furniture”, and “Patio Furniture”.
Note that a vendor on your site can only be associated with a single vendor category, so it is important to use categories that are broad enough to represent the shopper's choice of storefronts. For example, “Antique Furniture” and “Vintage Clothing” would not be broad enough categories if you have a vendor that sells both types of items. In this case, you might want to use “Antiques” as your vendor category.

Viewing Vendor Categories
TODO: access the vclist
TODO: search

Adding Vendor Categories
mambo-phpShop creates the vendor category name “-default-" upon installation. It is not necessary to change this unless you choose to fully utilize the vendor category functionality.
To create a new vendor category, select «Vendor | Add Vendor Category» from the mambo-phpShop admin interface.

Add a Vendor Category
This will bring up the Vendor Category Form.

Vendor Category Form
Vendor Category Form Fields

• Vendor Category Name – The name used to identify the vendor category.
• Vendor Category Description – The description of the vendor category.

Click on the “Save” icon.
You will be redirected to the “Vendor Category List” page, showing the “-default-» category, and the new category you just entered.

Vendor Category List
You may also add a new vendor category with the Vendor Category Form by clicking on the “New” icon from the Vendor Category List Screen.

Editing Vendor Categories
To edit an existing vendor category, select «Vendor | List Vendor Categories» in the mambo-phpShop admin menu.

List Vendor Categories
This will return the Vendor Category List screen (shown above).
Click on the linked text showing the name of the vendor category you would like to edit to bring up the Vendor Category Form.

Access a Vendor Category
When you have finished making changes, click on the “Save” icon.
You will be redirected back to the “Vendor Category List” screen.

Deleting Vendor Categories
In older versions of mambo-phpShop, all vendors associated to a vendor category had to be removed or re-associated to a different vendor category before mambo-phpShop would allow deletion of the vendor category.
This is no longer the case. In mambo-phpShop 1.2b3, if you remove a vendor category all vendors in that category will be reassigned to the “-default-» vendor category that was created upon installation. You can then re-associate the affected vendors if needed, as described below under “Vendors”.
There are two ways to delete a vendor category. The first way is to access the vendor category record by clicking on its name in the “Category Name” column of the Vendor Category List.

Vendor Category Deletion
This will bring up the Vendor Category Form.
Click on the “Remove” icon.
You will be redirected back to the “Vendor Category List” screen.
The second way to delete a vendor category is from the Vendor Category List screen. Click on the trash can icon in the “Remove” column next to the name of the vendor category you would like to delete.
Click 'OK' to confirm deletion of this category.
When you are ready to proceed, you may easily navigate to the vendor list by clicking on the linked text “list” in the “Vendors” column of the Vendor Category List.
This will open the Vendor List page.

5.8.2. Vendors
Vendors are the main organizational factor in mambo-phpShop. Products and product categories, billing options, etc. are all configured per-vendor.
Upon installation, a global, default vendor is created. This special case cannot be deleted, and is managed separately via the «Store | Edit Store» menu option.
If you are running a shopping site for a single vendor (for example, if you are the only vendor that will be offering products in your store) then there is no need to create additional vendors. If, however, you will be running an online mall site that will be host to several vendors, then create one vendor account for each storefront owner.
It may be worth noting here that you should not confuse vendors with manufacturers. A single vendor may have a different manufacturer for each product that they offer. If the person supplying the products on your site will be managing their own shipping, etc., then they are a vendor. If you will be managing these aspects, then the supplier is a manufacturer. (See Manufacturer Administration for more information on that topic).

Adding Vendors
To create a new vendor, select «Vendor | Add Vendor» in the mambo-phpShop admin menu.

Edit the following fields in the Vendor Information Form:

• Full
  

  6. Known Problems

  • “problematic” Product Names could mess up Email Generation HTML code
  
  

  7. To-Do List

  7.1. Not implemented Payment Gateways

  • Payfuse
  • pppay.com
  • Bluepay
  • Dtaus Export / bankwithdraw (wired support)
  • Ogone
  • 4b pasat
  • Ikobo
  • ProtX
  • Verisign

  7.2. Uncomplete/Untested Payment Gateways

  • 2Checkout
  • NoChex
  • PayMeNow
  • EPN 
  • deprecated: CyberCash

  7.3. Wishlist / Not implemented Features

  • Currency Selector in the Frontend [Feature Request #3344]
  • Multi-Language Support [Feature Request #1404]
  • Product Syndication/Data feed management [Feature Request #3569]
  • better Template System, spearation of Code and Design [Feature Request #3079]
  • DHL / FedEx / USPS Shipping modules
  • Related Products
  • Meta Description/Keywords for products
  • Quick-Add: Discount on *all* Products
  • allow “send as gift” with individual text on order
  • add/edit/delete States for Countries
  • streamlined Checkout
  • Shipping based on Cart Total
  • Shipping Total as percentage of Cart Total
  • Price Quantity breaks / Volume Discounts
  • Allow “Copy product” to simplify building up the product database

  7.4. General

  • improve performance
  • improve Security
  • Clean up code
  • XHTML compliance
  • Clean up checkout
  
  

  8. About

  8.1. The project

  mambo-phpShop is an Open Source E-Commerce solution, which is based on a Shopping Cart Script called “phpShop” (originally developed by Edikon Corp. and the phpShop community (http://www.phpshop.org).
  mambo-phpShop is a separate Fork of the phpShop script. Now there are a lot of differences between the original phpShop™ and mambo-phpShop. They don't use the same code base.
  mambo-phpShop is released under the GNU Public License, which means by the end, it free for download and use.
  There's a small bunch of developers who help in pushing this Shopping Script towards professionality and usability. The author of this documentation is the Lead Developer...and having not much time besides Wife, Work & Studies.

  8.2. The Community

  Since mambo-phpShop is free and Open Source Software, everyone using it can and should contribute to this project.
  You can send your code snippets, hints and everything else helpful to the Homepage of the project: http://mambo-phpshop.net.
  There's also an active Forum, where discussion and bug reporting can take place: Forum.

  8.3. The Documentation

  Этот документ был создан в XMLMind XML Editor с использованием DocBook XML Format.
  DocBook содержит набор элементов форматирования, удобных для разметки текста, так что этот текст может быть сохранен в нескольких разных форматах. Документы можно создавать в форматах: PDF, HTML, HTML Help (.chm файлы для справочной системы Windows), XML, RTF, TeX, WordML (Word 2003) и других. Автор этого документа создает документы для конечного пользователя при помощи eDE. Идея в том, чтобы сделать эту информацию доступной для максимально возможного числа людей. Digital information not stored properly tends to get lost. Due to the fact that not containing uncommon characters (such as binary formats) it's possible to index and search directly on the documents written on SGML and consequently on DocBook. The SGML systems use markups to make their description. DocBook holds over 300 markup elements each one with several attributes which can assume several values, these can be fixed or defined by the document / style that the author has used.