1. Wordpress関連
  2. ページ／投稿
  3. WordPressの新規投稿タイプ２：ユーザーインターフェースの翻訳方法

WordPressの新規投稿タイプ２：ユーザーインターフェースの翻訳方法

記事カテゴリ: 
wordpress
関連タグ: 
posts
Google Plus One
シリーズ記事一覧: 
WordPressの新規投稿タイプ１：functions.phpファイルに定義する方法
WordPressの多言語翻訳１：POT,PO,MOファイルの理解と作成

やりたいこと：カスタム投稿タイプ（Custom Post Type）のUIを日本語化

カスタム投稿タイプUIの日本語翻訳ファイル（PO/MO）を作成します

  • Poeditで日本語翻訳ファイル（PO）を作成します
    msgid ""
msgstr ""
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"
"X-Generator: Poedit 2.0.3\n"
"Language: ja_JP\n"
"Project-Id-Version: \n"
"POT-Creation-Date: \n"
"PO-Revision-Date: \n"
"Last-Translator: \n"
"Language-Team: \n"

msgid "Products"
msgstr "製品投稿"

msgid "Product"
msgstr "製品"

msgid "Add New"
msgstr "新規作成"

msgid "Add New Product"
msgstr "新規製品作成"

msgid "Edit Product"
msgstr "製品編集"

msgid "New Product"
msgstr "新規製品"

msgid "All Products"
msgstr "全製品"

msgid "View Product"
msgstr "製品表示"

msgid "Search Products"
msgstr "製品検"

msgid "No products found"
msgstr "製品を見つからない"

msgid "No products found in the Trash"
msgstr "ゴミ箱から製品を見つからない"
  • 上記POファイルをPoeditでコンパイルしてMOファイルに変換します

翻訳ファイルの配置は：{所属しているテーマフォルダ内} or {WPの言語フォルダ内}

  • 翻訳ファイルは所属しているテーマのフォルダ内に配置することができます
    • 今回の例では twentyseventeen-child （twentyseventeenの子テーマ）
    • 翻訳ファイルの命名規則： {locale}.po、{locale}.mo
      • localeは日本語の場合： ja.po、ja.mo となります
    • テーマフィールドに「languages」フォルダを作成、その下に配置します
      所属テーマのフォルダに翻訳ファイルの配置
  • WPの言語フォルダに配置することもできます
    • WPの言語フォルダ：wp-content/languages
    • 翻訳ファイルの命名規則： {domain}-{locale}.po、{domain}-{locale}.mo
      • 今回の例のテキストドメイン（text domain）名： product
      • 翻訳ファイル名：product-ja.po、product-ja.mo
    • 翻訳ファイル名を変更して、WPの言語フォルダに配置します
      翻訳ファイルWPの言語フォルダに配置

カスタム投稿タイプ登録する前に作成した翻訳ファイルをロードします

  • WPの言語フォルダに配置する場合、翻訳フォイルのロード記述する必要はありません（自動ロードとなります）
  • 所属しているテーマのフォルダに配置する場合、翻訳ファイルをロードする記述は必要となります
    • カスタム投稿タイプ登録（functions.php）する前にロードが必要です
      // 翻訳ファイルをロード
load_theme_textdomain("product", get_stylesheet_directory() . '/languages');

// カスタム投稿タイプ登録
add_action( 'init', 'my_custom_post_product' );
    • 翻訳ファイルのディレクト取得関数：get_stylesheet_directory() なので、get_stylesheet_directory_url()ではありません（後者の場合、翻訳ファイルのロードはできません）。また、get_template_directory()関数の使用はできません（これは親テーマのディレクトリを取得する）
    • load_child_theme_textdomain()で翻訳ファイルのロードもできます


関連記事一覧

WordPressの新規投稿タイプ１：functions.phpファイルに定義する方法

WordPressの新しい投稿タイプの追加ができます

  • WordPressの初期設定では一つの投稿タイプがあります
    • フィールド追加したり、レイアウトなどの変更が可能です
  • 目的に合わせて複数の投稿タイプが必要とることがあります
    • 投稿タイプより、表示の分類ができます
    • 投稿タイプより、違うカスタムフィールド/カテゴリ/タグなど用意ができます
  • 新しい投稿タイプの作成方法が大体二種類あります
    • テーマフォルダにあるfunctions.phpに直接に定義します
    • プラグイン導入で新しい投稿タイプの作成

WordPressのテーマフォルダにあるfunctions.phpに直接に投稿タイプの定義

  • WordPressのカスタマイズなので、子テーマを作成して新規投稿タイプ追加したほうがよいでしょう
  • WordPressの本家の新規投稿タイプ定義説明を参考して、基本的な定義は比較的に簡単です 
    add_action( 'init', 'create_post_type' );
