قوانین سفارشی اقدام دروپال میزبانی

تعریف قوانین اقدامات سازگار است.

این قلاب به منظور اضافه کردن یک عمل قوانین جدید مورد نیاز است. این را باید به فایل MODULENAME.rules.inc، که به طور خودکار شامل زمانی که قلاب استناد قرار داده شده است.

مقدار بازگشتی

مجموعه ای از اطلاعات در مورد قوانین اقدامات ارائه ماژول است. آرایه شامل یک زیر آرایه برای هر عمل، با نام عمل به عنوان کلید. عملیات نام فقط باید شامل نویسههای و زیرین حرفی و عددی حروف کوچک و باید با نام ماژول ارائه پیشوند. ویژگی های ممکن برای هر زیر مجموعه ای عبارتند از:

• برچسب. برچسب از عمل است. شروع با حروف بزرگ. ضروری.
• گروه. یک گروه برای این عنصر، مورد استفاده برای گروه بندی اقدامات در رابط. باید با یک حرف بزرگ شروع و ترجمه شود. ضروری.
• پارامتر. (اختیاری) یک آرایه توصیف تمام پارامتر از عمل با نام پارامتر به عنوان کلید. هر پارامتر به یک زیر آرایه با ویژگی ممکن است شرح داده شود پس از آن شرح داده شده است، در حالی که نام یک پارامتر نیاز به یک حروف کوچک، پی اچ پی معتبر نام متغیر.
• فراهم می کند. (اختیاری) یک آرایه توصیف متغیرهای عمل فراهم می کند به دولت ارزیابی با نام متغیر به عنوان کلید. هر متغیر است که توسط یک زیر آرایه با ویژگی ممکن است شرح داده شود پس از آن شرح داده شده است، در حالی که نام یک پارامتر نیاز به یک حروف کوچک، پی اچ پی معتبر نام متغیر.
• پارامتر به نام ". (اختیاری) اگر درست تنظیم شده، استدلال خواهد شد به عنوان یک آرایه تک با نام پارامتر به عنوان کلید منتقل می شود. این شبیه سازی پارامترها در پی اچ پی به نام و به طور خاص مفید باشد اگر تعداد پارامترهای می تواند متفاوت باشد. به طور پیش فرض به FALSE.
• پایه. (اختیاری) پایه برای تماس مجدد اجرای عمل کنند تا به جای نام اقدام است. به طور پیش فرض به نام های عمل.
• تماس مجدد. (اختیاری) یک آرایه که اجازه می دهد تا به مجموعه ای از تماس مجدد تابع خاص برای عمل است. به طور پیش فرض برای هر پاسخ به تماس پایه اقدامات اضافه شده توسط '_' و نام پاسخ به تماس است.
• ، پاسخ به تماس دسترسی. (اختیاری) مخاطبین است که به بازگشت که آیا در حال حاضر در کاربر به سیستم وارد مجاز به پیکربندی این عمل است. rules_node_integration_access () برای مثال پاسخ به تماس را مشاهده کنید.

هر پارامتر، آرایه ممکن است خواص زیر را شامل:

• برچسب. برچسب پارامتر. شروع با حروف بزرگ. ضروری.
• را تایپ کنید. نوع قوانین داده پارامتر است، که برای به عمل منتقل می شود. همه انواع اعلام شده در hook_rules_data_info () ممکن است به عنوان یک آرایه از انواع ممکن مشخص، و همچنین. همچنین لیست و لیست از یک نوع را می توان با استفاده از لیست نت مشخص به عنوان توسط ماژول ابرداده نهاد معرفی شده است، hook_entity_property_info ببینید (). کلمه کلیدی خاص '*' می توان استفاده می شود که تمام انواع نباید اجازه داده شود. ضروری.
• بسته. (اختیاری) آرایه ای از نام بسته نرم افزاری. هنگامی که از نوع مشخص شده است که یک نوع موجودیت واحد تنظیم شده، این ممکن است برای محدود کردن بسته نرم افزاری مجاز می باشد.
• شرح. (اختیاری) اگر لازم باشد، شرح بیشتر از پارامتر.
• لیست گزینه. (اختیاری) پاسخ به تماس یک که مجموعه ای از مقادیر ممکن برای این پارامتر می گرداند. پاسخ به تماس است که توسط hook_options_list، آرایه ای به بازگشت (). برای یک پیاده سازی مثال rules_data_action_type_options ببینید ().
• صرفه جویی. (اختیاری) اگر این درست تنظیم شده، پارامتر خواهد شد قوانین را نجات داد زمانی که ارزیابی قوانین به پایان می رسد. این فقط برای انواع داده پس انداز کردنی پشتیبانی می شود. اگر عمل false برگرداند، صرفه جویی در پرش می کند.
• اختیاری. (اختیاری) ممکن است درست، تنظیم زمانی که پارامتر مورد نیاز نمی باشد.
• 'مقدار پیش فرض'. (اختیاری) ارزش برای تصویب به عمل، در مورد پارامتر اختیاری است و هیچ مقدار مشخص شده وجود ندارد.
• اجازه می دهد پوچ. (اختیاری) معمولا قوانین هر مقدار NULL به عنوان آرگومان عبور نمی کند، اما سقط ارزیابی اگر مقدار NULL موجود است. اگر درست باشد، قوانین را نمی خواهد سقط جنین و تصویب مقدار NULL را از طریق. به طور پیش فرض به FALSE.
• محدودیت. (اختیاری) محدود چگونه استدلال برای این پارامتر ممکن است ارائه شود. ارزش های پشتیبانی شده عبارتند 'انتخاب' و 'ورودی.
• حالت پیش فرض. (اختیاری) سفارشی کردن حالت پیش فرض برای ارائه ارزش استدلال برای یک پارامتر. ارزش های پشتیبانی شده عبارتند 'انتخاب' و 'ورودی. به طور پیش فرض بستگی به نوع داده های مورد نیاز.
• مطابق اصول بهداشت. (اختیاری) اجازه می دهد تا پارامترهای 'متن' نوع خواستار بحث در حال حاضر مقادیر. اگر فعال باشد، هر مقدار مشخص شده توسط کاربر نمی شود خود را به خوبی بررسی، اما جایگزین اعمال شده توسط ارزیاب ورودی و همچنین ارزش های بازیابی شده از منابع داده انتخاب شده است.
• ترجمه است. (اختیاری) اگر درست تنظیم شده به مقدار آرگومان ارائه پارامتر ترجمه از طریق ترجمه i18n به رشته است. این قابل اجرا برای پارامترهای متنی تنها، به عنوان مثال پارامترهای از نوع «متن» لیست، "نشانههای '،' است"و" لیست. به طور پیش فرض به FALSE.
• کلاس UI. (اختیاری) اجازه می دهد تا فارغ از کلاس UI، ​​استفاده شده است که برای تولید UI پیکربندی یک پارامتر. به طور پیش فرض به کلاس UI از نوع داده مشخص شده است.
• تمیز کردن پاسخ به تماس. (اختیاری) مخاطبین که ارزیاب ورودی ممکن است برای تمیز کردن جایگزین قرار داده استفاده می کنند؛ به عنوان مثال، این است که توسط ارزیاب رمز استفاده می شود.
• پیچیده می شود. (اختیاری) تنظیم این درست در مورد داده ها باید پیچیده گذشت. این تنها به انواع داده پیچیده شده، به عنوان مثال، در مورد اشخاص.

