การสร้างหน้าการตั้งค่าปลั๊กอิน WordPress – ขั้นตอนที่ 1: สร้างไฟล์ปลั๊กอิน

การสร้างหน้าการตั้งค่าปลั๊กอิน WordPress ในบทช่วยสอนนี้ เราจะสร้างหน้าการตั้งค่าปลั๊กอิน WordPress ซึ่งจะทำให้เราสามารถเพิ่มตัวเลือกปลั๊กอินของเราในพื้นที่ผู้ดูแลระบบ WordPress เราจะใช้ Settings API ซึ่งเปิดตัวใน WordPress 2.7 API นี้ทำให้ง่ายต่อการเพิ่มหน้าการตั้งค่าให้กับปลั๊กอินของคุณ มาเริ่มกันเลยดีกว่า ขั้นตอนที่ 1: สร้างไฟล์ปลั๊กอิน ขั้นแรกเราต้องสร้างไฟล์ปลั๊กอินของเรา เราจะตั้งชื่อว่า "my-plugin-settings.php" และใส่ไว้ในไดเร็กทอรีปลั๊กอินของเรา สิ่งแรกที่เราต้องทำคือกำหนดปลั๊กอินของเรา เราจะทำเช่นนี้โดยเพิ่มสิ่งต่อไปนี้ในไฟล์ปลั๊กอินของเรา: /* ชื่อปลั๊กอิน: URI การตั้งค่าปลั๊กอินของฉัน Plugin URI: http://example.com/my-plugin-settings คำอธิบาย: นี่คือปลั๊กอินที่เพิ่มหน้าการตั้งค่าของเรา เสียบเข้าไป. เวอร์ชัน: 1.0 ผู้แต่ง: John Doe ผู้แต่ง URI: http://example.com ใบอนุญาต: GPLv2 */ ? > สิ่งนี้จะทำให้ปลั๊กอินของเรามีชื่อ คำอธิบาย และข้อมูลอื่นๆ ต่อไป เราต้องสร้างหน้าการตั้งค่าปลั๊กอินของเรา

สามารถเพิ่มปลั๊กอินได้โดยใช้หน้าการตั้งค่า ซึ่งผู้ดูแลระบบสามารถเข้าถึงได้ ในบทความนี้ คุณจะได้เรียนรู้วิธีดำเนินการดังต่อไปนี้ สุดท้ายนี้ ที่ส่วนท้ายของบทความ เราจะพูดถึงที่เก็บ GitHub ที่มีฟังก์ชันที่แสดงด้านล่างในเวอร์ชันที่ใช้งานได้ของปลั๊กอิน WordPress พร้อม หน้าการตั้งค่าอย่างง่าย ขั้นตอนแรกคือการเพิ่มฟังก์ชัน displayPluginAdminSettings ให้กับคลาสของคุณ plugins-name-configured-display.php ฟังก์ชันนี้จะกำหนดแท็บที่คุณอยู่ หากคุณมีแบบฟอร์มการตั้งค่าหลายแบบ แสดงประกาศที่ WordPress อาจมี และระบุไฟล์ PHP ที่คุณจะใช้เพื่อแสดงหน้าการตั้งค่าของปลั๊กอิน ในขั้นตอนที่ 4 คุณจะรวมการอ้างอิงถึงฟังก์ชันอื่นที่เรียกว่า pluginNameSettingsMessages ในฟังก์ชัน displayAdminTab ของคุณ หากคุณต้องการแก้ไขไฟล์ปลั๊กอินในสภาพแวดล้อมการพัฒนาท้องถิ่น คุณสามารถใช้แดชบอร์ดผู้ดูแลระบบ WordPress ได้

ทำสำเนาโฟลเดอร์หลักของปลั๊กอินและรวมไว้ในการติดตั้ง WordPress เนื่องจากขนาดและขอบเขตของมัน ฟังก์ชัน registerAndBuildFields ด้านบนจึงเล็กกว่าและอ่านง่ายกว่ามาก จากโพสต์นี้ เราได้เพิ่มฟังก์ชันนี้ ซึ่งช่วยให้คุณใช้กล่องเลือกในการตั้งค่าปลั๊กอินของคุณได้

