開発記録 #5:CheerDrop 統合とドッグフーディング
GoldFeather 開発記録 #5:CheerDrop 統合とドッグフーディング — 読者の声を直接受け取る仕組み
こんにちは、GoldFeather 開発チームです。
「読者の皆さんはこの記事をどう感じたのだろう?」「もっと詳しく知りたい内容はどこだろう?」
ブログを運営していると、数字(PV)だけでは見えない「読者の温度感」が気になるものです。前回の開発記録 #4では SEO とパフォーマンスを極限まで高めましたが、今回は読者との双方向のコミュニケーションを強化するための施策についてご紹介します。
具体的には、外部のリアクション・アンケートウィジェットである「CheerDrop」を GoldFeather に統合し、あわせて私たちが大切にしている「ドッグフーディング」の姿勢についてもお話しします。
CheerDrop とは?
CheerDrop は、Web サイトに数行のコードを追加するだけで、「いいね」や「拍手」などのリアクション、そして「この記事は役に立ちましたか?」といった簡易アンケートを設置できるサービスです。
GoldFeather のような技術ブログや個人メディアにおいて、コメントを書くほどではないけれど、ちょっとした応援やフィードバックを伝えたい読者のための「受け皿」として最適だと考え、導入を決めました。
開発の舞台裏:Astro への統合で直面した課題
今回の実装では、Astro (Vite) 特有の挙動と、モダンな Web セキュリティ(CORS)という 2 つのハードルがありました。
1. Astro / Vite の「バンドル」との戦い
Astro はデフォルトで <script> タグのコードを最適化・バンドルしようとします。しかし、外部サービスから提供されるウィジェットのように、特定の公開パスに置いたスクリプトをそのまま読み込ませたい場合、この最適化が裏目に出ることがあります。
実際、初期の実装ではビルド時に以下のようなエラーに遭遇しました。
references an asset in the "public/" directory. Please add the "is:inline" directive...
これを解決したのが、Astro の is:inline 指令です。
<!-- Layout.astro -->
<script is:inline src="/assets/widget.js"></script>
この一行を追加することで、Astro の処理を通さず「そのまま」ブラウザに配信させることができ、正常にウィジェットが起動するようになりました。
2. CORS と「Credentials」の罠
もう一つの課題は、ブラウザのコンソールに現れた赤い文字。CORS エラーです。
CheerDrop のウィジェットは、ユーザーごとの状態を保持するために認証情報(Credentials)を含めて API を叩きます。この際、サーバー側(Cloudflare Workers)が Access-Control-Allow-Origin: *(ワイルドカード)を返していると、ブラウザのセキュリティ制限によって遮断されてしまいます。
これは「認証情報が必要なリクエストの場合、許可するオリジンを特定しなければならない」というウェブの鉄則によるものです。
急遽、API 側の Worker を修正し、リクエスト元の Origin を動的にチェックして返すように調整。セキュリティを担保しつつ、正確に通信ができるよう修正を加えました。
なぜ「ドッグフーディング」をするのか
今回の組み込み作業を通じて、単に機能を追加しただけではない大きな収穫がありました。それが「ドッグフーディング(自社製品を自分たちで使い倒すこと)」の価値です。
実際、自分たちのブログに組み込んでみることで:
- 初期設定のここが分かりにくい
- エラーが出た時のメッセージが不親切
- モバイルで見た時のボタンの位置が少し邪魔
といった、開発者視点では気づきにくい「ユーザーとしての違和感」が次々と見つかりました。これらのフィードバックは、すぐにプロダクトの改善へと繋がっています。
「自分たちが使いたいと思えるものを作る」。GoldFeather というプラットフォーム自体も、そしてそこに統合されるサービスも、このドッグフーディングのサイクルを回すことで、より洗練されたものへと進化させていきます。
まとめ
本日のアップデートにより、各記事の末尾にリアクションボタンが表示されるようになりました。もしこの記事が面白かった、あるいは参考になったという方は、ぜひ左下のボタンをポチッと押してみてください!
皆さんのその小さな反応が、次なる開発の大きな動力源になります。
それでは、次回の開発記録でお会いしましょう。
GoldFeather 開発チーム一同