在 WordPress 中，文章的 slug（網址別名）預設是根據標題自動產生，或由使用者手動設定。有時候為了簡化網址管理或避免重複 slug，會想將 slug 固定為文章的 ID。這段程式碼示範如何在文章發佈或排程時，自動將 slug 設為文章 ID，適合需要統一網址格式的開發者或網站管理者。

## 為什麼要用文章 ID 當 slug？

文章 ID 是 WordPress 中每篇文章的唯一識別碼，使用 ID 當 slug 可以避免重複 slug 的問題，也方便在程式中直接以 ID 取用文章，提升網址的穩定性與一致性。

## 程式碼解析

### 1. 使用 save_post Hook

程式碼利用 WordPress 的 `save_post` action，這個鉤子會在文章儲存時觸發，能即時修改文章資料。

“`php
add_action(‘save_post’, function ($post_id, $post, $update) {
// 程式內容
}, 20, 3);
“`

這裡設定優先權為 20，並且接受三個參數：文章 ID、文章物件、是否為更新。

### 2. 基本保護條件

避免對修訂版本（revision）或自動儲存（autosave）執行，減少不必要的處理。

“`php
if (wp_is_post_revision($post_id) || wp_is_post_autosave($post_id)) return;
if (!is_object($post)) return;
“`

### 3. 限制只對文章類型生效

確保只對 `post` 文章類型操作，不影響其他自訂文章類型。

“`php
if ($post->post_type !== ‘post’) return;
“`

### 4. 限制文章狀態

只對「已發佈（publish）」與「排程（future）」的文章改寫 slug，避免草稿或其他狀態執行。

“`php
$allowed_status = [‘publish’, ‘future’];
if (!in_array($post->post_status, $allowed_status, true)) return;
“`

### 5. 判斷是否已是目標 slug

如果 slug 已經是文章 ID，則不再重寫，避免重複操作。

“`php
$target_slug = (string) $post_id;
if ($post->post_name === $target_slug) return;
“`

### 6. 防止無限迴圈

`wp_update_post` 會再次觸發 `save_post`，容易造成無限迴圈。使用靜態變數 `$running` 作為旗標，避免重複執行。

“`php
static $running = false;
if ($running) return;
$running = true;
“`

### 7. 更新 slug

呼叫 `wp_update_post` 更新文章的 `post_name` 欄位為文章 ID。

“`php
wp_update_post([
‘ID’ => $post_id,
‘post_name’ => $target_slug,
]);
$running = false;
“`

## 實務應用與延伸

– 適合網站需要簡潔、唯一的網址結構，或是避免標題相同導致 slug 重複的情況。
– 可擴充支援更多文章類型或狀態，只要調整條件判斷即可。
– 若需保留原本 slug，可改成在自訂欄位或其他欄位存 ID。
– 注意排程文章的 slug 會在排程時間前就設定完成。

## 常見問題與注意事項

– 無限迴圈問題是此類操作常見的陷阱，務必使用旗標避免。
– 使用文章 ID 當 slug 可能不利 SEO，需評估是否符合網站策略。
– 若網站有使用快取或重寫規則，更新 slug 後可能需要清除快取。

## 完整程式碼

“`php
post_type !== ‘post’) return;

// 3) 只在這些狀態下固定（你也可以只留 publish）
$allowed_status = [‘publish’, ‘future’]; // future = 排程
if (!in_array($post->post_status, $allowed_status, true)) return;

// 4) 目標 slug = 文章 ID
$target_slug = (string) $post_id;

// 5) 已經是目標 slug 就不做事
if ($post->post_name === $target_slug) return;

// 6) 防止 save_post -> wp_update_post -> save_post 無限迴圈
static $running = false;
if ($running) return;
$running = true;

// 7) 更新 slug
wp_update_post([
‘ID’ => $post_id,
‘post_name’ => $target_slug,
]);

$running = false;

}, 20, 3);
“`

在網頁中嵌入 YouTube 影片時，若希望影片能夠無限循環播放，通常需要在 iframe 的 URL 中加入特定參數。這段程式碼解決了直接設定 loop 參數無法生效的問題，適合需要動態調整或修正第三方影片嵌入參數的前端工程師與自學者。

## 問題背景與解決方案

YouTube 的 iframe 影片循環播放並非只靠 `loop=1` 參數即可生效，還必須同時指定 `playlist` 參數為影片 ID。這段程式碼會自動偵測所有帶有 `youtube-loop` 類別的 iframe，並補上正確的 `loop` 與 `playlist` 參數。

