Cách hỗ trợ gỡ lỗi WordPress Plugin

Các lập trình viên của JoomUnited luôn làm việc để các plugin của bạn hoạt động theo cách tối ưu nhất có thể, tất nhiên trong một số trường hợp, một loại lỗi nào đó có thể xảy ra, ví dụ như sự không tương thích được tạo ra do một plugin của bên thứ ba và chúng ta muốn gì khi những loại lỗi này xảy ra? Tất nhiên, chúng được giải quyết nhanh chóng ...    

Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách cung cấp thông tin chính xác cho lập trình viên để họ có thể hiểu và giải quyết lỗi một cách nhanh chóng. Bài viết này sẽ được chia thành 3 bước mà chúng ta sẽ thực hiện để cung cấp thông tin phù hợp cho lập trình viên khi có sự cố xảy ra:

• Bật nhật ký gỡ lỗi
• Cài đặt Plugin Khắc phục sự cố
• Kiểm tra lỗi JavaScript

Bật Hệ thống Gỡ lỗi và Ghi nhật ký của WordPress

Trước hết, chúng ta cần biết WP_DEBUG là gì; như chúng ta có thể thấy trên Wikipedia, “ WP_DEBUG là một hằng số PHP (một biến toàn cục cố định) có thể được dùng để kích hoạt chế độ "debug" trên toàn bộ WordPress. Mặc định nó được coi là false và thường được đặt thành true trong tệp wp-config.php trên các bản sao phát triển của WordPress.”

Như chúng ta có thể thấy WP_DEBUG là một hằng số mặc định là tắt nhưng chúng ta có thể bật nó lên cho mục đích gỡ lỗi tạm thời. 

Ngoài ra, còn có một hằng số PHP khác gọi là WP_DEBUG_LOG sẽ giúp chúng ta tự động tạo một tệp văn bản chứa tất cả các lỗi của plugin và đó là những gì chúng ta sẽ gửi cho các lập trình viên.  

Chúng tôi sẽ hướng dẫn bạn chính xác cách bật nó lên và nó sẽ trông như thế nào nếu có lỗi với plugin của bạn, WP Meta SEO sẽ được sử dụng cho ví dụ này nhưng bạn có thể làm theo các bước tương tự cho tất cả các plugin của chúng tôi. Trong trường hợp này chúng tôi gặp sự cố với WP Meta SEO, đó có thể là bất kỳ sự cố nào nên những gì chúng tôi sẽ làm là mở tệp wp-config.php , có thể thực hiện bằng phần mềm soạn thảo văn bản ưa thích của bạn, ví dụ như Notepad, Visual Studio Code, Brackets, chỉ cần mở wp-config.php.

Tệp nằm ở thư mục gốc của máy chủ, nơi website WordPress của bạn được cài đặt.

Mở tệp bằng trình soạn thảo văn bản rồi nhấn CTRL + F hoặc nhấp vào Edit > Find… bạn sẽ thấy một hộp để bạn có thể nhập từ mà bạn muốn tìm, trong trường hợp này, chúng ta sẽ nhập “WP_DEBUG” và nhấn Enter cho đến khi bạn tìm thấy:
“define( 'WP_DEBUG', false )”

Bây giờ chúng ta đang ở dòng đó, hãy xóa “false” và nhập true, nhấn Enter và ở dòng tiếp theo sao chép define( 'WP_DEBUG_LOG', true ); rồi lưu tệp, nó sẽ trông giống như hình ảnh tiếp theo.

Nếu thay đổi hai dòng này, một tệp có tên “debug.php” sẽ xuất hiện trong thư mục /wp-content/

Và xong… chúng ta đã hoàn thành bước đầu tiên, đây là một trong những tệp mà các lập trình viên của chúng tôi sẽ cần để tăng tốc quá trình khắc phục sự cố của bạn. Tất cả các lỗi sẽ được theo dõi và ghi vào chính tệp văn bản này.

Cài đặt plugin khắc phục sự cố WordPress

Health Check & Troubleshooting plugin là một plugin cho phép bạn chạy kiểm tra xung đột mà không ảnh hưởng đến khách truy cập bình thường trên trang web của bạn, nó thực sự dễ sử dụng và cài đặt, chúng tôi vẫn sẽ sử dụng WP Meta SEO cho ví dụ này. Thực hiện theo các bước sau để cài đặt và chạy kiểm tra xung đột với Health Check & Troubleshooting:  

• Đăng nhập vào trang WordPress của bạn, bạn sẽ ở trên bảng điều khiển của trang web
• Nhấp vào "Plugin" ở phần bên trái trang của bạn
• Nhấp vào “Thêm mới”
• Nhập “Health Check & Troubleshooting” vào thanh tìm kiếm, như hiển thị bên dưới

• Nhấp vào “Cài đặt ngay”, Danh sách các plugin sẽ tự động tải, hãy tìm đúng plugin và nhấp vào “Cài đặt ngay” rồi sau đó nhấp vào “Kích hoạt”

• Nhấp vào “Tình trạng trang”, Ở menu bên trái có một mục gọi là “Công cụ” Nhấp vào đó, sau đó nhấp vào “Tình trạng trang”

• Nhấp vào tab “Khắc phục sự cố” , đọc thông tin cảnh báo và nhấp vào “Vào chế độ khắc phục sự cố” 

Chế độ khắc phục sự cố tự động vô hiệu hóa tất cả các plugin và chuyển sang thememặc định. Chế độ khắc phục sự cố không ảnh hưởng đến khách truy cập bình thường vào trang web của bạn.  

