جدول المحتويات
TruePaws — دليل المستخدم الكامل
ما هو TruePaws؟
الجزء 1: المتطلبات المسبقة (ما تحتاجه قبل التثبيت)
1. موقع ووردبريس
- تحتاج إلى موقع ووردبريس مستضاف ذاتيًا (النوع الذي تقوم بتثبيته على استضافتك الخاصة — وليس مدونة مجانية على WordPress.com).
- يجب أن يكون إصدار ووردبريس 5.0 أو أحدث.
2. متطلبات الاستضافة
- PHP 7.4 أو أحدث (معظم المضيفات الحديثة توفر PHP 8.0+).
- قاعدة بيانات MySQL (وهي معيارية مع جميع مضيفات ووردبريس).
- يجب تمكين واجهة برمجة تطبيقات REST لووردبريس (وهي مفعلة افتراضيًا — إلا إذا قام أحدهم بإيقافها عمدًا).
3. اختياري (ولكن موصى به)
- مفتاح Gemini API من جوجل إذا كنت ترغب في استخدام الميزات المدعومة بالذكاء الاصطناعي (نصائح الرعاية، تنبيهات الصحة، إنشاء السيرة التسويقية). يمكنك الحصول على واحد مجانًا من استوديو الذكاء الاصطناعي من جوجل.
- حساب Zapier أو Make إذا كنت ترغب في إرسال إعلامات تلقائية إلى الخدمات الخارجية.
الجزء 2: تثبيت البرنامج المساعد
الخطوة 1 — رفع الإضافة
- قم بتسجيل الدخول إلى لوحة تحكم ووردبريس الخاصة بك (عادةً yourwebsite.com/wp-admin).
- في الشريط الجانبي الأيسر، انتقل إلى الإضافات → إضافة جديد.
- انقر على زر رفع الإضافة في الأعلى.
- انقر على اختيار ملف وحدد ملف truepaws.zip الذي استلمته.
- انقر على تثبيت الآن وانتظر حتى يتم الانتهاء.
الخطوة 2 — تفعيل الإضافة
- بعد اكتمال التثبيت، انقر على زر تفعيل الإضافة.
- ستقوم الإضافة تلقائيًا بإنشاء جميع جداول قاعدة البيانات التي تحتاجها.
- سترى عنصر قائمة TruePaws الجديد يظهر في الشريط الجانبي لووردبريس الخاص بك.
الجزء 3: الإعداد الأولي (افعل هذا أولاً!)
التبويب 1: الإعدادات العامة
| إعداد | ما يفعله | مثال |
|---|---|---|
| النوع الأساسي | نوع الحيوان الذي تقوم بتربيته بشكل أساسي. الخيارات: كلب، قطة، حصان، أرنب، خنزير غينيا، فرو، طائر. | كلب |
| بادئة المربي | رمز قصير (بحد أقصى 5 أحرف) يُستخدم عند التسمية التلقائية للجراء/القطط من الفضلات. | تي بي |
| مدة الحمل — الكلاب | عدد الأيام التي تستمر فيها حمل الكلب. القيمة الافتراضية هي 63. قم بالتغيير فقط إذا كنت تعرف غير ذلك. | 63 |
| مدة الحمل — القطط | عدد الأيام التي تستمر فيها حمل القطة. القيمة الافتراضية هي 65. | 65 |
| تعليمات التغذية | النص الذي سيظهر على وثائق التسليم التي تعطيها للمشترين الجدد. اكتب ما يأكله الحيوان، وعدد المرات، وأي تعليمات خاصة. | "اطعم 3 مرات يوميًا مع طعام الجراء رويال كانين..." |
| مفتاح API Gemini | الصق مفتاح Google Gemini API هنا لتفعيل ميزات الذكاء الاصطناعي. اتركه فارغًا إذا كنت لا تريد ميزات الذكاء الاصطناعي. | (مفتاحك) |
| رابط ويب هوك | إذا كنت تستخدم Zapier أو Make للأتمتة، الصق رابط ويب هوك هنا. اتركه فارغًا في حال عدم الاستخدام. | (رابط ويب هوك الخاص بك) |
التبويب 2: معلومات المربي
| حقل | ما يجب إدخاله |
|---|---|
| اسم المربي | اسمك الكامل كمربي |
| اسم النشاط التجاري | اسم مزرعتك للكلاب أو القطط |
| رقم الترخيص | رقم ترخيص التربية الخاص بك (إذا كان مطبقًا) |
| الهاتف | رقم هاتف نشاطك التجاري |
| البريد الإلكتروني | عنوان بريدك الإلكتروني التجاري |
التبويب 3: السلالات
- يأتي TruePaws مسبقًا مع 20 سلالة كلاب شائعة و20 سلالة قطط شائعة.
- لإضافة سلالة: اكتب اسم السلالة في مربع النص وانقر على إضافة سلالة.
- لإزالة سلالة: انقر على زر الحذف بجوار أي سلالة في القائمة.
التبويب 4: التواصل
| حقل | ما يجب إدخاله |
|---|---|
| عنوان الشارع | عنوان الشارع لمزرعتك |
| المدينة | المدينة |
| الولاية/المقاطعة | الولاية أو المحافظة |
| الرمز البريدي | الرمز البريدي |
| البلد | البلد |
| رابط الاتصال / الاستفسار | رابط صفحة الاتصال بموقعك (يُستخدم كرابط افتراضي على أزرار "الاتصال بالمربي") |
التبويب 5: تقارير المبيعات
- إجمالي الإيرادات المكتسبة
- إجمالي عدد المبيعات
- متوسط سعر البيع
- جدول تفصيلي شهري
- جدول أفضل المشترين
الجزء 4: لوحة التحكم
بطاقات الإحصاءات
- إجمالي الحيوانات - عدد الحيوانات في نظامك
- الولادات النشطة - حالات الحمل التي يتم تتبعها حالياً
- جهات الاتصال - إجمالي المشترين وقوائم الانتظار
- الأحداث القادمة - الأحداث التي تقترب (التطعيمات، مواعيد الولادة، إلخ)
إجراءات سريعة
- إضافة حيوان - الانتقال مباشرة إلى نموذج الحيوان الجديد
- تسجيل التزاوج - تسجيل تزاوج جديد
- إضافة جهة اتصال - إضافة مشتر جديد أو إدخال قائمة انتظار
قائمة التحقق للبدء
أحدث الأحداث
الرسوم البيانية
- توزيع السلالات - مخطط دائري يُظهر عدد الحيوانات لديك من كل سلالة.
- نظرة عامة على المبيعات - مخطط شريطي يُظهر الإيرادات الشهرية.
خريطة النشاط الحراري
الجزء 5: إضافة وإدارة الحيوانات
كيفية إضافة حيوان جديد
- انتقل إلى TruePaws → الحيوانات (أو انقر على "إضافة حيوان" في لوحة التحكم).
- انقر على زر إضافة حيوان جديد.
- املأ النموذج:
| حقل | مطلوب؟ | الوصف |
|---|---|---|
| الاسم | نعم | الاسم المسجل / الرسمي للحيوان |
| اسم النداء | لا | الاسم الذي تناديه به في المنزل |
| رقم التسجيل | لا | رقم التسجيل الرسمي من سجل السلالة الخاص بك |
| رقم الشريحة الإلكترونية | لا | رقم الشريحة الدقيقة (يجب أن يكون فريدًا) |
| السلالة | لا | اختر من قائمة السلالات الخاصة بك |
| الجنس | نعم | ذكر أو أنثى |
| الأب | لا | اختر من الذكور الموجودة في نظامك |
| الأم | لا | اختر من الإناث الموجودة في نظامك |
| تاريخ الميلاد | لا | تاريخ ولادة الحيوان |
| الحالة | لا | نشط، متقاعد، مباع، متوفى، أو مملوك بالمشاركة (الافتراضي هو نشط) |
| اللون/العلامات | لا | صف مظهر الحيوان |
| الوصف | لا | أي ملاحظات إضافية عن الحيوان |
| الصورة المميزة | لا | انقر لفتح مكتبة الوسائط في ووردبريس وتحديد صورة |
- انقر على حفظ الحيوان.
صفحة ملف الحيوان
عرض المعلومات
- اطلع على جميع التفاصيل التي أدخلتها، بالإضافة إلى شارة الحالة (مثل "نشط" باللون الأخضر، "تم البيع" بالأزرق).
- تظهر الصورة المميزة بشكل بارز، مع صورة ظلية احتياطية في حالة عدم تحميل أي صورة.
معرض الصور
- قم بتحميل عدة صور بالنقر على "إضافة صور".
- اسحب وأسقط الصور لإعادة ترتيبها.
- انقر على صورة لتحديدها كصورة مميزة.
- احذف الصور التي لم تعد بحاجة إليها.
الجدول الزمني والأحداث
- انقر على زر "إضافة حدث".
- اختر نوع الحدث:
- ميلاد — سجل ميلاد
- لقاح — تم إعطاء التطعيم
- حرارة — لوحظت دورة الشبق
- تزاوج — حدث تزاوج
- ولادة — أنجبت
- وزن — قياس الوزن
- زيارة بيطرية — موعد بيطري
- ملاحظة — ملاحظة عامة
- أدخل التاريخ وعنوانًا/وصفًا.
- لأحداث الوزن، أدخل قيمة الوزن.
- انقر فوق حفظ.
شجرة النسب
- يعرض شجرة عائلية لـ 3 أجيال تُظهر الآباء والأجداد وأجداد الأجداد.
- هذا يعمل فقط إذا قمت بإدخال علاقات الأبوة لحيواناتك.
- انقر فوق تنزيل شهادة النسب PDF لإنشاء شهادة نسب قابلة للطباعة.
مخطط نمو الوزن
- إذا قمت بتسجيل أحداث الوزن، سيظهر مخطط خطي يوضح وزن الحيوان بمرور الوقت.
- يعرض الوزن الحالي وإجمالي الوزن المكتسب.
ميزات الذكاء الاصطناعي (تتطلب مفتاح Gemini API)
- نصيحة الرعاية بالذكاء الاصطناعي — يولد توصيات رعاية مخصصة بناءً على سلالة الحيوان وعمره وتاريخه. يتم تخزين النتائج مؤقتًا لمدة 30 يومًا.
- السيرة الذاتية للتسويق بالذكاء الاصطناعي — يكتب وصفًا جذابًا لموقعك الإلكتروني أو قوائم الوسائط الاجتماعية.
- تنبيهات الصحة بالذكاء الاصطناعي — يحلل سجل الأحداث ويحدد المشكلات الصحية المحتملة.
بيع حيوان
- في ملف الحيوان، انقر فوق بيع / حجز.
- اختر المشتري من قائمة جهات الاتصال الخاصة بك.
- أدخل تاريخ البيع والسعر.
- أضف أي ملاحظات (اختياري).
- انقر على تأكيد البيع.
- يتغير حالة الحيوان إلى "مباع".
- يمكنك الآن النقر على إنشاء PDF تسليم لإنشاء مستند تسليم احترافي يحتوي على معلومات الحيوان، التاريخ الصحي، معاينة النسب، تعليمات الرعاية، وتفاصيلك كمربي.
نسخ الكود القصير
لم يتم العثور على الحيوان.
. انقر لنسخها. يمكنك لصقها في أي صفحة أو منشور ووردبريس لعرض ملف هذا الحيوان على موقعك العام.الجزء 6: التربية وإدارة الذرية
تسليل تزاوج جديد
- انتقل إلى TruePaws → الفضلات.
- انقر على تسجيل تزاوج جديد.
- املأ النموذج:
| حقل | مطلوب؟ | الوصف |
|---|---|---|
| الأب | نعم | اختر الذكر من بين حيواناتك |
| الأم (الأنثى) | نعم | اختر الأنثى من بين حيواناتك |
| تاريخ التزاوج | نعم | تاريخ حدوث التكاثر |
| الطريقة | لا | تزاوج طبيعي أو تلقيح صناعي (AI) |
| ملاحظات | لا | أي ملاحظات حول التزاوج |
- انقر فوق حفظ.
- يقوم النظام تلقائيًا بحساب تاريخ الولادة المتوقع بناءً على إعدادات مدة الحمل الخاصة بك (الافتراضي: 63 يومًا للكلاب، 65 للقطط).
تتبع الحمل
- شريط تقدم يوضح مدى تقدم الحمل.
- مؤشر الثلث (مبكر / منتصف / متأخر).
- الأيام المتبقية حتى الولادة المتوقعة.
- معالم قادمة مثل:
- الانغراس
- اكتشاف نبض القلب
- نافذة الموجات فوق الصوتية
- الفترة الآمنة للأشعة السينية
- سلوك التعشيش المتوقع
تسجيل الولادة (التوليد)
- انتقل إلى TruePaws → الأنسال.
- ابحث عن السلالة وانقر على "ولادة السلالة".
- يفتح معالج الولادة. اتبع الخطوات:
- أدخل تاريخ الولادة الفعلي.
- أدخل عدد الجراء/القطط الذكور.
- أدخل عدد الجراء/القطط الإناث.
- قم بمعاينة الأسماء المولدة تلقائياً (مثل "TP24AB جرو 1"، "TP24AB جرو 2").
- راجع الملخص.
- انقر على "إرسال".
- قم بإنشاء سجلات فردية لكل جرو/قطة.
- قم بتعيين والديهم (الأب والأم) تلقائياً.
- سجل حدث "ولادة" على كل واحد.
- قم بتعيينهم جميعاً إلى حالة "نشط".
- تعيين أسماء مًولدة تلقائياً باستخدام بادئة المربي الخاصة بك.
الجزء 7: إدارة جهات الاتصال (المشترون وقائمة الانتظار)
إضافة جهة اتصال
- انتقل إلى TruePaws → جهات الاتصال.
- انقر على إضافة جهة اتصال جديدة.
- املأ النموذج:
| حقل | مطلوب؟ | الوصف |
|---|---|---|
| الاسم الأول | نعم | الاسم الأول للمشتري |
| الاسم الأخير | لا | اسم العائلة للمشتري |
| البريد الإلكتروني | نعم | عنوان البريد الإلكتروني للمشتري |
| الهاتف | لا | رقم الهاتف |
| العنوان | لا | عنوان البريد |
| الحالة | لا | قائمة الانتظار، محجوز، مشتري، أو غير نشط |
| ملاحظات | لا | أي ملاحظات خاصة حول هذا الاتصال |
- انقر على حفظ جهة الاتصال.
ميزات قائمة الاتصال
- تصفية حسب الحالة — استخدم القائمة المنسدلة لعرض جهات الاتصال الموجودة في قائمة الانتظار، المحجوزة، المشترين، أو غير النشطة فقط.
- تصدير إلى CSV — انقر على زر التصدير لتنزيل جميع جهات الاتصال كملف جدول بيانات. هذا مفيد لاستيرادها إلى أدوات التسويق عبر البريد الإلكتروني مثل Mailchimp.
صفحة ملف الاتصال
- معلومات جهة الاتصال والعنوان.
- استفسر عن — يُظهر الحيوانات التي استفسر عنها هذا الشخص (من استمارة الاستفسار على موقعك الإلكتروني).
- الحيوانات المشتراة — تُدرج جميع الحيوانات التي بعتها لهذا الشخص.
- أزرار إجراء سريع لإرسال بريد إلكتروني، الاتصال، أو عرض الحيوانات المتاحة.
الجزء 8: عرض الحيوانات على موقعك الإلكتروني (رموز قصيرة)
1. عرض حيوان واحد
معرف حيوان غير صالح.
معرف حيوان غير صالح.
<code>
معرف حيوان غير صالح.
</code>
| معامل | ما يفعله | افتراضي |
|---|---|---|
| رابط_الاتصال="https://…" | رابط مخصص لزر "الاتصال بالمربي" | رابط إعداداتك |
| عرض_الذكاء_الاصطناعي="true" أو "false" | إظهار أو إخفاء معلومات رعاية الذكاء الاصطناعي | صحيح |
| عرض_شجرة_الأنساب="true" أو "false" | إظهار أو إخفاء شجرة الأنساب | صحيح |
| show_inquiry_form=”true” أو “false” | تضمين نموذج استفسار أسفل الحيوان | خطأ |
| show_gallery=”true” أو “false” | إظهار أو إخفاء معرض الصور | صحيح |
| gallery_columns=”3” | عدد الأعمدة للمعرض (من 2 إلى 6) | 4 |
معرف حيوان غير صالح.
معرف حيوان غير صالح.
2. عرض البطن
معرف غير صحيح للفرد.
معرف غير صحيح للفرد.
3. عرض جميع الجراء/القطط المتاحة
| معامل | ما يفعله | افتراضي |
|---|---|---|
| limit=”6” | الحد الأقصى لعدد الحيوانات لعرضها | 12 |
| breed=”Golden Retriever” | عرض الحيوانات من هذا الصنف فقط | (جميع الأصناف) |
| show_images=”true” أو “false” | إظهار أو إخفاء الصور | صحيح |
4. عرض نموذج الاستفسار
| معامل | ما يفعله | افتراضي |
|---|---|---|
| معرف_الحيوان="123" | ربط الاستفسار بحيوان معين | (لا شيء) |
| عنوان="مهتم؟ تواصل معنا!" | عنوان النموذج المخصص | "إرسال استفسار" |
- الاسم الأول (مطلوب)
- الاسم الأخير
- البريد الإلكتروني (مطلوب)
- الهاتف
- الرسالة (مطلوبة)
الجزء 9: مستندات PDF
1. شهادة النسب
- يتم إنشاؤه من صفحة الملف الشخصي لأي حيوان عن طريق النقر على تحميل PDF شجرة النسب.
- يحتوي على اسم الحيوان ورقم التسريب ورقم الشريحة الدقيقة والسلالة والجنس وتاريخ الميلاد وشجرة النسب لثلاثة أجيال.
- يتضمن اسم المربي وتاريخ الجيل.
2. حزمة التسليم
- يتم إنشاؤه من ملف حيوان تم بيعه عن طريق النقر على إنشاء PDF التسليم.
- يحتوي على:
- تفاصيل الحيوان (الاسم، السلالة، الجنس، تاريخ الميلاد، التسجيل، الشريحة الدقيقة، الأبوين)
- معاينة شجرة النسب
- سجل صحي كامل (اللقاحات، زيارات الطبيب البيطري، إلخ.)
- تعليمات التغذية/ الرعاية الخاصة بك (من الإعدادات)
- توصيات عامة للرعاية
- قسم العقد والشروط
- معلومات المربي في التذييل
الجزء 10: إشعارات البريد الإلكتروني الآلية
تذكيرات الولادة
- يتم إرساله قبل 7 أيام من تاريخ الولادة المتوقع.
- يتضمن البريد الإلكتروني اسم العائلة والتاريخ المتوقع وأسماء الأبوين.
تذكيرات التطعيم
- يتحقق تلقائيًا من جميع الحيوانات النشطة ويذكرك عندما تبلغ أعمارًا مهمة للتطعيم:
- 6 أسابيع — موعد التطعيم الأول
- 9 أسابيع — موعد التطعيم الثاني
- 12 أسبوعًا — موعد التطعيم الثالث
- 16 أسبوعًا — موعد التطعيم النهائي للجرو
- سنة واحدة — موعد الجرعة المعززة السنوية
- سنتان — موعد الفحص الصحي كل سنتين
- 3 سنوات — موعد الفحص الصحي كل ثلاث سنوات
الجزء 11: سير العمل الموصى به (خطوة بخطوة)
الإعداد الأولي
- قم بتثبيت وتشغيل الإضافة.
- اذهب إلى الإعدادات واملأ جميع الأقسام (عام، معلومات المربي، السلالات، الاتصالات).
- أضف سلالاتك المخصصة إذا لم تغطي السلالات الافتراضية كل ما تحتاجه.
بناء قاعدة البيانات الخاصة بك
- أضف أولاً جميع حيوانات التربية البالغة لديك (الذكور والإناث).
- قم برفع الصور وملء أرقام التسجيل ومعرفات الشريحة الدقيقة لكل حيوان.
- حدد علاقات الوالدين حيثما عرفت (هذا يبني أشجار النسب الخاصة بك).
- أضف الأحداث التاريخية (التطعيمات السابقة، زيارات الطبيب البيطري) لبناء الجدول الزمني لكل حيوان.
الاستخدام اليومي
- عند حدوث التزاوج، انتقل إلى الفضلات → تسجيل تزاوج جديد.
- تتبع الحمل باستخدام بطاقات متتبّع الحمل في صفحة الفضلات.
- عند ولادة الجراء/القطط، استخدم مساعد الولادة.
- حدث ملف كل جرو بصوره ولقاحاته وفحوصات الوزن أثناء نموهم.
- أضف المشترين وجهات الاتصال لقائمة الانتظار مع تلقيك الاستفسارات.
البيع
- عند بيع جرو، افتح ملفه الشخصي → انقر على بيع/حجز → صل جهة اتصال المشتري.
- قم بإنشاء ملف PDF للتسليم لتعطيه إلى المالك الجديد.
- تحقق من تقارير مبيعاتك في الإعدادات لتتبع الإيرادات.
موقع عام
- أنشئ صفحة باسم "جراء متاحة" وأضف .
- قم بإنشاء صفحات فردية للحيوانات الخاصة باستخدام معرف حيوان غير صالح..
- أضف إلى صفحة الاتصال الخاصة بك حتى يتمكن الزوار من التواصل معك.
- مشاركة صفحات الأفراد باستخدام معرف غير صحيح للفرد..
الجزء 12: نصائح وحيل
- استخدم خريطة الأنشطة الحرارية في لوحة التحكم لاكتشاف الفجوات في تسجيلك — قد تعني الفترة الهادئة أنك نسيت تسجيل الأحداث.
- قم بتصدير جهات الاتصال بانتظام إلى ملف CSV واستيرادها إلى Mailchimp أو ما شابه ذلك للحفاظ على قائمة البريد الإلكتروني محدثة.
- يمكن أن يوفر لك السيرة الذكية التسويقية الوقت في كتابة القوائم — قم بإنشاء سيرة ذاتية، ومراجعتها، ولصقها في موقعك أو وسائل التواصل الاجتماعي.
- تتبع الوزن مهم بشكل خاص للجراء — سجل الأوزان أسبوعيًا واستخدم مخطط النمو لاكتشاف أي جراء قد تحتاج إلى عناية إضافية.
- تتيح لك كود النموذج الاستفساري مع معلمة animal_id إنشاء أزرار استفسار خاصة بالحيوان، بحيث تعرف بالضبط عن أي حيوان يسأل كل شخص.
- حالة المشاركة مفيدة للحيوانات المشتركة بين المربين — حيث تبقى مرئية في نظامك ولكنها محددة بوضوح.