### 取得並解析 iframe 的 src

程式碼先取得所有符合條件的 iframe，並將 `src` 中可能被轉譯的 `&` 轉回 `&`，確保 URL 正確解析。

“`javascript
const rawSrc = iframe.getAttribute(‘src’);
const src = rawSrc.replace(/&/g, ‘&’);
“`

### 取得影片 ID

透過字串切割方式，從 src 中擷取影片 ID，這是設定 playlist 參數的關鍵。

“`javascript
const videoId = src.split(‘/embed/’)[1]?.split(‘?’)[0];
“`

### 設定 loop 與 playlist 參數

利用 URL 物件操作，設定 `loop=1` 與 `playlist=影片ID`，並避免重複設定造成無限迴圈。

“`javascript
const url = new URL(src);
url.searchParams.set(‘loop’, ‘1’);
url.searchParams.set(‘playlist’, videoId);
const newSrc = url.toString();
if (newSrc !== src) iframe.setAttribute(‘src’, newSrc);
“`

## 實務應用與優化建議

– 此方法適合在頁面載入後或動態插入 iframe 後呼叫，確保所有影片都能正確設定循環播放。
– 透過多次延遲呼叫（setTimeout）處理 builder 或 lazy load 產生的 iframe。
– 若有大量 iframe，可考慮改用 MutationObserver 監控 DOM 變化，提高效能與即時性。

## 常見問題與坑點

– 直接在 iframe URL 加 `loop=1` 不加 `playlist`，影片不會循環。
– URL 中的 `&` 需先轉回 `&`，否則 URL 解析會錯誤。
– 避免重複設定 src，否則會造成 iframe 不斷重新載入。

## 完整程式碼

“`javascript
(function () {
function fixYouTubeLoop() {
document.querySelectorAll(‘iframe.youtube-loop’).forEach((iframe) => {
const rawSrc = iframe.getAttribute(‘src’);
if (!rawSrc) return;

// 你的 src 可能含有 &，先轉回正常的 &
const src = rawSrc.replace(/&/g, ‘&’);

if (!src.includes(‘youtube.com/embed/’)) return;

const videoId = src.split(‘/embed/’)[1]?.split(‘?’)[0];
if (!videoId) return;

const url = new URL(src);
url.searchParams.set(‘loop’, ‘1’);
url.searchParams.set(‘playlist’, videoId);

const newSrc = url.toString();

// 避免無限重設
if (newSrc !== src) iframe.setAttribute(‘src’, newSrc);
});
}

document.addEventListener(‘DOMContentLoaded’, fixYouTubeLoop);

// 若是 builder / lazy load 後面才插入 iframe，再補一次
setTimeout(fixYouTubeLoop, 800);
setTimeout(fixYouTubeLoop, 2000);
})();
“`

在多語網站開發中，使用 Polylang 外掛管理翻譯文章是一種常見做法。但當需要將大量文章從某一語言批次複製到另一語言時，手動操作效率低且容易出錯。這段程式碼提供一個獨立於特定文章類型的批次翻譯複製工具，適合有基礎 WordPress 與 Polylang 使用經驗的工程師或自學者，幫助快速複製文章並保持翻譯關聯。

## 工具功能與設計架構

### 1. 固定來源語言與多目標語言選擇

程式碼中定義常數 `IR_SOURCE_LANG` 為來源語言（此處固定為中文 zh），目標語言則可從下拉選單選擇（預設有英文 en、日文 ja），方便擴充其他語言。

### 2. 獨立後台介面

透過 `add_submenu_page` 將工具掛載於 WordPress 後台「工具」選單下，並提供兩種操作模式：

– 單筆測試：指定文章 ID，快速測試複製功能。
– 批次複製：依選定文章類型，批次複製該語言下所有文章。

### 3. 使用 Polylang 官方 API 確保語言設定與翻譯關聯

核心複製流程依序使用 `wp_insert_post` 建立新文章，`pll_set_post_language` 設定語言，最後用 `pll_save_post_translations` 儲存翻譯群組關聯，確保與 Polylang 外掛的正確整合。

## 核心複製流程解析

### Step 1: 確認來源文章與語言

先取得來源文章，確認文章類型與來源語言是否符合設定，避免誤複製。

