manifest / events / schedule-tool-wp

Schedule Tool

A schedule-tool but as of WordPress plugin.

by Open Source Developer · github.com/ih4xz/schedule-tool-wp

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/ih4xz/schedule-tool-wp/archive/refs/heads/main.zip

Readme github.com/ih4xz/schedule-tool-wp ↗

This repository contains the official WordPress plugin implementation of the Schedule Tool.
هذا المستودع يحتوي على النسخة الرسمية لإضافة ووردبريس لأداة جداول الاختبارات.

العربية | English

العربية

إضافة ووردبريس (WordPress Plugin) قوية وسهلة الاستخدام تتيح للمشرفين إدارة جداول الاختبارات والكتالوجات الدراسية والجلسات بسهولة، وعرضها للطلاب في الواجهة الأمامية بشكل متجاوب وتفاعلي وثنائي اللغة بالكامل.

🌟 المميزات

ثنائية اللغة: دعم كامل للغتين العربية والإنجليزية.
تصفية ذكية وبحث حي: تصفية المقررات حسب المستويات الدراسية، الأقسام، والتخصصات مع محرك بحث فوري.
تصدير وطباعة: تصدير الجدول كملف PDF بتنسيقات متعددة، أو نسخه كنص منسق.
مزامنة محلية: حفظ الجدول الشخصي في ذاكرة المتصفح (Local Storage) واستعادته لاحقاً.
نظام إبلاغ ذكي: يتيح للطلاب إرسال البلاغات عن الأخطاء (التاريخ، الوقت، نقص المعلومات) مباشرة إلى قاعدة البيانات، مع دعم إشعارات البريد الإلكتروني وتيليجرام.
تحليلات متكاملة: لوحة تحليلات بسيطة ومتقدمة داخل لوحة التحكم لمتابعة سلوك الطلاب والبحث والمقررات الأكثر شعبية ونسبة التفاعل.

🛠️ طريقة التثبيت والاستخدام

انقل مجلد wp-schedule-tool إلى مسار الإضافات في موقعك (wp-content/plugins/).
قم بتفعيل الإضافة من صفحة "الإضافات" في لوحة تحكم ووردبريس.
توجه إلى التبويب الجديد "Schedules" في لوحة التحكم، واضغط على "Add New" لإنشاء جدول.
املأ بيانات الجدول (الإعدادات، الجلسات، المقررات، وصفوف الجدول).
بعد النشر، استخدم الكود القصير لعرض الجدول في أي صفحة أو مقال:
```
[seu_schedule post_id="YOUR_POST_ID"]
```

⚙️ الإعدادات والتحليلات

إعدادات البوت والبريد: اذهب إلى "الإعدادات" -> "Schedule Tool" لتفعيل وتعيين توكن بوت تلجرام والبريد الإلكتروني لتلقي إشعارات البلاغات.
لوحة التحليلات: اضغط على "Analytics" أو "Advanced Analytics" في قائمة "Schedules" لمتابعة التفاعلات ونشاط الطلاب.

English

This repository hosts the official WordPress plugin version of the Schedule Tool. It enables administrators to manage exam schedules, course catalogs, and session blocks, rendering a responsive, interactive, and bilingual timetable for students on the frontend.

🌟 Features

Bilingual Support: Full native layout and translation switching (AR/EN).
Smart Filtering & Live Search: Instantly filter exam times by study levels, categories, concentrations, or search by course codes/names.
Exporting Options: Download customized schedules as PDF (various styles) or copy formatted text for sharing.
Persistent Storage: Browser local storage caching allows students to save and reload their customized schedules.
Reporting System: Integrated feedback forms allowing students to report issues (wrong times, missing courses) to the database, Telegram, or email.
Built-in Analytics: Basic & Advanced analytics screens charting visitor actions, popular courses, and device usage.

🛠️ Installation & Getting Started

Move the wp-schedule-tool directory to your site's plugin directory (wp-content/plugins/).
Activate the plugin through the 'Plugins' menu in WordPress.
Navigate to the new "Schedules" custom post type menu, and click "Add New" to create a timetable.
Fill in the Sessions, Course Catalog, and Schedule mapping rows.
Once published, place this shortcode on any post or page to display it:
```
[seu_schedule post_id="YOUR_POST_ID"]
```

⚙️ Configurations & Reports

Telegram & Email Settings: Head to "Settings" -> "Schedule Tool" to set up Telegram Bot variables and administrator emails.
Dashboards: View daily tracking details under "Analytics" and "Advanced Analytics" submenus.

📄 License | الترخيص

هذا المشروع مرخص بموجب رخصة جي بي إل العامة (GPL-3.0) This project is licensed under the GNU General Public License v3.0.