SPECIFICATIONS - PRODUCT SETTINGS PAGE

Mockups: https://www.figma.com/file/aCBf2HlypjT0ZxP2XcsT68/Core-Github-issues?node-id=207%3A4875

Products (general)

Catalog mode. A switch button allows the merchant to enable or disable the catalog mode. By default, it is disabled. Enabling this catalog mode disables the shopping cart on the front office and displays another field right below, labeled ‘Show prices’.

It also impacts the customer account on the front office, turning off the ‘Order history and details’, ‘Credit slips’, and ‘Merchandise returns’ pages.

Show prices. It should be displayed only when the catalog mode is enabled. By default, it is disabled and prices are not mentioned on the front office. Enabling this option adds the products' price and keeps the shopping cart unavailable in the front office.

Number of days for which the product is considered ‘new’. Currently, a product is considered new starting from its creation date but day 0 should be based on its activation date, cf. to do issue #18823. By default, it is set to 20 days.

Only numbers can be typed in the field, or added by using the arrows at the end of the field. It cannot be set to less than 0 either, otherwise the field goes back to the previous valid value and an error notification is displayed: The Number of days for which the product is considered ‘new’ field is invalid.

Max size of short description. Merchants can modify the size of their product’s short description (= summary), available in the ‘Basic Settings’ tab of the product page. By default, it is limited to 800 characters. Changing the number of limited characters will update the help text in the bottom right-hand corner of the summary field in the Catalog > Products page, e.g. 76 of 900 characters allowed.

Only numbers should be typed in the field. If the input contains specific characters, an error notification is displayed: The Max size of short description field is invalid.

Quantity discounts based on. It is a dropdown selector containing two options: the merchant can decide to base all his quantity discounts per-product or per-combination. By default, the ‘Products’ option is selected, allowing quantity discounts based on several products.

If ‘Products’ is selected, then the discount (specific price or catalog price rule) is applied when the cart contains X products no matter the combinations added to the cart.

If ‘Combinations’ is selected, then the discount (specific price or catalog price rule) is applied when the cart contains X products of the same combination.

For example, the merchant has set a discount for 4 purchased items:

With quantity discounts based per-product: the customer can buy 2 white and 2 black tee-shirts to benefit from the discount.

With quantity discounts based per-combination: the customer needs to buy 4 blue tee-shirts to benefit from the discount.

Force update of friendly URL. A friendly URL is generated from the product name. By default, it is disabled. Enabling this option will automatically regenerate it every time the merchant modifies and saves a product name - and automatically update the friendly URL field in the ‘SEO’ tab of the product page.

Default activation status. By default, it is disabled. If enabled, this option will turn online the products the merchant creates manually in the Catalog > Products page. As a consequence, manually created products will be set as active in the ‘Status’ column in the Catalog > Products listing.

As mentioned by the tooltip, Enable this option if you want to activate by default all your manually created new products., it does not apply to the products added via the import feature in Advanced Parameters > Import, cf. to do issue #13841.

Product page

As a merchant, I want to be able to manage my unavailable product combinations.

Display unavailable attributes on the product page. By default, it is enabled. And the tooltip should be If an attribute is not available in every product combination, it will not be displayed., cf. 1.7.8 issue #17447.

When this option is enabled, unavailable products' combinations remain visible in the shop. A message on the FO product page and on product listings indicates the product is no longer available in the chosen option and invites customers to choose another combination: Other product variations available.

When this option is enabled as well as the ‘Allow ordering out-of-stock products’ option, customers are able to add unavailable combinations to their cart.

When this option is disabled and if the products have one single attribute, their combinations are no longer available and the attribute is hidden.

For example, the XS attribute and the related product are not displayed in the following case:

Size In stock
XS No
S Yes
M Yes
L Yes

but the S, M, and L attributes remain displayed.

Also, when this option is disabled and if the value of an attribute has no product in all possible combinations, the combination of the products that are no longer available is hidden.

