سفارشی‌سازی Greenlight

Greenlight v3 قابلیت سفارشی‌سازی متناسب با نیازهای شما را دارد. به‌صورت پیش‌فرض، این برنامه دارای مجموعه‌ای از امکانات و تنظیمات استاندارد است که از طریق پنل مدیریت (Administrator Panel) قابل تغییر هستند. در صورتی که به سطح بالاتری از سفارشی‌سازی نیاز دارید، می‌توانید مراحل زیر را دنبال کنید.

نکته مهم:

اگرچه سفارشی‌سازی Greenlight v3 می‌تواند راهکاری مناسب برای تطبیق پلتفرم با نیازهای خاص سازمان شما باشد، اما انجام تغییرات سفارشی ممکن است با ریسک‌هایی همراه باشد. پیش از اعمال هرگونه تغییر، لازم است از این موارد آگاه باشید:

• ریسک‌های امنیتی: تغییرات سفارشی ممکن است ناخواسته باعث ایجاد آسیب‌پذیری‌های امنیتی شوند.
• مشکلات سازگاری: تغییرات اعمال‌شده ممکن است با به‌روزرسانی‌های آینده پلتفرم سازگار نباشند و منجر به بروز خطا یا اختلال شوند.
• محدودیت در پشتیبانی: اعمال تغییرات سفارشی ممکن است میزان پشتیبانی دریافتی از توسعه‌دهندگان اصلی پلتفرم را محدود کند.
• هزینه نگهداری: تغییرات سفارشی نیازمند نگهداری و به‌روزرسانی مستمر هستند.

تغییر متون (Text Changes)

Greenlight v3 این امکان را فراهم می‌کند که تمامی رشته‌های متنی مورد استفاده در رابط کاربری را سفارشی‌سازی کنید. این شامل برچسب‌ها، پیام‌ها، اعلان‌ها و سایر متون می‌شود تا بتوانید آن‌ها را با اصطلاحات یا زبان موردنظر سازمان خود تطبیق دهید.

ابتدا فایل حاوی متنی که قصد تغییر آن را دارید پیدا کنید. فایل‌های زبان در دو مسیر زیر قرار دارند:

• app/assets/locales
• config/locales

در این مثال از فایل en.json در مسیر app/assets/locales/ استفاده می‌کنیم، اما می‌توانید تغییرات را در هر فایل دلخواه اعمال نمایید.

پس از یافتن فایل موردنظر، آن را در پوشه greenlight-v3 خود کپی کرده و ویرایش‌های لازم را انجام دهید.

سپس فایل docker-compose را ویرایش کنید تا فایل جدید شما داخل کانتینر بارگذاری شود. برای این کار، یک خط به بخش volumes اضافه کنید:

volumes:
  - ./data/greenlight-v3/storage:/usr/src/app/storage
  - ./en.json:/usr/src/app/app/assets/locales/en.json

یا در صورت استفاده از مسیر دیگر:

volumes:
  - ./data/greenlight-v3/storage:/usr/src/app/storage
  - ./en.json:/usr/src/app/config/locales/en.json

در نهایت، Greenlight v3 را ری‌استارت کنید تا تغییرات جدید در پلتفرم اعمال شوند.

تغییر کد (Code Changes)

سفارشی‌سازی کد در Greenlight v3 انعطاف‌پذیری و کنترل بیشتری بر رفتار پلتفرم فراهم می‌کند. با این حال، ویرایش کد پیچیده‌تر است و ریسک بروز خطا یا مشکلات سازگاری را افزایش می‌دهد.

اگر قصد تغییر کد را دارید، باید آشنایی کامل با Ruby on Rails و React (فریم‌ورک‌های مورد استفاده در Greenlight v3) داشته باشید. همچنین لازم است ساختار کد و وابستگی‌های پروژه را به‌خوبی بشناسید.

ابتدا فایل موردنظر برای ویرایش را در مخزن Greenlight جستجو کنید.

پس از یافتن فایل، آن را در پوشه greenlight-v3 خود کپی کرده و تغییرات لازم را اعمال کنید.

در این مثال از فایل rooms_controller.rb در مسیر app/controllers/api/v1/ استفاده می‌کنیم، اما می‌توانید هر فایل دیگری را نیز ویرایش نمایید.

سپس فایل docker-compose را ویرایش کرده و مسیر فایل جدید را به بخش volumes اضافه کنید:

volumes:
  - ./data/greenlight-v3/storage:/usr/src/app/storage
  - ./rooms_controller.rb:/usr/src/app/app/controllers/api/v1/rooms_controller.rb

در پایان، Greenlight v3 را مجدداً راه‌اندازی (Restart) کنید تا تغییرات اعمال‌شده در پلتفرم نمایش داده شوند.