キーテイクアウト

• WordPressプラグインボイラープレートシリーズの第3部は、プラグインのパブリック機能の実裝に焦點を當てています。
ガイドでは、テストのためのテーマを準備する方法、_contentフィルターにフックする方法、コンテンツを條件付きで変更する方法、および現(xiàn)在の時間と最後の修正時間の日の違いを計算する方法を説明します。
• 通知テキストのスタイリングについても説明し、著者は全體的なテーマデザインに合わせてシンプルなスタイリングガイドを提供します。著者はまた、さまざまなコンテキストの動的テキストや卻下可能な通知など、潛在的な改善を提案しています。
著者は、WordPressプラグインボイラープレートの利點を強調(diào)することで締めくくり、その明確な構(gòu)造、ベストプラクティスの順守、およびプラグイン開発のための確固たる出発點を持つことの時間節(jié)約の側(cè)面に注目しています。
• このシリーズの第2部では、プラグインの単純な管理機能を準備しました。ユーザーに、好みに応じてプラグインを調(diào)整できるオプションページを提供しました。
パート1と2を逃した場合は、以下を見つけてください：

WordPressプラグインボイラープレートパート1：WordPressプラグインボイラープレートを使用した開発をスピードアップ

WordPressプラグインボイラープレートパート2：WordPressプラグインの開発

この記事では、プラグインの公開機能を?qū)g裝します。これは、ユーザーの設定を取得し、その特定の投稿が時代遅れかどうかを判斷し、それに応じて単一の投稿ビューに通知を表示することを意味します。始めましょう！

• テーマの準備
• テーマを後でテストできるように、テーマを準備する必要があります。 WordPressでデフォルトで出荷される215のテーマを使用します。投稿を手動で埋め込むのではなく、テーマレビューチームが提供するテーマ単位テストデータを使用して、投稿を設定する予定です。
上記のCodexページに記載されているTheme-Unit-Test-Data.xmlをダウンロードして、WordPressのインストールにインポートする必要があります。 WordPressの組み込みインポート機能は、ツールにナビゲートして> SideBarからのインポートで見つけることができます。

さまざまな選択肢が提示され、WordPressエクスポートファイルをインポートするため、WordPressを選択します。 WordPressのインストールに応じて、WordPressインポータープラグインがインストールされていない場合、プラグインポップアップが表示されます。あなたがそれを持っていない場合は、最初にプラグインをインストールして、それが完了したら実際のインポートプロセスを続行します。 これはデフォルトのWordPressインポートページであるため、以前にダウンロードしたTheme-Unit-Test-data.xmlを選択し、[ファイルのアップロードとインポート]ボタンをクリックする必要があります。

2番目の畫面が表示されます。 「著者の割り當て」セクションについては、デフォルトのままにすることができるため、あまり心配しないでください。 「添付ファイルのインポート」セクションで、すべての外部添付ファイルがダウンロードされ、メディアライブラリにインポートされるように、「ファイル添付ファイルのダウンロードとインポート」というチェックボックスにチェックしてください。 「送信」ボタンを押して、インポートプロセスが正常に完了するまで待ちます。

今、私たちは通知を表示するコードを書く準備ができました。

the_contentフィルターに接続

The_Contentフィルターを使用することは、ユーザーに表示される投稿のコンテンツを変更するのに最適な方法です。以前のチュートリアルによると、define_admin_hooksの代わりにdefine_public_hooksメソッドが使用されるという唯一の違いは、ボイラープレートクラスローダーにフックを追加します。 このコードをメソッドに追加します：

これは、outstated_notice_publicクラスに公開the_contentメソッドを?qū)g裝する必要があることを意味します。 public/class-outdated-notice-public.phpを開き、それに応じて変更します

コンテンツを條件付きで変更します

the_contentフィルターはさまざまなプラグインと內(nèi)部のWordPressコアで使用されているため、カスタムコンテンツを挿入することに注意する必要があります。

<span>$this->loader->add_action( 'the_content', $plugin_public, 'the_content' );</span>

ブログ投稿インデックスではなく、単一の投稿が表示されるたびに、時代遅れの通知テキストを挿入することを確認する必要があります。そのためには、IS_MAIN_QUERY関數(shù)を使用してフィルタリングできます。この関數(shù)は、実行中のクエリがメインのクエリであるか、セカンダリ/カスタムクエリであるかを判斷する必要がある場合はいつでも便利です。

考慮する必要があるもう1つのことは、ポストタイプの投稿の単一ビューの通知テキストのみを表示することです。そのため、is_singular（ 'post'）検証は仕事に最適です。

これは、undated_notice_public classに含まれる更新されたthe_contentメソッドです。

日の差の計算

開始する前に、通知が投稿の「前」として表示されるように位置を設定しましょう。

最初に、プラグインの保存された設定を取得する必要があります。 get_option関數(shù)はジョブを行い、安全な尺度として、get_optionの2番目の引數(shù)としてデフォルト値を渡すつもりです。

<span>$this->loader->add_action( 'the_content', $plugin_public, 'the_content' );</span>

