Changes

Jump to navigation Jump to search
2,416 bytes added ,  14:09, 28 May 2020
→‎Serving size: serving_quantity
Line 34: Line 34:     
==== Common name ====
 
==== Common name ====
The common name defines the product. It is the name used when you don't want or can't use the product name. This is the place where you say "Cocoa and hazelnuts spreads" instead of "Nutella". This name is very useful for our AI (artificial intelligence): it helps to guess the category of the product.
+
The common name defines the product. It is the name used when you don't want or can't use the product name. This is the place where you say <code>Cocoa and hazelnuts spreads</code> instead of <code>Nutella</code>. This name is very useful for our AI (artificial intelligence): it helps to guess the category of the product.
    
The common name might be equivalent to product category but sometimes not [examples].
 
The common name might be equivalent to product category but sometimes not [examples].
Line 40: Line 40:  
In the database, the technical name for this field is <code>generic_name</code>.
 
In the database, the technical name for this field is <code>generic_name</code>.
    +
==== Quantity ====
 +
This is the quantity of the product, with the corresponding number of portions or unit. The best way to fill it is to enter the value as indicated on the product. Don't forget the units! If we can deduce the quantity in grams it can be used to calculate some things such as the carbon impact.
   −
==== Quantity ====
+
Examples:
This is the quantity of the product, with the corresponding number of portions or unit; example: "230g", "6" (for 6 eggs), etc.
+
* <code>230g</code>
 +
* <code>230 g</code>
 +
* <code>6</code> (for 6 eggs)
 +
* <code>3 x 150g</code> (for a product with 3 boxes, each of 150g)
   −
As indicated on the product. If we can deduce the quantity in grams it can be used to calculate some things such as the carbon impact.
+
A complete wiki page is dedicated to [[products quantities]].
    
In the database, the technical name for this field is <code>quantity</code>.
 
In the database, the technical name for this field is <code>quantity</code>.
Line 52: Line 57:  
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+quantity+label%3Aquantity issues related to <code>quantity</code>].
 
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+quantity+label%3Aquantity issues related to <code>quantity</code>].
    +
==== Packaging ====
 +
This is the packaging of the product. Multiple values are allowed. There is no taxonomy for this field, so you can enter anything you find relevant including:
 +
* the substance of the packaging: glass, metal, plastic, etc.
 +
* the shape: bottle, can, etc.
 +
 +
You can write it in your own language. Don't hesitate to add as much data as you find relevant.
 +
 +
Two draft taxonomies has been proposed, don't hesitate to comment or help:
 +
* a [[Global_packaging_taxonomy|global taxonomy]]
 +
* and a [[Global_packaging_taxonomy_logos|packaging logos taxonomy]]
 +
 +
In the database, there's two fields related to packaging:
 +
* <code>packaging</code>: the list of values entered in the packaging field; e.g.: <code>Bottle,Glass</code>
 +
* <code>packaging_tags</code>: an array of different packaging tags
 +
 +
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+packaging+label%3Apackaging issues related to <code>packaging</code>].
 +
 +
==== Brands ====
 +
This is the brands of the product. The main brand, generally clearly displayed on the front pack, should be entered first. A product can have other brands:
 +
* when a product is a brand sold by a big company: <code>Actimel</code> is sold by <code>Danone</code>, see https://world.openfoodfacts.org/product/4009700036810/actimel-granatapfel
 +
* when a product is sold with its brand translated in two languages: <code>Nature Valley</code> is sometimes written <code>Val Nature</code>; see  https://world.openfoodfacts.org/product/0065633280267/barre-granola-erable-et-cassonade-nature-valley
 +
 +
There's no taxonomy for brands for the moment, so just do your best and don't waste too much time to enter brands.
 +
 +
A complete wiki page is dedicated to [[brands]].
 +
 +
In the database, this field is called <code>brands</code>.
 +
 +
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+ingredients+label%3Abrands issues related to <code>brands</code>].
    
==== Ingredients ====
 
==== Ingredients ====
Line 132: Line 166:  
* <code>30</code> => there is no unit
 
* <code>30</code> => there is no unit
   −
In the database and in Product Opener software, the technical name for this field is <code>serving_size</code>.
+
In the database and in Product Opener software, the technical name for this field is <code>serving_size</code>. Based on <code>serving_size</code>, Open Food Facts computes a <code>serving_quantity</code> float number for 100g or 100ml. The <code>serving_quantity</code> can be found in the API or the data exports.
    
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+serving+label%3Aportions issues related to <code>serving_size</code>].
 
See [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+serving+label%3Aportions issues related to <code>serving_size</code>].

Navigation menu