カスタマー ポータルに変更をステージングしようとすると発生する「ウィジェット <custom/widget> は現在のフレームワーク バージョンではサポートされていません」というエラーを解決するにはどうすればよいですか？

環境:

カスタマポータル・フレームワーク・バージョン 3.1 またはそれ以降

問題:

ステージング中に、1 つ以上のページで使用されているカスタム ウィジェットが「現在のフレームワーク バージョンではサポートされていない」ことを示すエラーが発生します。 たとえば、 answers/details ページで使用されるカスタム ウィジェットでは次のようなエラーが発生する可能性があります:

04/10/2015 01:59 PM Error - page: '/answers/detail.php' The widget <custom/widget> is not supported on the current framework version: 3.2. It is valid for the following framework versions: 3.0

解決策:

カスタム ウィジェットの情報ファイル「info.yml」の「requires」の下にある「framework」プロパティを削除するか、同じプロパティを更新して、現在のカスタマー ポータル フレームワーク バージョンに設定します。

重要: 上記で概説した変更を行うことで、変更を正常にステージングできるようになりますが、新しいフレームワークで完全に機能させるには追加の変更が必要になる可能性があるため、新しいフレームワーク バージョンに移行した後、すべてのカスタム ウィジェットを徹底的にテストすることをお勧めします。

原因:

通常、このエラーは、ウィジェットの情報ファイル（「info.yml」）に指定されている特定のフレームワーク バージョンが現在のカスタマー ポータル フレームワーク バージョンと一致しない場合に、カスタム ウィジェットで発生します。 これは、新しいフレームワーク バージョンに移行した直後にカスタマー ポータルをステージングしようとしたときに最もよく見られます。