Chuyển tới nội dung chính

Post

Trang danh sách post​

Thay đổi ở v8: hai hook admin_post_{postType}_controllers_index_args và admin_post_{postType}_controllers_index_objects đã bị gỡ bỏ, và tham số truyền vào không còn là Qr (lớp này không còn tồn tại) mà là Eloquent Query Builder.

Muốn can thiệp điều kiện lấy danh sách, hãy override queryFilter() trong lớp Table của module.

Điều kiện lấy total​

Thay đổi điều kiện query dùng để đếm tổng số post cho phân trang. Đây là hook động — tên hook ghép theo postType.

HooksLoại HookPlatformVersion
admin_post_{postType}_controllers_index_args_before_countfiltercms7.0.0
$query = apply_filters('admin_post_'.$postType.'_controllers_index_args_before_count', $query);

Params: $query (SkillDo\Database\Eloquent\Builder)

Return: $query

use SkillDo\Database\Eloquent\Builder;

add_filter('admin_post_post_controllers_index_args_before_count', function (Builder $query) {
    return $query->where('featured', 1);
});

Loại trừ cột khi select​

Thay đổi danh sách cột bị loại trừ khỏi câu select của bảng danh sách post.

HooksLoại HookPlatformVersion
admin_post_{postType}_select_exclusionfiltercms8.0.0
$postSelect = apply_filters('admin_post_'.$postType.'_select_exclusion', [...]);

Form lọc & tìm kiếm​

HooksLoại HookPlatformVersion
admin_post_table_form_filterfiltercms8.0.0
admin_post_table_form_searchfiltercms8.0.0
$form = apply_filters('admin_post_table_form_filter', $form, $postType, $cateType);
$form = apply_filters('admin_post_table_form_search', $form, $request, $postType, $cateType);
admin_post_action_bar_heading​

Tạo ra danh sách buttons dưới tiêu đề trang

Loại HookPlatformVersion
do_actioncms6.0.0
do_action('admin_post_{postType}_action_bar_heading');

Return: mã html

function my_custom_admin_post_buttons_heading($buttons): array
{
    echo Admin::button('white', [
        'text' => 'Button Demo',
        'icon' => '<i class="fa-light fa-calendar-clock"></i>'
    ]);
            
    return $buttons;
}
add_action('admin_post_post_action_bar_heading', 'my_custom_admin_post_buttons_heading', 10);

table buttons bulk​

Tạo ra danh sách buttons bulk, là những button khi người dùng chọn nhiều row trên table

Loại HookPlatformVersion
apply_filterscms7.0.0
$buttons = apply_filters('table_post_bulk_action_buttons', array $buttons);

Params:

  • $buttons (array) : danh sách buttton

Return: $buttons

function my_custom_admin_post_bulk_action_buttons($buttons): array
{
    $actionList['postDelete'] = [
        'icon' => Admin::icon('delete'),
        'label' => trans('post.bulkAction.del.label'),
        'class' => 'js_btn_confirm',
        'attributes' => [
            'data-action' => 'delete',
            'data-ajax' => 'Cms_Ajax_Action::delete',
            'data-module' => 'post',
            'data-trash' => $trashEnable,
            'data-heading' => trans('post.bulkAction.del.heading'),
            'data-description' => trans('post.bulkAction.del.description'),
        ]
    ];
            
    return $buttons;
}
add_filter('table_post_bulk_action_buttons', 'my_custom_admin_post_bulk_action_buttons', 10);

table header buttons​

Tạo ra danh sách buttons trên table, là những button nằm ở header table phía tay phải

Loại HookPlatformVersion
apply_filterscms7.0.0
$buttons = apply_filters('table_post_header_buttons', array $buttons);

Params:

  • $buttons (array) : danh sách buttton

Return: $buttons

function my_custom_admin_post_table_header_buttons($buttons): array
{
    $buttons['reload'] = Admin::button('reload');
            
    return $buttons;
}
add_filter('table_post_header_buttons', 'my_custom_admin_post_table_header_buttons', 10);

table columns​

Chỉnh sữa danh sách table column của post

Loại HookPlatformVersion
apply_filterscms4.0.0
$this->_column_headers = apply_filters("manage_post_<postType>_columns", array $columnHeaders);

Params:

  • $columnHeaders (array) : danh sách column

Return: $columnHeaders

function my_custom_admin_post_table_columns($columnHeaders): array
{
    $columnHeaders['image'] = [
        'label'  => 'Hình ảnh',
        'column' => fn ($item, $args) => ColumnImage::make('image', $item, $args),
    ];
            
    return $columnHeaders;
}
add_filter('manage_post_posts_columns', 'my_custom_admin_post_table_columns');

table columns action​

Tạo ra danh sách buttons cho column action

Loại HookPlatformVersion
apply_filterscms7.0.0
$buttons = apply_filters('table_post_columns_action', array $buttons, $item);

Params:

  • $buttons (array) : danh sách buttton
  • $item (object) : đối tượng post của column hiện tại

Return: $buttons

function my_custom_admin_post_table_column_action_buttons($buttons, $item): array
{
    return $buttons;
}
add_filter('table_post_columns_action', 'my_custom_admin_post_table_column_action_buttons', 10, 2);

Thêm & Câp nhật post​

Form fields​

Thay đổi các group, các field trong form add và edit post

Loại HookPlatformVersion
apply_filterscms3.0.0
$adminForm = apply_filters("manage_post_<postType>_input", AdminFrom $adminForm);

Params:

  • $adminForm (AdminFrom) : một đối tượng AdminFrom

Return: $adminForm

function my_custom_admin_post_form(AdminFrom $adminForm): array
{
    $adminForm->right
        ->group('seo')
        ->addField('meta', 'text', ['label' => 'Thẻ meta'])
                
    return $adminForm;
}
add_filter('manage_post_post_input', 'my_custom_admin_post_table_column_action_buttons', 10, 2);

Thêm post thành công​

Giúp bạn thực hiện một hành động sau khi thêm post thành công

Loại HookPlatformVersion
do_actioncms7.0.0
do_action('save_post_object_add', $id, SkillDo\Http\Request $request);

Params:

  • $id (int) : id của post vừa thêm thành công
  • $request (Request) : đối tượng request
function my_custom_admin_add_post_success($id, SkillDo\Http\Request $request) : void
{
    //to do...
}
add_action('save_post_object_add', 'my_custom_admin_add_post_success', 10, 2);

Cập nhật post thành công​

Giúp bạn thực hiện một hành động sau khi cập nhật post thành công

Loại HookPlatformVersion
do_actioncms7.0.0
do_action('save_post_object_edit', $id, SkillDo\Http\Request $request);

Params:

  • $id (int) : id của post vừa cập nhật thành công
  • $request (Request) : đối tượng request
function my_custom_admin_edit_post_success($id, SkillDo\Http\Request $request) : void
{
    //to do...
}
add_action('save_post_object_edit', 'my_custom_admin_edit_post_success', 10, 2);