อนุญาตให้ผู้ใช้ของคุณเลือกเอนทิตี Drupal ด้วยโมดูลเบราว์เซอร์เอนทิตี

ในบล็อกโพสต์นี้ ฉันจะแสดงให้คุณเห็นถึงการเปิดใช้งานผู้ใช้ Drupal เพื่อเลือกเอนทิตีโดยใช้โมดูล "Entity Browser"

บทแนะนำนี้ได้รับการร้องขอโดยลูกค้า OSTraining ที่กำลังสร้างไซต์ทบทวนหนังสือ ลูกค้าต้องการใช้ Entity Browser เพื่อสร้างคุณลักษณะนี้:

• ไซต์นี้มีเนื้อหาสองประเภท: หนังสือและบทวิจารณ์หนังสือ
• เมื่อผู้ใช้สร้างบทวิจารณ์หนังสือใหม่ พวกเขาสามารถใช้มุมมองเพื่อค้นหาและเลือกหนังสือที่พวกเขากำลังวิจารณ์ได้ ตัวอย่างเช่น หากพวกเขากำลังตรวจสอบ "สงครามและสันติภาพ" พวกเขาสามารถค้นหาโหนด "สงครามและสันติภาพ" ที่มีอยู่ได้
• เมื่อมีการเผยแพร่บทวิจารณ์หนังสือ โหนดที่เลือกจะถูกฝังอยู่ภายในบทวิจารณ์หนังสือ

คำขอของลูกค้านี้สามารถทำได้ด้วยความช่วยเหลือของโมดูล Entity Browser โมดูลนี้มีเบราว์เซอร์ที่ผู้ใช้ Drupal สามารถใช้เพื่อฝังโหนดลงในส่วนอื่นๆ ของไซต์ของตน

บทช่วยสอนนี้จะนำคุณผ่านแบบฝึกหัดการสร้างไซต์และแสดงวิธีใช้โมดูลเบราว์เซอร์เอนทิตี

ขั้นตอนที่ 1. ติดตั้งโมดูลที่จำเป็น

ในการใช้ Entity Browser คุณต้องติดตั้งโมดูลต่อไปนี้: Entity Browser และ Chaos Tools

ใช้วิธีการที่คุณต้องการเพื่อดาวน์โหลดและติดตั้งโมดูลเหล่านี้ ฉันใช้ Composer:

 composer install drupal/entity_browser

 composer install drupal/ctools

สิ่งนี้จะวางโมดูลไว้ในการติดตั้ง Drupal ของคุณ หลังจากนั้นคลิก ขยาย ค้นหาทั้งสองโมดูล เปิดใช้งาน และคลิก ติดตั้ง

ขั้นตอนที่ 2. สร้างเงื่อนไขอนุกรมวิธาน

ในตัวอย่างนี้ หนังสือถูกจัดประเภทตามประเภท ดังนั้น เราจึงจำเป็นต้องมีคำศัพท์ที่เรียกว่า "ประเภทหนังสือ"

• คลิก โครงสร้าง > อนุกรมวิธาน > เพิ่มคำศัพท์
• ตั้งชื่อคำศัพท์และคำอธิบายที่ถูกต้อง
• คลิก บันทึก

• บนแท็บ รายการ คลิก เพิ่มคำ

เพิ่มเงื่อนไขต่อไปนี้:

• การผจญภัย
• หนังสือสอนทำอาหาร
• ละคร
• แฟนตาซี
• สยองขวัญ

ขั้นตอนที่ #3 สร้างประเภทเนื้อหาหนังสือ

ต่อไปเราจะสร้างประเภทเนื้อหาสำหรับหนังสือของเรา เราจะใช้อนุกรมวิธานประเภทหนังสือที่เราสร้างขึ้นในขั้นตอนก่อนหน้า

• คลิก โครงสร้าง > ชนิดเนื้อหา > เพิ่มชนิดเนื้อหา
• สร้างประเภทเนื้อหาที่เรียกว่า Book และเพิ่มฟิลด์เหล่านี้ด้วยการตั้งค่าเริ่มต้น:

• คลิก เพิ่มฟิลด์ อีกครั้ง
• ในรายการดรอปดาวน์ภายใต้ การอ้างอิง เลือก คำศัพท์อนุกรมวิธาน และกำหนดป้ายกำกับที่เหมาะสม
• คลิก บันทึกและดำเนินการต่อ

