Product Groups

Product groups are containers for groups of products located in a particular shop.

With product groups, you can organize products in any way you’d like – in groups or subgroups, and with access to a number of functions to make your life easier.

In Dynamicweb, products and product groups are very rich objects, with loads of properties, settings, options and abilities – and things can get pretty complicated.

Selected features are:

  • Set default values for a number of product details on the group level, and save time when working with products
  • Create product categories and product category fields, and have products located in the product group inherit the values
  • Add media and other information to a product group, and render the information on the frontend

 

manual

In this section you will learn about:

  • Creating, moving, attaching and deleting product groups
  • The basic (details) settings available when creating or editing a product group
  • Your options when interactiv with the buttons in the ribbon bar

To create a new product group:

  • Click Ecommerce on your accordion
  • Open the Product catalog on your Ecommerce
  • Right-click the shop under which you want to create a new product group (or right-click an existing product group to create a subgroup)
  • Click New group (Figure 3.1)
Figure 3.1 Creating a product group

This opens the details view for the new group, which is where you configure your product group settings.

You can edit or delete a product group by right clicking the product group in the Ecommerce tree (Figure 4.1).

Figure 4.1 the right-click menu gives you access to a number of useful actions for product groups

With the right-click menu, you can:

  • Create, edit, attach or delete groups and subgroups
  • Create, attach or sort products in the group
  • Set backend permissions for the product group. Read about permissions here

Attaching a group to another group (or to a shop) makes the group, and all products in it, a subset of the parent group. Groups can be attached to more than one group at the time.

Deleting an attached group will delete all instances of it, and all products located in the group, unless they are also members of other groups. Deleting a group with subgroups will also delete the subgroups.

To move a group, simply drag and drop it from its location in the shop tree to the desired location. This will open a menu, where you can choose between moving the group (and thus removing it from the original destination) or attaching it (Figure 4.2).

Similarly, attaching a product to a group does not copy or remove it from its original group, but creates a group relation. To remove an attached product from a group, remove the group-relation from the product details - if deleted, it will be deleted in all product groups.

Figure 4.2 Attaching groups to another group is easy - simply drag & drop it, and select 'Attach to this group'

When creating or editing a product group, you will have immediate access to the details view – which is the view you need, when configuring a group at the most basic level. More advanced options and settings are available from the product group ribbon bar.

In the following sections, you can read about the basic configuration options you have for product groups.

The more advanced options and settings available to you from the ribbon bar are described under the Implementing section of this document.

The first thing you will usually see is the basic product group settings (Figure 6.1).

Figure 6.1 The most basic product group settings

With the basic product group settings, you can:

  • Provide a name and number for the group. The product group name will be used in the frontend product catalog, and the product group number may be relevant for integration purposes, or simply as an identifier if you have two groups with the same frontend name.
  • Select a product category for all products belonging to this group (or leave it as ‘None’). You create new product categories from Management center > eCommerce > Product catalog > Product Categories.

You cannot edit the Id field. This is a unique identifier given to all products, groups and shops and it is used, for instance, when integrating Dynamicweb Ecommerce with third party solutions.

After the most basic settings, you will see the media settings (Figure 7.1).

Figure 7.1 The product group media settings

With the media settings, you can:

  • Attach a small and large picture to the product group in frontend
  • Select an icon for the product group, which will be displayed on the list of groups instead of the standard folder icon in backend

Default group images

You can set default images for product groups by going to Management center > Ecommerce >Advanced configurations > Images and locating the group default images area (Figure 7.3).

 

Figure 7.3 Set default images for product groups in the management center

With the meta-information fields (Figure 8.1), you can create meta-information about the product group.

Meta information is used by search engines to index searches, and can have an effect on how your website is ranked.

Figure 8.1 The meta information fields

You can specify:

  • A title, one or more keywords, and a description
  • A canonical URL, for search engine indexing purposes. The page displaying the product group will then be regarded as an instance of the canonical URL.
  • A user friendly URL for the group (if empty, the system will use the product group name)
  • A primary page for the product group (if you use it in several shops, and across several product catalogs).

To use canonical or other types of custom URLs for your product group, you must first enable them under Management center > WEB and HTTP > Customized URLs. Make sure you’ve checked the following checkbox:

Figure 8.3 Don't forget to enable customized URLs in the management center

With the default values settings (Figure 9.1), you can – well – set default values for products created under this group.

Figure 9.1 Set default values for new product here - and force those values onto your products by using the green checkmarks

Setting these can optimize your workflow when creating multiple products with the same manufacturer, VAT group or stock status.

  • To create Manufacturer values go to Management Center > Ecommerce >Product Catalog > Manufacturers.
  • To create VAT group values go to Management Center > Ecommerce > Internationalization > VAT groups.
  • To create Stock Status values go to Management Center > Ecommerce > Orders > Stock States.

Using this feature does not preclude you from using other values.

The green checkmarks are for making this selection apply to all products in the groupe.g. forcing the value onto existing products. You have to do this separately for each shop language.

If you have created any Sales discounts of the Product discount-type on your solution, you can select which (if any) sales discounts should apply to the products in this group (Figure 10.1).

