Fonctions utiles

  • dump : Afficher un debug
  • view : Rendre une vue
  • card : Rendre une card
  • e_tag : Rendre un tag
  • e_attr : Rendre un attribut
  • has_text : Vérifier si un texte est présent dans un champ texte

Afficher le debug d’une variable :

Pour afficher proprement le debug d’une variable, vous pouvez utiliser la fonction « dump ». La variable sera affiché de manière lisible à l’écran.

PHP
<?php dump($mavar); ?>

Rendre une vue :

Utilisation de la fonction render avec comme paramètres : render($viewname,$vars = array())

  • $viewname : Le chemin vers la vue depuis le répertoire views : blocs/texte/texte
  • $vars : Un tableau de paramètres libre passé à la vue

L’exemple si dessous inclu le fichier « /views/blocs/texte/texte.php » du thème si il existe, sinon du thème parent.

PHP
<?php
$vars = array("montexte"=>"Lorem Ipsum");
render('blocs/texte/texte', $vars);
?>

Rentre une card : card($post, $class)

  • $post : Un objet post wordpress (Page, Custom post type, SIT, etc.)
  • $class : Class à ajouter à la cards, facultatif

Cette fonction permet d’afficher la card d’un post wordpress, avec la detection de quel type de post il s’agit. (SIT, Articles, Page, etc.)

PHP
<?php
while (have_posts()){
global $post;
the_post();
card($post);
}
?>

Rentre un attribut : e_attr($attr_name, $value, $append, $separator)

Cette fonction permet d’afficher un attribut si une valeur est présente. Si la valeur est vide, l’attribut n’est pas affiché.
Des sous fonctions existent égalements, « e_style », « e_data », elles executent « e_attr » avec comme $attr_name « style » ou « data- » et ne prennent que « $value » et « $append ».

PHP
<?php
$target = "_blank";
$style = "text-transform: uppercase;";
?>

<a href="https://google.fr" <?php e_attr('target',$target); ?> <?php e_style($style); ?>>Exemple avec e_attr</a>

<a href="https://google.fr" <?php if($target){ ?>target="<?php echo $target; ?>"<?php } ?> <?php if($style){ ?>style="<?php echo $style; ?>"<?php } ?>>Exemple sans e_attr</a>

Rentre un tag : e_tag($tag_name, $content, $htmlAttrs)

  • $tag_name : Le nom du tag (p, div, etc.)
  • $content : le contenu html à afficher dans le tag
  • $htmlAttrs : Un tableau de params à ajouter au tag

Cette fonction permet d’afficher un tag html uniquement si tu contenu est présent. Si content est vide, rien n’est affiché.

PHP
<?php

$contenu = "";
e_tag('h2',$contenu,$attrs);
// ici, rien ne s'affiche car $contenu est vide

$contenu = "Hello World";
$attrs = array(
'class' => 'ma-class',
'id' => 'mon-id'
);

e_tag('h2',$contenu,$attrs);
// Affiche : <h2 id="mon-id" class="ma-class">Hello World</h2>

?>

Vérifier si un texte est présent : has_text($string)

Les wysiwyg ajoute parfois des balises HTML même si il n’y a pas de contenu, pour prévenir cela, on peut utiliser cette méthode qui retourne true ou false.