manifest / events / event-seat-manager

event-seat-manager

Open-source WordPress & WooCommerce event ticketing plugin with interactive seat maps, venue layout designer, seat reservations, QR-code tickets, online check-in, ticket sales, attendance reports, REST API, Elementor widgets, and bilingual English/Persian RTL support.

by Shahin Ilderemi · github.com/ildrm/event-seat-manager

★ 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/ildrm/event-seat-manager/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/ildrm/event-seat-manager ↗

event-seat-manager 2.0.0

افزونهٔ دوزبانهٔ وردپرس برای مدیریت رویداد، سالن، چیدمان صندلی، رزرو، بلیت ووکامرس و کنترل ورود آنلاین.

وضعیت تحویل: شمارهٔ بسته 2.0.0 است. آمادگی فروش عملیاتی باید با شواهد وضعیت انتشار ارزیابی شود؛ شمارهٔ نسخه به‌تنهایی تأیید تکمیل پرامپت مبنا نیست.

طراح سالن و رزرو گروهی جدید

طراح نسخهٔ دوم شامل ۵۰ چیدمان پارامتریک، ظرفیت دقیق یا محاسبه‌شده، بخش‌ها و طبقات، میز و جایگاه اختصاصی، قیمت‌گذاری بخش/دسته، نقشه و فهرست مشترک و پیش‌نمایش اختیاری سه‌بعدی است. ظرفیت هندسی و پایگاه داده تا ۱۵۰٬۰۰۰ جایگاه آزموده شده است؛ صندلی تکی و رزرو کامل میز از موجودی مشترک استفاده می‌کنند. بلیت گروهی ورود یک‌باره یا ورود تعدادی دارد.

ساخت جلسه‌های جدید این مدل تا پذیرش محیط مقصد بسته می‌ماند: آزمون محلی ۱۰۰۰ خرید هم‌زمان از نظر موجودی و صدور درست بود، اما هدف زمان پاسخ رزرو و موجودی را نگرفت. جلسه‌ها و بلیت‌های موجود فعال می‌مانند. راهنمای طراح و API نسخهٔ دوم و شواهد بار، وضعیت دقیق را توضیح می‌دهند.

امکانات موجود

مرکز و نقش‌های مدیریتی با کنترل دسترسی مرکز، رویداد و جلسه، سالن و نسخه‌های مستقل چیدمان.
تولید نقشه‌های ۱۵×۶۰ و ۱۸×۵۰، ویرایش دیداری، پیش‌نویس، ذخیرهٔ خودکار، JSON و چاپ چیدمان.
رزرو صندلی با مهلت، تغییر و تمدید محدود، قواعد مجاورت و جلوگیری از بیش‌فروشی با قفل InnoDB؛ ظرفیت بدون صندلی نیز مستقل نگهداری می‌شود.
ثبت سفارش مهمان، بلیت رایگان و پرداخت از صفحهٔ استاندارد پرداخت سفارش ووکامرس؛ قیمت و مبلغ صدور بلیت در سرور کنترل می‌شوند.
QR محلی، دریافت بلیت، بازیابی مهمان، کنترل ورود آنلاین و ورود دستی اپراتور مجاز.
گزارش ظرفیت و حضور، CSV و XLSX، گردش کنترل‌شدهٔ لغو رایگان و استرداد دستی، بلوک‌ها و ابزارک‌های اختیاری Elementor.
فارسی و انگلیسی بر اساس زبان وردپرس/کاربر؛ جهت RTL و LTR و نمایش تاریخ متناسب با زبان.
پنل بخش‌بندی‌شده با نمای کلی، کارت‌های عملیاتی، فرم‌های واکنش‌گرا و جریان رزرو شامل نقشه، خلاصهٔ سفارش و مرحلهٔ مشخصات خریدار.

قابلیت‌های پشت تنظیمات آزمایشی، از جمله بعضی مسیرهای تخفیف، انتقال مالکیت، گروه‌بندی بلیت و اعلان‌ها، به پذیرش مستقل نیاز دارند و به‌طور پیش‌فرض غیرفعال می‌مانند. خرید بسته‌ای مشترک، PDF بومی بلیت و Checkout Blocks رسمی از قابلیت‌های تکمیل‌شدهٔ این بسته نیستند. شکاف‌های پرامپت حفظ شده‌اند.

نصب و ارتقا

