Thêm mục trợ giúp WordPress admin

5 giờ ago, WordPress Plugin, 1 Views
Thêm mục trợ giúp WordPress admin

Thêm Mục Trợ Giúp (Help Tab) Tùy Chỉnh vào WordPress Admin

WordPress cung cấp một giao diện quản trị mạnh mẽ và thân thiện với người dùng. Tuy nhiên, đôi khi bạn muốn cung cấp thêm thông tin trợ giúp cụ thể cho khách hàng hoặc thành viên trong nhóm, giải thích các tùy chọn tùy chỉnh của chủ đề hoặc plugin của bạn. Một cách tuyệt vời để thực hiện điều này là thêm các tab trợ giúp tùy chỉnh vào màn hình quản trị WordPress. Bài viết này sẽ hướng dẫn bạn từng bước cách thêm mục trợ giúp tùy chỉnh vào WordPress admin.

Tại Sao Nên Thêm Mục Trợ Giúp Tùy Chỉnh?

Việc thêm mục trợ giúp tùy chỉnh vào WordPress admin mang lại nhiều lợi ích, bao gồm:

  • Cải thiện trải nghiệm người dùng: Cung cấp thông tin hướng dẫn rõ ràng và dễ tiếp cận ngay trong giao diện quản trị giúp người dùng dễ dàng hiểu và sử dụng các tính năng của website.
  • Giảm bớt yêu cầu hỗ trợ: Bằng cách trả lời các câu hỏi thường gặp ngay trong admin, bạn có thể giảm số lượng yêu cầu hỗ trợ mà bạn nhận được.
  • Nâng cao tính chuyên nghiệp: Mục trợ giúp tùy chỉnh được thiết kế tốt giúp website của bạn trông chuyên nghiệp và được chăm sóc kỹ lưỡng hơn.

Các Bước Thực Hiện

Để thêm một mục trợ giúp tùy chỉnh, bạn cần sử dụng WordPress hooks. Hook add_action được sử dụng để thêm một hàm tùy chỉnh vào một hành động hiện có của WordPress, trong trường hợp này là hiển thị mục trợ giúp. Dưới đây là các bước chi tiết:

Bước 1: Xác định Màn Hình Quản Trị Mục Tiêu

Trước khi thêm mục trợ giúp, bạn cần xác định màn hình quản trị nào mà bạn muốn hiển thị mục trợ giúp đó. Mỗi màn hình quản trị có một ID duy nhất. Bạn có thể tìm ID màn hình bằng nhiều cách. Một cách đơn giản là sử dụng hàm get_current_screen() trong WordPress.

Ví dụ:


  function get_current_screen_id() {
    $screen = get_current_screen();
    if ( $screen ) {
      return $screen->id;
    }
    return '';
  }

  add_action( 'admin_init', function() {
    $screen_id = get_current_screen_id();
    if ( $screen_id ) {
      error_log( 'Current Screen ID: ' . $screen_id ); // Ghi vào log để xem ID màn hình
    }
  });

Đoạn code trên sẽ ghi ID màn hình hiện tại vào file log của WordPress. Bạn có thể xem file log này để lấy ID màn hình mà bạn cần.

Một số ID màn hình phổ biến:

  • dashboard: Trang tổng quan
  • post: Trang chỉnh sửa bài viết
  • edit-post: Trang danh sách bài viết
  • page: Trang chỉnh sửa trang
  • edit-page: Trang danh sách trang
  • themes: Trang giao diện
  • plugins: Trang plugin

Bước 2: Tạo Hàm Thêm Mục Trợ Giúp

Sau khi bạn đã xác định được ID màn hình, bạn có thể tạo một hàm để thêm mục trợ giúp. Hàm này sẽ sử dụng hook add_action và hàm get_current_screen() để thêm mục trợ giúp vào màn hình cụ thể.

Ví dụ:


  function my_custom_help_tab() {
    $screen = get_current_screen();

    // Kiểm tra xem đây có phải là màn hình chỉnh sửa bài viết không
    if ( $screen->id == 'post' ) {

      // Thêm một tab trợ giúp mới
      $screen->add_help_tab( array(
        'id'      => 'my_help_tab',
        'title'   => __('Hướng Dẫn Soạn Thảo Bài Viết', 'my-textdomain'),
        'content' => '
' . __('Đây là phần hướng dẫn cách soạn thảo một bài viết hiệu quả. Hãy đảm bảo bạn đã nhập tiêu đề hấp dẫn và nội dung chất lượng.', 'my-textdomain') . '
' .
                     '
' . __('Bạn có thể sử dụng các định dạng như in đậm, in nghiêng, và danh sách để làm cho bài viết dễ đọc hơn.', 'my-textdomain') . '
'
      ) );

      // Thêm sidebar vào mục trợ giúp
      $screen->set_help_sidebar(
        '
' . __('Thông tin hữu ích', 'my-textdomain') . '
' .
        '
' . __('Liên hệ hỗ trợ: support@example.com', 'my-textdomain') . '
'
      );
    }
  }
  add_action( 'admin_head', 'my_custom_help_tab' );

