Các tiêu chuẩn mã hóa PHP của WordPress

Các tiêu chuẩn mã hóa PHP của WordPress

Các tiêu chuẩn PHP WordPress là gì? Trong video từ khóa học của chúng tôi, tìm hiểu PHP cho WordPress, bạn sẽ tìm hiểu tất cả về các tiêu chuẩn mã hóa và tại sao chúng lại quan trọng đến thế?

Các tiêu chuẩn mã hóa PHP của WordPress

Các tiêu chuẩn mã hóa PHP của WordPress là gì?

Bạn có thể tìm thấy các tiêu chuẩn mã hóa PHP WordPress đầy đủ trong cẩm nang chính thức của WordPress.

Về cơ bản, chúng là một tập hợp các cách thực hành tốt nhất về cách sử dụng PHP trong WordPress. Chúng ta sẽ đi qua một số ví dụ về ý nghĩa của thực tế trong phần còn lại của hướng dẫn này. Như bạn có thể thấy, có những tiêu chuẩn không chỉ cho PHP mà còn cho khả năng truy cập và cho các ngôn ngữ khác mà bạn sử dụng trong WordPress.

Tại sao các tiêu chuẩn mã hóa PHP lại quan trọng?

Tại sao điều quan trọng là tất cả chúng ta tuân thủ các tiêu chuẩn này? Vâng, có hai lý do. Một trong số đó là về chất lượng mã, và cái còn lại là về tính nhất quán. Vì vậy, trước hết, chất lượng rất quan trọng vì điều đó có nghĩa là mọi người viết mã trong WordPress đang tạo mã sẽ hoạt động, sẽ thực hiện công việc của mình và điều đó sẽ được viết theo kiểu cập nhật và chất lượng cao. Thứ hai, đó là về tính nhất quán, cũng quan trọng không kém. Thỉnh thoảng rất có thể bạn sẽ làm việc với mã của người khác.

Ví dụ: nếu bạn đang tạo một chủ đề con, bạn có thể phải sao chép một số mã từ chủ đề gốc. Và nếu bạn đang tạo một plugin, plugin đó có thể là một nhánh của plugin bên thứ ba hiện có mà bạn đang sao chép và thêm chức năng bổ sung vào. Điều thực sự quan trọng là cách bạn viết mã phù hợp với cách mà mọi người khác viết mã PHP cho WordPress tự viết mã.

Ví dụ về các tiêu chuẩn mã hóa PHP cho WordPress

Vì vậy, hãy xem xét một số tiêu chuẩn mã hóa PHP. Và tôi sẽ cho bạn thấy những ví dụ về điều này trong một số tệp trong chủ đề của tôi.

Quy ước đặt tên và trường hợp

Quy ước chung

Hãy bắt đầu với các quy ước và trường hợp đặt tên. Khi bạn nghĩ về quy ước đặt tên, có bốn điều cần suy nghĩ:

  1. Các chức năng trong chủ đề của bạn hoặc plugin của bạn.
  2. Các tập tin và cách bạn đặt tên cho chúng.
  3. Bất kỳ thứ hạng nào bạn viết.
  4. Bất kỳ biến nào bạn tạo.

Dưới đây là ví dụ về cách đặt tên tập tin.php trong chủ đề của tôi.

Bạn có thể thấy rằng chúng tôi có một chức năng đã xác định được và đó gọi là  rachelmcc_register_widgets. Tất cả những hàm được viết bằng chữ thường và chúng tôi đang sử dụng dấu gạch dưới giữa các từ, đó là cách bạn nên luôn luôn viết một hàm trong WordPress. Như bạn cũng sẽ thấy, tôi đã sử dụng tiền tố. Điều đó để đảm bảo rằng chức năng này không xung đột với bất kỳ chức năng nào khác có thể được cung cấp bởi chủ đề của tôi hoặc bởi một plugin khác.

Vì vậy, nếu tôi viết một hàm vừa được gọi register_widgets và một trong số các plugin của tôi cũng có một hàm được gọi register_widgets, hai trong số chúng có thể xung đột. Bạn có thể thấy rằng một trong số chúng ghi đè lên cái kia hoặc plugin không hoạt động. Vì vậy, thay vào đó, tôi đang sử dụng một chức năng duy nhất có liên quan đến chủ đề của tôi. Chủ đề của tôi được gọi rachelmccollin, vì vậy các chức năng của tôi có rachelmcc tiền tố. Và điều quan trọng nữa là sử dụng dấu gạch dưới cho các chức năng của bạn và không sử dụng dấu gạch nối.

