เอกสารสำหรับนักพัฒนา
เทมเพลตการพิมพ์ 

รุ่น 3.0.1 ขึ้นไป
การเพิ่มเทมเพลตที่กำหนดเอง:

ในการเริ่มต้นแม่แบบที่กำหนดเองหลังจากโหลด zprint call wp hook zprint_loaded

สิ่งนี้จะป้องกันข้อผิดพลาดในการโหลดปลั๊กอินโดยใช้ zprint API add_action ('zprint_loaded', 'your_plugin_init_function_name');

ตอนนี้แอ็คชัน zprint_loaded - wp จะถูกเรียกใช้หลังจากโหลด zprint สำเร็จ

\ Zprint \ Templates :: registerTemplate - วิธีการคงที่ต้องใช้วัตถุดำเนินการอินเตอร์เฟซ `\ Zprint \ Template \ Index`

แม่แบบ \ ดัชนี \ Zprint \

จำเป็นต้องใช้วิธีการในชั้นเรียนของคุณ:
getName () - ส่งคืนชื่อเทมเพลตของคุณ (สตริง)
getSlug () - กระสุนคืน (สตริง)
getPath ($format) - ยอมรับ $format (`ธรรมดา ',` html`), ส่งคืนพา ธ ไปยังไฟล์เลย์เอาต์ (สตริง)
getFormats () - ส่งคืนอาร์เรย์ของรูปแบบ assoc ระบุรูปแบบที่สนับสนุนประเภทแม่แบบของคุณตัวอย่างเช่น:
['html' => true, 'plain' => false].

รองรับรูปแบบที่กำหนดเอง (เช่น: html): ['key_format' => 'ชื่อรูปแบบ']

สำหรับตัวเลือกที่กำหนดเองสำหรับแม่แบบของคุณให้ใช้ แม่แบบ \ Options \ Zprint \ อินเตอร์เฟซ, renderOptions, processOptions วิธีการ
renderOptions ($options) - ยอมรับตัวเลือกปัจจุบัน assoc array ควรแสดงผล html ด้วยอินพุตเพื่อแสดงในรูปแบบตำแหน่ง
processOptions ($options) - ยอมรับอาร์เรย์ assoc ตัวเลือกปัจจุบันควรส่งคืนอาร์เรย์ assoc ใหม่พร้อมข้อมูล คุณสามารถเข้าถึงข้อมูลใหม่ได้โดย $_POST

ในแต่ละไฟล์เทมเพลตคุณสามารถเข้าถึงข้อมูลและตัวแปรการตั้งค่าบางอย่าง
$templateOptions - อาร์เรย์ assoc รวมถึงตัวเลือกเทมเพลตปัจจุบัน

เกี่ยวกับการตั้งค่าการจัดส่ง:

$location_data [ 'การจัดส่งสินค้า'] [ 'วิธีการ'] - แสดงวิธีการจัดส่ง
$location_data [ 'จัดส่ง'] [ 'billing_shipping_details'] - แสดงรายละเอียดการเรียกเก็บเงินและการจัดส่ง
$location_data [ 'จัดส่ง'] [ 'customer_details'] - แสดงรายละเอียดลูกค้า
$location_data [ 'การจัดส่งสินค้า'] [ 'ค่าใช้จ่าย'] - แสดงค่าจัดส่ง

วิธีการและฟังก์ชั่นที่เป็นประโยชน์เพิ่มเติม:

\ Zprint \ get_appearance_setting ($name)ยอมรับการตั้งค่าชื่อจาก ทั่วไป แถบ การตั้งค่าการพิมพ์.

ชื่อที่อนุญาต: เครื่องหมาย,หัวสั่งซื้อตรวจสอบส่วนหัวชื่อ บริษัทข้อมูล บริษัทส่วนหัวรายละเอียดการสั่งซื้อข้อมูลส่วนท้าย #1ข้อมูลส่วนท้าย #2

ส่งคืนสตริงหรือพา ธ src สำหรับ เครื่องหมาย

\ Zprint \ สั่งซื้อ :: getHiddenKeys () ส่งคืนอาร์เรย์ของคีย์สำหรับเมตารายการสั่งซื้อ (item_meta จาก $order-> get_items ()) ซึ่งไม่ควรแสดง

คุณสามารถใช้กุญแจของตัวเองได้โดย woocommerce_hidden_order_itemmeta กรอง.

รูปแบบเอาท์พุทธรรมดา:

ชั้น \ Zprint \ เอกสาร รวมถึงวิธีการแบบคงที่เพื่อจัดรูปแบบสตริง:

เอกสาร :: centerline ($string) - สตริงที่อยู่กึ่งกลางเครื่องพิมพ์
เอกสาร :: EMPTYLINE () = พิมพ์สตริงว่าง
เอกสาร :: symbolsAlign ($left, $right) - พิมพ์สองส่วนสตริงเข้าร่วมโดยช่องว่างในรูปแบบคอลัมน์
เอกสาร :: สาย ($string) - สายอักขระการพิมพ์ในบรรทัด

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

 

ตัวอย่างเทมเพลตที่กำหนดเอง
ซื้อ ตัวอย่างเทมเพลตการพิมพ์สำหรับปลั๊กอิน GCP WooCommerce

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

รุ่นเก่า 2.1.2
การเพิ่มเทมเพลตที่กำหนดเอง:

กรอง Zprint \ getTemplatesยอมรับ $templates - รายการแม่แบบพื้นฐาน
Return assoc array (template label => ชื่อเทมเพลต) ช่วยให้คุณสามารถเพิ่มเทมเพลตของคุณในรายการแบบหล่นลงที่เลือก

การใช้เทมเพลตใหม่:
add_filter ('Zprint \ getTemplates', ฟังก์ชัน ($templates) {
	$templates['แฟนซี'] = 'แฟนซี';
	กลับ $templates;
});

นอกจากนี้คุณต้องระบุเส้นทางไปยังแม่แบบของคุณ

กรอง Zprint \ getTemplatePathยอมรับ $templatePath - เส้นทางแม่แบบพื้นฐาน (ลองค้นหาแม่แบบในไดเรกทอรีเริ่มต้น) $template - ป้ายกำกับเทมเพลต (แฟนซี ในตัวอย่าง) $format - รูปแบบผลลัพธ์ HTML หรือ ที่ราบ.

ส่งคืนพา ธ สัมบูรณ์ไปยังแม่แบบ

เส้นทางการตั้งค่า:
add_filter ('Zprint \ getTemplatePath', ฟังก์ชัน ($path, $template, $format) {
	ถ้า ($template === 'แฟนซี') {
		$path = __DIR__ . '/ template-' . $format . '.php';
	}
	กลับ $path;
}, 10, 3);

ในแต่ละไฟล์เทมเพลตคุณสามารถเข้าถึงข้อมูลและตัวแปรการตั้งค่าบางอย่าง

$order - ตัวอย่างของ \ WC_Orderคุณสามารถรับข้อมูลเกี่ยวกับการสั่งซื้อจาก WC ตรวจสอบเอกสาร WC สำหรับการอ้างอิงสำหรับข้อมูลเพิ่มเติม

$location_details - อาร์เรย์ assoc มีการตั้งค่ามากมาย ตัวอย่างเช่นรูปแบบการตั้งค่าแบบอักษรการจัดส่ง

สำหรับการตั้งค่าแบบอักษร (css) คุณสามารถใช้นามแฝงเหล่านี้: $fontSize$fontWeight$headerSize$headerWeight

เกี่ยวกับการตั้งค่าการจัดส่ง:

$location_data [ 'การจัดส่งสินค้า'] [ 'วิธีการ'] - แสดงวิธีการจัดส่ง
$location_data [ 'จัดส่ง'] [ 'billing_shipping_details'] - แสดงรายละเอียดการเรียกเก็บเงินและการจัดส่ง
$location_data [ 'จัดส่ง'] [ 'customer_details'] - แสดงรายละเอียดลูกค้า
$location_data [ 'การจัดส่งสินค้า'] [ 'ค่าใช้จ่าย'] - แสดงค่าจัดส่ง

วิธีการและฟังก์ชั่นที่เป็นประโยชน์เพิ่มเติม:

\ Zprint \ get_appearance_setting ($name)ยอมรับการตั้งค่าชื่อจาก ทั่วไป แถบ การตั้งค่าการพิมพ์.

ชื่อที่อนุญาต: เครื่องหมาย,หัวสั่งซื้อตรวจสอบส่วนหัวชื่อ บริษัทข้อมูล บริษัทส่วนหัวรายละเอียดการสั่งซื้อข้อมูลส่วนท้าย #1ข้อมูลส่วนท้าย #2

ส่งคืนสตริงหรือพา ธ src สำหรับ เครื่องหมาย

\ Zprint \ สั่งซื้อ :: getHiddenKeys () ส่งคืนอาร์เรย์ของคีย์สำหรับเมตารายการสั่งซื้อ (item_meta จาก $order-> get_items ()) ซึ่งไม่ควรแสดง

คุณสามารถใช้กุญแจของตัวเองได้โดย woocommerce_hidden_order_itemmeta กรอง.

รูปแบบเอาท์พุทธรรมดา:

ชั้น \ Zprint \ เอกสาร รวมถึงวิธีการแบบคงที่เพื่อจัดรูปแบบสตริง:

เอกสาร :: centerline ($string) - สตริงที่อยู่กึ่งกลางเครื่องพิมพ์
เอกสาร :: EMPTYLINE () = พิมพ์สตริงว่าง
เอกสาร :: symbolsAlign ($left, $right) - พิมพ์สองส่วนสตริงเข้าร่วมโดยช่องว่างในรูปแบบคอลัมน์
เอกสาร :: สาย ($string) - สายอักขระการพิมพ์ในบรรทัด

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