Metadata-Version: 2.1
Name: odoo-addon-project_state_extend
Version: 16.0.1.0.0.2
Summary: Extend project status selection widget with custom states
Home-page: https://github.com/OCA/project
Author: Escodoo, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.10
Requires-Dist: odoo<16.1dev,>=16.0a

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

====================
Project State Extend
====================

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

.. |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/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fproject-lightgray.png?logo=github
    :target: https://github.com/OCA/project/tree/16.0/project_state_extend
    :alt: OCA/project
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/project-16-0/project-16-0-project_state_extend
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/project&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module extends Odoo's project state selection widget to allow adding extended state options beyond the standard ones (On Track, At Risk, Off Track, On Hold).

Custom states can be configured with:

* Display name (translatable)
* Technical name (unique identifier)
* Color (0-11 for status bubble display)
* Sequence (ordering in selection lists)

Custom states are available for Projects through the same state selection widget used by native Odoo.

**Table of contents**

.. contents::
   :local:

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

To configure custom project states:

#. Go to **Project > Configuration > Extended States**
#. Click **Create**
#. Fill in the form:
   
   * **Name**: Display name for the state (e.g., "Pending Review")
   * **Technical Name**: Unique identifier (lowercase, no spaces, e.g., "pending_review")
   * **Color**: Select a color index from 0 to 11 for the status bubble
   * **Sequence**: Lower numbers appear first in selection lists
   * **Active**: Uncheck to archive the state

#. Click **Save**

The extended state will now be available in the state selection widget for Projects.

**Note**: Technical names must be unique across all extended states.

Usage
=====

After configuring extended states, you can use them in Projects:

**For Projects:**

#. Open a project
#. Below the standard "Status" field, you'll see the "Custom State" field
#. Click to select from available extended states
#. The selection will save automatically

The extended state field uses the same widget as the native status field, providing a consistent user experience with colored status bubbles.

**Kanban View:**

Custom states are also visible in Kanban views for Projects, with the configured color displayed as a status bubble.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/project/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 <https://github.com/OCA/project/issues/new?body=module:%20project_state_extend%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Escodoo

Contributors
~~~~~~~~~~~~

* Escodoo (https://www.escodoo.com.br):

  * Kaynnan Lemes <kaynnan.lemes@escodoo.com.br>

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/project <https://github.com/OCA/project/tree/16.0/project_state_extend>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
