توضیحات
افزونه Storage for WooCommerce via S3-Compatible یک افزونه قدرتمند برای ووکامرس است که به شما امکان میدهد محصولات دیجیتال خود را با استفاده از Amazon S3 یا هر سرویس ذخیرهسازی سازگار با S3 ذخیره و ارائه کنید. این افزونه با APIهای S3 یکپارچگی روانی فراهم میکند و از لینکهای امضاشده با زمان انقضای قابل تنظیم پشتیبانی میکند.
ویژگیهای اصلی
- یکپارچگی سازگار با S3: ذخیره محصولات دیجیتال شما در Amazon S3، Wasabi، MinIO، DigitalOcean Spaces، Backblaze B2 و موارد دیگ
- لینکهای دانلود امضاشده: تولید نشانیهای URL امنِ امضاشده با زمان انقضای قابل تنظیم (۱ تا ۶۰ دقیقه)
- مدیریت آسان فایل: بارگذاری مستقیم فایلها در فضای ذخیرهسازی S3 از طریق بخش مدیریت وردپرس
- یکپارچهسازی با کتابخانه رسانه: مرور و انتخاب فایلها از فضای ذخیرهسازی S3 خود در داخل وردپرس
- پشتیبانی از پوشهها: جابهجایی و سازماندهی فایلها در پوشهها
- امنیت در اولویت: ساخته شده با رعایت بهترین روشهای امنیتی وردپرس
- مناسب برای توسعهدهندگان: کدی تمیز و مستند با هوکها و فیلترهای قابل استفاده
پیکربندی
- به مسیر ووکامرس > تنظیمات > S3-Compatible بروید
- اطلاعات S3 خود را وارد کنید:
- کلید دسترسی
- کلید خصوصی
- آدرس URL نقطه پایانی (مانند https://s3.example.com)
- منطقه سفارشی (اختیاری، برای مشخص کردن یک منطقه سفارشی مانند
eu-west-3برای باکت های AWS S3 یا سرویس دهنده های خاص سازگار با S3، تیک بزنید) - نام باکت
- زمان انقضای لینک را تنظیم کنید (۱ تا ۶۰ دقیقه)
- تنظیمات را ذخیره کنید
نحوهی استفاده
مرور و انتخاب فایلها
- هنگام ایجاد یا ویرایش یک محصول قابل دانلود در ووکامرس
- روی دکمه “انتخاب از S3” که در کنار فیلد فایل URL قرار دارد، کلیک کنید.
- ذخیرهسازی S3 خود را با استفاده از ناوبری پوشهها مرور کنید.
- از نوار مسیریاب (breadcrumb) برای رفتن سریع به پوشههای والد استفاده کنید.
- از کادر جستوجوی سربرگ برای فیلتر کردن فایلها بر اساس نام استفاده کنید.
- برای استفاده از یک فایل موجود برای دانلود خود، روی «انتخاب» کلیک کنید.
آپلود فایلهای جدید
- در مرور S3، روی دکمه “آپلود” در ردیف هدر کلیک کنید.
- فرم آپلود در بالای فهرست فایلها نمایش داده میشود.
- فایل خود را انتخاب کنید و روی «آپلود» کلیک کنید.
- پس از آپلود موفق، نشانی فایل (URL) بهصورت خودکار با پیشوند S3 تنظیم میشود.
- دوباره روی دکمه کلیک کنید تا فرم آپلود مخفی شود.
سرویسهای خارجی
این افزونه برای مدیریت فایلها و ایجاد لینکهای دانلود به APIهای ذخیرهسازی سازگار با S3 متصل میشود.
این افزونه اطلاعات احراز هویت لازم و درخواستهای مربوط به فایل را به اندپوینت S3 پیکربندیشده شما ارسال میکند. این فرآیند زمانی انجام میشود که در داشبورد سطل S3 خود را مرور میکنید، فایل آپلود میکنید یا زمانی که مشتری فایلی را دانلود میکند.
- سرویس: API ذخیرهسازی سازگار با S3
- موارد استفاده: مرور فایلها، آپلود و ایجاد لینکهای دانلود امضاشده.
- دادههای ارسالی: اطلاعات احراز هویت API، فراداده فایل، محتوای فایل (در زمان آپلود).
- نشانیهای URL: بسته به اندپوینت پیکربندیشده شما:
- Amazon S3:
https://s3.amazonaws.com - Wasabi:
https://s3.wasabisys.com - MinIO: آدرس endpoint سرور شما
- Amazon S3:
- حقوقی: به شرایط استفاده و سیاست حفظ حریم خصوصی ارائهدهنده فضای ذخیرهسازی خود مراجعه کنید
پشیتبانی
برای دریافت پشتیبانی و گزارش باگها، لطفا از انجمن پشتیبانی افزونه در WordPress.org استفاده کنید.
اگر این افزونه را مفید میدانید، لطفا نوشتن یک نقد و بررسی در WordPress.org را در نظر داشته باشید.
سایر ارائه دهندگان ذخیره سازی
به دنبال یک ارائه دهنده فضای ذخیره سازی متفاوت هستید؟ افزونه های دیگر ما را بررسی کنید:
- ذخیرهسازی برای ووکامرس از طریق دراپباکس – استفاده از دراپباکس برای ذخیرهسازی محصولات دیجیتال
سیاست حریم خصوصی
این افزونه برای دسترسی به فضای ذخیرهسازی شما و مدیریت فایلها به اطلاعات احراز هویت API مربوط به S3 نیاز دارد. این افزونه هیچگونه داده شخصیای فراتر از اطلاعات API لازم برای حفظ اتصال جمعآوری یا ذخیره نمیکند. تمام فرآیند ذخیرهسازی و ارائه فایلها از طریق زیرساخت امن اندپوینت S3 پیکربندیشده شما انجام میشود.
عکسهای صفحه
نصب
- فایلهای افزونه را در مسیر `
/wp-content/plugins/storage-for-woo-via-s3-compatible` آپلود کنید، یا افزونه را مستقیماً از طریق صفحه افزونههای وردپرس نصب نمایید. - اطمینان حاصل کنید که افزونه ووکامرس نصب شده و فعال است.
- اگر افزونه را از سورس نصب میکنید، در پوشه افزونه دستور `
composer install` را اجرا کنید (این مرحله برای نسخههای منتشر شده لازم نیست). - افزونه را از طریق صفحه «افزونهها» در وردپرس فعال کنید.
- برای پیکربندی افزونه به مسیر ووکامرس > تنظیمات > S3-Compatible بروید.
سوالات متداول
-
لینکهای دانلود چقدر امن هستند؟
-
این افزونه لینکهای امضاشدهای تولید میکند که فقط برای مدت زمان تنظیمشده (۱ تا ۶۰ دقیقه) معتبر هستند. این لینکها هنگام شروع دانلود توسط مشتری و بهصورت درخواستی ایجاد میشوند تا هر جلسه دانلود یک لینک جدید با اعتبار زمانی محدود دریافت کند.
-
آیا میتوانم زمان انقضای لینک را سفارشیسازی کنم؟
-
بله! برخلاف برخی سرویسهای ذخیرهسازی ابری دیگر، S3 به شما اجازه میدهد زمان انقضای لینک را تنظیم کنید. به مسیر ووکامرس > تنظیمات > ذخیرهسازی S3 بروید و مدت زمان دلخواه خود را (1 تا 60 دقیقه) تعیین کنید.
-
چه نوع فایلهایی برای بارگذاری پشتیبانی میشوند؟
-
افزونه از انواع فایلهای ایمن پشتیبانی میکند، شامل:
* آرشیوها: ZIP، RAR، 7Z، TAR، GZ
* اسناد: PDF، DOC، DOCX، TXT، RTF، XLS، XLSX، CSV، PPT، PPTX
* تصاویر: JPG، JPEG، PNG، GIF، WEBP، SVG
* صوتی: MP3، WAV، OGG، FLAC، M4A
* ویدئو: MP4، AVI، MOV، WMV، FLV، WEBM
* کتابهای الکترونیکی: EPUB، MOBI، AZW، AZW3
* فایلهای وب: CSS، JS، JSON، XMLانواع فایلهای خطرناک (مانند فایلهای اجرایی و اسکریپتها) بهطور خودکار برای حفظ امنیت مسدود میشوند.
-
کدام ارائهدهندگان S3 پشتیبانی میشوند؟
-
هر سرویس ذخیرهسازی سازگار با S3 کار میکند، از جمله:
* Amazon S3
* DigitalOcean Spaces
* Linode Object Storage
* Wasabi
* Backblaze B2 (با API سازگار با S3)
* Cloudflare R2
* MinIO
* Storj
* ArvanCloud
* Hetzner Object Storage
* و بسیاری دیگر -
آیا میتوانم پیشوند URL را برای فایلهای S3 سفارشیسازی کنم؟
-
بله، توسعهدهندگان میتوانند پیشوند URL را با استفاده از فیلتر
wcs3_url_prefixسفارشیسازی کنند. این کد را به فایل functions.php تم خود اضافه کنید:function customize_s3_url_prefix($prefix) { return 'wc-myprefix://'; // Change to your preferred prefix } add_filter('wcs3_url_prefix', 'customize_s3_url_prefix'); -
آیا میتوانم نوعهای فایل مجاز (MIME types) را سفارشیسازی کنم؟
-
بله، توسعهدهندگان میتوانند نوعهای MIME مجاز را با استفاده از فیلتر
wcs3_allowed_mime_typesسفارشیسازی کنند.
نقد و بررسیها
توسعه دهندگان و همکاران
“فضای ذخیرهسازی سازگار با S3 برای ووکامرس” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگان
“فضای ذخیرهسازی سازگار با S3 برای ووکامرس” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمکهایشان.
ترجمه “فضای ذخیرهسازی سازگار با S3 برای ووکامرس” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.2.1
- Fixed: Selecting a file from the S3 browser sometimes did not insert it into the WooCommerce downloadable file fields.
- Improved: More reliable detection of the target file row and its inputs across WooCommerce versions.
- Added: Clear error message instead of the modal closing silently on failure.
1.2.0
- Matched the loading skeleton search placeholder to the live search field.
- Rebuilt the file browser modal with the new shadcn-style interface.
- Improved upload feedback, keyboard focus states, and scrollbar stability.
1.1.2
- Fixed: Custom URL protocol corruption on first product save caused by early WordPress protocol caching (covers default
wc-s3cs://and custom prefixes). - Updated: Internal vendor dependencies.
1.1.1
- Added: Custom Region configuration setting to manually define S3 regions for AWS S3 and custom S3 endpoints, ensuring accurate Signature V4 signing and bucket listings.
- Tested: Fully compatible with WordPress 7.0.
1.1.0
- Major Refactor: Replaced legacy iframe browser with modern AJAX implementation for improved performance.
- Fixed: Critical issue where S3 uploads were considered successful despite 4xx/5xx HTTP errors.
- Fixed: Signature mismatch in download presigned URLs for files with special characters or spaces.
- Added: Strict pre-upload file validation (hash, size, and stream) for enhanced reliability.
- Security: Sanitized
response-content-dispositionheader in download links to prevent header injection.
1.0.5
- Improved: UI styles and enhanced layout consistency for better harmony.
- Improved: Comprehensive code improvements and stability optimizations.
- Added: Skeleton loader with shimmer animation for better UX while loading S3 browser modal.
1.0.4
- Improved WordPress coding standards compliance
1.0.3
- Added proper PHPCS annotations for nonce verification and input sanitization
1.0.2
- Added force download for files – browser now downloads files instead of opening them inline
1.0.1
- Improved file browser to open directly in the folder of the existing file
- Fixed issue with remembering last folder location
- Use wp_enqueue commands: Replaced inline and in includes/class-media-library.php (admin media library)
1.0.0
- Initial release
- S3-compatible storage integration
- Signed download link generation with configurable expiration
- Media library integration
- File upload functionality
- Admin settings interface
- Security enhancements and validation
- Internationalization support