Git Download Updater 拡張機能は、GitHub と BitBucket の両方をサポートしています。
BitBucket への接続
Easy Digital Downloads ウェブサイトを Bitbucket アカウントに接続するには、Bitbucket アカウント内にアプリを作成し、拡張機能の設定にアプリのパスワードと Bitbucket ユーザー名を追加する必要があります。
アプリのパスワードを作成するには、以下の手順に従ってください。
- 右上にある歯車のアイコンから、Personal Bitbucket Settings を選択します。
- Access management の下にある App passwords を選択します。
- Create app password を選択します。
- アプリのパスワードに、何のために使用されるかを思い出せるような名前を付けます。
- Permissions セクションで、次のチェックボックスをオンにします。
- Account > Email and Read
- Workspace Membership > Read
- Projects > Read
- Repositories > Read
- 生成されたパスワードを、一時的に安全な場所にコピーしてください。パスワードはこの一度しか表示されません。
上記の手順 5 で説明したすべての必要な権限の画像はこちらです。
アプリのパスワード（使用方法や取り消しを含む）の詳細については、Bitbucket の ドキュメント を参照してください。
新しいアプリのパスワードを入手したら、Downloads > Settings > Extensions > Git Updater ページに追加してください。
Username フィールドは、実際の Bitbucket ユーザー名です（アカウントのメールアドレスと混同しないでください）。このページで簡単に見つけることができます: https://bitbucket.org/account/settings/ の「Bitbucket profile settings」セクションの下にあります。
GitHub への接続
GitHub を使用するには、Downloads > Settings > Extensions > Git Updater に移動してください。そこに記載されている手順に従って GitHub に接続してください。
Git Updater を使用したダウンロードの設定
ダウンロードファイルのセットアップ
ウェブサイトを GitHub または Bitbucket のいずれかに接続したら、ダウンロード製品にファイルを追加できます。
1. ダウンロード編集画面の「Download Files」メタボックスに、「Fetch download from a git repository」というラベルのチェックボックスが表示されるようになります。
2. しばらくすると、リポジトリを選択できる新しいフィールドセットが表示されます。
3. リポジトリ名を検索し、使用したいタグを選択します。
注意: Git Updater で使用されるバージョンタグは、ネイティブの git タグである必要があります。readme ファイルからバージョンを解析するわけではありません。git のタグ機能の使用方法について詳しくは、このガイド を参照してください。
4. 「Fetch Now」をクリックします。ダウンロードが git リポジトリから正常にインポートされると、ボタンは「Fetched」と表示されます。
これで、必要に応じてファイル名やzipファイル名を編集できます。デフォルトのままにすることも可能です。zipファイルは準備完了です！
新しいバージョンをリリースする準備ができたら、使用したいタグを選択して「取得」をクリックします。取得が完了したら、製品を更新してください。
よくある質問とトラブルシューティング
zipファイルが生成される前に、ファイルをどのように除外または削除しますか？
Git Download Updaterは、Gitの「export」機能を使用して配信用のファイルを作成します。`.gitattributes`ファイルを使用して、エクスポート中に無視したいファイルを決定できます。EDD Coreでどのように使用しているかの例はこちら。
git属性を使用してファイルをエクスポートする方法の詳細については、このチュートリアルを参照してください。
無料版と有料版の間のアップデート競合
この問題を解決するには、2つの異なる方法があります。
- プロ版の名前と/またはスラッグを変更します。WordPressのアップデートAPIのニュアンスにより、WordPressはそれらを別個のプラグインとして区別できません。
- インスタンス化する際に、EDD_SL_PLugin_Updaterクラスの3番目のパラメータに「wp_override」を追加します。例：
// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
'version' => '1.0', // current version number
'license' => $license_key, // license key (used get_option above to retrieve from DB)
'item_id' => EDD_SAMPLE_ITEM_ID, // name of this plugin
'author' => 'Easy Digital Downloads', // author of this plugin,
'wp_override' => true
)
);注意：これにはプラグインアプデータークラスのv1.6.4が必要です。