For example, the white attribute and the related product are not displayed in the following case:

Size Color In Stock
S White No
S Black Yes
M White No
M Black Yes

but the S, M, and black attributes remain displayed.

As a merchant, I want to be able to parameter my products' attributes.

Display the “Add to cart” button when a product has attributes. Important note: this feature does not work with the Classic default theme. It has been removed from the front office in 1.7.x because many users added products to their cart without selecting a combination. A help text under the switch button notices users about it, Note that this setting does not work with the default theme anymore. in Admin.Shopparameters.Help.

It is still in the back office since it might work with other themes. By default, it sould be disabled. Display or hide the ‘Add to cart’ button on category pages for products that have attributes forcing customers to see product details.

Separator of attribute anchor on the product links. When a product has many attributes, the merchant can select a separator between the hyphen (-) and the comma (,). By default, it is the hyphen. It appears on shopping carts in the front office, invoices, merchandise returns, and order details pages, cf. issue #19636.

As a merchant, I want to be able to display the discounted price or the discount itself on my product pages.

Display discounted price. By default, it is disabled. When it’s enabled, in the volume discounts board, the new product price with the applied discount is displayed When it’s disabled, in the volume discounts board, the discount is displayed

Products stock

As a merchant, I want to be able to manage my product pages according to the available stock.

Enable stock management. It allows basic stock management options and features: merchants can set the current quantity of a product and let PrestaShop lower it for each order, or re-stock it for each canceled or returned order. By default, this feature is enabled.

When setting this option to ‘No’:

  • it automatically enables the ‘Allow ordering of out of stock products’ feature above and prevents the user from switching this feature again, cf. 1.7.8 issue #21037;
  • the ‘Quantity’ column is not displayed in the product listing (Catalog > Products);
  • the ‘Quantity’ field is not displayed in the product page (Catalog > Products);
  • the ‘Available’ column is not displayed in the order details page (Orders > Orders > View).

Default pack stock management. In case they sell packs of products, merchants can select how to update the stock among 3 different possibilities:

  • Decrement pack only. When a pack is sold, only the stock for the pack is impacted.
  • Decrement products in pack only. When a pack is sold, only the stock for each product is impacted.
  • Decrement both. When a pack is sold, both the stock for the pack and the stock for each product are impacted.

Note: this parameter can also be set for each pack in the ‘Quantities’ tab of their own product page.

Display available quantities on the product page. By default, it is enabled, displaying in the front office how many items are in stock in the product page, just before the delivery time: X in stock (in stock here is the “label of in stock product” defined by the merchant)

The number of available items should be based on the selected product and attributes (= combination). If the quantity is <= 0, the quantity is not displayed.

Display remaining quantities when the quantity is lower than. Merchants can display a small alert in the front office when the stock for a product gets below a certain level. It adds the following message, Only X left in stock, in the cart and in the product page before the delivery time label:

Availability: Only X left in stock - Delivered under 48 hours

If the product has combinations, this message is based on the selected attributes (= combinations) according to the quantity in stock.

It adds the following message , Only X left in stock, in product listings in green #5A9166 if the default combination quantity is below the level defined.

Only numbers can be typed in the field, or added by using the arrows at the end of the field. By default, it is set to 3 - typing 0 disables this feature. It cannot be set to less than 0, otherwise the field goes back to the previous valid value and an error notification is displayed: The Display remaining quantities when the quantity is lower than field is invalid.

Allow ordering of out-of-stock products. By default, it is disabled. It means that, when a product is not available in stock, the ‘Add to cart’ button on the product page is unclickable with the following message just below:

  1. Other product variations available if the selected combination can’t be ordered and if at least one other combination can be ordered.

  2. :no_entry_sign: Out-of-Stock (or any message typed in the ‘Label of out-of-stock products with denied backorders’ field) if this is a standard product.

On the contrary, enabling this option allows customers to order both in-stock and out-of-stock products.

