เพิ่มคุณสมบัติของไซต์ที่กำหนดเอง

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

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

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

1. เปิดไซต์เพื่อแก้ไข

2. คลิก ในแถบด้านข้าง แล้วคลิก คุณสมบัติของไซต์

3. คลิก เพิ่ม
4. ป้อนชื่อและค่าสำหรับคุณสมบัติของไซต์ที่กำหนดเอง คุณสามารถเพิ่มคุณสมบัติของไซต์ที่กำหนดเองได้สูงสุด 50 รายการ โดยในฟิลด์ชื่อมีขีดจำกัดของอักขระอยู่ที่ 200 ตัว และฟิลด์ค่ามีขีดจำกัดของอักขระอยู่ที่ 2000 ตัว

   

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

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

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

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

define([
    'jquery'
], function( $ ){
    'use strict';

    function SectionLayout( params ) {
    }
    SectionLayout.prototype = {
        render: function( parentObj ) {
            var html = '';

            try {
                html += '<div>';
                    html += '<h1>' + SCSRenderAPI.getCustomSiteProperty('SiteGreeting') + '</h1>;
                    html += '<div>For more information, contact <a href="mailto:' + SCSRenderAPI.getCustomSiteProperty('ContactEmail')
                        '"> + SCSRenderAPI.getCustomSiteProperty('ContactName') + '</a></div>';
                html += '</div>';
                $(parentObj).append( html );
            } catch( e ) {
                console.error( e );
            }
        },
    };

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