افزونه مدیریت رسانه وردپرس نگاربان پرو (Negarban Pro): پوشه‌بندی، فیلتر، ویرایش گروهی، واترمارک و فضای ابری ایرانی

نگاربان یک افزونه مدیریت رسانه وردپرس است که کتابخانهٔ رسانهٔ خودِ وردپرس را گسترش می‌دهد، نه این‌که آن را با یک صفحهٔ غریبه جایگزین کند. همان گرید آشنا، همان پنجرهٔ «افزودن رسانه» در گوتنبرگ و گالری محصول ووکامرس؛ فقط حالا پوشه دارد، فیلتر واقعی دارد، چند صد فایل را با یک کلیک ویرایش می‌کند، واترمارک فارسی می‌زند، فایل‌ها را به فضای ابری ایرانی می‌فرستد و از رسانه‌ها بکاپ می‌گیرد. همهٔ کارهای سنگین در پس‌زمینه با نوار پیشرفت اجرا می‌شوند و افزونه هیچ وابستگی Composer یا سرویس خارجی ندارد.

کتابخانهٔ رسانه با درخت پوشه‌ها در کنار گرید: شمارندهٔ هر پوشه، جست‌وجوی پوشه، پوشه‌های هوشمند و نشان‌های «روی ابر»، «واترمارک‌شده» و «بدون alt» روی هر فایل.

چرا کتابخانهٔ رسانهٔ وردپرس برای یک فروشگاه کافی نیست؟

بعد از چند هزار تصویر محصول، کتابخانهٔ رسانه فقط یک گرید بی‌پایان است: نه پوشه‌ای برای جدا کردن بنرها از عکس محصول، نه راهی برای پیدا کردن تصویرهای بدون متن جایگزین، نه امکان این‌که alt دویست عکس یک دسته را یک‌جا درست کنید. فایل‌ها حجم هاست را پر می‌کنند، بکاپ کامل سایت هر شب ساعت‌ها طول می‌کشد و برای واترمارک هر عکس باید به فتوشاپ برگردید. نگاربان دقیقاً همین شش مشکل را حل می‌کند، بدون این‌که آدرس حتی یک فایل عوض شود.

پوشه‌بندی مجازی، در کتابخانه و در پنجرهٔ انتخاب رسانه

• درخت نامحدود با رنگ، شمارندهٔ فایل، جست‌وجو و جمع کردن/باز کردن شاخه‌ها؛ پوشه‌ها مجازی‌اند و URL فایل‌ها دست نمی‌خورد.

• کشیدن‌ورها‌کردن: فایل‌ها را روی پوشه بیندازید (چندتایی هم می‌شود)، پوشه را زیر پوشهٔ دیگر ببرید. با Alt به‌جای انتقال، میان‌بر ساخته می‌شود تا یک فایل در چند پوشه دیده شود.

• همان درخت داخل مودال رسانه: گوتنبرگ، ویرایشگر کلاسیک، تصویر شاخص، گالری محصول ووکامرس، المنتور و هر جایی که wp.media باز می‌شود.

• پوشهٔ پیش‌فرض آپلود: پوشهٔ انتخاب‌شده، یک پوشهٔ ثابت، یا قوانین خودکار: مثلاً تصاویر محصولات دستهٔ «کفش» خودکار به «محصولات / کفش» بروند و آپلودهای هر کاربر به پوشهٔ خودش.

• پوشه‌های خصوصی برای هر کاربر، منوی راست‌کلیک (تغییر نام، رنگ، زیرپوشه، دانلود zip، حذف) و مهاجرت یک‌کلیکی از FileBird، Real Media Library، Enhanced Media Library، CatFolders و WP Media Folder.

پنجرهٔ انتخاب رسانه در گالری محصول ووکامرس: همان پوشه‌ها و همان فیلترها، بدون ترک صفحهٔ محصول.

فیلترهایی که روی ده‌ها هزار فایل هم سریع می‌مانند

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

• نوع (تصویر، ویدیو، صدا، سند، آرشیو) و پسوند دقیق (jpg، webp، svg، pdf، zip…)

• بازهٔ تاریخ شمسی با میان‌برهای امروز، ۷ روز، ۳۰ روز و امسال