• ปล่อย จำนวนค่าที่อนุญาตไว้ ที่ 1 แล้วคลิก บันทึกการตั้งค่าฟิลด์
• เลื่อนลงไปที่ด้านล่างของหน้าจอแก้ไขและเลือกคำศัพท์ที่คุณต้องการอ้างอิงในประเภทเนื้อหาของคุณ ในกรณีนี้: ประเภทหนังสือ
• คลิก บันทึกการตั้งค่า

• คลิกแท็บ การแสดงแบบฟอร์มจัดการ
• มองหาช่อง ประเภทหนังสือ และเปลี่ยนวิดเจ็ตเป็น ช่องทำเครื่องหมาย / ปุ่มตัวเลือก
• คลิก บันทึก

ขั้นตอนที่ #4 สร้างเนื้อหา หนังสือ

ตอนนี้ได้เวลาสร้างหนังสือ 5-10 เล่มและมอบหมายหนังสือแต่ละเล่มให้เป็นหนังสือประเภทใดประเภทหนึ่ง

• คลิก เนื้อหา > เพิ่มเนื้อหา > หนังสือ

ขั้นตอนที่ #5 สร้างมุมมอง

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

• คลิก โครงสร้าง > มุมมอง > เพิ่มมุมมอง
• สร้างมุมมองด้วยชื่อ หนังสือที่มีจำหน่าย
• แสดงเนื้อหา ประเภท หนังสือ
• ยกเลิกการเลือกการตั้งค่าเพจและบล็อก
• คลิก บันทึกและแก้ไข

• คลิกปุ่ม เพิ่ม ใต้ส่วนการ แสดง ผล
• เลือก เอนทิตีเบราว์เซอร์

• คลิก จัดเรียงใหม่ นอกเหนือจากเกณฑ์ SORT และลบ เนื้อหา: เขียน ตามเกณฑ์การอธิบาย
• คลิกสมัคร
• คลิก ADD นอกเหนือจากเกณฑ์ของตัวกรอง แล้วเลือกฟิลด์ ประเภทหนังสือ
• คลิก เพิ่มและกำหนดค่าเกณฑ์การกรอง

• ตรวจสอบให้แน่ใจว่าได้เลือก คำศัพท์ประเภทหนังสือ แล้ว
• เปลี่ยน ประเภทการเลือก เป็น ดรอปดาวน์
• คลิก สมัครและดำเนินการต่อ

• ทำเครื่องหมาย ที่เปิดเผยตัวกรองนี้แก่ผู้เยี่ยมชม เพื่อให้พวกเขาสามารถเปลี่ยนแปลงได้
• ตรวจสอบให้แน่ใจว่าได้เลือก Operator เป็น Is one of
• คลิก สมัคร

• เพิ่มฟิลด์ ชื่อ ลงในเกณฑ์ SORT
• ปล่อยให้การกำหนดค่าเริ่มต้น เรียงจากน้อยไปมาก แล้วคลิก นำไปใช้

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

• คลิกปุ่ม เพิ่ม ในส่วน ฟิลด์
• มองหาช่องปกหนังสือแล้วคลิก เพิ่มและกำหนดค่าช่อง

• เลือก รูปแบบรูปภาพ (ภาพขนาดย่อ 100x100) แล้วคลิก นำไปใช้
• คลิก เพิ่ม อีกครั้งเพื่อเพิ่มฟิลด์ แบบฟอร์มการเลือกกลุ่มของเบราว์เซอร์เอนทิตี
• คลิก เพิ่มและกำหนดค่าฟิลด์

• คลิก สมัคร

จำเป็นต้องใช้ฟิลด์นี้หากคุณต้องการใช้ Entity Browser ดังนั้นให้ใส่ใจเป็นพิเศษกับสิ่งนี้

• เปลี่ยนรูปแบบของมุมมอง เช่น เป็น Grid
• คลิก สมัคร สองครั้ง

การกำหนดค่ามุมมองใน Views UI ควรมีลักษณะเหมือนภาพด้านล่าง คลิก บันทึก เพื่อบันทึกมุมมอง

ขั้นตอนที่ #6 กำหนดค่าโมดูลเอนทิตีเบราว์เซอร์

