ACF最近の投稿ウィジェット

ACF最近の投稿ウィジェット | Rafał Gicgier @wp-doin

説明

ACFRPWは、[外観]-> [ウィジェット]-> [ACF最近の投稿]ウィジェットに新しいウィジェットを追加します。ほとんどのフィールドは非常に明白であり、投稿を表示するための一連の設定から選択できます。
設定ごとに、サイドバーに表示される投稿の量と種類が変わります。

利用可能な設定
ウィジェットは次の設定をサポートします。

ウィジェットのタイトル
カスタムウィジェットコンテナCSSクラス
スティッキー投稿を無視するオプション
キーワードクエリを検索
IDベースの投稿の除外
日付表示、変更日、相対およびカスタム日付形式の仕様
特定の期間(開始および終了)からの投稿の一覧表示
特定のパスワードで投稿を一覧表示する、パスワードで保護された投稿のみを一覧表示する、またはこれらを除外する
投稿タイプの選択
投稿フォーマットの選択
投稿ステータスの選択
著者IDを介して著者に限定された投稿を一覧表示する
注文仕様(ASCまたはDESC)
Orderby仕様(ID、作成者、タイトル、日付、変更、ランダム、コメント数、メニューの順序、メタ値、メタ値の数値)
メタキーの仕様(規則としてメタ値またはメタ値の数値が選択された場合)
メタ比較の選択
メタ値の仕様(メタ比較の選択用)
カテゴリ制限
タグの制限
IDベースのカスタム分類制限
上記のルールに対するオペレーターの仕様
表示する投稿の数
スキップする投稿の数
サムネイル表示、サムネイルサイズ(幅、高さ)、サムネイルの配置、デフォルトのサムネイル
抜粋表示、単語制限、続きのテキスト(単語数が制限を超えた場合にのみ発生)
ループの前に表示するカスタムHTML
ループ後に表示するカスタムHTML
各投稿の前に表示するカスタムHTML。カスタムメタキーとACFフィールドをサポートします
各投稿の後に表示するカスタムHTML。カスタムメタキーとACFフィールドをサポートします
投稿が見つからない場合に表示するカスタムHTML
カスタムおよびデフォルトのCSS
カスタムHTMLテンプレート

ACFがサポートするフィールド
プラグインはACF4(無料)で作成およびテストされています。バージョン4.1.5ACF Proもサポートされているため、
ただし、コードの保証はありません。これはベータフェーズであり、ACFProがこれ以上大きくならない限り維持されます。
ACFフリーの違い。
プラグインは次のACFフィールドをサポートします。

テキスト
Textarea

Eメール
パスワード
Wysiwgエディター
画像
ファイル

他のフィールドはテストされておらず、現時点ではサポートされていません。
ショートコード
バージョン4.4以降、プラグインはショートコードの埋め込みをサポートします。オプションの量とその特定の名前(ショートコード属性など)を考慮して、shorcodeビルダーが導入されました
参考のために7番目と8番目のスクリーンショットを参照してください。
ACFRPWボタンをクリックするとポップアップが表示され、ショートコードコードを自動的に設定することができます。残りは、ここで指定されたすべてのオプションに従います。
ショートコードを使用するには、現在のページ/投稿タイプに対してWordPressエディターを有効にする必要があります。無効になっている場合(たとえばACF経由)、ボタンは表示されません。
カスタムテンプレートの作成
バージョン4.3以降、プラグインはカスタムテンプレートをサポートします。これらを使用するには、見つかったすべてのファイルのコピーを作成する必要があります
acf-recent-posts-widget / templatesディレクトリにあり、それらをアクティブなテンプレートディレクトリのacfrpwサブディレクトリにコピーします。
このアプローチは、WooCommerceプラグインの動作方法と似ていますが、欠点があります。すべての新機能により、ファイルが古くなる可能性があります。
ウィジェットテンプレートファイルと同様に、ショートコードビルド投稿リスト用に個別のカスタムマークアップを作成できます。 acf-recent-posts-widget / templateファイルをコピーします
アクティブなテーマディレクトリ内に作成されたacfrpw-blogディレクトリへ。
テンプレートファイル
3つの主要なテンプレートファイルがあります。

loop-after.php(各投稿の後にマークアップを表示し、マークアップコンテナを閉じます)
loop-before.php(各投稿の前にマークアップを表示し、マークアップコンテナを開きます)
loop-inner.php(投稿ごとに個別にキューに入れられ、すべての投稿のマークアップが含まれます)