function create_post_type() {
  register_post_type( 'acme_product',
    array(
      'labels' => array(
        'name' => __( 'Products' ),
        'singular_name' => __( 'Product' )
      ),
      'public' => true,
      'has_archive' => true,
    )
  );
}
  • この例のように、新しい投稿タイプ「Products」を定義してみました 
    function my_custom_post_product() {
  $labels = array(
    'name'               => _x( 'Products', 'post type general name' ),
    'singular_name'      => _x( 'Product', 'post type singular name' ),
    'add_new'            => _x( 'Add New', 'book' ),
    'add_new_item'       => __( 'Add New Product' ),
    'edit_item'          => __( 'Edit Product' ),
    'new_item'           => __( 'New Product' ),
    'all_items'          => __( 'All Products' ),
    'view_item'          => __( 'View Product' ),
    'search_items'       => __( 'Search Products' ),
    'not_found'          => __( 'No products found' ),
    'not_found_in_trash' => __( 'No products found in the Trash' ), 
    'parent_item_colon'  => '',
    'menu_name'          => 'Products'
  );
  $args = array(
    'labels'        => $labels,
    'description'   => 'Holds our products and product specific data',
    'public'        => true,
    'menu_position' => 5,
    'supports'      => array( 'title', 'editor', 'thumbnail', 'excerpt', 'comments' ),
    'has_archive'   => true,
		'hierarchical'          => false,
		'show_ui'               => true,
		'show_in_menu'          => true,
		'menu_position'         => 5,
		'show_in_admin_bar'     => true,
		'show_in_nav_menus'     => true,
		'can_export'            => true,
		'has_archive'           => true,		
		'exclude_from_search'   => false,
		'publicly_queryable'    => true,
		'capability_type'       => 'page',
  );
  register_post_type( 'product', $args ); 
}
add_action( 'init', 'my_custom_post_product' );
  • この定義を子テーマのfunctions.phpにコピー/ペストします
  • テストサイトをリフレッシュして、管理メニューに「Products」投稿タイプが現れます
    WordPressに新しい投稿タイプ作成

WordPressの多言語翻訳１：POT,PO,MOファイルの理解と作成

WordPressのユーザーインターフェース言語翻訳はLocalization/Internationalizationと言います

  • Localizationはユーザーインターフェース言語翻訳以外にいろいろな意味があります
    • ローカル関連の日付表示
    • 通貨などの単位
  • Internationalizationは文字セットなどを管理しています
    • 読み順序（左から右、右から左）
    • 文言/書式など
  • Localizationの略： l10n
    • 英語の綴りの最初(l)から最後(n)までの間に１０文字があったので、"l10n"に簡略
  • Intanationalizationの略：i18n
    • 英語の綴りの最初（i）から最後（n）までの間に１８文字があったので、"i18n" に簡略

WordPressのユーザーインターフェース翻訳はGUNのgettext翻訳システムを採用しています

  • WordPressのユーザーインターフェース翻訳システムを開発していないので、GUNのgettext翻訳システムを採用しています
  • GUNのgettext翻訳システムは複数タイプのファイル（POT、PO、MO）があります
  • POT(Portable Object Template)： テキストファイル。基本言語（英語）文言が入っていますが、翻訳は空白です
    • msgid: 基本言語の文言（英語）。例： msgid: "test message"
    • msgstr: 翻訳文言（空白）。例：msgstr: ""
  • PO(Potable Object)：テキストファイル。一つ言語に一つのPOファイルが作成します
    • msgid: 基本言語の文言（英語）。例： msgid: "test message"
    • msgstr: 翻訳文言（日本語）。例：msgstr: "テストメッセージ"
  • MO（Machine Object）：バイナリファイル。POファイルからコンパイルして生成されます
    GUNのgettext翻訳システム紹介

POTファイル：テキストエディタで作成、PO/MOファイルがPoeditで作成（例）

  • POTファイルが開発ソースファイルにあるユーザーインターフェースの文言の集約です
    • 翻訳はそれぞれの国の人に任せて、POTファイルと関係ない
    • POTファイルがテキストエディタで作成されます
  • POファイルの作成/編集/コンパイルがいろいろな方法があります（gettextがオーペンソースなので、いろいろなフリーツールがあります）
    • ここでは、一般的によく利用されているPoeditを紹介します
  • POファイルがPoeditよりPOTファイルを読み込んで、変換し、翻訳文言を入力ます
    • 文字セットの決定（どこの国の文言に翻訳か）
    • 文言の翻訳をします（例：　msgid:"test message" => msgstr:"テストメッセージ"）
  • MOファイルがPoeditより翻訳した内容（POファイル）をコンパイルして、バイナリフォーマットとして保存します
    • テキストエディタで編集などはできません
    • テキスト文言変更の場合にPOファイルの翻訳文言を変更して、再度コンパイルします
    • テキスト文言の追加/削除/元文言変更はPOTファイル⇒POファイルまで

POTファイルが必須ではない（POファイルだけでもよい）

  • POTファイルが英文字通りに、ほかの言語への翻訳テンプレート（翻訳内容はない）
  • テキストエディタでPOファイル作成してもよいです
    • いくつかの定義をファイルの前に置きます 
      msgid ""
msgstr ""
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=ISO-8859-1\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
    • UTF－8フォーマットでファイル保存
  • 作成したPOファイルをPoeditで開く、編集して、保存するとMOファイルも自動的に作成されます
  • 複数の言語に翻訳しなければ、POファイルだけで十分です
    • 複数の言語に翻訳する場合、POTファイルがテンプレートとして利用されます

コメントを追加

関連記事

WordPressのプラグイン作成：カスタム投稿タイプの作成
WordPressの新規投稿タイプ１：functions.phpファイルに定義する方法
WordPressの関数（the_excerpt()）より投稿の抜粋表示および抜粋／ティーザー（Teaser）の概念
WordPressの投稿／固定ページにGoogleMap挿入の簡単方法：プラグイン（MapPress Easy Google Map）の導入
WordPressのプラグイン（Advanced Custom Fields）２：GoogleMapの挿入
WordPressの投稿／固定ページにGoogleMap挿入の簡単方法：GoogleMapのiframeコードの埋込
WordPressのカスタムフィールド追加とテンプレートタグ（the_meta）で値を表示
WordPressのプラグイン（Advanced Custom Fields）１：テキストフィールドの追加と表示
WordPressのフロントページ３：固定ページ＋投稿
WordPressの基本構成：ページ＋投稿、ページと投稿の区別