Code Tối ưu SEO hình ảnh – Chèn thẻ ALT ảnh tự động trên website WordPress

Thẻ ALT (Alternative Text) là một trong những yếu tố kỹ thuật SEO On-page quan trọng nhất giúp Google Image Search và các công cụ AI tìm kiếm hiểu được ngữ cảnh hình ảnh trên website. Tuy nhiên, nếu website của bạn có hàng trăm hoặc hàng nghìn hình ảnh chưa được đặt thẻ ALT, việc sửa thủ công từng ảnh trong WordPress Media Library sẽ tốn rất nhiều thời gian.

Dưới đây là đoạn code PHP tự động điền thẻ ALT, Caption và Description cho toàn bộ hình ảnh trong thư viện WordPress theo tên tiêu đề (Title) ảnh một cách nhanh chóng, an toàn và hoàn toàn không cần cài đặt các plugin bên ngoài gây nặng website.

1. Đoạn Code PHP Tự Động Điền Thẻ ALT Cho Hình Ảnh WordPress

Bạn có thể chèn đoạn code này vào file functions.php của theme đang dùng (tốt nhất là Child Theme), hoặc dùng plugin WPCode (Insert Headers and Footers) để thêm đoạn mã PHP này và kích hoạt (Active):

function helios_auto_fill_image_meta() {
    // Chỉ chạy khi quản trị viên truy cập đúng link kích hoạt
    if ( !isset($_GET['run_auto_fill_images']) || !current_user_can('manage_options') ) return;

    // Lấy tất cả hình ảnh trong thư viện Media
    $args = array(
        'post_type'      => 'attachment',
        'post_mime_type' => 'image',
        'post_status'    => 'inherit',
        'posts_per_page' => -1, // Quét toàn bộ hình ảnh
    );
    $attachments = get_posts($args);
    $count = 0;

    foreach ($attachments as $attachment) {
        $title = $attachment->post_title;
        $updated = false;

        $my_post = array(
            'ID' => $attachment->ID,
        );

        // 1. Kiểm tra Image Caption (post_excerpt)
        if ( empty($attachment->post_excerpt) ) {
            $my_post['post_excerpt'] = $title;
            $updated = true;
        }

        // 2. Kiểm tra Miêu tả/Description (post_content)
        if ( empty($attachment->post_content) ) {
            $my_post['post_content'] = $title;
            $updated = true;
        }

        // Cập nhật Caption và Description nếu có thay đổi
        if ($updated) {
            wp_update_post($my_post);
        }

        // 3. Kiểm tra Mô tả SEO/Alt Text (lưu trong postmeta _wp_attachment_image_alt)
        $alt = get_post_meta($attachment->ID, '_wp_attachment_image_alt', true);
        if ( empty($alt) ) {
            update_post_meta($attachment->ID, '_wp_attachment_image_alt', $title);
            $updated = true;
        }

        if ($updated) {
            $count++;
        }
    }

    echo '<div class="notice notice-success is-dismissible"><p><strong>TranTienDuy BOT:</strong> Đã kiểm tra và điền tự động thành công cho ' . $count . ' hình ảnh!</p></div>';
}
add_action('admin_notices', 'helios_auto_fill_image_meta');

2. Hướng Dẫn Kích Hoạt Và Vận Hành Lệnh

Sau khi đã lưu và bật đoạn code PHP trên, bạn tiến hành kích hoạt việc điền thẻ ALT tự động theo các bước sau:

1. Đăng nhập vào tài khoản WordPress với quyền Quản trị viên (Administrator). Lệnh được cài đặt lớp bảo mật current_user_can('manage_options') để đảm bảo an toàn tuyệt đối, người ngoài hoặc thành viên thường không thể kích hoạt.
2. Mở tab trình duyệt và thêm tham số ?run_auto_fill_images=1 vào ngay sau link trang quản trị (ví dụ: https://trantienduy.com/wp-admin/?run_auto_fill_images=1).
3. Bấm Enter để hệ thống chạy ngầm. Khi hoàn tất, một thông báo xanh nổi bật TranTienDuy BOT sẽ xuất hiện thông báo số lượng hình ảnh đã được tự động điền thẻ ALT thành công.

3. Lưu Ý Quan Trọng Khi Tối Ưu SEO Hình Ảnh WordPress

• Đoạn code chỉ bổ sung thẻ ALT cho những ảnh đang bị khuyết (empty), không ghi đè lên các hình ảnh bạn đã cẩn thận đặt thẻ ALT trước đó.
• Tiêu chuẩn đặt tên file ảnh: Trước khi tải ảnh lên, bạn nên đặt tên file không dấu, ngăn cách bằng dấu gạch ngang (ví dụ: khoa-hoc-seo-wordpress.webp) để khi code tự động lấy Title, thẻ ALT sẽ chuẩn SEO nhất.
• Sau khi chạy xong lệnh và kiểm tra thư viện Media đã đầy đủ thẻ ALT, bạn có thể Tắt (Deactivate) đoạn code trong WPCode để tối ưu tài nguyên máy chủ.