Theme Review

目次 1 Theme Review 2 各バージョンの変更点 3 テーマ審査工程と範囲 3.1 Responding to a Review 4 ガイドライン（指針） 4.1 コード品質 4.2 機能 4.3 テンプレートタグおよびフック 4.3.1 ファイルの読み込み 4.3.2 サイト情報 4.4 WordPress定義CSSクラス 4.5 テーマテンプレートファイル 4.6 ライセンシング（使用許諾） 4.7 テーマ名 4.8 クレジットリンク 4.9 テーマ説明書 4.10 テーマ単体テスト 5 テーマの旧式化 6 テーマ審査員になるには 7 資料 7.1 役立つCodexリンク集 7.2 コード検証リンク集 7.3 PHP/WordPress検証ツール

Theme Review

最終改訂日： 2010年11月14日

WordPressテーマディレクトリには、誰でもGPLまたは互換ライセンスのWordPressテーマを登録できます。新しいテーマは、公開する前にWordPressコミュニティのメンバーによって点検されます。このページでは、登録されたテーマの評価の過程と範囲、テーマ審査員向けガイドライン（指針）について説明します。

各バージョンの変更点

WordPressの各新バージョンの公開により、テーマ審査工程が更新されます。新たに登録されたテーマの最新WordPress特性・機能対応を確実にするには、WordPress新バージョンの一箇月以降に登録されるテーマは全て、更新後の審査基準に対応していなければなりません。

WordPressバージョン別テーマ審査基準変更点の一覧を参照してください。

テーマ審査工程と範囲

• The Theme directory is a repository of GPL (or compatible) licensed WordPress Themes. The review process, by community members, ensures Themes conform to modern web standards, WordPress standards, and are, in general, of high quality.
• Once a Theme author is ready to release a Theme to the public, they can upload it to the directory system. Be sure your Theme meets the Guidelines below, and test your theme with the Theme Unit Test before you upload your Theme. Also, check your Theme using the following Tools, which will also be used by the Theme Review Team as part of the review process:
  • Theme-Check プラグイン/en
• Submitted Themes are automatically checked to make sure they meet a few basic requirements.
• Theme authors receive an automated e-mail message, indicating that their Theme files have been received.
• Submitted Themes are assigned a ticket in the Theme Review Trac system, and entered into a review queue.
• Theme reviewers test Themes, using the method described below.
• While the goal of the design review is to ensure that Themes are functional and meet standards much of the review will surround technical issues. Themes will be checked for other factors, such as ensuring that all standards are met to a satisfactory standard, and that designs are logical, and user-friendly.
• Theme reviewers will provide feedback to Theme authors in a timely manner; and, Theme authors will have the opportunity to revise their Themes at any time.
• Theme reviewers will either approve Themes or contact Theme authors with feedback and/or questions.
• Theme authors can submit any changes via the upload page they used when they initially uploaded the Theme, either before or after a Theme has been approved.
• If a Theme is not initially approved, Theme authors can rework the Theme and resubmit it.

If you have any questions or suggestions about the process, don't hesitate to contact us. Thank you for your contributions!

Responding to a Review

A theme will be held for approval until items listed as Required are addressed. Once these issues have been resolved, please re-submit your Theme using the uploader tool, a new Trac ticket will be generated. Also note, re-submitted Themes are given priority over newly submitted Themes to help speed up the process and to ensure timely updates are available to end-users.

Theme developer questions, comments, and feedback are always welcome ... and encouraged!
Please use one of the following methods:

• Leave a comment on the appropriate Trac ticket(s) related to the Theme;
• Email the theme-reviewers email list (you may need to join first); or,
• Use the #wordpress-themes channel on irc.freenode.net where you can find the Theme Review team.

ガイドライン（指針）

• テーマ登録時点における最新のガイドラインを満たす必要があります。
• ガイドラインはWordPressのメジャーバージョン公開後に更新されます。

コード品質

