SWELLの設定値をTSVで確認する方法｜読み取り専用の管理者ツール

/**
 * Theme Settings Dump (FINDER) with NOTE column
 */

add_action('admin_menu', function () {
  add_management_page(
    'テーマ設定の出力',
    'テーマ設定の出力',
    'manage_options',
    'theme-settings-dump-finder',
    'waza_render_theme_settings_dump_finder'
  );
});

function waza_render_theme_settings_dump_finder() {
  if (!current_user_can('manage_options')) return;

  global $wpdb;

  $template   = get_option('template');    // parent theme slug (e.g. swell)
  $stylesheet = get_option('stylesheet');  // active theme slug (e.g. swell_child)

  // theme_mods option names
  $mods_opt_stylesheet = 'theme_mods_' . $stylesheet;
  $mods_opt_template   = 'theme_mods_' . $template;

  $mods_stylesheet = get_option($mods_opt_stylesheet);
  $mods_template   = ($mods_opt_template === $mods_opt_stylesheet) ? null : get_option($mods_opt_template);

  if (!is_array($mods_stylesheet)) $mods_stylesheet = [];
  if (!is_array($mods_template))   $mods_template   = [];

  $rows = [];

  // ---- meta
  $rows[] = ['meta', 'template', $template, waza_swell_note('meta', 'template')];
  $rows[] = ['meta', 'stylesheet', $stylesheet, waza_swell_note('meta', 'stylesheet')];
  $rows[] = ['meta', 'theme_mods_option_stylesheet', $mods_opt_stylesheet, waza_swell_note('meta', 'theme_mods_option_stylesheet')];
  $rows[] = ['meta', 'theme_mods_option_template', $mods_opt_template, waza_swell_note('meta', 'theme_mods_option_template')];

  // ---- dump theme_mods (both)
  foreach ($mods_stylesheet as $k => $v) {
    $sec = 'mods/' . $mods_opt_stylesheet;
    $rows[] = [$sec, (string)$k, waza_dump_stringify($v), waza_swell_note($sec, (string)$k)];
  }
  foreach ($mods_template as $k => $v) {
    $sec = 'mods/' . $mods_opt_template;
    $rows[] = [$sec, (string)$k, waza_dump_stringify($v), waza_swell_note($sec, (string)$k)];
  }

  // Only read known display-setting options, never scan arbitrary names.
  $options = [];
  foreach (['loos_customizer', 'swell_options', 'swell_editors'] as $option_name) {
    $value = get_option($option_name, null);
    if ($value !== null) {
      $options[] = ['option_name' => $option_name, 'option_value' => $value];
    }
  }

  $rows[] = ['meta', 'matched_wp_options_count', (string)count($options), waza_swell_note('meta', 'matched_wp_options_count')];

  foreach ($options as $opt) {
    $name = $opt['option_name'];
    $val  = maybe_unserialize($opt['option_value']);

    // loos_customizer は中身を展開して 1行=1設定
    if ($name === 'loos_customizer' && is_array($val)) {
      foreach ($val as $k => $v) {
        $k2 = "loos_customizer[$k]";
        $rows[] = ['options', $k2, waza_dump_stringify($v), waza_swell_note('options', $k2)];
      }
      continue;
    }

    // swell_options / swell_editors も展開
    if (in_array($name, ['swell_options','swell_editors'], true) && is_array($val)) {
      foreach ($val as $k => $v) {
        $k2 = "{$name}[$k]";
        $rows[] = ['options', $k2, waza_dump_stringify($v), waza_swell_note('options', $k2)];
      }
      continue;
    }

    // それ以外はそのまま
    $rows[] = ['options', $name, waza_dump_stringify($val), waza_swell_note('options', $name)];
  }

  // sort
  usort($rows, function($a, $b){
    if ($a[0] === $b[0]) return strcmp($a[1], $b[1]);
    return strcmp($a[0], $b[0]);
  });

  // TSV（4列固定）
  $tsv = "section\tkey\tvalue\tnote\n";
  foreach ($rows as $r) {
    $note = $r[3] ?? '';
    $tsv .= $r[0] . "\t" . $r[1] . "\t" . $r[2] . "\t" . $note . "\n";
  }

  // output
  echo '<div class="wrap">';
  echo '<h1>Theme Settings Dump (FINDER)</h1>';

  echo '<h2><label for="waza-settings-tsv">TSV（読み取り専用）</label></h2>';
  echo '<textarea id="waza-settings-tsv" readonly style="width:100%;height:300px;font-family:monospace;">'
       . esc_textarea($tsv) . '</textarea>';

  echo '<h2>Table view</h2>';
  echo '<table class="widefat striped">';
  echo '<thead><tr><th style="width:220px;">section</th><th>key</th><th>value</th><th>note</th></tr></thead><tbody>';

  foreach ($rows as $r) {
    $note = $r[3] ?? '';
    echo '<tr>';
    echo '<td>' . esc_html($r[0]) . '</td>';
    echo '<td><code>' . esc_html($r[1]) . '</code></td>';
    echo '<td style="white-space:pre-wrap;word-break:break-word;">' . esc_html($r[2]) . '</td>';
    echo '<td style="white-space:pre-wrap;word-break:break-word;">' . esc_html($note) . '</td>';
    echo '</tr>';
  }

  echo '</tbody></table>';
  echo '</div>';
}