PHP 8.1 یا جدیدتر و MySQL/MariaDB با InnoDB لازم است. برای سفارش و بلیت، WooCommerce فعال باشد. ترکیب نسخه‌های واقعاً آزموده‌شده در سازگاری ثبت می‌شود.
از فایل‌ها و پایگاه داده پشتیبان بگیرید. بستهٔ dist/event-seat-manager-2.0.0.zip را در افزونه‌های وردپرس نصب و فعال کنید.
هنگام جابه‌جایی از نام قبلی، ابتدا افزونهٔ قبلی را غیرفعال کنید؛ هر دو نسخه را هم‌زمان فعال نکنید. پوشه و فایل ورودی جدید event-seat-manager/event-seat-manager.php است.
پیشوند pesm_ در جدول‌ها، گزینه‌ها، مجوزها، API و شورت‌کدها عمداً ثابت است؛ اطلاعات موجود با تغییر نام پاک یا دوباره ایجاد نمی‌شوند. نسخهٔ ساختار داده 19 است؛ ارتقا از ۱۸ افزایشی است و نسخهٔ ساختار نباید به شمارهٔ محصول تغییر کند.
پس از فعال‌سازی pesm_schema_version=19 و خالی‌بودن pesm_schema_error را بررسی کنید. با مهاجرت ناموفق، مسیرهای رزرو متوقف می‌شوند. فعال‌سازی شبکه‌ای پشتیبانی نمی‌شود؛ در چندسایته هر سایت را جدا فعال کنید.
مرکز، سالن، رویداد و جلسه بسازید؛ رویداد و جلسه را منتشر کنید؛ صفحه‌های زیر را اضافه کنید و پذیرش آزمایشی را اجرا کنید.

سفارش‌های پرداخت‌نشدهٔ ساخته‌شده پیش از این نسخه snapshot مالی جدید ندارند؛ برای جلوگیری از صدور بلیت با مبلغ نامعتبر نیازمند بررسی دستی هستند. بلیت‌های قبلاً صادرشده حفظ می‌شوند. حذف افزونه داده‌های رزرو، بلیت و سفارش را پاک نمی‌کند.

صفحه‌ها

کاربرد	شورت‌کد
فهرست رویدادها	`[pesm_events]`
جزئیات رویداد	`[pesm_event id="123"]`
نقشهٔ صندلی	`[pesm_seat_map session="456"]`
بلیت‌های من	`[pesm_my_tickets]`
پنل مشتری	`[pesm_customer_panel]`
صورتحساب‌ها	`[pesm_invoices]`
کنترل ورود	`[pesm_gate_scanner]`
داشبورد مرکز	`[pesm_manager_dashboard center="7"]`
صندلی‌های سبد خرید	`[pesm_cart_seats]`

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

زبان و راهنما

در «تنظیمات ← عمومی ← زبان سایت»، فارسی یا English را انتخاب کنید. زبان پنل می‌تواند از تنظیمات زبان پروفایل مدیر پیروی کند. انگلیسی LTR و فارسی RTL است. ترجمه‌ها در languages/ و ابزار ساخت آن‌ها در tools/ قرار دارند. عناوین رویداد، نام مشتری و داده‌های واردشدهٔ کاربر ترجمهٔ ماشینی نمی‌شوند.

راهنمای مدیر فارسی · راهنمای کاربر فارسی · English guide · API · Security

توسعه و ساخت

npm ci
npm run build
python3 tests/run.py --report dist/verification.json
python3 tools/build-release.py

آزمون‌های مستقل هرکدام در فرایند PHP جدا اجرا می‌شوند. نصب و آزمون واقعی به محیط WordPress/WooCommerce/InnoDB نیاز دارد؛ دستور آن در راهنمای آزمون آمده است. CI برای PHP 8.1، 8.3 و 8.5 تعریف شده؛ اجرای آن در GitHub باید جداگانه تأیید شود. بسته از فهرست مجاز فایل‌ها ساخته می‌شود و شامل اطلاعات محیط محلی، تست‌ها یا فایل‌های مخزن نیست.

مجوز

GPL-2.0-or-later؛ تولیدکنندهٔ QR محلی تحت MIT است و متن مجوز آن در assets/vendor/ نگهداری می‌شود. فونت محلی Vazirmatn تحت SIL OFL 1.1 است و مجوز آن در assets/fonts/OFL.txt قرار دارد. مجوز Three.js و ابزار ساخت در assets/build/THIRD-PARTY-LICENSES.txt همراه بسته هستند. Node فقط برای توسعه و ساخت لازم است. تاریخچهٔ انتشار به درخواست مالک محصول خالی است.