11.6. دانلود دستی فایل‌های افزونه یا قالب

Last updated on
14 April 2025

هدف

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

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

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

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

گام‌ها

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

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

  1. صفحه پروژه افزونه یا قالب را از drupal.org باز کنید؛ برای نمونه، صفحه Admin Toolbar واقع در https://www.drupal.org/project/admin_toolbar.
  2. به قسمت دانلودها در انتهای صفحه بروید.

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

  3. روی tar.gz کلیک کرده تا فایل‌ها در رایانه شما دانلود شوند.

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

  1. اگر قصد افزودن یک افزونه یا قالب جدید را دارید، دایرکتوری‌های مورد نیاز آن‌ها را در modules و themes ایجاد کنید (اگر هم‌اکنون موجود نیستند). معمولا، برای افزونه‌ها و قالب‌های خارجی که از Drupal.org دانلود می‌شوند از دایرکتوری contrib و برای افزونه‌ها و قالب‌های سفارشی از custom استفاده می‌شود. دایرکتوری modules شما ممکن است شبیه به این باشد:

    ساختار دایرکتوری پیشنهادی برای افزونه‌ها

  2. اگر قصد تعویض یک افزونه یا قالب را با نسخه بروزرسانی شده و جدید آن دارید، ابتدا سایت را در حالت نگهداری قرار دهید. قسمت 11.2, “فعال‌سازی و غیرفعال‌سازی حالت نگهداری” را مشاهده کنید.
  3. اگر قصد تعویش یک افزونه یا قالب را با نسخه بروزرسانی شده و جدید آن دارید، تمام فایل‌های موجود برای آن افزونه یا قالب را یافته سپس حذف کنید. این فایل‌ها معمولا در مسیرهای modules یا themes قرار می‌گیرند.
  4. فایل tar.gz (یا هر فایل دیگری که ایجاد کرده‌اید) را آپلود کنید و محتویات آن را بجای همان فایل‌هایی که حذف کرده‌اید (به منظور جایگزین کردن) یا دایرکتوری‌های مرتبط با modules یا themes (به منظور افزودن) قرار دهید.
  5. فایل‌ها را از حالت tar.gz (یا هر بایگانی دیگری که ایجاد کرده‌اید) خارج کرده و در همان دایرکتوری که فایل در آن آپلود شده است قرار دهید. اگر به ترمینال دسترسی ندارید یا سرور میزبانی شما از لینوکس پشتیبانی نمی‌کند، کنترل پنل سرویس میزبانی شما راهی برای خارج کردن فایل‌ها از حالت فشرده در نظر گرفته است. اگر به یک ترمینال دسترسی دارید (تحت لینوکس) و از یک فایل tar.gz نیز استفاده کرده‌اید، می‌توانید از دستور زیر استفاده کنید:

    tar -xzf admin_toolbar-8.x-1.17.tar.gz
  6. فایل فشرده را از سرور حذف کنید، مگر هنگام عملیات قبلی حذف شده باشد.
  7. به منظور تکمیل فرآیند نصب یا بروزرسانی افزونه یا قالب به قسمت 11.3, “دانلود و نصب یک افزونه از Drupal.org، قسمت 11.5, “دانلود و نصب یک قالب از Drupal.org، قسمت 13.6, “بروزرسانی یک افزونه” یا قسمت 13.7, “بروزرسانی یک قالب” مراجعه کنید. به گامی بروید که در آن دانلود خودکار تمام شده باشد.

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

  • اگر با چندین محیط توسعه سر و کار دارید (برای نمونه، یک سایت محلی و یک سایت رسمی) گام‌های مطرح شده را در هر یک باید پیاده‌سازی کنید یا به شیوه‌ای این محیط‌ها را ادغام کنید. قسمت 11.8, “ایجاد یک سایت توسعه” را مشاهده کنید.
  • اگر قالب جدیدی اضافه کرده‌اید، از منوی مدیریت به مسیر ظاهر (admin/appearance) بروید و قالب جدید را غیرفعال کنید.

 

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: extend-manual-install.asciidoc

Help improve this page

Page status: No known problems

You can: