Widget

widget thêm nội dung và các tính năng cho sidebar hoặc các lĩnh vực được tiện ích hoá trong giao diện của bạn. Vật dụng được thiết kế để cung cấp một cách đơn giản và dễ dàng sử dụng cho thiết kế và cấu trúc điều khiển của giao diện Skilldo cho người dùng mà không đòi hỏi họ phải biết code.

Register Widget Area

register_sidebar([
    'id'          => 'sidebar_name',
    'name'        => __('Sidebar Name'),
    'description' => __('This the description for widget area'),
]);

#Source

src/
├── ...
└── application/
    └── helpers/
        └── template_helper.php

Display Widget Area

Hiển thị widget thuộc sidebar đã đăng ký

function dynamic_sidebar( $index )

#Source

src/
├── ...
└── application/
    └── helpers/
        └── template_helper.php

Create Widget

This widget will be created in /views/<current active theme>/widgets/<widget name>.

Tip

Sau khi hoàn thảnh widget bạn có thể đóng gói và gửi cho đội ngũ phát triển kiểm tra để có thể xuất hiện trên store skilldo.

Widget class

để tạo ra một widget SkillDo là thừa kế Widget class. Bằng cách này bạn có thể sử dụng các chức năng được xây dựng trong để cập nhật các widget, Hiển thị các widget và tạo ra một giao diện quản trị cho widget.

<?php
class Text_Widget extends Widget {
     
    // widget constructor
    public function __construct(){

        parent::__construct('widget_key', 'Label widget', widget_config);
    }
    
    public function widget( $options ) {
        // outputs the content of the widget
    }
    
    public function form( $left = array(), $right = array() ) {
        // creates the back-end form
    }
    public function update( $new_instance, $old_instance ) {
        // processes widget options on save
    }
}

Các chức năng cụ thể

Function	Description
__construct	Hàm này khai báo thông tin widget `widget_key` : ID của widget `Label widget` : Tên hiển thị widget trong admin `widget_config` : Là một mãng các tham số cấu hình cho widget Các tham số widget_config bao gồm `container` : Tự động thêm các trường container cho widget `grid` : Tự động thêm các trường grid cho widget `position` : (left/right) Vị trí các trường container, grid `remove` : mãng các trường muốn xóa Tham số widget_config chỉ hỗ trợ từ phiên bản SkillDo 3.0.9 trở lên
widget	Hàm này chịu trách nhiệm cho việc hiển thị ở front-end của widget. Nó xuất ra nội dung của các widget
form	Phương thức/hàm form() được sử dụng để xác định form widget ở back-end mà bạn nhìn thấy trong bảng điều khiển của Widget trong bảng điều khiển. Form này cho phép người dùng thiết lập các tiêu đề và các tùy chọn khác cho widget.
update	Phương thức này chỉ hỗ trợ từ phiên bản SkillDo 3.0.4 trở lên Xử lý các tùy chọn của widget khi lưu lại. Sử dụng hàm này để cập nhật widget của bạn (tùy chọn). Hàm này phải cần hai tham số: `$new_instance` - Các giá trị chỉ gửi đi để được lưu lại. Những giá trị này sẽ đến từ form được định nghĩa trong phương thức form() `$old_instance` - những giá trị đã được lưu lại trước đó từ cơ sở dữ liệu

#Source

src/
├── ...
└── application/
    └── libraries/
        └── widget.php

Register widget

Sau khi hoàn tất widget bạn phải đăng ký widget với cms để có thể bắt đầu sử dụng widget đã tạo ra.

function register_widget( 'Text_Widget' );

#Source

src/
├── ...
└── application/
    └── helpers/
        └── template_helper.php