==================
Product Origin Text
==================

..
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:todo
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3

|badge1| |badge2|

This module adds a simple free-text ``origin_text`` field to products.

**Problem:**

The standard ``product_origin`` module provides structured fields (country + state) for
product origin. However, suppliers often use creative and varied formats to describe
product origin:

* "Valencia, Spain"
* "Huerta de Ana, Aragón"
* "Organic Farm - Northern Italy"
* "Local producer - Basque Country"
* "Fair Trade - Colombia"

These free-form descriptions don't fit into structured country/state fields.

**Solution:**

This module adds a simple ``origin_text`` field to ``product.template`` that:

* Allows free-form text to describe product origin
* Is accessible from product variants via related field
* Works with any product workflow

**Features:**

* Free-text ``Origin`` field in product form
* Field visible in product list views (optional column)
* Variants share the same origin as their template
* Editable from both template and variant views

**Table of contents**

.. contents::
   :local:

Installation
============

This module depends on:

* ``product`` - Base product management

To install:

#. Install the required dependencies
#. Install this module through the Odoo Apps menu

Configuration
=============

No configuration is needed. The module works automatically after installation.

The origin field appears in the product form view (next to category) and can be
enabled as an optional column in list views.

Usage
=====

**To add origin information to a product:**

#. Go to a product form
#. Find the **Origin** field (near the product category)
#. Fill in the origin with free-form text
   (e.g., "Valencia, Spain", "Local producer - Basque Country")
#. Save the product

**To view origin information in lists:**

* In product list views, enable the optional "Origin" column
* The origin is shown for both product templates and variants

**Product variants:**

* All variants of a product template share the same origin
* Updating the origin on any variant updates the template
* This ensures consistency across all variants

Bug Tracker
===========

Bugs are tracked on `Criptomart GitLab Issues
<https://git.criptomart.net/criptomart/addons-cm/issues>`_.

In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
feedback.

Credits
=======

Contributors
------------

* `Criptomart <https://criptomart.net>`_:

  * Development and implementation

Financiers
----------

**Development:**

* `Criptomart <https://criptomart.net>`_

**Funding:**

* `Elika Bilbo <https://elikabilbo.eus>`_

This module was developed by Criptomart with funding from Elika Bilbo.

Maintainers
-----------

This module is maintained by Criptomart.

.. image:: https://criptomart.net/logo.png
   :alt: Criptomart
   :target: https://criptomart.net

This module is part of the `addons-cm <https://git.criptomart.net/criptomart/addons-cm>`_ project.