Figure 10.1 Apply sales discounts on all products in a product group with these settings

Depending on your setup, you may have access to one of more types of custom fields on your product group details:

  • Product group fields, which are custom fields which occur on all product groups on a solution
  • Product category fields, which can be created an selectively attached to product groups. Products created in that group will then inherit the fields (and field values).

Read more about both types of custom fields in the Implementing section.

If you click the Description button, your view will switch from the default Details view (where you provide the product group details) to the description view (Figure 12.1).

Figure 12.1 The description view

The description view basically gives you access to a rich text editor, where you can provide a description for the product group.

From the product group ribbon bar (Figure 13.1), you also have access to a number of more advanced settings and options for a product group.

Here's a basic overview of what the buttons do, but most of these areas are described more thoroughly elsewhere.

Figure 13.1 The ribbon bar gives you access to a lot of advanced functionality

The Location button gives you access to the location view (Figure 14.1).

Figure 14.1 The location settings

From here, you can:

  • See the parent group (if any) and parent shop of the product group
  • Enable or disable product category inheritance from parent groups – read more below.
  • Select which parent group is the primary parent group (if any). 

Order line fields give you the opportunity to provide extra information about products in the order process. Order line fields can be inherited from the parent group of a product.

To add order line fields to the products in a product group, click the order line fields button (Figure 15.1) on the ribbon bar.

Figure 15.1 The Order line fields button

This allows you to attach any order line fields you have created to a product group – and shows you the order line fields view (Figure 15.2).

Figure 15.2 The order line fields view

From here, you can see which order line fields are attached to the group, and whether they are set to be inherited from the parent group or not. 

To delete an order line field, click the red X-icon to the right of the order line field entry. Inherited order line fields are shown in a separate list.

 

If any of your order discounts are set to be assignable from product catalog, you can use the discounts-button (Figure 16.1) to assign a product to a discount directly from the product group.

Figure 16.1 Add discounts to a product group by clicking the Discounts button

To do so:

  • Click the little arrow-icon on the discount button and select either Manage including discounts or Manage excluding discounts. This opens a window showing the discounts you have made assignable from the Management Center.
  • Select the discounts you want to include the product group in
  • Click save and close
  • The discount will be added to the discount overview for the product (Figure 20.2)
Figure 16.2 The discounts overview

Read more about order discounts, sales discounts, including/excluding discounts and much more in the discounts documentation.

From the product group ribbon (Figure 17.1), you have access to the navigation options for the product group.

Figure 17.1 The navigation options allow you to control how a product group behaves in regard to navigation

With the navigation options, you can control whether a product group should appear in the menu, in the sitemap, and if it should be clickable.

To enable or disable a setting, simply click the appropriate button.

From the product group ribbon (Figure 18.1), you have access to the New products options for the product group.

Figure 18.1 The new product settings lets you set default behavior for products created in the product group

The New products settings allow you to create default behavior settings, and are only applicable when creating new products in the product group.

You can:

  • View or add one or more default related groups for new products created in this group – products created within this group are then automatically added to all the related groups.
  • View or add any default related products for new products created in this group.
  • Add a smart search which will automatically populate the list of related products for all products in the product group (e.g. a smart search finding red lamps, for a red-sofas product group, or something). Read more about product smart searches.

All related product groups, products and searches can be viewed and edited from the product details of a product - read more here.

From the product group ribbon (Figure 19.1), you have access to the Language and localization settings for the product group.

Figure 19.1 The language and delocalization buttons

The Language dropdown shows the current working language. When you create a new group it is created in the default language and in the working language.

With the Delocalize button you can remove the language-specific versions of a group, i.e. non-default languages. To do so, change the language to go to the localized instance of the group and click delocalize.

 

Delocalizing groups in the standard language

Note that you cannot delocalize standard language versions of a group – they must be deleted instead. Deleting a product group in the default language, however, also deletes all products in the product group. Treat with caution!

implementing

As stated in the introduction, products and product groups in Dynamicweb are very rich objects, with loads of properties, settings, options and abilities. Things can get pretty complicated. In this section, you can read about some of the more advanced native properties of product groups – options which should only need to be set up once or very rarely.

In this section you will learn about:

  • How to create and apply product group fields on your Ecommerce
  • How to create product category fields and control product category field inheritance

Product group fields are custom fields, which you can create, and which will then be available on all product groups.

When creating or editing a product group, you will then have access to the custom fields.

Product group fields on a product group could look like Figure 21.1.

Figure 21.1 Product group fields are available on all product grops on your solution

To create a product group field:

  • Go to Management center > Ecommerce > Product catalog > Product group fields
  • Click New field in the toolbar (Figure 24.2). (If editing an existing field, simply click it)
Figure 21.2 Click the New Field button to create a new field
  • This opens the Product group field window (Figure 21.3)
Figure 21.3 Creating a new product group field

From here, you must:

  • Specify a name and a system name for the field
  • Provide a template tag-value for the field. Use this value in your templates to render the field content on the frontend. Read more about template tags for product groups below.
  • Select a field type for the field – see table below
  • Decide if the field requires validation or not (i.e. if it is required or not)

