고급WP-CLI 명령어
WP-CLI 명령어
다음 WP-CLI 명령어를 사용하여 커스텀 게시물, 분류 텀(태그 및 카테고리), 미디어 항목, 메뉴, 사용자를 번역할 수 있습니다.
WP-CLI 명령어는 기본적으로 로그인된 사용자 없이 실행됩니다. 번역 항목을 생성하기 위한 적절한 권한을 갖추려면 --user 옵션을 사용하여 사용자 컨텍스트와 함께 명령어를 실행해야 합니다:
wp gatotranslate post 123 --user=adminwp gatotranslate post
커스텀 게시물(게시물, 페이지, 커스텀 게시물 유형)을 번역합니다.
사용법
wp gatotranslate post <ids> [options]매개변수
| 매개변수 | 설명 |
|---|---|
<ids> | 쉼표 또는 공백으로 구분하여 번역할 게시물 ID 목록 |
옵션
옵션을 지정하지 않으면 플러그인 설정의 값이 사용됩니다.
| 옵션 | 설명 | 가능한 값 |
|---|---|---|
--translate-slugs=<bool> | 슬러그를 번역할지 여부 | true, false |
--default-provider=<provider> | 기본 번역 공급자 | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--status-to-update=<status> | 업데이트 대상이 될 게시물의 상태 | draft, pending, publish, private, future, any |
--status-when-translated=<status> | 번역 후 게시물이 가질 상태 | draft, pending, publish, private, current(상태 변경 안 함), same-as-origin(원본 게시물의 상태를 복사) |
--copy-date=<bool> | 원본 게시물의 날짜를 복사할지 여부 | true, false |
--language-providers=<providers> | 언어 공급자 매핑의 JSON 문자열 | 언어 코드를 키로, 공급자 이름이나 "none"(해당 언어 비활성화) 또는 "default"(기본 공급자 사용)를 값으로 하는 JSON 문자열 |
--tasks=<tasks> | 실행할 작업의 쉼표로 구분된 목록 | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | 수정할 콘텐츠 부분의 쉼표로 구분된 목록 | properties(제목, 슬러그, 발췌문), content(게시물 본문), meta(커스텀 필드) |
--porcelain | 스크립트 파싱에 적합한 필수 정보만 출력 | 값 불필요(플래그) |
--fail-if-log-notifications | 실행 중 로그 알림이 추가되면 실패 처리 | 값 불필요(플래그) |
--process-failed | 실패한 번역만 처리 | 값 불필요(플래그) |
예시
# Translate post with ID 123
wp gatotranslate post 123 --user=admin
# Translate posts with IDs 123, 456, and 789
wp gatotranslate post 123,456,789 --user=admin
# Translate posts with IDs 123 and 456
wp gatotranslate post "123 456" --user=admin
# Translate post replicating the status and date of the original post
wp gatotranslate post 123 --user=admin --status-when-translated=same-as-origin --copy-date=true
# Translate post using ChatGPT as default provider
wp gatotranslate post 123 --user=admin --default-provider=chatgpt
# Translate post with a specific provider for each language
wp gatotranslate post 123 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate post disabling a specific language
wp gatotranslate post 123 --user=admin --language-providers='{"de":"none"}'
# Translate only post properties (title, slug, and excerpt)
wp gatotranslate post 123 --user=admin --parts=properties
# Translate only post content and meta
wp gatotranslate post 123 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate post 123 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed posts/languages only
wp gatotranslate post "123 456" --user=admin --process-failedwp gatotranslate term
분류 텀(카테고리, 태그, 커스텀 분류)을 번역합니다.
사용법
wp gatotranslate term <ids> [options]매개변수
| 매개변수 | 설명 |
|---|---|
<ids> | 쉼표 또는 공백으로 구분하여 번역할 텀 ID 목록 |
옵션
| 옵션 | 설명 | 가능한 값 |
|---|---|---|
--translate-slugs=<bool> | 슬러그를 번역할지 여부 | true, false |
--default-provider=<provider> | 기본 번역 공급자 | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | 언어 공급자 매핑의 JSON 문자열 | 언어 코드를 키로, 공급자 이름이나 "none"(해당 언어 비활성화) 또는 "default"(기본 공급자 사용)를 값으로 하는 JSON 문자열 |
--tasks=<tasks> | 실행할 작업의 쉼표로 구분된 목록 | translate-content, translate-entity-relationships |
--parts=<parts> | 수정할 콘텐츠 부분의 쉼표로 구분된 목록 | properties(이름, 슬러그), content(설명), meta(커스텀 필드) |
--porcelain | 스크립트 파싱에 적합한 필수 정보만 출력 | 값 불필요(플래그) |
--fail-if-log-notifications | 실행 중 로그 알림이 추가되면 실패 처리 | 값 불필요(플래그) |
--process-failed | 실패한 번역만 처리 | 값 불필요(플래그) |
예시
# Translate term with ID 1
wp gatotranslate term 1 --user=admin
# Translate terms with IDs 1, 2, and 3
wp gatotranslate term 1,2,3 --user=admin
# Translate term 1 disabling slug translation, and using OpenRouter as default provider
wp gatotranslate term 1 --user=admin --translate-slugs=false --default-provider=openrouterr
# Translate term 1 with a specific provider for each language
wp gatotranslate term 1 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling a specific language
wp gatotranslate term 1 --user=admin --language-providers='{"de":"none"}'
# Translate only term name and slug
wp gatotranslate term 1 --user=admin --parts=properties
# Translate only term description and meta
wp gatotranslate term 1 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate term 1 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed terms/languages only
wp gatotranslate term 1,2,3 --user=admin --process-failedwp gatotranslate media
미디어 항목(첨부 파일)을 번역합니다.
사용법
wp gatotranslate media <ids> [options]매개변수
| 매개변수 | 설명 |
|---|---|
<ids> | 쉼표 또는 공백으로 구분하여 번역할 미디어 ID 목록 |
옵션
| 옵션 | 설명 | 가능한 값 |
|---|---|---|
--translate-slugs=<bool> | 슬러그를 번역할지 여부 | true, false |
--default-provider=<provider> | 기본 번역 공급자 | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | 언어 공급자 매핑의 JSON 문자열 | 언어 코드를 키로, 공급자 이름이나 "none"(해당 언어 비활성화) 또는 "default"(기본 공급자 사용)를 값으로 하는 JSON 문자열 |
--tasks=<tasks> | 실행할 작업의 쉼표로 구분된 목록 | translate-content, translate-entity-relationships, replace-internal-links |
--parts=<parts> | 수정할 콘텐츠 부분의 쉼표로 구분된 목록 | properties(제목, 슬러그), content(대체 텍스트, 캡션, 설명), meta(커스텀 필드) |
--porcelain | 스크립트 파싱에 적합한 필수 정보만 출력 | 값 불필요(플래그) |
--fail-if-log-notifications | 실행 중 로그 알림이 추가되면 실패 처리 | 값 불필요(플래그) |
--process-failed | 실패한 번역만 처리 | 값 불필요(플래그) |
예시
# Translate media item with ID 10
wp gatotranslate media 10 --user=admin
# Translate media items with IDs 10, 11, 12
wp gatotranslate media 10,11,12 --user=admin
# Translate media item with a specific provider for each language
wp gatotranslate media 10 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling specific languages
wp gatotranslate media 10 --user=admin --language-providers='{"de":"none","zh":"none"}'
# Translate only media title and slug
wp gatotranslate media 10 --user=admin --parts=properties
# Translate only media content (alt text, caption, and description) and meta
wp gatotranslate media 10 --user=admin --parts=content,meta
# Only update the entity relationships for the target language
wp gatotranslate media 10 --user=admin --tasks=translate-entity-relationships
# Re-run translations for previously failed media items/languages only
wp gatotranslate media 10,11,12 --user=admin --process-failedwp gatotranslate menu
메뉴를 번역합니다.
원본 언어의 메뉴만 번역됩니다. Polylang은 메뉴의 언어 정보를 저장하지 않으므로, 이 정보는 할당된 메뉴 위치로부터 판별됩니다.
메뉴의 번역은 다음 조건을 모두 충족하는 경우에만 실행됩니다:
- 메뉴에 이미 최소 하나의 위치가 할당되어 있음
- 해당 위치 중 어느 것도 번역 언어용이 아님
사용법
wp gatotranslate menu <ids> [options]매개변수
| 매개변수 | 설명 |
|---|---|
<ids> | 쉼표 또는 공백으로 구분하여 번역할 메뉴 ID 목록 |
옵션
| 옵션 | 설명 | 가능한 값 |
|---|---|---|
--default-provider=<provider> | 기본 번역 공급자 | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | 언어 공급자 매핑의 JSON 문자열 | 언어 코드를 키로, 공급자 이름이나 "none"(해당 언어 비활성화) 또는 "default"(기본 공급자 사용)를 값으로 하는 JSON 문자열 |
--porcelain | 스크립트 파싱에 적합한 필수 정보만 출력 | 값 불필요(플래그) |
--fail-if-log-notifications | 실행 중 로그 알림이 추가되면 실패 처리 | 값 불필요(플래그) |
예시
# Translate menu with ID 5
wp gatotranslate menu 5 --user=admin
# Translate menus with IDs 5, 6, and 7
wp gatotranslate menu 5,6,7 --user=admin
# Translate menu with a specific provider for each language
wp gatotranslate menu 5 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate disabling specific languages
wp gatotranslate menu 5 --user=admin --language-providers='{"de":"none","zh":"none"}'wp gatotranslate user
사용자 설명을 번역합니다.
사용법
wp gatotranslate user <ids> [options]매개변수
| 매개변수 | 설명 |
|---|---|
<ids> | 쉼표 또는 공백으로 구분하여 번역할 사용자 ID 목록 |
옵션
| 옵션 | 설명 | 가능한 값 |
|---|---|---|
--default-provider=<provider> | 기본 번역 공급자 | chatgpt, claude, deepl, gemini, google_translate, deepseek, mistral, openrouter, self_hosted_llm |
--language-providers=<providers> | 언어 공급자 매핑의 JSON 문자열 | 언어 코드를 키로, 공급자 이름이나 "none"(해당 언어 비활성화) 또는 "default"(기본 공급자 사용)를 값으로 하는 JSON 문자열 |
--porcelain | 스크립트 파싱에 적합한 필수 정보만 출력 | 값 불필요(플래그) |
--fail-if-log-notifications | 실행 중 로그 알림이 추가되면 실패 처리 | 값 불필요(플래그) |
예시
# Translate user with ID 1
wp gatotranslate user 1 --user=admin
# Translate users with IDs 1, 2, and 3
wp gatotranslate user 1,2,3 --user=admin
# Translate users with IDs 1 and 2
wp gatotranslate user "1 2" --user=admin
# Translate user using ChatGPT as default provider
wp gatotranslate user 1 --user=admin --default-provider=chatgpt
# Translate user with a specific provider for each language
wp gatotranslate user 1 --user=admin --language-providers='{"es":"chatgpt","fr":"deepl"}'
# Translate user disabling a specific language
wp gatotranslate user 1 --user=admin --language-providers='{"de":"none"}'Prev
Next