Skip to Content

آموزش کامل راست‌چین (RTL) کردن Odoo در ویندوز

اگر قصد دارید Odoo را برای زبان‌های راست‌به‌چپ مثل فارسی و عربی آماده کنید، لازم است برخی کتابخانه‌ها و ابزارهای مربوط به RTL را روی ویندوز نصب و فعال کنید. در این آموزش، تمام مراحل موردنیاز برای فعال‌سازی RTL در Odoo نسخه‌های 14 تا 19 را توضیح داده‌ام.
3 دسامبر 2025 توسط
آموزش کامل راست‌چین (RTL) کردن Odoo در ویندوز
Sina Mohammadi

1. نصب Node.js (پیش‌نیاز اصلی)

Odoo برای کامپایل کردن فایل‌های LESS و تولید فایل‌های CSS راست‌چین، به Node.js نیاز دارد.

ابتدا Node.js را از لینک رسمی دانلود و نصب کنید:

🔗 https://nodejs.org

پس از نصب، یک‌بار Command Prompt را باز کنید و مطمئن شوید که Node به درستی نصب شده است:

node -v
npm -v

2. نصب پکیج‌های مورد نیاز برای RTL

Odoo برای راست‌چین کردن استایل‌ها از ابزارهایی مثل LESS و RTLcss استفاده می‌کند. بنابراین باید این پکیج‌ها را با npm نصب کنید.

کافیست CMD را در حالت Administrator باز کنید و این دستورات را بزنید:

npm install -g less
npm install -g less-plugin-clean-css
npm install -g rtlcss
npm install -g rtl-detect
npm install -g postcss-ltr-rtl-detect

این پکیج‌ها باعث می‌شوند که Odoo بتواند هنگام ساخت Assetها، نسخهٔ راست‌چین را هم به‌درستی ایجاد کند.

**3. مرحله بسیار مهم (اختصاصی ویندوز):

انتقال فایل‌های npm به مسیر thirdparty اودو**

وقتی npm پکیج‌ها را نصب می‌کند، آن‌ها را در مسیر زیر قرار می‌دهد:

C:\Users\<YourUser>\AppData\Roaming\npm\

در این فولدر فایل‌های زیر (و فولدرهای مربوطه) قرار دارند:

  • rtlcss
  • less
  • lessc
  • node_modules
  • …

🔥 باید کل این فولدر را کپی کنید و در مسیر زیر قرار دهید:

C:\Program Files\Odoo\thirdparty\

اگر thirdparty وجود نداشت، آن را ایجاد کنید.

این مرحله برای ویندوز حیاتی است چون Odoo روی ویندوز به‌صورت پیش‌فرض نمی‌تواند rtlcss و less را پیدا کند؛ باید به‌صورت دستی آن‌ها را وارد مسیر thirdparty کنیم.

4. فعال‌سازی RTL داخل تنظیمات Odoo

بعد از نصب پکیج‌ها، وارد Odoo شوید و تنظیمات زبان را بررسی کنید.

مراحل:

  1. از داشبورد به مسیر زیر بروید:
    Settings → Translations → Languages
  2. زبان موردنظر (مثلاً فارسی یا عربی) را باز کنید.
  3. مقدار Direction را روی:
    Right-to-Left
    تنظیم کنید.
  4. ذخیره کنید.

5. ری‌استارت Odoo و بازسازی Asset Bundle

این مرحله بسیار مهم است؛ بدون آن، تغییرات RTL اعمال نمی‌شود.

مراحل:

  1. سرور Odoo را ری‌استارت کنید.
    در ویندوز اگر سرویس نصب کرده‌اید:
    • Services را باز کنید → Odoo Server → Restart
  2. وارد Odoo شوید.
  3. Developer Mode (حالت توسعه‌دهنده) را فعال کنید.
    مسیر:
    Settings → Activate Developer Mode 
  4. بالای صفحه روی دکمه Regenerate Assets Bundle کلیک کنید.

Odoo اکنون فایل‌های CSS جدید را با پشتیبانی کامل RTL ایجاد می‌کند.

6. رفع مشکلات احتمالی

اگر هنوز RTL درست نمایش داده نمی‌شود:

✔ دکمه های ctrl + shift + R را فشار دهید تا حافظه مرورگر برای سایت شما مجدد بارگذاری شود.

✔ مطمئن شوید Language Direction = RTL

✔ با زدن دکمه Regenerate Asset Bundle، کش استایل‌ها رفرش شود

✔ روی نسخه‌های ویندوز معمولاً مشکل daemon وجود ندارد ولی اگر اسکریپت‌های نصب خودکار جواب نداد، کتابخانه‌ها را دستی نصب کنید (همان دستوراتی که در گام 2 دادیم)

جمع‌بندی

برای راست‌چین کردن Odoo در ویندوز کافی است:

✔ Node.js نصب شود

✔ پکیج‌های LESS و RTLcss نصب شوند

✔ کل محتویات npm در مسیر thirdparty اودو کپی شوند ← مهم‌ترین مرحله

✔ زبان با جهت RTL فعال شود

✔ Asset Bundle مجدداً ساخته شود

بعد از این مراحل، Odoo کاملاً راست‌چین، صحیح و بدون مشکل نمایش داده خواهد شد.

مقاله بعدی
آموزش تصویری نصب Odoo روی ویندوز (خلاصه و کاربردی)
در این راهنما، مراحل لازم برای نصب و اجرای اودو در ویندوز را به‌صورت خلاصه و کاملاً عملی توضیح می‌دهیم.