WordPressテーマの標準的な書き方や最良の方法については、テーマ開発およびWordPressコーディング基準、CSSコーディング基準/en、サイトのデザインとレイアウトを見直してください。

• テーマは、通知・警告・エラーがないこと、非推奨（廃止予定の）関数が使われていないことが必須です。以下の手法の一つを用いてテストしてください。
  • wp-config.php にて： define(WP_DEBUG, true);
  • プラグインにて： Log Deprecated Notices および／または Debogger
• 広く認められている最新（現行？）バージョンの(X)HTMLおよびCSSを利用することが必須です。（訳注： 翻訳が間違っているかもしれません。原文 "current recognized version(s) of (X)HTML and CSS"）
  • W3C XHTML Validator + W3C CSS Validator（バリデータ： 検証プログラム）
  • W3C XHTML+CSS Validator (Unicorn)
• JavaScriptエラーが発生しないことが必須です。
• 有効なHTMLドキュメント HEAD が必須です。
  • 有効なDOCTYPE宣言
  • <html> タグに language_attributes() が入っていること
  • <head> タグ内の正しいXFNプロファイルリンク： <head profile="http://gmpg.org/xfn/11"> (Exception: Wholly HTML 5 themes must not have the profile, as HTML 5 does not support it.)
  • 正しい content-type メタ宣言： <title> タグの前で <meta http-equiv="Content-Type" content="<?php bloginfo('html_type'); ?>; charset=<?php bloginfo('charset'); ?>" /><code> または <code><meta charset=<?php bloginfo('charset'); ?> 宣言
  • 題名と説明用に <title> 内に bloginfo() が入っていること（必要に応じて）

機能

テーマに以下の本体機能を組み込むことが必須です。

