HKAFE - JS Tutorial

awesome_dashboard/__manifest__.py

@@ -24,6 +24,10 @@
     'assets': {
         'web.assets_backend': [
             'awesome_dashboard/static/src/**/*',
+            ('remove', 'awesome_dashboard/static/src/dashboard/**/*'),
+        ],
+        'awesome_dashboard.dashboard': [
+            'awesome_dashboard/static/src/dashboard/**/*',
         ],
     },
     'license': 'AGPL-3'

awesome_dashboard/static/src/dashboard/dashboard.js

@@ -0,0 +1,38 @@
+/** @odoo-module **/
+
+import { Component, useState } from "@odoo/owl";
+import { registry } from "@web/core/registry";
+import { Layout } from "@web/search/layout";
+import { useService } from "@web/core/utils/hooks";
+import { DashboardItem } from "./dashboard_item/dashboard_item";
+import { PieChart } from "./pie_chart/pie_chart";
+
+class AwesomeDashboard extends Component {
+    static components = { Layout, DashboardItem, PieChart };
+    static template = "awesome_dashboard.AwesomeDashboard";
+
+    setup() {
+        this.display = { controlPanel: {} };
+        this.action = useService("action");
+        this.stats = useState(useService("awesome_dashboard.statistics"));
+        this.items = registry.category("awesome_dashboard").getAll();
+    }
+
+    openCustomers() {
+        this.action.doAction("base.action_partner_form");
+    }
+
+    openLeads() {
+        this.action.doAction({
+            type: "ir.actions.act_window",
+            res_model: "crm.lead",
+            name: "Leads",
+            views: [
+                [false, "list"],
+                [false, "form"],
+            ],
+        });
+    }
+}
+
+registry.category("lazy_components").add("AwesomeDashboard", AwesomeDashboard);

awesome_dashboard/static/src/dashboard/dashboard.scss

@@ -0,0 +1,14 @@
+.o_dashboard {
+    background-color: gray;
+}
+
+.btn-primary {
+    background-color: purple;
+    border-color: purple;
+}
+
+.divider{
+    width:5px;
+    height:auto;
+    display:inline-block;
+}

awesome_dashboard/static/src/dashboard/dashboard.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xml:space="preserve">
+
+    <t t-name="awesome_dashboard.AwesomeDashboard">
+        <Layout display="display" className="'o_dashboard h-100'">
+            <button type="button" class="btn btn-primary" t-on-click="openCustomers">
+                Customers
+            </button>
+            <div class="divider"/>
+            <button type="button" class="btn btn-primary" t-on-click="openLeads">
+                Leads
+            </button>
+            <div class="d-flex flex-wrap" t-if="stats.isLoaded">
+                <t t-foreach="items" t-as="item" t-key="item.id">
+                    <DashboardItem size="item.size || 1">
+                        <t t-set="itemProp" t-value="item.props ? item.props(stats) : {'data': stats}"/>
+                        <t t-component="item.component" t-props="itemProp"/>
+                    </DashboardItem>
+                </t>
+            </div>
+        </Layout>
+    </t>
+
+</templates>

awesome_dashboard/static/src/dashboard/dashboard_item/dashboard_item.js

@@ -0,0 +1,16 @@
+import { Component } from "@odoo/owl";
+
+export class DashboardItem extends Component {
+    static template = "awesome_dashboard.DashboardItem";
+    static props = {
+        size: {
+            type: Number,
+            default: 1,
+            optional: true,
+        },
+        slots: {
+            type: Object,
+            optional: true,
+        },
+    };
+}

awesome_dashboard/static/src/dashboard/dashboard_item/dashboard_item.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xml:space="preserve">
+
+    <t t-name="awesome_dashboard.DashboardItem">
+      <div class="card d-inline-block m-2" t-attf-style="width: {{18 * this.props.size}}rem;">
+        <div class="card-body">
+            <t t-slot="default"/>
+        </div>
+      </div>
+    </t>
+</templates>

awesome_dashboard/static/src/dashboard/dashboard_items.js

@@ -0,0 +1,66 @@
+import { NumberCard } from "./number_card/number_card";
+import { PieChartCard } from "./pie_chart_card/pie_chart_card";
+import { registry } from "@web/core/registry";
+
+const dashboardItems = [
+    {
+        id: "average_quantity",
+        description: "Average amount of t-shirt by order this month",
+        component: NumberCard,
+        props: (data) => ({
+            title: "Average amount of t-shirt by order this month",
+            value: data.average_quantity,
+        }),
+    },
+    {
+        id: "average_time",
+        description:
+            "Average time for an order to go from 'new' to 'sent' or 'cancelled'",
+        component: NumberCard,
+        props: (data) => ({
+            title: "Average time for an order to go from 'new' to 'sent' or 'cancelled'",
+            value: data.average_time,
+        }),
+    },
+    {
+        id: "nb_new_orders",
+        description: "Number of new orders this month",
+        component: NumberCard,
+        props: (data) => ({
+            title: "Number of new orders this month",
+            value: data.nb_new_orders,
+        }),
+    },
+    {
+        id: "nb_cancelled_orders",
+        description: "Number of cancelled orders this month",
+        component: NumberCard,
+        props: (data) => ({
+            title: "Number of cancelled orders this month",
+            value: data.nb_cancelled_orders,
+        }),
+    },
+    {
+        id: "total_amount",
+        description: "Total amount of new orders this month",
+        component: NumberCard,
+        props: (data) => ({
+            title: "Total amount of new orders this month",
+            value: data.total_amount,
+        }),
+    },
+    {
+        id: "orders_by_size",
+        description: "Shirt orders by size",
+        component: PieChartCard,
+        size: 1.5,
+        props: (data) => ({
+            title: "Shirt orders by size",
+            values: data.orders_by_size,
+        }),
+    },
+];
+
+dashboardItems.forEach((item) => {
+    registry.category("awesome_dashboard").add(item.id, item);
+});