“`php
ir_set_lang_official( $source_id, IR_SOURCE_LANG );
“`

這行確保來源文章語言正確。

### Step 2: 建立新文章

使用 `wp_insert_post` 複製文章標題、內容、狀態、作者、日期等基本欄位，確保新文章與原文一致。

### Step 3: 設定新文章語言

新文章建立後，設定為目標語言，保持語言一致性。

### Step 4: 儲存翻譯關聯

將新文章加入翻譯群組，讓 Polylang 知道這是原文的翻譯版本。

### Step 5: 複製分類法（Taxonomy）

複製原文文章所屬的分類與標籤，但排除語言相關的 taxonomy，避免衝突。

### Step 6: 複製特色圖片

如果原文有設定特色圖片，將同一張圖片設定給新文章，保持視覺一致性。

### Step 7: 複製 ACF 自訂欄位

利用 Advanced Custom Fields (ACF) 官方 API 安全複製所有自訂欄位，避免欄位名稱變動造成錯誤。

## 實務應用與優化建議

– **資料備份**：批次操作前務必備份資料庫，避免誤操作造成資料遺失。
– **語言擴充**：可依需求擴充 `$allowed_target_langs` 陣列，支援更多語言。
– **效能考量**：批次複製大量文章時，可能造成伺服器負擔，可分批執行或加入排程。
– **錯誤處理**：目前以回傳日誌方式呈現，可擴充為錯誤通知或記錄檔。

## 常見問題與注意事項

– 複製後的文章不會自動翻譯內容，僅複製原文內容，需後續人工或機器翻譯。
– Polylang API 函式必須存在，否則功能無法使用。
– ACF 複製需確保 ACF 外掛已啟用且函式存在。

## 完整程式碼