現(xiàn)在の時刻と最後の変更時刻の日の差を計算するには、2つのDateTimeオブジェクトをインスタンス化します。 DateTimeクラスに組み込まれているDIFFメソッドを使用して、時差を正確に測定できます。 DateTimeクラスはPHP> = 5.3.0でのみ利用可能です。

<span>public function the_content( $post_content ) {
</span>
		<span>if ( is_main_query() && is_singular('post') ) {
</span>			<span>// do something
</span>		<span>}
</span>
        <span>return $post_content;
</span>	<span>}</span>

$ date_diffはdateintervalクラスのインスタンスであるため、時間の違いに関して利用可能なさまざまなデータがあります。 $ date_diff変數(shù)をvar_dumpする場合、これはあなたが現(xiàn)在閲覧している投稿に応じて、私たちが取得する必要があるものです。

私たちの日數(shù)のしきい値に対する比較として使用されるため、日數(shù)にのみ関心があります。前にも言ったように、私たちはそれらを比較して、特定のクラスを通知div要素に適用して、投稿間で異なってスタイリングできるようにします。

<span>$position  = get_option( 'outdated_notice_position', 'before' );
</span>	<span>$days      = (int) get_option( 'outdated_notice_day', 0 );</span>

この単純な比較ブロックは、Divに使用するクラスを決定するのに十分です。今殘っている唯一のことは、ポストコンテンツに追加するHTMLを?qū)g際に構(gòu)築することです。

翻訳対応のテキストを改善するには、_N関數(shù)を使用して、投稿が最後に更新されてからの日數(shù)に応じて、使用する適切なテキストを選択的に選択します。次に、後でスタイルできるように、通知テキストを獨自のDivにラップします。通知テキストを自分の好みに合わせて微調(diào)整してください。

<span>$date_now  = new DateTime( current_time('mysql') );
</span>	<span>$date_old  = new DateTime( get_the_modified_time('Y-m-d H:i:s') );
</span>	<span>$date_diff = $date_old->diff( $date_now );</span>

$通知変數(shù)には、ポストコンテンツに挿入するマークアップが含まれている必要があります。殘っている唯一のことはそれを追加することです。

要約として、これはundated_notice_public內(nèi)のthe_contentメソッドが最終的に見えるべきです。

<span>object(DateInterval)#286 (8) {
</span>	  <span>["y"]=>
</span>	  <span>int(0)
</span>	  <span>["m"]=>
</span>	  <span>int(0)
</span>	  <span>["d"]=>
</span>	  <span>int(12)
</span>	  <span>["h"]=>
</span>	  <span>int(23)
</span>	  <span>["i"]=>
</span>	  <span>int(17)
</span>	  <span>["s"]=>
</span>	  <span>int(22)
</span>	  <span>["invert"]=>
</span>	  <span>int(0)
</span>	  <span>["days"]=>
</span>	  <span>int(12)
</span>	<span>}</span>

數(shù)ページでブラウジングを試して、プラグインが意図したとおりに機能しているかどうかを確認してください。これは、url /05/11/hello-world/。

<span>if ( $date_diff->days > $days ) {
</span>		<span>$class = 'is-outdated';
</span>	<span>} else {
</span>		<span>$class = 'is-fresh';
</span>	<span>}</span>

通知テキストのスタイリング

<span>// Filter the text
</span>	<span>$notice = sprintf(
</span>				<span>_n(
</span>					<span>'This post was last updated %s day ago.',
</span>					<span>'This post was last updated %s days ago.',
</span>					<span>$date_diff->days,
</span>					<span>'outdated-notice'
</span>				<span>),
</span>				<span>$date_diff->days
</span>			<span>);
</span>
	<span>// Add the class
</span>	<span>$notice = '<div >' . $notice . '</div>';
</span>	<span>$notice = sprintf( $notice, $class );</span>

邪魔にならずに全體的なテーマデザインとよく合うようになる、.outdated-dated-notice Divにいくつかの簡単なスタイリングを適用します。そのためには、すでに使用されているフォントサイズまたはフォントファミリに関しては何も変更しません。さらに、今のところブートストラップの配色とスタイリングを借ります。

Public/CSSフォルダー內(nèi)に含まれる時代遅れのnotice-public.cssファイルを開き、このルールを追加します。 また、新鮮さを表すために2つの異なるスタイルが必要です。これは、.ISのための1つのスタイルであり、別のスタイルは.isの別のスタイルです。このスニペットはトリックを行う必要があり、新鮮な投稿のための素敵な緑色の配色と、時代遅れの投稿のための赤い配色を與えてください。

投稿ビューを更新して、それがどのようにスタイルされているかを見てみましょう。新鮮で時代遅れの投稿の例：

それです！ WordPressプラグインボイラープレートに基づいて、完全に機能的なプラグインが開発されました。

改善

これまでに行ったことに基づいて改善できるさまざまなことがあります。その中には：

異なるコンテキストの動的テキスト。時代遅れの通知に異なるテキストを使用できます。

