Recherche…


Syntaxe

  • add_shortcode( $tag , $func );

Paramètres

Paramètre Détails
$ tag (chaîne) (obligatoire) Balise de code abrégé à rechercher dans le contenu de l'article
$ func (appelable) (obligatoire) Crochet pour s'exécuter lorsque le shortcode est trouvé

Remarques

  • Le callback shortcode sera passé trois arguments: les attributs shortcode, le contenu shortcode (le cas échéant) et le nom du shortcode.
  • Il ne peut y avoir qu'un seul crochet pour chaque shortcode. Ce qui signifie que si un autre plugin a un shortcode similaire, il remplacera le vôtre ou le vôtre remplacera le leur selon l'ordre dans lequel les plugins sont inclus et / ou exécutés.
  • Les noms d'attributs de shortcode sont toujours convertis en minuscules avant d'être transmis à la fonction de gestionnaire. Les valeurs sont intactes.
  • Notez que la fonction appelée par le shortcode ne doit jamais produire de sortie d'aucune sorte. Les fonctions de code abrégé doivent renvoyer le texte à utiliser pour remplacer le shortcode. La production directe de la production entraînera des résultats inattendus. Ceci est similaire à la manière dont les fonctions de filtrage doivent se comporter, en ce sens qu'elles ne doivent pas produire d'effets secondaires attendus de l'appel, car vous ne pouvez pas contrôler quand et où elles sont appelées.

Shortcode simple pour post récent

add_shortcode est le mot clé wp.

// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');

// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
   query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
   if (have_posts()) :
      while (have_posts()) : the_post();
         $return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
      endwhile;
   endif;
   wp_reset_query();
   return $return_string;
}

Cet extrait peut être placé dans votre theme functions.php .

[recent-posts] Ceci est un shortcode pour le post récent. Nous pouvons appliquer ce shortcode au backend (pages, post, widgets).

Nous pouvons également utiliser le même shortcode dans notre code. avec l'aide de do_shortcode .
Par exemple. echo do_shortcode( '[recent-posts]' );

Shortcode avancé pour les messages récents

Cette fonction prend le paramètre pour combien de messages récents que vous souhaitez afficher.

Ex: vous ne souhaitez afficher que cinq publications récentes. Juste passé les arguments avec posts = "5" (vous pouvez passer n'importe quel nombre de messages récents que vous souhaitez afficher).

Fonction ne récupère que cinq publications récentes de la base de données.

// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');

// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
   extract(shortcode_atts(array(
      'posts' => 1,
   ), $atts));

   $return_string = '<ul>';
   query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
   if (have_posts()) :
      while (have_posts()) : the_post();
         $return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
      endwhile;
   endif;
   $return_string .= '</ul>';

   wp_reset_query();
   return $return_string;
}

Par exemple. echo do_shortcode( '[recent-posts posts="5"]' );



Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow