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