# HajimeCreate Text Weaver API Integration プラグイン

APIからテキストを取得して出力するWordPressプラグインです。

## 環境設定

### 設定方法

プラグインの設定は、WordPress管理画面の「設定」→「Text Weaver API」から行います。

主な設定項目：
- **APIキー**: Text Weaver APIのアクセスキー
- **ベースURL**: Text WeaverのベースURL（デフォルト: https://text-weaver.com）
- **APIエンドポイント**: APIのエンドポイントパス（デフォルト: /api/v1/content/）
- **環境設定**: development, staging, production
- **デバッグモード**: デバッグ情報の表示/非表示
- **デフォルトキャッシュ時間**: APIレスポンスのキャッシュ時間（秒）

### 環境の種類

- **development（開発環境）**：テスト用設定、デバッグモードON、キャッシュなし
- **staging（ステージング環境）**：本番前のテスト環境
- **production（本番環境）**：本番用設定、デバッグモードOFF

### URL設定

- **本番環境**：`https://text-weaver.com`

### セキュリティ

設定情報はWordPressデータベースに安全に保存されます。
APIキーなどの機密情報は、WordPress標準のオプションAPIを使用して暗号化された状態で保存されます。

## ショートコード使用方法

投稿やページで以下のショートコードを使用してAPIからコンテンツを取得できます：

```
[hajimecreate_text_weaver_api label="your_label"]
```

`label`パラメータにはText Weaver APIで設定したラベル名を指定してください。

## 管理画面

WordPress管理画面の「Text Weaver API」から以下の操作が可能です：

- APIキーの設定
- API接続テスト
- 環境設定の確認
- Text Weaverへのログイン

## 本番環境への切り替え

1. 管理画面で「環境設定」を `production` に変更
2. 「デバッグモード」を `false` に設定
3. 「ベースURL」を `https://text-weaver.com` に設定
4. 本番用のAPIキーを設定

## 機能

- **ショートコード機能**: `[hajimecreate_text_weaver_api label="ラベル名"]` でAPIからデータを取得
- **管理画面**: GUIでAPIキーの設定とショートコードの管理
- **キャッシュ機能**: パフォーマンス向上のためのキャッシュシステム
- **API接続テスト**: 設定画面でAPIの接続テスト機能

## インストール

1. プラグインフォルダを `/wp-content/plugins/` にアップロード
2. WordPress管理画面の「プラグイン」メニューで有効化
3. 「設定」→「Text Weaver API」でAPIキーを設定

## 使用方法

### 基本的な使用例

```
[hajimecreate_text_weaver_api label="test1"]
[hajimecreate_text_weaver_api label="news"]
[hajimecreate_text_weaver_api label="custom"]
```

### オプション

- **label**: APIのラベル（必須）
- **cache_time**: キャッシュ時間（秒、省略時は0秒=キャッシュ無効）

### 管理画面での操作

1. **APIキー設定**: Text Weaver APIのAPIキーを入力
2. **ショートコード生成**: ラベルを入力してショートコードを自動生成
3. **ショートコード管理**: 生成されたショートコードの一覧、編集、削除
4. **API接続テスト**: 設定されたAPIキーでの接続テスト

## ファイル構造

```
hajimecreate-text-weaver-api-integration/
├── hajimecreate-text-weaver-api-integration.php  # メインプラグインファイル
├── includes/
│   ├── class-admin.php                          # 管理画面クラス
│   ├── class-shortcode.php                      # ショートコードクラス
│   └── class-api.php                            # API処理クラス
├── assets/
│   ├── css/
│   └── js/
└── README.md                                    # このファイル
```

## 要件

- WordPress 5.0 以上
- PHP 7.4 以上

## ライセンス

GPL v2 or later

## 更新履歴

### 1.0.0
- 初回リリース
- ショートコード機能
- 管理画面
- API接続機能