• 自動フィードリンク
  • add_theme_support('automatic-feed-links’)
• ウィジェット：
  • dynamic_sidebar()
  • register_sidebar()
  • add_action(widgets_init), register_widget() （ウィジェットAPIを参照） – （テーマでカスタムウィジェットを利用する場合）
• コメント：
  • comments_template()
  • wp_list_comments()
  • comment_class()/en – （wp_list_comments() のコールバックをを利用する場合）
  • comment_form()
  • wp_enqueue_script( 'comment-reply' )
    

テーマに以下の本体機能を組み込むことが推奨されますが、必須ではありません。ただし、組み込む場合にはWordPress本体の実装に対応しなければなりません。

• ナビゲーションメニュー：
  • wp_nav_menu()
  • functions.php 内に register_nav_menu() または register_nav_menus()
  • The following functions may only be used for navigation menus as a callback to wp_nav_menu(), as part of a has_nav_menu() conditional, or similar： wp_list_pages, wp_list_categories, wp_page_menu, etc.
• 投稿サムネイル：
  • the_post_thumbnail()
  • functions.php 内に add_theme_support('post-thumbnails’)
• カスタムヘッダ：
  • add_custom_image_header()
• カスタム背景：
  • add_custom_background()
• ビジュアルエディタCSS：
  • add_editor_style()
  • editor-style.css ファイル

テンプレートタグおよびフック

テーマで使うテンプレートタグおよびフックを適切に実装することが必須です。

次のテンプレートタグおよびフックは、適切な位置に入れることが必須です。

• wp_head() – （</head> タグの直前）
• body_class() – （<body> タグの内側）
• $content_width
• post_class()
• wp_link_pages()
• paginate_comments_links()/en または previous_comments_link()/en/next_comments_link()/en
• posts_nav_link() または previous_posts_link()・next_posts_link() または paginate_links()/en
• wp_footer() – （</body> タグの直前）

ファイルの読み込み

• テーマに組み込む場合、標準テンプレートファイルを正しいテンプレートタグを用いて呼び出すことが必須です。下記テーマテンプレートファイル節も参照のこと。
• If incorporated into the Theme, custom template files are required to be called using get_template_part()
• Legacy Theme Support
  • Themes are required to include all template files called within the Theme, rather than relying upon legacy Theme support. If a Theme uses any of the following functions, it is required to include the appropriate template file:
    • get_footer(): footer.php
    • get_header(): header.php
    • get_sidebar(): sidebar.php
• include( TEMPLATEPATH . '/file.php' ) should not be used to call Theme template part files unless absolutely necessary.

サイト情報

テーマに組み込む場合、サイト情報を正しいテンプレートタグを用いて呼び出すことが必須です。
(Note: this section is currently being drafted. Consider it as such until this notice is removed. - 20 Oct 2010)

• get_option( 'home' ) は使用できません。替わりに home_url() を使うこと。
• get_option( 'site_url' ) は使用できません。替わりに site_url() を使うこと。
  • see Trac Ticket #9008 for additional information related to this use of get_option() versus *_url

(This list is not exhaustive. Refer to bloginfo() for the full list)

• キャラクタセット（文字コードセット）: bloginfo( 'charset' )
• ホームURL:
  • bloginfo( 'url' )
  • echo home_url() (推奨)
• HTML種別: bloginfo( 'html_type' )
• フィードリンク:
  • bloginfo( 'feed_url' ) (where feed_url is rss_url, rss2_url, atom_url)
  • get_feed_link( 'feed' )/en (where feed is rss, rss2, atom) (推奨)
• 言語:
  • bloginfo( 'language' ) (en-US)
  • get_locale()/en (en_US)
• 親テーマディレクトリURL:
  • bloginfo( 'template_directory' )
  • bloginfo( 'template_url' )
  • get_template_directory_uri()/en (推奨)
• 親テーマ名: get_template()/en
• サイト説明文: bloginfo( 'description' )
• サイト名: bloginfo( 'name' )
• スタイルシートディレクトリURL:
  • bloginfo( 'stylesheet_directory' )
  • get_stylesheet_directory_uri()/en (推奨)
• スタイルシートURL:
  • bloginfo( 'stylesheet_url' )
  • get_stylesheet_uri()/en (推奨)
• 書字方向:
  • bloginfo( 'text_direction' )
  • is_rtl()/en for conditional statements (推奨)
• WordPress URL:
  • bloginfo( 'wpurl' )
  • echo site_url() (推奨)
• WordPressバージョン: bloginfo( 'version' )

WordPress定義CSSクラス

注： この節は草稿中です。 Consider it as such until this notice is removed.
以下のWordPress定義CSSクラス（最新）または同様の要素への対応が必須です。

• 配置クラス：
  • .aligncenter
  • .alignleft
  • .alignright
• キャプション関連クラス：
  （画像などの説明文）
  • .wp-caption
  • .wp-caption-text
  • .gallery-caption

WordPressが生成する次のクラスに対応することが推奨されます。

• 投稿クラス：
  • .sticky
• コメントクラス
  • .bypostauthor

テーマテンプレートファイル

最低限、入れることが必須のもの：

• index.php
• comments.php
  • Must be included using comments_template()
• screenshot.png (this should be a "reasonable facsimile" of the Theme after it is initially activated with default options)
• style.css

入れることが推奨されるもの：

• 404.php
• archive.php
• footer.php
  • Must be included using get_footer()/en
• header.php
  • Must be included using get_header()/en
• page.php
• search.php
• sidebar.php
  • （注） または 右記のような適切な変名： sidebar-left.php; sidebar-right.php; sidebar-footer.php 等
  • Must be included using get_sidebar()/en
• single.php

任意のもの：

• attachment.php
• author.php
• category.php
• date.php
• editor-style.css
• image.php
• tag.php

Themes are recommended to use core markup for the following forms, using the indicated template tag:

• Login Form: Must be included using wp_login_form()
• Search Form: Must be included using get_search_form()/en
  • Themes may optionally customize the search form, as searchform.php

登録するテーマには次のような名前のファイルを入れないことが推奨されます。However, if such files are used, Themes are required to provide end-user documentation explaining how to use them:

• page-foobar.php
• category-foobar.php
• tag-foobar.php
• taxonomy-foobar.php

注： 一般公開するテーマでこの命名法を避ける理由は、利用者が「foobar」というスラッグのページやカテゴリーを作成すると、デフォルトテンプレートではなく、予期せずこのテンプレートが適用されてしまうためです。テンプレート階層 - ページ表示を参照してください。

ライセンシング（使用許諾）

• 利用許諾条件
  • テーマは100% GPLライセンスまたはGPL互換ライセンスであることが必須です。This includes all PHP, HTML, CSS, images, fonts, icons, and everything else. All of the theme must be GPL-Compatible.
  • Themes are required to declare their license explicitly, using one of the following methods:
    • Adding License and License URI header slugs to style.css
    • Including a license.txt file with the Theme
  • Use this formatting for license information as in this example:

License: GNU General Public License v2.0
License URI: http://www.gnu.org/licenses/gpl-2.0.html

• GPL-Compatible Font Licenses
  • The GNU Foundation and the Fedora Project maintain lists of acceptable licenses for use with GPL (see also: this list).
• Fonts bundled with Themes submitted to the WordPress Theme directory are required to be licensed under one of the following font licenses:
  • Arphic Public License (Arphic)
  • Baekmuk License (Baekmuk)
  • Bitstream Vera License (Bitstream Vera)
  • Creative Commons Attribution License (CC-BY)
  • GNU GPL (with font exception) (GPL)
  • GUST e-Foundry Font License/LaTeX Project Public License (LPPL)
  • IPA Font License (IPA)
  • Liberation Font License (Liberation)
  • LaTeX Project Public License (LPPL)
  • mplus Font License (mplus)
  • ParaType Font License (PTFL)
  • SIL Open Font License (OFL)
  • STIX Fonts User License (STIX)
  • Wadalab Fonts License (Wadalab)
  • XANO Mincho Font License (XANO)
  • GPL-Compatible Icon Sets
• Some compatible icon sets include the following:
  • WooCons Set #1 (GPL)
  • Gallery2 Icons (GPL)
  • Lullacons Pack #1 (GPL)
  • Human O2 Grunge (GPL)
  • GNOME Desktop Icons (GPL)
  • Elegant Media Icons (GPL)
  • Humility Icons (GPL)
  • Crystal Icons (GPL)
  • Flat For Linux (GPL)
  • Ultimate GNOME Icons (GPL)
  • Shrunk Pidgin Smilies (GPL)
  • Twotiny Icons (GPL)
  • Web Design Creatives (GPL)
  • realistiK Reloaded (GPL)
  • Carpelinx (GPL)
  • DarkGlass Reworked (GPL)
  • Lynx Black (GPL)
  • KDE Crystal Diamond (GPL)
  • Oxygen (GPL)

テーマ名

Theme Name Guidelines are required for new Themes, and recommended for existing Themes.

• Themes are not to use WordPress in their name. For example My WordPress Theme, WordPress AwesomeSauce, and AwesomeSauce for WordPress would not be accepted. After all, this is the WordPress Theme repository.
  • Themes are not to use the term Theme in their name, such as: AwesomeSauce Theme. Same reason as above ... it's a Theme repository.
  • Themes may use the WP acronym in the Theme name, such as WP AwesomeSauce.
• Themes are not to use version-specific, markup-related terms (e.g. HTML5, CSS3, etc.) in their name.
• Themes are not to use Theme author/developer credit text in their name. For example AwesomeSauce by John Q. Developer (makes for a much better credit link); or, SEO/spam-seeded text, such as: AwesomeSauce by Awesome Free WP Themes (this is just not going to pass).

Also note, theme names as defined in the style.css header block will be used as the theme slug in the WordPress Extend Theme repository. All names will be turned to lower case and spaces will be replaced with hyphens. For example: 'CamelCase Name' would be 'camelcase-name'.

クレジットリンク

• Themes may optionally designate Author URI and Theme URI in style.css.
  • Theme URI, if used, is required to link to a page specifically related to the Theme.
  • Author URI, if used, is required to link to an author's personal web site or project/development website.
  • Themes are recommended to provide at least one of these two links, in order to ensure Theme users have a point of contact for the Theme developer.
• Themes may optionally include a public-facing credit link in the Theme footer.
  • If used, Themes are required to include no more than one such footer credit link.
  • Credit link, if used, is required to use either Theme URI or Author URI.
  • Credit link anchor text and title are required to be relevant and appropriate with respect to the linked site. Spam or SEO-seeded anchor text and titles may subject Themes to automatic rejection.
• Themes may optionally include a Theme Option to display additional credit links or text.
  Note: this section is currently being drafted. Consider it as such until this notice is removed.
  • If used, such options are required to be opt-in (i.e. disabled by default, rather than enabled)
  • If used, such options are recommended to provide user-modifiable text/links, rather than merely providing an enable/disable option
  • In general, such opt-in credit text/links are exempted from above-listed requirements regarding relevance and appropriateness. However, the Theme Review team reserves the right to prohibit such optional text/links if, at its sole discretion, a Theme abuses this option.
• Since Themes are GPL (or compatible), Theme authors are prohibited from requiring that these links be kept by Theme users. An appropriate way to ask for Theme users to keep a link to the author's website is as follows: "It is completely optional, but if you like the Theme I would appreciate it if you keep the credit link at the bottom."
• Any exception to these requirements must be approved by the Theme Review team.

テーマ説明書

Please be clear about the following in your Theme documentation (a README file included with your Theme helps many users over any potential stumbling blocks):

1. Indicate precisely what your Theme and template files will achieve.
2. Adhere to the naming conventions of the standard Theme hierarchy.
3. Indicate deficiencies in your Themes, if any.
4. Clearly reference any special modifications in comments/en within the template and stylesheet files. Add comments to modifications, template sections, and CSS styles, especially those which cross template files.
5. If you have any special requirements, which may include custom Rewrite Rules, or the use of some additional, special templates, images or files, please explicitly state the steps of action a user should take to get your Theme working.
6. Provide contact information (website or email), if possible, for support information and questions.

テーマ単体テスト

テーマ単体テストの要件を満たさなければいけません。

テーマの旧式化

• 一旦登録したら最新に保たなければいけません。
• Any Theme not updated to the current theme review process as of the most recent release of WordPress may be subject to temporary suspension.

テーマ審査員になるには

Are you interested in joining the Theme Reviewers team? Great! The team is open to anyone who wants to help out, and the process is simple:

1. Join the Theme Reviewers mail list.
2. Setup a WordPress test environment, and import the Theme Unit Test data. Be sure to set WP_DEBUG to 'true' in wp-config.
3. Install the Log Deprecated Notices plugin on your WordPress test environment.
4. Pick the oldest unclaimed Theme from the Theme Review Trac Queue; and, "reassign to" your Trac username
5. Using the SVN link in the Trac ticket, download the Theme files, and install/activate the Theme on your WordPress test environment.
6. Review the Theme per the process, ensuring the Theme meets the criteria as well as the Theme Development standards.
7. Attach your Theme review notes as a comment on the ticket.
8. Set the “resolve as” option to “suggest-approval” for inclusion in the Theme directory; or, “not-accepted” if the Theme does not meet the necessary review criteria and standards.

資料

役立つCodexリンク集

• テーマ開発
• テンプレート階層
• テーマ単体テスト
• WordPressコーディング基準
• CSSコーディング基準 /en
• サイトデザインとレイアウト
• CSSブラウザバグ対応 /en
• CSSトラブルシューティング /en

コード検証リンク集

• W3C XHTML+CSS Validator (Unicorn)
• W3C XHTML Validator
• W3C CSS Validator

PHP/WordPress検証ツール

• Log Deprecated Notices プラグイン （テーマ／プラグインに含まれる非推奨WordPress関数の通知を記録）
• Debogger プラグイン （PHPエラーおよびXHTMLバリデーションステータスを報告）

最新英語版： WordPress Codex » Theme Review （最新版との差分）