Skip to content

Commit

Permalink
Merge PR OCA#2428 into 16.0
Browse files Browse the repository at this point in the history
Signed-off-by pedrobaeza
  • Loading branch information
OCA-git-bot committed Jun 7, 2023
2 parents bc466c1 + ff575d4 commit 3038def
Show file tree
Hide file tree
Showing 22 changed files with 766 additions and 0 deletions.
2 changes: 2 additions & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# generated from manifests external_dependencies
plotly==5.13.1
6 changes: 6 additions & 0 deletions setup/web_widget_plotly_chart/setup.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
import setuptools

setuptools.setup(
setup_requires=['setuptools-odoo'],
odoo_addon=True,
)
138 changes: 138 additions & 0 deletions web_widget_plotly_chart/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
=================
Web Widget Plotly
=================

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github
:target: https://github.com/OCA/web/tree/16.0/web_widget_plotly_chart
:alt: OCA/web
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/web-16-0/web-16-0-web_widget_plotly_chart
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/webui/builds.html?repo=OCA/web&target_branch=16.0
:alt: Try me on Runboat

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

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

.. image:: https://raw.githubusercontent.com/OCA/web/16.0/web_widget_plotly_chart/static/description/example.png
:alt: Plotly Chart inserted into an Odoo view
:width: 600 px

`Plotly <https://plot.ly/>`__ 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
<https://github.com/plotly/plotly.py#overview>`_.

**Table of contents**

.. contents::
:local:

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

You need to install the python plotly library::

pip3 install plotly==5.4.0

Usage
=====

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

#. Declare a text computed field like this::

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

#. 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')

#. 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 <https://github.com/OCA/web/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/web/issues/new?body=module:%20web_widget_plotly_chart%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
~~~~~~~

* LevelPrime srl

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

* Roberto Fichera <[email protected]>
* Michele Zaccheddu <[email protected]>

Other credits
~~~~~~~~~~~~~

* This module uses the library `Plotly.js <https://github.com/plotly/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.

.. 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.

.. |maintainer-robyf70| image:: https://github.com/robyf70.png?size=40px
:target: https://github.com/robyf70
:alt: robyf70

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-robyf70|

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

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Empty file.
21 changes: 21 additions & 0 deletions web_widget_plotly_chart/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"name": "Web Widget Plotly",
"summary": """Allow to draw plotly charts.""",
"author": "LevelPrime srl, Odoo Community Association (OCA)",
"maintainers": ["robyf70"],
"website": "https://github.com/OCA/web",
"category": "Web",
"version": "16.0.1.0.0",
"depends": ["web"],
"data": [],
"external_dependencies": {
"python": ["plotly==5.13.1"],
},
"assets": {
"web.assets_backend": [
"web_widget_plotly_chart/static/src/js/widget_plotly.esm.js",
"web_widget_plotly_chart/static/src/js/widget_plotly.xml",
],
},
"license": "LGPL-3",
}
Empty file.
Empty file.
Empty file.
Empty file.
13 changes: 13 additions & 0 deletions web_widget_plotly_chart/i18n/web_widget_plotly_chart.pot
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 14.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
2 changes: 2 additions & 0 deletions web_widget_plotly_chart/readme/CONTRIBUTORS.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
* Roberto Fichera <[email protected]>
* Michele Zaccheddu <[email protected]>
4 changes: 4 additions & 0 deletions web_widget_plotly_chart/readme/CREDITS.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
* This module uses the library `Plotly.js <https://github.com/plotly/plotly.js>`__
which is under the open-source MIT License.
Copyright (c) 2019 Plotly, Inc
* Odoo Community Association (OCA)
14 changes: 14 additions & 0 deletions web_widget_plotly_chart/readme/DESCRIPTION.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
This module add the possibility to insert Plotly charts into Odoo standard views.

.. image:: ../static/description/example.png
:alt: Plotly Chart inserted into an Odoo view
:width: 600 px

`Plotly <https://plot.ly/>`__ 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
<https://github.com/plotly/plotly.py#overview>`_.
3 changes: 3 additions & 0 deletions web_widget_plotly_chart/readme/INSTALL.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
You need to install the python plotly library::

pip3 install plotly==5.4.0
24 changes: 24 additions & 0 deletions web_widget_plotly_chart/readme/USAGE.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
To insert a Plotly chart in a view proceed as follows:

#. Declare a text computed field like this::

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

#. 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')

#. 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>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 3038def

Please sign in to comment.