Bạn làm sử dụng dấu gạch nối ở hai nơi. Đầu tiên, bạn sử dụng dấu gạch nối khi bạn xác định các lớp CSS. Vì vậy, bạn có thể thấy rằng trong các widget của mình, tôi đang xác định các lớp CSS cho h3 phần tử của tôi và cho id khu vực widget đó. Và ở đây, bạn sử dụng dấu gạch nối. Nơi khác mà bạn sử dụng dấu gạch nối là trong tên tệp của bạn. Vì vậy, đây là front-page.php.

Bạn phải luôn luôn sử dụng dấu gạch nối trong tên tệp trong chủ đề và plugin của bạn; không sử dụng dấu gạch dưới. Vì vậy, ở đây có một cuộc gọi sử dụng locate_template. Và loop-frontpage.php là một tệp, một phần mẫu mà tôi đang gọi và bạn có thể thấy rằng đó là dấu gạch nối chứ không phải dấu gạch dưới. Mặt khác, ID loại bài đăng của tôi, là loại bài đăng tùy chỉnh mà tôi đã đăng ký, sử dụng dấu gạch dưới : rmcc_blurb. Bây giờ bạn cũng có thể cần phải suy nghĩ về các biến trong chủ đề của bạn. Hãy xem loop-frontpage.php:

Trong tệp cụ thể này, là tệp tôi đã gọi từ tệp trước đó, tôi đã xác định một số biến, một được gọi count và một được gọi title. Và bạn có thể thấy rằng tôi đang sử dụng chữ thường cho cả hai. Một nơi khác mà bạn cần suy nghĩ về dấu gạch dưới và viết hoa là khi bạn đang sử dụng một lớp. Hãy quay trở lại front-page.php:

Và bạn có thể thấy ở đây, tôi đang sử dụng lớp WP_Query. Vì vậy, một lớp có một chữ in hoa sau dấu gạch dưới, cũng như lúc bắt đầu. Vì vậy, đó là nơi bạn sử dụng viết hoa khi bạn xác định một lớp. Nó giúp mọi người làm việc với mã của bạn ngay lập tức xác định rằng đó là một lớp chứ không phải là một hàm.

Sử dụng dấu ngoặc đơn và dấu ngoặc kép

Bây giờ hãy xem cách bạn sẽ sử dụng các trích dẫn đơn và kép trong PHP cho WordPress. Bạn có thể sử dụng dấu ngoặc đơn hoặc dấu ngoặc kép, tùy thuộc vào dấu ngoặc kép nào phù hợp nhất với mã cụ thể mà bạn đang làm việc. Lý do mà trích dẫn đôi khi có thể hữu ích hơn là vì chúng giúp làm việc với các ký tự đặc biệt dễ dàng hơn. Đây là một ví dụ:

Giả sử bạn đang viết một tệp mẫu tìm kiếm, search.php. Và trong đó, nếu không tìm thấy gì, bạn sẽ đặt một đoạn có nội dung: “Tôi xin lỗi, tìm kiếm của bạn không tìm thấy gì. Tại sao bạn không thử lại?” Tôi đã đặt nó trong dấu ngoặc kép vì văn bản chứa dấu nháy đơn. Hãy để tôi chỉ cho bạn cách nó sẽ hoạt động nếu chúng tôi đã làm nó trong dấu ngoặc đơn.

Bạn cần đặt dấu gạch chéo ngược trước dấu nháy đơn để chúng được xuất chính xác trong HTML HTML nếu không, nó sẽ gây ra lỗi cho bạn. Bây giờ tôi không biết về bạn, nhưng tôi chỉ muốn gõ nó bình thường trong dấu ngoặc kép hơn là làm tất cả điều này trong dấu ngoặc đơn. Một điều khác bạn cần nhớ là nếu bạn cần đặt dấu ngoặc kép trong dấu ngoặc kép, bạn có thể đặt dấu ngoặc đơn trong dấu ngoặc kép hoặc ngược lại. Không quan trọng bằng cách nào, nhưng bạn không thể đặt dấu ngoặc đơn trong dấu ngoặc đơn hoặc dấu ngoặc kép trong dấu ngoặc kép. Vì vậy, đây là một ví dụ quay trở lại tệp tin.php.

