Bước 1 - Đảm bảo mọi thứ được định dạng chính xác
Bản thân WordPress phụ thuộc vào các tiêu đề ở đầu tệp plugin chính của bạn. Trong nhiều trường hợp, nếu plugin của bạn là "My Cool Plugin" thì tập tin này nằm my-cool-plugin.phptrong thư mục chính của thư mục của bạn. Đảm bảo phần trên cùng của tệp tuân theo định dạng này:
<?php
/*
=== [Plugin Name] ===
Plugin Name: [Plugin name]
Plugin URI: [Website where plugin information can be found - your blog, maybe]
Description: [Short description of your plugin]
Author URI: [Your website]
Author: [Your name]
Version: [This version number]
*/
Kho lưu trữ WordPress.org phụ thuộc vào readme.txttệp của bạn để tạo mô tả và trang tải xuống. Vì vậy, hãy đảm bảo readme.txttệp của bạn phù hợp với định dạng sau:
=== [Plugin Name] ===
Contributors: [Your WordPress.org username]
Donate link: [A site people can go to to give you money]
Tags: [Search terms related to your plugin]
Requires at least: [Minimum version of WordPress required]
Tested up to: [Newest version of WordPress you've tested with]
Stable tag: [This version number]
[Short, one-sentence description of your plugin]
== Description ==
[Long description of your plugin]
== Installation ==
[Steps required to install the plugin]
== Frequently Asked Questions ==
= [A question] =
[An answer]
= [Another question] =
[Another answer]
== Screenshots ==
== Changelog ==
== Upgrade Notice ==
Có một trình xác nhận readme tiện dụng trên WordPress.org mà bạn có thể sử dụng để đảm bảo readme của bạn có mọi thứ nó cần. Chỉ cần sao chép-dán và nó sẽ kiểm tra để đảm bảo tất cả các phần đều ở đó và bạn đã sẵn sàng để đi.
Bước 2 - Kiểm tra kho SVN
Đó là một ý tưởng tốt để tách biệt phiên bản phát triển của bạn khỏi kho lưu trữ plugin WordPress.org. Có, SVN được sử dụng để kiểm soát phiên bản, nhưng WordPress sử dụng nó nhiều hơn để quản lý phát hành. Nếu bạn bắt đầu cam kết mọi thay đổi đối với kho lưu trữ, bạn sẽ có khả năng gặp sự cố. Một điều mà nhiều nhà phát triển làm là phát triển cục bộ bằng Git, sau đó chuyển các tệp của bạn vào kho Subversion khi bạn sẵn sàng thực hiện một bản phát hành.
Các hướng dẫn này giả sử bạn đang sử dụng máy tính Windows. Nếu bạn đang sử dụng máy Mac, bạn có thể sử dụng SCPlugin thay vì TortoiseSVN. Các bước bạn cần thực hiện sẽ giống nhau, chỉ có các menu và ảnh chụp màn hình theo ngữ cảnh sẽ khác nhau đôi chút vì giao diện người dùng. Tôi không có máy Mac, vì vậy tôi không thể tạo ảnh chụp màn hình để hướng dẫn bạn qua hướng dẫn ... nhưng tin tôi đi, đó là quá trình tương tự.
Cài đặt TortoiseSVN nếu bạn chưa có.
TortoiseSVN là một Subversion GUI nguồn mở cho Windows. Tin tôi đi, sử dụng GUI dễ hơn vô cùng so với cố gắng làm những việc từ dòng lệnh. Bạn cũng sẽ gặp ít vấn đề hơn.
Kiểm tra kho lưu trữ SVN được lưu trữ trên WordPress của bạn
Tìm một nơi mà bạn muốn lưu trữ phiên bản được lưu trữ trên WordPress của plugin. Theo mặc định, tôi sử dụng /My Documents/WordPress/cho tất cả các công việc phát triển được lưu trữ của tôi. Nhấp chuột phải vào thư mục và chọn "SVN Checkout" từ menu thả xuống.
Trong cửa sổ hộp thoại bật lên, hãy nhập URL kho lưu trữ plugin WordPress.org của bạn (Tôi đang sử dụng một trong số đó cho mục đích trình diễn) và chọn thư mục con bạn muốn tạo.
Rùa sẽ suy nghĩ một chút, sau đó nó sẽ kéo xuống kho lưu trữ từ WordPress.org. Thư mục mới được tạo sẽ có tất cả các thư mục cần thiết đã được thiết lập cho bạn. Bây giờ bạn chỉ cần sao chép-dán và cam kết ... từng bước một.
Sao chép phiên bản mới nhất của bạn vào /tags
Đây là nơi tôi làm những điều ngược từ hầu hết các hướng dẫn. Mọi người khác sẽ bảo bạn cam kết /trunktrước, nhưng hãy nhớ rằng WordPress không sử dụng bất cứ thứ gì /trunkngoại trừ tệp readme khi xem các plugin. Vì vậy, nếu bạn đặt plugin của mình vào /trunkvà mất kết nối mạng (hoặc có sự cố khác) trước khi bạn cam kết thẻ, bạn sẽ gặp vấn đề.
Trong /tagsthư mục, tạo thư mục có tên giống như phiên bản bạn đang phát hành cho plugin của mình. Vì vậy, nếu bạn đang phát hành phiên bản 0.1, hãy tạo một /tags/0.1thư mục.
Sao chép toàn bộ plugin của bạn vào thư mục này.
Bây giờ, nhấp chuột phải vào thư mục và chọn "SVN Commit" từ menu thả xuống.
Bạn sẽ thấy một cửa sổ bật lên hiển thị tất cả các thay đổi của bạn (bạn sẽ thấy tất cả các tệp mới của mình được đánh dấu là "không có phiên bản").
Chọn hộp bên cạnh tất cả các tệp của plugin của bạn (hoặc nhấp vào "Chọn tất cả" để chọn tất cả các tệp).
Trong hộp trên cùng, nhập thông điệp cam kết. Vì bạn đang cam kết một thẻ, có lẽ bạn nên sử dụng một cái gì đó như:
Gắn thẻ phiên bản 0.1 của [Plugin của tôi].
Nhấn OK.
Một lần nữa, Rùa sẽ suy nghĩ trong vài phút, sau đó nó sẽ hỏi bạn tên người dùng và mật khẩu WordPress của bạn để cam kết với máy chủ. Cung cấp cho họ, chờ đợi mọi thứ đi qua và nói "Thành công", sau đó chuyển sang bước tiếp theo.
Sao chép phiên bản mới nhất của bạn vào /trunk
Bây giờ điều hướng đến /trunkthư mục của kho lưu trữ và một lần nữa sao chép-dán plugin của bạn vào thư mục đó. Trải qua các bước tương tự ở trên để chọn tệp của bạn và chuẩn bị cam kết. Nhưng đối với một tin nhắn, hãy sử dụng một cái gì đó giải thích những gì bản phát hành mới làm:
Phiên bản 0.1 của [Plugin của tôi] - thêm hỗ trợ cho OpenID.
Khi mọi thứ đã hoàn tất, bạn chỉ cần chờ một chút để các máy chủ của WordPress.org bắt kịp. Chúng có thể chậm hơn một số ngày so với những ngày khác, nhưng trong vòng một giờ hoặc lâu hơn, bạn sẽ thấy bản phát hành mới của mình trong kho lưu trữ.
Cập nhật plugin lên phiên bản mới
Khi plugin của bạn đang hoạt động, việc chuẩn bị một bản cập nhật tương đối dễ dàng.
Đầu tiên, sử dụng lệnh Cập nhật SVN để đảm bảo bạn có phiên bản mới nhất của kho lưu trữ. Nếu bạn là nhà phát triển duy nhất, bạn nên có, nhưng nên cập nhật trước khi bạn cam kết.
Sau đó thực hiện quy trình trên để tạo thư mục /tagscon mới cho phiên bản mới của bạn. Say, /tags/0.2. Đừng chạm vào /0.1thư mục cũ . Đó là vì một lý do và bạn sẽ không bao giờ chạm vào nó một lần nữa.
Cam kết thẻ mới của bạn, sau đó đi đến /trunkthư mục. Thay thế mọi thứ /trunkbằng phiên bản mới của bạn và cam kết như trên. Khi các máy chủ cập nhật, họ sẽ bắt đầu nói về phiên bản mới thay vì phiên bản cũ.