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.
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.
$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.)
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 ».
$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é.
$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.