Shortcode là gì?
Shortcode là đoạn mã ngắn trong dấu ngoặc vuông dùng để chèn nội dung động vào bài viết, trang, widget… trong WordPress. Ví dụ:
[gallery id="123"]
Thay vì phải viết code dài hoặc HTML phức tạp, bạn chỉ cần dùng một shortcode đơn giản để hiển thị nội dung.
Shortcode hoạt động như thế nào?
- Shortcode là một placeholder – khi hiển thị bài viết, WordPress sẽ thay thế nó bằng nội dung thực tế
- Shortcode có thể do WordPress core, theme hoặc plugin tạo ra
- Người dùng chỉ cần gõ shortcode – không cần biết lập trình
Các shortcode phổ biến trong WordPress
| Shortcode | Công dụng |
|---|---|
[gallery] |
Hiển thị bộ sưu tập ảnh |
[audio] |
Chèn file âm thanh |
[video] |
Chèn video player |
[caption] |
Thêm chú thích cho ảnh |
[embed] |
Nhúng nội dung bên ngoài |
Shortcode có thể dùng ở đâu?
- Bài viết, trang, custom post
- Widget (HTML hoặc text)
- Block “Shortcode” trong Gutenberg editor
- Trong PHP template (bằng
do_shortcode())
Cách viết shortcode tùy chỉnh
function hien_thi_chao() {
return "<p>Xin chào bạn!</p>";
}
add_shortcode('chao', 'hien_thi_chao');
Giờ bạn có thể dùng [chao] trong bất kỳ bài viết nào để hiển thị đoạn chào.
Shortcode có thể có tham số không?
Có – bạn có thể truyền tham số vào như sau:
[chao ten="Tuấn" tuoi="28"]
function chao_tu_dong($atts) {
$a = shortcode_atts([
'ten' => 'bạn',
'tuoi' => 'không rõ'
], $atts);
return "<p>Xin chào {$a['ten']}, bạn {$a['tuoi']} tuổi!</p>";
}
add_shortcode('chao', 'chao_tu_dong');
Lưu ý khi dùng shortcode
- Không được tự động chạy trong excerpt (trừ khi tùy biến)
- Cẩn thận xung đột shortcode trùng tên
- Nếu shortcode bị xóa (plugin bị tắt) → chỉ hiện thô như
[abc]
Kết luận
Shortcode là cách đơn giản nhưng cực kỳ mạnh để thêm nội dung động vào WordPress mà không cần viết code HTML hay PHP dài dòng. Biết sử dụng và tạo shortcode giúp bạn xây dựng website linh hoạt hơn, có thể tái sử dụng nội dung dễ dàng, và tương tác với plugin/theme tốt hơn.