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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Migrating Plugins and Themes 2008年2月16日 (土) 01:30 Jeremyclarke 版/著者: JHodgdon, Jeremyclarke)
 
(半端に和訳/Canonical URL の訳語は要検討)
1行目: 1行目:
==Introduction==
+
<div id="Introduction">
 +
== はじめに ==
 +
</div>
  
When you upgrade WordPress from one major version to another, such as from 2.1 to 2.2, 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, 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 から 2.2 へ、といった、あるバージョンから別のメジャーバージョンへアップグレードするとき、そのままでは使えないテーマやプラグインがあるかもしれません。メジャーアップグレードでは WordPress に抜本的な変更がなされることがあるため、プラグインやテーマが全く動作しない可能性もありますが、設定の更新やほんの少しの修正によって、使えるようにできるかもしれません。
  
This article has some hints on how to upgrade plugins and themes from one version to another, below. There is also a special article on [[Migrating Plugins and Themes to 2.1]], which covers changes between WordPress 2.0 and WordPress 2.1, as well as a much older article, [[Upgrade 1.2 to 1.5]], which covers how to convert a really old Theme to the current theming system.
+
このページは、プラグインやテーマを WordPress のメジャーアップグレードに対応させる方法の手引きです。<!-- 項目として独立:There is also a special article on [[Migrating Plugins and Themes to 2.1]], which covers changes between WordPress 2.0 and WordPress 2.1, as well as a much older article, [[Upgrade 1.2 to 1.5]], which covers how to convert a really old Theme to the current theming system. -->
  
==Migrating from 2.1 to 2.2==
+
== 1.2 から 1.5 への移行 ==
  
The main change of importance to Plugins and Themes in [[Version 2.2]] was the introduction of WordPress Widgets as part of the core of WordPress. (Widgets are small pieces of WordPress output, such as category lists, archive lists, and search forms, which you can put into the sidebar(s) of your blog.)
+
[[:en:Upgrade 1.2 to 1.5|1.2 から 1.5 へのアップグレード]] をご覧ください。古いテーマから現在のテーマシステムへの変換方法などを説明しています。
  