• حجم فایل، حداقل/حداکثر عرض و ارتفاع، جهت افقی/عمودی/مربع

• استفاده‌شده / بی‌استفاده (تصویر شاخص، گالری، گالری محصول، محتوای نوشته‌ها، تصویر دسته، لوگو)، دارای alt / بدون alt، محلی / روی ابر، واترمارک‌شده، آپلودکننده، برچسب رسانه و مرتب‌سازی بر اساس حجم و ابعاد و تعداد استفاده

• پوشه‌های هوشمند: هر فیلتر را ذخیره کنید تا زیر درخت پوشه‌ها بنشیند؛ مثلاً «تصاویر بزرگ‌تر از ۲ مگابایت بدون alt» یا «فایل‌های بی‌استفاده».

• ستون‌های حجم، ابعاد، پوشه، محل ذخیره و تعداد استفاده در نمای لیستی، با مرتب‌سازی

نوار فیلتر پیشرفته بالای گرید؛ فیلترهای فعال به شکل چیپ نمایش داده می‌شوند و با ستاره ذخیره می‌شوند.

ویرایش گروهی با سه حالت و الگوهای متنی

در حالت «انتخاب دسته‌جمعی» (یا با «انتخاب همهٔ N نتیجهٔ این فیلتر») عنوان، متن جایگزین، زیرنویس، توضیح، نویسنده، تاریخ، برچسب و پوشه را یک‌جا تغییر دهید. برای هر فیلد سه حالت افزودن / جایگزینی / حذف دارید به‌علاوهٔ «فقط اگر خالی است»، «جست‌وجو و جایگزینی» (با regex) و پیشوند/پسوند.

• الگوهای متنی: {product_name} - تصویر {n|03}، {filename|title}، {folder}، {product_sku}، {site_name}، {width}×{height} … مثلاً alt همهٔ تصاویر گالری محصولات را از نام محصول بسازید.

• پیش‌نمایش قبل/بعد روی چند فایل اول، اجرا با نوار پیشرفت یا در پس‌زمینه، و بازگردانی کامل هر عملیات از تاریخچهٔ کارها.

• اقدام‌های گروهی: انتقال به پوشه، دانلود zip، بازسازی اندازه‌ها، تبدیل به WebP، حذف با بررسی «کجا استفاده شده» (فایل‌های در حال استفاده رد می‌شوند مگر با تأیید)، ارسال به ابر / برگرداندن، اعمال / حذف واترمارک.

• تغییر نام فیزیکی فایل‌ها (اختیاری، پیش‌فرض خاموش): با تأیید دو مرحله‌ای، بازنویسی ارجاع‌ها در نوشته‌ها و محصولات و قابل بازگشت.

پنل ویرایش گروهی: برای هر فیلد حالت جداگانه، متغیرهای الگو و پیش‌نمایش قبل/بعد.

واترمارک تصویری و متنی فارسی، برگشت‌پذیر

• پروفایل‌های واترمارک: لوگو یا متن (فارسی و لاتین)، شبکهٔ ۳×۳ با آفست، اندازه نسبت به عرض تصویر، شفافیت، چرخش، حالت تکرار (ضدکپی)، حداقل عرض، فقط فرمت‌های انتخابی.

• متن فارسی درست با شکل‌دهی حروف داخل خود افزونه و فونت وزیرمتن؛ بدون نیاز به کتابخانهٔ اضافه. GD یا Imagick.

• قوانین خودکار هنگام آپلود: بر اساس پوشه، نوع پست (فقط محصولات)، دستهٔ محصول، نقش کاربر یا پسوند؛ اندازه‌های انتخابی (مثلاً full و woocommerce_single، هرگز thumbnail).

• نگه‌داری نسخهٔ اصلی در پوشهٔ محافظت‌شده: واترمارک را بردارید یا با پروفایل دیگری دوباره بزنید، بدون افت کیفیت. پیش‌نمایش زنده روی تصویر واقعی.

ساخت پروفایل واترمارک با پیش‌نمایش زنده؛ قوانین خودکار با یک خط تنظیم می‌شوند.

ذخیره‌سازی ابری: ابر آروان، لیارا، پارس‌پک و هر مقصد S3 یا FTP

