Hook action và filter

Đặt code ở đâu

Đặt trong functions.php của child theme, hoặc tốt hơn là một plugin nhỏ riêng để đổi giao diện không mất code. Không sửa file trong thư mục plugin — mọi thay đổi sẽ mất khi cập nhật. Mọi hook dưới đây có tiền tố devvn_bg_.

Bật nhật ký gỡ lỗi của plugin: khai define( 'DEVVN_BG_DEBUG', true ); trong wp-config.php (hoặc filter devvn_bg_debug). Nhật ký xem ở WooCommerce → Trạng thái → Nhật ký, nguồn devvn-quote-builder.

Action

Action để chèn giao diện

$context của trang chia sẻ gồm: chain, version, data (dữ liệu xuất file), token, updating, expired, can_accept, acceptance, is_staff.

Việc nền nhắc hằng ngày (Action Scheduler)

Cả bốn hook thuộc nhóm devvn_bg_notify. Hai việc hằng ngày được đăng ký ở lượt mở trang quản trị (admin_init); bị gỡ thì lần mở trang quản trị sau tự đăng ký lại.

Filter — quyền và ai thấy gì

Filter — duyệt giảm giá và báo cáo

Filter — tin nhắn thông báo

Filter — xuất file PDF, Excel, mã QR

Filter — trang lên báo giá và khách

Filter — trang chia sẻ báo giá

Filter — dọn dữ liệu và lưu giữ

Filter — kiểm tra hệ thống, bản quyền, hướng dẫn, gỡ lỗi

Ghi đè mẫu in và trang báo giá trong theme

Chép file từ wp-content/plugins/devvn-quote-builder/templates/ sang {theme}/devvn-quote-builder/{tên-file}.php rồi sửa. Plugin tìm theo thứ tự: child theme → theme cha → bản gốc của plugin, và không bao giờ sửa file trong theme.

• Giữ dòng @version trong khối chú thích đầu file. Bản ghi đè không có @version hoặc thấp hơn mốc bắt buộc bị coi là thiếu phần bắt buộc (cảnh báo đỏ); thấp hơn bản hiện tại nhưng không dưới mốc là cập nhật nhỏ (cảnh báo vàng).
• Riêng quote-pdf.php: bản ghi đè dưới mốc thì file gửi khách tự dùng mẫu gốc của plugin để không in sai số tiền. Tắt bằng ô Mẫu PDF trong theme ở tab Thương hiệu & mẫu in hoặc filter devvn_bg_template_pdf_fallback.
• Xem khác biệt giữa bản trong theme và bản gốc: Báo giá → Kiểm tra hệ thống, nhóm Mẫu giao diện, nút Xem khác biệt.
• Filter liên quan: devvn_bg_locate_template ($path, $name) đổi đường dẫn file cuối cùng; devvn_bg_template_theme_file (kết quả locate_template(), $name) chỉ bản ghi đè ở chỗ khác.

Ví dụ hay dùng

Cho Nhân viên báo giá thấy báo giá chưa ai nhận

add_filter( 'devvn_bg_sees_unassigned', function ( $can, $user ) {
    return $can || user_can( $user, 'devvn_bg_manage' );
}, 10, 2 );

Quản lý báo giá lập báo giá thì không cần trình duyệt

add_filter( 'devvn_bg_approval_thresholds', function ( $thresholds, $creator ) {
    if ( $creator && user_can( $creator, 'devvn_bg_approve' ) ) {
        foreach ( $thresholds as $key => $row ) {
            $thresholds[ $key ]['enabled'] = false;
        }
    }
    return $thresholds;
}, 10, 2 );

Coi biên lãi dưới 10% là lãi mỏng

add_filter( 'devvn_bg_report_thin_margin', function () {
    return 10.0;
} );

Đặt tên file tải về theo tên công ty

add_filter( 'devvn_bg_export_filename', function ( $name ) {
    return str_replace( 'Bao-gia-', 'DHC-Solar-Bao-gia-', $name );
} );

Báo sang hệ thống khác khi khách đồng ý báo giá

add_action( 'devvn_bg_quote_accepted', function ( $quote_id, $version_id, $acceptance_id, $method ) {
    wp_remote_post( 'https://crm.example.com/webhook/bao-gia', array(
        'timeout' => 10,
        'body'    => array(
            'quote_id'   => $quote_id,
            'version_id' => $version_id,
            'method'     => $method,
        ),
    ) );
}, 10, 4 );

Nhắc gọi lại chỉ đúng ngày hẹn, không báo bù

add_filter( 'devvn_bg_notify_followup_lookback', function () {
    return 0;
} );

Icon (i) mở tài liệu nội bộ của bạn

add_filter( 'devvn_bg_docs_url', function () {
    return 'https://tailieu.example.com/bao-gia/';
} );

Icon của màn Tin đã gửi khi đó mở https://tailieu.example.com/bao-gia/tab-thong-bao/?utm_source=plugin… — trang tài liệu của bạn cần có đúng các slug bài như bộ tài liệu này.

Ghi tên nhân viên kèm hotline vào tin nhắn

add_filter( 'devvn_bg_notify_values', function ( $values ) {
    $values['ten_nhan_vien'] .= ' (hotline 0900 000 111)';
    return $values;
} );

Chỉ đổi được giá trị của biến có sẵn (bảng ở mục tin nhắn thông báo); biến mới tự đặt tên sẽ không được thay vào mẫu.

Gỡ plugin có xoá dữ liệu không

Xoá plugin ở màn Plugin mặc định chỉ dọn thứ tạo lại được (tác vụ nền, bộ nhớ tạm, thư viện Excel tải về). Báo giá, bằng chứng chấp thuận, cài đặt, vai trò giữ nguyên. Muốn xoá sạch, khai trước trong wp-config.php:

define( 'DEVVN_BG_REMOVE_ALL_DATA', true );

Khi đó việc xoá plugin xoá thêm 12 bảng dữ liệu, mọi tuỳ chọn devvn_bg_*, dữ liệu giá trong sản phẩm (_devvn_bg_*), ba vai trò và quyền của plugin, và thư mục uploads/devvn-quote-builder/. Tài khoản nhân viên / đại lý vẫn còn (mất vai trò báo giá), kèm các ô hồ sơ đã lưu trên tài khoản.

Còn vướng chỗ nào thì xem Giải đáp thắc mắc.