[ADD] Lunch: New products doc

closes odoo/documentation#9894 X-original-commit: 2ae0e15982 Signed-off-by: Lara Martini (larm) <larm@odoo.com>
2024-06-14 15:58:29 -04:00
parent abb351a62f
commit 4d8d894727
4 changed files with 64 additions and 59 deletions
@@ -0,0 +1,62 @@
+========
+Products
+========
+
+Odoo's *Lunch* app does **not** come with any products preconfigured. The individual products being
+offered must first be configured before orders can be placed.
+
+To add and configure products for the *Lunch* app, navigate to :menuselection:`Lunch app -->
+Configuration --> Products`. Next, click the :guilabel:`New` button in the top-left corner, and a
+blank product form loads.
+
+Enter the following information on the form:
+
+- :guilabel:`Product Name`: enter the name for the product. This field is **required**.
+- :guilabel:`Product Category`: using the drop-down menu, select the :ref:`category
+  <lunch/product-categories>` this product falls under. This field is **required**.
+- :guilabel:`Vendor`: using the drop-down menu, select the vendor that supplies this product. This
+  field is **required**.
+- :guilabel:`Price`: enter the price for the product. The currency is determined by the company's
+  localization.
+- :guilabel:`Description`: enter a description of the product in this field. This description
+  appears beneath the product photo when users are viewing the day's options.
+- :guilabel:`New Until`: using the calendar popover, select the date on which the product is no
+  longer labeled as new. Until this date, a green `New` tag appears on the product.
+- :guilabel:`Company`: if the product should only be available to a specific company, select it from
+  the drop-down menu. If this field is left blank, this product is available for all companies in
+  the database.
+- **Image**: hover over the image box in the top-right corner of the form, and click the
+  :icon:`fa-pencil` :guilabel:`(pencil)` icon that appears. A file explorer pop-up window appears.
+  Navigate to the image, then click :guilabel:`Open`.
+
+.. image:: products/product.png
+   :align: center
+   :alt: A product form filled out for a nine inch pizza.
+
+.. _lunch/product-categories:
+
+Product categories
+==================
+
+Product categories organize the offerings in the *Lunch* app, and allows users to quickly filter
+them when reviewing the menu for the day.
+
+To add or modify categories, navigate to :menuselection:`Lunch app --> Configuration: Product
+Categories`. The available categories appear in a list view.
+
+In the *Lunch* app, there are four default categories: :guilabel:`Sandwich`, :guilabel:`Pizza`,
+:guilabel:`Burger`, and :guilabel:`Drinks`.
+
+To add a new category, click the :guilabel:`New` button in the top-left corner, and a blank category
+form loads.
+
+Enter a name in the :guilabel:`Product Category` field. If the category is company-specific and
+should only appear for a certain company, select the :guilabel:`Company` from the drop-down menu.
+
+If desired, add a photo for the category. Hover over the image box in the top-right, and click the
+:icon:`fa-pencil` :guilabel:`(pencil)` icon that appears. This opens a file explorer pop-up window.
+Navigate to the image, then click :guilabel:`Open`.
+
+.. image:: products/category.png
+   :align: center
+   :alt: The category form, with the fields filled out for a Soup category.