Comment créer un plugin de recherche WordPress personnalisé

Comment créer un plugin de recherche WordPress personnalisé

En tant que puissant système de gestion de contenu, WordPress fournit de nombreuses fonctions puissantes par défaut, dont la fonction de recherche. Cependant, il arrive parfois que la fonction de recherche par défaut ne réponde pas pleinement à nos besoins. Dans ce cas, nous pouvons obtenir la fonctionnalité de recherche dont nous avons besoin en créant un plugin de recherche WordPress personnalisé. Cet article explique comment créer un plug-in de recherche personnalisé de base et donne des exemples de code correspondants.

Étape 1 : Créez le dossier du plugin

Tout d'abord, créez un nouveau dossier dans le répertoire du plugin WordPress pour stocker notre plugin de recherche personnalisé. Vous pouvez nommer le dossier « recherche personnalisée » ou tout autre nom de votre choix.

Étape 2 : Créez le fichier principal du plug-in

Créez un fichier principal dans le dossier du plug-in et nommez-le "custom-search.php". Il s'agit du point d'entrée du plug-in et comprend des informations de base qui définissent le plug-in et les fonctions requises pour activer le plug-in.

Ce qui suit est un exemple de code de base de "custom-search.php" :

<?php
/*
Plugin Name: Custom Search
Plugin URI: https://www.example.com
Description: This is a custom search plugin for WordPress.
Version: 1.0
Author: Your Name
Author URI: https://www.example.com
*/

// 在这里添加插件功能代码
?>

Dans ce fichier, nous devons fournir des informations de base sur le plug-in, y compris le nom, la description, le numéro de version et l'auteur du plug. -dans. Le code de fonctionnalité du plugin sera ajouté au bas de ce fichier.

Étape 3 : Ajouter un formulaire de recherche

Ajoutez un formulaire de recherche au fichier principal du plug-in pour saisir des mots-clés de recherche.

Ce qui suit est un exemple de code pour ajouter un formulaire de recherche :

function custom_search_form() {
    $form = '
        <form role="search" method="get" id="searchform" action="' . home_url('/') . '" >
            <input type="text" value="' . get_search_query() . '" name="s" id="s" placeholder="Enter your search keyword" />
            <input type="submit" id="searchsubmit" value="Search" />
        </form>
    ';
     
    return $form;
}

Dans cet exemple, nous utilisons la fonction home_url('/') pour obtenir l'URL de la page d'accueil du site Web et l'utiliser comme l'attribut du formulaire de recherche. La fonction <code>get_search_query() renvoie le mot-clé de recherche actuel, qui est utilisé pour le renseigner dans le formulaire de recherche. home_url('/')函数来获取网站的首页URL，将其作为搜索表单的action属性。get_search_query()函数返回当前搜索关键字，用于将其填充到搜索表单中。

第四步：处理搜索请求

在插件的主文件中添加处理搜索请求的函数。

以下是处理搜索请求的代码示例：

function custom_search_results() {
    $keyword = isset($_GET['s']) ? $_GET['s'] : '';
     
    if ($keyword) {
        $search_results = new WP_Query(array(
            's' => $keyword,
            'post_type' => 'post',
            'order' => 'DESC',
            'orderby' => 'date',
        ));
         
        if ($search_results->have_posts()) {
            while ($search_results->have_posts()) {
                $search_results->the_post();
                 
                // 在这里输出搜索结果的HTML代码
            }
        } else {
            echo 'No results found';
        }
         
        wp_reset_postdata();
    }
}

在这个例子中，我们首先通过$_GET['s']获取到搜索关键字。然后，我们使用WP_Query类来获取相关的搜索结果。通过在WP_Query对象的配置中设置s参数为搜索关键字，post_type参数为"post"，我们可以只搜索文章类型的内容。

在循环遍历搜索结果之前，我们需要使用have_posts()函数来判断是否有搜索结果。如果有搜索结果，我们可以使用the_post()函数来准备下一个搜索结果进行输出。你可以根据自己的需要自定义搜索结果的HTML代码。

第五步：注册插件的短代码

在插件的主文件中注册一个短代码，用于在网站中添加搜索表单。

以下是注册短代码的代码示例：

function custom_search_shortcode() {
    ob_start();
    custom_search_form();
    return ob_get_clean();
}
add_shortcode('custom_search', 'custom_search_shortcode');

在这个例子中，我们使用了ob_start()和ob_get_clean()来捕获搜索表单的输出，并将其作为短代码的返回值。我们可以使用add_shortcode()函数来注册短代码，并将自定义搜索表单的函数作为回调函数。

第六步：启用插件

保存插件的主文件，并通过WordPress的后台管理系统将插件启用。之后，你可以在任何希望添加搜索表单的位置使用[custom_search]

Étape 4 : Traiter la demande de recherche

Ajoutez la fonction pour traiter la demande de recherche dans le fichier principal du plug-in.

Ce qui suit est un exemple de code pour traiter une demande de recherche : 🎜rrreee🎜Dans cet exemple, nous obtenons d'abord le mot-clé de recherche via $_GET['s']. Ensuite, nous utilisons la classe WP_Query pour obtenir des résultats de recherche pertinents. En définissant le paramètre s comme mot-clé de recherche et le paramètre post_type comme "post" dans la configuration de l'objet WP_Query, nous ne pouvons rechercher que pour le contenu des types d’articles. 🎜🎜Avant de parcourir les résultats de recherche, nous devons utiliser la fonction have_posts() pour déterminer s'il existe des résultats de recherche. S'il y a des résultats de recherche, nous pouvons utiliser la fonction the_post() pour préparer le prochain résultat de recherche pour la sortie. Vous pouvez personnaliser le code HTML des résultats de recherche selon vos besoins. 🎜🎜Étape 5 : Enregistrez le shortcode du plugin 🎜🎜Enregistrez un shortcode dans le fichier principal du plugin pour ajouter un formulaire de recherche au site Web. 🎜🎜Voici un exemple de code pour enregistrer un shortcode : 🎜rrreee🎜Dans cet exemple, nous avons utilisé ob_start() et ob_get_clean() pour capturer la sortie du formulaire de recherche , et utilisez-le comme valeur de retour du shortcode. Nous pouvons utiliser la fonction add_shortcode() pour enregistrer un shortcode et utiliser la fonction du formulaire de recherche personnalisé comme fonction de rappel. 🎜🎜Étape 6 : Activez le plug-in 🎜🎜Enregistrez le fichier principal du plug-in et activez le plug-in via le système de gestion backend WordPress. Vous pouvez ensuite utiliser le shortcode [custom_search] pour afficher le formulaire de recherche là où vous souhaitez l'ajouter. 🎜🎜Résumé🎜🎜En créant un plugin de recherche WordPress personnalisé, nous pouvons obtenir la fonctionnalité de recherche dont nous avons besoin. Dans cet article, nous expliquons comment créer un plug-in de recherche personnalisé de base et fournissons des exemples de code correspondants. Vous pouvez étendre et améliorer davantage les fonctionnalités du plug-in en fonction de vos besoins et de votre niveau technique. Espérons que cet article vous aidera à créer un plugin de recherche personnalisé qui répond à vos besoins. 🎜

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!