「開発者ポータル」 ページに表示されるブロックの追加および変更
新規ブロックを追加したり、 「開発者ポータル」 ページに表示される既存のブロックを変更したりすることができます。
開始前に
このタスクを実行するには、開発者ポータルに対する管理者権限が必要です。
注： このモジュールは、Developer Portal サイト UI でコンシューマによって作成されたアプリケーションの資格情報を同期します。 API Manager UI でプロバイダが作成したアプリケーションの認証情報を同期することはできません。
このタスクについて
ブロックとは、ページ上のある領域 (エリア) にレンダリングされるコンテンツのボックスのことです。 有効なコンテンツは、カスタム HTML、Github Markdown、またはプレーン・テキストです。ブロックの外観、サイズ、位置を指定でき、さらにブロックの可視性設定を編集することにより、どのページにブロックを表示するかを構成することもできます。 また、既存のブロックを編集して、ブロックの外観、サイズ、位置、可視性を変更することもできます。
手順
新しい基本ブロックを追加するには、以下の手順を実行します。
- 管理者ダッシュボードが表示されない場合は、 「管理」 をクリックして表示します。
- 「構造」をクリックしてから、 「ブロック・レイアウト」をクリックします。システム内のすべてのブロックがテーマ別に表示されます。 「ブロック・レイアウト」ページで、ブロックをある領域に割り当て、その領域内でのブロックの順序を制御できます。 ブロックは、各テーマに基づいて配置されるため、サイト上で複数のテーマを有効にすると、テーマごとに異なるブロックの配置できます。
- をクリックします。「カスタムブロックを追加」ページが表示されます。
- 「ブロックの説明」 フィールドに入力します。
- ブロックに必要なコンテンツを 「本文」 セクションに入力します。テキスト形式は、「フル HTML」、「基本的な HTML」、「制限付き HTML」、または「Github Markdown (Github Markdown)」に設定できます。 「本文」セクションの編集アイコンを使用して、コンテンツを構成できます。 ソースアイコン
をクリックして、HTMLなどのコードソースを入力します。
- 「保存」をクリックします。 新しいカスタム・ブロックが保存され、「ブロックの構成」ページが表示されます。
- ブロックの 「タイトル」 フィールドに入力します。
- 「可視性」 セクションで、ブロックの表示方法を指定します。コンテンツ・タイプを指定したり、言語設定を構成したり、ブロックが表示されるページを特定のコンテンツ・タイプが表示されるページのみに制限したりできます。また、ブロックを表示するページを設定したり、ブロックを表示できるユーザー・ロールを制限したりすることもできます。
- 「領域」 セクションで、ブロックを表示する領域を選択します。
- 「ブロックの保存」をクリックします。新しいカスタム・ブロックが 開発者ポータル ・サイトに追加されます。
既存のブロックのコンテンツを編集するには、「ブロック・レイアウト」ページで以下の手順を実行します。
- カスタムブロックライブラリタブをクリックします（または、管理ダッシュボードから を選択します）。
- 必要なブロックの横にある 「編集」 をクリックします。
- 必要に応じて、ブロックの説明と本文の内容を変更します。
- 変更内容を保存するには、 「保存」 をクリックします。
既存のブロックのレイアウトまたは可視性の設定を変更するには、「ブロック・レイアウト」ページで以下の手順を実行します。
- ブロックが配置されている領域を変更するには、必要なブロックの横にあるドロップダウン・リストから必要な 「領域」 を選択します。
- 領域内におけるブロックの縦方向のソート順を変更するには、ブロックを目的の位置にドラッグします。
- 既存のブロックの可視性の設定を編集するには、必要なブロックの横にある 「操作」 ドロップダウン・メニューから 「構成」 をクリックします。
- 既存のブロックを有効または無効にするには、必要なブロックの横にある 「操作」 ドロップダウン・メニューから 「有効化」 または 「無効化」 を選択します。
- 変更内容を保存するには、 「ブロックの保存」 をクリックします。