WordPress : ajoutez un shortcode à afficher aujourd’hui avec un formatage et des calculs facultatifs

Le pouvoir d’afficher dynamiquement du contenu permet WordPress utilisateurs pour créer des expériences utilisateur plus attrayantes, à jour et pertinentes. Une application pratique de cette fonctionnalité dynamique consiste à utiliser des codes courts pour insérer du contenu personnalisé dans des publications, des pages et des widgets.

Cet article présente un shortcode personnalisé pour afficher la date et l’heure actuelles et même calculer les ajustements de date, le tout formaté en fonction de vos paramètres WordPress ou de vos préférences personnalisées. C’est semblable à un autre shortcode que j’ai partagé pour calculer le nombre d’années depuis une date précise. Cette fonctionnalité n’est pas seulement pratique ; cela change la donne pour les sites qui ont besoin de présenter du contenu opportun, tel que des avis d’événements, des offres spéciales ou des messages quotidiens.

Le aujourd’hui le shortcode affiche la date, l’heure et même le fuseau horaire d’aujourd’hui avec la flexibilité supplémentaire de formater la date et l’heure de sortie et de calculer les différences de date, le tout étant affiché dynamiquement à chaque fois qu’une page est chargée (tant qu’elle n’est pas mise en cache, bien sûr) .

Comment utiliser le shortcode d’aujourd’hui

Une fois configuré, l’utilisation du shortcode est simple. Il affichera par défaut la date et l’heure actuelles en fonction de vos paramètres WordPress. Par exemple:

Vous pouvez personnaliser cette sortie en spécifiant un format. WordPress propose une large gamme d’options de formatage de date et d’heure détaillées sur dans notre article sur les dates, que notre shortcode prend entièrement en charge. Par exemple:

[today dateformat="F j, Y" timeformat="g:i A"]

Si vous souhaitez afficher simplement l’heure actuelle, vous pouvez utiliser :

[today dateformat="" timeformat="g:i A"]

En option, vous pouvez également inclure le fuseau horaire.

[today dateformat="F j, Y" timeformat="g:i A" zoneformat="T"]

Calculs d’aujourd’hui

De plus, le shortcode prend en charge les calculs pour ajouter ou soustraire des jours, des semaines, des mois ou des années à la date actuelle :

[today calculate="+1 month" dateformat="F j, Y" timeformat=""]

Des calculs de temps sont également possibles :

[today calculate="+2 hours" dateformat="" timeformat="g:i A"]

Le shortcode offre un outil puissant aux propriétaires de sites WordPress, permettant un affichage de contenu dynamique qui peut améliorer considérablement l’engagement des utilisateurs et la pertinence du contenu. En suivant les directives et les exemples, vous pouvez exploiter ce shortcode à son plein potentiel, garantissant ainsi que votre site reste à jour, précis et opportun.

Shortcode WordPress pour aujourd’hui avec calculs et formatage facultatifs

function calculate_today_shortcode( $atts ) {
    // Fetch the WordPress-configured date and time formats as defaults
    $default_date_format = get_option('date_format', 'F j, Y');
    $default_time_format = get_option('time_format', 'g:i A');

    // Fetch and set the WordPress-configured time zone
    $timezone_string = get_option('timezone_string');
    if (empty($timezone_string)) {
        $offset = get_option('gmt_offset');
        $timezone_string = timezone_name_from_abbr('', $offset * 3600, false);
    }
    date_default_timezone_set($timezone_string);

    // Set default attributes and merge with user provided ones
    $atts = shortcode_atts(
        array(
            'dateformat' => $default_date_format, // Default date format
            'timeformat' => $default_time_format, // Default time format
            'calculate' => '', // No date calculation by default
            'zoneformat' => '', // Default zone format is blank
        ),
        $atts,
        'today'
    );

    // Calculate the date if needed
    $date = $atts['calculate'] ? strtotime($atts['calculate']) : time();

    // Initialize an empty string for the formatted output
    $formatted_output="";

    // Format and append the date if the dateformat is not empty
    if (!empty($atts['dateformat'])) {
        $formatted_output .= date($atts['dateformat'], $date);
    }

    // Format and append the time if the timeformat is not empty
    if (!empty($atts['timeformat'])) {
        // Add a separator if both date and time are being displayed
        if (!empty($formatted_output)) {
            $formatted_output .= ', ';
        }
        $formatted_output .= date($atts['timeformat'], $date);
    }

    // Append the time zone if zoneformat is not empty
    if (!empty($atts['zoneformat'])) {
        // Add a separator if date/time and zone are being displayed
        if (!empty($formatted_output)) {
            $formatted_output .= ' ';
        }
        // Use 'e' for the timezone identifier, 'T' for the timezone abbreviation,
        // or any other format supported in the PHP date function
        $formatted_output .= date($atts['zoneformat'], $date);
    }

    // Reset to the default timezone to avoid side effects
    date_default_timezone_set('UTC');
    
    return $formatted_output;
}
add_shortcode( 'today', 'calculate_today_shortcode' );

La magie derrière le shortcode d’aujourd’hui réside dans son PHP fonction, qui utilise WordPress add_shortcode fonction. Cette fonction récupère la date et l’heure actuelles, applique tous les calculs définis par l’utilisateur et formate la sortie selon les paramètres WordPress ou le format personnalisé spécifié dans le shortcode. L’ajustement dynamique au fuseau horaire configuré par WordPress garantit précision et pertinence pour tous les utilisateurs, quelle que soit leur situation géographique.

Nous soulignons également l’importance de définir le format par défaut pour qu’il corresponde aux paramètres de WordPress, garantissant ainsi la cohérence sur l’ensemble de votre site. Cette approche exploite la flexibilité de WordPress, permettant au shortcode de s’adapter automatiquement à la configuration de date et d’heure que vous avez choisie.

Meilleures pratiques : utilisation dans un plugin personnalisé

En ajoutant ce code à votre thème functions.php déposer peut être tentant, je vous recommande fortement de le placer dans un plugin personnalisé. Cette pratique garantit que votre shortcode reste fonctionnel et cohérent lors des changements de thème, offrant ainsi une expérience utilisateur plus stable et plus fiable.

L’intégration de tels shortcodes personnalisés dans votre boîte à outils WordPress élève votre stratégie de contenu et souligne la polyvalence et l’adaptabilité de WordPress en tant que système de gestion de contenu. Que vous soyez blogueur, spécialiste du marketing ou organisateur d’événements, le aujourd’hui le shortcode témoigne des possibilités créatives qu’offre WordPress.