قواعد العرف استضافة دروبال العمل

تحديد قواعد الإجراءات متوافقة.

هذا مطلوب هوك من أجل إضافة إجراء قواعد جديدة. وينبغي أن توضع في ملف MODULENAME.rules.inc، الذي يحصل شملت تلقائيا عندما يتم استدعاء هوك.

قيمة الإرجاع

مجموعة من المعلومات حول الإجراءات القواعد المنصوص الوحدة النمطية. يحتوي على مجموعة مجموعة فرعية لكل عمل، مع اسم العمل كمفتاح. قد تحتوي أسماء الإجراءات فقط الشخصيات وسفلية الرقمية ألفا صغيرة ويجب أن يبدأ مع توفير اسم الوحدة النمطية. الصفات الممكنة لكل مجموعة فرعية هي:

قواعد العرف قد يحتوي العمل دروبال استضافة مجموعة ما يلي
  • ضع الكلمة المناسبة. التسمية من العمل. رسملة البداية. مطلوب.
  • مجموعة. مجموعة لهذا العنصر، وتستخدم لتجميع الإجراءات في الواجهة. يجب أن تبدأ بحرف كبير وترجمتها. مطلوب.
  • معامل. (اختياري) هناك مجموعة واصفا كل معلمة للعمل مع اسم المعلمة باعتبارها مفتاح. كل معلمة لابد من وصفها من قبل مجموعة فرعية مع سمات الممكنة كما هو موضح بعد ذلك، في حين أن اسم المعلمة لابد أن يكون صغيرة، PHP صحيح اسم متغير.
  • يوفر. (اختياري) هناك مجموعة تصف المتغيرات يوفر العمل للدولة التقييم مع اسم المتغير كمفتاح. كل متغير لابد من وصفها من قبل مجموعة فرعية مع سمات الممكنة كما هو موضح بعد ذلك، في حين أن اسم المعلمة لابد أن يكون صغيرة، PHP صحيح اسم متغير.
  • "المعلمة اسمه '. (اختياري) إذا تم تعيينها إلى TRUE، سيتم تمرير الحجج مجموعة واحدة مع أسماء المعلمات كمفاتيح. هذا يحاكي اسمه المعلمات في PHP وهو على وجه الخصوص مفيدة إذا كان عدد المعلمات يمكن أن تختلف. افتراضات إلى FALSE.
  • قاعدة. (اختياري) وقاعدة لعمليات الاسترجاعات تنفيذ إجراءات لاستخدام بدلا من اسم العمل ل. افتراضات إلى اسم الإجراء.
  • رد. (اختياري) صفيف الذي يسمح لوضع الاسترجاعات وظيفة محددة للعمل. الافتراضي لكل الاستدعاء هو قاعدة الإجراءات الملحقة التي كتبها '_' واسم الاستدعاء.
  • "رد المتحركة. (اختياري) يسمح للرد الذي لديه للعودة إذا كان دخوله حاليا في المستخدم لتكوين هذا الإجراء. انظر rules_node_integration_access () للحصول على مثال الاستدعاء.

قد تحتوي على كل "المعلمة" مجموعة الخصائص التالية:

  • ضع الكلمة المناسبة. تسمية المعلمة. رسملة البداية. مطلوب.
  • اكتب. نوع قواعد البيانات من المعلمة، والتي هي لتمريرها إلى العمل. جميع أنواع أعلن في hook_rules_data_info () قد تكون محددة، فضلا عن مجموعة واسعة من الأنواع الممكنة. أيضا قوائم وقوائم من نوع معين يمكن تحديده باستخدام قائمة الترميز؟ كما قدم من قبل وحدة الفوقية كيان، انظر hook_entity_property_info (). الكلمة الرئيسية الخاصة '*' يمكن استخدامها متى يجب أن يسمح لجميع أنواع. مطلوب.
  • بال. (اختياري) هناك مجموعة من أسماء الباقة. عندما يتم تعيين النوع المحدد إلى نوع كيان واحد، وهذا يمكن أن تستخدم لتقييد حزم المسموح بها.
  • وصف. (اختياري) إذا لزم الأمر، وصفا مزيد من المعلمة.
  • قائمة الخيارات. (اختياري) والاستدعاء التي تقوم بإرجاع مجموعة من القيم الممكنة لهذه المعلمة. رد الاتصال ديه للعودة مجموعة كما يستخدمه hook_options_list (). لتنفيذ سبيل المثال نرى rules_data_action_type_options ().
  • حفظ. (اختياري) إذا تم تعيين هذا إلى TRUE، سيتم حفظ المعلمة بقواعد عندما ينتهي تقييم القواعد. هذا معتمد فقط لأنواع البيانات savable. إذا كان الإجراء إرجاع FALSE، يتم تخطي الادخار.
  • اختياري. (اختياري) قد يتم تعيين إلى TRUE، عندما لا يطلب من المعلمة.
  • 'القيمة الافتراضية'. (اختياري) قيمة لتمريرها إلى العمل، في حالة المعلمة اختيارية وليس هناك قيمة محددة.
  • 'السماح لاغية ". و(اختياري) عادة قواعد لا يمر أي قيم فارغة كما الحجة، ولكن إحباط تقييم إذا كانت قيمة NULL موجودة. إذا تم تعيين إلى TRUE، وقوانين لا إحباط وتمرير قيمة NULL من خلال. افتراضات إلى FALSE.
  • تقييد. (اختياري) تقييد كيف يمكن تقديم حجة لهذه المعلمة. القيم المعتمدة هي "محدد" و "الإدخال".
  • الوضع الافتراضي. (اختياري) تخصيص الوضع الافتراضي لتوفير قيمة وسيطة للمعلمة. القيم المعتمدة هي "محدد" و "الإدخال". الافتراضي يعتمد على نوع البيانات المطلوب.
  • عقم. (اختياري) يسمح المعلمات من نوع 'نص' للمطالبة حجة مطهرة بالفعل. في حالة التمكين، لن يتم تطهير أي قيمة المستخدم المحدد في حد ذاته، ولكن استبدال تطبيقها من قبل مقيمين المدخلات وكذلك القيم التي تم استردادها من مصادر البيانات المحددة.
  • ترجمة. (اختياري) إذا تم تعيينها إلى TRUE، قيمة الوسيطة المقدمة من المعلمة للترجمة عبر ترجمة سلسلة I18N. هذا ينطبق على المعلمات نصية فقط، أي معالم 'نص' نوع القائمة، 'رمز'، '"و" قائمة". افتراضات إلى FALSE.
  • الطبقة واجهة المستخدم. (اختياري) يسمح تجاوز الطبقة UI، والذي يستخدم لتوليد UI تكوين معلمة. التخلف إلى فئة UI من نوع البيانات المحدد.
  • تنظيف رد. (اختياري) والاستدعاء أن المقيمين المدخلات قد تستخدم لتنظيف استبدال إدراجها. مثلا يتم استخدام هذه من قبل مقيم رمزية.
  • مغطى. (اختياري) تعيين هذا إلى TRUE في حالة يجب أن مرت ملفوفة البيانات. هذا ينطبق فقط على أنواع البيانات ملفوفة، على سبيل المثال، جهات.
