Line 7:
Line 7:
== Bulk product categories ==
== Bulk product categories ==
−
OFF Prices allows the user to enter the prices of bulk products. For each product the user has to specify a category. As the variety of bulk products is not very large, there is no need to expose the user to the complexities of the [https://world.openfoodfacts.org/categories Categories taxonomy], which consists of 72.000 products. A subset of the categories taxonomy is sufficient for OFF Prices.
+
OFF Prices allows the user to enter the prices of bulk products. For each product the user has to specify a category. As the variety of bulk products is not very large, there is no need to expose the user to the complexities of the [https://world.openfoodfacts.org/categories Categories taxonomy], which consists of 72.000 categories. A subset of the categories taxonomy is sufficient for OFF Prices.
−
Virtually all products are sold with a barcode on the packaging. Which product categories are however also available without "official" barcode. This will be a very small subset of the categories taxonomy. For prices we need to identify these product categories.
+
Virtually all products are sold with a barcode on the packaging. Which product categories are however also available without an "official" barcode. This will be a very small subset of the categories taxonomy. For prices we need to identify these product categories. There are multiple ways of doing this.
−
=== Super category ===
+
=== By super category ===
−
We could also add the super category <nowiki>en:Bulk</nowiki> for easy retrieval of bulk products. This has the advantage that the indexing facilities can be used. Together with the id of the shop, it is possible to list the products for a specific shop.
+
We could also add the super category <nowiki>en:Bulk</nowiki> for easy retrieval of bulk products. This has the advantage that the indexing facilities can be used.
−
=== Property ===
+
=== By Property ===
−
Each category that can be sold as bulk gets a specific sales_format property.
+
Each category that can be sold as bulk gets a specific sales_format property. This property can indicate whether the product is sold by weight, by volume, per item (1 banana) or set (6 eggs).
−
By adding this property to each category that is sold as bulk, OFF Prices can figure out what categories need to be shown to the user.
+
By adding this property to each category that is sold as bulk, OFF Prices can figure out which categories need to be shown to the user and what sales format.
The identification of these bulk categories will be done by adding a property to each relevant category. The property [[Taxonomy_Properties#sales_format|sales_format]] will indicate whether that category is also sold by bulk. This can be by weight (for example almonds), by volume (for example olive oil) or by item (for example lemons). Default, i.e. no property implies '''sales_format:en:''' package. When a bulk_code is present the default '''sales_format:en:''' is package, weight.
The identification of these bulk categories will be done by adding a property to each relevant category. The property [[Taxonomy_Properties#sales_format|sales_format]] will indicate whether that category is also sold by bulk. This can be by weight (for example almonds), by volume (for example olive oil) or by item (for example lemons). Default, i.e. no property implies '''sales_format:en:''' package. When a bulk_code is present the default '''sales_format:en:''' is package, weight.
−
+
== Bulk category simplification ==
Unfortunately the category name corresponding to the bulk product can be very extensive. For instance bulk almonds are only sold shelled, whole, unsalted, unroasted and unblanched. To simplify the category a specific convenience category has been created, called [https://world.openfoodfacts.org/category/raw-almonds raw almonds]. (better than Almonds(whole/unsalted/unroasted/unblanched). This might even be too large for OFF Prices, a shorted name would be more convenient to the user. Why not call them just almonds?
Unfortunately the category name corresponding to the bulk product can be very extensive. For instance bulk almonds are only sold shelled, whole, unsalted, unroasted and unblanched. To simplify the category a specific convenience category has been created, called [https://world.openfoodfacts.org/category/raw-almonds raw almonds]. (better than Almonds(whole/unsalted/unroasted/unblanched). This might even be too large for OFF Prices, a shorted name would be more convenient to the user. Why not call them just almonds?
Line 31:
Line 31:
fr: Bananes(fraîche)
fr: Bananes(fraîche)
nl: Bananen(vers)
nl: Bananen(vers)
−
bulk_code:en: 5310000
+
bulk_proxy_category:en: en:bananas
bulk_proxy_category:en: en:bananas
sales_format:en: package, weight, item
sales_format:en: package, weight, item