إضافة صفحة مخصصة في استضافة دروبال
أعلن المسار وخياراتها.
وتشمل هذه الخطوة عنوان الصفحة، وبشروط الدخول إلى الصفحة، وغيرها.
في دروبال 7، كان لديك لتنفيذ hook_menu ().
في دروبال 8، إنشاء ملف
كتابة التعليمات البرمجية للعودة الجسم الصفحة.
في دروبال 7، كان عليك أن تكتب وظيفة صفحة الاستدعاء المنصوص عليها في hook_menu ().
في دروبال 8، يجب أن يكون رد الصفحة إما أسلوب فئة أو خدمة مسجلة. ويمكن أن تكون مختلفة تبعا لظروف مختلفة (HTTP مقابل HTTPS، ورؤوس المحتوى، وغيرها) ولكن هذا هو خارج نطاق هذه المقدمة.
تجول
اقتداء في هذه الصفحة، يجب أن تكون قادرا على إنشاء صفحة بسيطة في وحدة مخصصة، دون الحاجة إلى معرفة المزيد عن الداخلية دروبال. لمزيد من التفاصيل، راجع سجل التغيير لتغيير نظام التوجيه وتطبيقات مختلفة في جوهر ومشروع الأمثلة.
توجيه ملف YAML لوحدة مثال
يتم تخزين المعلومات التوجيه في المثال / example.routing.yml:
example.my_page هذا هو اسم الجهاز من الطريق. من جانب الاتفاقية، ينبغي module_name.sub_name أسماء آلة الطريق. عندما تحتاج أجزاء أخرى من رمز للإشارة إلى الطريق، وسوف تستخدم اسم الجهاز. مسار هذا يعطي المسار إلى صفحة على موقع الويب الخاص بك. ملاحظة مائلة للرائد (/)! التخلف عن هذا يصف الصفحة وعنوان رد. todo: أين يمكن تجاوز هذه الافتراضات؟ متطلبات هذا يحدد الشروط التي بموجبها سيتم عرض الصفحة. يمكنك تحديد أذونات الوحدات التي يجب تمكين، وغيرها من الشروط.
تنفيذ الصفحة لوحدة مثال
وينبغي تحديد ExampleController الدرجة تحكم في المثال / SRC / المراقب / ExampleController.php:
مساحة هذا يعلن البادئة اللازمة لتأهيل بالكامل اسم الطبقة نحن حاسمة. قارن كتلة ثيقة الملف واسم الفئة. لصناعة السيارات في محمل الطبقة يعرف ذلك، للعثور على الطبقة \ دروبال \ سبيل المثال \ المراقب \ ExampleController. يجب أن نبحث عن وحدات ملف / المثال / SRC / المراقب / ExampleController.php. استخدام هذا يتيح لنا استخدام ControllerBase بدلا من اسم مؤهل بشكل كامل. وهذا يجعل خط طبقتنا أسهل بكثير للقراءة. صفحتي () الأسلوب المحدد في ملف YAML يجب أن تكون علنية. يجب أن إرجاع مجموعة renderable.