Add Persian translation for Features/README.md and Features/JCB-Admin-Views.md

persian/Features/JCB-Admin-Views.md

@@ -0,0 +1,83 @@
+# ویوهای مدیریتی JCB
+
+
+ویوهای مدیریتی JCB قلب هر کامپوننت تولید شده توسط Joomla Component Builder هستند. آنها مدل داده شما را با کامپایل یک‌جای جداول پایگاه داده، کنترلرهای CRUD (Create, Read, Update, Delete)، لایه‌های لیست و ویرایش، دکمه‌های نوار ابزار، قوانین ACL و حتی ویجت‌های اختیاری داشبورد، به یک تجربه مدیریتی کامل Joomla تبدیل می‌کنند. از آنجا که کامپایلر درک می‌کند که ویوهای مدیریتی چگونه با فیلدها، Dynamic Gets و دارایی‌های سمت سایت ارتباط دارند، یک ویو منظم واحد از نمونه‌های اولیه سریع تا برنامه‌های داده‌ای در سطح سازمانی، بدون نیاز به کدهای تکراری دستی، مقیاس می‌پذیرد.
+
+> 🧭 **تازه‌کار هستید؟** با [فهرست مستندات](../index.md) برای یک نقشه کلی شروع کنید، سپس هنگامی که آماده مدل‌سازی داده هستید به این بررسی عمیق قابلیت بازگردید.
+
+## چرا ویوهای مدیریتی یک قابلیت برتر هستند
+
+کمپوننت JCB با اجازه دادن به شما برای توصیف یک ویو مدیریتی تنها یک بار و واگذار کردن کارهای سنگین به کامپایلر، توسعه Joomla را تسریع می‌کند. ویژگی‌های حاصل شامل موارد زیر است:
+
+* **طرح پایگاه داده فوری** – هر ویو مدیریتی ساختار جدول خود را با نسخه‌بندی در سطح فیلد تعریف و نگهداری می‌کند.
+* **پشته MVC تولید شده** – لایه‌های لیست و ویرایش، مدل‌ها، کنترلرها، عملیات گروهی، فیلترها و نوار ابزار به طور خودکار کامپایل می‌شوند.
+* **دسترسی‌های دقیق** – سوئیچ‌های ACL جوملا دسترسی به ازای هر ویو و هر فیلد را در دسترس قرار می‌دهند و برای حاکمیت سازمانی آماده هستند.
+* **مدیریت روابط** – فرم‌های فرعی، Dynamic Gets، فیلترهای زنجیره‌ای و منطق نمایش شرطی، ویوهای مدیریتی را بدون SQL اضافی به هم متصل می‌کنند.
+* **دارایی‌های قابل استفاده مجدد** – لایه‌ها، قالب‌ها، مکان‌نماهای کد سفارشی و رشته‌های زبان همراه با ویو منتقل می‌شوند تا بتوانید آن‌ها را بین پروژه‌ها شاخه‌گیری یا بازنشانی کنید.
+
+این مرور مفهومی را هر زمان که به زمان‌بندی‌ها، تصاویر یا مثال‌های عمیق‌تر نیاز دارید، با راهنمای بلند [متن آموزش ویوهای مدیریتی JCB](../Admin-Views.md) همراه کنید.
+
+## چه زمانی یک ویو مدیریتی ایجاد کنیم
+
+هرگاه نیاز به مدیریت داده‌های ساختاریافته درون یک کامپوننت دارید - مانند مقالات، تنظیمات، کاتالوگ‌ها یا هر شیئی که شایسته عملیات CRUD باشد - یک ویو مدیریتی ایجاد کنید. کامپوننت‌های JCB بدون حداقل یک ویو مدیریتی کامپایل نخواهند شد، بنابراین آن را به عنوان نقطه شروع هر پروژه در نظر بگیرید. از آنجا می‌توانید [ویوهای مدیریتی سفارشی](../Custom-Admin-Views.md) برای داشبوردها یا [ویوهای سایت](../Adding-Site-Views-to-a-Component.md) برای رابط عمومی را به همان پایه داده متصل کنید.
+
+## چک‌لیست پیش‌نیازها
+
+قبل از شیرجه زدن در سازنده، مطمئن شوید که:
+
+1. درک کرده‌اید که [فیلدهای JCB](../JCB-Fields.md) چگونه ستون‌های پایگاه داده و ویجت‌های فرم را کنترل می‌کنند.
+2. ساختار داده خود را با استفاده از نکات [برنامه‌ریزی کلی](../General-Planning.md#12-admin-views-and-field-creation) برنامه‌ریزی کرده‌اید.
+3. کمپوننت JCB را با دنبال کردن [راهنمای نصب](../Installation-of-JCB.md) نصب یا به‌روز کرده‌اید تا داده‌های نمونه و کتابخانه‌های فیلد در دسترس باشند.
+
+## گام به گام: ساخت اولین ویو مدیریتی خود
+
+این مراحل عملی را برای ایجاد یک ویو مدیریتی قوی دنبال کنید. هر مرحله طوری طراحی شده است که حتی کاربران بار اول نیز می‌توانند در اولین تلاش خود یک صفحه حرفه‌ای بک‌اند جوملا تولید کنند.
+
+1. **بخش ویوهای مدیریتی را باز کنید**
+   1. جوملا کامپوننت بیلدر JCB را در بخش مدیریت جوملای خود راه‌اندازی کنید.
+   2. در نوار کناری، **Admin Views → New** را انتخاب کنید.
+   3. به ویو خود یک **نام مفرد** (مفرد) و **نام جمع** (برچسب لیست) بدهید. برای نام‌های مستعار جدول قابل پیش‌بینی، به نام‌های کوچک با جداکننده زیرخطی پایبند باشید.
+
+2. **ویوی خود را توصیف کنید**
+   1. توضیحات کوتاه و بلند اضافه کنید تا به هم‌تیمی‌ها در درک هدف کمک کنید.
+   2. **نوع** را انتخاب کنید: `Read/Write` برای رکوردهای قابل ویرایش یا `Read Only` برای سیاهه‌های ممیزی و جداول جستجو.
+   3. یک آیکون اختصاص دهید تا ویو در داشبورد کامپوننت برجسته شود. راهنمای [افزودن ویوهای مدیریتی به یک کامپوننت](../Adding-Admin-Views-to-a-Component.md#2-adding-view-icons) اندازه‌های توصیه شده را نشان می‌دهد.
+
+3. **فیلدها را ضمیمه کنید**
+   1. به تب **Fields** بروید.
+   2. روی **Add Field** کلیک کنید و تعاریف فیلد موجود را مجدداً استفاده کنید یا در لحظه جدید ایجاد کنید.
+   3. فیلدها را با کشیدن و رها کردن مرتب کنید تا ورودی‌های مرتبط گروه‌بندی شوند. برای ویجت‌های مناسب به [مرور انواع فیلد](../Field-Types.md#7-admin-fields-and-views) مراجعه کنید.
+
+4. **روابط را مدل‌سازی کنید**
+   1. از تب **Linked Views** برای اتصال فرم‌های فرعی یا روابط والد-فرزند استفاده کنید.
+   2. فیلترهای لیست و ترتیب‌دهی را برای فیلدهای رابطه‌ای پیکربندی کنید تا پیمایش، شهودی باشد.
+   3. هنگامی که به داده‌های تجمیع شده نیاز دارید، با دنبال کردن [راهنمای dynamicGet](../dynamicGet.md#overview)، Dynamic Gets را ضمیمه کنید.
+
+5. **تجربه را اصلاح کنید**
+   1. تاریخچه نسخه، عملیات گروهی، صادرات/واردات و سوئیچ‌های فراداده را در تب **Options** فعال کنید.
+   2. پیش‌فرض‌های ACL جوملا را در تب **Permissions** تنظیم کنید تا ویراستاران، مدیران و ادمین‌ها از ابتدا دسترسی مناسب داشته باشند.
+   3. CSS، جاوااسکریپت یا PHP سفارشی را در مکان‌نماهای ارائه شده قرار دهید تا رفتار را بدون هک کد تولید شده گسترش دهید.
+
+6. **ویوی خود را به کامپوننتتان پیوند دهید**
+   1. درون JCB به **Components → Your Component → Admin Views** بروید.
+   2. تنظیم کنید که ویو در کجا ظاهر شود (منوی اصلی، ماژول داشبورد، زیرمنو، اقدامات سریع).
+   3. کامپوننت را کامپایل و نصب کنید. تصاویر دقیق در [راهنمای یکپارچه‌سازی ویو مدیریتی](../Adding-Admin-Views-to-a-Component.md) موجود است.
+
+7. **آزمایش و تکرار**
+   1. کامپوننت کامپایل شده را در بخش مدیریت جوملا باز کنید تا رکوردهای نمونه اضافه کنید.
+   2. تأیید کنید که فیلترهای لیست، دسترسی‌ها و دکمه‌های نوار ابزار مطابق انتظار رفتار می‌کنند.
+   3. اگر نیاز به تنظیم طرح دارید، ویو مدیریتی را به‌روز کرده و مجدداً کامپایل کنید — JCB مدیریت مهاجرت پایگاه داده را از طریق [به‌روزرسان SQL خودکار](../Auto-create-SQL-updates-for-Componets-in-JCB.md) انجام می‌دهد.
+
+## نکات بهره‌وری
+
+* **از ویوهای اثبات شده مجدداً استفاده کنید** – ویوهای مدیریتی را از مخازن مشترک بازنشانی یا شاخه‌گیری کنید تا تیم شما با طرح‌های ممیزی شده و الگوهای UI شروع کند.
+* **منطق را اعلانی نگه دارید** – قبل از نوشتن PHP سفارشی، از شرایط، فیلدهای زنجیره‌ای و Dynamic Gets استفاده کنید. تنظیمات اعلانی پس از تولید مجدد باقی می‌مانند و فرآیند آشنایی را تسریع می‌کنند.
+* **انتخاب‌ها را مستند کنید** – از فیلدهای توضیحات و پیام‌های کامیت استفاده کنید تا توضیح دهید چرا هر ویو وجود دارد. همکاران آینده می‌توانند سپس با استفاده از پیوندهای بالا مستقیماً به سراغ قابلیت بروند.
+
+## گام‌های بعدی و یادگیری مرتبط
+
+* با [ویوهای مدیریتی سفارشی](../Custom-Admin-Views.md) ادامه دهید تا داشبوردهایی بسازید که از همان داده استفاده می‌کنند.
+* [راه‌اندازی ویو ویرایش سایت](../Setup-Site-Edit-View-in-JCB.md) را کاوش کنید تا داده‌های ویو مدیریتی خود را در فرانت‌اند نمایش دهید.
+* پس از انتشار راهنماهای قابلیت اضافی (به زودی)، [فهرست پوشه ویژگی‌ها](../Features/README.md) را نشانک گذاری کنید.
+
+هر زمان که به موضوع دیگری نیاز دارید، به [فهرست اصلی مستندات](../index.md) بازگردید.

persian/Features/README.md

@@ -0,0 +1,9 @@
+# بررسی عمیق قابلیت‌های JCB
+
+پوشه **Features** مجموعه‌ای از راهنمایی‌های متمرکز را گردآوری می‌کند که قابلیت‌های کلیدی Joomla Component Builder را بسط می‌دهد. هر مقاله توضیح می‌دهد که چه زمانی از هر قابلیت استفاده کنید، چرا اهمیت دارد و چگونه مرحله‌به‌مرحله آن را پیکربندی کنید تا اعضای جدید تیم بتوانند با اطمینان مشارکت کنند. اگر نیاز به یک مسیر پایدار گام‌به‌گام، قابل دنبال کردن و مرور در بقیه مستندات دارید، از این نقطه با [راهنمای شروع کار](../README.md) همراه شوید.
+
+## قابلیت‌های موجود
+
+* [ویوی مدیریتی JCB](./JCB-Admin-Views.md) — داده‌های خود را یک بار مدل‌سازی کنید و اجازه دهید JCB تمام تجربه بخش ادمین Joomla را کامپایل کند.
+
+برای دسترسی به فهرست و سایر آموزشها، به [فهرست اصلی مستندات](../index.md) بازگردید.