function waza_dump_stringify($v) {
  $v = maybe_unserialize($v);

  if (is_bool($v)) $s = $v ? 'true' : 'false';
  elseif (is_null($v)) $s = '';
  elseif (is_scalar($v)) $s = (string)$v;
  else $s = wp_json_encode($v, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

  // 改行/タブ潰し（TSV崩れ防止）
  return str_replace(["\r\n", "\r", "\n", "\t"], ["\\n", "\\r", "\\n", "\\t"], $s);
}

function waza_swell_note($section, $key) {

  // meta
  if ($section === 'meta') {
    return match ($key) {
      'matched_wp_options_count' => 'wp_options から抽出できたSWELL/LOOS系オプション件数（探索用）',
      'template' => '親テーマ（template）スラッグ',
      'stylesheet' => '有効化中テーマ（子テーマ含む）スラッグ',
      'theme_mods_option_stylesheet' => 'theme_mods（子テーマ側）の保存先 option_name',
      'theme_mods_option_template' => 'theme_mods（親テーマ側）の保存先 option_name',
      default => 'メタ情報',
    };
  }

  // theme_mods（Customizer / ウィジェット / メニューなど）
  if (str_starts_with($section, 'mods/')) {
    if ($key === 'nav_menu_locations') return 'メニュー位置（location）→ メニューID の割当（環境依存ID）';
    if ($key === 'custom_css_post_id') return '追加CSS（カスタマイザー）を保存している投稿ID（環境依存ID）';
    if ($key === 'sidebars_widgets') return '各サイドバーに配置されているウィジェット一覧（ブロック含む）';
    if ($key === '0') return 'theme_mods のダミー/未使用要素（無視してOK）';
    return 'テーマ設定（theme_mods / Customizer系）';
  }

  // options（SWELL/LOOS）
  if ($section === 'options') {

    // loos_customizer[...]
    if (preg_match('/^loos_customizer\[(.+)\]$/', $key, $m)) {
      $k = $m[1];

      if (str_starts_with($k, 'color_')) return 'SWELLカスタマイザー：配色設定';
      if (in_array($k, ['to_site_flat','to_site_rounded'], true)) return 'SWELLカスタマイザー：全体の角丸/フラット（見た目テイスト）';
      if (in_array($k, ['container_size','max_column_sp'], true)) return 'SWELLカスタマイザー：レイアウト幅/カラム設定';
      if (in_array($k, ['fix_header','fix_header_sp'], true)) return 'SWELLカスタマイザー：ヘッダー固定（PC/SP）';
      if ($k === 'phrase_pos') return 'SWELLカスタマイザー：ヘッダーのフレーズ表示位置';
      if ($k === 'main_visual_type') return 'SWELLカスタマイザー：メインビジュアル種別（スライダー等）';
      if ($k === 'show_post_slide') return 'SWELLカスタマイザー：投稿スライダー表示';
      if (str_contains($k, 'sidebar')) return 'SWELLカスタマイザー：サイドバー表示制御（ページ種別ごと）';
      if ($k === 'hide_bg_breadcrumb') return 'SWELLカスタマイザー：パンくず背景の表示/非表示';
      if ($k === 'index_style') return 'SWELLカスタマイザー：目次デザイン';
      if (in_array($k, ['h2_type','h3_type','h4_type','sec_title_style','sidettl_type','spmenu_title_type','footer_title_type','archive_title_style','page_title_style'], true))
        return 'SWELLカスタマイザー：見出し/タイトル装飾スタイル';
      if (in_array($k, ['show_title_date','show_title_date_sp'], true)) return 'SWELLカスタマイザー：タイトル周りの日付表示（PC/SP）';
      if (in_array($k, ['show_meta_tag'], true)) return 'SWELLカスタマイザー：記事メタ（タグ等）表示';
      if (in_array($k, ['show_page_links'], true)) return 'SWELLカスタマイザー：ページ内リンク（前後/ページ送り等）表示';
      if (in_array($k, ['show_author','show_comments','show_icon_list','show_foot_icon_list'], true)) return 'SWELLカスタマイザー：表示/非表示（著者/コメント/アイコン）';
      if ($k === 'copyright') return 'SWELLカスタマイザー：フッター著作権表示';
      if ($k === 'urlcopy_btn_pos') return 'SWELLカスタマイザー：URLコピー/シェアボタン位置';
      return 'SWELLカスタマイザー：その他設定';
    }

    // swell_editors[...]
    if (preg_match('/^swell_editors\[(.+)\]$/', $key, $m)) {
      $k = $m[1];
      if (str_starts_with($k, 'color_')) return 'SWELLエディター設定：ブロック用カラー/装飾カラー';
      if (str_starts_with($k, 'border')) return 'SWELLエディター設定：枠線プリセット';
      if (str_starts_with($k, 'btn_radius')) return 'SWELLエディター設定：ボタン角丸プリセット';
      if ($k === 'marker_type') return 'SWELLエディター設定：マーカー（蛍光ペン）タイプ';
      if (str_starts_with($k, 'format_set_') || str_starts_with($k, 'format_title_')) return 'SWELLエディター設定：装飾（カスタム書式）設定';
      if ($k === 'custom_format_css') return 'SWELLエディター設定：装飾用の追加CSS（カスタム）';
      if (in_array($k, ['blog_card_type','blog_card_type_ex'], true)) return 'SWELLエディター設定：ブログカード（内部/外部）のデザイン';
      if ($k === 'blockquote_type') return 'SWELLエディター設定：引用（blockquote）デザイン';
      if (str_starts_with($k, 'iconbox')) return 'SWELLエディター設定：アイコンボックスのスタイル';
      return 'SWELLエディター設定：その他';
    }

    // swell_options[...]
    if (preg_match('/^swell_options\[(.+)\]$/', $key, $m)) {
      $k = $m[1];
      if (str_starts_with($k, 'cache_')) return 'SWELL高速化：CSS/ヘッダー/サイドバー等のキャッシュ';
      if (str_starts_with($k, 'delay_js')) return 'SWELL高速化：JS遅延読み込み（対象/除外/待機秒数）';
      if ($k === 'lazy_type') return 'SWELL高速化：LazyLoad方式';
      if (str_starts_with($k, 'use_')) return 'SWELL機能ON/OFF（構造化データ・PJAX等）';
      if (str_starts_with($k, 'remove_')) return 'SWELL最適化：WP標準機能の無効化（絵文字/バージョン/rel等）';
      if (str_starts_with($k, 'load_')) return 'SWELL読み込み設定：CSS/JS/Font Awesome等';
      if ($k === 'fa_version') return 'SWELL：Font Awesome バージョン';
      if (str_contains($k, 'ad_code') || str_contains($k, 'infeed') || str_contains($k, 'before_h2')) return 'SWELL広告/コード挿入（見出し前/インフィード等）';
      if (str_starts_with($k, 'ld_org_')) return 'SWELL構造化データ：Organization 情報';
      return 'SWELL設定：その他（パフォーマンス/機能）';
    }

    // その他 option
    if ($key === 'swell_others') return 'SWELL内部フラグ（初期設定完了など）';
    if ($key === 'swell_version') return 'SWELLテーマバージョン';
    if ($key === 'sweller_email') return 'SWELL購入/ライセンス関連の登録メール（機微情報なので扱い注意）';

    return 'wp_options：SWELL/LOOS関連（名称から判断）';
  }

  return '不明';
}