• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Migrating Plugins and Themes to 2.1 23:31, 24 Apr 2007 Ghidra99 の版)
 
(一部和訳)
1行目: 1行目:
原文・最新版: [http://codex.wordpress.org/Migrating_Plugins_and_Themes_to_2.1 WordPress Codex » Migrating Plugins and Themes to 2.1]
+
原文・最新版: [[:en:Migrating Plugins and Themes to 2.1|WordPress Codex » Migrating Plugins and Themes to 2.1]]
  
==Introduction==
+
== はじめに ==
 +
(Introduction)
  
When you upgrade WordPress to
+
WordPress [http://wordpress.org/development/2007/01/ella-21/ バージョン 2.1]へアップグレードするとき、そのままでは使えないテーマやプラグインがあるかもしれません。2.1 では抜本的な変更がなされたため、そのプラグイン・テーマは全く動作しない可能性もありますが、設定の更新やほんの少しの修正によって、使えるようにできるかもしれません。
[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. 
+
  
If the Theme or Plugin you are using was developed by someone else, there are several places to look for information:
+
他の誰かが開発したテーマやプラグインを使っているのなら、次のページに情報が載っています。
* Your Plugin or Theme's home page
+
* プラグイン・テーマの配布ページ
* WordPress 2.1 [[Plugins/Plugin_Compatibility/2.1|Plugin Compatibility List]]
+
* WordPress 2.1 [[Plugins/Plugin_Compatibility/2.1|プラグイン互換性リスト]]
* WordPress 2.1 [[Themes/Theme_Compatibility/2.1|Theme Compatibility List]]
+
* WordPress 2.1 [[Themes/Theme_Compatibility/2.1|テーマ互換性リスト]]
  
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.
+
あなたがテーマ・プラグインの作者であるか、自分で変更・カスタマイズをした場合、以下に、2.1 対応にアップグレードするための情報があります。テーマ・プラグインを一般に配布している場合、動作するようになったら、2.1 で使えることや動作するバージョンをユーザが確認できるよう、上記互換性リストに追加するといいでしょう。
  
==Fixing Up Your Theme or Plugin==
+
== テーマ・プラグインの修正 ==
 +
(Fixing Up Your Theme or Plugin)
  
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.  
+
テーマ・プラグインのアップグレードの第一歩は、WordPress 2.1 の変更点を理解することです。概要は [http://wordpress.org/development/2007/01/ella-21/ WordPress Development Blog article on the release of Version 2.1] に載っています(この和訳は[[#.E8.BF.BD.E5.8A.A0.E8.B3.87.E6.96.99|追加資料]]参照)。変更された機能をプラグイン・テーマが利用しているなら、変更点をさらに詳しく確認する必要があります。
  
===Core WordPress Database Changes===
+
=== コア WordPress DB の変更点===
 +
(Core WordPress Database Changes)
  
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 2.1 におけるとても重大な変更は、WordPress のデータベース構造です。2.1 での一番の変更は、リンク(ブログロール)と投稿記事のカテゴリが一つのテーブルに統合されたことです。そのため、プラグインの中で、リンク/記事カテゴリテーブルに関して何か行なっている場合、それを修正する必要があります。
  
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.
+
また、WordPress ユーザが以前のバージョンからアップグレードするとき、アップグレードスクリプトはブログロールカテゴリのデータを記事カテゴリテーブルにマージします。記事カテゴリとブログロールカテゴリは同じ ID になれない(一つのテーブル内で ID は一意となる)ので、ブログロールカテゴリの ID 番号は、アップデート中に新しい番号に付け替えられることになります。そのため、テーマやプラグインで、特定のブログロールカテゴリについて、その ID 番号で何か処理している場合は、その ID 番号を新しいものに直さなければなりません。新しい番号を知るには、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.
+
もう一つの DB の変更点は、"posts" テーブルに "post_type" という新しいフィールド(項目)ができたことです。プラグインの中で、投稿記事と WordPressページを識別するのに使えます。これは互換性の問題にはなりませんが、ロジックの改良として、プラグインを直すとよいでしょう。
  
===Core WordPress File Changes===
+
=== コア WordPress ファイルの変更点 ===
 +
(Core WordPress File Changes)
  
 
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.  
 
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.  
  
===Deprecated Functions and Variables===
+
=== 非推奨となった関数・変数  ===
 +
(Deprecated Functions and Variables)
  
 
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.
 
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.
47行目: 51行目:
 
* 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行目: 69行目:
 
* 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行目: 83行目:
 
* $tablepostmeta (use $wpdb->postmeta)
 
* $tablepostmeta (use $wpdb->postmeta)
  
==Further Reading==
+
== 追加資料 ==
 +
(Further Reading)
  
 
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:
 
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:
90行目: 95行目:
 
* [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] - affects editing plugins that do special things with tags or other Custom Fields
 +
* [http://bono.s201.xrea.com/2007/01/327-wp_references21/ power source* » WP: WordPress 2.1 アップグレード用リンク集] -- 文章中やこのリストに登場する記事の和訳ページへのリンクもあり(後で転記予定)。
  
 
+
{{DEFAULTSORT:ふらくいんとてえまの2.1へのいこう}}
[[Category:Advanced Topics]]
+
[[Category:上級トピック]]
[[Category:WordPress Development]]
+
[[Category:WordPress の開発]]
[[Category:Plugins]]
+
[[Category:プラグイン]]
 
[[Category:New page created]]
 
[[Category:New page created]]

2007年7月6日 (金) 20:27時点における版

原文・最新版: WordPress Codex » Migrating Plugins and Themes to 2.1

はじめに

(Introduction)

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

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

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

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

(Fixing Up Your Theme or Plugin)

テーマ・プラグインのアップグレードの第一歩は、WordPress 2.1 の変更点を理解することです。概要は WordPress Development Blog article on the release of Version 2.1 に載っています(この和訳は追加資料参照)。変更された機能をプラグイン・テーマが利用しているなら、変更点をさらに詳しく確認する必要があります。

コア WordPress DB の変更点

(Core WordPress Database Changes)

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

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

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

コア WordPress ファイルの変更点

(Core WordPress File Changes)

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.

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

(Deprecated Functions and Variables)

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.

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!):

  • 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)

追加資料

(Further Reading)

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: