إنشاء صفحة إعدادات البرنامج المساعد WordPress - الخطوة 1: إنشاء ملف البرنامج المساعد

إنشاء صفحة إعدادات البرنامج المساعد WordPress في هذا البرنامج التعليمي ، سننشئ صفحة إعدادات البرنامج المساعد WordPress. سيسمح لنا ذلك بإضافة خيارات البرنامج المساعد إلى منطقة إدارة WordPress. سنستخدم الإعدادات API ، والتي تم تقديمها في WordPress 2.7. تعمل واجهة برمجة التطبيقات هذه على تسهيل إضافة صفحات الإعدادات إلى المكونات الإضافية الخاصة بك. اذا هيا بنا نبدأ. الخطوة 1: إنشاء ملف البرنامج المساعد أولاً ، نحتاج إلى إنشاء ملف البرنامج المساعد الخاص بنا. سنطلق عليه اسم "my-plugin-settings.php" ونضعه في دليل البرنامج المساعد الخاص بنا. أول شيء يتعين علينا القيام به هو تحديد المكون الإضافي الخاص بنا. سنفعل ذلك عن طريق إضافة ما يلي إلى ملف البرنامج المساعد الخاص بنا: / * اسم المكون الإضافي: URI إعدادات البرنامج المساعد الخاص بي: http://example.com/my-plugin-settings الوصف: هذا مكون إضافي يضيف صفحة إعدادات إلى موقعنا توصيل في. الإصدار: 1.0 المؤلف: John Doe المؤلف URI: http://example.com الترخيص: GPLv2 * /؟ > سيعطي هذا الإضافة اسمًا ووصفًا وبعض المعلومات الأخرى. بعد ذلك ، نحتاج إلى إنشاء صفحة إعدادات المكون الإضافي الخاصة بنا.

يمكن إضافة مكون إضافي باستخدام صفحة الإعدادات ، والتي يمكن للمسؤولين الوصول إليها. في هذه المقالة سوف تتعلم كيفية القيام بما يلي. أخيرًا ، في نهاية المقالة ، سنذكر مستودع GitHub الذي يتضمن الوظائف المدرجة أدناه في إصدار عمل من مكون WordPress الإضافي مع صفحة إعدادات بسيطة . الخطوة الأولى هي إضافة وظيفة displayPluginAdminSettings إلى فصلك الدراسي ، plugins-name-config-display.php. تحدد هذه الوظيفة علامة التبويب التي تستخدمها إذا كان لديك نماذج إعدادات متعددة ، وتعرض أي إشعارات قد يكون لدى WordPress ، وتحدد ملف PHP الذي ستستخدمه لعرض صفحة إعدادات المكون الإضافي. في الخطوة 4 ، ستقوم بتضمين مرجع إلى وظيفة أخرى تسمى pluginNameSettingsMessages في وظيفة displayAdminTab. إذا كنت ترغب في تحرير ملفات البرنامج المساعد في بيئة تطوير محلية ، يمكنك استخدام لوحة تحكم مسؤول WordPress.

قم بعمل نسخة من المجلد الأصل للمكون الإضافي الخاص بك وقم بتضمينه في تثبيت WordPress. نظرًا لحجمها ونطاقها ، فإن وظيفة registerAndBuildFields المذكورة أعلاه أصغر بكثير وأكثر قابلية للقراءة. نتيجة لهذا المنشور ، أضفنا هذه الوظيفة ، والتي تتيح لك استخدام مربعات التحديد في إعدادات المكون الإضافي الخاص بك.

صفحة إعدادات WordPress Plugin Boilerplate

يمكن أن تكون صفحة إعدادات Boilerplate المكونة من WordPress طريقة رائعة للبدء في تطوير مكون WordPress الإضافي. يوفر نقطة انطلاق للمكوِّن الإضافي الخاص بك ويمكن أن يساعدك في التنظيم. يمكن أن تكون أيضًا طريقة رائعة للتعرف على تطوير البرنامج المساعد WordPress .

