Tutoriel «HG3 Include Codes», inclure PHP dans WordPress

Tutoriel comment inclure du code (php, html, css, javascript ou autre) dans une page ou un article, directement dans l’éditeur visuel de WordPress.

Version 1.1 du 21 novembre 2011

HG3 Include Codes, version améliorée du plugin MaGiKS Proper PHP Include de Keith James Lock, permet toujours d’inclure du code dans l’éditeur visuel de WordPress, mais aussi de choisir le chemin du fichier à inclure en utilisant une syntaxe plus normale qui permet de mettre des blancs où on veut, d’ajouter un pseudo query au chemin du fichier à inclure (fichier?a=1, comme pour les urls), de passer une variable string ou int au fichier appelé et de choisir entre un simple include ou un include_once.

Tuto rapide

• Installez le plugin directement dans votre tableau de bord admin de WordPress : Extensions > Ajouter > Chercher > «hg3-include».
• Ou téléchargez le plugin en cliquant sur la pompe ci-dessus et mettez-le dans le dossier /wp-content/plugins/.
• Ou téléchargez le plugin chez WordPress en cliquant ici et mettez-le dans le dossier /wp-content/plugins/.
• Le mettre dans le dossier /wp-content/plugins/
• L’activer dans le menu « Extensions » de la page admin de WordPress
• Créer un fichier php contenant le code à inclure; par exemple test.php. Le chemin de départ du fichier est toujours la racine du site.
• Le mettre dans un dossier quelconque; par exemple dans wp-content/mondossier/
• Utiliser le shortcode suivant dans la page, l’article ou le widget où doit être inclus le code dont au sujet duquel :

[hg3_include ('test.php', 'wp-content/mondossier/')]

On peut utiliser une constante comme chemin :

[hg3_include ('test.php', MON_DOSSIER_INCLUDE)]

On peut demander un include_once à la place du include par défaut avec un boolean à true après le chemin :

[hg3_include ('test.php', MON_DOSSIER_INCLUDE, true)]

On peut ajouter un query au nom du fichier, style get d'url et récupérer la variable dans le fichier appelé. Dans l'exemple ci-dessous, la variable $a sera égale à 12 dans le fichier test.php. Et include_once sera utilisé, pas include.

[hg3_include ('test.php?a=12', MON_DOSSIER_INCLUDE, true)]

La variable par query ne peut être que numérique (pas de a="popol"), mais don't worry, papa a pensé à tout: on peut aussi passer une string plus conséquente en ajoutant un paramètre après le boolean de l'include. Dans l'exemple ci-dessous, la variable $a sera toujours égale à 12 dans le fichier test.php mais, en prime, on aura un magnifique "Tu la sens, ma grosse variable ?" dans $ouiii.

[hg3_include ('test.php?a=12', MON_DOSSIER_INCLUDE, false, ouiii = "Tu la sens, ma grosse variable ?")]

Précisions sur cette dernière variable:

• ➜ l'utilisation de cette variable n'est possible que si le boolean include/include_once est renseigné, true ou false.
• ➜ vous pouvez passer des int (var = 745) ou des strings (var = "Olé"). Pour les arrays, passez les valeurs séparées par une virgule dans une string et faites un explode dans le fichier appelé.
• ➜ pas besoin de coder les strings, le utf8 aque les accents du midi filent comme un pet sur une toile cirée, c'est de l'include pur jus, pas de l'url.
• ➜ les <br /> et \r ne passent pas, même échappés, l'éditeur visuel de WordPress les code à la volée, l'enfoiré. Si vous voulez quand même aller à la ligne dans cette variable - Qui c'est qui commande ? Merdalors ! - mettez-y vos <br /> et décodez au début du fichier à inclure les &lt;br /&gt; reçus.

Allez, c'est la fête, on ne se refuse rien, un petit bout de code pour ce faire:

$recu = str_replace('&lt;br /&gt;', '<br />', $recu);

Ou, pour se la péter, un autre bout de code avec des regex bien imbitables, qui fait exactement la même chose, mais moins vite.

$recu = preg_replace('/\&lt;br \/\&gt;+/', '<br />',$recu);

➜ Les autres variables - php ou autres - présentes dans la page où vous incluez votre code sont bien sûr disponibles pour le code en question (si c'est du php, dans le code qui est avant l'include). Par exemple, si vous avez besoin d'infos sur l'utilisateur courant dans le fichier test.php, vous pouvez faire un truc du genre :

if ( ! isset($current_user) ) $current_user = wp_get_current_user();

➜ Vous pouvez aussi inclure des fichiers html, javascript, css et autres merdouilles dans votre site usine à gaz qui ne ressemble déjà plus à rien tellement il est surchargé.

Yep, le javascript aussi, la preuve : cliquez ICI

Dernier truc : désolé pour les amateurs d'explosion E_COMPILE_ERROR, y'a pas d'option require ou require_once, allez vous trafiquez le code du plugin vous-même, les masos.

(N.D.L.F.D.R) C'est reparti ! Tu vas arrêter d'engueuler les lecteurs, oui ?
J'engueule pas, c'est juste que j'aime pas les requires, c'est tout. Ils me font peur, les requires.
(N.D.L.F.D.R) Il est dingue, ma mère m'avait bien dit de ne pas épouser un informaticien, ils sont tous givrés !

Tuto, complément pour les djeun's

Pour pas se prendre la tête avec des chemins à la con pour retrouver ses dossiers, genre

 ../../mais/merdeeeeee/ou/est/ce/putain/de/dossier/pourri

une bonne habitude est de créer des dossiers à un endroit précis et de déclarer leur chemin dans une constante, constante que l'on pourra utiliser sans se soucier de savoir où on se trouve dans la hiérarchie du site.

Ces déclarations de constantes se font dans le fichier « /wp-includes/default-constants.php » de WordPress. Par exemple, si on déclare

if ( !defined('MES_INCLUDES') )
     define( 'MES_INCLUDES', ABSPATH . 'mon_dossier/mes_includes/' );

ABSPATH étant la constante créée automatiquement par WordPress et contenant le chemin de la racine du site, généralement httpdocs/wordpress/, MES_INCLUDES contiendra donc httpdocs/wordpress/mon_dossier/mes_includes/

Pour peu que vous ayez effectivement créé les dossiers mon_dossier et mes_includes et que vous y ayez délicatement déposé un fichier mon_fichier.php, un simple appel en php, dans n'importe quelle page du site de

include (MES_INCLUDES.'mon_fichier.php');

vous permettra de retrouver vos petits sans s'emmerder avec les ../ susnommés.

Oui, ben NON, ça ne marche pas. Pas dans l'éditeur de WordPress qui ne vous laisse pas inclure de code dans vos articles. Et que si vous essayez, il va vous mettre des blancs dans vos codes ou vous les virer avec ses sales doigts crochus.

D'où l'utilité de ce plugin qui brise dans l'oeuf les velléités de prise de pouvoir de WordPress.

WordPress qui n'est qu'un assemblage de 0 et de 1, contrairement à nous, qui sommes beaux et qui sentons bon le sable chaud.

Et qui sommes totalement insensibles aux ⌘Q

Et on ne peut pas nous arracher la prise.