Hướng dẫn code plugin wordpress

Việc tạo plugin WordPress khá là dễ dàng so với những gì bạn nghĩ. Trên thực tế, bạn có thể tạo một plugin chỉ với một vài dòng code và bạn chỉ cần rất ít kiến thức hoặc kinh nghiệm.

Trong bài viết này, Vietnix sẽ giải thích cách hoạt động của các plugin và thảo luận về cách plugin phù hợp như thế nào với WordPress Community. Sau đó là từng bước để bạn có thể tạo Plugin WordPress đầu tiên của mình.

Nếu bạn đã quen thuộc với nền tảng WordPress, rất có thể bạn cũng sẽ quen thuộc với các plugin. Như tài liệu của WordPress đã nói “Plugin là cách để mở rộng và thêm các chức năng vào trong WordPress”.

Bản thân WordPress bao gồm tập hợp các tính năng, được gọi chung là “core” của nền tảng. Các plugin là các tiện ích bổ sung có thể download, chứa các file và code có thể mở rộng hoặc thay đổi chức năng của core đó. Trên thực tế, WordPress đã tuyên bố rằng nếu một tính năng có khả năng được sử dụng không dưới 80% của người dùng, thì nó nên được đưa vào core. Nếu không, nó phải là một plugin.

Vì lý do này, phạm vi rộng của các chức năng được cung cấp bởi plugin là rất lớn. Bạn có thể sử dụng chúng để thêm form opt-in, slider hoặc là popup.

Điều này có nghĩa là plugin là một trong những tính năng quan trọng nhất của WordPress. Chúng giúp bạn dễ dàng thêm hầu hết mọi chức năng vào website mà không cần mã hóa. Có hàng nghìn plugin miễn phí để bạn sử dụng hoặc bạn có thể chọn các plugin premium [có trả phí]. Hơn nữa, việc download và cài đặt các plugin trong WordPress admin chỉ mất một vài giây.

Các plugin cũng là một phương tiện quan trọng cho những ai muốn bắt đầu tự dev.

Vì WordPress và plugin đều là mã nguồn mở, nên mọi người có thể sử dụng và thử nghiệm mã của chúng. Đây là một cách tuyệt vời cho các lập trình viên mới vào nghề tìm hiểu mọi thứ hoạt động đằng sau và tham gia vào việc tạo plugin WordPress.

Sự khác nhau giữa Plugin và Theme

Trước khi tiếp tục, hãy phân biệt sự khác nhau giữ plugin và theme. Nhìn bên ngoài thì khá là dễ phân biệt. Nhưng trên thực tế, thật sự khó để phân biệt plugin và theme.

Một theme cũng có thể thay đổi chức năng của website, trong khi một plugin có thể thay đổi giao diện của nó. Tất cả các theme WordPress đều chứa file functions.php, bao gồm mã bổ sung chức năng cho website của bạn. Trên thực tế, bạn có thể thêm một đoạn code vào plugin hoặc functions.php và nó sẽ hoạt động tương tự nhau trên website của bạn.

Sự khác biệt là khi bạn thêm đoạn code vào functions.php, nó sẽ được liên kết với theme hiện tại. Điều này có thể hữu ích nếu bạn muốn thay đổi một số chức năng của theme hoặc bạn muốn nhanh chóng thêm một chức năng mà không cần tạo plugin WordPress. Bạn cũng có thể sử dụng phương pháp này nếu bạn đang tạo theme và muốn chèn các chức năng tùy chỉnh.

Cách Plugin hoạt động: Giới thiệu về Hooks, Actions và Filters

Bây giờ đã đến lúc tìm hiểu chuyên sâu hơn một chút. Vietnix đã đề cập rằng các plugin hoạt động theo nghĩa đen là plug in vào WordPress core. Điều này được thực hiện bằng cách sử dụng hook, cho phép một đoạn mã tương tác với đoạn mã khác. Như vậy, các hook sẽ xác định thời điểm và vị trí trên website của bạn một plugin thực sự được sử dụng.

Điều này sẽ hơi khó hiểu nếu bạn chưa làm quen với theme này. Do đó, hãy xem xét một số ví dụ. Hãy tưởng tượng bạn có một plugin thông báo lỗi khi ai đó cố gắng đăng nhập vào website của bạn bằng password sai. Trong trường hợp này, thông báo lỗi có thể là hook. Một plugin có thể kết nối với mã hiển thị thông báo đó và thay đổi văn bản được hiển thị.

Có hai loại hook mà WordPress hiểu được đó là:

• Actions: Được sử dụng để thêm hoặc thay đổi chức năng của WordPress.
• Filters: Được sử dụng để thay đổi chức năng của actions.

Nếu bạn muốn hiểu thêm về hook và cách hoạt động của nó. Vietnix khuyên bạn nên đọc thêm các loại hook trong Plugin Developer Handbook.

Những điều cần biết trước khi tạo Plugin WordPress

Bây giờ, bạn có thể bắt đầu tạo plugin WordPress cho riêng mình. Tuy nhiên, bạn cần đảm bảo đã chuẩn bị kỹ lưỡng.

Mặc dù không bắt buộc phải làm theo các bước dưới đây, nhưng một số kinh nghiệm lập trình và mã hóa sẽ cực kỳ hữu ích. Điều này cực kỳ đúng nếu bạn muốn tạo plugin WordPress của riêng mình thay vì chỉ đi chỉnh sửa đoạn code của người khác. Có một nền tảng kỹ thuật vững chắc sẽ giúp bạn tuân thủ các tiêu chuẩn mã hóa của WordPress để dev các plugin một cách dễ dàng hơn.