تم تضمين واجهة برمجة تطبيقات إعدادات WordPress في WordPress 2.7 ، مما يسمح للمطورين بتسجيل حقول الإعدادات في نماذج إعدادات لوحة المعلومات الحالية. يمكنك تحديد الأقسام والصفحات والحقول داخل الأقسام التي تحددها بمساعدة هذه الأداة. كيف تضيف صفحة إعدادات إلى مكون WordPress الإضافي الخاص بك؟ هناك العديد من مكتبات التجميع المتاحة لمساعدتك في إنشاء صفحة إعدادات لمكوِّن WordPress الإضافي الخاص بك. في المثال التالي ، نقوم بإنشاء قسم مجموعة عن طريق ربط الإعدادات به. يجب بعد ذلك تحديد الإعداد الذي يجب تمكينه باستخدام get_option ('dbi_example_ plugin_options') ومفتاح المصفوفة. عند تطوير مكون إضافي أو سمة للتوزيع ، لا يمكنك الاعتماد على ACF لأنه لم يتم تثبيته.

لمعرفة المزيد حول استخدام إطار عمل Carbon Fields ، راجع مقالتنا السابقة. يجعل إطار العمل من السهل جدًا جعل الحقول أكثر سهولة في الاستخدام ، مثل إضافة المعلمات الافتراضية والحد الأقصى والحد الأدنى والحد الأقصى إلى حقل "حد النتائج". خيار آخر هو الاستفادة من WordPress.settings API عبر مولد WordPress. يمكننا إعادة إنشاء صفحة الإعدادات الخاصة بنا باستخدام مولد صفحة خيارات WordPress. كبديل لطلبات admin-ajax.php التقليدية ، توفر واجهة برمجة تطبيقات REST مزايا أداء ، بالإضافة إلى تجارب مستخدم محسنة من خلال حفظ إعدادات النموذج في الخلفية أثناء تحديث الصفحة. يرشدك Josh Pollock إلى كيفية إنشاء صفحة إعدادات باستخدام jQuery وواجهة برمجة تطبيقات REST في هذه المقالة. التالي هو صفحة إعدادات مدعومة من VueJS.

يمكن استخدام الكود المستخدم في هذه المقالة لتثبيت الحزمة مباشرة في Composer وصفحة الإعدادات الخاصة به. عند استخدام واجهة برمجة تطبيقات REST ، يمكنك القيام بالكثير من React أو VueJS في إدارة WordPress الخاصة بك. المفضلة الحالية هي WP-optionskit ، والتي تحتوي على العديد من علامات تبويب الإعدادات والأقسام الفرعية المتاحة. ما هي طريقة إنشاء صفحة إعدادات WordPress لمكوِّن إضافي؟ أخبرنا في التعليقات إذا كان لديك أي أسئلة.

البرنامج المساعد للإعدادات المخصصة لـ WordPress

هناك العديد من الإضافات الرائعة للإعدادات المخصصة المتاحة لـ WordPress. لكل منها ميزاته وفوائده الفريدة. ومع ذلك ، تتضمن بعض الميزات الشائعة القدرة على تخصيص شكل ومظهر موقع WordPress الخاص بك ، وإضافة وظائف جديدة ، وتوسيع إمكانيات المكونات الإضافية الحالية. في النهاية ، سيعتمد اختيار المكون الإضافي المناسب للإعدادات المخصصة لاحتياجاتك على أهدافك ومتطلباتك المحددة.

كيف أقوم بإدخال إعداد المكون الإضافي للمكون الإضافي في إعدادات WordPress؟ تركز مدونة Knowband على وحدات التجارة الإلكترونية. الهدف من هذه المدونة هو شرح كيفية إنشاء إعداد مكون إضافي مخصص . يجب إضافة إعدادات المكون الإضافي حتى يتم تنفيذها. يمكن العثور على مجلد الإضافات في مجلد الملحقات في موقع Woo Commerce الخاص بك. يجب إنشاء ملف PHP جديد في دليل البرنامج المساعد الخاص بك. في نموذج الكود ، قمنا بنسخ الكود من صفحة الخيارات أدناه إلى ملف plugin.php المخصص. باتباع هذه الخطوة ، ستتمكن من رؤية خيار المكون الإضافي المخصص الخاص بك في إعداد Word press كما هو موضح في الصورة أدناه: في هذه الخطوة ، يجب عليك إنشاء نموذج يعرض الخيارات (الحقول) في إعدادات البرنامج المساعد المخصص صفحة.

صفحة الإعدادات المخصصة لـ WordPress

