WordPressリポジトリにプラグインを追加するには?


11

最初のプラグインを作成したところ、WordPressに承認されました。私にとっては素晴らしいニュースですが、今はどうですか?コーデックスの「指示」は私にははっきりとは言えません。Dig WPに関する記事は見つかりましたが、コードの3行目にたどり着きました。その後、喜びはありません。

本全体を読む必要なしにこれを行う方法についての明確な一連の指示をここに持っている人はいますか?ここにはいつもこれをやっている経験豊富な人がいると思います...

前もって感謝します!


これを試してください:digimantra.com/tutorials/wordpress/...この:1manfactory.com/...
Bainternet

@Piet:Bainternetが以下の回答で言及しているリンクがあなたの質問に答えない場合は、使用しているOSとsvnツールを知る必要があります。
Manzabar

申し訳ありませんが、私はOSX 10.6(Mac)を使用していると述べるべきでした。また、readme.txtファイルの作成手順を説明することは非常に親切ですが、プラグインはWordPress.orgによってすでに承認されているため、必要ありません。今私は、readme.txtファイルが検証された場合にのみ承認できるという想定の下にありましたが、それはそうです:)

公式サイト(?)からSVNをダウンロードしましたが、どのように動作し、どうすればよいのかわかりません。先ほど触れたように、DIG WPのチュートリアルに従い、プログラムが停止する前に、最初の3行を完了しました($ mkdir my-local-dir $ svn co svn.wp-plugins.org/your-plugin- name my-local-dir $ cd my-local-dir /)

実際には、アプリケーションはreadmeファイルとは何の関係もありません。プラグインの開発を始める前に、私はよく申請(そして承認)します。
EAMann

回答:


12

ステップ1-物事が正しくフォーマットされていることを確認する

WordPress自体は、メインのプラグインファイルの上部にあるヘッダーに依存しています。多くの場合、プラグインが「My Cool Plugin」の場合、このファイルは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バリデーターがあり、readmeに必要なものがすべて揃っていることを確認できます。コピーして貼り付けるだけで、すべてのセクションが存在し、準備ができていることを確認できます。

ステップ2-SVNリポジトリをチェックアウトする

開発バージョンをWordPress.orgプラグインリポジトリとは別にしておくことをお勧めします。はい、SVNはバージョン管理に使用されますが、WordPressはリリース管理により多く使用します。すべての変更セットをリポジトリにコミットし始めると、問題が発生する可能性があります。多くの開発者が行うことの1つは、Gitを使用してローカルで開発し、リリースの準備ができたらファイルをSubversionリポジトリに転送することです。

これらの手順は、Windowsコンピューターを使用していることを前提としています。Macを使用している場合は、TortoiseSVNの代わりにSCPluginを使用できます。実行する必要がある手順は同じですが、UIのため、コンテキストメニューとスクリーンショットのみが若干異なります。Macを持っていないので、スクリーンショットを作成してチュートリアルを説明することはできません。

TortoiseSVNをまだインストールしていない場合は、インストールしてください。

TortoiseSVNは、Windows用のオープンソースのSubversion GUIです。GUIを使用する方が、コマンドラインから実行するよりもはるかに簡単です。問題も少なくなります。

WordPressがホストするSVNリポジトリを確認する

WordPressでホストされているバージョンのプラグインを保存する場所を見つけます。デフォルトで/My Documents/WordPress/は、ホストされているすべての開発作業に使用します。フォルダ内を右クリックし、ドロップダウンメニューから[SVNチェックアウト]を選択します。

TortoiseSVNコンテキストメニュー

ポップアップ表示されるダイアログウィンドウで、WordPress.orgプラグインリポジトリのURL(デモ用に使用しているものの1つ)を入力し、作成するサブフォルダーを選択します。

チェックアウトダイアログ

Tortoiseは少し考えてから、WordPress.orgからリポジトリをプルダウンします。新しく作成されたフォルダには、必要なすべてのフォルダがすでに設定されています。これで、コピーアンドペーストしてコミットするだけです。一度に1ステップずつです。

