Sheets to WP
Google スプレッドシートのセルを記事内に埋め込み、シート更新で全記事を自動更新
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/terasakisd/sheets-to-wp/archive/refs/heads/main.zipGS Dynamic Content - WordPress Plugin
スプレッドシートのセルを記事内に埋め込み、スプレッドシートを更新するだけで全記事を自動更新できるWordPressプラグインです。
特徴
- 📊 スプレッドシート連携: Google Sheetsのセルを記事内に直接参照
- 🔄 自動更新: スプレッドシートを更新すれば全記事が自動的に更新
- ⚡ 高速表示: キャッシュ機能でページ表示速度を維持
- 🎯 簡単な記法:
{{gs:A1}}または[gs_cell]A1[/gs_cell] - 📅 スケジュール更新: 1時間ごと、毎日、週1回など自動更新設定
- 🛠️ 管理画面: 使用状況の確認、手動更新、キャッシュ管理
使用例
年次更新の自動化
今年は{{gs:A1}}の目標を達成しました!
スプレッドシートのA1セルを「2025年」→「2026年」に変更すれば、全記事が自動更新!
価格情報の一括管理
価格は[gs_cell format="currency"]B2[/gs_cell]です
スプレッドシートで価格を管理し、変更すれば全ページの価格が自動更新!
インストール
- このプラグインフォルダを
/wp-content/plugins/ディレクトリにアップロード - WordPressの管理画面から「プラグイン」→「GS Dynamic Content」を有効化
- 「GS Dynamic」メニューから設定を行う
初期設定
1. Google Sheets API の設定
- Google Cloud Console にアクセス
- 新しいプロジェクトを作成(または既存のプロジェクトを選択)
- 「APIとサービス」→「ライブラリ」から「Google Sheets API」を検索して有効化
- 「認証情報」→「認証情報を作成」→「APIキー」を選択
- 作成されたAPIキーをコピー
2. スプレッドシートの準備
- Google Sheetsでスプレッドシートを作成
- 共有設定を「リンクを知っている全員」に変更
- URLからスプレッドシートIDを取得
- URL例:
https://docs.google.com/spreadsheets/d/1ABC...XYZ/edit 1ABC...XYZの部分がスプレッドシートID
- URL例:
3. プラグイン設定
- WordPress管理画面の「GS Dynamic」→「設定」へ移動
- APIキーとスプレッドシートIDを入力
- 「接続テスト」ボタンで接続を確認
- キャッシュ設定と自動更新設定を調整
- 「設定を保存」
使い方
基本的な記法
方法1: {{gs:セル}} 形式(推奨)
今年は{{gs:A1}}です
価格は{{gs:B2}}円
営業時間:{{gs:Sheet1!C3}}
方法2: ショートコード形式
[gs_cell]A1[/gs_cell]
[gs_cell sheet="Sheet1"]A1[/gs_cell]
シート名の指定
{{gs:Sheet1!A1}}
{{gs:価格表!B2}}
[gs_cell sheet="Sheet1"]A1[/gs_cell]
名前参照(行名.列名)
セル番地の代わりに「行名.列名」で指定できます。 1行目を列見出し、A列を行見出しとして使っているシートで有効です。
{{gs:消費者金融!プロミス.審査時間}}
{{gs:プロミス.審査時間}} ← デフォルトタブの場合
| A | B | C |
|---|---|---|
| サービス名 | 審査時間 | 金利 |
| プロミス | 最短3分 | 4.5%〜17.8% |
| アコム | 最短20分 | 3.0%〜18.0% |
上の表なら {{gs:プロミス.審査時間}} → 「最短3分」が表示されます。
- 行の追加・並べ替えをしても参照が壊れないのがメリットです
- 見出しは前後の空白を除いた完全一致で照合されます
- 該当する行名・列名が見つからない場合はデフォルト値(未指定なら空)になります
デフォルト値の設定
[gs_cell default="データなし"]A1[/gs_cell]
フォーマットオプション
<!-- 数値のカンマ区切り -->
[gs_cell format="number"]A1[/gs_cell]
<!-- 通貨形式(¥記号付き) -->
[gs_cell format="currency"]B2[/gs_cell]
<!-- 日付形式 -->
[gs_cell format="date"]C3[/gs_cell]
<!-- 日時形式 -->
[gs_cell format="datetime"]D4[/gs_cell]
範囲をテーブルで表示
[gs_range header="true"]A1:C10[/gs_range]
[gs_range class="my-custom-table"]A1:D20[/gs_range]
実用例
例1: 年次情報の一括更新
スプレッドシート(A1セル): 2026年
記事内:
{{gs:A1}}の目標
{{gs:A1}}版カタログ
{{gs:A1}}の売上実績
→ A1を「2027年」に変更すれば、全記事が一括更新!
例2: 営業情報の管理
スプレッドシート: | A | B | |---|---| | 営業時間 | 10:00-19:00 | | 定休日 | 水曜日 | | 電話番号 | 03-1234-5678 |
記事内:
営業時間:{{gs:B1}}
定休日:{{gs:B2}}
お問い合わせ:{{gs:B3}}
例3: 価格一覧の自動更新
スプレッドシート: | 商品名 | 価格 | |--------|------| | プランA | 10000 | | プランB | 20000 |
記事内:
プランA: [gs_cell format="currency"]B1[/gs_cell]
プランB: [gs_cell format="currency"]B2[/gs_cell]
管理画面の機能
設定ページ
- API設定
- キャッシュ設定
- 自動更新スケジュール設定
使用状況ページ
- 使用中のセル一覧
- 各セルの現在値
- 投稿の再スキャン
ヘルプページ
- 使い方ガイド
- よくある質問
よくある質問
Q: スプレッドシートを更新したのに記事に反映されません
A: キャッシュが有効になっています。以下の方法で更新できます:
- 管理画面の「今すぐ更新」ボタンをクリック
- キャッシュ有効期間が経過するまで待つ
- 「キャッシュをクリア」ボタンをクリック
Q: プライベートなスプレッドシートは使えますか?
A: 現在のバージョンはAPIキー方式のため、「リンクを知っている全員」に共有設定したスプレッドシートのみ対応しています。
Q: 複数のスプレッドシートを使えますか?
A: 現在は1つのスプレッドシートのみ対応していますが、複数シート(タブ)の利用は可能です。
例: {{gs:Sheet1!A1}}、{{gs:Sheet2!B2}}
Q: APIリクエスト制限はありますか?
A: Google Sheets APIには1日あたりのクエリ制限があります。キャッシュ機能を活用することで、APIリクエスト数を削減できます。
Q: セルの値が表示されません
A: 以下を確認してください:
- APIキーが正しく設定されているか
- スプレッドシートIDが正しいか
- スプレッドシートが「リンクを知っている全員」に共有されているか
- Google Sheets APIが有効化されているか
- セル参照(A1など)が正しいか
セキュリティについて
- APIキーは適切に管理してください
- スプレッドシートの共有範囲を適切に設定してください
- 機密情報をスプレッドシートに保存する場合は注意してください
システム要件
- WordPress 5.0以上
- PHP 7.2以上
- Google Sheets API アクセス
ライセンス
GPL v2 or later
サポート
問題が発生した場合は、以下をお試しください:
- 「接続テスト」で接続を確認
- 「投稿を再スキャン」で使用セルを更新
- 「キャッシュをクリア」でキャッシュをリセット
変更履歴
1.0.0
- 初回リリース
- Google Sheets API連携
- キャッシュ機能
- 自動更新スケジュール
- 管理画面