メンテがエラーで終わるとプラグインバッジが消える罠 — バックエンドマーカーとフロント実数反映の設計
WordPress の保守ツールには、サイト一覧に「未更新プラグインが N 件ある」を示すバッジを表示する機能がある。通常のメンテナンスでは更新が終わるとバッジが消え、次回の横断ダッシュボード走査まで 0 件扱いになる— …
一度直したはずの csh バグが新機能追加で再燃した — `/bin/sh -c` ラッパーで3サーバー環境に対応する設計
2026年5月、さくらインターネット上の WordPress サイトで SSH 経由の bash コマンドが動かない問題に遭遇した。原因はさくらの既定ログインシェルが csh だったこと。コードベースに散在する bash …
デプロイ完了とgitコミット完了は別物 — 「アップロード済み=ローカルも同期済み」と思い込む罠
リリース作業の最終段階で、本番サーバーへのファイル転送がすべて成功し、配信用のバージョン情報ファイルも更新できた。ここまで確認して「リリース完了」と報告したところ、実はローカルのgitリポジトリには、転送したはずの変更が …
並び替えAPIの「件数が変わっていないか」検証 — 書き込み前のサニティチェック
ドラッグ&ドロップで複数件のデータを並べ替える機能を作るとき、新しい順序をサーバーに送って保存する処理が必要になる。このとき気をつけないと、並べ替えのロジックに小さな欠陥があるだけで、データが消えたり重複したりし …
バージョン番号バンプの取りこぼし事故 — 単一ソース + –check ゲートで再発防止する設計
バージョン番号バンプの取りこぼし事故 — 単一ソース + –check ゲートで再発防止する設計 デスクトップアプリのリリースでは、バージョン番号を1つ上げるだけのつもりが、実は5箇所のファイルを同時に書き換える作業に …
Playwrightの生エラー(Call log: …)をそのままユーザーに見せない — 例外メッセージの翻訳設計
Playwrightの生エラー(Call log: …)をそのままユーザーに見せない — 例外メッセージの翻訳設計 Playwright で何かが失敗すると、例外メッセージには Call log: から始まる長いデバ …
一括選択チェックボックスが「チェックしたつもり」で反映されない罠 — check() 後の検証フォールバック
WordPress のプラグイン更新画面やテーマ更新画面には「すべて選択」チェックボックスがある。Playwright で check() を呼べばクリックは成功する。だが、その後に個別のチェックボックスを見ると、1件も …
`update-core.php` のバージョン番号抽出が誤検出する罠 — プラグイン版番号と本体バージョンを区別する3段階ガード
SSH が使えない環境では、Playwright で update-core.php（WordPress 更新画面）を開き、ページのテキストから「WordPress 本体が今何バージョンか」を読み取る処理を書くことがある …
ブラウザ補完更新で「管理者メール確認」画面に詰まる罠 — Playwright が wp-admin 操作で止まる理由
SSH が使えないホスティング環境では、Playwright で wp-admin にログインしてプラグイン更新画面を直接操作する経路を用意している。多くの場面ではこれで問題なく動くが、ある日突然、プラグイン更新画面に到 …
「スケジュール投稿が公開されない」の正体 — WP-CLI で WP-Cron の中身を見る
公開予約した記事が指定時刻になっても公開されない。プラグインの定期メール通知が届かない。アクセスが少ない時間帯にこうした現象が起きやすいのには理由がある。 補足: WP-Cron は WordPress に組み込まれた予 …