Hiển thị code trong bài viết của WordPress

Hiển thị code (HTML, CSS, JS, PHP…) rõ ràng và chuyên nghiệp trong bài viết của WordPress.

Đối với các lập trình viên, blogger công nghệ hay bất kỳ ai thường xuyên chia sẻ các đoạn mã (code snippet) trên website WordPress của mình thì việc trình bày mã một cách rõ ràng và chuyên nghiệp là vô cùng quan trọng. Một khối mã thuần văn bản không chỉ khó đọc mà còn làm giảm tính thẩm mỹ của bài viết. Đây chính là lúc syntax highlighter (trình tô sáng cú pháp) phát huy tác dụng. Suốt một thời gian dài trước đây, tôi đã từng sử dụng plugin SyntaxHighlighter Evolved để hiển thị code trong bài viết. Tuy nhiên, nó được tích hợp quá nhiều tính năng mà blog của tôi không cần đến.

Tham khảo thêm:

• 5 WordPress plugin giúp làm nổi bật code và syntax
• Chèn code PHP vào WordPress với plugin Code Snippets

Syntax highlighter là gì?

Syntax highlighter là một tính năng hoặc công cụ có khả năng hiển thị mã nguồn bằng cách sử dụng màu sắc và định dạng font chữ khác nhau cho các thành phần cú pháp như từ khóa, biến, chuỗi, bình luận… Thay vì một “bức tường văn bản” đơn điệu, mã nguồn của bạn sẽ được trình bày một cách trực quan, gần giống như khi bạn xem nó trong một trình soạn thảo mã (IDE) chuyên nghiệp như Visual Studio Code hay Sublime Text.

Tại sao nên sử dụng syntax highlighter?

• Cải thiện tính dễ đọc: màu sắc giúp mắt người đọc dễ dàng phân biệt các thành phần khác nhau của mã, từ đó hiểu logic nhanh hơn.
• Tăng tính thẩm mỹ: các đoạn mã được tô sáng trông chuyên nghiệp và hấp dẫn hơn, nâng cao chất lượng tổng thể của website.
• Giảm thiểu lỗi: khi người đọc sao chép mã, việc trình bày rõ ràng giúp họ dễ dàng phát hiện các lỗi cú pháp hoặc ký tự bị thiếu.
• Nâng cao trải nghiệm người dùng: một bài viết kỹ thuật với các đoạn mã được trình bày tốt sẽ giữ chân người đọc lâu hơn và được đánh giá cao hơn.

Tại sao bạn nên chọn WPCB Syntax Highlighter?

WPCB Syntax Highlighter là một plugin WordPress được viết bởi WP Căn bản với mục tiêu cung cấp một giải pháp tô sáng cú pháp đơn giản, gọn nhẹ và hiệu quả. Plugin sử dụng thư viện JavaScript Prism.js, một trong những thư viện tô sáng cú pháp phổ biến, nhẹ và có khả năng mở rộng cao. WPCB Syntax Highlighter có một số ưu điểm như:

• Nhẹ và nhanh: plugin được thiết kế để có hiệu suất cao, tập trung vào chức năng cốt lõi là tô sáng cú pháp mà không thêm vào các tính năng không cần thiết.
• Tài nguyên tự host: các file prism.css và prism.js được lưu trữ ngay trong thư mục của plugin. Điều này có nghĩa là website của bạn không phụ thuộc vào CDN bên ngoài, giúp tăng tốc độ tải trang, đảm bảo tính riêng tư và hoạt động ổn định ngay cả khi các dịch vụ bên thứ ba gặp sự cố.
• Tải tài nguyên có điều kiện: đây là một trong những điểm tối ưu nhất của plugin. Nó chỉ tải các file CSS và JS cần thiết khi phát hiện có shortcode tô sáng cú pháp ([ php ], [ css ]…) trong nội dung bài viết hoặc trong nội dung bình luận. Điều này giúp tối ưu hiệu suất, tránh tải tài nguyên thừa trên các trang không chứa mã.
• Sử dụng đơn giản với shortcode: bạn có thể dễ dàng tô sáng các đoạn mã bằng cách bọc chúng trong các shortcode trực quan như [ php ], [ css ], [ js ], [ html ] và [ text ]. Kể từ phiên bản 1.9, các bạn có thể sử dụng shortcode [ code ] để thay thế cho toàn bộ các shortcode trước đó. Plugin sẽ tự động nhận biết loại mã nguồn để hiển thị giao diện tương ứng.
• Tương thích với plugin chống copy: kể từ phiên bản 1.8, WPCB Syntax Highlighter được bổ sung thêm tính năng “Click to copy”, giúp nó tương thích với các plugin chống copy nội dung, chẳng hạn như WPCB Content Protector.
• Hỗ trợ cập nhật tự động: plugin được tích hợp tính năng cập nhật tự động, cho phép nhận các bản cập nhật chỉ với 1 click, đảm bảo bạn luôn có phiên bản mới nhất.
• Hỗ trợ đa ngôn ngữ: plugin hỗ trợ sẵn 2 ngôn ngữ phổ biến là tiếng Việt và tiếng Anh.

Xem changelog – WPCB Syntax Highlighter

Hiển thị code trong bài viết với WPCB Syntax Highlighter

1. Đầu tiên, bạn cần download plugin WPCB Syntax Highlighter. Vui lòng tham gia group WP Căn bản trên Facebook (chỉ dành riêng cho khách hàng) để lấy link download plugin.

Tham gia group WP Căn bản ngay

2. Upload, cài đặt và kích hoạt plugin WPCB Syntax Highlighter.

3. Mở trình soạn thảo bài viết ra, bọc 2 đầu đoạn code của bạn bằng các shortcode sau:

• [ php ][/ php ]: đối với code PHP.
• [ html ][/ html ]: đối với code HTML.
• [ css ][/ css ]: đối với code CSS.
• [ js ][/ js ]: đối với code JS.
• [ text ][/ text ]: đối với các loại code khác, chẳng hạn như code trong file .htaccess.
• [ code ][/ code ]: áp dụng cho tất cả các loại code kể trên, plugin sẽ tự động nhận biết để hiển thị cho phù hợp. Yêu cầu sử dụng phiên bản 1.9 trở lên.

Lưu ý quan trọng khi sử dụng:

• Nhớ xóa các khoảng trắng (dấu cách) trong shortcode.
• Ngoài ra, code phải không được chứa dòng trống (dòng trắng).
• Code nên được chèn cuối cùng (sau khi bạn đã biên soạn xong toàn bộ nội dung) ở chế độ Code (mã). Sau khi chèn code, hãy xuất bản hoặc cập nhật luôn bài viết luôn, đừng chuyển qua chế độ Visual (trực quan) rồi mới xuất bản để tránh bị lỗi định dạng.
• Đối với một số code “cứng đầu” (hiển thị không đúng sau khi xuất bản), các bạn có thể bọc thêm bên ngoài shortcode bằng thẻ <pre></pre>.

4. Kết quả bạn nhận được sẽ tương tự như thế này:

• Đối với code PHP:

• Đối với code HTML:

• Đối với code CSS:

• Đối với code JS:

• Đối với plain text:

Thật tuyệt vời phải không nào? Chúc các bạn thành công!

Bạn có đang chia sẻ code trong các bài viết trên website của mình không? Bạn đã sử dụng plugin nào để làm điều đó? Hãy chia sẻ với chúng tôi giải pháp của bạn thông qua khung bình luận bên dưới.

Nếu bạn thích bài viết này, hãy theo dõi blog của tôi để thường xuyên cập nhật những bài viết hay nhất, mới nhất nhé. Cảm ơn rất nhiều. :)