Label of in-stock products. Merchants can add a label to all in-stock products. The text should be displayed in green #5A9166 in different places of the front-office:

  • just below the price in product listings
  • just above the quantity input and the ‘Add to cart’ button of the product page.
  • in the shopping cart, below the combinations if there are, otherwise under the product name

Leaving this field empty disables the feature. Merchants can localize the label according to the store’s available languages.

Label of out-of-stock products with allowed backorders. Merchants can add a label to all out-of-stock products when the ‘Allow ordering of out-of-stock products’ option is enabled. The text should be displayed in orange #FF5E24 in different places of the front-office:

  • just below the price in product listings
  • just above the quantity input and the ‘Add to cart’ button of the product page. ²
  • in the shopping cart, below the combinations if there are, otherwise under the product name

In case of a product with combinations:

  • if the default combination (on the product listing) or the selected combination (on the product page) is out of stock with allowed backorders, the “Label of out-of-stock products with allowed backorders” will be displayed in orange #FF5E24.

Leaving this field empty disables the feature. Merchants can localize the label according to the store’s available languages.

Label of out-of-stock products with denied backorders. Merchants can add a label to all out-of-stock products when the ‘Allow ordering of out-of-stock products’ option is disabled. By default, it is Out-of-Stock (or its translation for other languages). The text should be displayed in red #C3362B in different places of the front-office:

  • just below the price in product listings
  • just above the quantity input and the ‘Add to cart’ button of the product page.
  • in the shopping cart, below the combinations if there are, otherwise under the product name

In case of a product with combinations:

  • if the default combination is out of stock with denied backorders and if no other combination can be ordered, only the “Label of out-of-stock products with denied backorders” will be displayed in red #C3362B.
  • if at least one other combination than the default one (on the product listings) or the selected one (on product page) can be ordered, the “Other product variations available” message will be displayed under the “Label of out-of-stock products with denied backorders” message.

Leaving this field empty disables the feature. Merchants can localize the label according to the store’s available languages. The placeholder for this field is: “Temporarily out of stock”

Delivery time of in-stock products. Merchants can indicate the delivery time of in-stock products. The text should be displayed in green #5A9166 in different places of the front-office if the ‘Default delivery time’ is checked in the ‘Shipping’ tab of the product page (Catalog > Products):

  • just above the quantity input and the ‘Add to cart’ button of the product page, after the stock label.
  • in the shopping cart, below the combinations if there are, otherwise under the product name, after the stock label.

By default the field is empty. Leaving this field empty disables the feature. Merchants can localize the label according to the store’s available languages.

Delivery time of out-of-stock products with allowed backorders. Merchants can indicate the delivery time of out-of-stock products with allowed backorders. It should be displayed in orange #FF5E24 in different places of the front-office if the ‘Default delivery time’ is checked in the ‘Shipping’ tab of the product page (Catalog > Products):

  • just above the quantity input and the ‘Add to cart’ button of the product page, after the stock label.
  • in the shopping cart, below the combinations if there are, otherwise under the product name, after the stock label.

By default, the field is empty. Leaving this field empty disables the feature. Merchants can localize the label according to the store’s available languages.

Pagination

As a merchant, I want to be able to set my pagination preferences.

Products per page. It defines the number of products displayed per page - category or product pages, e.g. the ‘New Products’ page. By default, it is set to 12.

Only numbers can be typed in the field, or added by using the arrows at the end of the field. It cannot be set to less than 0, otherwise the field goes back to the previous valid value and an error notification is displayed: The Products per page field is invalid.

Default order by. Merchants can select the criterion based on what their products should be listed on category or product pages, e.g. the ‘New Products’ page: product name, product price, product creation date, product last modification date, position inside category, brand, product quantity, product reference. By default, it is by position inside category - see the ‘Position’ column in the Catalog > Categories page.

Default order method. It defines if products should be listed following an ascending (.asc in the URL) or a descending (.desc in the URL) order on category or product pages, e.g. the ‘New Products’ page, cf. issue #21312. By default, it is in ascending order.