قواعد العرف العمل دروبال استضافة مصفوفة

كل "تقدم" مجموعة قد يحتوي على الخصائص التالية:

  • ضع الكلمة المناسبة. تسمية المتغير. رسملة البداية. مطلوب.
  • اكتب. نوع قواعد البيانات للمتغير. جميع أنواع أعلن في hook_rules_data_info () قد تكون محددة. يمكن parametrized أنواع مثل العقدة أنواع أو قائمة صالحة.
  • حفظ. (اختياري) إذا تم تعيين هذا إلى TRUE، يتم حفظ متغير المقدمة من القواعد عندما ينتهي تقييم القواعد. ممكن فقط لأنواع البيانات savable. افتراضات إلى FALSE.

وحدة لديها لتوفير التنفيذ لكل عمل، لكونها وظيفة اسمه كما هو محدد في 'القاعدة' الرئيسية أو الاستدعاء التنفيذ. كل الاسترجاعات أخرى مناسبة اختيارية. يتم تعريف الاسترجاعات العمل بدعم من قواعد وتوثيقها في RulesPluginImplInterface. ولكن أي وحدة قد يمتد البرنامج المساعد العمل استنادا إلى واجهة محددة باستخدام hook_rules_plugin_info (). كافة الأساليب التي يعرفها في هذه الواجهات يمكن التغلب عليه من تنفيذ العمل. وتطبيقات الاستدعاء لهذه الواجهات قد تكون موجودة في أي ملف المحددة في hook_rules_file_info ().

مواضيع ذات صلة

قواعد "السنانير السنانير التي يمكن تنفيذها من قبل وحدات أخرى من أجل توسيع نطاق القواعد.

مساهمات / قواعد / rules.api.php. خط 137 هذا الملف يحتوي على أي رمز PHP العامل؛ كان موجودا لتقديم وثائق إضافية لdoxygen فضلا عن توثيق السنانير بالطريقة دروبال القياسية.

شاهد هذا الفيديو!

مقالات ذات صلة

تطبيقات API دروبال استضافةتحديد قواعد الإجراءات متوافقة. هذا مطلوب هوك من أجل إضافة إجراء قواعد جديدة. وينبغي أن توضع في ملف MODULENAME.rules.inc، الذي يحصل شملت تلقائيا عند ...
حقل منطقي استضافة نوع دروبالإرفاق حقول البيانات المخصصة للكيانات دروبال. وAPI الميدان يسمح حقول البيانات المخصصة لتركيبها على الكيانات دروبال ويعتني تخزين والتحميل، والتحرير، وتقديم البيانات الميدانية ....
هل عمل المرجع مجموعة ورد الاستضافةتنفيذ وظائف مدمن مخدرات على ربط إجراءات محددة، وتحديد الحجج في صفيف. هذه هي وظيفة مماثلة لdo_action. ولكن الحجج التي تم تمريرها إلى وظائف التوصيل إلى $ العلامة هي ...
إضافة حقل استضافة نوع دروبالفي المواد الافتراضية. الصفحات. صفحة بلوق. وأنواع المحتوى الأخرى ليس لديها مكان للزوار لترك تعليق. وابتداء من عام دروبال 8، أصبح تعليق نوع الحقل الخاص به. وهذا يعني أنه من ...
إضافة صفحة مخصصة في استضافة دروبالأعلن المسار وخياراتها. وتشمل هذه الخطوة عنوان الصفحة، وبشروط الدخول إلى الصفحة، وغيرها. في دروبال 7، كان لديك لتنفيذ hook_menu (). في دروبال 8، إنشاء ...