awesome_dashboard/static/src/dashboard/number_card/number_card.js

@@ -0,0 +1,10 @@
+import { Component } from "@odoo/owl";
+
+export class NumberCard extends Component {
+    static template = "awesome_dashboard.NumberCard";
+
+    static props = {
+        title: String,
+        value: Number,
+    };
+}

awesome_dashboard/static/src/dashboard/number_card/number_card.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xml:space="preserve">
+
+    <t t-name="awesome_dashboard.NumberCard">
+        <t t-esc="props.title"/>
+        <div class="fs-1 fw-bold text-success text-center">
+            <t t-esc="props.value"/>
+        </div>
+    </t>
+</templates>

awesome_dashboard/static/src/dashboard/pie_chart/pie_chart.js

@@ -0,0 +1,52 @@
+import {
+    Component,
+    useEffect,
+    useRef,
+    onWillUnmount,
+    onWillStart,
+} from "@odoo/owl";
+import { loadJS } from "@web/core/assets";
+import { getColor } from "@web/core/colors/colors";
+
+export class PieChart extends Component {
+    static template = "awesome_dashboard.PieChart";
+    static props = {
+        label: { type: String, optional: true },
+        data: { type: Object },
+    };
+
+    setup() {
+        this.canvasRef = useRef("canvas");
+        this.chart = null;
+
+        onWillStart(() => loadJS(["/web/static/lib/Chart/Chart.js"]));
+        useEffect(() => this.renderChart());
+        onWillUnmount(() => {
+            if (this.chart) {
+                this.chart.destroy();
+            }
+        });
+    }
+
+    renderChart() {
+        const labels = Object.keys(this.props.data);
+        const values = Object.values(this.props.data);
+        const color = labels.map((_, idx) => getColor(idx * 2));
+        if (this.chart) {
+            this.chart.destroy();
+        }
+        this.chart = new Chart(this.canvasRef.el, {
+            type: "pie",
+            data: {
+                labels: labels,
+                datasets: [
+                    {
+                        label: this.props.label || "",
+                        data: values,
+                        backgroundColor: color,
+                    },
+                ],
+            },
+        });
+    }
+}

awesome_dashboard/static/src/dashboard/pie_chart/pie_chart.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xml:space="preserve">
+    <t t-name="awesome_dashboard.PieChart">
+        <canvas t-ref="canvas" />
+    </t>
+</templates>

awesome_dashboard/static/src/dashboard/pie_chart_card/pie_chart_card.js

@@ -0,0 +1,12 @@
+import { Component } from "@odoo/owl";
+import { PieChart } from "../pie_chart/pie_chart";
+
+export class PieChartCard extends Component {
+    static template = "awesome_dashboard.PieChartCard";
+    static components = { PieChart };
+
+    static props = {
+        title: String,
+        values: Object,
+    };
+}

awesome_dashboard/static/src/dashboard/pie_chart_card/pie_chart_card.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xml:space="preserve">
+
+    <t t-name="awesome_dashboard.PieChartCard">
+        <t t-esc="props.title"/>
+        <PieChart data="props.values" label="''"/>
+    </t>
+</templates>

awesome_dashboard/static/src/dashboard/statistics_service.js

@@ -0,0 +1,25 @@
+import { registry } from "@web/core/registry";
+import { rpc } from "@web/core/network/rpc";
+import { reactive } from "@odoo/owl";
+
+const statisticsService = {
+    async: ["loadStatistics"],
+    start() {
+        const statistics = reactive({ isLoaded: false });
+
+        async function loadStatistics() {
+            const result = await rpc("/awesome_dashboard/statistics");
+            statistics.isLoaded = true;
+            Object.assign(statistics, result);
+        }
+
+        setInterval(loadStatistics, 10 * 60 * 1000);
+        loadStatistics();
+
+        return statistics;
+    },
+};
+
+registry
+    .category("services")
+    .add("awesome_dashboard.statistics", statisticsService);

awesome_dashboard/static/src/dashboard_action.js

@@ -0,0 +1,12 @@
+import { Component, xml } from "@odoo/owl";
+import { registry } from "@web/core/registry";
+import { LazyComponent } from "@web/core/assets";
+
+export class DashboardAction extends Component {
+    static components = { LazyComponent };
+    static template = xml`<LazyComponent bundle="'awesome_dashboard.dashboard'" Component="'AwesomeDashboard'" props="props"/>`;
+}
+
+registry
+    .category("actions")
+    .add("awesome_dashboard.dashboard", DashboardAction);

awesome_owl/__manifest__.py

@@ -35,7 +35,7 @@
             ('include', 'web._assets_bootstrap'),
             ('include', 'web._assets_core'),
             'web/static/src/libs/fontawesome/css/font-awesome.css',
-            'awesome_owl/static/src/**/*',
+            'awesome_owl/static/src/**/**',
         ],
     },
     'license': 'AGPL-3'

awesome_owl/static/src/card/card.js

@@ -0,0 +1,24 @@
+import { Component, useState } from "@odoo/owl";
+
+export class Card extends Component {
+    static template = "awesome_owl.card";
+    static props = {
+        title: { type: String },
+        slots: {
+            type: Object,
+            shape: {
+                default: true,
+            },
+        },
+    };
+
+    setup() {
+        this.state = useState({
+            isOpen: true,
+        });
+    }
+
+    onToggle() {
+        this.state.isOpen = !this.state.isOpen;
+    }
+}