WordPress用の簡単なFAQプラグインの作成方法

私たちは多くの前に見ました ブログのヒント とツール。 さて、今日はあなたのブログのための良いツールを作成する方法を学びます–FAQページプラグイン。 しかし、最も重要なことは、プラグイン自体だけでなく、この原則で何ができるかです。 WPサイトに任意のタイプのデータを保存する方法と、それを外部ライブラリ（jQuery UIなど）と統合してサイトのカスタムコンポーネントを作成する方法を学習します。 始めましょう！

アイデア、デモ、ダウンロード

ここでの目標は、多くのものに使用できるプラグインを作成することですが、FAQページにはうまく収まります。

しかしそれとは別に、私たちの主な業績は ワードプレスの理解 カスタムポストタイプ、ショートコード、外部JS / jQueryプラグインとのやりとり。 このアイデアを使えば、そこにある他のクレイジープラグインに基づいてたくさんのものを作ることができます。これはちょうどあなたの出発点です、親愛なるパダワンです。

So ここでjQuery APIデモを見つけることができます 使用するコンポーネントの場合–しかし、本当にすばらしいのは、そのコンポーネント（PHP）を生成するために使用するコードです。

ウォームアップ - プラグインファイルとカスタム投稿タイプ

まず、データを保存するカスタムポストタイプを作成する必要があります。

カスタムポストタイプはWPの魔法の大きな部分です。これにより、WPの関数を使用して呼び出しおよび操作できるように、新しいデータタイプ（ポスト、ページ、添付ファイルなど）を作成できます。 これは初心者には簡単に思えるかもしれませんが、DBにデータを接続して保存するだけの難しさを知っているのは、昔のPHPプログラマー（それでもまだですか？） 新しいデータ型を動的に作成することはもちろん、これは微妙ですが、コードに大きな柔軟性をもたらします。

私たちにはこのプラグインが必要ですが、すでにこのコンセプトに精通していると思います。 プラグインはWordPressのレゴブロックに似ていますが、簡単にプラグインできるコードを使用して現在の機能を追加または変換したり、必要に応じてプラグを抜いたりします。

WPがそれを認識できるようにプラグインを作成するには、2のものが必要です。

1. あなたのwp-content / plugins /
2. そのファイルの先頭にメタデータを追加すると、WPはその内容を理解できます

ファイル名は一意でなければならないので、誰かが自分のプラグイン（あなた自身でさえ）をインストールしても、現在のプラグインと競合することはありません。 私たちの場合、より良い組織のために、faq-whsrという名前の新しいフォルダを追加し、その中にfaq-whsr.phpというファイルを追加します。

メタダの場合は、プラグインファイルの先頭（直後に次のようなものを追加するだけです）

つまり、

• プラグイン名：wp-admin>プラグインインターフェースに表示される素敵な名前
• プラグインURI：プラグインのページ（ドキュメント、例、販売ページ）へのリンクを追加する場合
• 説明：これは、wp-admin> pluginsインターフェースに表示される小さな段落です。 ユーザーがそれが何のためにあるのかを思い出せるように、シンプルにしてください
• 作成者/著者URI：プラグインを作成した人物/会社、クレジットのリンク
• ライセンス：したがって、ユーザーはプラグインで何ができる/できないのかを知ることができます

OK、プラグインを作成し、関連するメタデータを追加しました。 プラグインファイルを保存するとすぐに、wp-adminインターフェイスで表示できるはずです。

それをアクティブにして、何が起こるか見てみましょう。

待って、何もない？ うーん、それは良いことです、何かが間違っていたら、今あなたはエラーを見るでしょう。 私たちのカスタムポストタイプの作成に移りましょう。

私たちのケースでは、CPTはFAQ項目ですが、書籍、ビデオ、功績などを作成することができます。 ここで留意すべき重要なことは、関数名が一意であることです。 関数名は一意でなければならず、関数名は一意でなければなりません。 とった？ これは、OOPを使用できるようになるまで（多くの場合、次のチュートリアルで多分）、多くの問題を解決します。

ウィザードは次のコードで実行されます：

そして、これは関連する部分が意味するものです：

• $ labels –wp-admin領域のさまざまなセクションのラベルとテキストを含む配列です。 したがって、WPはアイテムを呼び出す適切な方法を知っています
• サポート–これは、wp-admin> FAQ>新しい画面に表示される内容を示しています。 この場合、タイトル、エディター（メインコンテンツボックス）、作成者、リビジョン、およびカスタムフィールド（必要な場合）があります。
• タクソノミー–ここでは、許可されるタクソノミー（カテゴリ、タグ、またはカスタムタクソノミー）をWPに通知します
• register_post_type（ 'faq_whsr'、$ args）–これはWPに通知します 「ねえ、$ argsの引数を使用して、IDがfaq_whsrの新しいカスタム投稿タイプを作成します」.

それを保存して、あなたの息を止めてください。 メインのwp-adminメニューに新しいセクションが表示されるはずです

それじゃない？ うん。 このスニペットは、CPTの機能全体を作成します。 このクールが見つからない場合は、次のセクションでクーラーになるのを待ちます。

