manifest / media / elin-audio-player

Elin Audio Player

Custom Elementor podcast audio player widget with WaveSurfer waveform, skip controls and playback-speed slider (RTL)

by Elin · github.com/ishadmehri/elin-audio-player

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ishadmehri/elin-audio-player/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/ishadmehri/elin-audio-player ↗

ویجت اختصاصی المنتور برای پخش پادکست و فایل صوتی، با نمایش موج صوتی (waveform) و کنترل سرعت پخش. طراحی RTL و ریسپانسیو.

A custom Elementor widget for podcast/audio playback with a WaveSurfer waveform, skip controls and a playback-speed slider. RTL-first, responsive.

ویژگی‌ها

نمایش موج صوتی با WaveSurfer.js نسخه ۷ (کلیک روی موج = پرش به همان نقطه)
دکمه پخش/توقف با آیکون داینامیک
جلو و عقب رفتن با مقدار قابل تنظیم (پیش‌فرض ۱۵ ثانیه)
نمایش زمان جاری و مدت کل
اسلایدر سرعت پخش با پله‌های 0.5 / 0.75 / 1 / 1.25 / 1.5
رابط کاربری جداگانه برای موبایل (popup تمام‌صفحه) و دسکتاپ
آیکون قابل انتخاب (کتابخانه آیکون یا SVG دلخواه) با کنترل رنگ پس‌زمینه، اندازه، فاصله داخلی و گردی گوشه
تب Style کامل در المنتور: رنگ‌ها، تایپوگرافی، padding و گردی گوشه‌ها
بارگذاری تنبل: فایل صوتی فقط وقتی پلیر به ویوپورت نزدیک می‌شود دانلود می‌شود؛ مدت زمان از هدر فایل خوانده می‌شود
peaks سمت سرور با ffmpeg (اختیاری): موج فوری رسم می‌شود و فایل فقط هنگام پخش دانلود می‌شود؛ بدون ffmpeg به روش عادی کار می‌کند
پشتیبانی از چند پلیر در یک صفحه
سازگار با ویرایشگر زنده المنتور (live preview)
قابل ترجمه (text domain: elin-audio-player)

نصب

پوشه افزونه را در wp-content/plugins/ قرار دهید و از پیشخوان وردپرس فعالش کنید.

cd wp-content/plugins
git clone https://github.com/<user>/elin-audio-player.git

سپس در المنتور، ویجت Elin Audio Player را از دسته General به صفحه بکشید و یک فایل صوتی انتخاب کنید.

نیازمندی‌ها

مورد	حداقل نسخه
WordPress	5.9
PHP	7.4
Elementor	3.5.0

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

ساختار

elin-audio-player.php              بوت‌استرپ، بررسی نیازمندی‌ها، ثبت asset ها
widgets/elin-audio-player-widget.php   کلاس ویجت المنتور (کنترل‌ها + رندر)
assets/js/player.js                منطق پلیر روی WaveSurfer
assets/js/wavesurfer.min.js        کتابخانه WaveSurfer 7.8.4
assets/css/player.css              استایل RTL + ریسپانسیو (بر پایه CSS variables)

رنگ‌ها به‌صورت CSS custom property روی .elin-player تعریف شده‌اند (--elin-accent، --elin-bg، …) و کنترل‌های تب Style همان متغیرها را بازنویسی می‌کنند.

توسعه

بعد از تغییر فایل‌های CSS/JS، ثابت ELIN_AUDIO_VERSION را در فایل اصلی بالا ببرید تا کش مرورگر پاک شود.

لایسنس

GPL-2.0-or-later — همسو با لایسنس وردپرس.