Install
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/inisoliman/wp-akoal/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
موسوعة أقوال الآباء (Akoal Fathers Quotes) - WordPress Plugin
إضافة ووردبريس احترافية لعرض أقوال الآباء القديسين، تم تحويلها وتطويرها من تطبيق أندرويد "موسوعة أقوال الآباء". تتميز بتصميم عصري (Glassmorphism)، دعم SEO كامل، وميزات تفاعلية متقدمة.

🌟 المميزات (Features)
- 📚 مكتبة ضخمة: تحتوي على آلاف الأقوال لآباء الكنيسة القديسين.
- 🎨 تصميم عصري: واجهة مستخدم جميلة تعتمد على تأثير الزجاج (Glassmorphism) وتتوافق مع جميع الشاشات (Responsive).
- 🔍 صديقة لمحركات البحث (SEO):
- روابط دائمة لكل قديس (Permalinks).
- عناوين صفحات ديناميكية.
- استخدام وسوم
<a>وروابط حقيقية للأرشفة.
- 🖼️ توليد الصور (Image Generator): إمكانية تحويل أي قول إلى صورة احترافية مع اسم القديس والخلفية بضغطة زر، جاهزة للمشاركة على فيسبوك وإنستجرام.
- 📋 نسخ ذكي: زر لنسخ المقولة مع اسم القديس ورابط الموقع تلقائياً.
- 🧩 ويدجت (Widget): ويدجت "حكمة اليوم" لعرض أقوال عشوائية في السايدبار مع رابط لصفحة القديس.
- ⚡ أداة استيراد: نظام استيراد تلقائي للبيانات من ملف JSON عند تفعيل الإضافة لأول مرة.
🚀 طريقة التثبيت (Installation)
- قم بتحميل ملفات الإضافة ورفعها إلى مجلد
wp-content/plugins/akoalفي موقعك. - اذهب إلى لوحة تحكم ووردبريس > إضافات (Plugins).
- قم بتفعيل إضافة "Akoal Fathers Quotes".
- هام جداً: بعد التفعيل، اذهب إلى الإعدادات > روابط دائمة (Settings > Permalinks) واضغط على "حفظ التغييرات" فقط (دون تعديل شيء) لتنشيط روابط القديسين.
💻 طريقة الاستخدام (Usage)
1. الكود المختصر (Shortcode)
لعرض مكتبة الأقوال كاملة في أي صفحة، استخدم الكود المختصر التالي:
[fathers_quotes]
2. الويدجت (Widget)
اذهب إلى مظهر > ودجات (Appearance > Widgets) واسحب ويدجت "أقوال الآباء (Akoal)" إلى الشريط الجانبي.
🛠️ التقنيات المستخدمة (Tech Stack)
- PHP: المنطق الخلفي وإدارة قاعدة البيانات.
- WordPress API: الودجات، الشورت كود، والخيارات.
- JavaScript (jQuery): التفاعل في الواجهة الأمامية (AJAX).
- html2canvas: لتوليد الصور داخل المتصفح.
- CSS3: Flexbox, Grid, Glassmorphism, Animations.
- Cairo Font: خط عربي عصري ومقروء.
📂 هيكلية المشروع
akoal/
├── assets/ # ملفات التنسيق، الصور، والجافاسكريبت
├── includes/ # الكلاسات والوظائف الأساسية
│ ├── class-akoal-db.php # التعامل مع قاعدة البيانات
│ ├── class-akoal-shortcode.php # منطق الشورت كود وعرض الصفحات
│ └── class-akoal-widget.php # منطق الويدجت
├── templates/ # قوالب الصفحات
│ └── single-father.php # قالب صفحة القديس المنفردة
├── data/ # بيانات الأقوال (JSON)
├── akoal.php # الملف الرئيسي للإضافة
└── README.md # هذا الملف
📄 الترخيص (License)
هذا المشروع مفتوح المصدر. تطوير: HiMa & InI.soliman الأصل: تطبيق "موسوعة أقوال الآباء" لووردبريس.