web-dev-qa-db-ja.com

テーマとWordPressのコーディング規約が矛盾している場合はどうすればいいですか?

私は _ sの根 のような異なるスターターテーマを検討しています。根はとてもよく見えます、特にその生け花のフォーク。とにかく、私に関係することが一つあります。 RootsがテーマやプラグインのWordPressのコーディング標準に準拠していないようです。 Rootsをスターターテーマとして使用したい場合は、どの標準に従う必要がありますか?

3
user54383

これは非常に主観的な質問です - 非常に良くて興味深いものですが、私はこれについて私自身の見解を提供しようと思います。

一般に、あなたは常にWordPress Coding Standardsを遵守するように努めるべきです。唯一の例外は、既存のコードを変更しているときです。基本的に、既存の "製品"(プラグインやテーマなど)を編集するときは、その製品が従うコーディング標準を使用する必要があります。ですから、あなたの場合は、テーマのコーディング標準に従うべきです。

この差別化はかなり白黒に見えるかもしれませんが、違います。考慮すべき灰色の領域がたくさんあります。私はそれらのうちのいくつかをカバーしようとするつもりですが、最初に基本的なルールのセットを与えることを試みましょう。

  1. 製品を変更するのではなく、新しい製品を作成するか既存の製品を拡張する場合は、WordPressコーディング標準を使用してください。
  2. WordPressコアでコードを変更する場合は、WordPressコーディング標準を使用します(追加のコードが準拠していない場合もあります)。
  3. 製品を変更していて、コードが読みやすくフォーマットが統一されている場合は、オリジナル製品のコーディング標準を使用してください。

一般に、コーディング標準の最も重要なことは、コードを読みやすくすることです。ですから、オリジナルのコーディング標準とWordPressのコーディング標準のどちらを使用するのかを決めるときには、この製品のコードを全体的に読みやすくするための質問を自分で考えてください、オリジナルまたはWordPressのコーディング標準を使用しますか?

子テーマのコーディング基準

これは実際には灰色の領域ではありませんが、明確にするのは興味深い点です。つまり、製品を拡張するとき(つまり、変更することなく実際に拡張するとき)、既存の製品に依存する追加の製品を提供します。これは別の製品であり、あなたはWordPressのコーディング標準を遵守するべきです。

ばかげたコーディング標準

あなたが製品を変更していて、それがばかげたコーディング標準(例えば、コードの可読性を著しく損なうコーディング標準)を持っているならば、あなたはWordPressコーディング標準の使用を選ぶべきです。

一貫性のないコーディング規格

オリジナルの製品が特定のコーディング標準のセットを順守することに矛盾がないように思われる場合は、独自の新しいコードにはWordPressコーディング標準を使用する必要があります。

3
engelen

ルーツは、WPの1タブインデントと比較して、わずかに少ないスペースと2スペースのインデントで独自の規約に準拠しています。

これがコーデックスが 字下げについて言うことです

あなたのインデントは常に論理構造を反映するべきです。スペースを使用せずに実際のタブを使用してください。これにより、クライアント間での柔軟性が最大になります。

例外:整列していると読みやすくなるコードブロックがある場合は、スペースを使用してください。

これはコーディング標準に固執する問題ではありません。常に覚えておいてください、コードの可読性は非常に重要です、そして、コーディング標準はこれのための準備をします。

あなたの質問では、Rootsテーマはまだコーディング標準の範囲内でものをやっています。私はまた、そのような成功したテーマが彼らの評判を超えるという評判を脅かすことはないと思います。ルーツがあなたに提供するものに固執してください、それらはコーディング標準の範囲内にあるので、あなたは読みやすさのために彼らの構造を保つべきです

参考文献:

編集

この質問では、「主にオピオンベース」として近い投票を受けました。

参照を使用して指摘したように、コーデックスは使用するコーディング標準、規則に対する例外、標準の実際の適用方法、およびこれらの標準の実装方法の例を明確に示しています。

この演習全体が、コーデックスのこれらのページを読んで理解することに帰着すると本当に思います。

4
Pieter Goosen