Là nhà phát triển WordPress, chúng tôi có trách nhiệm xây dựng các plugin mang lại lợi ích cho người dùng của chúng tôi không chỉ bằng chức năng mà các plugin của chúng tôi thêm vào. Các plugin của chúng tôi cũng nên tránh tải các tài nguyên không cần thiết, không nên làm chậm phần phụ trợ và phải dễ sử dụng, chẳng hạn như plugin soạn sẵn WPPB
Hãy nhớ rằng, hệ sinh thái WordPress dựa trên mã nguồn mở và các nhà phát triển xây dựng dựa trên các plugin của nhau. Đó là tinh thần của nguồn mở để cộng tác và cùng nhau tạo mã cải tiến. Nhưng chúng ta cũng cần một khuôn khổ để làm việc cùng nhau một cách hiệu quả. Do đó, Automattic sử dụng các nguyên tắc nghiêm ngặt khi chấp nhận một plugin vào kho lưu trữ của họ [điều này cũng đúng với các chủ đề]
May mắn thay, có những nhà phát triển như Tom McFarlin và Devin Vinson. Họ đã tạo plugin soạn sẵn WPPB, nhằm giúp việc xây dựng plugin WordPress dễ dàng hơn
Tại sao nên sử dụng Bản soạn sẵn plugin chẳng hạn như Bản soạn sẵn WPPB?
Trước hết, hãy nói về lý do tại sao bạn nên cân nhắc sử dụng bản soạn sẵn trong quy trình phát triển của mình
Có một số tình huống sử dụng bản soạn sẵn WPPB có ý nghĩa
- Bạn đang xây dựng một plugin từ đầu với một nhóm các nhà phát triển
- Plugin dự định sẽ được xuất bản trong kho lưu trữ plugin WP
- Plugin của bạn sẽ trở thành bắt buộc trong hoạt động kinh doanh của khách hàng và cần phải đáng tin cậy và ổn định
- Bạn muốn tìm hiểu về các tiêu chuẩn mã hóa WordPress và các phương pháp hay nhất
Hãy chia nhỏ từng lý do đó
thứ nhất. Bạn đang xây dựng một plugin từ đầu, với một nhóm các nhà phát triển
Bất cứ khi nào có nhiều nhà phát triển làm việc trên cùng một cơ sở mã, những thách thức sẽ xảy ra mà các nhà phát triển đơn lẻ hiếm khi gặp phải. Bạn cần đảm bảo rằng
- Mọi người đều hiểu cấu trúc tập tin
- Mục đích của mọi tệp và lớp đều rõ ràng
- Các chức năng được ghi lại tốt
- Nhà phát triển hiểu nơi đặt hành động, gọi lại, v.v.
- Quá trình đẩy các thay đổi đối với hệ thống dàn dựng và trực tiếp của bạn rõ ràng
Là một nhà phát triển đơn lẻ, bạn thường không lo lắng quá nhiều về những điều này. Bạn là người duy nhất làm việc trên plugin, vì vậy dù sao cấu trúc cũng là của bạn. Nhưng với nhiều nhà phát triển, bạn cần đảm bảo rằng nhà phát triển A hiểu tại sao nhà phát triển B lại viết mã theo cách của anh ấy/cô ấy
Bản tóm tắt WPPB giúp tránh nhầm lẫn, vì nó đặt mọi người trên cùng một trang
lần 2. Plugin dự định sẽ được xuất bản trong Kho lưu trữ plugin WP
Như đã nói trước đó, Automattic thực thi các nguyên tắc nghiêm ngặt đối với các plugin được chấp nhận trong kho lưu trữ WP. Sử dụng bản soạn sẵn WPPB giúp việc tuân theo các hướng dẫn đó trở nên đơn giản hơn vì mã đã được viết theo các tiêu chuẩn mã hóa và tiêu chuẩn tài liệu. Vì vậy, bạn đang tiết kiệm thời gian duyệt qua codex WordPress và có thể bắt đầu làm việc ngay lập tức, trong khi chỉ cần làm theo các cấu trúc được cung cấp trong bản soạn sẵn
Ngoài ra, các tệp đã được sắp xếp theo cách mà kho plugin yêu cầu. Cấu trúc tệp hiển thị rõ ràng, tệp nào sẽ đi đến đâu và loại bỏ mọi phỏng đoán
lần thứ 3. Công việc kinh doanh của khách hàng của bạn sẽ phụ thuộc vào plugin của bạn
Mặc dù việc phát triển một plugin ổn định và đáng tin cậy phải luôn là mục tiêu, nhưng có những tình huống mà bạn muốn plugin của mình trở nên vững chắc. Nếu plugin của bạn thực hiện các hành động mà không có tác động đến hoạt động kinh doanh của khách hàng, thì cơ sở mã của bạn cần phải ổn định, hiệu quả và dễ bảo trì
Bằng cách sử dụng plugin soạn sẵn làm nền tảng, bạn sẽ thấy mã của mình hoạt động đơn giản hơn khi bạn càng quen với cấu trúc soạn sẵn. Nếu không có cấu trúc cố định đó, thật dễ dàng - trong tiềm thức - tạo cấu trúc plugin mới cho mọi dự án bạn đang thực hiện. Điều đó sẽ gây khó khăn nghiêm trọng khi làm việc với mã mà bạn chưa chạm vào trong 6-12 tháng
lần thứ 4. Bạn muốn tìm hiểu về các tiêu chuẩn mã hóa WordPress và các phương pháp hay nhất
Để trở thành một nhà phát triển giỏi hơn, bạn phải liên tục học hỏi những điều mới và thích ứng với các phương pháp hay nhất. Một trong những cách nhanh nhất để bạn làm quen với các tiêu chuẩn mã hóa WordPress là mở rộng một plugin đã triển khai chúng. WPPB làm cho điều này rất thoải mái. Bạn có thể sao chép bất kỳ plugin ví dụ nào và bắt đầu học
Bạn sẽ sớm hiểu tại sao chúng được xây dựng theo cách của chúng và cách bạn có thể thêm chức năng tùy chỉnh của mình cho chúng
Thiết lập bản cài đặt cục bộ và duyệt qua mã của các plugin mẫu
Bắt đầu với Plugin mới của bạn bằng cách sử dụng WPPB Boilerplate cho WordPress
Lý thuyết đủ rồi, hãy đi sâu vào sử dụng WPPB
Đối với bài đăng này, tôi sẽ cho rằng bạn đã cài đặt một trang web cục bộ làm môi trường phát triển. Việc cài đặt Git trên máy của bạn sẽ hữu ích, nhưng điều đó không bắt buộc
Bước đầu tiên là đi đến WPPB. tôi
Vì bản soạn sẵn WPPB có nhiều nơi tham chiếu tên plugin, sên, tên tác giả, v.v. , bạn nên sử dụng WPPB. trình tạo me khi tải xuống các tệp. Bạn có thể sao chép kho lưu trữ WPPB Github, nhưng điều đó sẽ để lại tất cả công việc tìm kiếm + thay thế cho bạn
Đối với ví dụ này, chúng tôi sẽ sử dụng các chi tiết sau
Khi bạn nhấp vào “Build Plugin”, trình duyệt của bạn sẽ tải xuống một kho lưu trữ zip mà sau đó bạn có thể cài đặt trên trang web địa phương của mình. Để làm được điều đó, bạn có thể sử dụng trình cài đặt plugin thông thường hoặc giải nén tệp lưu trữ và đặt nó vào wp-content/plugins. Sau khi kích hoạt plugin, bạn sẽ thấy nó hiển thị trong danh sách Plugin của mình
Hiểu cấu trúc soạn sẵn của plugin WordPress
Ok, quá trình tạo và cài đặt plugin không quá thú vị – nhưng cần thiết cho người mới bắt đầu. Để thực sự bắt đầu phát triển với plugin, hãy xem cấu trúc tệp
Như bạn mong đợi, các tệp được sắp xếp rất tốt
Thư mục “admin” chứa logic và giao diện người dùng tải trong khu vực WP-Admin của trang web. Mọi nhà phát triển nhìn vào plugin này ngay lập tức hiểu rằng
Thư mục “bao gồm” chứa nội dung của plugin, ở đây bạn sẽ đặt hầu hết các chức năng. Ví dụ, bạn có thể mở rộng class-my-plugin-activator. php để thiết lập các bảng cơ sở dữ liệu tùy chỉnh, công việc wp-cron tùy chỉnh hoặc để kiểm tra các phần bổ trợ và phần phụ thuộc khác. Bên trong class-my-plugin-deactivator. php, bạn có thể dọn sạch trang web khi plugin của bạn bị vô hiệu hóa
Theo Tiêu chuẩn quốc tế hóa, class-my-plugin-i18n. php tải miền văn bản của plugin
Bất kể bạn đang xem tệp plugin nào, bạn sẽ thấy rằng mã được ghi lại rất tốt
Trong ảnh chụp màn hình, bạn có thể thấy tệp cốt lõi cho plugin mới của mình, theo tôi đây là điểm khởi đầu lý tưởng để hiểu cách thức hoạt động của logic plugin. Bất cứ khi nào bạn bắt gặp chuỗi “my-plugin” hoặc “My_Plugin”, hãy nhớ rằng tôi đã đặt nó trong trình tạo. Đó là lý do tại sao tôi thích tạo bản tóm tắt hơn là chỉ sao chép repo Github. Nếu không có trình tạo, bạn phải xem qua tất cả các tệp plugin và điều chỉnh các chuỗi đó để khớp với tên plugin của bạn
Hãy nói nhanh về cấu trúc tệp cho các nội dung như tệp JS hoặc CSS
Để loại bỏ mọi phỏng đoán khỏi quá trình phát triển, WPPB được tổ chức trong các thư mục riêng biệt dành cho CSS, JS và các phần. Như bạn mong đợi, class-my-plugin-public. php chịu trách nhiệm xử lý CSS và JS đúng cách và tải các phần khi cần. Khi bạn mở tệp, bạn sẽ thấy rằng nó sử dụng wp_enqueue_script, wp_enqueue_style và wp thông thường
Nếu bạn không quen làm việc với partials, tôi khuyên bạn nên đọc qua tài liệu Tệp mẫu. “Một phần mẫu là một phần của mẫu được bao gồm như một phần của mẫu khác, chẳng hạn như tiêu đề trang web. Các phần mẫu có thể được nhúng trong nhiều mẫu, đơn giản hóa việc tạo chủ đề. ” – Tài liệu WordPress
Mặc dù tài liệu nói về việc tạo chủ đề, rõ ràng bạn cũng có thể bao gồm các phần trong plugin, cả trong phần phụ trợ và phần đầu. Đối với giao diện người dùng, một cách khả thi để sử dụng một phần có thể là nhúng nó vào một mã ngắn. Trong phần phụ trợ, bạn có thể muốn sử dụng một phần trong trang quản trị plugin của mình [mà chúng tôi sẽ đề cập trong bài viết này]
Rõ ràng, các tệp hiện gần như trống rỗng và chỉ có logic cơ bản nhất. Điều này tuyệt vời để bắt đầu một plugin mới từ đầu, nhưng có thể không lý tưởng để tìm hiểu cách thức hoạt động của mã soạn sẵn. Để học, tôi khuyên bạn nên cài đặt Plugin WPPB Demo và làm quen với nó
Thí dụ. Thiết lập trang tùy chọn trong phần phụ trợ
Như bạn có thể thấy sau khi kích hoạt Plugin WPPB Demo, có một trang tùy chọn mới trong menu “Plugin”
Để kiểm tra cách trang này được thêm vào, hãy xem qua mã plugin
Tìm kiếm nơi đã thêm trang “WPPB Demo Options” rất đơn giản, chúng ta phải xem thư mục “admin”. Dựa trên cấu trúc thư mục, đơn giản là không có nơi nào khác để đặt mã tải trong khu vực WP-Admin
File mới này xử lý nội dung hiển thị trên trang quản trị. Bạn có thể kiểm tra logic của nó và bạn sẽ thấy rằng nó có khả năng
- Hiển thị đầu trang, nội dung hoặc chân trang
- Lưu liên kết đến hồ sơ xã hội
- Ngoài ra còn có các ví dụ để xử lý đầu vào
Vui lòng xem các chức năng này để biết chúng là gì. ví dụ. Đừng mong đợi chúng được tích hợp sâu vào bất kỳ chủ đề nào bạn đang sử dụng. Chúng nhằm giải thích cách bạn có thể xây dựng chức năng tương tự với plugin mới của mình. Tải nội dung diễn ra trong class-wppb-demo-plugin-admin. php, trong hàm load_dependencies[] ở dòng 70
Tất nhiên, điều đó hoàn toàn phụ thuộc vào bạn nếu bạn thêm cài đặt plugin dưới dạng một mục trong menu “Plugin”, làm mục menu chính hoặc trang Tùy chọn. Bạn có thể thay đổi cách triển khai bất kỳ lúc nào bằng cách sửa đổi hàm setup_plugin_options_menu[] ở dòng 55 của class-wppb-demo-plugin-settings. php
Tuy nhiên, tôi khuyên bạn nên tập trung vào UX của phần phụ trợ. Không phải lúc nào bạn cũng nên làm lộn xộn menu WP-Admin với các trang menu chỉ vì bạn nghĩ rằng plugin của mình quan trọng hơn các plugin khác
Kết luận về Plugin WPPB Boilerplate cho WordPress
Đối với tôi, plugin soạn sẵn WPPB là một nền tảng tuyệt vời để xây dựng một plugin WordPress từ đầu
Tôi nghĩ rằng nó phù hợp với các dự án mà
- Yêu cầu nhiều nhà phát triển làm việc trên plugin mới
- Lên kế hoạch gửi plugin tới kho lưu trữ plugin WordPress
- Muốn xây dựng một cơ sở mã đáng tin cậy và có thể bảo trì
- Có nghĩa là để nhà phát triển làm quen với các tiêu chuẩn mã hóa WordPress
Mặc dù vậy, plugin soạn sẵn WPPB cũng có thể quá mức cần thiết, đặc biệt nếu bạn
- Muốn xây dựng plugin MVP để xác thực ý tưởng
- Cần một sửa chữa tạm thời cho một vấn đề đơn giản
Xin lưu ý rằng các nhà phát triển lần đầu tiên làm việc với mã sẽ cần phải làm quen với bản soạn sẵn. Tuy nhiên, khi họ đã biết bản soạn sẵn WPPB, họ sẽ ở một vị trí tốt để xây dựng một plugin tuân theo các tiêu chuẩn tài liệu và mã hóa WordPress
Cần một nhà cung cấp dịch vụ lưu trữ WordPress nhanh hơn?
Giải pháp WordPress được quản lý của Nexcess tự động xử lý nén hình ảnh và tất cả các bản cập nhật plugin và cốt lõi của WordPress để bạn có thể tập trung vào việc tạo một plugin đặc biệt