صفحة الإعدادات المخصصة في WordPress هي صفحة يمكنك من خلالها إضافة خياراتك المخصصة لموقع WordPress الخاص بك. يمكن أن يكون هذا مفيدًا إذا كنت تريد إضافة خيارات لموضوعك أو مكونك الإضافي ، أو إذا كنت تريد إنشاء لوحة تحكم مخصصة لموقعك.

سنتناول كيفية إنشاء صفحة إعداد مخصصة جديدة لـ WordPress في هذا المنشور. يسمح قسم الإعداد ، وهو جزء من واجهة برمجة تطبيقات إعدادات WordPress ، للمطورين بتنظيم إعداداتهم حسب العنوان. تحتوي هذه الصفحة على الكود الذي تم استخدامه لإنشاء صفحة مسؤول مخصصة في المنشور السابق. لقد أضفنا قسم إعداد جديد في الكود أعلاه كنتيجة للكود أعلاه. لا تسمح لك وظيفة settings_fields بإضافة ترميز إلى الإعدادات وعلامات الإدخال فحسب ، بل إنها تضيف أيضًا أمانًا من خلال تتبع الشخص الذي يقوم بإنشاء الإعدادات والتوصيفات. في هذه الحالة ، سنلف الكود في وظيفة جديدة تسمى admin_init. عند محاولة حفظ الإعدادات ، قد تحدث بعض الأخطاء ، مثل عدم العثور على صفحة الخيار.

نظرًا لأننا لم نسجل بعد في WordPress ، فلا يمكننا بعد الوصول إلى قاعدة بيانات WordPress لحفظ القيمة. باستخدام وظيفة register_setting ، سنضبط إعداداتنا في WordPress. ستعيد وظيفة get_option القيمة المحفوظة للإعداد المُضاف.

صفحة إعدادات WordPress

توجد علامة التبويب الإعدادات في الشريط الجانبي لـ WordPress Admin وتعمل كمحور مركزي لتكوين الإعدادات لأقسام مختلفة من موقع WordPress على الويب. يمكن العثور على لوحات فرعية متعددة في هذا القسم ، وكثيرًا ما تتضمن مكونات WordPress الإضافية صفحة الإعدادات الخاصة بها كخيار قائمة ضمن علامة التبويب الإعدادات. عند النقر فوق رمز الإعدادات ، يمكنك تمكينه. هذه شاشة عامة.

قد يكون إنشاء مكون إضافي لبرنامج WordPress تجربة ممتعة إذا لم تكن متأكدًا من كيفية إنشاء صفحة إعدادات. نعتقد أحيانًا أن توفير الخيارات للجميع أمر جيد ، على الرغم من حقيقة أنه قد يكون هناك عدد لا حصر له من الخيارات. في النهاية ، تكون هذه القرارات فنية بطبيعتها ، وهي اختيارات لا يستطيع المستخدم العادي اتخاذها. واجهة برمجة تطبيقات إعدادات WordPress متاحة الآن في الإصدار 2.70. الغرض من هذه الوظائف هو تبسيط إنشاء صفحات الإعدادات. يتم تضمين الميزة التي يمكن استخدامها لتحديد الخيارات المتاحة ، وكذلك واجهة المستخدم التي سيتم استخدامها لتحرير كل منها. نظرًا لأن أفضل طريقة للتعلم هي من خلال الأمثلة ، فلنستخدم واجهة برمجة تطبيقات الإعدادات لإنشاء صفحة الإعدادات الأولى الخاصة بنا.

الخطوة التالية هي تحديد كل خيار من الخيارات التي ستظهر في صفحة الإعدادات الخاصة بنا. يمكن تحقيق ذلك باستخدام طريقتين: register_setting و add_settings_field. يمكننا تحديد اسم قاعدة البيانات التي سنحفظ الإعدادات منها عن طريق إجراء هذا البيان. بالإضافة إلى ذلك ، يشتمل كل حقل على مرجع دالة ، والذي يخبر WordPress بكيفية تقديمه. يعد إنشاء صفحة الإعداد أمرًا بسيطًا إلى حد ما. يمكنك إدخال الحقول التي تريد استخدامها في صفحة الإعدادات الخاصة بك باستخدام منشئ رمز على الإنترنت. في مثالنا ، من الممكن أن تكون عمليات الاسترجاعات مشابهة لهذا. رد النداء هذا ، وفقًا لتعليماته ، يقوم فقط بإرجاع قيمة الحقل المقصود تقديمه.