開発者は、Easy Digital Downloads (EDD) 用の独自の拡張機能を自由に構築し、他のストアオーナーと共有できます。簡単なガイドラインに従うことで、拡張機能を簡単に見つけ、公式機能と明確に区別し、EDD管理の他の部分と一貫させることができます。
このガイドでは、拡張機能の名前付け、EDDブランドの使用、設定の配置方法について説明します。
注意: このガイドの設定フックは、Easy Digital Downloads自体の一部です。無料プラグインでパスなしでそれらを構築できます。このガイドは開発者向けです。ストアに追加する機能を探している場合は、ダウンロード » 拡張機能メニューにある公式のものから始めてください。
開始する前に、開発中のWordPressサイトにEasy Digital Downloadsがインストールされ、有効化されていることを確認してください。
拡張機能の名前付け
明確な名前は、拡張機能がEDDで動作すること、そしてそれが私たちからではなくあなたから提供されたものであることをストアオーナーにすぐに伝えます。
サードパーティ拡張機能には、「Easy Digital Downloads用拡張機能名」の形式で名前を付けます。多くのプラグインエコシステムがこの同じパターンを使用しているため、ストアオーナーはすでにそれを認識しています。
「Easy Digital Downloads – 拡張機能名」は使用しないでください。この形式は公式拡張機能のために予約されており、それを使用すると拡張機能が私たちのもののように見えます。
Easy Digital Downloadsブランドの使用
拡張機能のページ、リスト、またはスクリーンショットでEasy Digital Downloadsに言及している場合は、公式ロゴと色を使用してください。それらは、ブランドガイドラインとともに、プレス＆ブランドアセットページで見つけることができます。
そのページでは、名前の書き方もカバーしています。Easy Digital Downloadsは常に3つの単語で、E、D、Dが大文字です。EDDに短縮しても問題ありません。
WordPress.orgプラグインガイドラインの遵守
すべてのプラグインは、公式のWordPress.orgプラグインガイドラインに従う必要があります。EDD拡張機能の場合、最も重要なのはガイドライン17：プラグインは商標、著作権、およびプロジェクト名を尊重しなければならないです。
このガイドラインでは、あなたがその製品を所有または代表していない限り、プラグインのスラッグが他の製品の名前で始まることは許可されていません。your-extension-for-easy-digital-downloadsのようなスラッグはルールに従っており、上記の命名形式に一致します。
拡張機能タブへの設定の追加
ストアオーナーは、拡張機能の設定を1か所で見つけることを期待しています。個別のメニューや設定ページを追加するのではなく、ダウンロード » 設定 » 拡張機能の下にある独自のセクションにEDD固有の設定を配置してください。
設定を登録する各拡張機能は、拡張機能タブの上部にある独自のリンクを取得します。この例では、2つの拡張機能が、ディスカウントプロとドロップボックスと呼ばれる独自のセクションを追加しています。
拡張機能タブは、少なくとも1つの拡張機能が設定を登録すると表示されます。ストアに拡張機能がない場合、タブはまったく表示されません。
バージョン3.7以降、EDDはイベントサブスクライバークラスを通じて独自のフックを登録しており、拡張機能も同様に行うことができます。設定クラスは2つのフィルターをサブスクライブします。
edd_settings_sections_extensions：拡張機能タブにセクションリンクを追加します。一意のキーとストアオーナーが表示するラベルを使用して、配列にエントリを追加します。edd_settings_extensions：タブに設定を追加します。セクションに使用したのと同じキーの下にネストされた設定を返すため、EDDはそれらをセクションに配置します。
サードパーティ拡張機能は、EDD固有の設定を[ダウンロード]→[設定]→[拡張機能]→[あなたの拡張機能名]の下に配置する必要があります。サブセクションと設定の登録方法の例については、このGistを参照してください。
EDDはこれらの設定を他のオプションと共に保存します。コードで値を取得するには、edd_get_option( 'myext_enable_feature' )を使用します。
各設定には、id、name、およびtypeが必要です。一般的なタイプには、checkbox_toggle、text、textarea、select、rich_editor、およびheaderが含まれます。stdを使用してデフォルト値を設定することもできます。
両方のファイルをコピーするには、GitHubのサンプルGistを参照してください。
これで、Easy Digital Downloadsに適合するように拡張機能を名前付け、ブランド化、およびセットアップする方法がわかりました。EDDの構築の詳細については、Easy Digital Downloadsの開発者向け入門を参照してください。
EDD拡張機能開発に関するFAQ
以下に、EDDのサードパーティ拡張機能の構築に関する最も一般的な質問のいくつかに回答します。
拡張機能を構築するためにパスが必要ですか？
いいえ。このガイドの「設定」タブとフックは、無料のEasy Digital Downloadsプラグインの一部です。
設定に拡張機能タブが表示されないのはなぜですか？
タブは、拡張機能が少なくとも1つの設定を登録すると表示されます。コードがセクションとその設定を追加すると、拡張機能タブがダウンロード » 設定の下に表示されます。
EDDチームは私の拡張機能をサポートしますか？
いいえ。サードパーティの拡張機能は、それらを構築した開発者によってサポートされます。顧客があなたに連絡してサポートを受けるための明確な方法が必要です。
拡張機能の名前をEasy Digital Downloadsで始めることはできますか？
しないでください。「Easy Digital Downloads」で始まる名前は、公式拡張機能のために予約されています。WordPress.orgは、プラグインのスラッグが他の製品の名前で始まることも許可していません。代わりに、「Easy Digital Downloadsの拡張機能名」形式を使用してください。
