کتابخانه رسانه جایی است که همهٔ فایل‌های تصویری، ویدیویی و اسناد میزکار را نگه می‌دارید — یک‌بار آپلود، بارها در محصول، سایت، فاکتور و … استفاده. این راهنما هم صفحهٔ کامل (/media) و هم انتخابگر داخل فرم‌ها را پوشش می‌دهد.

این قابلیت چیست؟

آپلود در /media ──► ذخیره در میزکار ──► انتخاب در فرم محصول / پست / …
                         │
                         └──► لینک public در سایت منتشر می‌شود

رسانه‌ها workspace-scoped هستند — میزکار A فایل میزکار B را نمی‌بیند.

کجا در پنل پیدا می‌شود؟

نکته: در منوی اصلی دسکتاپ لینک مستقیم /media ممکن است نباشد — از سایت یا فرم محصول هم reachable است.

صفحهٔ /media — گام‌به‌گام

۱. باز کردن کتابخانه

1. به /media بروید (یا از داشبورد سایت).

2. sidebar چپ: «همه رسانه‌ها» + لیست پوشه‌ها.

3. وسط: grid فایل‌ها با scroll بی‌نهایت.

4. بالا: toolbar جستجو، فیلتر، آپلود، پوشه جدید.

۲. آپلود فایل

1. آپلود را بزنید — یا فایل را drag & drop کنید.

2. می‌توانید چند فایل یک‌جا بفرستید.

3. فایل در پوشهٔ انتخاب‌شده ذخیره می‌شود؛ اگر «همه رسانه‌ها» selected باشد → root.

4. فایل‌ها public آپلود می‌شوند (برای نمایش در سایت).

۳. پوشه بسازید

1. پوشه جدید → نام بنویسید.

2. پوشه در sidebar ظاهر می‌شود.

3. پوشه را انتخاب کنید → آپلودهای بعدی آنجا می‌روند.

ویرایش / حذف پوشه: از sidebar — حذف پوشه فایل‌ها را پاک نمی‌کند (به root یا بدون پوشه می‌روند؛ بسته به رفتار API).

۴. جستجو و فیلتر

فیلتر نوع در مرورگر اعمال می‌شود — اگر فیلتر «تصاویر» خالی بود، سیستم خودکار صفحات بعدی را load می‌کند تا تصویر پیدا شود.

۵. جزئیات فایل (drawer)

روی هر فایل کلیک کنید:

انتخابگر رسانه در فرم‌ها (Picker)

بسیاری از فرم‌ها به‌جای upload مستقیم، کتابخانه را باز می‌کنند:

کجا استفاده می‌شود؟

گام‌به‌گام — انتخاب از picker

1. در فرم روی انتخاب از کتابخانه (یا «انتخاب رسانه») کلیک کنید.

2. مودال باز می‌شود — دو تب:

   • کتابخانه — browse + جستجو + فیلتر

   • آپلود — upload بدون رفتن به /media

3. فایل را کلیک کنید (highlight).

4. انتخاب → مودال بسته + preview در فرم.

5. برای حذف: حذف رسانه در فرم.

محدودیت accept: بعضی picker فقط تصویر یا ویدیو می‌پذیرند — تب آپلود همان محدودیت را دارد.

جریان‌های عملی

«لوگوی سایت را عوض کنم»

1. /media → آپلود لوگو در پوشه «برند»

2. سایت → تنظیمات پایه → انتخاب از کتابخانه → لوگو

   — یا مستقیم: تغییر لوگو

«تصویر محصول»

1. محصولات → ایجاد/ویرایش

2. فیلد تصویر → انتخاب از کتابخانه

3. برای چند تصویر: گالری — چند بار picker

«تصویر داخل مقاله»

1. سایت → پست → ویرایشگر متن

2. دکمه درج تصویر → picker

3. جزئیات editor: ویرایشگر محتوا

نکات مهم

یک‌بار آپلود، چندبار استفاده

همان fileId در چند جا reference می‌شود. حذف فایلی که در سایت publish شده → تصویر broken — قبل از حذف usage را چک کنید.

نام و عنوان

• نام فایل — از upload می‌آید

• عنوان — برای جستجو در picker مفید است؛ در drawer ویرایش کنید

حجم و فرمت

محدودیت‌ها از API — اگر upload fail شد، فرمت یا حجم را کم کنید. ویدیوهای سنگین → صبر بیشتر.

public بودن

فایل‌های کتابخانه برای نمایش وب public هستند. اسناد محرمانه را اینجا نگذارید — از /documents (مدیریت سند) برای فایل‌های داخلی استفاده کنید.

performance

کتابخانه ۴۸ فایل در هر batch load می‌کند + scroll بی‌نهایت — workspace با هزاران فایل هم باید روان باشد.

تفاوت /media و /documents

مشکلات رایج

قدم بعدی

منابع

• داشبورد سایت — میانبر رسانه