[[extend-module-find]]
=== یافتن افزونه‌ها

[role="summary"]
چگونگی جستجو و ارزیابی افزونه‌ها در Drupal.org.

(((Module,finding)))
(((Module,evaluating)))
(((Contributed module,finding)))
(((Contributed module,evaluating)))
(((Drupal.org website,finding and evaluating modules on)))

==== هدف

یافتن و ارزیابی افزونه‌ها در _Drupal.org_.

==== دانش پیشنیاز

* <<understanding-drupal>>
* <<understanding-modules>>

//==== Site prerequisites

==== گام‌ها

. از نشانی https://www.drupal.org[_Drupal.org_] به مسیر _دانلود و توسعه_ > _افزونه‌ها_ (https://www.drupal.org/project/project_module) بروید.

. جستجوی خود را با استفاده از طبقه‌بندی‌های صفحه جستجو افزونه فیلتر کنید. فیلدها را با توجه به جدول زیر پر کنید.
+
[width="100%",frame="topbot",options="header"]
|================================
| نام فیلد | توضیحات | مقدار نمونه
| وضعیت نگهداری | افزونه با چه شرایطی مدیریت می‌شود؟ | Actively maintained
| وضعیت توسعه | چه نوع توسعه‌ای برای افزونه در نظر گرفته شده است؟| Any
| طبقه‌بندی‌های افزونه | ناحیه پوشش افزونه. | Administration
| سازگاری با هسته | نسخه هسته که افزونه با آن سازگار است.| 8.x
| وضعیت | وضعیت پروژه: پروژه‌های _sandbox_ حالت آزمایشی دارند.  پروژه‌های _full_ فرآیند بازبینی را رد کرده اما ممکن است در حال توسعه باشند. | Full projects
| جستجوی افزونه‌‌ها | به جستجوی _Admin Toolbar_ بپردازید، افزونه‌ای که در ادامه آن را توضیح می‌دهیم. اگر قصد جستجوی افزونه خاصی را ندارید، می‌توانید آن را خالی بگذارید. | Admin Toolbar
| مرتب‌سازی | ترتیب نمایش نتایج جستجو مانند _بیشترین نصب‌شده‌ها_ (افزونه‌های محبوب که اکثر سایت‌ها استفاده می‌کنند) یا _آخرین انتشار_ (تاریخ آخرین نسخه انتشار). | Most Installed
|================================
+
--
// Module search box on https://www.drupal.org/project/project_module.
image:images/extend-module-find_module_finder.png["فیلترهای موجود در صفحه جستجوی افزونه‌های _Drupal.org_"]
--

. روی _جستجو_ کلیک کنید. نتایج جستجو نمایش داده می‌شود.
+
--
// Search results on https://www.drupal.org/project/project_module.
image:images/extend-module-find_search_results.png["صفحه نمایش نتایج افزونه‌ها در _Drupal.org_"]
--

. برای ارزیابی بیشتر یک افزونه، روی عنوان آن از صفحه نتایج کلیک کرده تا به صفحه پروژه هدایت شوید.

برخی جنبه‌های قابل توجه هنگام ارزیابی افزونه‌ها:

* توضیح پروژه: توضیح افزونه در صفحه پروژه خود باید واضح و کاربردی باشد. شما با خواندن آن باید به ویژگی‌ها و نیازمندی‌هایش پی ببرید.

* وضعیت نگهداری: اگر یک افزونه به صورت _Actively Maintained_ باشد، می‌توانید از وجود بروزرسانی‌های امنیتی، برطرف کردن باگ‌ها و بهینه‌سازی ویژگی‌ها به صورت مداوم اطمینان حاصل کنید. اگرچه، اگر افزونه نگهداری نشده یا رها شده باشد، نباید از آن استفاده کنید.

* وضعیت توسعه: _Under Active Development_ یعنی باید انتظار ویژگی‌های جدید را برای افزونه داشته باشید، اما برخی جنبه‌ها (برای نمونه API) ممکن است تغییر کنند. _Maintenance Fixes Only_ یعنی ویژگی‌های کلی پروژه کامل شده است.

* دانلودها و نصب‌های گزارش شده: می‌توانید تعداد دفعاتی که افزونه دانلود یا در سایتی بکار رفته است را مشاهده کنید. اگر تنها توسط چند سایت استفاده شده باشد، ممکن است راه حلی منحصربفرد باشد که به کار دیگران نمی‌آید یا ممکن است نشانه اخطاری باشد که می‌گوید نباید از آن استفاده کنید.

* نگهدارندگان: آخرین commit (زمانی که یک نفر تغییری در پروژه ایجاد کرده است) یا آخرین انتشار (نسخه جدید) چه زمانی بوده است؟ اگر پروژه تنها چند issue باز دارد، زمان طولانی بین commit و انتظار قابل قبول است اما اگر دارای تعداد زیادی issue باز است و هیچ commit یا انتشاری موجود نیست، ممکن است نشانه این باشد که پروژه رها شده است.

* مشکلات: ببینید آیا هیچ issue بازی وجود دارد، مشکلات احتمالی با افزونه. قسمت _آمار_ را به منظور بازه زمانی پاسخگویی به مشکلات بررسی کنید.

* منابع: بررسی کنید آیا افزونه دارای فایل README یا مستندات است یا خیر، که می‌تواند به فرآیند نصب، پیکربندی، پیمایش و آزمون آن به شما کمک کند.
+
--
// Project page for Admin Toolbar module.
image:images/extend-module-find_project_info.png["اطلاعات صفحه پروژه که به ارزیابی شما از افزونه کمک می‌کند", width="100%"]
--

==== درک خود را گسترش دهید

<<extend-module-install>>

//==== Related concepts

//==== Additional resources

*مشارکت‌کنندگان*

نگارش توسط https://www.drupal.org/u/dianalakatos[Diána Lakatos] در https://pronovix.com//[Pronovix]

ترجمه توسط https://www.drupal.org/u/novid[Navid Emami]
