WordPressコーディング標(biāo)準(zhǔn)

WordPress 開発におけるコーディング標(biāo)準(zhǔn)は、強(qiáng)固で持続可能なコードベースのために不可欠です。開発者がコードを書く際に従うガイドラインや規(guī)約であり、共同作業(yè)の強(qiáng)化、メンテナンスの簡(jiǎn)素化、全體的な信頼性の確保に役立ちます。

さらに、コーディング標(biāo)準(zhǔn)はよくある落とし穴やエラーを防ぎ、コードの品質(zhì)を向上させます。WordPress の開発では、複數(shù)の貢獻(xiàn)者がひとつのプロジェクトで共同作業(yè)を行うことが多いため、コーディング標(biāo)準(zhǔn)は効果的なチームワークの基礎(chǔ)となります。コミュニケーションを促進(jìn)し、潛在的な衝突を緩和し、開発プロセスをより効率的にするのに役立ちます。

畫像[1] - WordPressコーディング標(biāo)準(zhǔn)入門 - Photon Flux|プロフェッショナル?ワードプレス修繕サービス、グローバル展開、クイックレスポンス

コーディング標(biāo)準(zhǔn)の遵守は、プロジェクト間の一貫性を促進(jìn)し、開発者がコードベース間をシームレスに切り替えることを容易にします。この一貫性は、コードの可読性と保守性にも及び、チームメンバー間の共通理解を促進(jìn)します。

WordPress Coding Standardsは、まとまりのある効率的な開発プロセスのための5つの重要な領(lǐng)域をカバーしています:

  • PHPはサーバーサイドのコードの一貫性を保証します。
  • 構(gòu)造化マークアップとセマンティックマークアップを促進(jìn)するHTML
  • 効果的なクライアントサイド機(jī)能のためのJavaScript
  • 一貫したスタイリング方法のためのCSS
  • 最終的な製品が、多様なニーズを持つ人々にとって包括的でユーザーフレンドリーなものであること。

WordPress開発におけるPHP標(biāo)準(zhǔn)

畫像[2] - WordPressコーディング標(biāo)準(zhǔn)入門 - Photon Flux|プロフェッショナル?ワードプレス修理サービス?グローバル?リーチ?迅速対応

ワードプレス専用PHPコーディング標(biāo)準(zhǔn)WordPress コードの一貫性と可読性を確保するために、これらの標(biāo)準(zhǔn)は WordPress コアには必須であり、テーマとプラグインには強(qiáng)く推奨されています。これらの標(biāo)準(zhǔn)は、読みやすさを向上させ、コラボレーションを促進(jìn)するために、命名規(guī)則からインデントやコード構(gòu)造まですべてをカバーしています。

WordPressのPHP標(biāo)準(zhǔn)は以下のカテゴリをカバーしています:

  • 一般論として- これらの標(biāo)準(zhǔn)には、複數(shù)行のPHPスニペットをHTMLコードブロックに埋め込む際に、 開始と終了のPHPタグを別の行に配置すること、一重引用符や二重引用符を使用する際に 短縮形のPHPタグを使用しないこと、include文やrequire文の書き方のガイドラインなどが含まれます:
// HTML 內(nèi)で PHP タグを開閉します。
// open/closeタグをそれぞれの行に記述します。