หน้าการตั้งค่าปลั๊กอิน WordPress Plugin Boilerplate

หน้าการตั้งค่า WordPress Plugin Boilerplate อาจเป็นวิธีที่ดีในการเริ่มต้นพัฒนาปลั๊กอิน WordPress เป็นจุดเริ่มต้นสำหรับปลั๊กอินของคุณและช่วยให้คุณจัดระเบียบได้ นอกจากนี้ยังเป็นวิธีที่ยอดเยี่ยมในการเรียนรู้เกี่ยวกับ การพัฒนาปลั๊กอิน WordPress

WordPress Settings API รวมอยู่ใน WordPress 2.7 ทำให้นักพัฒนาสามารถลงทะเบียนฟิลด์การตั้งค่าบนแบบฟอร์มการตั้งค่าแดชบอร์ดที่มีอยู่ได้ คุณสามารถกำหนดส่วน หน้า และฟิลด์ภายในส่วนที่คุณกำหนดโดยใช้เครื่องมือนี้ คุณจะเพิ่มหน้าการตั้งค่าให้กับปลั๊กอิน WordPress ของคุณได้อย่างไร? มีไลบรารีของ wrapper มากมายที่จะช่วยคุณในการสร้างหน้าการตั้งค่าสำหรับปลั๊กอิน WordPress ของคุณ ในตัวอย่างต่อไปนี้ เราสร้างส่วนกลุ่มโดยเชื่อมโยงการตั้งค่าเข้ากับส่วนนั้น จะต้องกำหนดการตั้งค่าที่ต้องเปิดใช้งานโดยใช้ get_option('dbi_example_ plugin_options') และคีย์อาร์เรย์ เมื่อพัฒนาปลั๊กอินหรือธีมสำหรับการแจกจ่าย คุณไม่สามารถพึ่งพา ACF ได้เนื่องจากยังไม่ได้ติดตั้ง

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการใช้เฟรมเวิร์ก Carbon Fields โปรดดูบทความก่อนหน้าของเรา กรอบงานทำให้ง่ายมากในการทำให้ฟิลด์เป็นมิตรกับผู้ใช้มากขึ้น เช่น การเพิ่มพารามิเตอร์เริ่มต้น สูงสุด ต่ำสุด และสูงสุดลงในฟิลด์ 'ขีดจำกัดผลลัพธ์' อีกทางเลือกหนึ่งคือการใช้ประโยชน์จาก WordPress.settings API ผ่านตัวสร้าง WordPress เราสามารถสร้างหน้าการตั้งค่าใหม่ได้โดยใช้ WordPress Option Page Generator เป็นทางเลือกแทนคำขอ admin-ajax.php แบบเดิม REST API มอบข้อได้เปรียบด้านประสิทธิภาพ เช่นเดียวกับประสบการณ์ผู้ใช้ที่ได้รับการปรับปรุงโดยบันทึกการตั้งค่าแบบฟอร์มในพื้นหลังในขณะที่หน้ากำลังรีเฟรช Josh Pollock จะอธิบายวิธีสร้างหน้าการตั้งค่าโดยใช้ jQuery และ REST API ในบทความนี้ ถัดไปคือหน้าการตั้งค่าที่ขับเคลื่อนด้วย VueJS

โค้ดที่ใช้ในบทความนี้สามารถใช้เพื่อติดตั้งแพ็กเกจลงใน Composer และหน้าการตั้งค่าได้โดยตรง เมื่อคุณใช้ REST API คุณสามารถทำ React หรือ VueJS ได้มากมายในการดูแลระบบ WordPress ของคุณ รายการโปรดปัจจุบันของฉันคือ WP-optionskit ซึ่งมีแท็บการตั้งค่าและส่วนย่อยหลายรายการ แนวทางในการสร้าง หน้าการตั้งค่า WordPress สำหรับปลั๊กอินคืออะไร? บอกเราในความคิดเห็นหากคุณมีคำถามใด ๆ

