個人事業主のためのWordPressテーマ「LiteWord」

外部AIがLiteWordのマイパーツを直接コーディングする

Codex・Claude等がコードを作り、LWマイパーツのHTML/CSS/JavaScript欄へ直接設定する手順。LiteWord内蔵の「AIパーツ生成」を押したり、Gemini等の生成APIやそのキーを用意したりする必要はない。外部AI自身の利用料金・機能は利用環境による。内蔵APIの契約を不要にする話と、テーマ機能の権利・作成枠・保存権限の回避は別である。

着手前: 公開情報の必須保護、共通パーツの作成・設置・更新、対象版のパーツ仕様を読む。この条件は、内蔵のマイパーツ生成指示とテーマの実際の保存・描画の仕組みを外部AIでも使えるよう整理したもの。開発者専用のソースを利用者に探させない。公式資料と対象版の画面が異なれば、実画面を調べて未確認を区別する。

独立した1ページを作る場合

HTML全体をそのまま使うLPや、ブラウザで動く電卓等を独立ページとして作るならコード専用ページの手順へ進む。そちらはDOCTYPEから書く方式で、ここで説明する「部品のみ・テーマのリセット済み・HTML/CSS/JSの3欄」を適用しない。

パーツとして出力する範囲

  • 出力するのは依頼されたセクション・部品だけ。<!doctype>、html/head/body、title/meta、WordPressのPHP、テーマのヘッダー・グローバルナビ・フッターを含めない。ヘッダー付きの完成ページをパーツ欄へ入れない。ページ全体の背景や余白を変えるコードも混ぜない。
  • HTML欄は部品のマークアップ、CSS欄はCSS本文、JavaScript欄はJS本文を入れる。CSSをstyleタグ、JSをscriptタグで包まない。内蔵APIのJSON形式は通信上の形式なので、UIのHTML欄へJSONやMarkdownのコードフェンスごと貼らない。
  • 本文の途中へ置く部品にh1を追加せず、前後の見出し階層に合うh2/h3等を使う。画像のalt、リンクの目的、フォーム等のラベルを設定し、キーボード操作とフォーカス表示も確保する。

命名と影響の限定

最上位に部品固有のクラスを一つ置く。内蔵生成指示の形は lw_my_parts_<用途>_<番号>。例えば lw_my_parts_notice_1 を使い、既存パーツと重複しないか確認する。子はinner/title等でもよいが、CSSは親クラスの内側だけへ適用する。body、h2、a、button、.post_style、.lw_content_wrapなどを単独で上書きしない。keyframes名やCSS変数を使う場合も部品に閉じる。

通常の本文用セクションをheader/footerタグで包まない。対象のテーマやプラグインが同じタグへスタイルや処理を持つことも考慮し、section/div等で役割を表す。標準ヘッダー・フッターを置き換える依頼は専用手順で別に扱う。

リセットと本文用CSSを両方考慮する

内蔵生成指示は、margin/paddingが0、border-box、ulのマーカーなし、aの下線なし、本文の基本値16px・line-height 1・字間0.03em等を前提にしている。ただし実際には対象版のreset.cssに加えてcommon.css、page.css、選んだ本文スタイル、ページ色・フォント等が重なる。これらの数値がそのページの最終値とは限らない。 ブラウザの見た目とcomputed styleで使う要素を確かめる。

パーツのCSSを空にせず、親クラス配下で必要なレイアウト・文字サイズ・行高・段落間・見出し間・ボタンの上下余白と内部余白・画像サイズ・レスポンシブを指定する。ulは必要ならマーカーと開始側余白を設定する。テーマの見出しの線・背景・擬似要素、段落の余白、リンク色などが意図せず入る場合は、部品内の該当要素だけを補正する。全サイトのリセット再投入、全要素のall:unset、無差別な!importantで隠さない。

内蔵生成指示はモダンCSSネストを使う。対象ブラウザの対応条件を確認し、例えば次のように親から指定する。数値・色は例であり、全パーツの固定値ではない。

.lw_my_parts_notice_1 {
  padding: 32px 24px;
  color: #4c4137;
  font-size: 16px;
  line-height: 1.8;

  .title {
    margin: 0 0 16px;
    padding: 0;
    background: none;
    border: 0;
    font-size: 24px;
    line-height: 1.5;
  }

  @media (max-width: 480px) {
    padding: 24px 16px;

    .title {
      font-size: 20px;
    }
  }
}