هر "فراهم می کند 'آرایه ممکن است خواص زیر را شامل:

• برچسب. برچسب متغیر است. شروع با حروف بزرگ. ضروری.
• را تایپ کنید. نوع قوانین داده متغیر است. همه انواع اعلام شده در hook_rules_data_info () ممکن است مشخص شود. انواع ممکن است به عنوان مثال، پارامتری گره انواع یا لیست معتبر هستند.
• صرفه جویی. (اختیاری) اگر این درست تنظیم شده، متغیر ارائه شده است توسط قوانین را نجات داد زمانی که ارزیابی قوانین به پایان می رسد. تنها راه ممکن برای انواع داده پس انداز کردنی. به طور پیش فرض به FALSE.

این ماژول دارای به ارائه یک پیاده سازی برای هر عمل، یک تابع به نام در 'پایگاه کلید و یا برای پاسخ به تماس اعدام مشخص شده است. همه تماس مجدد ممکن دیگر اختیاری هستند. تماس مجدد اقدام پشتیبانی شده توسط قوانین تعریف شده و مستند در RulesPluginImplInterface. با این حال هر ماژول ممکن است پلاگین عمل بر اساس یک رابط تعریف شده با استفاده از hook_rules_plugin_info گسترش (). همه روش های تعریف شده در این رابطهای را می توان با اجرای عمل باطل شود. پیاده سازی مخاطبین برای کسانی که رابط ممکن است در هر فایل مشخص شده در hook_rules_file_info اقامت ().

مطالب مرتبط

قوانین، قلاب قلاب است که می تواند با ماژول های دیگر به منظور گسترش قوانین اجرا شده است.

کمک / قوانین / rules.api.php. خط 137 این فایل فاقد کد پی اچ پی؛ آن وجود دارد به ارائه اسناد و مدارک اضافی برای داکسیجن و همچنین به سند قلاب در شیوه ای استاندارد دروپال.

مقالات مرتبط

تعریف قوانین اقدامات سازگار است. این قلاب به منظور اضافه کردن یک عمل قوانین جدید مورد نیاز است. این را باید به فایل MODULENAME.rules.inc، که به طور خودکار در هنگام قرار داده ...

ضمیمه زمینه های داده های سفارشی به اشخاص دروپال. از API درست اجازه می دهد تا زمینه های داده های سفارشی را به به اشخاص دروپال متصل می شود و طول می کشد مراقبت از ذخیره سازی، بارگذاری، ویرایش و رندر داده های میدانی ....

اجرای توابع قلاب در یک قلاب عمل خاص، مشخص استدلال در یک آرایه. این تابع یکسان به do_action است. اما آرگومان به توابع قلاب به تگ $ هستند ...

به طور پیش فرض مقالات. صفحه های. صفحات وبلاگ. و دیگر انواع مطالب را مکانی برای بازدید کنندگان به ترک نظر ندارد. در آغاز دروپال 8 نظر نوع فیلد خود شد. این به این معنی آن است که ...

اعلام مسیر و گزینه های آن است. این مرحله شامل عنوان صفحه، الزامات دسترسی برای صفحه، و دیگران است. در دروپال 7، شما را مجبور به پیاده سازی hook_menu (). در دروپال 8، ایجاد ...