[[extend-module-install]]
=== دانلود و نصب یک افزونه از _Drupal.org_

[role="summary"]
چگونگی دانلود و نصب یک افزونه از Drupal.org با استفاده از رابط مدیریتی یا Drush.

(((Module,downloading)))
(((Module,installing)))
(((Module,enabling)))
(((Module,contributed)))
(((Module,custom)))
(((Downloading,module)))
(((Installing,module)))
(((Enabling,module)))
(((Contributed module,downloading)))
(((Contributed module,installing)))
(((Functionality,extending)))
(((Drush tool,using to download and install module)))
(((Admin Toolbar module,downloading)))
(((Admin Toolbar module,installing)))
(((Module,Admin Toolbar)))
(((Update Manager module,using to install module)))
(((Module,Update Manager)))
(((Drupal.org website,downloading and installing module from)))

==== هدف

دانلود و نصب https://www.drupal.org/project/admin_toolbar[افزونه خارجی Admin Toolbar] که به شما اجازه می‌دهد به راحتی در میان رابط مدیریتی وبسایت پیمایش کنید.

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

* <<understanding-modules>>
* <<extend-module-find>>
* <<install-tools>>

==== پیشنیازهای سایت

* اگر قصد نصب افزونه‌ها از طریق رابط مدیریتی وبسایت را دارید، افزونه داخلی Update Manager باید نصب گردد. برای اطلاعات بیشتر درباره نصب افزونه‌ها، <<config-install>> را مشاهده کنید.

* اگر قصد استفاده از Drush را دارید، <<install-tools>> را مشاهده کنید.

==== گام‌ها

برای نصب یک افزونه خارجی، می‌توانید از رابط مدیریتی یا Drush استفاده کنید. اگر قصد نصب یک افزونه سفارشی را دارید و پیام _نصب افزونه‌ها و قالب‌ها نیازمند دسترسی FTP به سرور شما می‌باشد_ نمایش یافت، یا گام‌های پیش رو برای دانلود و استفاده از افزونه‌های خارجی به کار شما نمی‌آید، <<extend-manual-install>> را مشاهده کنید. اگر قصد نصب افزونه خارجی را دارید که وابستگی‌های خود را با استفاده از Composer مدیریت می‌کند، <<install-composer>> را مشاهده کنید. در هر کدام از این موارد، به گام ۷ از این راهنما مراجعه کرده تا فرآیند نصب افزونه کامل شود.

===== استفاده از رابط مدیریتی

. در صفحه پروژه _Admin Toolbar_ وافع در _https://www.drupal.org/project/admin_toolbar_ به قسمت _دانلودها_ در انتهای صفحه بروید.

. از نشانی پیوند _tar.gz_ رونوشت بگیرید.
+
--
// Downloads section of the Admin Toolbar project page on drupal.org.
image:images/extend-module-install-download.png["یافتن نشانی یک افزونه"]
--

. از منوی _مدیریت_ به مسیر _توسعه_ (_admin/modules_) بروید. صفحه _توسعه_ نمایش داده می‌شود.

. روی _نصب افزونه جدید_ کلیک کنید. صفحه _نصب افزونه جدید_ نمایش می‌یابد.
+
--
// Install new module page (admin/modules/install).
image:images/extend-module-install-admin-toolbar-do.png["نصب افزونه با استفاده از نشانی آن"]
--

. در فیلد _نصب از یک نشانی_ محتوای پیوند موجود را قرار دهید. این مقدار شبیه به زیر است:
_https://ftp.drupal.org/files/projects/admin_toolbar-8.x-1.14.tar.gz_

. روی _نصب_ کلیک کنید تا افزونه جدید در سرور قرار بگیرد. فایل‌ها در دایرکتوری _modules_ قرار می‌گیرند.

. روی _فعال‌سازی افزونه‌های تازه اضافه شده_ کلیک کنید تا به صفحه _توسعه_ بازگردید. اگر با شیوه دستی اقدام به قرار دادن فایل‌ها روی سرور کرده‌اید، از منوی _مدیریت_ به مسیر _توسعه_ (_admin/modules_) رفته و از آنجا ادامه دهید.

. _Admin Toolbar_ را شناسایی و انتخاب کنید.

برای فعال‌سازی افزونه جدید روی _نصب_ کلیک کنید.

===== استفاده از Drush

. نام پروژه افزونه‌ای که قصد نصب آن را دارید پیدا کنید، این نام قسمت انتهایی نشانی صفحه پروژه است. برای نمونه، اگر نشانی پروژه _https://www.drupal.org/project/admin_toolbar_ باشد، آنگاه نام پروژه برابر "admin_toolbar" است.

. با استفاده از نام پروژه (برای نمونه `admin_toolbar`)، دستورات زیر را اجرا کنید:
+
----
drush dl admin_toolbar
drush en admin_toolbar
----

. توضیحات روی صفحه را دنبال کنید.

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

* با پیمایش از منوی مدیریتی سایت به قسمت‌های مختلف، اطمینان یابید که https://www.drupal.org/project/admin_toolbar[افزونه خارجی Admin Toolbar] به درستی کار می‌کند.

* با نصب و پیکربندی https://www.drupal.org/project/pathauto[افزونه خارجی Pathauto] محتوای سایت خود را به صورت خودکار از نشانی‌های تمیز بهره‌مند سازید. برای اطلاعات بیشتر <<content-paths>> را مشاهده کنید.

* اگر تاثیر این تغییرات را در سایت خود مشاهده نمی‌کنید، ممکن است لازم باشد حافظه موقت را پاکسازی نمایید. <<prevent-cache-clear>> را مشاهده کنید.

//==== Related concepts

==== منابع مطالعاتی

* https://www.drupal.org/node/340271[صفحه "افزونه‌های خارجی" در مستندات جامعه‌کاربری _Drupal.org_]
* https://www.drupal.org/download[صفحه "دانلود و توسعه" در _Drupal.org_]
* https://www.drupal.org/project/admin_toolbar[افزونه Admin Toolbar در _Drupal.org_]

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

نگارش و ویرایش توسط https://www.drupal.org/u/batigolix[Boris Doesborg] و https://www.drupal.org/u/jhodgdon[Jennifer Hodgdon]

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