• 使用されていないため、時代遅れのnotice-public.jsスクリプトのenqueuingを削除します。 投稿を読むときにユーザーエクスペリエンスを中斷しないように
卻下可能な通知。
• 結(jié)論

WordPressプラグインボイラープレートは、プラグインをゼロから開発するのに最適な出発點を提供します。シリーズのこの最後の部分では、プラグインのパブリックに直面している機能を開発することで終了しました。修正は非常に単純ですが、少しの時間で行われますが、ボイラープレート自體によって確立されたOOPパターンを維持し、基準とベストプラクティスに準拠しています。

パート3ブランチのGitHubで通常どおりコードの完全なコピーが利用可能です。 WordPressプラグインボイラープレートに関するよくある質(zhì)問（FAQ）

WordPressプラグインボイラープレートとは何ですか？それが重要なのはなぜですか？

WordPressプラグインボイラープレートは、高品質(zhì)のWordPressプラグインを構(gòu)築するための標準化され、組織化され、オブジェクト指向の基礎です。特にWordPressプラグインの開発を初めての開発者に、理解しやすく、取り組むことができる明確で一貫した構(gòu)造を提供します。堅実な出発點を提供し、一般的なコードをゼロから書く必要性を減らすことにより、時間と労力を節(jié)約することが重要です。また、プラグインのコーディング、パフォーマンス、セキュリティ、保守性の向上におけるベストプラクティスを促進します。最初にGitHubリポジトリからダウンロードする必要があります。ダウンロードしたら、ボイラープレートのディレクトリとファイルの名前を変更して、プラグインの詳細に一致させることができます。ボイラープレートのコードは十分に構(gòu)成されており、カスタムコードをどこに配置するかを?qū)Г蓼?。メインプラグインファイルのプラグインヘッダーを更新して、プラグインの詳細を反映することを忘れないでください。

商用プロジェクトにはWordPressプラグインボイラープレートを使用できますか？ GPLの下でライセンスされているため、個人および商業(yè)プロジェクトの両方に使用できます。ただし、プラグインのドキュメントやクレジットでボイラープレートを認めることをお勧めします。

WordPressプラグインボイラープレートプロジェクトに貢獻するにはどうすればよいですか？

WordPressプラグインボイラープレートはコミュニティ主導のプロジェクトであり、貢獻はいつでも歓迎します。バグを報告したり、改善を提案したり、GitHubリポジトリにプルリクエストを送信したりすることで貢獻できます。貢獻する前に、プロジェクトの貢獻ガイドラインを必ず読んで理解してください。

WordPressプラグインボイラープレートの構(gòu)造は何ですか？

WordPressプラグインボイラープレートは、コードを整理するように設計された特定の構(gòu)造に従います。および管理可能。 「管理者」、「含まれる」、「パブリック」の3つのメインディレクトリで構(gòu)成されています。 「管理者」ディレクトリには、プラグインの管理者固有のサイドのCSS、JavaScript、およびPHPファイルが含まれています。 「含まれる」ディレクトリは、コアプラグインクラスとその他の共有関數(shù)を定義するために使用されます。 「public」ディレクトリには、プラグインのパブリック面のファイルが含まれています。

WordPressプラグインボイラープレートを使用してプラグインに新しい機能を追加するにはどうすればよいですか？プラグインの機能は、通常、「含める」ディレクトリにその機能の新しいクラスを作成します。このクラスは、機能を?qū)g行する必要があるすべてのフックを定義する必要があります。次に、メインプラグインクラスにこのクラスをインスタンス化し、「実行」関數(shù)に追加します。このモジュラーアプローチにより、プラグイン內(nèi)の機能を簡単に追加、削除、または変更できます。 「管理者」ディレクトリのプラグインオプションの処理。このクラスには、設定を登録するための関數(shù)、セクションとフィールドの定義、設定ページのレンダリングが含まれます。このクラスを拡張してプラグインの特定のオプションを処理することができます。

WordPressプラグインボイラープレートでプラグインを國際化するにはどうすればよいですか？ディレクトリ。このクラスは、プラグインのテキストドメインをロードし、他の言語に翻訳できるようにします。ボイラープレート內(nèi)のプレースホルダーテキストドメインをプラグインのテキストドメインに置き換えるだけです。 「管理者」および「パブリック」ディレクトリのスクリプトとスタイルを排除するため。これらのクラスには、スクリプトとスタイルを登録およびenqueする機能が含まれ、適切な場所で適切なタイミングでロードされるようにします。

WordPressプラグインボイラープレートでプラグインをきれいにアンインストールするにはどうすればよいですか？

WordPressプラグインボイラープレートには、WordPressダッシュボードからプラグインがアンインストールされたときに実行されるUninstall.phpファイルが含まれています。このファイルには、プラグインオプションやデータベーステーブルの削除など、クリーンアップコードが含まれている必要があります。これにより、プラグインがアンインストールされたときにトレースが殘さないようにします。

以上がWordPressプラグインボイラープレートパート3：最後の手順の詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。