wp-adminを終了する前に、いくつかのダミーデータ（少なくとも2カテゴリを含むいくつかの質問）を追加してください。

フロントエンド - WP x jQueryインタラクション

ついに、何らかの行動を見なければなりません。 jQuery UIアコーディオン要素 このため。

jQuery UIには、jQuery自体とほとんど同じ利点があります。

• それに取り組んでいる多くの開発者
• クロスブラウザとモバイル対応のコード
• 十分に文書化
• WPでうまく演奏する（WP自体で使用する）

問題は今です：どのようにそれを呼び出すのですか？

これには2のアプローチがあります：

1. 悪い純粋 / tags in your wp_head
2. 素晴らしいwp_enqueue

今日は間違ったアプローチであまり時間を無駄にしませんが、良いのは基本的にWPを伝えることです "おい、おい、私たちのコードのある時点でjQuery UIが必要になります。ページにそれを含めてください"。 このようにWPは、他の誰かが既にそれを含んでいるのか、別のバージョンを含んでいるのかを確認し、重複したライブラリの問題を避けることができます。 さて、良いチャットをコードに変換するには？

エンキュー機能の使用：

ショートコード

それでwp-adminに戻ります。 私たちはFAQアイテムを持っています。私たちは必要なアイテムのスタイルを設定するためのライブラリを持っていますが、他に何が欠けていますか？ さて、私たちはアイテムを呼び出す必要があります！

これにはたくさんのオプションがありますが、この場合には簡単なコードを作成するのが最も簡単です。 ショートコードは、あなたのコンテンツフィールド（ページ、投稿、CPTなど）に追加するもので、WPは実際に実行する関数を検索します。 2タイプのショートコードがあります：

1. [自己完結型] –タグのようにまたはこの種のショートコードは、ある時点で関数を呼び出すだけです–これは私たちの男です
2. [ラップ]コンテンツ[/ラップ] –これはタグのようなものですまたは実際にその内容を変換したり、内容を引数として使用したりできます。

どのようにそれが動作するか見てみましょう。 wp-adminで新しいページを作成し、そこにこのコードを追加してください：

[faq-whsr]

保存してそのページにアクセスし、何が起こるか見る...

ちょうど冗談、それは正しいことをしませんか？ それは、まだ関数を作成していないからです。

これをあなたのプラグインファイルに追加してください：

今あなたのページをリフレッシュし、本当にクールなことが起こることを約束します。

冷静さ？ 今、あなたはそれが走っているのを見ることができ、空はあなたの限界です。 そのコードが行うことは、[faq-whsr]と呼ばれるショートコードがあることをWPに伝え、WPがそれを見つけた場合、WPはページのそのポイントで機能を実行する必要があります。

私たちの場合、jQuery UIパネルを作成するには、次の構造を実装する必要があります：

そしてそのために、 WPクエリFAQ項目とその内容を読み込みます。 短コード関数を次のように置き換えます。

OK、FAQアイテムが呼び出されます。 ここで行ったのは、wp_queryを呼び出してカスタム投稿タイプを呼び出し、それをショートコードリターンに渡して、WPが目的の構造に従ってすべてを表示するようにすることです。

それは良いことですが、何かが足りませんよね？ いくつかのオプションはどうですか？ さて、ショートコードのオプションを追加できます。ショートコードでWP_Query引数のいくつかを作成する方法を見てみましょう。

この方法で、次の引数を使用してアイテムを呼び出すことができます（必要な数だけ組み合わせることができます）。

• cat –カテゴリID（配列として複数追加）[faq-whsr cat = 1]
• category_name –カテゴリ名[faq-whsr category_name =” food”]
• order – ASCまたはDESC（DESCがデフォルトです）[faq-whsr order =” ASC”]
• orderby –アイテムの注文基準を変更します[faq-whsr orderby =” title”]
• posts_per_page –ロードされるアイテムの数を変更します[faq-whsr posts_per_page = 5]

しかし、私が言ったように、空はあなたの限界です。 実装して使用できるWP_Queryのオプションは次のとおりです。

• 著者
• カテゴリ（not_inで除外オプションを追加する）
• 検索（ユーザーに検索機能を提供したい場合はクール）
• カスタムフィールド（FAQアイテムにはカスタムフィールドと値を持つアイテムを読み込むために使用できるので）

今ではあなたの番です

あなたが見ることができるように、これはちょうど出発点に過ぎません。 このシンプルなプラグインを改善するために、私たちは皆、他にもたくさんのクールなことを学ぶことができます。ここで深く掘り下げるためのいくつかの提案があります：

• 応答デザイン
• ウィジェットの作成
• プラグインによるフックの有効化/無効化
• 国際化
• OOP
• 必要な場合にのみエンキューする（特定のページの場合）

コメントにあなたの考えを残すことを忘れないでください！ そして、ここに私たちの挑戦があります：ショートコードに「デフォルトアイテム」オプションを適用することは可能ですか（ページがロードされると、最初のアイテムではない別のアイテムが開きます）？ どうしますか？