# Web Widget Plotly

This module add the possibility to insert Plotly charts into Odoo standard views.

Plotly is a Python interactive visualization library built on top of d3.js and stack.gl, plotly.js is a high-level, declarative charting library. plotly.js ships with over 40 chart types, including scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.

If you want to see some samples of plotly’s capabilities follow this link.

Table of contents

- Installation
- Usage
- Bug Tracker
- Credits
  - Authors
  - Contributors
  - Other credits
  - Maintainers

# Installation

You need to install the python plotly library:

    pip install plotly==5.22.0

# Usage

To insert a Plotly chart in a view proceed as follows:

1. Import plotly:

   import plotly

2. Declare a text computed field like this:

       plotly_chart = fields.Text(
           string='Plotly Chart',
           compute='_compute_plotly_chart',
       )

3. In its computed method do:

       def _compute_plotly_chart(self):
           for rec in self:
               data = [{'x': [1, 2, 3], 'y': [2, 3, 4]}]
               rec.plotly_chart = plotly.offline.plot(data,
                                            include_plotlyjs=False,
                                            output_type='div')

4. In the view, add something like this wherever you want to display your plotly chart:

       <div>
           <field name="plotly_chart" widget="plotly_chart" nolabel="1"/>
       </div>

# Bug Tracker

Bugs are tracked on GitHub 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.

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

# Credits

## Authors

- LevelPrime srl

## Contributors

- Roberto Fichera <roberto.fichera@levelprime.com>
- Michele Zaccheddu <michele.zaccheddu@levelprime.com>

## Other credits

- This module uses the library Plotly.js which is under the open-source MIT License. Copyright (c) 2019 Plotly, Inc
- Odoo Community Association (OCA)

## Maintainers

This module is maintained by the OCA.

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.

Current maintainer:

This module is part of the OCA/web project on GitHub.

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