التوثيق
من أول موكل إلى ملف DATEV.
دليل عملي لإضافة Albertoit Law Office Manager: التثبيت، الموكلون والقضايا، تتبع الوقت، الفواتير، تصدير DATEV وحماية البيانات — خطوة بخطوة.
- بلا خدمات خارجية
- البيانات تبقى محلية
- DATEV اختياري
المحتويات
الخطوات الأولى
جاهز للاستخدام في 15 دقيقة.
خمس خطوات من تثبيت ووردبريس الفارغ إلى أول فاتورة. الترتيب توصية فقط — يمكنك العودة إلى أي خطوة لاحقاً.
- 1
تثبيت الإضافة
انتقل إلى الإضافات → إضافة جديد وابحث عن «Albertoit Law Office Manager». بدلاً من ذلك، ارفع ملف ZIP عبر رفع إضافة. بعد التفعيل تظهر قائمة AIT Law Clients في الشريط الجانبي.
- 2
مراجعة الإعدادات
ضمن AIT Law Clients → الإعدادات، حدّد بادئة رقم القضية والأجر الساعي الافتراضي والعملة. فعّل DATEV فقط إذا كان مستشارك الضريبي يدعم الاستيراد.
- 3
إضافة موكل
AIT Law Clients → الموكلون → إضافة موكل جديد: فرد أو شركة، بيانات الاتصال والعنوان والملاحظات. تُنشئ الإضافة رقم الموكل تلقائياً (CLI-0001).
- 4
فتح قضية
AIT Law Clients → القضايا → إضافة قضية جديدة: الموكل والعنوان ونوع القضية والحالة. يمكن حفظ المحكمة والخصم ورقم الملف وتاريخ التقادم مباشرة في القضية.
- 5
تسجيل الوقت والفوترة
AIT Law Clients → الوقت → إضافة قيد وقت أو ابدأ المؤقت المباشر. ضمن الفواتير → فاتورة جديدة، اختر الأعمال القابلة للفوترة وأنشئ الفاتورة.
أنشئ موكلاً تجريبياً وقضية تجريبية أولاً. يتيح لك ذلك اختبار تتبع الوقت والفوترة وتصدير DATEV دون لمس بيانات الموكلين الحقيقية.
ما تحتاج إليه
- ووردبريس 6.2 أو أحدث
- PHP 7.4 أو أحدث
- صلاحية مدير للتثبيت
- HTTPS ونسخ احتياطي منتظم
بعد التفعيل
- قائمة AIT Law Clients في الشريط الجانبي
- جداول قاعدة بيانات تحتوي أسماءها على
ait_lmgmt_ - صلاحية
manage_ait_lmgmtللمديرين - قيم افتراضية للترقيم والأجر والعملة
التثبيت
ثبّت، فعّل، واضبط الوصول.
يعمل مدير مكتب المحاماة بالكامل داخل تثبيت ووردبريس. لا يوجد حساب خارجي ولا اتصال سحابي.
من دليل الإضافات
افتح الإضافات → إضافة جديد، وابحث عن «Albertoit Law Office Manager»، ثم اضغط تثبيت الآن وبعدها تفعيل.
من ملف ZIP
نزّل ملف ZIP الحالي من WordPress.org. انتقل إلى الإضافات → إضافة جديد → رفع إضافة، واختر الملف، ثم اضغط تثبيت الآن وتفعيل.
بعد التفعيل
- تظهر قائمة AIT Law Clients في شريط ووردبريس الجانبي.
- تُنشئ الإضافة جداولها بالبادئة
ait_lmgmt_. - يحصل المديرون على صلاحية
manage_ait_lmgmt. - تُملأ قيم الأجر والعملة وبادئة رقم القضية مسبقاً.
لا يحصل على الصلاحية تلقائياً سوى المديرين. إذا احتاج مستخدم آخر إلى الوصول، امنحه manage_ait_lmgmt عن قصد عبر إضافة لإدارة الأدوار. لا تتضمن الإضافة محرر أدوار خاصاً بها.
// مثال: إضافة الصلاحية إلى دور موجود.
$role = get_role( 'editor' );
$role->add_cap( 'manage_ait_lmgmt' );
حذف الإضافة يحتفظ بجميع البيانات والجداول افتراضياً. فقط عند ضبط AIT_LMGMT_DELETE_DATA_ON_UNINSTALL على true في wp-config.php تحذف أداة إلغاء التثبيت الجداول والخيارات. لا يُحذف المجلد wp-content/uploads/ait-lmgmt-private تلقائياً — احتفظ بنسخة منه أو احذفه بشكل منفصل.
الموكلون والقضايا
جميع الأطراف وكل قضية في مكان واحد.
الموكلون
الموكل إما فرد أو شركة. يُسجّل الاسم والبريد الإلكتروني والهاتف والعنوان والملاحظات وحالة نشط أو غير نشط. تُنشئ الإضافة رقم الموكل تلقائياً بصيغة CLI-0001 ولا يمكن تعديله.
- البحث بالاسم أو رقم الموكل أو البريد الإلكتروني
- تصدير قائمة الموكلين كاملة بصيغة CSV
- سجل النشاط لآخر 30 حدثاً
- تصدير بيانات الموكل بصيغة JSON وإخفاء الهوية مباشرة من شاشة الموكل
القضايا
تنتمي القضية دائماً إلى موكل واحد وتجمع عمل الملف الفعلي. إلى جانب العنوان ونوع القضية (نص حر) والحالة مفتوحة أو قيد الانتظار أو مغلقة، تحفظ القضية التفاصيل القانونية:
الأطراف والمحكمة
- الخصم
- محامي الخصم
- المحكمة
- رقم الملف / رقم القضية
التواريخ والسجل
- تاريخ الفتح والإغلاق
- تاريخ التقادم
- مستندات القضية
- مواعيد القضية
أرقام القضايا
تحصل القضايا الجديدة على رقم بصيغة PREFIX-YEAR-0001، وافتراضياً AIT-2026-0001. غيّر البادئة من الإعدادات: حتى خمسة أحرف أو أرقام، بأحرف كبيرة. يؤثر التغيير في القضايا الجديدة فقط؛ الأرقام الحالية تبقى كما هي.
المستندات
يمكن إرفاق ملفات سرية بقضية. تُخزّن خارج مكتبة الوسائط العامة ولا يمكن تنزيلها إلا للمستخدمين المصرح لهم. راجع المستندات والخصوصية للتفاصيل وأنواع الملفات المسموحة.
يمكن البحث في قائمة القضايا برقم القضية أو العنوان وتصديرها كاملة بصيغة CSV. هذا مفيد للتسليم والمراجعة والتقارير الخاصة بك.
المواعيد النهائية
لا تفوت أي موعد نهائي.
تنتمي المواعيد النهائية إلى قضية وتظهر أيضاً في لوحة المعلومات. تُبرز المواعيد المفتوحة المتأخرة، وتبقى المواعيد المنجزة في سجل القضية.
أنواع المواعيد
| نوع الموعد | الاستخدام المعتاد |
|---|---|
| تقديم / موعد المحكمة | طلبات التقاضي والمواعيد الإجرائية |
| جلسة / محاكمة | جلسات المحكمة والمرافعات |
| تاريخ المحاكمة | تاريخ الجلسة الرئيسية |
| التقادم | انتهاء مدة تقادم المطالبة |
| عقد / موعد رد | مواعيد تعاقدية أو مرتبطة بالمراسلة |
| موعد الاستئناف | الموعد المحدد لتقديم الطعن |
| موعد Discovery | الموعد المحدد للإفصاح عن الأدلة |
| اجتماع مع الموكل | مواعيد الاجتماعات مع الموكل |
| أخرى | موعد دون تصنيف محدد |
لوحة المعلومات والإنجاز
تعرض لوحة المعلومات المواعيد القادمة وتشير إلى المتأخرة. يمكن تعليم الموعد كمنجز بنقرة واحدة؛ فيخرج من قائمة المفتوحة لكنه يبقى موثقاً في القضية.
تُذكّر الإضافة وتوثّق، لكنها لا تحسب المواعيد القانونية ولا تتحقق من تمديدها. تبقى مسؤولية الالتزام بالمواعيد والمراجعة القانونية على المكتب.
الوقت والفواتير
من الساعة إلى الفاتورة.
قيود الوقت
ينتمي قيد الوقت دائماً إلى قضية ويحتوي على التاريخ والساعات والأجر الساعي وعلامة الفوترة والوصف. يُملأ الأجر مسبقاً من الإعدادات ويمكن تغييره لكل قيد.
- قابل للفوترة: يمكن ربط القيد لاحقاً بفاتورة.
- غير قابل للفوترة: يبقى القيد في السجل لكنه لا يظهر في اختيار الفاتورة.
- مفوتر مسبقاً: القيود المرتبطة بفاتورة لا تُعرض مرة أخرى.
المؤقت المباشر
يعمل المؤقت على الخادم لكل مستخدم، وليس في تبويب المتصفح. يمكنك إغلاق الصفحة والمتابعة لاحقاً. عند الإيقاف يُنشأ قيد وقت عادي؛ وتجاهل يحذف الوقت الجاري دون قيد. تُقرّب المدة إلى منزلتين عشريتين.
لكل مستخدم مؤقته الخاص. لا يعطّل مؤقت مستخدم آخر ولا قضية أخرى.
إنشاء فاتورة
- 1
اختيار الموكل والتواريخ
الفواتير → فاتورة جديدة: اختر الموكل وتاريخ الفاتورة وتاريخ الاستحقاق الاختياري.
- 2
اختيار الأعمال القابلة للفوترة
تُعرض جميع قيود الوقت القابلة للفوترة وغير المفوترة لهذا الموكل — بما في ذلك القيود من قضايا مختلفة.
- 3
إضافة البنود
يمكن إضافة بنود يدوية ومصاريف (disbursements) فوق الوقت المحدد.
- 4
الضريبة والدفع
أدخل معدل الضريبة بالنسبة المئوية (مثلاً 19 لضريبة القيمة المضافة الألمانية، أو 0 لعدم وجود ضريبة) والمبلغ المدفوع. يُحسب الرصيد المتبقي تلقائياً.
- 5
الحفظ والإخراج
احفظ الفاتورة، واضبط حالتها على غير مدفوعة أو مدفوعة، ثم استخدم طباعة / حفظ PDF لفتح عرض الطباعة.
يُمنح رقم الفاتورة تلقائياً بصيغة INV-2026-0001. يتم إخراج PDF عبر نافذة طباعة المتصفح («حفظ كملف PDF»)؛ ولا يُنشأ ملف PDF على الخادم. عند حذف فاتورة تُحرَّر قيود الوقت المرتبطة بها لفاتورة جديدة.
جديد في الإصدار 1.5.6
تصدير DATEV لمستشارك الضريبي.
منذ الإصدار 1.5.6، يمكن لمدير مكتب المحاماة تصدير الفواتير كدفعة قيود DATEV بصيغة EXTF 700. ملف CSV مخصص للاستيراد من قبل مستشارك الضريبي في ألمانيا.
تصدير DATEV مهم فقط إذا كانت محاسبتك تعمل بنظام DATEV في ألمانيا. يمكنك تفعيله وتعطيله في أي وقت من الإعدادات.
خمس خطوات إلى ملف DATEV
- 1
تفعيل DATEV
AIT Law Clients → الإعدادات → تصدير DATEV: ضع علامة على «تفعيل تصدير DATEV» واحفظ.
- 2
إدخال البيانات الأساسية
أدخل رقم المستشار ورقم الموكل وحساب الإيرادات وأساس حساب المدينين ومفتاح الضريبة واسم الدفعة ونص القيد.
- 3
مراجعة الفواتير
تُصدَّر فقط الفواتير ذات الإجمالي الموجب. تُضمَّن الفواتير المدفوعة والمفتوحة معاً؛ ولا تؤثر حالة الدفع في دفعة القيود.
- 4
اختيار الفترة
ضمن الفواتير، اضغط تصدير DATEV واختر تاريخ البداية والنهاية. يجب أن تقع الفترة ضمن سنة مالية واحدة.
- 5
استيراد الملف
سلّم الملف
EXTF_Buchungsstapel_YYYY-MM-DD_YYYY-MM-DD.csvإلى مستشارك الضريبي. اختبر الاستيراد على نسخة من الدفاتر أولاً.
حقول DATEV
| الحقل | المعنى | الافتراضي / الحد |
|---|---|---|
| رقم المستشار | رقم المستشار الضريبي | 1، حتى 7 أرقام |
| رقم الموكل | رقم الموكل لدى مكتب الضرائب | 1، حتى 5 أرقام |
| حساب الإيرادات | الحساب المقابل للإيراد | 4300، حتى 8 أرقام |
| أساس المدينين | الرقم الأساسي للمدينين؛ الحساب = الأساس + معرف الموكل | 10000، حتى 8 أرقام |
| مفتاح الضريبة | مفتاح القيد للمعالجة الضريبية | 9، حتى 4 أرقام |
| اسم الدفعة | اسم دفعة القيود | Buchungsstapel، حتى 30 حرفاً |
| نص القيد | نص سطر القيد؛ العناصر النائبة {number} و{client} |
Rechnung {number}، حتى 120 حرفاً |
الصيغة التقنية
- دفعة قيود EXTF، إصدار الصيغة 700
- CSV بفاصلة منقوطة، بترميز CP1252 وفاصلة عشرية
- سطر قيد واحد لكل فاتورة: حساب المدين (الأساس + معرف الموكل) مقابل حساب الإيرادات
- ترويسة تحتوي بيانات المستشار والموكل والسنة المالية والفترة واسم الدفعة
- يُسجّل التصدير في سجل النشاط
التصدير ليس تدقيقاً محاسبياً أو ضريبياً وليس معتمداً من DATEV. تحقق من معدلات الضريبة وحسابات الإيرادات وأرقام المدينين والاستيراد مع مستشارك الضريبي. تُتجاهل الفواتير ذات الإجمالي السالب أو الصفري؛ والإشعارات الدائنة ليست جزءاً من الدفعة.
المستندات والخصوصية
السرية تبقى سرية.
مستندات القضية الخاصة
تُرفق المستندات بقضية وتُخزّن في المجلد المحمي wp-content/uploads/ait-lmgmt-private — وليس في مكتبة الوسائط العامة. يتطلب التنزيل صلاحية الإضافة ورمز nonce صالحاً.
| أنواع الملفات المسموحة | الامتدادات |
|---|---|
.pdf |
|
| الصور | .jpg، .jpeg، .png |
| Word | .doc، .docx |
| Excel | .xls، .xlsx |
| نص | .txt |
مدة الاحتفاظ
ضمن الخصوصية والامتثال، اضبط مدة الاحتفاظ من سنة إلى 100 سنة؛ الافتراضي 10 سنوات. تحصل القضايا الأقدم من المدة على علامة مراجعة. لا يُحذف أي شيء تلقائياً.
حقوق أصحاب البيانات
- تصدير البيانات: تنزيل جميع بيانات موكل واحد كملف JSON.
- إخفاء الهوية: إزالة البيانات الشخصية مع الاحتفاظ بالفواتير وقيود الوقت وسجل التدقيق.
- الحذف النهائي: إزالة الموكل مع القضايا وقيود الوقت والمواعيد والفواتير والمستندات المرتبطة — بعد تأكيد صريح فقط.
النسخ الاحتياطي وملكية البيانات
تقع جميع البيانات في قاعدة بيانات ووردبريس ضمن جداول تحتوي أسماءها على ait_lmgmt_. لا توجد استدعاءات API خارجية أو نصوص تتبع أو نقل بيانات إلى أطراف ثالثة. احتفظ بنسخة من قاعدة البيانات و مجلد ait-lmgmt-private؛ فبدون المجلد ستُفقد المرفقات بعد الاستعادة.
توفر الإضافة مكوّنات للخصوصية والتوثيق، لكنها ليست استشارة قانونية. تبقى مسؤولية المعالجة القانونية والاحتفاظ والالتزامات المهنية على المكتب.
مرجع
الإعدادات والقيم الافتراضية.
تجد الخيارات الرئيسية ضمن AIT Law Clients → الإعدادات. تنطبق التغييرات على السجلات الجديدة؛ الأرقام والفواتير الحالية تبقى كما هي.
| الإعداد | الافتراضي | ملاحظة |
|---|---|---|
| بادئة رقم القضية | AIT |
حتى 5 أحرف/أرقام، للقضايا الجديدة فقط |
| الأجر الساعي الافتراضي | 0.00 |
يُملأ مسبقاً في قيود الوقت الجديدة |
| رمز العملة | USD |
مثلاً EUR؛ لا تحويل بين العملات |
| رمز العملة المعروض | $ |
يظهر في القوائم والفواتير وPDF |
| مدة الاحتفاظ | 10 سنوات |
1–100 سنة، ضمن الخصوصية والامتثال |
| DATEV مفعّل | متوقف | يُظهر زر التصدير وإعدادات DATEV |
لا تحوّل الإضافة بين العملات. تستخدم الفاتورة العملة المخزنة عند إنشائها. غيّر العملة فقط عندما تريد المتابعة بعملة أخرى عن قصد.
خذ بياناتك معك
CSV واللغة وملكية البيانات.
تصدير CSV
توفّر قوائم الموكلين والقضايا والوقت والمواعيد النهائية والفواتير تصديراً بصيغة CSV. الملفات بترميز UTF-8 مع BOM وتفتح في Excel دون رموز مشوّهة.
- أسماء ملفات مثل
albertoit-clients-2026-10-06.csv - القائمة الكاملة، وليس نتائج البحث الحالية فقط
- مناسبة للتسليم والمراجعة والتقارير الخاصة بك
اللغة
لغة مصدر الإضافة هي الإنجليزية وهي قابلة للترجمة بالكامل. يتضمن القالب POT؛ وتُقدَّم ترجمات المجتمع عبر translate.wordpress.org حيث تتوفر. منذ الإصدار 1.5.5 لم تعد ملفات .po/.mo مرفقة.
ملكية البيانات
- لا خدمات أو واجهات API أو SDKs أو نصوص تتبع خارجية
- لا ملفات موكلين عامة أو مسارات REST
- جميع البيانات في قاعدة بيانات ووردبريس الخاصة بك
- تحكم كامل في النسخ الاحتياطي والوصول والاحتفاظ
للمطورين
الخطافات والصلاحيات والتوسعة.
توفر الإضافة ثلاث نقاط توسعة. يمكن للإضافات الإضافية التكامل دون تعديل قلب الإضافة.
| الخطاف | النوع | الغرض |
|---|---|---|
ait_lmgmt_loaded |
Action | يعمل بعد اكتمال تهيئة الإضافة؛ يمرر نسخة الإضافة مع repository وaudit وuploads. |
ait_lmgmt_admin_menu |
Action | يعمل أثناء تسجيل القائمة؛ يمرر الصلاحية المطلوبة للصفحات الفرعية المخصصة. |
ait_lmgmt_is_pro |
Filter | يتحكم في ظهور تنبيه «Pro». يمكن لإضافة نشطة إرجاع true. |
add_action( 'ait_lmgmt_loaded', function ( $plugin ) {
// $plugin->repo, $plugin->audit, $plugin->uploads
} );
add_action( 'ait_lmgmt_admin_menu', function ( $cap ) {
add_submenu_page(
'ait-lmgmt',
'My add-on',
'My add-on',
$cap,
'my-addon',
'my_addon_render'
);
} );
add_filter( 'ait_lmgmt_is_pro', '__return_true' );
الصلاحية لجميع شاشات الإضافة هي manage_ait_lmgmt. للوصول المخصص إلى البيانات، استخدم repository الخاص بنسخة الإضافة؛ استعلامات قاعدة البيانات المباشرة تتجاوز الفحوصات الحالية ولا يُنصح بها.
لا تسجّل الإضافة اختصارات أو مسارات REST عامة أو أنواع محتوى مخصصة لبيانات الموكلين والقضايا. هذا قرار خصوصية متعمد.
استكشاف الأخطاء
أسئلة شائعة وحلول سريعة.
أين تُخزَّن بياناتي؟
في قاعدة بيانات ووردبريس الخاصة بك، ضمن جداول تحتوي أسماءها على ait_lmgmt_. تقع المرفقات في المجلد المحمي wp-content/uploads/ait-lmgmt-private. لا تُرسل أي بيانات إلى خوادم خارجية.
لماذا لا أرى قائمة AIT Law Clients؟
لا يملك مستخدمك صلاحية manage_ait_lmgmt. يحصل المديرون عليها عند التفعيل. للأدوار الأخرى، امنح الصلاحية عن قصد عبر إضافة لإدارة الأدوار.
هل يمكنني فوترة أعمال عدة موكلين في فاتورة واحدة؟
لا. تنتمي الفاتورة إلى موكل واحد فقط. لكن يمكنك اختيار وقت قابل للفوترة من عدة قضايا تابعة لذلك الموكل.
هل تُنشئ الإضافة ملف PDF حقيقياً؟
يتم الإخراج عبر عرض طباعة. في المتصفح اختر «طباعة» ثم «حفظ كملف PDF». لا يُخزَّن ملف PDF على الخادم.
هل تُحذف البيانات عند حذف الإضافة؟
لا افتراضياً. يُحتفظ بالبيانات والجداول. للإزالة الكاملة، اضبط AIT_LMGMT_DELETE_DATA_ON_UNINSTALL على true في wp-config.php واحذف مجلد ait-lmgmt-private بشكل منفصل.
لماذا لا يظهر زر تصدير DATEV؟
التصدير متوقف افتراضياً. فعّله من الإعدادات → تصدير DATEV. ويحتاج مستخدمك أيضاً إلى صلاحية الإضافة.
هل يمكنني تعديل فاتورة لاحقاً؟
نعم. يمكن تعديل معدل الضريبة وحالة الدفع والبنود. يبقى رقم الفاتورة دون تغيير. عند حذف فاتورة تُحرَّر قيود الوقت المرتبطة بها لفاتورة جديدة.
هل المستندات المرفقة متاحة للعامة؟
لا. تُخزَّن خارج مكتبة الوسائط وتُسلَّم فقط عبر تنزيل محمي بـ nonce ويتطلب صلاحية الإضافة.
هل تعمل الإضافة مع أي قالب؟
تعمل الإدارة بالكامل داخل لوحة تحكم ووردبريس ومستقلة عن قالب الواجهة. لا تُنشئ الإضافة صفحات أو قوالب عامة.
ما اللغات التي تدعمها الواجهة؟
لغة المصدر هي الإنجليزية والإضافة قابلة للترجمة بالكامل. تُقدَّم الترجمات عبر WordPress.org حيث وفّرها المجتمع.
ملاحظات الإصدار
ما الذي تغيّر مؤخراً.
تُحمَّل الإدخالات التالية مباشرة من WordPress.org وتُخزَّن ست ساعات. النص الأصلي بالإنجليزية؛ والعنوان والملاحظة مترجمان.
1.5.6الإصدار الحالي
- New: DATEV export (EXTF Buchungsstapel, format version 700) – export issued invoices as a DATEV-compatible booking batch file for your German tax advisor (Steuerkanzlei) to import into DATEV.
- New: “DATEV export” button on the Invoices screen, visible only when the feature is enabled.
- New: DATEV section on the Settings screen: enable/disable, Beraternummer, Mandantennummer, Erlöskonto (revenue account), Debitor base number, Buchungsschlüssel (tax key), batch label and a booking text template.
- Security: the export link is nonce-protected and the handler is permission-checked against the plugin capability; only issued invoices are included in the batch.
1.5.5
- Renamed the plugin to “Albertoit Law Office Manager” (slug
albertoit-law-office-manager) so the distinctive brand term leads the name. - Moved the invoice print-view styles into a proper enqueued stylesheet.
- Sanitized every field of stored attachment descriptors decoded from the case form, instead of only checking their structure.
- Removed the bundled
.po/.motranslation files; the plugin remains fully internationalized and translation-ready via translate.wordpress.org.
1.5.4
- Added the
ait_lmgmt_loadedandait_lmgmt_admin_menuextension points, so an add-on can boot with the plugin and add its own screens under the same menu. - Added the
ait_lmgmt_is_profilter: the “Learn more about Pro” link is dropped once the Pro add-on reports itself as active. - Clarified this changelog: the paid layer described in the 1.2.x entries below is no longer part of this plugin – it ships as a separate add-on. This free build contains no Pro code, no license field and no gated screens.
1.5.3
- Renamed the admin menu label to “AIT Law Clients”.
ينشر WordPress.org سجل التغييرات بالإنجليزية. تُعرض الإدخالات دون تغيير حتى تبقى أرقام الإصدارات والتفاصيل التقنية دقيقة.
هل لديك أسئلة أخرى؟
تساعدك صفحة الدعم ومنتدى WordPress.org في الإعداد والترخيص واستيراد DATEV. لأسئلة Pro، يرجى تجهيز رقم الترخيص.
