当前位置: 首页>>WEB开发>>正文


如何将插件添加到WordPress存储库?

webfans WEB开发 , , 去评论

问题描述

我刚刚创建了我的第一个插件,它得到了WordPress的批准。对我来说是个好消息,但现在呢? Codex上的”instructions”对我来说一点都不清楚。我找到了一篇关于Dig WP的文章,我设法得到了第3行代码。在那之后没有快乐。

这里有没有人有一套关于如何做到这一点的明确说明,而不需要阅读整本书?我相信这里有非常有经验的人一直在做这些事情……

提前致谢!

最佳解决思路

第1步 – 确保格式正确

WordPress本身取决于主插件文件顶部的标题。在许多情况下,如果您的插件是“我的酷插件”,则此文件位于文件夹主目录中的my-cool-plugin.php。确保文件的顶部遵循以下格式:

<?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]
*/

WordPress.org存储库依赖于您的readme.txt文件来创建描述和下载页面。因此,请确保您的readme.txt文件符合以下格式:

=== [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 ==

在WordPress.org上有一个方便的readme validator,您可以使用它来确保您的自述文件具有所需的一切。只需copy-paste,它将检查以确保所有部分都在那里并且您已准备就绪。

第2步 – 查看SVN存储库

将开发版本与WordPress.org插件存储库分开是一个好主意。是的,SVN用于版本控制,但WordPress更多地将其用于版本管理。如果您开始将每个变更集提交到存储库,则可能会遇到问题。许多开发人员做的一件事是使用Git在本地开发,然后在准备好发布时将文件传输到Subversion存储库。

These instructions assume you’re using a Windows computer. If you’re on a Mac, you can use SCPlugin instead of TortoiseSVN. The steps you’ll need to follow will be the same, only the contextual menus and screenshots will differ slightly because of the UI. I don’t have a Mac, so I can’t create screenshots to walk you through a tutorial … but trust me, it’s the same process.

如果您还没有TortoiseSVN,请安装它。

TortoiseSVN是Windows的开源Subversion GUI。相信我,使用GUI比尝试从命令行执行操作要容易得多。你也会遇到更少的问题。

查看您的WordPress-hosted SVN存储库

找到您要存储WordPress托管的插件版本的位置。默认情况下,我将/My Documents/WordPress/用于我的所有托管开发工作。在文件夹内右键单击,然后从下拉菜单中选择”SVN Checkout”。

plugin-repository,customization,wordpress

在弹出的对话框窗口中,输入您的WordPress.org插件存储库URL(我使用其中一个用于演示目的)并选择您要创建的子文件夹。

plugin-repository,customization,wordpress

Tortoise会考虑一下,然后它将从WordPress.org下载存储库。新创建的文件夹将为您设置所有必需的文件夹。现在你只需要copy-paste并一次提交一步。

将您的最新版本复制到/tags

这是我从大多数教程向后做事的地方。其他人都会告诉你先提交/trunk,但请记住,在查看插件时,除了自述文件外,WordPress不会在/trunk中使用任何内容。因此,如果您在提交标记之前将插件放入/trunk并丢失网络连接(或其他出错的地方),那么您将遇到问题。

/tags文件夹中,创建一个名称与您为插件发布的版本相同的文件夹。因此,如果您要发布0.1版,请创建一个/tags/0.1文件夹。

plugin-repository,customization,wordpress

将整个插件复制到此文件夹中。

现在文件夹中有right-click,然后从下拉菜单中选择”SVN Commit”。

您将看到一个弹出的窗口,显示您的所有更改(您应该看到所有新文件都标记为”non-versioned”)。

plugin-repository,customization,wordpress

选中所有插件文件旁边的框(或单击”Select All”以选择所有这些文件)。

在顶部的框中,输入提交消息。由于您提交的是标签,因此您应该使用以下内容:

Tagging version 0.1 of [My Plugin].

单击确定。

再次,Tortoise会思考几分钟,然后它会询问您的WordPress用户名和密码,以便提交到服务器。提供它们,等待事情通过并说”Success,”然后继续下一步。

将您的最新版本复制到/trunk

现在导航到存储库的/trunk文件夹,再次将copy-paste插入到该文件夹​​中。完成上述相同步骤以选择文件并准备提交。但是对于消息,请使用解释新版本功能的内容:

Version 0.1 of [My Plugin] – adds support for OpenID.

一切都通过后,你只需等待一点WordPress.org的服务器即可迎头赶上。有些日子它们可能比其他日子慢,但是在一个小时左右之内你应该在存储库中看到你的新版本。

将插件更新为新版本

一旦你的插件在野外,准备更新相对容易。

首先,使用SVN Update命令确保您拥有最新版本的存储库。如果您是唯一的开发人员,那么您应该已经开始了,但最好在提交之前进行更新。

然后通过上面的过程在/tags中为您的新版本创建一个新的sub-folder。说,/tags/0.2。请勿触摸旧的/0.1文件夹。这是有原因的,你永远不会再触摸它。

提交新标签,然后转到/trunk文件夹。用新版本替换/trunk中的所有内容并按上述方式提交。一旦服务器更新,他们将开始讨论新版本而不是旧版本。

参考资料

本文由朵颐IT整理自网络, 文章地址: https://duoyit.com/article/3019.html,转载请务必附带本地址声明。