使用法
使用法は非常に高度であるため、各テンプレートファイルには、その使用方法に関する非常に詳細なドキュメントが含まれています。
まず、テンプレートファイルでグローバル変数を削除してはなりません。これらの各変数はウィジェット設定を格納し、それを使用してコードを生成します。
次に、すべての変数名がわかりにくいため、loop-inner.phpテンプレートファイルには、使用されているすべての名前のリストが含まれています。これらの名前は抽出され、php変数として使用できます。
ウィジェット/サイドバーごとに異なるテンプレート
テンプレートを使用すると、各ウィジェットのマークアップを調整できます。まず、使用されているウィジェットIDを確認する必要があります。その後、ウィジェットIDを参照できます。
ウィジェットIDを格納する変数は$ acf_rpw_args [‘widget_id’]です。テンプレートに値をダンプすることは、ウィジェット用に作成された自動IDを見つけるための最良の方法です。
テンプレートを処理する最良の方法は、それらのコードから学ぶことです。私の個人的な提案は、テンプレートを現在のテーマにコピーして直接作業し、一度に1つの変更を行うことです。
テンプレートを使用するには学習曲線が必要であり、全員の問題に対する単一の答えはありません。
複雑な使用法
このセクションでは、プラグインの動作をより細かく制御したい上級ユーザー向けのプラグインの複雑な使用法について

説明

し、一般的でない機能についても

説明

します。
HTMLテキストエリアフィールドの使用
これらのセクションは明白ではないかもしれません。ループ全体の設定の前後のHTMLまたはテキストは、投稿リスト全体の前後に追加するカスタムHTMLマークアップを指定できる領域です。
各投稿の前後のHTMLまたはテキストは、カスタムHTMLを指定できるだけでなく、メタキーまたは特定のACFフィールドを印刷する機能も提供されます(ACFでサポートされているフィールドを参照)。
メタキー名/ ACFの使用法
これらのフィールドは、{metaname}または{acffield_name}タグ(ショートコードに似ています)内にラップする必要があります。プラグインはこれらのフィールドを解析し、それに応じた値を出力します。テキストタイプのカスタムACFフィールドがあり、フィールド名が「テキスト」であるとします。
その値を印刷するには、befoe内/各投稿textareaの後に[acftext]を使用する必要があります。同様の解決策がメタキーに適用されます。
メタ値の使用
[メタ値]フィールドは要素の配列をサポートしているため、すべてのmeta_compareパラメーターを使用できます。これを行うには、たとえば1234; 12345のようにセミコロンで区切って2つのパラメーターを指定してください。
プラグインはこれらを配列に変換し、2つに適切な操作を適用します。さらに、[日付]ショートコードはここで使用できます。タイムスタンプパラメータを引数として取りますが、これは必須です–可能な引数はと同じです
ここで

説明

されている関数:http://php.net/manual/pl/function.strtotime.php。たとえば、[date +1 day]は、明日の日付を「Ymd」形式で生成します。
これは、カスタムメタフィールド日付で使用できます。
プラグインフィルター
プラグインをプログラムで強化するために使用できるいくつかのフィルターは次のとおりです。

「acf_rwp_query」は、各ウィジェットに適用されるクエリをフィルタリングする機能を提供します。
「acp_rwp_before」は、各投稿の前にプラグインのフロントエンド出力をフィルタリングする機能を提供します。 [acf]と[meta]のショートコードの使用を可能にする2つのフックがすでにここに接続されています。
「acp_rwp_after」は、各投稿後にプラグインのフロントエンド出力をフィルタリングする機能を提供します。 [acf]と[meta]のショートコードの使用を可能にする2つのフックがすでにここに接続されています。
meta_valueクエリパラメータをフィルタリングする「acf_meta_value」。

引数と使用例については、acf_widget_widgetファイルを確認してください。
依存関係

ACF(オプション)

ウィジェット基本クラス(含まれています)

ショートコードポップアップジェネレーター(付属)

その他

オンラインデモ
プラグインサイトとドキュメント
プラグイン開発調査

サポートされている言語

英語(デフォルト)
ポーランド語(2015年5月11日以降)
フランス語(2015年6月29日以降)、wolforg、スタンドアロンソース

スポンサー
後援:Infolinks、WordPressサイトのスマート広告。

インストール

このセクションでは、プラグインを

インストール

して機能させる方法について説明します。

acf-widget.zipを/ wp-content / plugins /ディレクトリにアップロードして解凍します
WordPressの[プラグイン]メニューからプラグインをアクティブ化します
ACF最近の投稿ウィジェットをサイドバー領域にドラッグアンドドロップします

プラグインの作者

Rafał Gicgier @wp-doin

プラグインの公式ウェブサイトアドレス

https://wordpress.org/plugins/acf-recent-posts-widget/
ACF最近の投稿ウィジェットプラグインの使用で問題が発生した場合は、以下にコメントしてください。問題の解決に最善を尽くします

コメントする

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です