توضیحات
افزونه Storage for EDD via OneDrive یک افزونه قدرتمند برای Easy Digital Downloads است که به شما امکان میدهد محصولات دیجیتال خود را با استفاده از فضای ابری Microsoft OneDrive ذخیره و ارائه کنید. این افزونه یکپارچگی روانی با Microsoft Graph API فراهم میکند و از احراز هویت OAuth2 و لینکهای دانلود موقت و امن پشتیبانی میکند.
ویژگیهای اصلی
- یکپارچگی با OneDrive: ذخیره امن محصولات دیجیتال شما در Microsoft OneDrive
- احراز هویت OAuth2: اتصال امن و آسان به حساب Microsoft شما
- لینکهای دانلود موقت: تولید آدرسهای دانلود موقت و امن از طریق @microsoft.graph.downloadUrl
- مدیریت آسان فایل: بارگذاری مستقیم فایلها در فضای ذخیرهسازی OneDrive از طریق بخش مدیریت وردپرس
- یکپارچهسازی با کتابخانه رسانه: مرور و انتخاب فایلها از فضای ذخیرهسازی OneDrive خود در داخل وردپرس
- پشتیبانی از پوشهها: جابهجایی و سازماندهی فایلها در پوشهها
- امنیت در اولویت: ساخته شده با رعایت بهترین روشهای امنیتی وردپرس
- مناسب برای توسعهدهندگان: کدی تمیز و مستند با هوکها و فیلترهای قابل استفاده
پیکربندی
- یک برنامه در Azure App Registrations ثبت کنید.
- مجوزهای API را برای Microsoft Graph اضافه کنید (Files.Read، Files.ReadWrite، User.Read، offline_access)
- URI بازگشت OAuth را به:
https://your-site.com/odse-oauth-callback/تنظیم کنید. - یک Client Secret ایجاد کنید و مقدار آن را کپی کنید.
- به مسیر Downloads > Settings > Extensions > OneDrive Storage بروید.
- مقادیر Client ID و Client Secret خود را وارد کنید
- تنظیمات را ذخیره کنید، سپس روی اتصال به OneDrive کلیک کنید.
نحوهی استفاده
مرور و انتخاب فایلها
- هنگام ایجاد یا ویرایش یک دانلود در Easy Digital Downloads
- روی دکمه “انتخاب از OneDrive” که در کنار فیلد فایل URL قرار دارد، کلیک کنید.
- با استفاده از ناوبری پوشهها، فضای ذخیرهسازی OneDrive خود را مرور کنید.
- از نوار مسیریاب (breadcrumb) برای رفتن سریع به پوشههای والد استفاده کنید.
- از کادر جستوجوی موجود در هدر برای فیلتر کردن فایلها بر اساس نام استفاده کنید.
- برای استفاده از یک فایل موجود برای دانلود خود، روی «انتخاب» کلیک کنید.
آپلود فایلهای جدید
- در مرور OneDrive، روی دکمه “آپلود” در ردیف هدر کلیک کنید.
- فرم آپلود در بالای فهرست فایلها نمایش داده میشود.
- فایل خود را انتخاب کنید و روی «آپلود» کلیک کنید.
- پس از آپلود موفق، نشانی فایل بهصورت خودکار با پیشوند OneDrive تنظیم میشود.
- دوباره روی دکمه کلیک کنید تا فرم آپلود مخفی شود.
سرویسهای خارجی
این افزونه به API Microsoft Graph API (OneDrive) متصل میشود تا فایلها را مدیریت کند، لینکهای دانلود ایجاد کند و احراز هویت را انجام دهد.
این افزونه توکنهای احراز هویت لازم و درخواستهای مربوط به فایل را به سرورهای Microsoft ارسال میکند. این کار زمانی انجام میشود که شما فایلهای OneDrive خود را در داشبورد مرور میکنید، فایلها را آپلود میکنید یا زمانی که یک مشتری فایلی را دانلود میکند.
- سرویس: Microsoft Graph API (OneDrive)
- مورد استفاده: احراز هویت، مرور فایلها، آپلود و ایجاد لینکهای دانلود.
- دادههای ارسالشده: توکنهای OAuth، فراداده فایل، محتوای فایل (در زمان بارگذاری).
- نشانیها:
https://graph.microsoft.com(فراخوانیهای API)https://login.microsoftonline.com(احراز هویت)
- حقوقی: شرایط استفاده، سیاست حفظ حریم خصوصی
پشیتبانی
برای دریافت پشتیبانی و گزارش باگها، لطفا از انجمن پشتیبانی افزونه در WordPress.org استفاده کنید.
اگر این افزونه را مفید میدانید، لطفا نوشتن یک نقد و بررسی در WordPress.org را در نظر داشته باشید.
سایر ارائه دهندگان ذخیره سازی
به دنبال یک ارائه دهنده فضای ذخیره سازی متفاوت هستید؟ افزونه های دیگر ما را بررسی کنید:
- فضای ذخیرهسازی Box برای EDD – از Box برای ذخیرهسازی محصولات دیجیتال خود استفاده کنید.
- فضای ذخیرهسازی Dropbox برای EDD – از Dropbox برای ذخیرهسازی محصولات دیجیتال خود استفاده کنید.
- فضای ذخیرهسازی سازگار با S3 برای EDD – استفاده از سرویسهای سازگار با S3 مانند MinIO، DigitalOcean Spaces، Linode، Wasabi و موارد دیگر
سیاست حریم خصوصی
این افزونه برای ذخیرهسازی و دریافت فایلها به مجوز دسترسی به حساب Microsoft OneDrive شما نیاز دارد. این افزونه هیچگونه داده شخصیای فراتر از توکنهای OAuth لازم برای حفظ اتصال جمعآوری یا ذخیره نمیکند. تمام فرآیند ذخیرهسازی و ارائه فایلها از طریق زیرساخت امن Microsoft انجام میشود.
عکسهای صفحه
نصب
- فایلهای افزونه را در مسیر `
/wp-content/plugins/storage-for-edd-via-onedrive` آپلود کنید، یا افزونه را مستقیما از طریق صفحه افزونههای وردپرس نصب نمایید. - اطمینان حاصل کنید که افزونه Easy Digital Downloads نصب و فعال شده است.
- اگر افزونه را از سورس نصب میکنید، در پوشه افزونه دستور `
composer install` را اجرا کنید (این مرحله برای نسخههای منتشر شده لازم نیست). - افزونه را از طریق صفحه «افزونهها» در وردپرس فعال کنید.
- به مسیر Downloads > Settings > Extensions > OneDrive Storage بروید تا افزونه را پیکربندی کنید.
سوالات متداول
-
لینکهای دانلود چقدر امن هستند؟
-
این افزونه از
@microsoft.graph.downloadUrlدر Microsoft Graph API استفاده میکند که لینکهای دانلود موقتی و از پیش احراز هویتشده ارائه میدهد. این لینکها بهصورت آنی و هنگام خرید محصول توسط مشتری ایجاد میشوند. -
چه نوع فایلهایی برای بارگذاری پشتیبانی میشوند؟
-
افزونه از انواع فایلهای ایمن پشتیبانی میکند، شامل:
* آرشیوها: 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انواع فایلهای خطرناک (مانند فایلهای اجرایی و اسکریپتها) بهطور خودکار برای حفظ امنیت مسدود میشوند.
-
آیا میتوانم پیشوند URL را برای فایلهای OneDrive سفارشیسازی کنم؟
-
بله، توسعهدهندگان میتوانند پیشوند URL را با استفاده از فیلتر
odse_url_prefixسفارشیسازی کنند. این کد را به فایل functions.php تم خود اضافه کنید:function customize_onedrive_url_prefix($prefix) { return 'edd-myprefix://'; // Change to your preferred prefix } add_filter('odse_url_prefix', 'customize_onedrive_url_prefix'); -
آیا میتوانم نوعهای فایل مجاز (MIME types) را سفارشیسازی کنم؟
-
بله، توسعهدهندگان میتوانند نوعهای MIME مجاز را با استفاده از فیلتر
dbxe_allowed_mime_typesسفارشیسازی کنند.
نقد و بررسیها
توسعه دهندگان و همکاران
“فضای ذخیرهسازی OneDrive برای EDD” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگان
“فضای ذخیرهسازی OneDrive برای EDD” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمکهایشان.
ترجمه “فضای ذخیرهسازی OneDrive برای EDD” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.2.0
- Matched the loading skeleton search placeholder to the live search field.
- Rebuilt the OneDrive file browser with the new shadcn-style interface.
- Improved upload feedback, keyboard focus states, and scrollbar stability.
1.1.1
- Updated: Internal vendor dependencies.
1.1.0
- Major Refactor: Replaced legacy iframe browser with modern AJAX implementation for improved performance.
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 OneDrive browser modal.
1.0.4
- Use wp_enqueue commands: Replaced inline and in includes/class-media-library.php (admin media library)
1.0.3
- Added: New “Browse” button next to file inputs for easier file selection.
- Improved: Modernized file browser UI with a dedicated modal window.
- Improved: File browser is now context-aware, opening directly to the selected file’s folder.
- Improved: Browse button is automatically hidden if the plugin is not configured.
- Improved: Removed legacy “OneDrive Library” tab from the standard WordPress media uploader for a cleaner interface.
1.0.2
- Added: Native search input type with clear (“X”) icon support for a cleaner UI.
- Improved: Mobile breadcrumb navigation with path wrapping for long directory names.
- Improved: Reduced separator spacing in breadcrumbs on mobile devices.
- Improved: Media library table styling for more consistent file and folder display.
- Improved: Redesigned folder rows with better icons and refined hover effects.
- Improved: Enhanced mobile responsiveness for the file browser table.
- Fixed: Corrected file name and path display order in the media library.
- Improved: Standardized header row spacing and title font sizes for UI consistency.
- Improved: Enhanced notice detail styling for better error/success message readability.
- Improved: More robust handling of file lists with additional data validation.
- Security: Standardized use of wp_json_encode() for client-side data.
- Improved: Unified root folder label as “Home” across all breadcrumb states for consistent navigation.
1.0.1
- Added: Breadcrumb navigation in file browser – click any folder in the path to navigate directly.
- Improved: Integrated search functionality directly into the breadcrumb navigation bar for a cleaner UI.
- Improved: Better navigation experience without needing the Back button.
- Improved: Enhanced styling for search inputs and buttons, including compact padding.
- Fixed: RTL layout issues for breadcrumbs and navigation buttons.
- Cleaned: Removed legacy CSS and unused search container elements.
1.0.0
- Initial release
- Microsoft Graph API OAuth2 integration
- Temporary download link generation via @microsoft.graph.downloadUrl
- Media library integration
- File upload functionality
- Admin settings interface
- Security enhancements and validation
- Internationalization support