Changes

Jump to navigation Jump to search
2,403 bytes added ,  09:55, 17 September 2020
Add ""categories" and labels".
Line 56: Line 56:     
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 ====
 
==== 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:
 
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 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 wrote <code>Val Nature</code>; see  https://world.openfoodfacts.org/product/0065633280267/barre-granola-erable-et-cassonade-nature-valley
+
* 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.
 
There's no taxonomy for brands for the moment, so just do your best and don't waste too much time to enter brands.
Line 68: Line 85:  
In the database, this field is called <code>brands</code>.
 
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>].
+
See: [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+ingredients+label%3Abrands issues related to <code>brands</code>].
 +
 
 +
==== Categories ====
 +
[to be completed]
 +
 
 +
This field list the specific [[Global_categories_taxonomy|category]] of a product and its related parents. This field is very important: it needs to be completed for Nutri-Score computation, as this computation makes differences between types of products (beverages, ...).
 +
 
 +
→ Indicate only the most specific category. "Parents" categories will be automatically added.
 +
 
 +
Examples: Sardines in olive oil, Orange juice from concentrate
 +
 
 +
See also:
 +
* [https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/categories.txt our categories taxonomy on our repository].
 +
* [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+category+label%3Acategories issues related to <code>categories</code>].
 +
 
 +
==== Labels ====
 +
[to be completed]
 +
 
 +
"[[Labels]], certifications, awards" on the website.
 +
 
 +
Example: Organic.
 +
 
 +
See the [[Labels]] page for more informations.
 +
 
 +
See also:
 +
* [https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/labels.txt our labels taxonomy on our repository].
 +
* [https://github.com/openfoodfacts/openfoodfacts-server/issues?q=is%3Aissue+is%3Aopen+category+label%3Alabels issues related to <code>labels</code>].
    
==== Ingredients ====
 
==== Ingredients ====
Line 149: Line 192:  
* <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