If you want to use Widgets in a Theme that was developed prior to WordPress 2.2, you can find out how to fix your theme in [http://automattic.com/code/widgets/themes/ this article on Widgetizing Themes].
+
== 2.0.x から 2.1 への移行 ==
 +
 
 +
[[プラグインとテーマの 2.1 への移行]] をご覧ください。
 +
 
 +
<div id="Migrating_from_2.1_to_2.2">
 +
== 2.1 から 2.2 への移行 ==
 +
</div>
 +
 
 +
[[Version 2.2|バージョン 2.2]] におけるプラグインとテーマにとっての主要な変更点は、WordPress ウィジェットが WordPress のコア(本体)に組み込まれたことです。(ウィジェットとは、カテゴリリストやアーカイブリスト・検索フォームといった WordPress の出力要素を、簡単にブログのサイドバーに配置できるようにするものです。従来はプラグインとして提供されていました。)
 +
 
 +
WordPress 2.2 より前に開発されたテーマでウィジェットを使えるようにするには、[http://automattic.com/code/widgets/themes/ テーマのウィジェット対応についてのこの記事]でテーマの修正方法をご覧ください。
  
 
If you want some output that your Plugin generates to be displayed in a sidebar Widget, you can find out how in [http://automattic.com/code/widgets/plugins/ this article on Widgetizing Plugins], and you may also find the [http://automattic.com/code/widgets/api/ Widgets API] article useful.
 
If you want some output that your Plugin generates to be displayed in a sidebar Widget, you can find out how in [http://automattic.com/code/widgets/plugins/ this article on Widgetizing Plugins], and you may also find the [http://automattic.com/code/widgets/api/ Widgets API] article useful.
 +
プラグインでサイドバーウィジェットへの表示を生成する方法は、[http://automattic.com/code/widgets/plugins/ プラグインのウィジェット対応のこの記事]をご覧ください。[http://automattic.com/code/widgets/api/ Widgets API] も役立ちます。
  
==Migrating from 2.2 to 2.3==
+
<div id="Migrating_from_2.2_to_2.3">
 +
== 2.2 から 2.3 への移行 ==
 +
</div>
  
===Categories and Tags===
+
<div id="Categories_and_Tags">
The main change of importance to Plugins and Themes in [[Version 2.3]] was the introduction of tagging as a core WordPress functionality.
+
=== カテゴリとタグ ===
 +
</div>
 +
[[Version 2.3|バージョン 2.3]] におけるプラグインとテーマにとっての主要な変更点は、WordPress 本体の機能として[[タグ付け機能|タグ付け]]が組み込まれたことです。
  
If you want to add tags to your theme (e.g. to display the tags used on a post, or put a tag cloud into your sidebar), you will be interested in new [[Template_Tags/the_tags|the_tags]] and [[Template_Tags/wp_tag_cloud|wp_tag_cloud]] template tag functions.
+
テーマにタグを追加(例:記事に付けられているタグの表示、サイドバーへのタグクラウドの表示)するには、新しいテンプレートタグ [[テンプレートタグ/the_tags|the_tags]] [[テンプレートタグ/wp_tag_cloud|wp_tag_cloud]] を用います。
  
 
There were also quite a few new tag-related functions for use in plugins introduced in WordPress 2.3.  
 
There were also quite a few new tag-related functions for use in plugins introduced in WordPress 2.3.  
  
Also, as a side effect of introducing tags to WordPress, the underlying database table structure, in regards to storage of categories, was changed considerably. So, any plugins that ran queries using the category-related tables in the WordPress database will likely be broken; the queries will have to be completely rewritten. Plugins and Themes that used WordPress functions to access categories should be OK.
+
また、WordPress にタグを導入する副作用として、カテゴリ情報の格納に関して、基盤である[[データベース概要|データベース・テーブル構造]]が大幅に変更されました。したがって、WordPress データベースのカテゴリ関係のテーブルを使うクエリを実行するプラグインは、おそらく使えなくなってしまい、クエリを全面的に書き換えなければなりません。カテゴリへのアクセスに WordPress 関数を利用しているプラグイン・テーマであれば、大丈夫なはずです。
  
===Canonical URLs===
+
<div id="Canonical_URLs">
Another change in 2.3 that affects some plugins is the introduction of "canonical" URLs. The canonical URL system basically rewrites all URLs used in WordPress into "canonical" form, so that there is only one URL that points to a given display, and other URLs that could also point to that display are redirected to the "canonical" URL. Most plugins will not be affected by this change, but a plugin that adds suffixes to URLs could find that some of the URLs it generates are broken. Notably, a URL with a page number in it, such as example.com/page/2/ (to access the second page of older posts) ''must'' have the page section at the end of the URL. Prior versions of WordPress would have allowed example.com/page/2/suffix/ to work, but in WordPress 2.3, the URL must be generated as example.com/suffix/page/2 in order to function correctly.
+
=== Canonical URL ===
 +
</div><!-- "Canonical URL" の訳語は要検討。-->
 +
プラグインに影響する 2.3 のもう一つの変更点は、「canonical(カノニカル)」URL の導入です。The canonical URL system basically rewrites all URLs used in WordPress into "canonical" form, so that there is only one URL that points to a given display, and other URLs that could also point to that display are redirected to the "canonical" URL.(カノニカル URL システムは、与えられた表示(ページ)を指し示す URL を一つだけとするために、WordPress で使われる全ての URL を原則として「カノニカル」形式に書き換え、その表示を指す他の URL は「カノニカル」URL へリダイレクトします?) ほとんどのプラグインはこの変更による影響を受けませんが、a plugin that adds suffixes to URLs could find that some of the URLs it generates are broken.(~~~ URL に接尾辞(suffix)を加えるようなプラグインは使えなくなります。) 特に、<code>example.com/page/2/</code>(過去記事の2ページ目にアクセス)のようにページ番号が付く URL は、'''必ず''' URL の末尾にページセクションが必要です。WordPress の従来のバージョンでは <code>example.com/page/2/suffix/</code> は動作できましたが、WordPress 2.3 では、正しく機能させるために URL を <code>example.com/suffix/page/2</code> と生成しなければなりません。
  
Note that if you use a non-standard url/permalink structure that is necessary for the functioning of your site, the "canonical url" functionality can be turned off by adding the following to a plugin file or the functions.php file in your template folder:
+
留意: あなたのサイトを機能させるために、一般的でない URL/パーマリンク構造を使う必要がある場合は、「カノニカル URL」機能をオフにできます。プラグインファイル または テーマディレクトリ内の `function.php` に次の 1行を加えてください。
 
  remove_filter('template_redirect', 'redirect_canonical');
 
  remove_filter('template_redirect', 'redirect_canonical');
 
WordPress 2.5 will make a further filter available for choosing which canonical redirects are denied rather than forcing them to be all on or all off.
 
WordPress 2.5 will make a further filter available for choosing which canonical redirects are denied rather than forcing them to be all on or all off.
  
==Migrating from 2.3 to 2.5==
+
<div id="Migrating_from_2.3_to_2.5">
 
+
== 2.3 から 2.5 への移行 ==
(Note: There was no WordPress version 2.4 - it was skipped.)
+
</div>
 +
(注: WordPress バージョン 2.4 はありません。とばして 2.5 となります。)
  
Themes are unlikely to be affected hugely by Version 2.5.
+
テーマについては、[[Version 2.5|バージョン 2.5]] による重大な影響はないでしょう。
  
The main change affecting plugins in the (at time of writing) upcoming WordPress version 2.5 is the complete overhaul of the administration screens and menus of WordPress. This change will affect some plugins that add pages to the menus, or sections to screens, in the administration sections of WordPress.
+
もうすぐ公開される [[Version 2.5|WordPress バージョン 2.5]] における、プラグインに影響する主な変更点は、WordPress の管理画面とメニューの全面的な見直しです。この変更は、WordPress の管理パネルに対して、メニューへのページ追加や、ある画面内にセクションを追加するようなプラグインに影響します。
  
 
First, menus: The menus have been reorganized slightly; most plugins will probably still function correctly, if they used the standard methods of [[Adding Administration Menus]].
 
First, menus: The menus have been reorganized slightly; most plugins will probably still function correctly, if they used the standard methods of [[Adding Administration Menus]].
64行目: 84行目:
 
{{原文|Migrating Plugins and Themes}}
 
{{原文|Migrating Plugins and Themes}}
  
[[Category:Advanced Topics]]
+
{{DEFAULTSORT:ふらくいんとてえまのいこう}}
[[Category:WordPress Development]]
+
[[Category:上級トピック]]
[[Category:Plugins]]
+
[[Category:WordPress の開発]]
[[Category:New page created]]
+
[[Category:プラグイン]]
 +
[[Category:デザインとレイアウト]]
 +
[[Category:wp2.2]]
 +
[[Category:wp2.3]]
 +
[[Category:wp2.5]]
  
 
[[en:Migrating Plugins and Themes]]
 
[[en:Migrating Plugins and Themes]]

2008年2月19日 (火) 23:24時点における版

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

このページは、プラグインやテーマを WordPress のメジャーアップグレードに対応させる方法の手引きです。

1.2 から 1.5 への移行

1.2 から 1.5 へのアップグレード をご覧ください。古いテーマから現在のテーマシステムへの変換方法などを説明しています。

2.0.x から 2.1 への移行

プラグインとテーマの 2.1 への移行 をご覧ください。

2.1 から 2.2 への移行

バージョン 2.2 におけるプラグインとテーマにとっての主要な変更点は、WordPress ウィジェットが WordPress のコア(本体)に組み込まれたことです。(ウィジェットとは、カテゴリリストやアーカイブリスト・検索フォームといった WordPress の出力要素を、簡単にブログのサイドバーに配置できるようにするものです。従来はプラグインとして提供されていました。)

WordPress 2.2 より前に開発されたテーマでウィジェットを使えるようにするには、テーマのウィジェット対応についてのこの記事でテーマの修正方法をご覧ください。

If you want some output that your Plugin generates to be displayed in a sidebar Widget, you can find out how in this article on Widgetizing Plugins, and you may also find the Widgets API article useful. プラグインでサイドバーウィジェットへの表示を生成する方法は、プラグインのウィジェット対応のこの記事をご覧ください。Widgets API も役立ちます。

2.2 から 2.3 への移行

カテゴリとタグ

バージョン 2.3 におけるプラグインとテーマにとっての主要な変更点は、WordPress 本体の機能としてタグ付けが組み込まれたことです。

テーマにタグを追加(例:記事に付けられているタグの表示、サイドバーへのタグクラウドの表示)するには、新しいテンプレートタグ the_tagswp_tag_cloud を用います。

There were also quite a few new tag-related functions for use in plugins introduced in WordPress 2.3.

また、WordPress にタグを導入する副作用として、カテゴリ情報の格納に関して、基盤であるデータベース・テーブル構造が大幅に変更されました。したがって、WordPress データベースのカテゴリ関係のテーブルを使うクエリを実行するプラグインは、おそらく使えなくなってしまい、クエリを全面的に書き換えなければなりません。カテゴリへのアクセスに WordPress 関数を利用しているプラグイン・テーマであれば、大丈夫なはずです。

Canonical URL

プラグインに影響する 2.3 のもう一つの変更点は、「canonical(カノニカル)」URL の導入です。The canonical URL system basically rewrites all URLs used in WordPress into "canonical" form, so that there is only one URL that points to a given display, and other URLs that could also point to that display are redirected to the "canonical" URL.(カノニカル URL システムは、与えられた表示(ページ)を指し示す URL を一つだけとするために、WordPress で使われる全ての URL を原則として「カノニカル」形式に書き換え、その表示を指す他の URL は「カノニカル」URL へリダイレクトします?) ほとんどのプラグインはこの変更による影響を受けませんが、a plugin that adds suffixes to URLs could find that some of the URLs it generates are broken.(~~~ URL に接尾辞(suffix)を加えるようなプラグインは使えなくなります。) 特に、example.com/page/2/(過去記事の2ページ目にアクセス)のようにページ番号が付く URL は、必ず URL の末尾にページセクションが必要です。WordPress の従来のバージョンでは example.com/page/2/suffix/ は動作できましたが、WordPress 2.3 では、正しく機能させるために URL を example.com/suffix/page/2 と生成しなければなりません。

留意: あなたのサイトを機能させるために、一般的でない URL/パーマリンク構造を使う必要がある場合は、「カノニカル URL」機能をオフにできます。プラグインファイル または テーマディレクトリ内の `function.php` に次の 1行を加えてください。

remove_filter('template_redirect', 'redirect_canonical');

WordPress 2.5 will make a further filter available for choosing which canonical redirects are denied rather than forcing them to be all on or all off.

2.3 から 2.5 への移行

(注: WordPress バージョン 2.4 はありません。とばして 2.5 となります。)

テーマについては、バージョン 2.5 による重大な影響はないでしょう。

もうすぐ公開される WordPress バージョン 2.5 における、プラグインに影響する主な変更点は、WordPress の管理画面とメニューの全面的な見直しです。この変更は、WordPress の管理パネルに対して、メニューへのページ追加や、ある画面内にセクションを追加するようなプラグインに影響します。

First, menus: The menus have been reorganized slightly; most plugins will probably still function correctly, if they used the standard methods of Adding Administration Menus.

Second, screens: Any plugin that had added a section to the post editing screen, or other administration screen, will probably find that the formatting and markup changes on the administration screens in WordPress 2.5 have made their section so that it no longer "blends in" and looks like it belongs with the built-in WordPress sections on the screen. So, plugin authors will either need to release a new version of their plugins for WordPress 2.5, or (preferably) put some decision logic into their plugin that will detect the version and use the right formatting. A good way to do that is to detect whether the new formatting functions have been defined. For example:

if (function_exists('add_meta_box')) {
 // 2.5 style
} else {
 // 2.3
} 

Another change that might affect some plugins is that in WordPress 2.5, the Activation hooks for plugins are run in non-global scope within a function (they used to be run in the global scope). This means that if your plugin has an activation hook, and the function it calls relies on global variables that are defined within your plugin file, you may find that they are not working properly. All you need to do is, at the global scope level in your plugin, add a "global" declaration for those variables, and you should be OK. For instance:

global $my_plugin_variable;
$my_plugin_variable = 3;

function my_plugin_activation_function() {
   global $my_plugin_variable;

   // rest of activation function
}

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