Trong đoạn code trên:

  • my_custom_help_tab(): Là hàm tùy chỉnh của bạn để thêm mục trợ giúp.
  • get_current_screen(): Lấy thông tin về màn hình hiện tại.
  • $screen->id == 'post': Kiểm tra xem có phải màn hình chỉnh sửa bài viết không.
  • $screen->add_help_tab(): Thêm một tab trợ giúp mới.
    • 'id': ID duy nhất cho tab trợ giúp.
    • 'title': Tiêu đề của tab trợ giúp.
    • 'content': Nội dung HTML của tab trợ giúp.
  • $screen->set_help_sidebar(): Thêm nội dung vào sidebar của mục trợ giúp.
  • add_action( 'admin_head', 'my_custom_help_tab' ): Thêm hàm my_custom_help_tab vào hook admin_head.

Bước 3: Thêm Code vào Chủ Đề hoặc Plugin

Bạn có thể thêm đoạn code trên vào file functions.php của chủ đề con (child theme) hoặc tạo một plugin tùy chỉnh. Sử dụng chủ đề con hoặc plugin là cách tốt nhất để đảm bảo rằng các tùy chỉnh của bạn không bị mất khi bạn cập nhật chủ đề chính.

Bước 4: Tùy Chỉnh Nội Dung Mục Trợ Giúp

Bạn có thể tùy chỉnh nội dung của mục trợ giúp bằng cách sửa đổi nội dung HTML trong tham số 'content' của hàm $screen->add_help_tab(). Bạn có thể sử dụng bất kỳ thẻ HTML nào, bao gồm đoạn văn, danh sách, tiêu đề, hình ảnh và liên kết.

Ví dụ:


  'content' => '
' . __('Chào mừng bạn đến với hướng dẫn!', 'my-textdomain') . '
' .
               '
' . __('Dưới đây là một số mẹo hữu ích để sử dụng website của bạn:', 'my-textdomain') . '
' .
               '
    
                 
  • ' . __('Tạo bài viết hấp dẫn', 'my-textdomain') . '
    • 
                 
  • ' . __('Quản lý trang hiệu quả', 'my-textdomain') . '
    • 
                 
  • ' . __('Sử dụng plugin để mở rộng chức năng', 'my-textdomain') . '
    • 
               
'

Bước 5: Sử Dụng Biến Màn Hình (Screen Variables)

WordPress cung cấp các biến màn hình giúp bạn truy cập thông tin về màn hình hiện tại. Bạn có thể sử dụng các biến này để tùy chỉnh nội dung của mục trợ giúp dựa trên màn hình cụ thể mà người dùng đang xem.

Một số biến màn hình phổ biến:

  • $screen->id: ID của màn hình.
  • $screen->base: Tên cơ bản của màn hình.
  • $screen->post_type: Loại bài viết (ví dụ: post, page).

Ví dụ:


  function my_custom_help_tab() {
    $screen = get_current_screen();

    if ( $screen->id == 'edit-post' && $screen->post_type == 'page' ) {
      // Thêm mục trợ giúp chỉ cho trang danh sách trang
      $screen->add_help_tab( array(
        'id'      => 'my_help_tab_pages',
        'title'   => __('Hướng Dẫn Quản Lý Trang', 'my-textdomain'),
        'content' => '
' . __('Đây là phần hướng dẫn cách quản lý các trang trên website của bạn.', 'my-textdomain') . '
'
      ) );
    }
  }
  add_action( 'admin_head', 'my_custom_help_tab' );

Lời Khuyên và Lưu Ý

  • Sử dụng chủ đề con (child theme) hoặc plugin: Để tránh mất các tùy chỉnh khi cập nhật chủ đề chính.
  • Sử dụng text domain: Để đảm bảo khả năng dịch thuật cho nội dung của bạn.
  • Kiểm tra kỹ lưỡng: Sau khi thêm mục trợ giúp, hãy kiểm tra kỹ lưỡng để đảm bảo rằng nó hiển thị đúng và nội dung chính xác.
  • Giữ cho nội dung ngắn gọn và dễ hiểu: Người dùng thường không có thời gian đọc nội dung dài dòng.
  • Cập nhật nội dung thường xuyên: Đảm bảo rằng nội dung của mục trợ giúp luôn phù hợp với phiên bản hiện tại của website của bạn.

Kết Luận

Thêm mục trợ giúp tùy chỉnh vào WordPress admin là một cách tuyệt vời để cải thiện trải nghiệm người dùng và giảm bớt yêu cầu hỗ trợ. Bằng cách làm theo các bước được mô tả trong bài viết này, bạn có thể dễ dàng thêm mục trợ giúp tùy chỉnh vào bất kỳ màn hình quản trị nào trong WordPress.

Hãy nhớ rằng, việc đầu tư thời gian vào việc tạo ra tài liệu trợ giúp tốt sẽ mang lại lợi ích lớn cho cả bạn và người dùng của bạn. Chúc bạn thành công!

Related Topics by Tag
, , , ,

..