“`

Polylang API 不存在，請確認 Polylang 是否啟用。

‘;
return;
}

// 允許的目標語言（依照 Polylang 的 code）
$allowed_target_langs = [ ‘en’, ‘ja’ ];

// 可選 post types（public）
$post_types = get_post_types( [ ‘public’ => true ], ‘objects’ );

// 預設值
$current_post_type = isset( $_POST[‘ir_post_type’] ) ? sanitize_text_field( wp_unslash( $_POST[‘ir_post_type’] ) ) : ‘post’;
if ( ! isset( $post_types[ $current_post_type ] ) ) {
$current_post_type = ‘post’;
}

$current_target = isset( $_POST[‘ir_target_lang’] ) ? sanitize_text_field( wp_unslash( $_POST[‘ir_target_lang’] ) ) : ‘en’;
if ( ! in_array( $current_target, $allowed_target_langs, true ) ) {
$current_target = ‘en’;
}

echo ‘

通用翻譯複製工具（Polylang 官方流程）

‘;
echo ‘

來源語言固定為：' . esc_html( IR_SOURCE_LANG ) . '

‘;
echo ‘

⚠️ 執行前請先備份資料庫

‘;

echo ‘

‘;

/* =========================
* 單筆測試
* ========================= */
echo ‘

‘;

/* =========================
* 批次處理
* ========================= */
echo ‘

‘;

/* =========================
* 執行
* ========================= */
if ( isset( $_POST[‘ir_single_run’] ) ) {
check_admin_referer( ‘ir_single’ );

$post_id = isset( $_POST[‘ir_test_id’] ) ? absint( $_POST[‘ir_test_id’] ) : 0;
$target = $current_target;
$post_type = $current_post_type;

echo ‘

‘;
$log = ir_clone_post( $post_id, $target, $post_type );

echo ‘

' . esc_html( implode( "\n", $log ) ) . '

‘;
}

if ( isset( $_POST[‘ir_bulk_run’] ) ) {
check_admin_referer( ‘ir_bulk’ );

$target = $current_target;
$post_type = $current_post_type;

echo ‘

‘;

$posts = get_posts( [
‘post_type’ => $post_type,
‘posts_per_page’ => -1,
‘post_status’ => ‘any’,
‘lang’ => IR_SOURCE_LANG, // Polylang 的語言 query var
‘fields’ => ‘ids’,
] );

if ( empty( $posts ) ) {
echo ‘

找不到來源語言（’ . esc_html( IR_SOURCE_LANG ) . ‘）的文章。

‘;
} else {
$output = [];
foreach ( $posts as $id ) {
$output = array_merge( $output, ir_clone_post( $id, $target, $post_type ) );
}
echo ‘

' . esc_html( implode( "\n", $output ) ) . '

‘;
}
}

}

/* =========================
* 核心：複製一篇文章 → 目標語言翻譯
* ========================= */
function ir_clone_post( $source_id, $target_lang, $post_type ) {

$log = [];

if ( ! $source_id ) {
return [ ‘❌ 文章 ID 不可為 0’ ];
}

$src = get_post( $source_id );
if ( ! $src ) {
return [ “❌ 找不到文章 {$source_id}” ];
}

// 確保來源文章屬於選定的 post type（避免拿錯）
if ( $src->post_type !== $post_type ) {
return [ “❌ 文章 {$source_id} 的 post_type 是 {$src->post_type}，不是你選的 {$post_type}，已中止。” ];
}

// Step 1) 確保原文語言
ir_set_lang_official( $source_id, IR_SOURCE_LANG );
$log[] = “Step 1) 設定原文語言：{$source_id} → ” . IR_SOURCE_LANG;

// 取得翻譯群組
$translations = function_exists( ‘pll_get_post_translations’ )
? pll_get_post_translations( $source_id )
: [];

if ( empty( $translations[ IR_SOURCE_LANG ] ) ) {
$translations[ IR_SOURCE_LANG ] = $source_id;
}

// 已存在目標語言 → 跳過
if ( ! empty( $translations[ $target_lang ] ) ) {
$existing = (int) $translations[ $target_lang ];
$log[] = “⚠️ 已存在 {$target_lang} 翻譯（ID {$existing}），跳過。”;

// debug 狀態
if ( function_exists( ‘pll_get_post_language’ ) ) {
$lang_debug = [];
foreach ( $translations as $code => $pid ) {
$lang_debug[] = $code . ‘:’ . $pid . ‘(‘ . pll_get_post_language( $pid ) . ‘)’;
}
$log[] = ‘🧪 目前語言狀態：’ . implode( ‘, ‘, $lang_debug );
}

return $log;
}

// Step 2) 建立新文章
$new_id = wp_insert_post( [
‘post_type’ => $post_type,
‘post_status’ => $src->post_status,
‘post_title’ => $src->post_title,
‘post_content’ => $src->post_content,
‘post_excerpt’ => $src->post_excerpt,
‘post_author’ => $src->post_author,
‘post_date’ => $src->post_date,
‘post_date_gmt’ => $src->post_date_gmt,
‘menu_order’ => $src->menu_order,
‘post_parent’ => $src->post_parent,
], true );

if ( is_wp_error( $new_id ) ) {
$log[] = ‘❌ wp_insert_post 錯誤：’ . $new_id->get_error_message();
return $log;
}
$log[] = “Step 2) 建立新文章：{$new_id}”;

// Step 3) 設定新文章語言
ir_set_lang_official( $new_id, $target_lang );
$log[] = “Step 3) 設定新文章語言：{$new_id} → {$target_lang}”;

// Step 4) 儲存翻譯關聯
$translations[ $target_lang ] = $new_id;
pll_save_post_translations( $translations );
$log[] = ‘Step 4) 儲存翻譯關聯：’ . wp_json_encode( $translations );

// Step 5) 複製 taxonomy（排除語言 taxonomy）
$taxes = get_object_taxonomies( $post_type );
$taxes = array_diff( $taxes, [ ‘language’, ‘pll_language’ ] );

foreach ( $taxes as $tax ) {
$terms = wp_get_object_terms( $source_id, $tax, [ ‘fields’ => ‘ids’ ] );
if ( ! is_wp_error( $terms ) ) {
wp_set_object_terms( $new_id, $terms, $tax, false );
}
}
$log[] = ‘Step 5) Taxonomy 複製完成’;

// Step 6) 複製特色圖片
$thumb = get_post_thumbnail_id( $source_id );
if ( $thumb ) {
set_post_thumbnail( $new_id, $thumb );
$log[] = ‘Step 6) Featured Image 複製完成’;
} else {
$log[] = ‘Step 6) 原文沒有 Featured Image’;
}

// Step 7) 複製 ACF 全欄位（官方安全寫法）
if ( function_exists( ‘get_field_objects’ ) && function_exists( ‘update_field’ ) ) {
$fields = get_field_objects( $source_id );
$count = 0;

if ( $fields ) {
foreach ( $fields as $field ) {
// 用 field key 複製最穩（不怕改欄位 name）
update_field( $field[‘key’], $field[‘value’], $new_id );
$count++;
}
}

$log[] = “Step 7) ACF 全欄位複製完成（{$count} 個欄位）”;
} else {
$log[] = ‘Step 7) ACF API 不存在（get_field_objects / update_field），跳過 ACF 複製’;
}

// 最後：語言檢查
if ( function_exists( ‘pll_get_post_language’ ) ) {
$src_lang_real = pll_get_post_language( $source_id );
$new_lang_real = pll_get_post_language( $new_id );
$log[] = “🧪 實際語言檢查：原文 {$source_id} 語言：{$src_lang_real}；新文 {$new_id} 語言：{$new_lang_real}”;
}

$log[] = “✅ 完成：原文 {$source_id} → {$target_lang} 翻譯 {$new_id}”;
return $log;
}
“`

