Créer un plugin WordPress simple

Testez toujours le plugin dans un environnement local ou de préproduction avant de l'installer sur un site en ligne, et faites une sauvegarde.

Fonction : afficher un bandeau d'information configurable en haut du site pendant une période donnée.

bandeau-info/bandeau-info.php (extrait)

<?php
/**
 * Plugin Name:  Bandeau Info
 * Description:  Affiche un bandeau d'information configurable avec un texte et un lien.
 * Version:      1.0.0
 * Requires PHP: 8.1
 * Text Domain:  bandeau-info
 */

defined( 'ABSPATH' ) || exit;

add_action( 'admin_init', 'bandeau_info_register_settings' );
function bandeau_info_register_settings(): void {
	register_setting( 'bandeau_info', 'bandeau_info_options', array(
		'sanitize_callback' => 'bandeau_info_sanitize',
	) );
}

function bandeau_info_sanitize( $input ): array {
	$input = is_array( $input ) ? $input : array();
	return array(
		'text' => sanitize_text_field( $input['text'] ?? '' ),
		'url'  => esc_url_raw( $input['url'] ?? '' ),
	);
}

add_action( 'wp_body_open', 'bandeau_info_render' );
function bandeau_info_render(): void {
	$opts = get_option( 'bandeau_info_options', array() );
	if ( empty( $opts['text'] ) ) {
		return;
	}
	printf(
		'<div class="bandeau-info" role="region" aria-label="%s">%s <a href="%s">%s</a></div>',
		esc_attr__( 'Notice', 'bandeau-info' ),
		esc_html( $opts['text'] ),
		esc_url( $opts['url'] ?? '' ),
		esc_html__( 'Learn more', 'bandeau-info' )
	);
}

admin_init enregistre l'option via la Settings API, qui gère déjà le nonce du formulaire ; wp_body_open affiche le bandeau juste après l'ouverture de <body>. Les données sont nettoyées à l'enregistrement et échappées à l'affichage ; les chaînes sources restent en anglais, comme le recommande WordPress, et passent par le text domain…