سبب تعطل الكود الخاص بك هو تعارض أساسي في الطباعة. غالبًا ما تولد أدوات الذكاء الاصطناعي ومعالجات النصوص "علامات اقتباس ذكية" (مثل علامات الاقتباس المنحنية “ و ”). تتطلب أكواد ووردبريس القصيرة ولغات البرمجة الأساسية بشكل صارم "علامات اقتباس مستقيمة" (مثل " و '). عندما يرى جوتنبرج علامات اقتباس منحنية داخل قوس الكود القصير، يفشل في تحليلها ككود ويتعطل العرض.
علاوة على ذلك، فإن النسخ واللصق دمر تمامًا الجداول في الوثائق، وحولها إلى كتل نص غير قابلة للقراءة. النسخ واللصق للنص الخام بشكل أعمى يقلل من جودة البيانات الهيكلية.
لقد قمت بتنظيف النص الخاص بك. قمت بتحويل كل الطباعة إلى علامات اقتباس مستقيمة، ووضعت أكوادك القصيرة في تنسيق الكود حتى لا يحاول جوتنبرج تنفيذها، وأعدت بناء الجداول المدمرة إلى تنسيق Markdown الصحيح. إذا قمت بلصق هذا مباشرة في جوتنبرج، يجب أن يولد تلقائيًا العناوين والجداول وكتل الكود الصحيحة.
هنا هو الإصدار الهيكلي السليم:
TruePaws — الدليل الشامل للمستخدم
ما هو TruePaws؟
TruePaws هو نظام إدارة بيوت الكلاب يعمل داخل موقع ووردبريس الخاص بك. يساعد المربين المحترفين في إدارة حيواناتهم، وتتبع التكاثر والحمل، والتعامل مع جهات اتصال المشترين، وإنشاء المستندات الرسمية (مثل شهادات النسب وحزم التسليم)، وحتى عرض الجراء/القطط المتاحة على موقعك العام.
الجزء 1: المتطلبات الأساسية (ما تحتاجه قبل التثبيت)
1. موقع ووردبريس
- تحتاج إلى موقع ووردبريس مستضاف ذاتيًا (النوع الذي تقوم بتثبيته على استضافتك الخاصة — وليس مدونة ووردبريس.كوم المجانية).
- يتطلب إصدار ووردبريس 5.0 أو أحدث.
2. متطلبات الاستضافة
- PHP 7.4 أو أحدث (معظم مضيفي الاستضافة الحديثين يوفرون PHP 8.0+).
- قاعدة بيانات MySQL (وهي معيارية مع جميع مضيفي ووردبريس).
- يجب تمكين واجهة برمجة تطبيقات REST لووردبريس (وهي مفعلة افتراضيًا — إلا إذا قام شخص ما بإيقافها عمدًا).
3. اختياري (ولكن موصى به)
- مفتاح واجهة برمجة تطبيقات Google Gemini إذا كنت ترغب في استخدام الميزات المدعومة بالذكاء الاصطناعي (نصائح الرعاية، تنبيهات الصحة، إنشاء السيرة التسويقية). يمكنك الحصول على واحد مجانًا من Google AI Studio.
- حساب Zapier أو Make إذا كنت ترغب في إرسال إشعارات آلية إلى الخدمات الخارجية.
الجزء 2: تثبيت الإضافة
الخطوة 1 — رفع الإضافة
- قم بتسجيل الدخول إلى لوحة تحكم إدارة ووردبريس الخاصة بك (عادةً
yourwebsite.com/wp-admin). - في الشريط الجانبي الأيسر، انتقل إلى الإضافات → إضافة جديدة.
- انقر على رفع إضافة الزر في الأعلى.
- انقر اختر ملف وحدد
truepaws.zipالملف الذي استلمته. - انقر تثبيت الآن وانتظر حتى ينتهي.
الخطوة 2 — تفعيل الإضافة
- بعد اكتمال التثبيت، انقر على تفعيل الإضافة زر.
- ستقوم الإضافة تلقائيًا بإنشاء جميع جداول قاعدة البيانات التي تحتاجها.
- سترى عنصر قائمة جديد ترو باوز يظهر في الشريط الجانبي لووردبريس الخاص بك.
الجزء 3: الإعداد الأولي (افعل هذا أولاً!)
بعد التفعيل، انتقل إلى TruePaws → الإعدادات في الشريط الجانبي لووردبريس الخاص بك. سترى عدة علامات تبويب في الأعلى. اعمل على كل واحدة منها.
التبويب 1: الإعدادات العامة
| إعداد | ما يفعله | مثال |
| النوع الافتراضي | نوع الحيوان الذي تقوم بتربيته بشكل أساسي. الخيارات: كلب، قطة، حصان، أرنب، خنزير غينيا، ابن مقرض، طائر. | كلب |
| بادئة المربي | رمز قصير (بحد أقصى 5 أحرف) يستخدم عند التسمية التلقائية للجراء/القطط من الفضلات. | تي بي |
| مدة الحمل - الكلاب | عدد الأيام التي يستغرقها حمل الكلب. الافتراضي هو 63. قم بالتغيير فقط إذا كنت تعرف غير ذلك. | 63 |
| مدة الحمل - القطط | عدد الأيام التي يستغرقها حمل القطة. الافتراضي هو 65. | 65 |
| تعليمات التغذية | النص الذي سيظهر على مستندات التسليم التي تقدمها للمشترين الجدد. اكتب ما يأكله الحيوان، وعدد المرات، وأي تعليمات خاصة. | “أطعم 3 مرات يوميًا بطعام الجراء Royal Canin…” |
| مفتاح واجهة برمجة تطبيقات Gemini | الصق مفتاح واجهة برمجة تطبيقات Google Gemini هنا لتمكين ميزات الذكاء الاصطناعي. اتركه فارغًا إذا كنت لا تريد ميزات الذكاء الاصطناعي. | (مفتاحك) |
| رابط Webhook | إذا كنت تستخدم Zapier أو Make للأتمتة، فالصق رابط Webhook هنا. اتركه فارغًا في حال عدم الاستخدام. | (رابط Webhook الخاص بك) |
انقر حفظ الإعدادات عند الانتهاء.
التبويب 2: معلومات المربي
املأ تفاصيلك المهنية. تظهر هذه المعلومات على ملفات PDF المُنشأة (شهادات النسب، حزم التسليم).
| الحقل | ما يجب إدخاله |
| اسم المربي | اسمك الكامل كمربي |
| اسم العمل | اسم مزرعتك للكلاب أو القطط |
| رقم الترخيص | رقم ترخيص التربية الخاص بك (إذا كان متاحًا) |
| الهاتف | رقم هاتف عملك |
| البريد الإلكتروني | عنوان بريدك الإلكتروني التجاري |
انقر حفظ الإعدادات عند الانتهاء.
التبويب 3: السلالات
هذا هو المكان الذي تدير فيه قائمة السلالات المتاحة في القوائم المنسدلة عبر المكون الإضافي. يأتي TruePaws مسبقًا مع 20 سلالة كلاب شائعة و20 سلالة قطط شائعة.
- لإضافة سلالة: اكتب اسم السلالة في مربع النص وانقر على إضافة سلالة.
- لإزالة سلالة: انقر على زر الحذف بجوار أي سلالة في القائمة.
نصيحة: أضف جميع السلالات التي تعمل معها الآن. يمكنك دائمًا إضافة المزيد لاحقًا.
التبويب 4: التواصل
املأ عنوان بريدك الإلكتروني ورابط صفحة الاتصال. يُستخدم هذا للميزات العامة والرموز القصيرة.
| الحقل | ما يجب إدخاله |
| عنوان الشارع | عنوان الشارع لمزرعتك |
| المدينة | المدينة |
| الولاية/المقاطعة | الولاية أو المقاطعة |
| الرمز البريدي | الرمز البريدي |
| البلد | البلد |
| رابط الاتصال / الاستفسار | رابط صفحة الاتصال بموقعك الإلكتروني (يُستخدم كرابط افتراضي لأزرار "الاتصال بالمربي") |
انقر حفظ الإعدادات عند الانتهاء.
التبويب 5: تقارير المبيعات
هذه علامة تبويب للقراءة فقط — تعرض إحصائيات مبيعاتك بمجرد بدء تسجيل المبيعات. سترى:
- إجمالي الإيرادات المكتسبة
- إجمالي عدد المبيعات
- متوسط سعر البيع
- جدول تفصيلي شهري
- جدول أفضل المشترين
الجزء 4: لوحة التحكم
عند النقر على TruePaws في الشريط الجانبي، تصل إلى لوحة التحكم. هذه هي قاعدتك الرئيسية. إليك ما ستراه:
بطاقات الإحصائيات
- إجمالي الحيوانات - عدد الحيوانات في نظامك
- الولادات النشطة - حالات الحمل التي يتم تتبعها حاليًا
- جهات الاتصال - إجمالي المشترين ومدخلات قائمة الانتظار
- الأحداث القادمة - الأحداث القريبة (التطعيمات، مواعيد الولادة، إلخ)
إجراءات سريعة
- إضافة حيوان - الانتقال مباشرة إلى نموذج الحيوان الجديد
- تسجيل التزاوج - تسجيل تزاوج جديد
- إضافة جهة اتصال - إضافة مشتر جديد أو مدخل لقائمة الانتظار
قائمة التحقق للبدء
- قائمة مراجعة مفيدة ترشدك خلال الإعداد لأول مرة.
أحدث الأحداث
- خط زمني لأحدث الأحداث عبر جميع حيواناتك (التطعيمات، زيارات الطبيب البيطري، فحوصات الوزن، إلخ).
الرسوم البيانية
- توزيع السلالات — مخطط دائري يوضح عدد الحيوانات التي تمتلكها من كل سلالة.
- نظرة عامة على المبيعات — مخطط شريطي يوضح الإيرادات الشهرية.
خريطة النشاط الحراري
- خريطة حرارية على نمط GitHub تُظهر مدى نشاط مزرعتك كل يوم خلال العام الماضي. المربعات الأغمق = المزيد من الأحداث المسجلة في ذلك اليوم.
الجزء 5: إضافة وإدارة الحيوانات
كيفية إضافة حيوان جديد
- انتقل إلى TruePaws → الحيوانات (أو انقر على "إضافة حيوان" في لوحة التحكم).
- انقر على إضافة حيوان جديد زر.
- املأ النموذج:
| الحقل | مطلوب؟ | الوصف |
| الاسم | نعم | الاسم المسجل/الرسمي للحيوان |
| اسم النداء | لا | الاسم الذي تناديه به في المنزل |
| رقم التسجيل | لا | رقم التسجيل الرسمي من سجل السلالة |
| رقم الشريحة الإلكترونية | لا | رقم الشريحة الإلكترونية (يجب أن يكون فريدًا) |
| السلالة | لا | اختر من قائمة السلالات الخاصة بك |
| الجنس | نعم | ذكر أو أنثى |
| الأب (الأب) | لا | اختر من الذكور الموجودة في نظامك |
| الأم (الأم) | لا | اختر من الإناث الموجودة في نظامك |
| تاريخ الميلاد | لا | تاريخ ميلاد الحيوان |
| الحالة | لا | نشط، متقاعد، مباع، متوفى، أو مملوك بالمشاركة (الافتراضي هو نشط) |
| اللون/العلامات | لا | صف مظهر الحيوان |
| الوصف | لا | أي ملاحظات إضافية عن الحيوان |
| الصورة المميزة | لا | انقر لفتح مكتبة الوسائط في ووردبريس وتحديد صورة |
- انقر حفظ الحيوان.
نصيحة للإعداد لأول مرة: ابدأ بإضافة حيوانات التربية البالغة (الذكور والإناث) أولاً. بهذه الطريقة، عند إضافة الحيوانات الأصغر سنًا أو الجراء، يمكنك اختيار آبائهم من القوائم المنسدلة.
صفحة ملف الحيوان
بعد الحفظ، انقر على اسم أي حيوان لرؤية صفحة ملفه الشخصي. هذه هي الصفحة الأكثر غنى بالميزات في البرنامج المساعد. إليك كل ما يمكنك فعله:
عرض المعلومات
- اطلع على جميع التفاصيل التي أدخلتها، بالإضافة إلى شارة الحالة (مثل "نشط" باللون الأخضر، "مباع" باللون الأزرق).
- تظهر الصورة المميزة بشكل بارز، مع صورة ظلية احتياطية في حالة عدم تحميل أي صورة.
معرض الصور
- قم بتحميل صور متعددة بالنقر على "إضافة صور".
- اسحب الصور وأسقطها لإعادة ترتيبها.
- انقر على صورة لتعيينها كصورة مميزة.
- احذف الصور التي لم تعد بحاجة إليها.
الجدول الزمني والأحداث
يعرض الجدول الزمني تاريخًا زمنيًا لكل ما حدث لهذا الحيوان. لإضافة حدث جديد:
- انقر على إضافة حدث زر.
- اختر نوع الحدث: ولادة، تطعيم، شبق، تزاوج، ولادة، وزن، زيارة طبيب بيطري، أو ملاحظة.
- أدخل التاريخ وعنوان/وصف.
- لأحداث الوزن، أدخل قيمة الوزن.
- انقر حفظ.
شجرة النسب
- يعرض شجرة عائلة من 3 أجيال تُظهر الآباء والأجداد وأجداد الأجداد. (يعمل فقط إذا قمت بإدخال علاقات الوالدين).
- انقر تحميل ملف PDF لشجرة النسب لإنشاء شهادة قابلة للطباعة.
مخطط نمو الوزن
- إذا كنت قد سجلت أحداث الوزن، سيظهر مخطط خطي يوضح وزن الحيوان بمرور الوقت.
ميزات الذكاء الاصطناعي (تتطلب مفتاح واجهة برمجة تطبيقات Gemini)
- نصائح الرعاية بالذكاء الاصطناعي — يولد توصيات رعاية مخصصة بناءً على سلالة الحيوان وعمره وتاريخه.
- السيرة التسويقية بالذكاء الاصطناعي — يكتب وصفًا جذابًا لموقعك على الويب أو قوائم وسائل التواصل الاجتماعي.
- تنبيهات الصحة بالذكاء الاصطناعي — يحلل سجل الأحداث ويشير إلى المشكلات الصحية المحتملة.
بيع حيوان
- في ملف الحيوان، انقر بيع / حجز.
- اختر المشتري من قائمة جهات الاتصال الخاصة بك.
- أدخل تاريخ البيع والسعر.
- أضف أي ملاحظات (اختياري).
- انقر تأكيد البيع.
- يتغير حالة الحيوان إلى "مباع".
- انقر إنشاء ملف PDF للتسليم لإنشاء وثيقة تسليم احترافية.
نسخ الكود المختصر
في أسفل الملف الشخصي، سترى رمزًا قصيرًا مثل . انقر لنسخه. يمكنك لصق هذا في أي صفحة أو منشور ووردبريس لعرض ملف هذا الحيوان على موقعك العام.
الجزء 6: التربية وإدارة الفضلات
تسبيط تزاوج جديد
- انتقل إلى TruePaws → الفضلات.
- انقر تسجيل تزاوج جديد.
- املأ النموذج:
| الحقل | مطلوب؟ | الوصف |
| الأب (الأب) | نعم | اختر الذكر من بين حيواناتك |
| الأم (الأم) | نعم | اختر الأنثى من بين حيواناتك |
| تاريخ التزاوج | نعم | تاريخ حدوث التكاثر |
| الطريقة | لا | تزاوج طبيعي أو تلقيح صناعي (AI) |
| ملاحظات | لا | أي ملاحظات حول التزاوج |
- انقر حفظ.يقوم النظام تلقائيًا بحساب تاريخ الولادة المتوقع بناءً على إعدادات مدة الحمل الخاصة بك.
تتبع الحمل
كل فضلة نشطة تعرض متتبع الحمل بطاقة تحتوي على:
- شريط تقدم يوضح مدى تقدم الحمل.
- مؤشر الثلث (مبكر / منتصف / متأخر).
- الأيام المتبقية حتى الولادة المتوقعة.
- المعالم القادمة (الانغراس، نبض القلب، الموجات فوق الصوتية، إلخ).
تسجيل الولادة (الوضع)
- انتقل إلى TruePaws → الفضلات.
- ابحث عن القمامة وانقر ولادة القمامة.
- الخطوة 1 — تسجيل الولادة: أدخل تاريخ الولادة الفعلي، عدد الذكور/الإناث من النسل، ومعاينة الأسماء المولدة تلقائياً.
- الخطوة 2 — التأكيد: راجع الملخص وانقر على إرسال. يقوم النظام تلقائياً بإنشاء سجلات فردية لكل نسل، تعيين الوالدين، تسجيل حدث الولادة، وتعيين حالتهم إلى نشط.
الجزء 7: إدارة جهات الاتصال (المشترين وقائمة الانتظار)
إضافة جهة اتصال
- انتقل إلى TruePaws → جهات الاتصال.
- انقر إضافة جهة اتصال جديدة.
- املأ النموذج:
| الحقل | مطلوب؟ | الوصف |
| الاسم الأول | نعم | الاسم الأول للمشتري |
| الاسم الأخير | لا | الاسم الأخير للمشتري |
| البريد الإلكتروني | نعم | عنوان البريد الإلكتروني للمشتري |
| الهاتف | لا | رقم الهاتف |
| العنوان | لا | عنوان البريد |
| الحالة | لا | قائمة الانتظار، محجوز، مشتري، أو غير نشط |
| ملاحظات | لا | أي ملاحظات خاصة حول هذا الاتصال |
- انقر حفظ جهة الاتصال.
ميزات قائمة الاتصال
- تصفية حسب الحالة — عرض فقط قائمة الانتظار، المحجوزة، المشترين، أو جهات الاتصال غير النشطة.
- تصدير إلى CSV — تنزيل جميع جهات الاتصال كملف جدول بيانات لأدوات تسويق البريد الإلكتروني.
الجزء 8: عرض الحيوانات على موقعك (رموز قصيرة)
الرموز القصيرة هي رموز خاصة تلصقها في صفحات أو منشورات ووردبريس لعرض محتوى TruePaws على موقعك العام.
1. عرض حيوان واحد
[truepaws_animal id="7"]
She loves exploring the garden, chasing her favorite toys, and cuddling up after a long day of adventure. Vivamus pretium quam sed velit tempor, eget facilisis nulla sagittis. Her friendly personality and bright eyes make her a joy to everyone around. Donec ultricies, magna sed bibendum suscipit, sapien orci euismod nisl, non tempor felis nisi a justo. Bailey Sire: Max Dam: Lizzy
Bailey
Sold
Photos
Parents
Description
Pedigree
(استبدل 123 برقم هوية الحيوان الفعلي)
إعدادات اختيارية يمكنك إضافتها:
| المعامل | ما يفعله | افتراضي |
contact_url="https://..." | رابط مخصص لزر "اتصل بالمربي" | رابط إعداداتك |
show_ai="true" أو "false" | إظهار أو إخفاء معلومات رعاية الذكاء الاصطناعي | صحيح |
show_pedigree="true" أو "false" | إظهار أو إخفاء شجرة النسب | صحيح |
show_inquiry_form="true" أو "false" | تضمين نموذج استفسار أسفل الحيوان | خطأ |
show_gallery="true" أو "false" | إظهار أو إخفاء معرض الصور | صحيح |
gallery_columns="3" | عدد الأعمدة للمعرض (من 2 إلى 6) | 4 |
مثال مع خيارات:
[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]
She loves exploring the garden, chasing her favorite toys, and cuddling up after a long day of adventure. Vivamus pretium quam sed velit tempor, eget facilisis nulla sagittis. Her friendly personality and bright eyes make her a joy to everyone around. Donec ultricies, magna sed bibendum suscipit, sapien orci euismod nisl, non tempor felis nisi a justo. Bailey Sire: Max Dam: Lizzy
Bailey
Sold
Photos
Parents
Description
Pedigree
2. عرض الفضلات
[truepaws_litter id="1"]
No puppies available from this litter at this time. Litter: BR26LB
يعرض هذا معلومات الفضلة بما في ذلك الوالدين، تاريخ الولادة، وشريط من الجراء/القطط المتاحة مع صورهم وشارات الحالة.
3. عرض جميع الجراء/القطط المتاحة
[truepaws_available_puppies]
يعرض هذا شريطًا لجميع الحيوانات ذات حالة "نشط".
إعدادات اختيارية:
| المعامل | ما يفعله | افتراضي |
limit="6" | الحد الأقصى لعدد الحيوانات لعرضها | 12 |
breed="Golden Retriever" | عرض حيوانات هذا السلالة فقط | (جميع السلالات) |
show_images="true" أو "false" | إظهار أو إخفاء الصور | صحيح |
مثال:
[truepaws_available_puppies breed="Labrador Retriever" limit="8"]
4. عرض نموذج الاستفسار
[truepaws_inquiry_form]
يعرض هذا نموذج اتصال يمكن للزوار ملؤه للاستفسار عن حيواناتك.
إعدادات اختيارية:
| المعامل | ما يفعله | افتراضي |
animal_id="123" | ربط الاستفسار بحيوان معين | (لا شيء) |
title="Interested? Get in Touch!" | عنوان النموذج المخصص | "إرسال استفسار" |
الجزء 9: مستندات PDF
يمكن لـ TruePaws إنشاء نوعين من مستندات PDF الاحترافية:
1. شهادة النسب
يتم إنشاؤها من صفحة ملف أي حيوان. تحتوي على اسم الحيوان، تفاصيل التسجيل، شجرة نسب لثلاثة أجيال، واسم المربي.
2. حزمة التسليم
يتم إنشاؤها من ملف حيوان تم بيعه. تحتوي على تفاصيل الحيوان، معاينة النسب، السجل الصحي الكامل، تعليمات التغذية، توصيات الرعاية، العقد/الشروط، ومعلومات المربي.
ملاحظة: للحصول على أفضل جودة لملف PDF، اطلب من مضيف الويب الخاص بك التأكد من تثبيت مكتبة TCPDF أو Dompdf PHP.
الجزء 10: إشعارات البريد الإلكتروني التلقائية
يقوم TruePaws بإجراء فحص يومي ويرسل لك تذكيرات عبر البريد الإلكتروني ل:
- تذكيرات الولادة: يتم إرسالها قبل 7 أيام من تاريخ الولادة المتوقع.
- تذكيرات التطعيم: يذكرك بالمراحل الرئيسية (6 أسابيع، 9 أسابيع، 12 أسبوعًا، 16 أسبوعًا، سنة واحدة، سنتان، 3 سنوات).
مهم: يتم إرسال هذه الرسائل إلى العنوان الذي أدخلته في الإعدادات → معلومات المربي → البريد الإلكتروني.
الجزء 11: سير العمل الموصى به (خطوة بخطوة)
الإعداد الأولي
- قم بتثبيت وتفعيل الإضافة.
- انتقل إلى الإعدادات واملأ جميع الألسنة.
- أضف سلالاتك المخصصة.
بناء قاعدة البيانات الخاصة بك
- أضف جميع حيوانات التربية البالغة أولاً (الذكور والإناث).
- قم بتحميل الصور وملء بيانات التسجيل.
- حدد علاقات الأبوين لبناء أشجار النسب.
- أضف الأحداث التاريخية لبناء الجدول الزمني لكل حيوان.
الاستخدام اليومي
- عند حدوث التزاوج، سجله تحت قسم الفضلات.
- تتبع حالات الحمل واستخدم معالج الولادة عند حدوث الولادات.
- قم بتحديث ملفات النسل أثناء نموها.
- أضف المشترين إلى قائمة جهات الاتصال.
البيع
- عند بيع حيوان، استخدم ميزة البيع/الحجز في ملفه الشخصي.
- إنشاء ملف PDF للتسليم.
- مراقبة تقارير المبيعات.
الموقع الإلكتروني العام
- إنشاء صفحة "جراء متاحة" باستخدام:
truepaws_available_puppiesكود قصير - إنشاء صفحات فردية باستخدام
truepaws_animal id="..."كود قصير - إضافة
truepaws_inquiry_formكود قصير إلى صفحة الاتصال الخاصة بك.
الجزء 12: نصائح وحيل
- استخدم خريطة النشاط الحرارية في لوحة التحكم لاكتشاف الفجوات في حفظ السجلات.
- تصدير جهات الاتصال إلى ملف CSV بانتظام للحفاظ على تحديث قائمة البريد الإلكتروني.
- يمكن لسيرة الذاتية التسويقية بالذكاء الاصطناعي توفير وقتك في كتابة الإعلانات.
- تسجيل الأوزان أسبوعيًا للجراء واستخدام مخطط النمو لاكتشاف المشاكل مبكرًا.
- استخدم
animal_idالمعامل في نماذج الاستفسار لتتبع طلبات الحيوانات المحددة. - استخدم حالة "مشترك" للحيوانات المشتركة بين المربين.