Widget

Sidebar
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.

#Add

static function Sidebar::add($args);

$args (array) biến mở rộng bao gồm

[id] (string) id sidebar

[name] (string) Tên sidebar

[description] (string) mô tả sidebar

Sidebar::add(['id' => 'home-sidebar', 'Sidebar trang chủ');

#Display

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

static function Sidebar::render($id);

#Create

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
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	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

#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.

static function Widget::add($widget_id);