Elinweb Lightweight Player for Aparat

Description

الین‌وب: آپارات بهینه شده امکان نمایش ویدئوهای آپارات را با کاهش بارگذاری اولیهٔ پلیر در وب‌سایت فراهم می‌کند. در ابتدا، پوستر و یک آیکون پخش دایره‌ای نمایش داده می‌شود و دریافت و پخش ویدئو پس از کلیک کاربر آغاز می‌شود.

با واردکردن نشانی ویدئو در بلوک گوتنبرگ یا ویجت المنتور، افزونه پوستر را آماده کرده و در کتابخانهٔ رسانهٔ وردپرس ذخیره می‌کند. استفاده از شورت‌کد و توابع PHP نیز امکان‌پذیر است.

لینک باید به یکی از این دو شکل باشد:

• https://www.aparat.com/embed/ytf50k5 — قالب جدیدتر و پیشنهادی
• https://www.aparat.com/v/ytf50k5

عبارت ytf50k5 را با شناسهٔ ویدئوی موردنظر جایگزین کنید.

امکانات افزونه

• پلیر سبک مرورگر با پخش از اولین کلیک؛ بدون بارگذاری iframe و اسکریپت پلیر آپارات در حالت پیش‌فرض.
• دریافت و ذخیرهٔ پوستر در رسانه‌های وردپرس و تبدیل به WebP، در صورت پشتیبانی سرور.
• بلوک گوتنبرگ، ویجت المنتور، شورت‌کد و امکان نمایش با کد PHP.
• تنظیم پوستر دلخواه، نسبت تصویر، زمان شروع و پخش اولیهٔ بی‌صدا.
• اولویت بارگذاری پوستر برای ویدئوهای بالای صفحه.
• امکان انتخاب پلیر رسمی آپارات، با بارگذاری بعد از کلیک.
• استثناهای لازم برای Delay JavaScript در WP Rocket و Perfmatters.
• رابط فارسی و کنترل‌های قابل استفاده با کیبورد.

جدید در نسخهٔ ۲.۱.۰: فصل‌بندی ویدئو

برای بخش‌های مختلف ویدئو، عنوان و زمان شروع تعریف کنید. با انتخاب هر فصل، پخش از زمان مشخص‌شده آغاز می‌شود. در صورت فعال‌بودن پلیر، همان پلیر به زمان انتخاب‌شده منتقل می‌شود.

در فیلد «فصل‌های ویدئو» در گوتنبرگ یا المنتور، اطلاعات هر فصل را در یک خط وارد کنید:

00:05 > سلام و احوال‌پرسی
00:40 > نصب برنامه
01:20 > تنظیمات اولیه

زمان شروع به ثانیه، دقیقه:ثانیه یا ساعت:دقیقه:ثانیه قابل ثبت است. اعداد فارسی و عربی نیز پشتیبانی می‌شوند. فصل‌ها بر اساس زمان مرتب می‌شوند و حداکثر ۱۰۰ فصل قابل نمایش است. فیلد فصل‌ها در المنتور از Dynamic Tags نیز پشتیبانی می‌کند.

فصل‌بندی در گوتنبرگ، المنتور، شورت‌کد و PHP در دسترس است. این قابلیت برای پلیر مرورگر ارائه شده است؛ در حالت پلیر رسمی آپارات، فهرست فصل‌ها نمایش داده نمی‌شود. عنوان و زمان فصل‌ها به‌صورت دستی ثبت می‌شوند و استخراج خودکار آن‌ها از محتوای ویدئو در این نسخه ارائه نشده است.

جدید در نسخهٔ ۲.۱.۰: استفاده در قالب و کد PHP

برای نمایش ویدئو در قالب یا صفحاتی که با کد ساخته شده‌اند، نیازی به شورت‌کد یا صفحه‌ساز نیست:

do_action('lwpa_display', 'https://www.aparat.com/embed/ytf50k5');

تابع lwpa_display() خروجی را چاپ می‌کند و lwpa_render() رشتهٔ HTML را برمی‌گرداند. فیلترهای lwpa_render_args و lwpa_render_html نیز برای سفارشی‌سازی تنظیمات و خروجی در دسترس هستند. اجرای wp_head() و wp_footer() در قالب ضروری است.

نمونه‌های کامل در فایل docs/developer-guide-fa.md و گیت‌هاب افزونه قرار دارند.

آماده‌سازی پوستر هنگام ویرایش، ذخیره یا در پس‌زمینه انجام می‌شود؛ رندر عمومی صفحه برای دریافت اطلاعات ویدئو منتظر پاسخ آپارات نمی‌ماند. پخش ویدئو به دسترسی سرور و مرورگر به API و CDN آپارات وابسته است.

این افزونه مستقل است و وابستگی رسمی به آپارات یا المنتور ندارد.
نویسنده: Iman Shadmehri — الین‌وب

External services

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

هنگام ویرایش، ذخیره، آماده‌سازی پوستر در پس‌زمینه یا درخواست پخش، سرور شناسهٔ ویدئو را به https://www.aparat.com/etc/api/video/videohash/{identifier} می‌فرستد. آپارات IP سرور و اطلاعات معمول درخواست HTTP را دریافت می‌کند. پوستر از میزبان‌های معتبر آپارات دانلود و در سایت ذخیره می‌شود.

پس از کلیک روی پخش، مرورگر بازدیدکننده فایل ویدئو را از CDN آپارات دریافت می‌کند؛ این سرویس IP بازدیدکننده و اطلاعات معمول درخواست مرورگر را دریافت می‌کند. نشانی فایل ویدئو فقط برای مدت کوتاهی در سرور کش می‌شود و در HTML مقاله ذخیره نمی‌شود. در حالت پلیر رسمی، iframe آپارات پس از کلیک بارگذاری می‌شود و درخواست‌ها، کوکی‌ها و آمار آن تحت کنترل آپارات است.

به حساب آپارات یا کلید API نیاز نیست. افزونه اطلاعات ورود وردپرس یا محتوای خصوصی مقاله‌ها را ارسال نمی‌کند و ابزار جمع‌آوری آمار اختصاصی ندارد.

• قوانین آپارات
• پشتیبانی آپارات