## DO
関數(shù) foo() {
  foo() { ?>DO function foo() { ?
  <div>
    <?php
    echo esc_html (
      bar (
        $param1,
        $param2
      )
    );
    ?>
  </div>
  <?php
}

## DON'T
if ( $x === $y ) { ?>
  <div>
    <!-- HTML content -->
  <?php }
// 省略記法の PHP タグは避けてください。

## DO



## don't
何と言っていいかわかりません。
// include/require 文の記述。
include_onceはファイルが見つからなくても実行を続けるので、 // 避けてください。
// ファイルが見つからない場(chǎng)合でも実行を継続します。
// ファイルパスを括弧で囲まないでください。

## DO
require_once ABSPATH . 'ファイル名.php'

## しない
require_once __DIR__ . '/file-name.php'
include_once ( ABSPATH . 'file-name.php' );

クリステン-命名基準(zhǔn)には、命名規(guī)則と命名ダイナミックフックの補(bǔ)間が含まれます:

## DO
// 関數(shù)と変數(shù)名には小文字を使用します。
関數(shù) my_function( $some_variable ) {}。

// 定數(shù)名には大文字を使用します。
Define('MAX_AGE', 60);

##は使用しないでください。
// キャメルケースを使用します。
function myFunction( $someVariable ) {}。

ボイド- 空白の標(biāo)準(zhǔn)は、空白の使い方、インデント、末尾の空白の削除に関するガイドラインを定めています。(開発者の間で活発な議論を始めるには、コードをインデントするときにタブとスペースのどちらが好きか尋ねてみてください。好みにかかわらず、WordPressの開発者が公式に推奨しているのはタブを使うことで、これはPHPに加えてJavaScriptとCSSにも當(dāng)てはまります。(PHPだけでなく、JavaScriptやCSSでも同様です。)

## DO
// カンマの後にスペースを入れてください。
$colors = ['赤', '緑', '青'].

// 開き括弧と閉じ括弧の両側(cè)にスペースを入れます。
// 制御構(gòu)造體の開始括弧と閉じ括弧の両側(cè)にスペースを入れます。
foreach( $foo as $bar ) { ...

// 関數(shù)の定義: function my_function() { .
function my_function() { ...

// 論理比較: if ( !
if ( ! $foo ) { ...

// 配列項(xiàng)目へのアクセス: $a = $foo['bar'] { ...
$a = $foo['bar'] { ...
$a = $foo[ $bar ]。

## don't
$colors = ['red','green','blue'] です。
foreach($foo as $bar){ ...
function my_function(){ ...
if (!$foo) { ...
$a = $foo[ 'bar'] { ...
$a = $foo[$bar] ...

フォーマッティング- WordPress PHP 開発のための書式標(biāo)準(zhǔn)には、括弧スタイル、配列宣言、複數(shù)行の関數(shù)呼び出しのガイドライン、型宣言、マジック定數(shù)、展開演算子などがあります:

// DO
// 以下のブレース?スタイルを使用します。
if ( 條件 ) {
    アクション(); } elseif ( 條件2 ) { } elseif ( 條件2 )
} elseif ( 條件2 ) {
    action2(); } elseif ( 條件2 ) { action2()
} else {
    default_action(); } elseif ( condition2 ) { action2(); } else { default_action()
}

// long構(gòu)文で配列を宣言します。
$numbers_long = array(1, 2, 3, 4, 5); // 複數(shù)行の関數(shù)呼び出しでは、各パラメータは1行で済むようにします。
/* 複數(shù)行の関數(shù)呼び出しでは、各パラメータは1行しか使用できません。
複數(shù)行のパラメータ値には変數(shù)を代入し、その変數(shù)を関數(shù)呼び出しに渡す必要があります。
$data = array(
    
    
    
).
$greeting_message = sprintf().
    /* %sはユーザー名にマップされます */
    __( 'Hello, %s!', 'yourtextdomain' )、
    $data['user_name'].
);
$result = some_function (
    $data、
    $greeting_message, $data('user_name') ); $result = some_function (
    /* 翻訳関數(shù)%sは都市名にマップします*/
    sprintf( __( 'User resides in %s.' ), 'Cityville' ).
);

// マジック定數(shù)は大文字にします。
// ::class 定數(shù)は小文字で、スコープ解決演算子 (::) の周りには空白を入れません。
add_action( my_action, array( __CLASS__, my_method ) ); // ::class 定數(shù)は小文字で、スコープ解決演算子 (::) の周りにはスペースを入れません。
add_action( my_action, array( My_Class::class, my_method ) );; add_action( my_action, array( __CLASS__, my_method ); add_action( my_action, array( My_Class::class, my_method ) ).

/* スプレッド演算子の前に、適切なインデントでスペースまたは改行を追加します。
   を追加します。

   このようにします。

   /* スプレッド演算子の前には、適切なインデントでスペースまたは改行を追加します。
     スプレッド演算子とそれが適用される変數(shù)/関數(shù)の間にはスペースを入れてはいけません。

   * スプレッド演算子と參照演算子の間にスペースはありません。
     スプレッド演算子と參照演算子を組み合わせた場(chǎng)合、スプレッド演算子と參照演算子の間にスペースはありません。
*/スプレッド演算子と參照演算子の間にスペースなし。

//DO
関數(shù) some_func( &..$arg1 ) { {.
    bar( .....$arg2 );
    bar(
        array( ....$arg3 ), .
        ....array_values( $array_vals )
    );
}

//DONT
関數(shù) some_func( & ...  $arg1 ) {
    bar(...
        $arg2 );
    bar(
        array( ....$arg3 ),....array_values( $array_vals )
    );
}

宣言文、名前空間、および Import 文- これらのコーディング標(biāo)準(zhǔn)は、名前空間宣言と用途ステートメント

// 各名前空間宣言には
// 大文字の単語をアンダースコアで區(qū)切ります。
namespace My_CompanyProjectKinsta_ProjectUtilities; namespace My_CompanyProjectKinsta_ProjectUtilities.

// インポート使用ステートメントでは、名前の衝突を防ぐために // エイリアスを使用できます。
// 名前の衝突を防ぐために
use Project_NameFeatureClass_C as Aliased_Class_C; // インポートの use 文は、 // 名前の衝突を防ぐためにエイリアスを使用できます。

オブジェクト指向プログラミング - これらの基準(zhǔn)には、1つの文書につき1つのオブジェクト構(gòu)造しか使用しないこと、機(jī)能へのアクセスを提供すること、"C "および "D "機(jī)能を使用することなどが含まれます。用途ステートメント、可視性が常に宣言されるようにするためのガイド、可視性と修飾子の順序の概要、オブジェクトのインスタンス化のルールの概要について説明します:

// Trait use 文はクラスの先頭に記述します。
// Trait use は、 // 最初と最後の文の前後に少なくとも 1 行ずつ記述する必要があります。
// 最初と最後の文。
// 常に可視性を宣言してください。
クラス Foo {
    use Bar_Trait; public $baz = Bar_Trait.
    public $baz = true; ...
    ...
}

// 新しいオブジェクトのインスタンスを作成するときは、常に括弧を使用します。
// オブジェクトのインスタンスを作成するときは、常に括弧を使用します。
// クラス名と開始括弧の間にスペースを追加しないでください。
$foo = new Foo(); // クラス名と開始括弧の間にスペースを入れないでください。

制御構(gòu)造- 制御構(gòu)造には elseifノットでなければ與田ステートメント:論理比較で変數(shù)と定數(shù)、リテラル、関數(shù)コールを混在させる場(chǎng)合は、以下のように変數(shù)を右側(cè)に配置し、誤った代入を防ぎます:

// "合法的な "比較: if ( true === $result ) { if ( true === $result )
if ( true === $result ) { // $resultで何かをします。
    // $resultで何かを行います。
}

if ( $result = true ) { // $resultで何かをする } // しかし、このようなタイプミスはあなたを通過する可能性があります。
if ( $result = true ) { // $resultで何かをする } // しかし、このようなタイプミスはあなたを通り過ぎる可能性があります。
    // 必ずここに行き著きます

えんざんし- これらの標(biāo)準(zhǔn)は、三項(xiàng)演算子、エラー制御演算子( @) とインクリメント/デクリメント演算子:

// 常に三項(xiàng)演算子
// ステートメントが false ではなく true かどうかをテストします。
$programming_language = ( 'PHP' === $language ) ? 'cool' : 'meh';

// pre-increment/decrementをpost-increment/decrementより優(yōu)先します。
// スタンドアロン文の場(chǎng)合。

// DO
--$a.

// DON'T
$a--; // しない
  • 総合データベース- データベース?コーディング?スタンダードは、データベース?クエリを?qū)g行し、SQLステートメントをフォーマットするための命令を提供します。
  • その他の推奨事項(xiàng)- その他の提案には、関數(shù)の引數(shù)に説明しやすいフラグ値を使う、賢いコード、クロージャ(無名関數(shù))、正規(guī)表現(xiàn)、シェルコマンド、以下を避けるための指示などの基準(zhǔn)が含まれます。extract().

WordPress PHPコードのインラインドキュメンテーション標(biāo)準(zhǔn)

上記のガイドラインに加え、WordPressではインラインドキュメンテーション規(guī)格. WordPress は、PHPDoc 構(gòu)文からヒントを得たカスタムドキュメントアーキテクチャを使用しています。phpDocumentorメンテナンスされる PHP コードにはドキュメントが提供されます。これらの標(biāo)準(zhǔn)は外部ドキュメントの生成を簡(jiǎn)素化し、コードベースの構(gòu)造に関する共通の理解を促進(jìn)することで、より広い WordPress 開発者コミュニティに貢獻(xiàn)します。

畫像[3] - WordPressコーディング標(biāo)準(zhǔn)入門 - Photon Flux|プロフェッショナル?ワードプレス修理サービス、グローバル展開、クイックレスポンス

WordPressのPHPドキュメントは、フォーマットされたブロックやインラインコメントとして表示されることがほとんどです。WordPress のファイルには、次のようなドキュメントを記述してください:

  • 関數(shù)とクラスメソッド
  • クラス
  • プロパティと定數(shù)を含むクラス?メンバ
  • 必要なもの
  • フック(操作用、フィルター用)
  • インラインコメント
  • ヘッダー
  • 定數(shù)

WordPressにおけるHTMLとCSSの標(biāo)準(zhǔn)

WordPressのテーマとプラグインは厳格に従っています。HTMLコーディング標(biāo)準(zhǔn)。一貫性、アクセシビリティ、保守性を確保するためのものです。ガイドラインはセマンティックなマークアップを強(qiáng)調(diào)し、開発者がHTML要素を本來の目的に沿って使用することを奨勵(lì)しています。このアプローチは、コンテンツの構(gòu)造を強(qiáng)化し、検索エンジン最適化(SEO)のパフォーマンスを向上させます。

HTMLコード標(biāo)準(zhǔn)は、以下のガイダンスを提供しています:

  • バリデーションW3CバリデータすべてのHTMLページを検証し、マークアップが正しくフォーマットされていることを確認(rèn)します。
  • 自動(dòng)閉鎖エレメント- 自閉要素內(nèi)の前方スラッシュの前にはスペースを入れてください。
<!-- DO -->
<br />

<!-- DON'T –>
<br/>

屬性とタグ -すべての屬性とタグは小文字にすべきです。さらに、屬性値は機(jī)械が解釈する場(chǎng)合のみ小文字にすべきです。人間のために書かれた場(chǎng)合、見出しは正しい大文字を使うべきです。

<!-- DO -->
<a href="http://example.com/" title="リンク説明">説明文</a>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />

<!-- DON'T -->
<a href="http://example.com/" title="リンク説明">ここをクリック</a>

- すべての屬性は値を持ち、一重引用符か二重引用符のどちらかを使用しなければなりません。これらの値を引用符で囲わないと、セキュリティ違反になる可能性があります。


を入力してください。
 <!


 <!

圧痕- HTML のインデントは、常に論理構(gòu)造を反映したものでなければなりません。PHP と HTML を混在させる場(chǎng)合は、PHP ブロックを周囲の HTML コードに合わせてインデントします。

<!-- DO -->
<?php if ( ! have_articles() ) : ?>
<div class="article">
    <h1 class="article-title">見つかりません</h1>
    <div class="article-content">
        <p>結(jié)果は見つかりませんでした。</p>
        <?php get_error_msg(); ?>
    </div>
</div>
<?php endif; ?>

<!-- DON'T -->
<?php if ( ! have_articles() ) : ?>
<div class="article">
<h1 class="article-title">見つかりません</h1>
<div class="article-content">
<p>結(jié)果は見つかりませんでした。</p>
<?php get_error_msg(); ?>
</div>
</div>
<?php endif; ?>

これらのHTML標(biāo)準(zhǔn)に加えてWordPressのCSS標(biāo)準(zhǔn)もは、クリーンでモジュール化されたレスポンシブなスタイルシートを作成するのに役立ちます。コアコードからテーマ、プラグインに至るまで、コラボレーションとレビューのベースラインを設(shè)定します。これらのガイドラインは、コードが読みやすく、一貫性があり、理にかなっていることを保証するのに役立ちます。

WordPress CSS Code Standardsは、要素を配置するために特定のクラスを使用することを強(qiáng)調(diào)し、一貫性のある整理された構(gòu)造を促進(jìn)します。具體的には、以下のような基準(zhǔn)があります:

フレームワーク::

/* DO
各セレクタは、カンマまたは中括弧で終わる行に記述します。
各セレクタは、カンマまたは中括弧で終わる行に記述します。
閉じ中括弧は、開始セレクタと同じインデント?レベルを占めなければなりません。
閉じ中括弧は、始めのセレクタと同じインデントレベルを占めなければなりません。
#selector-2{を指定します。
    プロパティ: 値; }。
}

ピッカー::

/* DO
小文字を使用し、ハイフンで単語を區(qū)切ります。
屬性セレクタの値は二重引用符で囲んでください。
div.container.などの修飾しすぎのセレクタは避けてください。
#contact-form {
    property: value; }.
}
input[type="text"] {
    property: value; } を指定します。
}

因果性(発注者と供給者の接頭辭):

/* コロンとスペースでプロパティを追加します。
プロパティは小文字で、フォント名
また、省略記法を使用してください。
#selector {
    property: value; /* プロパティをコロンとスペースで追加します。
}

価値観::

/* 値の前にスペースを、値の後にセミコロンを追加します。
二重引用符を使用してください。
0 の値には単位を付けないでください。
小數(shù)値には先頭のゼロを使用します。
に対して複數(shù)のコンマ區(qū)切り値を指定します。
1つのプロパティに対して複數(shù)のカンマ區(qū)切り値をスペースまたは改行で區(qū)切ります。
#contact-form{(コンタクトフォーム
    font-family: "Helvetica Neue", sans-serif; opacity: 0.9; }.
    
    box-shadow.
        0 0 0 1px #5b9dd9、
        0 0 0 2px 1px rgba(20, 120, 170, 0.9);
}

メディアお問い合わせ::

/* メディアクエリに設(shè)定されたルールは、1階層分インデントされるべきです。
メディアクエリは、スタイルシートの一番下にメディアごとにグループ化しておきましょう。
media all and (max-width: 1024px) and (min-width: 780px) { @media all and (max-width: 1024px) and (min-width: 780px) {
    $selector {
        property: value; }.
    }
}
畫像[4] - WordPressコーディング標(biāo)準(zhǔn)入門 - Photon Flux|プロフェッショナル?ワードプレス修理サービス、グローバル展開、クイックレスポンス

2003年の設(shè)立以來、WordPressのHTMLとCSSのコーディング標(biāo)準(zhǔn)は、World Wide Web Consortium(W3C)のHTMLとCSSガイドラインに準(zhǔn)拠しています。W3C標(biāo)準(zhǔn)は、レスポンシブデザインの原則とセマンティックマークアップの統(tǒng)合を重視しており、HTML5とCSS3のリリース以降、テーマとプラグインの開発に影響を與えています。

W3C ガイドラインを採用することで、WordPress サイトがグローバルなウェブ標(biāo)準(zhǔn)に準(zhǔn)拠し、相互運(yùn)用性とユーザーエクスペリエンスが向上します。

WordPressでこれらのガイドラインを遵守することは、以下のターゲットを絞ることの重要性を強(qiáng)調(diào)しています。W3C HTMLマークアップバリデータHTMLの品質(zhì)検証を?qū)g行します。

これらのHTMLとCSSの標(biāo)準(zhǔn)は、WordPressのウェブサイトが視覚的に魅力的で、ユーザーフレンドリーであり、プラットフォーム間で効率的に表示されることを保証します。シームレスなユーザーエクスペリエンスをサポートし、WordPressエコシステムのさまざまな側(cè)面の開発者間のコラボレーションを促進(jìn)します。


お問い合わせ
チュートリアルが読めない?無料でお答えします!個(gè)人サイト、中小企業(yè)サイトのための無料ヘルプ!
カスタマーサービス WeChat
カスタマーサービス WeChat
電話:020-2206-9892
QQ咨詢:1025174874
Eメール:info@361sale.com
勤務(wù)時(shí)間: 月~金、9:30~18:30、祝日休み
? 複製に関する聲明
この記事はハリーが執(zhí)筆しました。
終わり
好きなら応援してください。
クドス0 分かち合う
おすすめ
解説 ソファ購入

コメントを投稿するにはログインしてください

    コメントなし