在 WooCommerce 後台商品列表中，管理者常需要快速取得商品的「加入購物車」連結以便分享或推廣。這段程式碼實作了在商品列表中新增一欄「複製課程連結」按鈕，點擊後可彈出視窗讓使用者輸入優惠券代碼，並將優惠券參數附加到連結中，最後將完整連結複製到剪貼簿。這對於需要快速產生帶優惠券的購物車連結的電商管理者非常實用。

## 新增自訂欄位顯示複製按鈕

利用 `manage_edit-product_columns` 過濾器新增一欄「複製課程連結」，並透過 `manage_product_posts_custom_column` 動作在該欄位輸出一個帶有商品加入購物車 URL 的按鈕。URL 是以網站首頁 URL 加上 `/cart/?add-to-cart=商品ID` 組成。

“`php
add_filter(‘manage_edit-product_columns’, ‘add_copy_link_column’);
function add_copy_link_column($columns) {
$columns[‘copy_add_to_cart’] = __(‘複製課程連結’, ‘woocommerce’);
return $columns;
}

add_action(‘manage_product_posts_custom_column’, ‘show_copy_link_column_content’, 10, 2);
function show_copy_link_column_content($column, $post_id) {
if ($column === ‘copy_add_to_cart’) {
$product_id = (int) $post_id;
$site_url = my_copy_cart_site_url();
$add_to_cart_url = $site_url . ‘/cart/?add-to-cart=’ . $product_id;
echo ‘複製‘;
}
}
“`

## 客製化 JavaScript 處理複製邏輯與優惠券輸入

在後台商品列表頁尾插入 JavaScript 和 CSS，當使用者點擊「複製」按鈕時：

1. 透過 `window.prompt` 詢問是否輸入優惠券代碼，可留空。
2. 根據輸入結果組合最終 URL，若有優惠券則加上 `&wt_coupon=優惠券代碼`。
3. 使用 Clipboard API 複製連結，若不支援則使用傳統 `execCommand` 備援。
4. 複製成功會顯示成功提示，失敗則顯示錯誤提示並提供手動複製。

“`js
function buildFinalUrl(baseUrl) {
var coupon = window.prompt(‘是否要加入優惠券？\n(可留空，直接按確定即可)’, ”);
if (coupon === null) return baseUrl;
coupon = String(coupon || ”).trim();
if (!coupon) return baseUrl;
var joiner = (baseUrl.indexOf(‘?’) === -1) ? ‘?’ : ‘&’;
return baseUrl + joiner + ‘wt_coupon=’ + encodeURIComponent(coupon);
}

$(document).on(‘click’, ‘.copy-cart-link’, function(e) {
e.preventDefault();
var button = $(this);
var baseUrl = button.data(‘url’);
var originalHtml = button.html();
if (button.hasClass(‘copying’)) return;
button.addClass(‘copying’);
var finalUrl = buildFinalUrl(baseUrl);
if (navigator.clipboard && window.isSecureContext) {
navigator.clipboard.writeText(finalUrl).then(function() {
showCopySuccess(button, originalHtml);
}).catch(function() {
fallbackCopyTextToClipboard(finalUrl, button, originalHtml);
});
} else {
fallbackCopyTextToClipboard(finalUrl, button, originalHtml);
}
});
“`

## 快速動作連結整合

除了欄位按鈕外，也在商品標題下方的快速動作連結加入「複製購物車連結」，提升操作便利性。此連結同樣帶有商品加入購物車的 URL，並套用相同的 JavaScript 行為。