The field types available to you are:

Field type

Function

Text (5-255)

Standard text field where you can type between 5 and 255 characters

Editor

Inserts a WYSIWYG editor where you write a text using various text editing tools.

Long text

Inserts a text box where you can type several thousand characters.

Checkbox

Inserts a checkbox

Date

Inserts a drop down where a date can be selected

Date/time

Inserts a drop down where a date and time can be selected

Integer

Inserts a field where integers can be entered

Decimal number

Inserts a field where decimal numbers can be entered

Link

Inserts a field where you can enter a link to another web page or a file in your File Manager

File Manager

Inserts a field where you can select a file from your File Manager

List box

Inserts a list of options that can be selected/deselected. This option comes with extra settings, see below.

List box options

If you create a list box field, you will have extra options available to you (Figure 22.2).

You must:

  • Choose between list box types, radio button, checkbox, dropdown, and multiselect, in the Display as dropdown
  • Specify a name and a value for each of the list box options
  • Choose whether you want each option to be selected by default or not
Figure 22.2 Creating new list box opions

Product category fields are used to extend the products in a particular group (and subgroups) with custom (and possibly inherited) fields and field values.

The process is straight forward:

  • Create a number of product categories (e.g. wine, spirits and beer) and associated fields
  • Attach product categories to product groups, and create default field values
  • Customize which fields should be inherited by which subgroups

Once you have configured your product category fields, you can then enter custom values (or restore default values) from the edit group view – values, which will then be present on all new products located in the product group.

Here are the details!

To create a product category:

  • Go to Management Center > Ecommerce > Product catalog > Product categories
  • Click New in the toolbar (Figure 27.1)
Figure 24.1 Click New in the toolbar to create a new product category

This will take you to the Product category view (Figure 24.2).

Figure 24.2 The product category view

From here, you can:

  • Specify a name for the product category, which will be used as the section name when editing a product or product group with product category fields (a system name will be generated based on the name).
  • Add any number of fields to the product category – and name them and select a field type (a system name and template tag will be generated based on the name).

The field types available to you are:

Field type

Function

Text (5-255)

Standard text field where you can type between 5 and 255 characters

Editor

Inserts a WYSIWYG editor where you write a text using various text editing tools.

Long text

Inserts a text box where you can type several thousand characters.

Checkbox

Inserts a checkbox

Date

Inserts a drop down where a date can be selected

Date/time

Inserts a drop down where a date and time can be selected

Integer

Inserts a field where integers can be entered

Decimal number

Inserts a field where decimal numbers can be entered

Link

Inserts a field where you can enter a link to another web page or a file in your File Manager

File Manager

Inserts a field where you can select a file from your File Manager

List box

Inserts a list of options that can be selected/deselected. This option comes with extra settings, see below.

List box options

If you create a list box field, you will have extra options available to you (Figure 25.1).

You must:

  • Choose between list box types, radio button, checkbox, dropdown, and multiselect, in the Display as dropdown
  • Specify a name and a value for each of the list box options
  • Choose whether you want each option to be selected by default or not
Figure 25.1 List box options

When you attach a product category to a product group, all the products in the group will be extended with the fields defined in the product category. 

Figure 26.1 Attach a product category to a group by using the Product category dropdown in the settings area

To attach a product category to a group:

  • Edit the group whose products should be extended with category fields
  • Select the product category in the in the drop down in the Settings box
  • Click OK to the popup appearing with  a warning
  • Save the group and confirm again
  • Now all products in the group has been extended with the defined product category fields

Note: The category field values for all the products in the group will be lost when changing an existing product category on a group. 

You can define default category field values on the product group. Note that these values are both inherited to groups and products below the parent group (Figure 27.1).

Figure 27.1 Default product category values

To set default values on a group:

  • Edit a group with a product category attached
  • Scroll down to the bottom of the edit group frame
  • All the product categories on the group will have an individual box containing all their fields
  • Input default text or default options in these fields to apply to all the products in this group that do not have a value explicitly set

You can always override the default values on the product if needed

You can control what category fields are inherited from groups to subgroups under the Location button in the ribbon (Figure 28.1).

Figure 28.1 Control inheritance by customizing the Location settings

Here you can select the parent group(s) from which to inherit category fields. If several groups are selected, the available fields will be a merge of all the parent group fields. 

To enable or disable product category inheritance:

  • Edit the group where you want to enable inherit categories
  • Click the Location button in the ribbon
  • Click the red cross for the groups whose categories should be inherited
  • Click the green checkmark for the groups whose categories should not be inherited
  • Save the group

Once you have parent groups defined, you can see the inherited product category fields when editing a product (Figure 29.1).

Figure 29.1 You can fill out your own values when editing a product - or use the default inherited values. Click the blue icon to restore the default value.

With the blue arrows, you can restore category field values to the default defined on the parent group(s).

When a field has an inherited value the text is dimmed (Figure 29.2).

Figure 29.2 A field with an inherited value has grey text
development

There is no developing specific information for this subject.

database

There is no database specific information for this subject.

integration

There is no integration specific information for this subject.