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

สำคัญ (1): หากไม่มีผู้ใช้เข้าสู่ระบบในฐานะผู้ดูแลระบบ (superuser) ปุ่มจะแสดงขึ้นก็ต่อเมื่อมีการตั้งค่านี้อย่างชัดเจนในการตั้งค่าปลั๊กอิน! โดยค่าเริ่มต้น ผู้ใช้จะต้องเข้าสู่ระบบเพื่อดูปุ่ม

สำคัญ (2): คุณไม่สามารถเข้าสู่ระบบจากปลั๊กอินนี้ได้ คุณต้องเข้าสู่ระบบโดยใช้การเข้าสู่ระบบเพื่อเข้าสู่แดชบอร์ดผู้ดูแลระบบ เมื่อไม่ได้เข้าสู่ระบบ กล่องโต้ตอบการเข้าสู่ระบบจะแสดงจาก GRAV CMS

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

ความต้องการ
ปลั๊กอินนี้ต้องการให้คุณติดตั้งและเปิดใช้งานปลั๊กอินต่อไปนี้:

ผู้ดูแลระบบ
เข้าสู่ระบบ
การติดตั้ง
การติดตั้งปลั๊กอินปุ่มแก้ไขส่วนหน้าสามารถทำได้หลายวิธี วิธีการติดตั้ง GPM (Grav Package Manager) ช่วยให้คุณติดตั้งปลั๊กอินได้อย่างรวดเร็วและง่ายดายด้วยคำสั่งเทอร์มินัลอย่างง่าย ในขณะที่วิธีการแบบแมนนวลทำให้คุณสามารถทำได้ผ่านไฟล์ zip

การติดตั้ง GPM (แนะนำ) **
วิธีที่ง่ายที่สุดในการติดตั้งปลั๊กอินนี้คือผ่าน Grav Package Manager (GPM) ผ่านเทอร์มินัลของระบบ (หรือที่เรียกว่าบรรทัดคำสั่ง) จากรูทของประเภทการติดตั้ง Grav ของคุณ:

bin/gpm ติดตั้ง frontend-edit-button
สิ่งนี้จะติดตั้งปลั๊กอินปุ่มแก้ไข Frontpage ลงในไดเร็กทอรี /user/plugins ของคุณภายใน Grav ไฟล์ของมันสามารถพบได้ใน /your/site/grav/user/plugins/grav-frontend-edit-button

Git โคลน
ในโฟลเดอร์ผู้ใช้/ปลั๊กอินของไซต์ของคุณ:

โคลน git https://github.com/enovision/grav-frontend-edit-button
การติดตั้งด้วยตนเอง
ในการติดตั้งปลั๊กอินนี้ ให้ดาวน์โหลดเวอร์ชัน zip ของที่เก็บนี้และเปิดเครื่องรูดภายใต้ /your/site/grav/user/plugins จากนั้นเปลี่ยนชื่อโฟลเดอร์เป็น grav-frontend-edit-button คุณสามารถค้นหาไฟล์เหล่านี้ได้ที่ GitHub หรือทาง GetGrav.org

ตอนนี้คุณควรมีไฟล์ปลั๊กอินทั้งหมดภายใต้

/your/site/grav/user/plugins/grav-frontend-edit-button
หมายเหตุ: ปลั๊กอินนี้เป็นส่วนประกอบแบบแยกส่วนสำหรับ Grav ซึ่งต้องใช้ Grav และข้อผิดพลาดและปัญหาในการทำงาน

การกำหนดค่า
ก่อนกำหนดค่าปลั๊กอินนี้ คุณควรคัดลอก user/plugins/grav-frontend-edit-button/grav-frontend-edit-button.yaml ไปยัง user/config/plugins/grav-frontend-edit-button.yaml และแก้ไขเท่านั้น สำเนา.

นี่คือการกำหนดค่าเริ่มต้นและคำอธิบายของตัวเลือกที่มี:

เปิดใช้งาน: จริง
ตำแหน่งของปุ่ม มีตัวเลือกดังต่อไปนี้:

(tr) ขวาบน (ค่าเริ่มต้น)
(tl) บนซ้าย
(br) ล่างขวา
(bl) ล่างซ้าย
ตำแหน่ง: tr
แสดงฉลากบนปุ่ม

showLabel: จริง
แสดงไอคอน (ต้องโหลด Fontawesome มันใช้งานได้เมื่อคุณติดตั้งปลั๊กอิน Markdown Font Awesome)

ไอคอนแสดง: จริง
สำคัญ: เมื่อปิดใช้งานทั้ง showLabel และ showIcon จะใช้ showLabel = true ภายในโดยอัตโนมัติ

มองเห็นได้เฉพาะหลังจากเข้าสู่ระบบ

ต้องการAuth: true
การใช้งาน
เมื่อเปิดใช้งานปลั๊กอินแล้ว ไม่ต้องทำอะไรอีก มันจะแสดงปุ่มบนหน้าส่วนหน้า

อย่างไรก็ตาม เป็นไปได้ที่จะปิดการแก้ไขส่วนหน้าต่อหน้าโดยเพิ่มสิ่งต่อไปนี้ในส่วนหัวของหน้า ( frontmatter):

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

การรีเฟรชนี้จะดำเนินการเสมอเมื่อคุณออกจากแท็บ (เบลอ) และคลิกกลับ (โฟกัส) บนแท็บที่มีหน้าที่นำเสนอ

CSS และ JavaScript
CSS และ JavaScript ที่จำเป็นจะถูกโหลดก็ต่อเมื่อปลั๊กอินตรงตามข้อกำหนดสำหรับการดำเนินการ

CSS
คุณสามารถเปลี่ยนสไตล์ของปุ่มได้โดยแก้ไขไฟล์ style.scss ในโฟลเดอร์ scss จำเป็นต้องมีแท็ก CSS ต่อไปนี้เหมือนเดิม:

frontend-edit-button {

position: fixed;
z-index: 10000;
padding: 5px;
}

frontend-edit-button.top {

top: 0;
}

frontend-edit-button.bottom {

bottom: 0;
}

frontend-edit-button.left {

left: 0;
}

frontend-edit-button.right {

right: 0;
}
คุณสามารถคอมไพล์ SASS ได้โดยเข้าไปที่รูทของโฟลเดอร์ /assets ของปลั๊กอินนี้ ./sass.cmd คุณต้องมีคอมไพเลอร์ติดตั้งอยู่

i18n
มีไฟล์ภาษาสำหรับรองรับหลายภาษา

เครดิต
ทีมงาน GRAV CMS ที่น่าทึ่งสำหรับการสร้าง CMS ที่น่าทึ่ง
Nick Bell สำหรับการแก้ไขข้อผิดพลาดบางเส้นทาง
Christian Bewernitz สำหรับเพิ่มตัวเลือกข้อกำหนดการเข้าสู่ระบบ (เวอร์ชัน 1.0.7)