Hướng dẫn cho người mới bắt đầu Phát triển Plugin WordPress
WordPress CMS đã thay đổi bộ mặt Internet của chúng tôi và cho phép một loạt các ý tưởng mới phát triển và phong trào nguồn mở của nó có sự hiện diện mạnh mẽ bắt nguồn từ sự phát triển phần mềm và web. WordPress là một nền tảng blog có khả năng khởi chạy vào nhiều tập lệnh khác như diễn đàn web, bảng công việc và thậm chí là một trang web cổ điển Hệ thống quản lý nội dung.
Chúng tôi sẽ giới thiệu một vài cách để bắt đầu phát triển plugin cho WordPress. Các bước khá đơn giản và không đòi hỏi sự cống hiến lớn cho việc học. Kiến thức thô sơ về PHP sẽ hữu ích ngay cả với sự hiểu biết cơ bản về cấu trúc tệp và bảng quản trị WordPress.
Trong hướng dẫn ngắn gọn này, chúng ta sẽ thực hiện các bước cơ bản cần thiết để tạo một plugin WordPress đơn giản. Các chức năng sẽ được sử dụng để tạo các trích đoạn động dựa trên số được truyền vào lệnh gọi hàm của chúng tôi. Bạn sẽ cần tải lên tệp trình cắm và kích hoạt từ bảng Quản trị viên, sau đó theo dõi bằng cách gọi chức năng của chúng tôi từ bất kỳ trang nào chúng tôi muốn đoạn trích xuất hiện. Liên kết đến mã nguồn trình cắm đã hoàn thành đã được thêm vào sau trong bài viết này :)
Tại sao phát triển cho WordPress?
Plugin là một cách tuyệt vời để tăng cường chức năng của blog của bạn bằng cách thêm các tính năng bổ sung. Chúng có thể được đặt ở bất cứ đâu trong mẫu của bạn bằng các móc chức năng. Theo thời gian, khả năng mở rộng của hệ thống trình cắm của WordPress đã cho phép tăng trưởng vượt bậc và hàng trăm phần mềm do nhà phát triển gửi.
WordPress đặc biệt cung cấp các tính năng nâng cao như vậy trong CMS của nó mà các plugin độc đáo rất ít và xa. Là một nhà phát triển, bạn có toàn quyền kiểm soát các chi tiết phụ trợ của nhật ký web của bạn. Thuê một nhà phát triển PHP để tạo một plugin hệ thống sẽ tốn kém hơn nhiều so với bạn có thể tưởng tượng và API khá dễ dàng để làm việc và tự tìm hiểu.
Là một đối số thứ yếu, phát triển qua WordPress là một thực tiễn tuyệt vời để điều chỉnh bản thân vào các lĩnh vực khác. Xây dựng các plugin và tiện ích thanh bên nhỏ hơn trong WordPress sẽ giúp bạn phát triển sự hiểu biết về cách hệ thống phụ trợ thực sự hoạt động. Điều này không chỉ giới hạn ở WordPress vì bạn sẽ hiểu sâu hơn về đại đa số Hệ thống nội dung.
1. Cấu trúc thư mục WP
Giới thiệu về cấu trúc thư mục WordPress sẽ hiển thị các thư mục ứng dụng cơ bản. Bên trong wp-content bạn sẽ tìm thấy một bổ sung danh mục. Ở đây là nơi tất cả các trình cắm riêng lẻ của bạn sẽ được lưu trữ, các tệp đơn hoặc thư mục con được đặt tên đúng.
Đối với các trình cắm nhỏ hơn chỉ yêu cầu một tệp .php duy nhất, bạn có tùy chọn đặt tệp này trực tiếp vào thư mục trình cắm /. Tuy nhiên, khi bạn bắt đầu phát triển các ứng dụng phức tạp hơn, việc tạo một thư mục con được đặt tên theo trình cắm của bạn sẽ hữu ích hơn nhiều. Bên trong bạn có thể chứa JavaScript, CSS và HTML bao gồm các chức năng PHP của bạn.
Một readme.txt tập tin cũng có thể hữu ích nếu bạn dự định cung cấp plugin để tải xuống. Tập tin này nên bao gồm tên của bạn và những gì plugin làm. Là tác giả, bạn cũng có thể xem xét bao gồm các chi tiết về mỗi sửa đổi và bản cập nhật nào đã được đưa ra.
2. Bắt đầu tệp PHP của bạn
Khi tạo một plugin mới, bạn cần bắt đầu với một tệp PHP đơn giản. Điều này có thể được đặt tên bất cứ điều gì nhưng thường phản ánh tên chính thức của trình cắm thêm của bạn. Vì vậy, ví dụ tôi đã tạo mã cơ sở của chúng tôi và đã đặt tên cho tệp của mình là hongkiat-excerpt.phps.
Các dòng đầu tiên của trình cắm thêm của bạn phải được bình luận thông tin cho các công cụ phân tích cú pháp. Điều này cực kỳ quan trọng vì WordPress sẽ không thể xử lý tệp của bạn mà không có. Dưới đây là một đoạn mã ví dụ bạn có thể sao chép và tạo khuôn theo hướng của riêng bạn.
Tên Plugin là thứ sẽ hiển thị trong bảng phụ trợ Quản trị viên của bạn khi bạn kích hoạt. Tương tự với URI sẽ được đặt trong ngăn chi tiết bên trong bảng bổ trợ. Mặc dù không bắt buộc phải bao gồm một phiên bản hoặc mô tả nhưng nó làm cho plugin của bạn trông chuyên nghiệp hơn nhiều.
3. Các quy ước đặt tên và thực tiễn tốt nhất của WordPress
Có một vài cách để thực sự cấu trúc trình cắm của bạn. Nhiều lần các nhà phát triển PHP sẽ tạo ra toàn bộ hệ thống lớp để tránh xung đột với các hàm và tên biến. Nếu bạn không quen với chức năng OOP nâng cao của PHP thì tốt nhất bạn chỉ nên viết mã của mình trong các hàm mẫu.
Vì vậy, đối với mã ví dụ của chúng tôi, chúng tôi sẽ viết một hàm duy nhất để chứa dữ liệu của chúng tôi. Chúng tôi cũng cần xác định một vài biến là chìa khóa để thực hiện bên trong các tệp mẫu của chúng tôi. Dưới đây là một đoạn mã ví dụ được lấy từ tệp plugin của chúng tôi với logic lõi đã bị xóa.
Khi viết mã mẫu của bạn, tốt nhất bạn nên tuân theo các quy định và hướng dẫn được thiết lập bởi WordPress. Vì có rất nhiều hàm nội bộ đã được xác định, bạn có thể tránh trùng lặp bằng cách thêm tiền tố vào tất cả các biến và tên hàm của bạn.
Trong các ví dụ trên, chúng tôi đặt trước tất cả các tên cài đặt của chúng tôi bằng Hồng Kông. Điều này có thể được thay thế bằng bất kỳ từ khóa nào bạn chọn thường liên quan đến tên plugin của bạn. Đoạn mã trên chỉ là cài đặt mẫu và không nên liên quan đến trình cắm cuối cùng của chúng tôi. Đây chỉ là để cung cấp cho bạn cái nhìn sâu sắc về cách viết tên biến và các lệnh gọi hàm của bạn.
4. Đi sâu vào các bộ lọc và hành động
Có một khái niệm đáng chú ý khác là đề cập đến trước khi chúng tôi nhảy vào mã thô. Hành động và bộ lọc là hai khái niệm hoàn toàn khác nhau liên quan sâu sắc đến cách họ thao tác dữ liệu plugin.
Hai bit mã này trở thành tiêu chuẩn trong API WordPress. Các bộ lọc và hành động cho phép các nhà phát triển trình cắm cập nhật các đoạn mã trong bảng điều khiển quản trị viên WordPress liên quan đến trình cắm mới của bạn. Điều này có nghĩa là bạn có thể thêm một tab mới trong thanh bên hoặc liên kết cài đặt bổ sung cho các tùy chọn Trình cắm của bạn.
Hiểu add_filter ()
Một bộ lọc được sử dụng trên một chút văn bản hoặc dữ liệu được truyền vào WordPress. Với các bộ lọc, bạn hoàn toàn có thể lọc nội dung thông qua các chức năng viết tùy chỉnh của riêng bạn để thay đổi dữ liệu theo bất kỳ cách nào.
Ví dụ: bạn có thể tạo bộ lọc để thay đổi $ the_content đó là một biến được đặt bởi WordPress có chứa toàn bộ nội dung bài đăng của một bài viết WordPress. Đối với trình cắm của chúng tôi, chúng tôi sẽ lấy $ the_content và rút ngắn độ dài của các ký tự thành một đoạn trích.
Các bộ lọc trở nên hữu ích khi bạn viết các trình cắm để tùy chỉnh giao diện của blog. Chúng đặc biệt phổ biến khi viết các tiện ích thanh bên hoặc các chức năng nhỏ hơn để thay đổi cách hiển thị bài đăng. Dưới đây là một dòng mã mẫu cho biết cách áp dụng bộ lọc.
add_filter ('wp_title', 'hongkiat_func'); Ở đây chúng tôi đang thêm một bộ lọc vào tiêu đề trang WordPress. Lưu ý mã này không liên quan đến plugin chính thức của chúng tôi và chỉ được sử dụng làm ví dụ ở đây.
Các add_filter Hàm có nguồn gốc từ WordPress và được sử dụng để thêm bộ lọc mới vào một biến được tìm thấy trong nội dung trang. Trong dòng trên chúng tôi đang nhắm mục tiêu $ wp_title trong đó có tiêu đề của trang hiện tại của chúng tôi. Chúng tôi sau đó chuyển biến này vào một hàm giả mạo có tiêu đề hongkiat_func () sau đó có thể thao tác và trả lại thẻ tiêu đề mới cho bất kỳ mục đích nào.
Hiểu add_action ()
Các hành động tương tự như các bộ lọc ở chỗ chúng không hoạt động trên các bit dữ liệu mà thay vào đó nhắm mục tiêu các khu vực được xác định trước trong mẫu và bảng quản trị của bạn. Ví dụ, bạn có thể áp dụng một hành động bất cứ khi nào bạn cập nhật hoặc chỉnh sửa nội dung của trang. WordPress cung cấp một danh sách hành động toàn diện trong tài liệu API của họ. Dưới đây là danh sách nhỏ các hành động mẫu để bạn làm quen với một số khu vực mục tiêu được xác định trước.
- xuất bản - được gọi khi một bài đăng được xuất bản hoặc khi trạng thái được thay đổi thành “được phát hành”
- save_post - được gọi khi bài đăng / trang được tạo từ đầu hoặc cập nhật
- wp_head - được gọi khi mẫu được tải và chạy
wp_head ()chức năng - loop_end - được gọi ngay sau khi bài đăng cuối cùng được xử lý thông qua vòng lặp WordPress
- trackback_post - được gọi bất cứ khi nào một trackback mới được thêm vào bài viết
Một lần nữa chúng ta có thể thấy bit mã này đơn giản như thế nào. Nếu bạn có thể hiểu được sự khác biệt giữa các hành động và bộ lọc, bạn sẽ tiến gần hơn đến việc xây dựng các plugin WordPress hoạt động toàn diện. Dưới đây là một dòng mã khác khởi tạo một chức năng hành động trên save_post móc. Để làm rõ lại, điều này không liên quan đến plugin đang phát triển hiện tại của chúng tôi và chỉ được sử dụng như một đoạn mã ví dụ để hiểu add_action () chức năng.
add_action ('save_post', 'thông báo'); Vì vậy, ở đây chúng ta thấy một thiết lập tương tự như trước với add_filter (). Chúng tôi cần 2 biến, đầu tiên giữ tên của hook chúng tôi đang nhắm mục tiêu. Trong trường hợp này save_post có nghĩa là bất cứ khi nào một bài đăng mới được lưu, chúng tôi sẽ gọi hàm của chúng tôi được xác định ở vị trí thứ hai (thông báo ()). Rõ ràng bạn có thể cập nhật thông báo là bất kỳ tên hàm nào bạn muốn chạy, tuy nhiên điều này không bắt buộc đối với trình cắm ví dụ hiện tại của chúng tôi.
Kết thúc Logic Logic của chúng tôi
Kết thúc trên con đường của chúng tôi, chúng tôi sẽ thêm chức năng cuối cùng của chúng tôi ngay vào tệp trình cắm của chúng tôi. Tài liệu API rất cụ thể và cung cấp một nguồn tài nguyên tuyệt vời cho các nhà phát triển có thể giữ các câu hỏi nâng cao. Tài liệu có vẻ khó nếu bạn không quen với PHP nhưng hãy dành thời gian cho các khái niệm và mọi thứ sẽ bắt đầu trôi chảy một cách tự nhiên!
Các chức năng dưới đây nên được thêm trực tiếp sau bình luận tiêu đề của plugin của bạn. Ngoài ra, điều này cũng có thể được đặt trong chủ đề của bạn Hàm.php tập tin. Mã được sử dụng để tạo nội dung bài đăng động dựa trên một phạm vi ký tự giới hạn.
Vì vậy, với ví dụ của chúng tôi, chúng tôi có thể giới hạn đoạn trích câu chuyện chỉ dài 55 ký tự với hk_trim_content () chức năng. Bạn có thể dễ dàng gọi bit mã này từ một tiện ích thanh bên hoặc một trong các tệp chủ đề của bạn để thay thế $ the_content.
= $ giới hạn) mảng_pop ($ nội dung); $ content = implode ("", $ content). 'Mạnh'; other $ content = implode ("", $ content); $ content = preg numplace ('/\[.+\[/', ", $ content); $ content = application_filters ('the_content', $ content); trả về $ content;?> Bạn không nên mong đợi rằng bạn hiểu đầy đủ tất cả các biến hoặc hàm nội bộ được sử dụng ở đây. Chỉ cần hiểu một cách tổng quát về cách các chức năng của bạn nên được viết và một tập hợp ví dụ sẽ như thế nào là một khởi đầu rất tốt.
Bạn cũng có thể nhận thấy chúng tôi đang sử dụng một cuộc gọi đến áp dụng các bộ lọc đó là một chức năng cụ thể của WordPress. Đây là một khía cạnh khác bạn không cần phải hoàn toàn nắm bắt nhưng nó giúp ích cho việc lập trình trong tương lai qua WP. Kiểm tra trang tham chiếu application_filters để biết thêm chi tiết và Câu hỏi thường gặp về chủ đề này.
Hàm cốt lõi ở trên được đặt tên hk_trim_content (). Điều này chỉ cần 1 tham số có tên $ giới hạn. Điều này cũng có thể được rút ngắn thành $ lim sẽ lưu một số nguyên chỉ định có bao nhiêu ký tự để giới hạn đoạn trích của bạn. Nội dung được sử dụng trên các trang bài đăng đầy đủ và cả các trang tĩnh (về chúng tôi, liên hệ).
Do đó, để gọi hàm này, chúng ta sẽ cần thêm tham số vào các tệp mẫu. Điều này sẽ được đặt ở đâu đó có thể trong của bạn index.php hoặc là loop.php (các) tệp và sẽ yêu cầu bạn cài đặt plugin trước. Ví dụ dưới đây:
Cài đặt và chạy Plugin
Tôi đã tạo một tệp mẫu cho plugin để demo nếu bạn muốn bỏ qua mã hóa cứng. Chỉ cần tải xuống tệp này (đổi tên thành .php) hoặc sao chép / dán mã vào tài liệu PHP mới và tải tệp này lên / wp-content / plugin danh mục.
Sau khi hoàn thành, bạn sẽ muốn truy cập bảng quản trị WordPress và duyệt bộ trình cắm hiện tại của mình để xem bản demo vừa cài đặt. Khi bạn kích hoạt, sẽ không có gì mới xảy ra, cho đến khi chúng tôi thêm thủ công cuộc gọi chức năng của mình. Để làm điều này chỉ cần điều hướng Xuất hiện -> Biên tập và tìm kiếm đơn.php.
Tệp này chứa tất cả các mẫu HTML / CSS cho trang bài viết cơ bản của bạn. Cuộn xuống cho đến khi bạn tìm thấy Nội dung() và thay thế bằng mã ví dụ ở trên. Điều này sẽ giới hạn tất cả các trang bài viết của bạn ở 55 ký tự cho dù chế độ xem đang được sử dụng. Bạn cũng có thể thêm chức năng này vào các trang tương tự trong thư mục mẫu của mình, chẳng hạn như tìm kiếm.php hoặc là archive.php.
Phần kết luận
Đây là một số điều cơ bản để giúp bạn bắt đầu làm việc trong quá trình phát triển WordPress. Hệ thống plugin rất rộng lớn và chứa rất nhiều chức năng nội bộ. Nếu bạn đã có ý tưởng cho một plugin, hãy dùng thử cài đặt cục bộ của WordPress để thực hành các chủ đề này.
Nếu bạn vẫn còn bối rối bởi nhiều thông tin, bạn có thể xem lại tài liệu WordPress và tìm kiếm câu trả lời của mình ở đó. Cộng đồng phát triển có đầy đủ người dùng hữu ích và các diễn đàn lưu trữ các câu hỏi từ nhiều năm trước.