ปลั๊กอินการตั้งค่าแบบกำหนดเองของ WordPress

มี ปลั๊กอินการตั้งค่าแบบกำหนดเองที่ยอดเยี่ยมมากมาย สำหรับ WordPress แต่ละคนมีคุณสมบัติและประโยชน์ที่เป็นเอกลักษณ์ของตัวเอง อย่างไรก็ตาม คุณลักษณะทั่วไปบางอย่างรวมถึงความสามารถในการปรับแต่งรูปลักษณ์ของไซต์ WordPress ของคุณ เพิ่มฟังก์ชันการทำงานใหม่ และขยายขีดความสามารถของปลั๊กอินที่มีอยู่ของคุณ ในท้ายที่สุด การเลือกปลั๊กอินการตั้งค่าแบบกำหนดเองที่เหมาะสมกับความต้องการของคุณจะขึ้นอยู่กับเป้าหมายและข้อกำหนดเฉพาะของคุณ

ฉันจะแทรกการตั้งค่าปลั๊กอินสำหรับปลั๊กอินในการตั้งค่า WordPress ได้อย่างไร บล็อก Knowband มุ่งเน้นไปที่โมดูลอีคอมเมิร์ซ เป้าหมายของบล็อกนี้คือการอธิบายวิธีสร้างการตั้งค่า ปลั๊กอินที่กำหนดเอง ต้องเพิ่มการตั้งค่าของปลั๊กอินเพื่อใช้งาน โฟลเดอร์ปลั๊กอินของคุณสามารถพบได้ในโฟลเดอร์ปลั๊กอินของไซต์ Woo Commerce ของคุณ ต้องสร้างไฟล์ PHP ใหม่ในไดเรกทอรีปลั๊กอินของคุณ ในโค้ดตัวอย่าง เราได้คัดลอกโค้ดจากหน้าตัวเลือกด้านล่างลงในไฟล์ custom- plugin.php ทำตามขั้นตอนนี้ คุณจะสามารถเห็นตัวเลือกของปลั๊กอินแบบกำหนดเองของคุณในการตั้งค่า Word press ดังที่แสดงในภาพด้านล่าง: ในขั้นตอนนี้ คุณต้องสร้างแบบฟอร์มที่จะแสดงตัวเลือก (ฟิลด์) ในการตั้งค่าของปลั๊กอินแบบกำหนดเอง หน้าหนังสือ.

หน้าการตั้งค่าแบบกำหนดเองของ WordPress

หน้าการตั้งค่าแบบกำหนดเองของ WordPress คือหน้าที่คุณสามารถเพิ่มตัวเลือกที่กำหนดเองสำหรับไซต์ WordPress ของคุณได้ สิ่งนี้มีประโยชน์หากคุณต้องการเพิ่มตัวเลือกสำหรับธีมหรือปลั๊กอินของคุณ หรือหากคุณต้องการสร้างแผงควบคุมแบบกำหนดเองสำหรับไซต์ของคุณ

เราจะพูดถึงวิธีสร้างหน้าการตั้งค่าแบบกำหนดเองใหม่สำหรับ WordPress ในโพสต์นี้ ส่วนการตั้งค่าซึ่งเป็นส่วนหนึ่งของ API การตั้งค่าของ WordPress ช่วยให้นักพัฒนาสามารถจัดระเบียบการตั้งค่าได้โดยไปที่หัวข้อ หน้านี้ประกอบด้วยรหัสที่ใช้สร้างหน้าผู้ดูแลระบบแบบกำหนดเองในโพสต์ก่อนหน้า เราได้เพิ่มส่วนการตั้งค่าใหม่ในโค้ดด้านบนอันเป็นผลมาจากโค้ดด้านบน ฟังก์ชัน settings_fields ไม่เพียงแต่ช่วยให้คุณเพิ่มมาร์กอัปในการตั้งค่าและมาร์กอัปอินพุต แต่ยังเพิ่มความปลอดภัยด้วยการติดตามว่าใครสร้างการตั้งค่าและมาร์กอัป ในกรณีนี้ เราจะรวมโค้ดไว้ในฟังก์ชันใหม่ที่เรียกว่า admin_init เมื่อคุณพยายามบันทึกการตั้งค่า อาจเกิดข้อผิดพลาดบางอย่าง เช่น ไม่พบหน้าตัวเลือก

