# Recherche d’administration

> Champ de recherche disponible dans les écrans de liste de l'administration, interrogeant titres et contenus pour retrouver rapidement une fiche.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/recherche-administration/

Retrouver un article dont on ne se souvient que d'un bout de titre, ou un utilisateur dont on connaît seulement le prénom : le champ de recherche présent en haut de chaque tableau d'administration rend ce genre de recherche possible sans avoir à parcourir des pages de pagination.

## Une simple façade sur WP_Query

Côté articles, cette recherche repose sur le paramètre `s` transmis à `WP_Query`, exactement comme la recherche publique du site : elle interroge par défaut les colonnes `post_title`, `post_content` et `post_excerpt` via une clause `LIKE` construite par la méthode privée `WP_Query::parse_search()`. Le filtre `posts_search` permet d'étendre cette logique à d'autres colonnes ou d'y intégrer une métadonnée personnalisée.

## Exemple : chercher aussi dans une métadonnée

```
<?php
add_filter( 'posts_search', function ( $search, $query ) {
    global $wpdb;
    if ( is_admin() && $query->is_main_query() && $query->get( 's' ) ) {
        $terme = $wpdb->esc_like( $query->get( 's' ) );
        $search .= $wpdb->prepare( " OR {$wpdb->posts}.ID IN (
            SELECT post_id FROM {$wpdb->postmeta}
            WHERE meta_key='reference' AND meta_value LIKE %s
        )", '%' . $terme . '%' );
    }
    return $search;
}, 10, 2 );
```

## Bon à savoir

- Cette recherche par défaut ne couvre pas les métadonnées personnalisées : sans filtre additionnel, une référence produit stockée en champ personnalisé restera introuvable.
- La recherche d'utilisateurs, d'un autre côté, s'appuie sur `WP_User_Query` et interroge par défaut le login, l'e-mail et le nom affiché, pas les métadonnées utilisateur.
- Sur une base volumineuse, une recherche non indexée sur des colonnes de type texte long peut devenir lente : envisagez une extension de recherche dédiée si le catalogue est important.