Trước khi tạo plugin WordPress, bạn cũng nên cân nhắc về việc sử dụng tên cho plugin mà bạn tạo. Vì bạn cần tránh xung đột về tên, nó xảy ra khi nhiều phần tử trên một website có cùng tên.

Trên thực tế, điều này có nghĩa là quyến định xem bạn sẽ sử dụng một file duy nhất cho đoạn code của mình hoặc là sử dụng nó trên nhiều file khác nhau. Ngoài ra, bạn cũng sẽ muốn lên kế hoạch cho các folder trong plugin của mình.

Tất nhiên, còn nhiều điều cần xem xét trước khi bạn muốn trở thành một lập trình viên WordPress chính thức. Ví dụ: bảo mật plugin là điều cần thiết để đảm bảo plugin của bạn không chứa bất kỳ lỗ hổng bảo mật nào.

Cách tạo Plugin WordPress

Đã đến lúc để tạo Plugin WordPress đầu tiên của bạn, hãy sử dụng một lượng mã hóa tối thiểu. Trong các bước sau, Vietnix sẽ hướng dẫn bạn tạo Plugin WordPress dùng để thay đổi link text khi bạn chèn tag Read More vào post.

Bước 1: Thiết lập môi trường thử nghiệm

Khi bạn đang lập trình bất kỳ thứ gì, cho dù đó là tạo plugin WordPress hay thực hiện các thay đổi khác có thể ảnh hưởng đến website của bạn, bạn phải luôn sử dụng môi trường thử nghiệm. Đây còn được gọi là staging site hoặc local enviroment, tùy thuộc vào việc website được lưu trữ trên server bên ngoài hay máy tính của riêng bạn.

Bất kể vị trí nào, môi trường thử nghiệm phải là một bản sao của website của bạn. Điều này cho phép bạn thêm và chỉnh sửa các file và chức năng của website của mình mà không có nguy cơ gây ra thiệt hại cho website đang hoạt động. Điều này đặc biệt quan trọng khi bạn đang làm việc với các file và plugin core vì những sai lầm có thể gây hại lâu dài cho website của bạn.

May mắn thay, việc thiết lập một website thử nghiệm khá đơn giản, nhờ vào nhiều công cụ có sẵn để giúp bạn. Để thiết lập, bạn nên sử dụng DesktopServer. Chương trình này giúp bạn dễ dàng cài đặt phiên bản WordPress cục bộ trên máy tính.

Bạn cũng có thể tạo một staging site online. Điều này sẽ hoạt động như một bản sao chính của website của bạn, ngoại trừ việc chỉ có bạn và các admin khác mới có thể truy cập nó. Bạn có thể sử dụng DreamHost để dễ dàng tạo một bản sao cho website.

Sau đó, bạn thậm chí có thể sao chép những thay đổi bạn đã thực hiện trên staging site của mình và nhập chúng trở lại phiên bản trực tiếp.

Khi bạn đã chắc chắn rằng môi trường thử nghiệm không rủi ro, đã đến lúc tạo plugin WordPress thực tế.

Bước 2: Tạo một file Plugin mới

Để bắt đầu kết hợp một plugin mới, bạn sẽ cần quyền truy cập vào directory của website của mình. Cách dễ nhất để thực hiện việc này là sử dụng SFTP, đây là một phương pháp để xem và quản lý các file trên website của bạn khi chúng được đặt trên một server bên ngoài. Vietnix sẽ sử dụng một ứng dụng client có tên là FileZilla để làm ví dụ của vì nó vừa miễn phí vừa dễ sử dụng.

Khởi động FileZilla và sử dụng thông tin đăng nhập SFTP do web server của bạn cung cấp để truy cập website của bạn. Sau khi đã vào, bạn sẽ cần điều hướng đến directory chứa các plugin của mình, nằm tại /wp-content/plugins/.

Để thêm plugin mới, bạn cần tạo một thư mục mới bên trong directory này. Làm như vậy ngay bây giờ và đặt cho nó bất kỳ tên duy nhất nào bạn muốn. Vietnix sẽ đặt tên cho directory là very-first-plugin.

Thư mục này là nơi mọi thứ liên quan đến plugin của bạn sẽ được đặt trên website của bạn. Vì plugin này sẽ rất đơn giản, nó chỉ chứa một file duy nhất mà bạn sẽ tạo ngay bây giờ. Đây sẽ là một file PHP, sẽ chứa mã của plugin.

Tiếp theo, mở directory very-first-plugin và nhấp chuột phải, sau đó chọn Create new file.

Bạn sẽ được yêu cầu đặt tên cho file. File này bây giờ sẽ được thêm vào thư mục.

Tại thời điểm này, bạn sẽ cần thêm một số thông tin cơ bản vào file. Thông tin đó sẽ được WordPress sử dụng để hiển thị tên, nội dung và thông tin khác. Để thực hiện việc này, hãy nhấp chuột phải vào file PHP và chọn View/Edit. Sau đó, bạn sẽ được yêu cầu mở file, bạn có thể thực hiện thao tác này trong bất kỳ trình soạn thảo văn bản nào, chẳng hạn như TextEdit hoặc Notepad.

File này hiện đang trống, vì vậy hãy dán văn bản sau vào đó: