سبب تعطل الكود الخاص بك هو تعارض أساسي في الطباعة. غالبًا ما تولد أدوات الذكاء الاصطناعي ومعالجات النصوص "علامات اقتباس ذكية" (علامات اقتباس منحنية مثل “ و ”). تتطلب أكواد ووردبريس القصيرة ولغات البرمجة الأساسية بشكل صارم "علامات اقتباس مستقيمة" (مثل " و '). عندما يرى جوتنبرج علامات اقتباس منحنية داخل قوس الكود القصير، يفشل في تحليلها ككود ويتسبب في تعطل العرض.
علاوة على ذلك، فإن النسخ واللصق الخاص بك دمر تمامًا الجداول في الوثائق، مما جعلها كتل نصية غير قابلة للقراءة. النسخ واللصق للنص الخام بشكل أعمى يقلل من جودة البيانات الهيكلية.
لقد قمت بتنظيف النص الخاص بك. قمت بتحويل كل الطباعة إلى علامات اقتباس مستقيمة، ولفت أكوادك القصيرة بتنسيق الكود حتى لا يحاول جوتنبرج تنفيذها، وأعدت بناء الجداول المدمرة إلى تنسيق Markdown الصحيح. إذا قمت بلصق هذا مباشرة في جوتنبرج، يجب أن يولد تلقائيًا العناوين والجداول وكتل الكود الصحيحة.
إليك النسخة الهيكلية السليمة:
TruePaws — دليل المستخدم الكامل
ما هو TruePaws؟
TruePaws هو نظام إدارة تربية الكلاب يعمل داخل موقع ووردبريس الخاص بك. يساعد المربين المحترفين في إدارة حيواناتهم، وتتبع التربية والحمل، والتعامل مع جهات الاتصال المشترين، وإنشاء المستندات الرسمية (مثل شهادات النسب وحزم التسليم)، وحتى عرض الجراء/القطط المتاحة على موقعك العام.
الجزء 1: المتطلبات الأساسية (ما تحتاجه قبل التثبيت)
1. موقع ووردبريس
- تحتاج إلى موقع WordPress مستضاف ذاتيًا (النوع الذي تقوم بتثبيته على استضافتك الخاصة — وليس مدونة مجانية على WordPress.com).
- يتطلب إصدار WordPress 5.0 أو أحدث.
2. متطلبات الاستضافة
- PHP 7.4 أو أحدث (معظم المضيفات الحديثة توفر PHP 8.0+).
- قاعدة بيانات MySQL (معيارية مع جميع مضيفات WordPress).
- يجب تمكين واجهة برمجة تطبيقات REST لـ WordPress (هي مفعلة افتراضيًا — إلا إذا قام شخص ما بإيقافها عمدًا).
3. اختياري (ولكن موصى به)
- مفتاح واجهة برمجة تطبيقات Google Gemini إذا كنت ترغب في استخدام الميزات المدعومة بالذكاء الاصطناعي (نصائح الرعاية، تنبيهات الصحة، إنشاء السيرة الذاتية التسويقية). يمكنك الحصول على واحد مجانًا من Google AI Studio.
- حساب Zapier أو Make إذا كنت ترغب في إرسال إشعارات آلية إلى خدمات خارجية.
الجزء 2: تثبيت الإضافة
الخطوة 1 – تحميل الإضافة
- قم بتسجيل الدخول إلى لوحة تحكم إدارة WordPress الخاصة بك (عادةً
yourwebsite.com/wp-admin). - في الشريط الجانبي الأيسر، انتقل إلى الإضافات → إضافة جديدة.
- انقر على رفع الإضافة زر في الأعلى.
- انقر اختر ملف وحدد
truepaws.zipالملف الذي استلمته. - انقر تثبيت الآن وانتظر حتى ينتهي.
الخطوة 2 – تفعيل الإضافة
- بعد اكتمال التثبيت، انقر على تفعيل الإضافة الزر.
- ستقوم الإضافة تلقائيًا بإنشاء جميع جداول قاعدة البيانات التي تحتاجها.
- سترى عنصر قائمة جديد TruePaws يظهر في الشريط الجانبي لووردبريس الخاص بك.
الجزء 3: الإعداد الأولي (افعل هذا أولاً!)
بعد التفعيل، انتقل إلى TruePaws → الإعدادات في الشريط الجانبي لووردبريس الخاص بك. سترى عدة علامات تبويب في الأعلى. اعمل على كل واحدة منها.
التبويب 1: الإعدادات العامة
| الإعدادات | ما يفعله | مثال |
| النوع الافتراضي | نوع الحيوان الذي تقوم بتربيته بشكل أساسي. الخيارات: كلب، قطة، حصان، أرنب، خنزير غينيا، ابن عرس، طائر. | كلب |
| بادئة المربي | رمز قصير (بحد أقصى 5 أحرف) يستخدم عند تسمية الجراء/القطط تلقائيًا من الفضلات. | TP |
| مدة الحمل — الكلاب | عدد الأيام التي يستغرقها حمل الكلب. الافتراضي هو 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. شهادة النسب
يتم إنشاؤها من صفحة ملف أي حيوان. تحتوي على اسم الحيوان، تفاصيل التسجيل، شجرة نسب من 3 أجيال، واسم المربي.
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المعامل في استمارات الاستفسار لتتبع طلبات حيوانات محددة. - استخدم حالة "مشترك الملكية" للحيوانات المشتركة بين المربين.