カルーセルコンポーネントを作成する（前編）
カスタムコンポーネントの練習としてよくあるカルーセルの作成、今回は XM Cloud のコンポーネントにする手続きを元に作ってみたいと思います。作業量はあまりありませんが、説明が長くなるので分けて紹介をします。今回は前編です。
Next.js
Next.jsは、Reactベースのフレームワークで、Reactを使用してサーバーサイドレンダリングと静的サイト生成を可能にする機能を提供します。
Nodemailer を利用して Next.js のプロジェクトからメールを送信する
前回は nodemailer を利用してメールを送信する仕組みを確認しました。今回は、Next.js のプロジェクトを作成して、React Email および Nodemailer が連携できるような形で実装を進めていきます。今回は、React Email のリソースを追加しておきますが、主に API を利用してメールを送信するサンプルまで仕上げます。なお、Moosend でも Sitecore Send でも同じコードで動作します。
Next.js OpenAI Starter を Azure OpenAI と連携させる
これまで ChatGPT との連携を前提として進めてきましたが、Next.js OpenAI Starter は Azure Open AI とも連携が可能です。今回は、ChatGPT の API キーではなく、Azure Open AI との連携する方法を検証していきます。
Next.js OpenAI Starter サンプルを Sitecore Search と連携する
前回の記事では、Json のデータで提供されている情報をチャットが対応できるように AI の持っているデータを拡張して動作させました。今回は、Sitecore Search が持っているデータを連携させて、対応させたいと思います。
Next.js OpenAI Starter をカスタマイズする
サンプルを起動して、続いて動作の確認をしていきました。今回は簡単なカスタマイズをしていきます。
Next.js OpenAI Starter の動作を確認する
前回の記事では、サンプルのコードをそのまま動かしてみました。このサンプルに含まれているコードを見ながら動作を確認していきたいと思います。
Next.js OpenAI Starter を動かす
ChatGPT と連携する Chatbot のサンプルである Next.js OpenAI Starter のテンプレートを動かすまでの手順を今回まとめておきます。
Playwright を利用したサムネイル取得 まとめ
これまで複数回に渡って Playright を利用してページのサムネイルを取得できるようにしました。今回は最後に、全体のまとめとして記載しておきます。
Next.js の API と Playwright のコンテナを連動させる（後編）
このシリーズとしては最終回です。スクリーンショットを撮るところまでできたので、ストレージと連携させていきます。今回は、Azure Blob Storage と連携する形に仕上げていきます。
Next.js の API と Playwright のコンテナを連動させる（中編）
Next.js の API として Web サイトのサムネイルを表示するための仕組みを実装していきます。今回は、取得した URL を利用して画像を表示するところまで進めていきます。
Next.js の API と Playwright のコンテナを連動させる（前編）
Playwright のコンテナを動かすところまで進めていきましたが、以前の Sitecore Search のサンプルサイトと連携するように、今回は API を追加します。
Next.js のプロジェクトに Search の Widget を追加する（後編）
前回は Sitecore Search のウィジットを追加することができるように、言語切替えのボックスのみ準備をしました。今回は、ウィジットを追加して検索結果を表示したいと思います。
Next.js のプロジェクトに Search の Widget を追加する（前編）
これまでブログでは Sitecore Search SDK を利用して検索結果を表示していました。今回から数回に分けて、Next.js のプレーンな環境に対して Widget を追加していく形で、実際のどういう形で動いているのかを紹介していきます。
ヘッダーとフッターを追加する
今回は Next.js のアプリに対してヘッダーとフッターを追加していきます。今回は特に外部との連携は入れていません。
NextUI の Dark モードを有効にする
Web サイトでライトモードとダークモードを切り替えることができるようになっています。私個人も、ダークモードを利用しています。今回はこれを NextUI で実装する手順を確認していきます。
NextUI を利用する
これまで動かしていたサンプルは、最低限のデザインも入っておらず、文字を表示する程度の動きでした。もう少し見た目をきれいにするべく、今回はプロジェクトで NextUI を利用できるようにしていきます。
Nextjs の App Route の Dynamic Route を利用してブログのページを作る（後編）
前回、ブログの個別のページに関して、Dynamic Route で ID を利用して作成する手順を紹介しました。今回はもう１つ改善して、URL のパスに日付と Slug を利用して処理できるように進めていきます。
Nextjs の App Route の Dynamic Route を利用してブログのページを作る（前編）
ブログの記事に関してそれぞれのページを用意したいと思います。前編では ID を利用して URL を作成する形で作っていきます。
ブログのデータ取得の分離
前回はブログのタイトルの取得を page.tsx ファイルで利用しましたが、ブログのデータを取得する部分をきちんと別ファイルに今回は分けます。
Next.js の Fetch を利用してコンテンツ一覧を取得する
Next.js には fetch の機能を利用して、外部のデータを取得して処理をするための仕組みが含まれています。今回はこれを利用して、Blog のタイトルを取得したいと思います。
Next.js に Google Tag Manager を設定する ( App Router 編 ）
前回作成をした Next.js の App Router のサンプルに対して Google Tag Manager を設定したいと思います。これを使うことで、アナリティクスもそうですが、Sitecore の他の製品との連携なども簡単にできる、というのがあります。
Next.js の App Router について
Next.js で利用しているルーティングの処理が、13.4 から新しい App Router に切り替わりました。従来の仕組みは Page Routing という形になり、従来の仕組みはもちろん利用できますが、新しい App Routing でアプリが今後主流になってきます。そこで、今回はこの App Router に関して確認をしていきます。
ローカルの Next.js のプロジェクトを XM Cloud に接続する
今回は手元にある Next.js のプロジェクトを直接 XM Cloud のインスタンスにつなげて動かす手順に関して紹介します。
Haramizu.com のサイトをリニューアルしました
しばらくサイトの更新をしていませんでしたが、コンテンツのボリュームも増えたり古い記事がそのままになっていたりと問題があったので、リニューアルをして見ました。
Sitecore 10.3 で Headless SXA を簡単に起動する
これまで数回に分けて Sitecore 10.3 のコンテナ環境、SXA の追加など手元で動かす方法を紹介してきました。毎回同じ手順を実施するのは大変なので、簡単に起動することができるリポジトリを作成しました。リポジトリを利用して起動する方法を今回は紹介します。
Next.js のプロジェクトを追加する
前回作成をしたヘッドレスのサイトはまだサイトコアのアイテムがあるだけとなっています。今回はこれに Next.js のプロジェクトを追加して、ページの編集ができるところまでの紹介をします。
ヘッドレスサイトを追加する
プロジェクトの作成、XM1 の環境整備、そして前回は SXA のモジュールのインストールをしました。今回はこのプロジェクトに対して、ヘッドレスのサイトを追加して、Next.js のプロジェクトと連携させていきます。手順が長くなるため、今回はヘッドレスのサイトを追加して、そのデータをいつでも再利用できるようにシリアライズができるところまで紹介をします。
SXA のモジュールを追加する
前回は XM1 のインスタンスを起動することができました。今回は、Next.js のプロジェクトを追加するにあたって必要となる Sitecore Experience Accelerator のモジュールをコンテナで利用できる様に追加の設定をしていきます。
新しいプロジェクトを作成する
新年あけましておめでとうございます。今年も Sitecore に関する技術的な情報をブログで提供していきたいと思います。実は Sitecore の技術情報は日本語で多く提供しているのですが、いざ始めるとなるとどこから手を付けていいのか悩ましいですよね。ということで、新年最初の投稿は、新しいプロジェクトをサクッと作るところを紹介します。
HTML のページを追加する
すでに Web サイトのコンテンツがあって、HTML のデータがあるという際に、Next.js をベースのサイトの場合はどうすれば良いでしょうか？実は Next.js の基本的な機能を利用すれば、HTML ファイルなどを一通りサーバーにホストすることが可能です。
Headless SXA - 新規コンポーネントの追加
前回は既存のコンポーネントの表示形式を増やすだけでしたが、今回は新しいコンポーネントを作成します。これにより、各企業で求めているデータ構造に対してのレイアウト作成という形で、Sitecore でデータ形式の定義をして、見た目の部分を実装するという部分のイメージが湧くかと思います。
Headless SXA - Variant の追加
前回は Headless SXA に関して簡単に紹介をしました。基本コンポーネントだけでは当然 Web サイトを作る上では色々なものが不足しています。今回は、既存のコンポーネントの表示形式を追加する方法を紹介します。
Headless SXA の紹介
Sitecore が提供する Web サイトのコンポーネント集となる Sitecore Experience Accelerator のヘッドレス版となる Headless SXA の提供を開始しました。このコンポーネントは Sitecore XM 10.3 でも利用できるようになっていますので、既存の Sitecore のサブスクリプションライセンスを利用の場合も同じように利用することが可能です。
Next.js に Google Tag Manager を設定する - XM Cloud 編
XM Cloud のサイトを外部に公開をしました。他のサービスと連携させるためにも、まずは Google Tag Manager を設定します。
Experience Edge を利用して Vercel に展開する
これまでサーバーとして Sitecore を仮想マシンとして起動していましたが、エンドポイントとして Sitecore Experience Edge というサービスを展開しており、これを利用することで Next.js のアプリを Vercel に簡単に展開することができます。今回はその展開手順に関して紹介をします。
Sitecore Headless 開発、テスト環境を起動する
これまで複数回に分けてプロジェクトを作成してきましたが、毎回同じことを実施するのは面倒です。そこで、これまでの手順を省略して環境を起動する手順を紹介します。
Sitecore Headless 開発、テスト環境の構築 Part 8 - プロジェクトの整理（ 設定の一元管理 ）
テスト環境の設定に関して、この項目を入力してください、などの記述をしていましたが実際に使うとなるともう少し自動化したほうが良い形になってきました。そこで最後に設定を .env ファイルに集約する形に書き換えていきます。
Sitecore Headless 開発、テスト環境の構築 Part 7 - プロジェクトの整理（ CD サーバーの削除 ）
すでにプロジェクトとしてはヘッドレスの検証環境を用意した形となりますが、今回と次回で不要な部分を削除、整理していきたいと思います。今回はヘッドレスで起動することになったので、CD サーバーの構成を削除したいと思います。
Sitecore Headless 開発、テスト環境の構築 Part 6 - エクスペリエンス エディターを利用できるようにする
前回は Node.js をベースとしたコンテナを立ち上げて、そのコンテナで Next.js を起動しました。Next.js は Sitecore からデータを取得してページを表示している形です。今回は、Sitecore が Node.js のコンテナに接続して、エクスペリエンスエディターが起動するところまで進めていきます。
Sitecore Headless 開発、テスト環境の構築 Part 5 - Node.js コンテナの追加
これまで紹介してきた内容は、 Sitecore をコンテナで起動、その後テンプレートを追加、サーバーでの動作というところまで進めてきました。サーバーの環境では、Vercel を利用してページの編集、確認ができるようにしましたが、ローカルのコンテナの環境では Vercel の部分が不足している形となります。そこで今回は、この部分を Node.js のコンテナを追加して同じように動作する設定を作成します。
エクスペリエンス エディターを利用できるようにする
前回は Vercel に新しいサイトを展開することができました。このインスタンスを利用して、エクスペリエンスエディターでページの編集をできるように進めていきます。
Vercel に展開する
これまで作成をしてきた Web サイトを Vercel に展開したいと思います。シリーズの最初の頃に立ち上げたサーバーに対してサンプルのデータを展開、合わせて Vercel に展開する手順を紹介していきます。
Next.js サンプルサイトの追加（後編）
前々回に Next.js のテンプレートの準備を、前回はそれを利用するための Sitecore にアイテムをインポートする手順を紹介しました。今回は Next.js の設定を変更して、Sitecore のアイテムを参照してページが表示されるところまで紹介をします。
Next.js サンプルサイトの追加（前編）
４回に分けて作成をしてきた環境にはまだ Next.js のプロジェクトがないため、サンプルサイトを追加していきます。プロジェクトにコードを追加する形です。この手順は２回に分けて紹介をしていく予定です。今回は、まず Next.js のサンプルが動くところまで進めていきます。
Sitecore Helix の Next.js サンプルを動かす - コンテナを起動する
前回は環境を準備するところまでとして、コンテナを起動することはありませんでした。今回は、サンプルを実行するためのスクリプト up.ps1 を参考にしながらどういう形でコンテナを起動することになるのかを確認していきます。
Sitecore Helix の Next.js サンプルを動かす - 準備
Sitecore が提供しているデモ Sitecore Helix に、Next.js をベースにしたサンプルが含まれています。今回は、このサンプルを動かすところまでの手順を紹介していきます。なお、今回は設定までとして、実際にコンテナを起動するのは次回紹介する予定です。
Sitecore Headless - Next.js Tips シリーズ
Next.js の SDK を利用して Sitecore をヘッドレス CMS で開発をする際の各種ヒントを個別のトピックとして紹介しています。ここでは一覧で表示していますので参考にしてください。
ルートアイテムの作成
これまで Next.js ベースのサンプルとして作成していたアイテムは JSS のサンプルをインポートした時のルートアイテムをベースに作成をしていました。今回はルートアイテムに相当するものを作成する手順を紹介して行きます。
コンポーネントの作成とテンプレート連携 - ファイル編
コンポーネント作成シリーズの最後として、ファイルを指定することができるファイルコンポーネントを作成します。ファイル自体はメディアライブラリにあるファイルを指定する形となりますが、データとしてどういう形で取得することができるのか、というのを確認するのが主な目的です。
コンポーネントの作成とテンプレート連携 - コンテンツリスト編
今回はコンテンツリストを利用したコンポーネントを作成していきます。コンテンツリストは、Sitecore のアイテムを複数指定して、それらのデータを一括で利用したいというケースで使い勝手の良いものです。よくあるケースとしては、Meta タグで利用するキーワードを選択できるようにする、といったニーズにも使えます。
コンポーネントの作成とテンプレート連携 - チェックボックス編
これまで紹介をしていたデータの形式は一般的なデータとして利用することが多い項目でしたが、今回はチェックボックスを紹介する地味なトピックとなります。
コンポーネントの作成とテンプレート連携 - リンクフィールド編
Web サイトのデータとして重要になってくるのがコンテンツの次にリンクになります。この部分の記述をコンポーネントではどう言った形で記述するのかを今回は紹介していきます。
コンポーネントの作成とテンプレート連携 - 日付と数字編
日付、数字に関してはテキストのフィールドを利用して管理することもできますが、Sitecore のフィールドとしては日付、時間、数字を設定することが可能です。今回はこれらの項目を利用してコンテンツを構成できるように、フィールドの使い方を紹介していきます。
コンポーネントの作成とテンプレート連携 - 画像編
前回はテキストに関するフィールド形式を利用して、テンプレートを作成しました。今回は画像を指定できるコンポーネントを作成していきます。
コンポーネントの作成とテンプレート連携 - テキスト編
Sitecore のコンテンツ管理の仕組みとしては、コンテンツのデータ構造を定義する仕組みとしてテンプレートという仕組みを提供しています。今回はデータの持ち方を定義して、どのように呼び出しをするのかについてテンプレートを作成、データの表示について紹介をしていきます。なお、このサンプルコードは Styleguide のサンプルデータとして含まれているものを紹介していく形となります。
コンポーネントの作成
Sitecore と連携している環境の準備ができていれば、コンポーネントの追加に関しての手順は非常に簡単なものです。今回は、jss scaffold のコマンドを利用することなく、コンポーネントを追加することで、どういう形でコンポーネントを管理しているのか、を確認します。
多言語サイトのコンテンツに切り替える
Next.js のテンプレートはすでに多言語対応のモジュールが入っているため、Sitecore 側の設定を追加することで比較的簡単に言語を増やすことができます。そこで今回は、日本語のリソースを追加したいと思います。
Sitecore Horizon のインストール
これまで Sitecore の編集環境としてはコンテンツエディター、エクスペリエンスエディターと２つのツールを利用していました。全体を見渡すことができるコンテンツエディター、見たまま編集を実現するエクスペリエンスエディターという位置付けです。今回紹介をする Sitecore Horizon はその２つのいいところ取りの製品になります。
Hero エリアの部品を作成する（後編）
前回は新しいコンポーネントを作成して配置しましたが、まだ見た目は普通に HTML が表示されている程度の Tailwind CSS のデザインになっています。今回は見た目を少し変更するのと、合わせてコンテンツの属性を少し変更したいと思います。
Hero エリアの部品を作成する（前編）
前回の記事でヘッダー、フッターのエリアを整理しました。今回はトップページで利用する Hero エリアのコンポーネントを新規に作成していきます。この手順を通じて、新しいコンポーネントの作り方を学んでいきます。
ナビゲーションを分離する
前回は Tailwind CSS を利用できるところまで実施しました。今回はこれを利用する前に、レイアウトの中に記載されているナビゲーションのコードを別のファイルに分離する手順を確認していきます。
Tailwind.css を Next.js のサンプルに適用する
Next.js のサンプルは CSS のスタイルシートとして bootstrap が標準で設定されています。CSS のスタイルシートはさまざまなものが提供されていますが、今回は Tailwind CSS を利用する形に切り替えていきます。
Next.js に Google Tag Manager を設定する
今回は少し趣向を変えて Sitecore ではなく Next.js で Google Tag Manager を適用するための手順を紹介します。テストも含めて、実施していきます。
Sitecore Headless - Next.js ステージングの追加
前回の記事で、Next.js のサンプルを Sitecore に展開、また実際のデリバリーとして Vercel と連携する形まで用意をしました。今回は、もう少しテスト、検証をしやすくするためにプロダクションとステージング環境を分けて、ローカルでもテストする手順を紹介をしていきます。
Sitecore Headless - Next.js 評価環境の構築
ブログでこれまでヘッドレスに関しての情報を提供していました。手順に関してはリンクを貼りながら紹介していきつつ、テスト環境を素早く立ち上げる手順について今回は紹介をします。
Next.js のサンプルデータが含まれないプロジェクトの作成
サイトコアの新しいバージョンとなる 10.2 のリリースに合わせて Sitecore Headless Services のバージョンも 19.0.0 に変わりました。この際、Next.js のサンプルデータが入っていないプロジェクトの作成の手順が追加されました。毎回最初のステップでデータを削除するところを省略できるので、今回はこれについて紹介をします。
Sitecore ヘッドレス と Next.js でサイト構築 - コンポーネントの追加
Sitecore JSS で開発をしていくときに、コンポーネントを追加するためのコマンド jss scaffold が用意されています。今回はこれを元に、１つコンポーネントを作成していきます。
Sitecore ヘッドレス と Next.js でサイト構築 - 空プロジェクトの作成
前回は Sitecore のインスタンスの設定および Vercel での動作まで進めました。今回は立ち上げたサンプルのサイトに関して、すでに入っているコンテンツの整理、またそれを表示するために定義されている内容などを削除して、空っぽのプロジェクトまで仕上げていきます。