ในขั้นตอนนี้ เราจะเลือกการตั้งค่าโมดูลหลักในบทช่วยสอนนี้: เบราว์เซอร์เอนทิตี

• คลิก การกำหนดค่า > เบราว์เซอร์เอนทิตี

• คลิก เพิ่มเบราว์เซอร์เอนทิตี
• กำหนดป้ายกำกับที่เหมาะสม เช่น Book browser
• เป็นปลั๊กอินการแสดงผล เลือก iFrame
• คลิก ถัดไป

• กาเครื่องหมาย เปิดเบราว์เซอร์เอนทิตีอัตโนมัติ แล้วคลิก ถัดไป

• คลิก ถัดไป อีกสองครั้งจนกว่าคุณจะไปถึงหน้าการกำหนดค่า วิดเจ็ต
• คลิกรายการแบบเลื่อนลงเพื่อเลือก ดู ปลั๊กอินวิดเจ็ต
• เปลี่ยนป้ายกำกับของวิดเจ็ต เช่น "เลือกหนังสือ"
• เลือกมุมมองที่คุณกำหนดค่าในขั้นตอน #5
• คลิก เสร็จสิ้น

ขั้นตอนที่ #7 สร้างประเภทเนื้อหาบทวิจารณ์หนังสือ

เว็บไซต์ของเราใกล้จะเสร็จสมบูรณ์แล้ว ก่อนที่เราจะเสร็จสิ้น เราจำเป็นต้องสร้างประเภทเนื้อหาที่ผู้ตรวจทานหนังสือสามารถใช้ได้:

• คลิก โครงสร้าง > ชนิดเนื้อหา > เพิ่มชนิดเนื้อหา
• ตั้งชื่อเนื้อหาประเภทนี้ บทวิจารณ์หนังสือ
• เพิ่มฟิลด์ใหม่ จากส่วน อ้างอิง ให้เลือก เนื้อหา
• กำหนดป้ายกำกับที่เหมาะสมให้กับฟิลด์นี้ เช่น หนังสือ
• คลิก บันทึกและดำเนินการต่อ
• ในตัวเลือก ประเภทของรายการที่จะอ้างอิง เลือก เนื้อหา
• คลิก บันทึกการตั้งค่าฟิลด์

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

โปรดสังเกตว่าคุณยังมีตัวเลือกในการแสดงเฉพาะ ป้ายกำกับเอนทิตี หรือ เอนทิตีที่แสดงผลแบบเต็ม คุณสามารถใช้โหมดการดู (เช่น ทีเซอร์) เพื่อนำเสนอเอนทิตีในประเภทเนื้อหา บทวิจารณ์หนังสือ ใหม่นี้

ขั้นตอนที่ #8 สร้างบทวิจารณ์หนังสือ

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

• คลิก เนื้อหา > เพิ่มเนื้อหา > รีวิวหนังสือ
• ตั้งชื่อโหนดนี้และข้อความเนื้อหาที่เหมาะสม
• เลื่อนลงไปอีกและคุณจะพบส่วนที่ยุบเรียกว่า THE BOOK (นั่นคือชื่อของฟิลด์)
• คลิกฟิลด์นี้และคุณจะเห็น Entity Browser ซึ่งคุณสามารถเลือกหนังสือที่คุณกำลังอ้างอิงในบทวิจารณ์หนังสือเล่มนี้ได้
• นอกจากนี้ยังมีตัวกรองเปิดด้านบนเพื่อให้คุณสามารถเลือกหนังสือที่เกี่ยวข้องกับประเภทเดียวเท่านั้น
• เลือกประเภทและคลิก นำไปใช้

เบราว์เซอร์จะแสดงเฉพาะหนังสือในประเภทนี้เท่านั้น

• เลือกหนังสือแล้วคลิก เลือกเอนทิตี

• หลังจากฝังเอนทิตีแล้ว ให้คลิก บันทึก แล้วคุณจะเห็นเอนทิตี หนังสือ ที่อ้างอิงบนโหนดการ ตรวจทานหนังสือ

บทช่วยสอนนี้แสดงให้เห็นถึงพลังของโมดูล "Entity Browser" สำหรับ Drupal 8 ฉันหวังว่าคุณจะชอบมัน ขอบคุณที่อ่าน!