1.1.3 基本的なカスタムブロックの作成

1.1.3.1ローカル開発環境のセットアップ

https://desktop.github.com/download/ に移動し、Github デスクトップ をダウンロードしてインストールします。

ブロック

Github デスクトップがインストールされたら、前の演習で作成した GitHub リポジトリに移動します。 「<> コード」をクリックしてからGitHub デスクトップで開く」をクリックします。

ブロック

GitHub リポジトリは、GitHub デスクトップで開かれます。 ローカルパス を自由に変更できます。 クローン をクリックします。

ブロック

これで、ローカルフォルダーが作成されます。

ブロック

Visual Studio Code を開きます。 File/Open Folder に移動します。

ブロック

GitHub の設定で使用されるフォルダーを選択します citisignal-aem-accs

ブロック

Visual Studio Code でそのフォルダーが開いていることが確認できます。新しいブロックを作成する準備が整いました。

ブロック

1.1.3.2 基本カスタムブロックの作成

Adobeでは、次の 3 つの段階アプローチでブロックを開発することをお勧めします。

  • ブロックの定義とモデルを作成し、レビューして、実稼動環境に取り込みます。
  • 新しいブロックでコンテンツを作成します。
  • 新しいブロックの装飾とスタイルを実装します。

component-definition.json

Visual Studio Code で、ファイル component-definition.json を開きます。

ブロック

ブロック が表示されるまで下にスクロールします。 カーソルをコンポーネントの閉じブラケットの下に置きます カード

ブロック

このコードを貼り付け、コードのブロックの後にコンマ , を入力します。

{
  "title": "FiberOffer",
  "id": "fiberoffer",
  "plugins": {
    "xwalk": {
      "page": {
        "resourceType": "core/franklin/components/block/v1/block",
        "template": {
          "name": "FiberOffer",
          "model": "fiberoffer",
          "offerText": "<p>Fiber will soon be available in your region!</p>",
          "offerCallToAction": "Get your offer now!",
          "offerImage": ""
        }
      }
    }
  }
}

変更を保存します。

ブロック

component-models.json

Visual Studio Code で、ファイル component-models.json を開きます。

ブロック

最後の項目が表示されるまで下にスクロールします。 最後のコンポーネントの閉じブラケットの隣にカーソルを置きます。

ブロック

コンマ , を入力し、enter キーを押して、次の行に次のコードをペーストします。

{
  "id": "fiberoffer",
  "fields": [
     {
       "component": "richtext",
       "name": "offerText",
       "value": "",
       "label": "Offer Text",
       "valueType": "string"
     },
     {
       "component": "richtext",
       "valueType": "string",
       "name": "offerCallToAction",
       "label": "Offer CTA",
       "value": ""
     },
     {
       "component": "reference",
       "valueType": "string",
       "name": "offerImage",
       "label": "Offer Image",
        "multi": false
     }
   ]
}

変更を保存します。

ブロック

component-filters.json

Visual Studio Code で、ファイル component-filters.json を開きます。

ブロック

セクション の下で、コンマ , を入力し、現在の最後の行の後にコンポーネント "fiberoffer" の ID を貼り付けます。

変更を保存します。

ブロック

1.1.3.3 変更をコミットします

これで、プロジェクトで、GitHub リポジトリにコミットして戻す必要のある変更をいくつか加えました。 それには、GitHub デスクトップ を開きます。

編集した 3 つのファイルが「変更 の下に表示され す。 変更をレビューします。

ブロック

PR、Fiber Offer custom block の名前を入力します。 「メインにコミット」をクリックします。

ブロック

この画像が表示されます。 接触チャネルをプッシュ をクリックします。

ブロック

数秒後に、変更が GitHub リポジトリにプッシュされます。

ブロック

ブラウザーで、GitHub アカウントと、CitiSignal 用に作成したリポジトリに移動します。 変更を受け取ったことを示す、次のようなメッセージが表示されます。

ブロック

1.1.3.4 ページにブロックを追加

基本的な引用ブロックが定義され、CitiSignal プロジェクトにコミットされたので、既存のページに fiberoffer ブロックを追加できます。

https://my.cloudmanager.adobe.com に移動します。 プログラム をクリックして開きます。

AEMCS

次に、「環境」タブの 3 つのドット をクリックし、「詳細を表示」をクリックします。

AEMCS

その後、環境の詳細が表示されます。 オーサー 環境の URL をクリックします。

NOTE
環境が休止状態になっている可能性があります。 その場合は、まず環境の休止状態を解除する必要があります。

AEMCS

AEM オーサー環境が表示されます。 サイト に移動します。

AEMCS

CitiSignal に移動します。 作成 をクリックし、「ページ」を選択します。

AEMCS

ページ を選択し、「次へ」をクリックします。

AEMCS

次の値を入力します。

  • タイトル:Fiber
  • 名前:fiber
  • ページタイトル:ファイバ

作成」をクリックします。

AEMCS

開く を選択します。

AEMCS

この画像が表示されます。

AEMCS

空白領域をクリックして、「セクション」コンポーネントを選択します。 次に、右側のメニューのプラス + アイコンをクリックします。

AEMCS

カスタムブロックが、使用可能なブロックのリストに表示されます。 クリックして選択します。

AEMCS

オファーテキストオファーCTAオファー画像 などのフィールドがエディターに追加されます。 オファー画像 フィールドの「+追加 をクリックして、画像を選択します。

AEMCS

この画像が表示されます。 クリックしてフォルダー citisignal を開きます。

AEMCS

画像 product-enrichment-1.png を選択します。 「選択」をクリックします。

AEMCS

これで完了です。 「公開」をクリックします。

AEMCS

もう一度 公開 をクリックします。

AEMCS

これで、新しいページが公開されました。

1.1.3.5 ナビゲーション メニューに新しいページを追加する

AEM Sitesの概要で CitiSignal に移動し、「Header/nav ファイルのチェックボックスをオンに ます。 「編集」をクリックします。

AEMCS

プレビュー画面で テキスト フィールドを選択し、画面の右側にある テキスト フィールドをクリックして編集します。

AEMCS

テキスト Fiber を使用して、ナビゲーションメニューにメニューオプションを追加します。 テキスト Fibre を選択し、「リンク」アイコンをクリックします。

AEMCS

URL /content/CitiSignal/fiber.html に対してこれを入力し、V アイコンをクリックして確認します。

AEMCS

これで完了です。 「完了」をクリックします。

AEMCS

これで完了です。 「公開」をクリックします。

AEMCS

もう一度 公開 をクリックします。

AEMCS

XXX を GitHub ユーザーアカウント(この例では main--citisignal--XXX.aem.page/us/en/)に置き換えた後、main--citisignal--XXX.aem.live/us/en/woutervangeluwe に移動して、web サイトの変更を表示できるようになりました。

この例では、完全な URL は次のようになります。
https://main--citisignal--woutervangeluwe.aem.page/us/en/https://main--citisignal--woutervangeluwe.aem.live/us/en/

この画像が表示されます。 ファイバ をクリックします。

AEMCS

これが基本的なカスタムブロックですが、web サイトにレンダリングされています。

AEMCS

次の手順:​ 詳細カスタムブロック ​

Adobe Experience Manager Cloud ServiceとEdge Delivery Services に戻る

​ すべてのモジュールに戻る ​

recommendation-more-help
4bbf020c-24db-4a43-b239-88fab142f02d