Trong phạm vi này, tôi đã nhận được một dấu ngoặc đơn cho giá trị của before_widget, và sau đó, tôi đã có hai dấu ngoặc kép cho ID và loại đó. Tôi không thể sử dụng dấu ngoặc kép ở đây và sau đó đặt dấu ngoặc kép bên trong nó, vì vậy đó là lý do tại sao tôi sử dụng dấu ngoặc đơn ở đó, vì tốt hơn là sử dụng dấu ngoặc kép với CSS của bạn.

Lõm

Bây giờ, hãy nhìn vào vết lõm. Và hãy tiếp tục xem xét tệp tin.php, đây là một ví dụ khá hay vì tôi đã lùi vào một số dòng mã trong đó. Bạn có thể thấy rằng tên hàm nằm ở bên trái, và sau đó trong register_sidebar hàm đó được thụt vào một cấp. Và nội dung của nó được thụt lề một lần nữa.

Vì vậy, mỗi khi bạn đặt nội dung trong dấu ngoặc nhọn hoặc dấu ngoặc nhọn, mọi thứ bên trong sẽ được lùi vào. Và cũng để thụt lề, bạn nên sử dụng ngắt dòng. Hãy xem một tập tin khác, nơi có các dòng đơn cũng như dòng đôi.

Ở đây bạn có thể thấy tôi đã nhận được một thông báo có mã lệnh trong đó. Vì vậy, tôi đã đặt một dòng ngắt ở trên và dưới trong hai dòng mã đó. Nếu chỉ có một dòng mã, tôi sẽ không phải đặt các không gian dòng đó vào trong mà tôi sẽ chỉ đặt nó thẳng vào phần chắc chắn nhất của mình. Sử dụng khoảng cách như thế này giúp làm rõ nơi khối mã của bạn. Và bạn cũng có thể thấy rằng vết lõm đã được sử dụng.

Một điều khác bạn cần ghi nhớ là nơi bạn mở và đóng thẻ PHP của bạn và liệu đó có nằm trên cùng một dòng với mã của bạn hoặc một dòng khác. Và điều đó cũng phụ thuộc vào việc bạn đang mã hóa một khối mã hay một dòng đơn. Trường hợp bạn đã có một khối mã, bạn đặt thẻ mở của bạn trên một dòng và thẻ đóng của bạn trên một dòng khác. Điều đó giúp làm rõ rằng đó là một khối PHP và mọi thứ trong các thẻ đó là PHP.

Một điều mà bạn phải chắc chắn rằng bạn làm là sử dụng một thẻ PHP mở đầy đủ. Vì vậy, đừng chỉ sử dụng một dấu hỏi, như bạn có thể đã làm trong một số hệ thống khác sử dụng PHP, bởi vì trong WordPress bạn phải sử dụng thẻ PHP đầy đủ. Nếu tôi đã viết một số PHP chỉ trên một dòng, tôi sẽ đặt các thẻ mở và đóng PHP trên cùng một dòng.

Bạn có thể thấy rằng chúng ta đã có một số PHP tất cả trong một dòng và sau đó tôi đã có HTML. Vì vậy, các thẻ mở và đóng đi cùng dòng với mã của tôi.

Phần kết luận

Đó là phần giới thiệu về một số yếu tố của các tiêu chuẩn mã hóa PHP của WordPress và tôi đã chỉ cho bạn một số ví dụ về chúng trong các tệp của mình và thay đổi một số khi tôi đi cùng để cho bạn thấy cách mọi thứ được thực hiện chính xác.

Trong khóa học đầy đủ, Tìm hiểu PHP cho WordPress , bạn sẽ tìm hiểu tất cả về PHP, ngôn ngữ lập trình mà WordPress được tích hợp. Tôi sẽ cung cấp cho bạn tổng quan về PHP là gì và cách sử dụng cho các chủ đề và plugin của WordPress, với các ví dụ. Bạn sẽ tiếp tục tìm hiểu cách tạo một tệp PHP và sử dụng nó để xuất HTML. Sau đó, bạn sẽ học cách sử dụng các hàm, vòng lặp và nếu các câu lệnh để mã hóa các chủ đề và plugin tùy chỉnh WordPress.