フォーム機能実装に半日かかった

(最終更新: )

フォーム機能実装に半日かかった

こんにちは。新人エンジニアの岡山です。 本日も「今日やったこと・詰まったこと・学びになったこと」などを書いていきます。よろしくお願いします。

microCMSのWebhookをGitHub Actionsで追加

microCMSの更新をきっかけにGitHub Actionsを動かすため、Webhook機能を追加しました。手順は次の通りです。

  1. GitHubの「Settings」>「Developer settings」>「Personal access tokens」からトークンを生成する
  2. リポジトリの .github/workflows/ 配下にYAMLファイルを作成し、repository_dispatch で任意のイベント名をつけて、トリガーを受け取れるように設定する
  3. microCMSの対象APIで「API設定」>「Webhook」>「追加」をクリックし、サービスの中から「GitHub Actions」を選択して、次の項目を入力して保存する
    • GitHubトークン: 作成したアクセストークン
    • リポジトリのユーザー名(または組織名)
    • リポジトリ名
    • トリガーイベント名(event_type): YAMLファイルで付けたイベント名(例: update など)
    • 通知を送るタイミング

初めて設定しましたが、手順どおりに進めれば比較的簡単に設定できました。

SSGフォームでお問い合わせフォームを追加、これが大変でした

今回のAstroの案件では、フォーム機能の追加にSSGフォームを使いました。こちらは時間がかかりました。手順は次の通りです。

  1. スパム防止のため、CAPTCHAサービス(今回はTurnstile)でウィジェットを作成し、サイトキーとシークレットキーを取得する
  2. SSGフォームで、フォーム名や送信を受け取るメールアドレスを設定し、CAPTCHAサービスのシークレットキーの値を入力してフォームを作成する
  3. envファイルに、SSGフォームの送信先URLとCAPTCHAサービスのシークレットキーを記述する
  4. ReactやTypeScriptで、お問い合わせの送信処理を記述する
  5. 送信が届くかテストする

詰まったポイント

一つ目は、Turnstileでウィジェットを作成する際に、今回のプロジェクトのドメインを入力するのに、1時間ほどかかったことです。
Turnstileはドメインを入力して検索してヒットしたものをホスト名として登録できるのですが、ドメインの方式を一スペルでも間違えると検索に引っ掛からず、沼にハマりました。
reCAPTCHAと違ってTurnstileを扱っている記事が少なく参考にしづらかったので余計に時間がかかりました。

二つ目は、ReactやTypeScriptでの送信処理です。先日のプレビュー機能のときと同じく、今回もここに時間がかかりました。

おわりに

Webhookのように手順どおりに進めればできるものと、スクリプトを自分で書く必要があるものとで、かかる時間にはっきり差が出た一日でした。

Murataから一言

めちゃめちゃ調べながら自力でやってて偉い!!!でもやっぱり1人で考えると沼ってしまうのは私も同じ、、!デザイナーも1人で沼ってしまう状況が課題としてあって、チームでどう動くかを試行錯誤しているところなので、及川パイセンとエンジニア連携しながら頑張ってね!!