私たちは数週間後にMatomo 5の最初のベータ版をリリースする予定です。Matomoユーザーがこのベータ版に簡単にアップグレードできるようにするためには、マーケットプレイスでできるだけ多くのプラグインがあらかじめアップデートされ、Matomo 5と互換性があることが望ましいです。これで、多くのユーザーが問題なく最初のベータ版にアップグレードできるようになります。

おそらく、プラグインをマーケットプレイスに掲載するとき、ユーザーに使ってもらいたいはずです。プラグインを Matomo 5 と互換性を持たせることは、利用者があなたのプラグインを見つけ、使い続けることができるようにすることにつながります。プラグインが Matomo 5 と互換性がない場合、あなたのプラグインは Matomo 5 のインスタンスで自動的に無効化されます。問題がある場合は、互換性を達成するためのお手伝いをさせていただきます。

MatomoインスタンスをMatomo 5にアップグレードするには

gitでMatomoの開発環境をインストールしているなら、以下のコマンドを実行することで、Matomo 5のブランチ「5.x-dev」をチェックアウトし、その依存関係をインストールするだけです：

• git checkout 5.x-dev
• composer install

また、GitHubから最新版をZIPファイルで直接ダウンロードし、その後にcomposer installを実行することができます。

プラグインをMatomo 5にアップグレードするには

• Matomo 5をサポートするプラグインの新しいブランチを作成することをお勧めします。例えば、”5.x-dev “という名前のブランチを作成します。これで、Matomo 4とMatomo 5用にプラグインを変更し、別々のバージョンをリリースすることができるようになります。
• Matomo 4からMatomo 5への移行ガイドをチェックし、すべての変更点のリストを確認するようにしてください。
• 通常通り、プラグインの新バージョンを GitHub でリリースしてください。

Matomo 5ではいくつかの変更点がありますが、ほとんどのプラットフォームAPIは変更されておらず、変更点の多くは使われていないAPIです。プラグインを Matomo 5 に対応させるには、（移行ガイドにあるように）「plugin.json」ファイルを調整するだけでよいことがほとんどです。

開発者向けドキュメントは、すでにMatomo 5用にアップデートされたディベロッパーゾーンでご覧いただけます。

プラグインの変更が正常にリリースされたことを知るには

「plugin.json」ファイルにメールアドレスを設定している場合は、数分以内に確認メールまたはエラーメールが届きます。また、マーケットプレイスのプラグインページで直接確認することもできます。プラグインのリリースが成功した場合、ダウンロードボタンの下に、プラグインがどのバージョンと互換性があるのかを示す追加リンクが表示されます。

Matomo 4とMatomo 5の切り替え、またはMatomo 4へのダウングレードはどうすればよいでしょうか？

Matomoの開発環境において、Matomo 5からMatomo 4にダウングレードする場合：

• 4.x-dev ブランチをチェックアウトする
• 通常通り “composer install “を実行する

Matomo 5の最終リリースはいつ？

Matomo 5.0.0の最終的な安定版リリースは、約2〜3ヶ月後と推定しています。

Matomo 5では何が新しくなったのですか？

まだ変更点の要約はありませんが、このリリースでクローズされた問題はすべてここで見ることができます。

ご質問やお困りのことはございませんか？

ご質問がある場合、または移行中に問題が発生した場合は、遠慮なく私たちにご連絡ください。プラグインを互換性のあるものにし、アップデートを公開するためのお手伝いをさせていただきます。もし、文書化されていない変更点を見つけたり、移行プロセスで不明な点を見つけたりした場合は、私たちにもお知らせください。

マーケットプレイスにプラグインを投稿していただき、Matomoをより良くしていただきありがとうございます。あなたの仕事に心より感謝しています！