docs: add PHP examples for WordPress integration

docs/API_WORKFLOW_WORDPRESS_N8N.md

@@ -196,6 +196,196 @@ curl -s -X POST "https://api.momentry.ddns.net/api/v1/search" \
 
 ---
 
+## WordPress PHP 範例
+
+### 基本設定
+
+```php
+<?php
+class Momentry_API {
+    private const API_URL = 'https://api.momentry.ddns.net';
+    private const API_KEY = 'YOUR_API_KEY';
+
+    public static function request(string $method, string $endpoint, ?array $data = null): array {
+        $url = self::API_URL . $endpoint;
+        
+        $args = [
+            'method'      => $method,
+            'headers'     => [
+                'X-API-Key'    => self::API_KEY,
+                'Content-Type' => 'application/json',
+            ],
+            'timeout'     => 30,
+        ];
+
+        if ($data !== null) {
+            $args['body'] = json_encode($data);
+        }
+
+        $response = wp_remote_request($url, $args);
+        
+        if (is_wp_error($response)) {
+            throw new Exception($response->get_error_message());
+        }
+
+        return json_decode(wp_remote_retrieve_body($response), true);
+    }
+
+    public static function getVideos(): array {
+        return self::request('GET', '/api/v1/videos');
+    }
+
+    public static function getVideo(string $uuid): array {
+        return self::request('GET', "/api/v1/videos/{$uuid}");
+    }
+
+    public static function getJob(string $uuid): array {
+        return self::request('GET', "/api/v1/jobs/{$uuid}");
+    }
+
+    public static function search(string $query, int $topK = 5): array {
+        return self::request('POST', '/api/v1/search', [
+            'query' => $query,
+            'top_k' => $topK,
+        ]);
+    }
+}
+```
+
+### Step 3: 確認註冊成功
+
+```php
+<?php
+// 查詢所有影片
+$videos = Momentry_API::getVideos();
+
+foreach ($videos['videos'] as $video) {
+    echo "UUID: " . $video['uuid'] . "\n";
+    echo "檔案: " . $video['file_name'] . "\n";
+    echo "時長: " . $video['duration'] . " 秒\n";
+    echo "---\n";
+}
+
+// 查詢特定影片
+$video = Momentry_API::getVideo('952f5854b9febad1');
+print_r($video);
+```
+
+### Step 4: 查詢處理進度
+
+```php
+<?php
+// 取得任務狀態
+$job = Momentry_API::getJob('9760d0820f0cf9a7');
+
+switch ($job['status']) {
+    case 'pending':
+        echo "等待處理中...\n";
+        break;
+    case 'processing':
+        echo "處理中: " . $job['progress'] . "%\n";
+        break;
+    case 'completed':
+        echo "處理完成！\n";
+        break;
+    case 'failed':
+        echo "處理失敗: " . ($job['error'] ?? '未知錯誤') . "\n";
+        break;
+}
+```
+
+### Step 5: 搜尋內容
+
+```php
+<?php
+// 搜尋相關片段
+$results = Momentry_API::search('測試關鍵字', 5);
+
+foreach ($results['results'] as $result) {
+    echo "UUID: " . $result['chunk_id'] . "\n";
+    echo "分數: " . $result['score'] . "\n";
+    echo "內容: " . ($result['text'] ?? '') . "\n";
+    echo "---\n";
+}
+```
+
+### WordPress Shortcode 範例
+
+```php
+<?php
+// 在 functions.php 中加入
+add_shortcode('momentry_search', function($atts) {
+    $atts = shortcode_atts([
+        'query'   => '',
+        'limit'   => 10,
+    ], $atts);
+
+    if (empty($atts['query'])) {
+        return '<p>請輸入搜尋關鍵字</p>';
+    }
+
+    try {
+        $results = Momentry_API::search($atts['query'], $atts['limit']);
+        
+        if (empty($results['results'])) {
+            return '<p>找不到相關結果</p>';
+        }
+
+        $html = '<div class="momentry-results">';
+        $html .= '<h3>搜尋結果: ' . esc_html($atts['query']) . '</h3>';
+        $html .= '<ul>';
+
+        foreach ($results['results'] as $result) {
+            $html .= '<li>';
+            $html .= '<strong>時間: ' . ($result['start_time'] ?? 'N/A') . 's</strong>';
+            $html .= '<br>';
+            $html .= esc_html($result['text'] ?? '無文字描述');
+            $html .= '</li>';
+        }
+
+        $html .= '</ul></div>';
+        return $html;
+
+    } catch (Exception $e) {
+        return '<p>搜尋服務暫時無法使用</p>';
+    }
+});
+```
+
+**使用方式**:
+```html
+[momentry_search query="關鍵字" limit="5"]
+```
+
+---
+
+## 完整 n8n Workflow 範例
+
+```
+┌──────────────┐
+│  觸發 (定時)  │
+└──────┬───────┘
+       ▼
+┌──────────────┐     ┌──────────────┐
+│  查詢影片     │────►│  比對新檔案   │
+│  /videos     │     │              │
+└──────┬───────┘     └──────────────┘
+       │                   │
+       ▼                   ▼
+┌──────────────┐     ┌──────────────┐
+│  等待處理     │◄────│  輪詢任務狀態  │
+│  /jobs/:uuid │     │  /jobs/:uuid │
+└──────┬───────┘     └──────────────┘
+       │
+       ▼ (completed)
+┌──────────────┐
+│  搜尋測試     │
+│  /search     │
+└──────────────┘
+```
+
+---
+
 **注意**: 
 - 處理時間視影片長度而定（1分鐘影片約需 2-5 分鐘處理）
 - 大量影片時建議分批上傳