เนื่องจากเรายังไม่ได้ลงทะเบียนใน WordPress เราจึงยังไม่สามารถเข้าถึงฐานข้อมูล WordPress เพื่อบันทึกมูลค่าได้ ด้วยฟังก์ชัน register_setting เราจะตั้งค่าของเราใน WordPress ฟังก์ชัน get_option จะคืนค่าที่บันทึกไว้ของการตั้งค่าที่เพิ่มเข้ามา

หน้าการตั้งค่า WordPress

แท็บการตั้งค่า อยู่ในแถบด้านข้างผู้ดูแลระบบ WordPress และทำหน้าที่เป็นศูนย์กลางสำหรับการกำหนดค่าการตั้งค่าสำหรับส่วนต่างๆ ของเว็บไซต์ WordPress ในส่วนนี้ คุณจะพบแผงย่อยหลายแผง และปลั๊กอิน WordPress มักรวมหน้าการตั้งค่าไว้เป็นตัวเลือกเมนูใต้แท็บการตั้งค่า เมื่อคุณคลิกไอคอนการตั้งค่า คุณสามารถเปิดใช้งานได้ นี่คือหน้าจอทั่วไป

การสร้างปลั๊กอิน WordPress อาจเป็นประสบการณ์ที่น่าสนใจ หากคุณไม่แน่ใจว่าจะสร้างหน้าการตั้งค่าได้อย่างไร บางครั้งเราเชื่อว่าการให้ทางเลือกสำหรับทุกคนนั้นเป็นสิ่งที่ดี แม้ว่าอาจมีทางเลือกมากมายไม่รู้จบก็ตาม ในท้ายที่สุด การตัดสินใจเหล่านี้เป็นลักษณะทางเทคนิค ซึ่งเป็นตัวเลือกที่ผู้ใช้ทั่วไปไม่สามารถทำได้ API การตั้งค่าของ WordPress พร้อมใช้งานแล้วในเวอร์ชัน 2.70 วัตถุประสงค์ของฟังก์ชันเหล่านี้คือเพื่อลดความซับซ้อนในการสร้างหน้าการตั้งค่า รวมคุณลักษณะที่สามารถใช้เพื่อกำหนดตัวเลือกที่พร้อมใช้งาน รวมทั้งอินเทอร์เฟซผู้ใช้ที่จะใช้ในการแก้ไขแต่ละตัวเลือก เนื่องจากวิธีที่ดีที่สุดในการเรียนรู้คือการดูตัวอย่าง ลองใช้ API การตั้งค่าเพื่อสร้าง หน้าการตั้งค่าแรก ของเรา

ขั้นตอนต่อไปคือการเลือกแต่ละตัวเลือกที่จะปรากฏในหน้าการตั้งค่าของเรา สามารถทำได้โดยใช้สองวิธี: register_setting และ add_settings_field เราสามารถระบุชื่อของฐานข้อมูลที่เราจะบันทึกการตั้งค่าโดยทำคำสั่งนี้ นอกจากนี้ แต่ละฟิลด์ยังมีการอ้างอิงฟังก์ชัน ซึ่งบอก WordPress ว่าควรแสดงผลอย่างไร การสร้างหน้าการตั้งค่าค่อนข้างง่าย คุณสามารถป้อนฟิลด์ที่คุณต้องการใช้ในหน้าการตั้งค่าของคุณโดยใช้โปรแกรมสร้างโค้ดออนไลน์ ในตัวอย่างของเรา มีความเป็นไปได้ที่การเรียกกลับจะคล้ายกับสิ่งนี้ ตามคำแนะนำ การเรียกกลับนี้จะส่งกลับเฉพาะค่าของฟิลด์ที่ตั้งใจจะแสดงผล