نگاربان با الگوی «کپی و بازنویسی URL» کار می‌کند: فایل مثل همیشه روی هاست ذخیره می‌شود، در صف به مقصد می‌رود و آدرس‌ها هنگام نمایش بازنویسی می‌شوند (شامل srcset، داده‌های مودال رسانه و محتوای نوشته‌ها). دیتابیس همیشه آدرس محلی را نگه می‌دارد؛ غیرفعال کردن افزونه سایت را نمی‌شکند.

• سه سرویس ایرانی با endpoint رسمی: ابر آروان (منطقه‌های سیمین و شهریار)، لیارا (storage.c2.liara.site) و پارس‌پک (endpoint اختصاصی پنل)، به‌علاوه Amazon S3، Cloudflare R2، DigitalOcean Spaces و MinIO. برای هر preset راهنمای فارسی گرفتن Access Key و ساخت bucket داخل پنل است.

• کلاینت S3 سبک با امضای SigV4 (آپلود چندبخشی برای فایل‌های بزرگ، URL امضاشده، حذف گروهی) که با همهٔ سرویس‌های S3-compatible کار می‌کند؛ بدون AWS SDK.

• هاست دانلود با FTP/FTPS یا SFTP: مثلاً فقط ویدیوها و فایل‌های بزرگ‌تر از ۲۰ مگابایت به dl.example.com بروند.

• سیاست نسخهٔ محلی: نگه‌داشتن همه‌چیز، پاک‌سازی هوشمند (حذف اندازه‌های تولیدشده و نگه‌داشتن اصل) یا مهاجرت کامل با دانلود خودکار هنگام نیاز (ویرایش تصویر، بازسازی اندازه‌ها).

• حذف همگام از ابر، نسخه در مسیر برای شکستن کش CDN، هدر Cache-Control و Content-Disposition درست، فایل‌های خصوصی با URL امضاشده (فایل‌های دانلودی ووکامرس)، تست اتصال قبل از ذخیره، «ارسال رسانه‌های موجود» با نوار پیشرفت.

• امنیت اعتبارنامه‌ها: اولویت با ثابت‌های wp-config.php (NEGARBAN_S3_ACCESS_KEY / NEGARBAN_S3_SECRET_KEY)؛ در غیر این صورت رمزنگاری با libsodium یا AES-256-GCM. هیچ کلیدی به جاوااسکریپت نمی‌رسد.

تب ذخیره‌سازی: انتخاب preset، راهنمای همان سرویس، تست اتصال هفت‌مرحله‌ای، پیش‌نمایش URL نهایی و وضعیت offload.

پشتیبان‌گیری افزایشی رسانه

• بکاپ تخصصی رسانه (فایل‌ها، رکوردهای attachment و متادیتا، برچسب‌ها و جدول‌های افزونه)؛ رقیب UpdraftPlus نیست، مکمل آن است.

• زمان‌بندی روزانه/هفتگی/ماهانه در ساعت دلخواه، نگه‌داری N نسخه، افزایشی (فقط فایل‌های تغییرکرده)، آرشیوهای تکه‌تکهٔ مثلاً ۲۰۰ مگابایتی برای هاست اشتراکی.

• مقصد: پوشهٔ محافظت‌شدهٔ محلی یا همان مقصد ابری تنظیم‌شده. zip خالص PHP؛ حتی بدون افزونهٔ zip روی سرور.

• بازیابی انتخابی یک فایل یا یک پوشه با حالت dry-run و گزارش تفاوت، اعلان ایمیل و وب‌هوک در صورت خطا.

تب پشتیبان‌گیری: زمان‌بندی، مقصد، نگه‌داری نسخه‌ها و فهرست بکاپ‌ها با بازیابی و dry-run.

پنل تنظیمات و کارهای پس‌زمینه

• نُه تب: عمومی، پوشه‌ها، فیلترها، ویرایش گروهی، واترمارک، ذخیره‌سازی، پشتیبان‌گیری، دسترسی‌ها و ابزارها. هر ماژول با یک کلید روشن/خاموش می‌شود.

• کارهای پس‌زمینه با Action Scheduler (اگر ووکامرس دارید) یا WP-Cron؛ هر کار قابل توقف، تکرار و بازگردانی است و تاریخچه و خطاهایش را می‌بینید.