本文に入れた実表示で見出しやリンクへのテーマ装飾が残る場合は、その対象に限定してセレクタの強さや擬似要素も調べる。単独の白紙プレビューだけで完成にしない。

幅・配置・レスポンシブ

  • 本文内、サイドバー、フッター等、設置先の幅を先に決める。親に対する100%と画面に対する100vwは違う。内側に最大幅と左右余白を確保し、長い日本語、ボタン、画像がはみ出さない構成にする。
  • 全幅が必要なら、まずマイパーツの「全幅表示」を使い、出力される .lw_width_full_on を実ページで確認する。内蔵生成指示には width:100vw と margin-left:calc((100% - 100vw) / 2) の方法もあるが、これは全幅化する場合の指定。同じ要素へトグルと二重に適用せず、サイドバー等へ無条件で使わない。
  • 内蔵指示の .first_content を消す例はFVを先頭へ置く場合の前余白への対応で、通常パーツへコピーしない。必要なときだけ対象ページ・当該部品へ限定し、他ページや標準ヘッダーを隠さない。
  • 768px/480pxは内蔵指示の目安。内容と実際の親幅で調整し、PC・中間幅・SPを確認する。既存の .none_750px / .on_750px を使うなら750px境界と実表示を確認する。固定高さで文字を切らず、画像の切り抜き位置とPC/SP差替えも必要に応じて設計する。
  • background-attachment:fixedは使わない。文字クリップを使うなら -webkit-background-clip:text と標準の background-clip:text を併記し、背景や文字色の代替も確認する。見出し・ボタン等へ絵文字を加えない。

JavaScriptと資源

動きが不要ならJS欄は空にする。必要なら素のJavaScriptを即時実行関数に閉じ、変数・関数を部品名で区別する。DOMContentLoadedの前後どちらでも初期化でき、対象がないページで例外を出さないようにする。共通パーツを同一ページへ複数設置する場合は全インスタンスを処理し、イベントの二重登録を避ける。

HTMLの固定IDを何度も複製しない。原則は各部品のルートからquerySelector等で探し、ラベルやaria-controls等でIDが必要ならインスタンスごとに一意にする。グローバルなquerySelector一件だけで全パーツを操作しない。

内蔵指示はスライダーにSwiperを想定しているが、「CDNは自動読み込み」という記述だけで対象ページにもあると決めない。実際の読み込みと版・枚数条件を確認し、既存資源へ接続する。無断で別版のライブラリ・jQuery・リセットCSS・フォントを重ねず、不足なら必要性と選択肢を示す。スライダーは枚数と操作の確認も行う。

内蔵APIにはpicsum.photosを画像生成前の置換元として使う工程がある。外部AIの完成パーツにランダム写真を必須とする条件ではない。 利用者の素材や許可された生成画像を使い、画像が不要な部品へ写真を強制しない。参照画像や既存コードを直す場合は、依頼外の画像URL・色・文字・構造を保つ。

CSS/JSは公開ページへ出力される。秘密鍵、管理用トークン、個人情報、外部への無断送信、動的コード実行を含めない。権限でHTML/JSが除去された場合は、その結果を報告し、権限チェックを外したり勝手にロールを上げたりしない。

UIへ設定し、実際の埋め込み先で確認する

  1. 既存パーツを編集するなら3欄、モード、全幅、状態、利用先を控える。通常エディタの本文と3欄を混同しない。
  2. 「編集モード → コードエディタ」を選び、自動保存・再読込が終わってから3欄へ設定する。CodeMirror等の見える入力欄を使い、通常の保存操作を行う。非公開の内部ストアを書き換えたり、推測したAPIで保存しない。操作権限がなければ3つに分けたコードと手順を渡す。
  3. 保存後に再読込し、HTML/CSS/JSが残り、タグや文字が壊れていないことを確かめる。専用プレビューは途中確認に使い、最終確認はLiteWordの実ページへ埋め込んで行う。
  4. PC/SPと必要な中間幅で幅・文字・行高・余白・テーマ装飾・リンク・動作を確認する。複数箇所で使う部品は同一ページの複数設置も確認し、元パーツの更新が複数ページへ反映されることを調べる。公開する場合は訪問者表示も別に確認する。
  5. パーツ外の見出し・本文・ヘッダー・フッターに副作用がないか、変更に関係する範囲を確認する。直すときは当該パーツだけを修正し、未検証の配置方法や端末まで対応済みにしない。

最終更新: 2026-11-06 21:38