最新バージョンをにコピーします /tags

ここで、ほとんどのチュートリアルから逆の処理を行います。他の誰もが/trunk最初にコミットするように言うでしょうが、WordPressは/trunkプラグインを見るときにreadmeファイルを除いて何も使用しないことを覚えておいてください。したがって/trunk、タグをコミットする前にプラグインを挿入してネットワーク接続を失う(または何かがうまくいかない)と、問題が発生します。

/tagsフォルダーに、プラグイン用にリリースするバージョンと同じ名前のフォルダーを作成します。したがって、バージョン0.1をリリースする場合は、/tags/0.1フォルダーを作成します。

リポジトリタグフォルダ

プラグイン全体をこのフォルダーにコピーします。

次に、フォルダ内を右クリックし、ドロップダウンメニューから[SVNコミット]を選択します。

すべての変更を示すウィンドウポップアップが表示されます(「バージョンなし」としてマークされたすべての新しいファイルが表示されます)。

コミットウィンドウ

プラグインのすべてのファイルの横にあるチェックボックスをオンにします(または、[すべて選択]をクリックしてすべてを選択します)。

上部のボックスにコミットメッセージを入力します。タグをコミットしているので、おそらく次のようなものを使用する必要があります。

[My Plugin]のバージョン0.1にタグを付けます。

OKをクリックします。

ここでも、Tortoiseは数分間考え、サーバーにコミットするためにWordPressのユーザー名とパスワードを要求します。それらを提供し、物事が完了するのを待って「成功」と言ってから、次のステップに進みます。

最新バージョンをにコピーします /trunk

次に/trunk、リポジトリのフォルダに移動し、プラグインをそのフォルダにもう一度コピーして貼り付けます。上記と同じ手順を実行してファイルを選択し、コミットを準備します。ただし、メッセージには、新しいリリースの機能を説明するものを使用します。

[My Plugin]のバージョン0.1-OpenIDのサポートを追加します。

すべてが完了したら、WordPress.orgのサーバーが追いつくのを少し待つ必要があります。一部の日は他の日より遅くなる場合がありますが、1時間以内にリポジトリに新しいリリースが表示されるはずです。

プラグインを新しいバージョンに更新する

プラグインが公開されると、更新の準備は比較的簡単です。

まず、SVN Updateコマンドを使用して、リポジトリの最新バージョンがあることを確認します。あなたが唯一の開発者であれば、すでにそうすべきですが、とにかくコミットする前に更新することは良い習慣です。

次に、上記のプロセスを実行し/tagsて、新しいバージョン用の新しいサブフォルダーを作成します。と言い/tags/0.2ます。古い/0.1フォルダには触れないでください。理由があるので、二度と触れないでしょう。

新しいタグをコミットし、/trunkフォルダーに移動します。すべてを/trunk新しいバージョンに置き換え、上記のようにコミットします。サーバーが更新されると、サーバーは古いバージョンではなく新しいバージョンについて話し始めます。


1
私はトランクからすべてを行うことを好みます。これにより、すべてのラインがどこから来たのかについての素晴らしい履歴を得ることができます。あなたのアプローチでは、すべてが最新バージョンで登場したように見えませんか?
Jan Fabry、

@EAMannの詳細な説明に感謝します。残念ながら、私はMacを使用しています。申し訳ありませんが、私の質問では、私の悪いことを述べるべき

1
@Janこれが、私の開発リポジトリとリリースリポジトリを分離する理由です。アクティブな開発にWP.orgリポジトリを使用するとき、私はものごとをひどく壊したので、完全なバージョン履歴のためにGitまたはHgのいずれかを使用してローカルで開発し、リリースをビルドするときにWP Svnリポジトリにコピーします。
EAMann

@Pietその場合、SCPlugin for Macを見てください。手順はまったく同じですが、スクリーンショットのみが異なります。同じ人がたくさん作っているので、まるで亀のように機能します。
EAMann

@EAMannありがとうございます。今すぐダウンロードしています。状況をお知らせします...
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.