• دسترسی‌ها: ماتریس نقش × قابلیت (مدیریت پوشه‌ها، ویرایش گروهی، ذخیره‌سازی/واترمارک، بکاپ، تنظیمات).

• سلامت سیستم: نشان می‌دهد GD/Imagick، WebP/AVIF، FTP، ssh2، zlib، فونت فارسی و رمزنگاری روی سرور شما هست یا نه.

• Import/Export تنظیمات و درخت پوشه‌ها به JSON، حذف داده‌ها هنگام حذف افزونه فقط با انتخاب شما.

تب عمومی: آمار کتابخانه، ایندکس رسانه با بازسازی یک‌کلیکی و فهرست کارهای پس‌زمینه.

ابزارها و سلامت سیستم: پیش از فعال کردن واترمارک یا SFTP می‌بینید سرور چه چیزی دارد.

برای توسعه‌دهندگان

• PHP 8.1 تا 8.5 با strict types، PSR-4، بدون وابستگی Composer در زمان اجرا، مطابق WordPress Coding Standards.

• REST API با namespace negarban/v1 (پوشه‌ها، انتقال، فیلترها، کارها، ویرایش گروهی، ذخیره‌سازی، واترمارک، بکاپ) با nonce و بررسی capability روی هر endpoint.

• WP-CLI: wp negarban index rebuild، wp negarban folders create "محصولات/کفش"، wp negarban bulk --folder=12 --ops=…، wp negarban offload --all، wp negarban watermark apply، wp negarban backup run.

• بیش از ۱۵ فیلتر و ۱۵ اکشن با پیشوند negarban_: نوع کار سفارشی، آداپتور ذخیره‌سازی سفارشی، preset جدید، متغیر الگوی جدید، قوانین واترمارک سفارشی، کلید شیء و URL نهایی. مستندات HOOKS.md، STORAGE.md و WATERMARK.md همراه افزونه.

• تست‌های واحد قابل اجرا با PHP خالص: بردارهای رسمی امضای SigV4 آمازون، سرور S3 شبیه‌سازی‌شده، نوشتن/خواندن zip و شکل‌دهی حروف فارسی.

مقایسه با افزونه‌های محبوب

«دارد» یعنی در خود افزونه، «پولی» یعنی فقط در نسخه/افزودنی پرمیوم، «محدود» یعنی ناقص یا نیازمند سرویس خارجی.

مشخصات فنی

نصب و شروع در پنج دقیقه

1. فایل افزونه را از وردپرس کالا دریافت و از مسیر افزونه‌ها › افزودن › بارگذاری نصب و فعال کنید. ایندکس رسانه در پس‌زمینه ساخته می‌شود.

2. به رسانه › کتابخانه بروید: درخت پوشه‌ها کنار گرید است. با «+ پوشهٔ جدید» ساختار بسازید و فایل‌ها را با کشیدن منتقل کنید.

3. روی «فیلترها» کلیک کنید، مثلاً «تصاویر بدون alt» را بزنید، «انتخاب دسته‌جمعی» و سپس «ویرایش گروهی» را باز کنید و alt را با الگوی {product_name} پر کنید.

4. در رسانه › نگاربان › عمومی ماژول‌های واترمارک، ذخیره‌سازی و پشتیبان‌گیری را روشن کنید.

5. در تب ذخیره‌سازی سرویس خود (مثلاً ابر آروان) را انتخاب کنید، bucket و کلیدها را وارد کنید، «تست اتصال» و بعد «ارسال رسانه‌های موجود» را بزنید.

6. در تب پشتیبان‌گیری زمان‌بندی را تنظیم کنید و یک «بکاپ کامل» بگیرید.

پشتیبانی و به‌روزرسانی

هر لایسنس شامل یک سال به‌روزرسانی و پشتیبانی برای یک سایت است. تمدید اختیاری است و افزونه بعد از پایان لایسنس هم کار می‌کند؛ فقط به‌روزرسانی‌های جدید و پشتیبانی متوقف می‌شود. مستندات فارسی داخل پنل و فایل‌های همراه افزونه بیشتر پرسش‌ها را پاسخ می‌دهد.