当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「プラグインとテーマの 2.1 への移行」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Migrating Plugins and Themes to 2.1 23:31, 24 Apr 2007 Ghidra99 の版)
 
(5 版)
 
(同じ利用者による、間の4版が非表示)
1行目: 1行目:
原文・最新版: [http://codex.wordpress.org/Migrating_Plugins_and_Themes_to_2.1 WordPress Codex &raquo; Migrating Plugins and Themes to 2.1]
+
<div id="Introduction">
 +
== はじめに ==
 +
</div>
  
==Introduction==
+
WordPress を[http://wordpress.org/development/2007/01/ella-21/ バージョン 2.1]へアップグレードするとき、そのままでは使えないテーマやプラグインがあるかもしれません。2.1 では抜本的な変更がなされたため、そのプラグイン・テーマは全く動作しない可能性もありますが、設定の更新やほんの少しの修正によって、使えるようにできるかもしれません。
  
When you upgrade WordPress to
+
他の誰かが開発したテーマやプラグインを使っているのなら、次のページに情報が載っています。
[http://wordpress.org/development/2007/01/ella-21/ Version 2.1], you may find that your Themes and Plugins no longer work the way you are used to. It could be that they are completely broken, because something in WordPress that was fundamental to them changed in Version 2.1, but it's also possible that you can get them working again by updating some settings, or maybe just a small edit.
+
* プラグイン・テーマの配布ページ
 +
* WordPress 2.1 [[:en:Plugins/Plugin_Compatibility/2.1|プラグイン互換性リスト]]
 +
* WordPress 2.1 [[:en:Themes/Theme_Compatibility/2.1|テーマ互換性リスト]]
  
If the Theme or Plugin you are using was developed by someone else, there are several places to look for information:
+
あなたがテーマ・プラグインの作者であるか、自分で変更・カスタマイズをした場合、以下に、2.1 対応にアップグレードするための情報があります。テーマ・プラグインを一般に配布している場合、動作するようになったら、2.1 で使えることや動作するバージョンをユーザが確認できるよう、上記互換性リストに追加するといいでしょう。
* Your Plugin or Theme's home page
+
* WordPress 2.1 [[Plugins/Plugin_Compatibility/2.1|Plugin Compatibility List]]
+
* WordPress 2.1 [[Themes/Theme_Compatibility/2.1|Theme Compatibility List]]
+
  
If you are the author of your Theme or Plugin, or if you have modified or customized your Theme, then this article will help you upgrade your Theme/Plugin for 2.1. If your Theme or Plugin is distributed publicly, after getting it working you may want to add it to the Compatibility lists above, so your users will know it is working and which version they should be running.
+
<div id="Fixing_Up_Your_Theme_or_Plugin">
 +
== テーマ・プラグインの修正 ==
 +
</div>
  
==Fixing Up Your Theme or Plugin==
+
テーマ・プラグインのアップグレードの第一歩は、WordPress 2.1 の変更点を理解することです。概要は [http://wordpress.org/development/2007/01/ella-21/ WordPress 開発ブログの バージョン2.1 リリース記事] に載っています(この和訳は[[#.E8.BF.BD.E5.8A.A0.E8.B3.87.E6.96.99|追加資料]]参照)。変更された機能をプラグイン・テーマが利用しているなら、変更点をさらに詳しく確認する必要があります。
  
The starting point for upgrading your Theme or Plugin is to understand the changes to WordPress in Version 2.1. There is an overview of the changes in the [http://wordpress.org/development/2007/01/ella-21/ WordPress Development Blog article on the release of Version 2.1]. If your plugin or theme was relying on a feature that has changed, you may need to re-think it completely.
+
<div id="Core_WordPress_Database_Changes">
 +
=== コア WordPress DB の変更点===
 +
</div>
  
===Core WordPress Database Changes===
+
WordPress 2.1 におけるとても重大な変更は、WordPress のデータベース構造です。2.1 での一番の変更は、リンク(ブログロール)と投稿記事のカテゴリが一つのテーブルに統合されたことです。そのため、プラグインの中で、リンク/記事カテゴリテーブルに関して何か行なっている場合、それを修正する必要があります。
  
One fairly significant change in WordPress Version 2.1 is the WordPress database structure. The main change is that in version 2.1, the categories for links (i.e. blogroll) and posts have been combined into one table. So, if your plugin does something special with the link or post category tables, you may need to modify it.
+
また、WordPress ユーザが以前のバージョンからアップグレードするとき、アップグレードスクリプトはブログロールカテゴリのデータを記事カテゴリテーブルにマージします。記事カテゴリとブログロールカテゴリは同じ ID になれない(一つのテーブル内で ID は一意となる)ので、ブログロールカテゴリの ID 番号は、アップデート中に新しい番号に付け替えられることになります。そのため、テーマやプラグインで、特定のブログロールカテゴリについて、その ID 番号で何か処理している場合は、その ID 番号を新しいものに直さなければなりません。新しい番号を知るには、WordPress 管理パネルのカテゴリセクションで一覧を見ます。
  
Also, when a user upgrades from a previous version, the upgrade script will take their blogroll categories and merge them into the post category table. Since you cannot now have a post category and a blogroll category with the same ID numbers, the result is that the blogroll category ID numbers will all change during the update. So, if you have a Theme or Plugin that does something special with a particular blogroll category, by knowing its ID number, you will need to change the ID number(s) cited in the Theme or Plugin to the new ID numbers. To see what the current numbers are, go to the Categories section of the Manage panel in WordPress, and they will be listed in the table there.
+
もう一つの DB の変更点は、"posts" テーブルに "post_type" という新しいフィールド(項目)ができたことです。プラグインの中で、投稿記事と WordPressページを識別するのに使えます。これは互換性の問題にはなりませんが、ロジックの改良として、プラグインを直すとよいでしょう。
  
Another database change is that the WordPress "posts" table now has a new field called "post_type", which you can use in your Plugin to distinguish better between Posts and Pages. This will not cause any compatibility problems, but you might want to use it in your Plugin to improve its logic.
+
* [[データベース概要|データベース概要(最新版)]]
 +
* [[:en:Database Description/2.0|データベース概要(2.0.x 版)]]
  
===Core WordPress File Changes===
+
<div id="Core_WordPress_File_Changes">
 +
=== コア WordPress ファイルの変更点 ===
 +
</div>
  
Many of the core WordPress files were either reorganized or had their names changed between Version 2.0.x and 2.1. For most Themes and Plugins, this is not a problem, but some Plugins that need access to a particular WordPress function may be loading a specific PHP file name, in order to make sure that that function is defined. If the function you are using is located in a new file now, you'll need to change the reference.
+
コア WordPress ファイルの多くは、再編成されたり、バージョン 2.0.x 2.1 とでファイル名が変わったりしました。ほとんどのテーマやプラグインでは問題にはなりませんが、特定の WordPress 関数へのアクセスが必要なプラグインでは、その関数が定義されていることを確認するために、具体的な PHP ファイル名をロードしているかもしれません。使用する関数が新しいファイルに置かれるようになった場合、参照先を変更する必要があります。
  
===Deprecated Functions and Variables===
+
訳注: ちなみに、この「ファイル再編成・リネーム」のため、2.0.x 系からのアップグレードは、従来のような上書きアップロードではなく、一部のファイルを除いて一旦削除した上でアップロードする必要があります。参照: [[WordPress のアップグレード]]
  
Some Plugins and Themes may be using functions and global variables that are "deprecated", which means that they were present in previous versions of WordPress, but are being phased out. They could be deleted in a future version of WordPress, without warning, and then your Plugin or Theme would stop working.
+
<div id="Deprecated_Functions_and_Variables">
 +
=== 非推奨となった関数・変数  ===
 +
</div>
  
So, It is a good idea to check your Themes and Plugins for these functions, and make a substitution. Here is a (hopefully complete) list of deprecated functions (including ones deprecated in previous versions of WordPress). Replacement suggestions are also included (if they are missing and you know what they should be, feel free to jump in and edit!):
+
プラグインやテーマの中で、WordPress の以前のバージョンに存在していたが今後廃止されていく「非推奨」な関数やグローバル変数を使っているかもしれません。これらは、WordPress の将来のバージョンで警告なしに削除される可能性があるので、プラグインやテーマの中で使うのを止めるようにしてください。
 +
 
 +
あなたのテーマとプラグインをチェックして、替わりのものに書き換えるのはいいことです。
 +
 
 +
非推奨な関数の(きっと完全な)一覧(過去バージョンで非推奨になっていたものも含む)。代替関数の提示付き(間違いがあったら遠慮なく編集して!):
 
* dropdown_cats
 
* dropdown_cats
 
* get_archives
 
* get_archives
47行目: 61行目:
 
* link_pages
 
* link_pages
 
* list_authors
 
* list_authors
* list_cats (use [[Template_Tags/wp_list_categories|wp_list_categories]])
+
* list_cats (use [[テンプレートタグ/wp_list_categories|wp_list_categories]])
* next_post (use [[Template_Tags/next_post_link|next_post_link]])
+
* next_post (use [[テンプレートタグ/next_post_link|next_post_link]])
* previous_post (use [[Template_Tags/previous_post_link|previous_post_link]])
+
* previous_post (use [[テンプレートタグ/previous_post_link|previous_post_link]])
 
* start_wp
 
* start_wp
 
* the_category_ID
 
* the_category_ID
65行目: 79行目:
 
* wp_get_linksbyname
 
* wp_get_linksbyname
 
* wp_get_post_cats
 
* wp_get_post_cats
* wp_list_cats (use [[Template_Tags/wp_list_categories|wp_list_categories]])
+
* wp_list_cats (use [[テンプレートタグ/wp_list_categories|wp_list_categories]])
 
* wp_set_post_cats
 
* wp_set_post_cats
  
Also, the following global variables are deprecated:
+
非推奨となったグローバル変数は次のとおり:
 
* $tableposts  (use $wpdb->posts)
 
* $tableposts  (use $wpdb->posts)
 
* $tableusers  (use $wpdb->users)
 
* $tableusers  (use $wpdb->users)
79行目: 93行目:
 
* $tablepostmeta (use $wpdb->postmeta)
 
* $tablepostmeta (use $wpdb->postmeta)
  
==Further Reading==
+
<div id="Further_Reading">
 +
== 追加資料 ==
 +
</div>
  
Here is a list of internal and external articles that may be of use in upgrading Themes or Plugins to Version 2.1 of WordPress:
+
テーマとプラグインを WordPress 2.1 対応にアップグレードするのに役立ちそうな記事のリスト:
 
* [http://wordpress.org/development/2007/01/ella-21/ WordPress Development Blog article on the release of Version 2.1]
 
* [http://wordpress.org/development/2007/01/ella-21/ WordPress Development Blog article on the release of Version 2.1]
* [[Version 2.1|WordPress Codex article on Version 2.1]]
+
* [[:en:Version 2.1|WordPress Codex article on Version 2.1]]
 
* [http://wordpress.org/development/2006/12/naughty-or-nice/ WordPress Blog article "Is Your Plugin Naughty or Nice"]
 
* [http://wordpress.org/development/2006/12/naughty-or-nice/ WordPress Blog article "Is Your Plugin Naughty or Nice"]
* [[Template Tags]] - list of Template Tags for using in Themes, including information on deprecated and new tags by WordPress version
+
* [[テンプレートタグ]] - テーマで使用するテンプレートタグの一覧。WordPress バージョンによる非推奨・新規タグ情報を含む。
 
* [http://lorelle.wordpress.com/2007/01/26/wordpress-21-template-tag-and-function-changes/ Lorelle's article on Template Tag updates for 2.1]
 
* [http://lorelle.wordpress.com/2007/01/26/wordpress-21-template-tag-and-function-changes/ Lorelle's article on Template Tag updates for 2.1]
 
* [http://lorelle.wordpress.com/2007/01/25/fear-not-wordpress-21-and-wordpress-plugins/ Lorelle's article on upgrading to 2.1]
 
* [http://lorelle.wordpress.com/2007/01/25/fear-not-wordpress-21-and-wordpress-plugins/ Lorelle's article on upgrading to 2.1]
 
* [http://lorelle.wordpress.com/2006/08/02/when-the-blog-breaks-fixing-your-broken-blog/ Lorelle's article on fixing a broken blog]
 
* [http://lorelle.wordpress.com/2006/08/02/when-the-blog-breaks-fixing-your-broken-blog/ Lorelle's article on fixing a broken blog]
* [http://markjaquith.wordpress.com/2007/01/28/authorization-and-intentionorigination-verification-when-using-the-edit_post-hook/ Mark Jaquith's article on Authorization and intention/origination verification when using the edit_post hook] - affects editing plugins that do special things with tags or other Custom Fields
+
* [http://markjaquith.wordpress.com/2007/01/28/authorization-and-intentionorigination-verification-when-using-the-edit_post-hook/ Mark Jaquith's article on Authorization and intention/origination verification when using the edit_post hook] - タグやカスタムフィールドで特別なことを行なうプラグインの作成への影響
 +
* [http://bono.s201.xrea.com/2007/01/327-wp_references21/ power source* » WP: WordPress 2.1 アップグレード用リンク集] -- 文章中やこのリストに登場する記事の和訳ページへのリンクもあり(後で転記予定)。
 +
 
 +
{{原文|Migrating Plugins and Themes to 2.1}}
  
 +
{{DEFAULTSORT:ふらくいんとてえまの2.1へのいこう}}
 +
[[Category:上級トピック]]
 +
[[Category:WordPress の開発]]
 +
[[Category:プラグイン]]
 +
[[Category:デザインとレイアウト]]
 +
[[Category:テンプレートタグ]]
 +
[[Category:wp2.1]]
  
[[Category:Advanced Topics]]
+
[[en:Migrating Plugins and Themes to 2.1]]
[[Category:WordPress Development]]
+
[[Category:Plugins]]
+
[[Category:New page created]]
+

2008年5月5日 (月) 16:06時点における最新版

WordPress をバージョン 2.1へアップグレードするとき、そのままでは使えないテーマやプラグインがあるかもしれません。2.1 では抜本的な変更がなされたため、そのプラグイン・テーマは全く動作しない可能性もありますが、設定の更新やほんの少しの修正によって、使えるようにできるかもしれません。

他の誰かが開発したテーマやプラグインを使っているのなら、次のページに情報が載っています。

あなたがテーマ・プラグインの作者であるか、自分で変更・カスタマイズをした場合、以下に、2.1 対応にアップグレードするための情報があります。テーマ・プラグインを一般に配布している場合、動作するようになったら、2.1 で使えることや動作するバージョンをユーザが確認できるよう、上記互換性リストに追加するといいでしょう。

テーマ・プラグインの修正

テーマ・プラグインのアップグレードの第一歩は、WordPress 2.1 の変更点を理解することです。概要は WordPress 開発ブログの バージョン2.1 リリース記事 に載っています(この和訳は追加資料参照)。変更された機能をプラグイン・テーマが利用しているなら、変更点をさらに詳しく確認する必要があります。

コア WordPress DB の変更点

WordPress 2.1 におけるとても重大な変更は、WordPress のデータベース構造です。2.1 での一番の変更は、リンク(ブログロール)と投稿記事のカテゴリが一つのテーブルに統合されたことです。そのため、プラグインの中で、リンク/記事カテゴリテーブルに関して何か行なっている場合、それを修正する必要があります。

また、WordPress ユーザが以前のバージョンからアップグレードするとき、アップグレードスクリプトはブログロールカテゴリのデータを記事カテゴリテーブルにマージします。記事カテゴリとブログロールカテゴリは同じ ID になれない(一つのテーブル内で ID は一意となる)ので、ブログロールカテゴリの ID 番号は、アップデート中に新しい番号に付け替えられることになります。そのため、テーマやプラグインで、特定のブログロールカテゴリについて、その ID 番号で何か処理している場合は、その ID 番号を新しいものに直さなければなりません。新しい番号を知るには、WordPress 管理パネルのカテゴリセクションで一覧を見ます。

もう一つの DB の変更点は、"posts" テーブルに "post_type" という新しいフィールド(項目)ができたことです。プラグインの中で、投稿記事と WordPressページを識別するのに使えます。これは互換性の問題にはなりませんが、ロジックの改良として、プラグインを直すとよいでしょう。

コア WordPress ファイルの変更点

コア WordPress ファイルの多くは、再編成されたり、バージョン 2.0.x と 2.1 とでファイル名が変わったりしました。ほとんどのテーマやプラグインでは問題にはなりませんが、特定の WordPress 関数へのアクセスが必要なプラグインでは、その関数が定義されていることを確認するために、具体的な PHP ファイル名をロードしているかもしれません。使用する関数が新しいファイルに置かれるようになった場合、参照先を変更する必要があります。

訳注: ちなみに、この「ファイル再編成・リネーム」のため、2.0.x 系からのアップグレードは、従来のような上書きアップロードではなく、一部のファイルを除いて一旦削除した上でアップロードする必要があります。参照: WordPress のアップグレード

非推奨となった関数・変数

プラグインやテーマの中で、WordPress の以前のバージョンに存在していたが今後廃止されていく「非推奨」な関数やグローバル変数を使っているかもしれません。これらは、WordPress の将来のバージョンで警告なしに削除される可能性があるので、プラグインやテーマの中で使うのを止めるようにしてください。

あなたのテーマとプラグインをチェックして、替わりのものに書き換えるのはいいことです。

非推奨な関数の(きっと完全な)一覧(過去バージョンで非推奨になっていたものも含む)。代替関数の提示付き(間違いがあったら遠慮なく編集して!):

  • dropdown_cats
  • get_archives
  • get_author_link (use get_author_posts_url)
  • get_autotoggle
  • get_linkobjects (use get_linkz)
  • get_linkobjectsbyname (use get_linkz)
  • get_linkswithrating
  • get_linksbyname
  • get_linksbyname_withrating
  • get_postdata (use get_post)
  • get_settings (use get_option as direct replacement)
  • link_pages
  • list_authors
  • list_cats (use wp_list_categories)
  • next_post (use next_post_link)
  • previous_post (use previous_post_link)
  • start_wp
  • the_category_ID
  • the_category_head
  • tinymce_include (use wp_print_scripts or WP_Scripts)
  • user_can_create_draft (use current_user_can)
  • user_can_create_post (use current_user_can)
  • user_can_delete_post (use current_user_can)
  • user_can_delete_post_comments (use current_user_can)
  • user_can_edit_post (use current_user_can)
  • user_can_edit_post_comments (use current_user_can)
  • user_can_edit_post_date (use current_user_can)
  • user_can_edit_user (use current_user_can)
  • user_can_set_post_date (use current_user_can)
  • wp_get_linksbyname
  • wp_get_post_cats
  • wp_list_cats (use wp_list_categories)
  • wp_set_post_cats

非推奨となったグローバル変数は次のとおり:

  • $tableposts (use $wpdb->posts)
  • $tableusers (use $wpdb->users)
  • $tablecategories (use $wpdb->categories)
  • $tablepost2cat (use $wpdb->post2cat)
  • $tablecomments (use $wpdb->comments)
  • $tablelinks (use $wpdb->links)
  • $tablelinkcategories (does not exist - all categories are in the main categories table now, and there is not a separate link categories table)
  • $tableoptions (use $wpdb->options)
  • $tablepostmeta (use $wpdb->postmeta)

追加資料

テーマとプラグインを WordPress 2.1 対応にアップグレードするのに役立ちそうな記事のリスト:

最新英語版: WordPress Codex » Migrating Plugins and Themes to 2.1