• Tái hiện sự cố bạn đang gặp phải

Trong môi trường mặc định không có plugin nào hoạt động và giao diện mặc định theme, nếu sự cố xảy ra, điều đó có nghĩa là plugin của chúng tôi không gây ra hành vi bất thường.

• Nhấp vào “Plugins” > “Plugins đã cài đặt”

  Menu “Plugins” sẽ mở rộng cung cấp cho bạn các tùy chọn bổ sung. Nhấp vào “Installed Plugins”

• Nhấp vào “Bật trong khi khắc phục sự cố” bên cạnh WP Meta SEO

• Tái hiện sự cố bạn đang gặp phải chỉ với WP Meta SEO đang hoạt động và một theme mặc định, nếu sự cố xảy ra, thì sự cố đó là do plugin của chúng tôi gây ra.

Theo một cách nào đó, đây là tin tốt vì bạn đã xác định được một phần của vấn đề. Bây giờ nó yêu cầu lập trình viên đăng nhập vào websitecủa bạn và khắc phục sự cố trước khi chúng tôi phát hành phiên bản mới! Nếu không, hãy lặp lại các bước để kích hoạt plugin bị vô hiệu hóa tiếp theo mà bạn có thể tái tạo lỗi.

Kiểm tra và gỡ lỗi Javascript trong Plugin WordPress

Chúng ta sẽ tìm kiếm các lỗi Javascript bằng bảng điều khiển của Chrome hoặc Firefox. Tùy thuộc vào trình duyệt của bạn, tên gọi của nó có thể hơi khác một chút, nhưng theo Chrome và FireFox, chúng ta sẽ gọi nó là “Console”. Để mở bảng điều khiển, chỉ cần làm theo các bước sau:  

• Nhấp chuột phải vào inspect, trên frontend ở bất kỳ vị trí nào của trang web

• Chọn console, nó sẽ mở công cụ dành cho lập trình viên ở bên phải trang, nhấp vào “Console”

Kiểm tra lỗi, với bảng điều khiển đang mở, hãy tái hiện lỗi mà bạn đang gặp phải và xem xét bảng điều khiển, các lỗi là văn bản màu đỏ mô tả vị trí xung đột javascript

Nếu bạn đã tìm thấy lỗi JavaScript, vui lòng chụp ảnh màn hình phiên bản mở rộng của lỗi để đính kèm vào ticket/bài đăng của bạn.

Gửi / Chia sẻ báo cáo sự cố của bạn

Bây giờ bạn đã có tất cả thông tin này, bạn sẽ giúp lập trình viên tăng tốc quá trình, chỉ cần sử dụng tất cả thông tin mà bạn đã thu thập và thêm vào ticket/bài đăng của bạn, hãy nhớ rằng, các mục là:  

• debug.log
• Ghi chú với các plugin gây ra xung đột
• Ảnh chụp bảng điều khiển javascript có lỗi

Nếu bạn làm theo các bước này và gửi cho chúng tôi thông tin chính xác, lập trình viên sẽ có thể thực hiện công việc gỡ lỗi nhanh hơn và chúng tôi xin cảm ơn bạn rất nhiều trước :)    

Tạo và chia sẻ tài khoản người dùng WordPress mới cho mục đích hỗ trợ

Việc tạo một người dùng quản trị mới đôi khi là một cách nhanh chóng để cho nhóm hỗ trợ thấy vấn đề của bạn là gì. Trước khi bắt đầu quá trình đó, một lời nhắc nhanh rằng:

• Chúng tôi không lưu trữ thông tin đăng nhập cũ sau khi sự cố được giải quyết (vì lý do bảo mật)
• Chúng tôi khuyến nghị xóa các tài khoản người dùng quản trị được tạo cho mục đích hỗ trợ
• Tất cả thông tin được chia sẻ với đội ngũ của chúng tôi đều được bảo mật và sẽ được giữ kín

Để tạo người dùng mới, trước tiên, bạn đăng nhập vào trang quản trị của mình. Sau khi đăng nhập thành công, bạn sẽ ở trong bảng điều khiển WordPress.

Sau đó, bạn nên truy cập vào menu bên trái Menu > Người dùng.

Sau đó, điều hướng đến màn hình trên cùng, nhấp vào nút Thêm mới hoặc di chuyển đến nút Thêm mới trên Menu bên trái.

Tiếp theo, biểu mẫu Thêm người dùng mới sẽ xuất hiện trên màn hình của bạn. Có 2 trường bắt buộc để điền thông tin: Tên người dùng, Email.

Tại trường Mật khẩu , bạn có thể sử dụng trình tạo mật khẩu ngẫu nhiên hoặc đặt mật khẩu của riêng bạn. Và bạn có thể đánh dấu vào tùy chọn Gửi thông báo cho người dùng nếu bạn muốn gửi email cho người dùng mới về tài khoản của họ.

Sau đó, bạn chọn Vai trò cho người dùng trong hộp thả xuống. Đây là một bước quan trọng để thiết lập quyền cho người dùng trên trang web của bạn. "Quản trị viên" là cấp cao nhất và nó cấp cho người dùng quyền truy cập vào tất cả các tính năng của website. Bạn có thể đặt các vai trò khác nếu bạn muốn giới hạn quyền truy cập của người dùng.

Cuối cùng, nhấp vào Thêm Người dùng mới nút ở dưới cùng. Xong rồi, chúc may mắn!