فریمورک Odoo برای فرانتاند (Frontend)، به عنوان یک قسمت اصلی از ساختار کلی Odoo، از یک فریمورک استفاده میکند که به نام Owl شناخته میشود. Owl یک فریمورک جاوا اسکریپت است که بر پایهٔ تکنولوژی Vue.jsساخته شده است.
در ادامه، توضیحاتی در مورد Owl و ویژگیهای مهم آن آورده شده است:
1. Component-Based Architectur (معماری مبتنی بر کامپوننت):
- Owl از معماری کامپوننت مبتنی بر Vue.js استفاده میکند. این به این معناست که ویژگیها و رفتارهای مختلف به صورت کامپوننتهای مجزا تعریف شده و سپس در سراسر سیستم مورد استفاده قرار میگیرند.
2. Two-Way Data Binding (پیوند داده دوطرفه):
- Owl از پیوند داده دوطرفه پیشرفته برای همگامسازی اطلاعات بین مدل و نمایش استفاده میکند. این به تبادل داده بین مدل و رابط کاربری کمک میکند.
3. State Management (مدیریت وضعیت):
- Owl از وضعیتها (States) برای مدیریت اطلاعات در سراسر کامپوننتها استفاده میکند. این امکان را فراهم میکند تا اطلاعات به راحتی بین کامپوننتها به اشتراک گذاشته شوند.
4. Template Syntax (نحوهٔ نگارش قالب):
- Owl از یک نحوهٔ نگارش قالب ساده و قدرتمند برخوردار است که مشابه با Vue.js است. این امکان را به توسعهدهندگان میدهد تا به راحتی واسطهای کاربری را تعریف و ایجاد کنند.
5. Integration with Odoo Backend (ادغام با بخش Backend اودو):
- Owl به طور مستقیم با بخش Backend اودو ادغام شده است. این امکان را میدهد تا از ویژگیهای Odoo، اطلاعات، و خدمات Backend به صورت مستقیم در فرانتاند استفاده شود.
6. Async Operations and Odoo RPC (عملیات ناهمزمان و RPC اودو):
- Owl امکان انجام عملیاتهای ناهمزمان و ارتباط با Odoo RPC را فراهم کرده است، که به توسعهدهندگان این امکان را میدهد تا به صورت همزمان با سرور اطلاعات را دریافت و ارسال کنند.
این ویژگیها و اصول به کمک Owl، Frontend اودو را به یک تجربهٔ توسعه کاملاً مدرن و انعطافپذیر تبدیل کردهاند.
البته، مطالبی که قبلاً ارائه شدهاند به طور کامل و کاملی ویژگیهای Owl و ارتباط آن با فرانتاند Odoo را توضیح دادهاند. اما برای افزودن توضیحات بیشتر، میتوانم به صورت خلاصه و با ارائه مثالهایی دیگر به برخی از نکات اصلی اشاره کنم.
- یکی از نکات جالب در ارتباط فرانتاند (Owl) با بخش Backend (پایتون) اودو، این است که Owl از امکانات برنامهنویسی پایتون در قالب کدهای جاوااسکریپت خود بهره میبرد. این ادغام این امکان را به توسعهدهندگان میدهد که با استفاده از قابلیتهای پایتون، دادهها و خدماتی را به Owl ارائه دهند.
- برای نمونه، در Owl یک کامپوننت میتواند به شکل زیر باشد:
Owl.Component.extend('MyComponent', (require) => { class MyComponent extends Owl.Component { async willStart() { await this._super(...arguments); // عملیات ماقبل شروع } mounted() { // عملیات پس از نصب } } MyComponent.template = Owl.tags.xml` <div> <h1>Hello Owl!</h1> </div> `; return MyComponent; });
این کد یک کامپوننت Owl ایجاد میکند که یک عنوان ساده به نام "Hello Owl!" را نمایش میدهد. این نمونه نشاندهندهٔ ساختار کامپوننت مبتنی بر Vue.js و Owl استفاده شده در فریمورک Frontend Odoo است.

- به عنوان یکی از ویژگیهای Vue.js که در Owl استفاده میشود، پیوند داده دوطرفه (Two-Way Data Binding) است که امکان تغییرات در مدل داده از طریق ورودی کاربر و نیز به روزرسانی رابط کاربری با تغییرات در مدل را فراهم میکند.
این توضیحات و مثالها نشان دهندهٔ برخی از نکات مهم در توسعهٔ Frontend با استفاده از Owl در Odoo هستند. با این حال، برای درک کاملتر و بهتر از مستندات رسمی Odoo و Owl میتوانید به آدرسهای زیر مراجعه کنید.
نسخه 16
https://www.odoo.com/documentation/16.0/developer/reference/frontend/framework_overview.html
نسخه 17
https://www.odoo.com/documentation/17.0/developer/reference/frontend/framework_overview.html
پوشه web/static/src تمامی کدهای جاوااسکریپت (و سی اس اس و قالبها) مربوط به بخش وب را شامل میشود. در زیر لیستی از مهمترین پوشهها آورده شده است:
core/ بیشتر ویژگیهای سطح پایینfields/ تمام کامپوننتهای فیلدviews/ تمام کامپوننتهای نما view در جاوااسکریپت (form, list, …)search/ پنل کنترل، نوار جستجو، پنل جستجو، ...webclient/ کد اختصاصی وب-کلاینت: navbar, user menu, action service, …پوشه web/static/src پوشه روت یا ریشه است. هر چیزی که در داخل آن قرار دارد، میتواند به سادگی با استفاده از پیشوند @ و web وارد شود. به عنوان مثال، در زیر نحوه وارد کردن تابع memoize که در web/static/src/core/utils/functions قرار دارد نشان داده شده است:
import { memorize } from "@web/core/utils/functions"
همانطور که گفته شد، وب-کلاینت یک برنامه Owl است. در زیر نسخهی سادهشدهتری از قالب آن آورده شده است:
<t t-name="web.WebClient"> <body class="o_web_client"> <NavBar/> <ActionContainer/> <MainComponentsContainer/> </body> </t>
همانطور که مشاهده میشود، اصولاً یک پوشش (رپر) برای یک نوار ناوبری (wrapper for a navbar)، اکشن فعلی (the current action) و برخی از کامپوننتهای اضافی است. ActionContainerیک کامپوننت سطح بالاتر است که کنترلگر اکشن فعلی را نمایش میدهد (بنابراین، یک اکشن کاربر، یا یک نمای ویژه در مورد اکشنهای نوع act_window). مدیریت اکشن ها (actions) یک بخش عظیم از کار آن است: سرویس اکشن (action service) یک stack یا پشته از همهٔ اکشن های فعال را (نمایان شده در breadcrumbs) در حافظه نگه میدارد و هر تغییر را هماهنگ میکند.
نکتهٔ دیگری که قابل توجه است، MainComponentsContainer است: این اصولاً یک کامپوننت است که تمام کامپوننتهای ثبت شده در رجیستری main_components را نمایش میدهد. این روشی است که بخشهای دیگر سیستم میتوانند وب-کلاینت را گسترش دهند.
به عنوان یک برنامه Owl، وب کلاینت Odoo محیط خود را تعریف میکند (که کامپوننتها میتوانند به آن با استفاده از this.env دسترسی پیدا کنند). در زیر، توضیحی از آنچه Odoo به ابجکت env مشترک اضافه میکند آورده شده است:
بنابراین، به عنوان مثال، برای ترجمه یک رشته در یک کامپوننت (توجه: قالبها به صورت خودکار ترجمه میشوند، بنابراین در آن صورت عمل خاصی نیاز نیست)، میتوانید این کار را انجام دهید:
const someString = this.env._t('some text');