مستندات افزونه چت اضطراری ویدالیوم
افزونه Vidalium SOS Chat یک ابزار چت اضطراری گروهی برای سایت‌های وردپرسی است که به کاربران واردشده اجازه می‌دهد در شرایط بحرانی، مانند قطعی اینترنت یا مواقع اضطراری، با یکدیگر ارتباط برقرار کنند. این افزونه با هدف حفظ ارتباط بین خانواده‌ها و دوستان در شرایط سخت، به‌ویژه پس از شروع جنگ بین جمهوری اسلامی و اسرائیل و مشکلات شبکه اینترنت در ایران، طراحی شده است.
همچنین می توانید این افزونه را در همین مقاله دانلود نمایید.
آموزش عمومی استفاده از افزونه چت اضطراری ویدالیوم
افزونه چت اضطراری ویدالیوم چیست و چه کار می‌کند؟
Vidalium SOS Chat یک سیستم چت ساده است که به شما امکان می‌دهد در سایت وردپرسی خود با دیگر کاربران ثبت‌شده گپ بزنید. این افزونه برای مواقع اضطراری طراحی شده و به شما اجازه می‌دهد:
پیام‌های متنی یا صوتی ارسال کنید.
در چت‌روم‌های گروهی با تعداد محدود (تا 10 کاربر) شرکت کنید.
پیام‌ها را ویرایش یا حذف کنید (اگر مال خودتان باشد یا ادمین باشید).
ببینید چه کسانی پیام‌های شما را دیده‌اند.
توجه: این افزونه ابتدا قرار بود به‌صورت پولی و با امکانات پیشرفته منتشر شود، اما به دلیل شرایط بحرانی و نیاز فوری به ارتباط امن، به‌صورت رایگان و با امکانات محدود عرضه شد.
هدف اصلی: کمک به مردم ایران، برای حفظ ارتباط امن و محدود با عزیزانشان در شرایط اضطراری، با تمرکز بر سادگی و کارایی.
توجه: تمام داده‌های چت روی هاست خود شما ذخیره می‌شود و ما هیچ دسترسی مستقیم یا غیرمستقیمی به اطلاعات شما نداریم.
نکات مهم برای کاربران
محدودیت تعداد کاربران: این افزونه برای حداکثر 10 کاربر و 3 چت‌روم بهینه شده است. استفاده با تعداد بیشتر ممکن است به دلیل محدودیت‌های هاست اشتراکی یا کندی اینترنت مشکل‌ساز شود.
- محدودیت در زمان پیام صوتی: طبق تست هایی که تا کنون روی افزونه با انواع هاست های اشتراکی و سرعت اینترنت فعلی ایران صورت گرفته، بهتر است از پیام های حداکثر 10-15 ثانیه ای استفاده کنید.
پاکسازی چت‌روم: برای کاهش حجم دیتابیس، توصیه می‌کنیم ادمین‌ها هر چند وقت یک‌بار پیام‌های چت‌روم را پاک کنند (از پنل مدیریت).
فایل‌های صوتی: هنگام پاکسازی چت‌روم، فایل‌های صوتی فیزیکی روی سرور باقی می‌مانند. اگر می‌خواهید این فایلها هم حذف شوند، از طریق فرم تماس یا ربات تلگرام به ما اطلاع دهید تا در نسخه‌های بعدی اضافه کنیم.
گزارش باگ: اگر مشکلی دیدید (مثلاً پیام ارسال نشد یا چت‌روم لود نشد)، لطفاً از طریق فرم تماس در پایین همین صفحه یا ربات تلگرام @vidalstudio_bot گزارش کنید.
چگونه از افزونه چت اضطراری ویدالیوم استفاده کنیم؟
ورود به سایت:
برای استفاده از چت، باید وارد حساب کاربری خود در سایت وردپرسی شوید. اگر حساب ندارید، با مدیر سایت تماس بگیرید تا برایتان حساب بسازد.
دسترسی به چت‌روم‌ها:
پس از ورود، در منوی پیشخوان وردپرس (یا ویجت پیشخوان)، چت‌روم‌های موجود (مثل “چت عمومی”) را می‌بینید.
روی نام چت‌روم کلیک کنید تا وارد صفحه چت شوید.
ارسال پیام:
در پایین صفحه چت، کادر متنی “پیام خود را بنویسید…” را می‌بینید.
پیام خود را بنویسید و دکمه ارسال پیام را بزنید.
ارسال پیام صوتی:
برای ضبط صدا، دکمه شروع ضبط را بزنید.
پس از ضبط، دکمه توقف ضبط را بزنید تا پیام صوتی ارسال شود.
مدیریت پیام‌ها:
اگر پیام مال خودتان باشد، می‌توانید آن را ویرایش یا حذف کنید (با کلیک روی گزینه‌های کنار پیام).
ادمین‌ها می‌توانند پیام‌های همه را حذف کنند.
دیدن وضعیت کاربران:
بالای صفحه چت، لیست کاربران آنلاین (یا آفلاین) نمایش داده می‌شود.
می‌توانید ببینید چه کسانی پیام‌های شما را دیده‌اند (ویژگی “Seen By”).
مستندات فنی برای توسعه دهندگان
قابلیت‌های افزونه چت اضطراری ویدالیوم
چت‌روم‌های گروهی:
ادمین کل (کاربر با نقش Administrator) می‌تواند چت‌روم ایجاد، ویرایش، یا حذف کند.
چت‌روم پیش‌فرض (“چت عمومی”) هنگام فعال‌سازی افزونه ساخته می‌شود و همه کاربران ثبت‌شده به آن دسترسی دارند.
مدیریت دسترسی:
ادمین می‌تواند کاربران خاصی (بر اساس نقش یا به‌صورت دستی) را به چت‌روم‌ها اضافه یا حذف کند.
ادمین‌ها به همه چت‌روم‌ها دسترسی دارند.
پیام‌های متنی و صوتی:
پشتیبانی از پیام‌های متنی و صوتی (فایل‌های صوتی با فرمت webm روی هاست ذخیره می‌شوند).
امکان پاسخ به پیام‌ها (Reply) و نمایش سلسله‌مراتبی پیام‌ها.
ویژگی Seen By:
با استفاده از Intersection Observer، مشخص می‌شود کدام کاربران پیام را دیده‌اند.
مدیریت پیام‌ها:
کاربران می‌توانند پیام‌های خودشان را ویرایش یا حذف کنند.
ادمین‌ها می‌توانند همه پیام‌ها را حذف کنند یا کل پیام‌های یک چت‌روم را پاک کنند.
وضعیت آنلاین:
نمایش وضعیت آنلاین/آفلاین کاربران (بر اساس فعالیت 5 دقیقه اخیر).
ویجت پیشخوان:
دسترسی سریع به چت‌روم‌ها از پیشخوان وردپرس.
محدودیت‌ها
تعداد کاربران: به دلیل محدودیت‌های هاست‌های اشتراکی (اکثر سایت‌های وردپرسی)، افزونه برای حداکثر 10 کاربر و 3 چت‌روم بهینه شده است. استفاده با تعداد بیشتر ممکن است باعث کندی یا خطا شود.
شبکه اینترنت: در شرایط کندی اینترنت، ارسال پیام یا لود چت‌روم ممکن است با تأخیر مواجه شود.
فایل‌های صوتی: فایل‌های صوتی هنگام پاکسازی چت‌روم حذف نمی‌شوند (برای حفظ داده‌ها). برای حذف فایلها، درخواست خود را از طریق فرم تماس یا ربات تلگرام ارسال کنید.
عدم پشتیبانی از چندزبانه: رابط کاربری فقط به زبان فارسی است (برای کاربران ایرانی طراحی شده).
عدم ذخیره‌سازی ابری: همه داده‌ها روی هاست کاربر ذخیره می‌شوند، که ممکن است با افزایش پیام‌ها حجم دیتابیس را زیاد کند.
نصب و راه‌اندازی
دانلود و نصب:
فایل افزونه را از صفحه مستندات دانلود کنید.
در پیشخوان وردپرس، به افزونه‌ها > افزودن بروید و فایل را آپلود و فعال کنید.
ایجاد چت‌روم پیش‌فرض:
پس از فعال‌سازی، چت‌روم “چت عمومی” به‌طور خودکار ساخته می‌شود و همه کاربران ثبت‌شده به آن دسترسی دارند.
مدیریت چت‌روم‌ها:
به منوی مدیریت چت‌روم‌ها در پیشخوان بروید.
چت‌روم جدید بسازید، کاربران را اضافه کنید، یا چت‌روم‌های موجود را ویرایش/حذف کنید.
گزارش باگ و درخواست پشتیبانی
فرم تماس: از طریق vidalstudio.ir با ما تماس بگیرید.
ربات تلگرام: به @vidalstudio_bot پیام دهید و مشکل را شرح دهید.
لطفاً اطلاعات دقیق (مثل خطا، نسخه وردپرس، و تعداد کاربران) ارائه دهید تا سریع‌تر کمک کنیم.
مشارکت داوطلبانه در توسعه
اگر تمایل دارید به توسعه این پروژه کمک کنید، می‌توانید هر مبلغی که مایلید به شماره حساب زیر واریز کنید:
شماره کارت: 6277601373549078
ما در صورت صلاحدید، این مبالغ را برای بهبود افزونه یا کمک به مردم جنگ‌زده ایران استفاده خواهیم کرد.
پرسش و پاسخ
1. چرا گاهی پیام‌ها دیر ارسال می‌شوند؟
این مشکل ممکن است به دلیل کندی اینترنت یا محدودیت‌های هاست اشتراکی باشد. توصیه می‌کنیم تعداد کاربران را به 10 نفر یا کمتر محدود کنید و پیام‌های قدیمی را پاک کنید.
2. آیا می‌توانم چت‌روم را برای تعداد بیشتری کاربر استفاده کنم؟
افزونه برای حداکثر 10 کاربر و 3 چت‌روم بهینه شده است. استفاده با تعداد بیشتر ممکن است باعث کندی یا خطا شود. اگر نیاز به مقیاس بزرگ‌تر دارید، با ما تماس بگیرید.
3. پیام‌های صوتی کجا ذخیره می‌شوند؟
پیام‌های صوتی روی هاست شما (در پوشه آپلود وردپرس) ذخیره می‌شوند. هنگام پاکسازی چت‌روم، این فایلها حذف نمی‌شوند، اما می‌توانید خودتان از روی هاست پاکسازی نمایید. “در نسخه بعدی قابلیت حذف فیزیکی فایلها از داخل پنل وردپرس اضافه خواهد شد”
4. آیا اطلاعات چت‌ها جایی غیر از هاست من ذخیره می‌شود؟
خیر، همه داده‌ها (پیام‌ها، فایل‌های صوتی، و تنظیمات) فقط روی هاست شما ذخیره می‌شوند. ما هیچ دسترسی به داده‌های شما نداریم.
5. چگونه همه چت‌روم را پاکسازی کنم؟
فقط ادمین‌ها می‌توانند در پنل مدیریت چت‌روم‌ها، گزینه پاکسازی پیام‌ها را برای هر چت‌روم انتخاب کنند. این کار همه پیام‌های چت‌روم را از دیتابیس حذف می‌کند.
6. چطور پیام های خودم را در چت‌روم پاکسازی کنم؟
خیلی ساده روی دکمه حذف کلیک کنید.
5. چطور می توانم به پیام دیگران مستقیما پاسخ دهم؟ “replay”
خیلی ساده روی دکمه پاسخ که زیر پیام قرار دارد کلیک کنید و سپس پیام صوتی یا متنی خودتان را ارسال کنید.
7. آیا می‌توانم افزونه را برای مقاصد تجاری استفاده کنم؟
خیر، این افزونه فقط برای استفاده غیرتجاری و در شرایط اضطراری طراحی شده است. هرگونه سوءاستفاده تجاری یا غیرقانونی منجر به پیگرد قانونی خواهد شد.
نکات قانونی و اخلاقی
هدف انسان‌دوستانه: این افزونه با هدف کمک به حفظ ارتباط خانواده‌ها در شرایط بحرانی ساخته شده است. لطفاً از آن فقط برای مقاصد خیرخواهانه استفاده کنید.
ممنوعیت سوءاستفاده: هرگونه استفاده تجاری، غیرقانونی، یا غیراخلاقی از افزونه ممنوع است و پیگرد قانونی دارد.
حریم خصوصی: ما هیچ دسترسی به داده‌های شما نداریم. همه اطلاعات روی هاست خود شما ذخیره می‌شوند.
مسئولیت کاربر: مسئولیت محتوای چت‌ها و مدیریت چت‌روم‌ها با مدیر سایت است.
ویدال استودیو یک تیم متشکل از متخصصین جوان ایرانی است که با عشق به کمک به هم‌وطنان ایرانی، افزونه چت اضطراری ویدالیوم را رایگان منتشر کرده است. هدف ما ایجاد ابزاری ساده و امن برای ارتباط در شرایط سخت است. “مانند جنگی که در حال حاضر، در آن به سر می بریم”