Khi đọc tài liệu developer của WordPress, chuyện mình ghét nhất là copy code về, dựng site thử rồi mới biết đoạn ví dụ chạy ra kết quả gì. Từ đầu tháng 9/2026, vấn đề đó hết: Code Reference chính thức cho phép nhấn nút Run và chạy code ngay trên trình duyệt. Trong bài này, mình sẽ hướng dẫn từ A đến Z cách dùng tính năng này, cách viết ví dụ chạy được cho plugin của bạn, và vì sao mình nghĩ đây là thay đổi đáng giá nhất của hệ sinh thái tài liệu WordPress trong năm nay.
Code Reference chạy code trực tiếp là gì?
Code Reference là trang tài liệu tra cứu hàm, class và hook của WordPress tại developer.wordpress.org/reference. Trước giờ nó chỉ hiển thị code tĩnh, bạn đọc xong phải tự mang về môi trường riêng để thử. Giờ mỗi ví dụ có nút Run, bấm vào là snippet được thực thi trên một bản WordPress thật chạy bởi WordPress Playground, kết quả hiện ngay bên dưới. Không cần cài gì, không cần VPS, chỉ cần trình duyệt. Với ai hay tra API như WP_HTML_Tag_Processor, đây là bước tiết kiệm thời gian đáng kể.
Cách dùng nút Run như thế nào?
Cách dùng rất đơn giản, mình làm lại từ đầu cho bạn nào chưa từng đụng tới. Trước tiên, mở trang Code Reference của hàm cần tra. Ví dụ mình hay dùng WP_HTML_Processor::class_list(), một API ít người biết của WordPress để đọc danh sách class trong thẻ HTML. Tiếp theo, kéo xuống phần ví dụ bên dưới mô tả hàm. Bạn sẽ thấy khối code kèm nút Run. Bấm Run, chờ vài giây, kết quả xuất ra ngay tại chỗ.
Ví dụ đó trông như sau:
$p = new WP_HTML_Tag_Processor(
"<div class='free <egg> lang-en'>"
);
$p->next_tag();
foreach ( $p->class_list() as $class_name ) {
echo "{$class_name} ";
}
// Kết quả: "free <egg> lang-en "Điều thú vị là kết quả này chạy trên WordPress thật, không phải mô phỏng. Bạn có thể tin được output, điều mà Stack Overflow thời nay chưa chắc đã cho bạn.
Ví dụ chạy được trong DocBlock viết ra sao?
Phần mình thích nhất ở thiết kế này: ví dụ chạy được và tài liệu của hàm nằm chung một file. Cụ thể, các đóng góp viên viết ví dụ ngay trong DocBlock, dùng code fence đặc biệt tên là php interactive. Hệ thống build sẽ nhận diện fence này và thêm nút Run trên trang tài liệu.
Cấu trúc như sau:
/**
* Generator for a foreach loop to step through each class name.
*
* ```php interactive
* $p = new WP_HTML_Tag_Processor( "<div class='x'>" );
* $p->next_tag();
* foreach ( $p->class_list() as $class_name ) {
* echo "{$class_name} ";
* }
* ```
*/Nếu bạn maintain plugin open source, đây là lúc đóng góp ngược lại cho WordPress: viết vài ví dụ interactive cho API bạn hay dùng. Ý tưởng này từng nằm trong issue tracker của nhóm Documentation khá lâu trước khi thành hiện thực, nên cộng đồng đang rất cần người viết thêm ví dụ.
WordPress Playground giúp gì khi thử bản beta?
Nền tảng đằng sau nút Run là WordPress Playground, và nó còn làm được nhiều hơn thế. Bạn có thể mở playground.wordpress.net, chọn chạy bản beta hoặc trunk của WordPress với PHP 8.0 trở lên, không cần cài đặt gì. Mình thường dùng nó để thử Gutenberg mới nhất trước khi khách hàng hỏi.
Vụ này đang nóng vì lịch WordPress 7.2 đã rõ: Beta 1 dự kiến 20 đến 22/10/2026, bản chính thức ra khoảng 8 đến 10/12/2026. Chu kỳ phát triển 7.2 hứa hẹn nhiều thay đổi lớn cho developer, mình sẽ theo dõi và viết chi tiết khi có bản beta. Nếu bạn muốn đọc trước những gì hai bản Gutenberg 23.8 và 23.9 chuẩn bị cho 7.2, mình đã tổng hợp tại đây.
Mình thấy tính năng này hữu ích cho ai?
Nói thẳng: nhóm được lợi nhất là developer tự viết plugin và người đang học API hệ thống của WordPress. Thay vì dựng môi trường test chỉ để biết một hàm trả về gì, bạn kiểm chứng trong mười giây. Với người viết plugin thương mại, tư duy “ví dụ phải chạy được” cũng là chuẩn tốt để áp cho tài liệu sản phẩm của chính mình.
Mình đã áp dụng cách này khi viết plugin tích hợp AI cho WordPress: mỗi ví dụ code trong readme đều được mình chạy qua Playground trước khi công bố. Nhờ vậy gần như không có ai phản hồi “code trong docs không chạy”. Chi tiết cách xây plugin đó mình chia sẻ từng bước trong bài trước.
Kết luận
Tài liệu sống — nơi ví dụ chạy thật ngay tại chỗ — là hướng đi đúng của WordPress. Bạn không cần chờ WordPress 7.2 mới dùng được: Code Reference hiện tại đã có nút Run, Playground mở miễn phí cho mọi người. Mình đề nghị bạn dành mười phút cuối ngày nay, mở một trang Code Reference bất kỳ, bấm Run và tự kiểm chứng. Một khi quen, bạn sẽ không quay lại kiểu đọc tài liệu cũ nữa.
