[[extend-manual-install]]
=== دانلود دستی فایل‌های افزونه یا قالب

[role="summary"]
چگونگی دانلود دستی فایل‌های افزونه یا قالب و آپلود آن در سرور.

(((Module,downloading)))
(((Contributed module,downloading)))
(((Theme,downloading)))
(((Contributed theme,downloading)))
(((Downloading,module or theme files manually)))
(((Manually downloading module or theme files,overview)))

==== هدف

دانلود دستی فایل‌های افزونه یا قالب و قرار دادن آن‌ها در سرور سایت، اگر روش‌های رابط مدیریتی یا Drush برای نصب و بروزرسانی افزونه‌ها و قالب‌ها کار نمی‌کند یا شما قصد قرار دادن یک افزونه یا قالب سفارشی را در سایت خود دارید.

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

* <<understanding-modules>>
* <<extend-module-find>>
* <<understanding-themes>>
* <<extend-theme-find>>

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

باید هر یک از گزینه‌های زیر هنگام دانلود دستی فایل‌های یک افزونه یا قالب را مد نظر قرار دهید:

* مشکلات مجوزهای فایل

* مشکلات مجوزهای FTP

* شما یک افزونه/قالب سفارشی ایجاد کرده یا آن را از فرد دیگری گرفته باشید

* شما نمی‌توانید به راحتی دستورالعمل‌های واقع در <<extend-module-install>>، <<extend-theme-install>>، <<security-update-module>> یا <<security-update-theme>> را با موفقیت به پایان برسانید.

اگر هیچ کدام از گزینه‌های بالا برای شما صادق نیست، این قسمت را نادیده بگیرید.

==== گام‌ها

اگر قصد نصب یک افزونه یا قالب را از _Drupal.org_ دارید، از دستورالعمل‌های دانلود پیروی کرده سپس دستورالعمل‌های آپلود را دنبال کنید. اگر شما افزونه یا قالب را ایجاده کرده‌اید، گام مربوط به دانلود را نادیده بگیرید. در عوض، یک فایل بایگانی ایجاد کرده (که می‌دانید چطور می‌شود در سرور ذخیره کرد) و گام‌های موجود در قسمت آپلود را با هر شیوه‌ای که مناسب کار خودتان است، دنبال کنید.

===== دانلود فایل‌ها

. صفحه پروژه افزونه یا قالب را از drupal.org باز کنید؛ برای نمونه، صفحه _Admin Toolbar_ واقع در https://www.drupal.org/project/admin_toolbar.

. به قسمت _دانلودها_ در انتهای صفحه بروید.
+
--
// Downloads section of the Admin Toolbar project page on drupal.org.
image:images/extend-manual-install-download.png["دانلود فایل‌های افزونه"]
--

. روی _tar.gz_ کلیک کرده تا فایل‌ها در رایانه شما دانلود شوند.

===== آپلود فایل‌ها به سایت و خارج کردن آن‌ها از حالت فشرده

. اگر قصد افزودن یک افزونه یا قالب جدید را دارید، دایرکتوری‌های مورد نیاز آن‌ها را در _modules_ و _themes_ ایجاد کنید (اگر هم‌اکنون موجود نیستند). معمولا، برای افزونه‌ها و قالب‌های خارجی که از _Drupal.org_ دانلود می‌شوند از دایرکتوری _contrib_ و برای افزونه‌ها و قالب‌های سفارشی از _custom_ استفاده می‌شود. دایرکتوری _modules_ شما ممکن است شبیه به این باشد:
+
--
// Make custom and contrib directories under modules, and take a screen shot
// showing the directory structure.
image:images/extend-manual-install-directories.png["ساختار دایرکتوری پیشنهادی برای افزونه‌ها",width="174px"]

// NOTE for Translators: you don't need to localize the 'custom' and 'contrib' directory names as they are more common in English.
--

. اگر قصد تعویض یک افزونه یا قالب را با نسخه بروزرسانی شده و جدید آن دارید، ابتدا سایت را در حالت نگهداری قرار دهید. <<extend-maintenance>> را مشاهده کنید.

. اگر قصد تعویش یک افزونه یا قالب را با نسخه بروزرسانی شده و جدید آن دارید، تمام فایل‌های موجود برای آن افزونه یا قالب را یافته سپس حذف کنید. این فایل‌ها معمولا در مسیرهای _modules_ یا _themes_ قرار می‌گیرند.

. فایل _tar.gz_ (یا هر فایل دیگری که ایجاد کرده‌اید) را آپلود کنید و محتویات آن را بجای همان فایل‌هایی که حذف کرده‌اید (به منظور جایگزین کردن) یا دایرکتوری‌های مرتبط با _modules_ یا _themes_ (به منظور افزودن) قرار دهید.

. فایل‌ها را از حالت _tar.gz_ (یا هر بایگانی دیگری که ایجاد کرده‌اید) خارج کرده و در همان دایرکتوری که فایل در آن آپلود شده است قرار دهید. اگر به ترمینال دسترسی ندارید یا سرور میزبانی شما از لینوکس پشتیبانی نمی‌کند، کنترل پنل سرویس میزبانی شما راهی برای خارج کردن فایل‌ها از حالت فشرده در نظر گرفته است. اگر به یک ترمینال دسترسی دارید (تحت لینوکس) و از یک فایل tar.gz نیز استفاده کرده‌اید، می‌توانید از دستور زیر استفاده کنید:
+
----
tar -xzf admin_toolbar-8.x-1.17.tar.gz
----

. فایل فشرده را از سرور حذف کنید، مگر هنگام عملیات قبلی حذف شده باشد.

. به منظور تکمیل فرآیند نصب یا بروزرسانی افزونه یا قالب به <<extend-module-install>>، <<extend-theme-install>>، <<security-update-module>> یا <<security-update-theme>> مراجعه کنید. به گامی بروید که در آن دانلود خودکار تمام شده باشد.

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

* اگر با چندین محیط توسعه سر و کار دارید (برای نمونه، یک سایت محلی و یک سایت رسمی) گام‌های مطرح شده را در هر یک باید پیاده‌سازی کنید یا به شیوه‌ای این محیط‌ها را ادغام کنید. <<install-dev-making>> را مشاهده کنید.

* اگر قالب جدیدی اضافه کرده‌اید، از منوی _مدیریت_ به مسیر _ظاهر_ (_admin/appearance_) بروید و قالب جدید را غیرفعال کنید.

// ==== Related concepts

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

* https://www.drupal.org/node/250790[صفحه "بروزرسانی افزونه‌ها" در مستندات جامعه‌کاربری _Drupal.org_]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-drupal-8-modules[صفحه "نصب افزونه‌های خارجی" در مستندات جامعه‌کاربری _Drupal.org_]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-themes[صفحه "نصب قالب‌ها" در مستندات جامعه‌کاربری _Drupal.org_]

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

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

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