Il s'agit du fichier principal de votre thème WordPress. Situé dans /wp-content/themes/(nom de votre thème ici)/functions.php.
Il définit les propriétés importantes du thème, personnalise les hooks, l'apparence et les fonctionnalités, et ajoute certaines des fonctionnalités dont vous avez besoin. Ce fichier est chargé à chaque fois que vous ouvrez une page WordPress, vous pouvez donc l'utiliser pour modifier n'importe quel élément du site. A ce propos, de nombreux conseils à la " comment changer quelque chose dans WordPress sans plugins » concernent souvent spécifiquement la modification de function.php, au lieu de créer un plugin séparé pour cette fonctionnalité ou d'utiliser une solution prête à l'emploi. Cela conduit souvent à une surcharge d'informations dans le fichier, rendant le code difficile à analyser et rendant les corrections encore plus difficiles. Mais ce n’est pas la chose la plus dangereuse. Le plus dangereux c'est que Lorsque vous changez le thème actif, tout ou partie des fonctionnalités nécessaires du site disparaîtront.

Quelle est la différence entre function.php et un plugin ?

Rien. À la base, function.php est une sorte de plugin global non désactivé lié au thème actuel. Vous pouvez voir comment il est connecté dans WordPress dans wp-settings.php. Comme le montre le code source, il est chargé après tous les plugins, cependant, cela ne présente aucun inconvénient ni avantage, à l'exception peut-être de la possibilité de remplacer quelque chose dans les plugins connectés. Cela n’affectera pas non plus la vitesse d’exécution du code. Seul le contenu des plugins et des fonctions.php est concerné. Par conséquent, soyez prudent lorsque vous choisissez des plugins actifs pour votre thème et supprimez ceux inutiles qui vous sont peu utiles, vous pourrez alors rendre votre site plus facile et accélérer son fonctionnement.

Quand utiliser Functions.php

Suivez cette règle : si la fonctionnalité est directement liée au thème actuel, mais pas au fonctionnement du site, écrivez-la dans fonctions.php.

Par exemple, cela pourrait être

• Configuration des vignettes
• Définition des tailles de la barre latérale
• Configuration des emplacements pour les widgets
• Déclarer des lieux sous le menu de navigation
• Réglage des thèmes
• Fonctionnalités supplémentaires de votre thème

Quand éviter d’utiliser Functions.php

Si la fonctionnalité doit fonctionner même lorsque le thème actif est modifié, vous devez veiller à le déplacer dans un plugin séparé.
Cela peut inclure :

• Détermination des compteurs de trafic (Google Analytics, Yandex.Metrika, Liveinternet)
• Configuration de fonctionnalités d'administration supplémentaires (par exemple)
• Configuration du code source()
• Définir des codes courts
• Inscription

Les listes sont incomplètes, vous pouvez déterminer vous-même leur contenu.

Où dois-je mettre ce code sinon dans Functions.php ? Vous pouvez écrire des plugins spéciaux pour eux, cependant, il existe un moyen plus intéressant et plus simple.

mu-plugins comme alternative à Functions.php

Une fonctionnalité intéressante nous est parvenue dans les versions modernes de WordPress de WordPress MU (Multi-User), appelée Plugins MU. Son essence était la suivante. L’administrateur WordPress MU avait parfois besoin de définir des plugins pour tout un réseau de sites. Cela ne pouvait pas être réalisé avec les fonctionnalités habituelles, c'est pourquoi une section spéciale a été introduite : /wp-content/mu-plugins/, où ils ont été définis. Une autre chose intéressante est que les fichiers plugins de ce répertoire sont chargés avant tous les autres, ce qui permet de prédéfinir certaines constantes ou paramètres.
Plus tard, WPMU a été aboli, son code a été intégré au blog principal et désormais, n'importe quel WordPress peut utiliser la fonctionnalité des plugins MU, qui signifie désormais Doit utiliser, c'est-à-dire obligatoire pour l'utilisation.

Comment utiliser les plugins mu

Vous devez d’abord créer une section spéciale /wp-content/mu-plugins/
Nous y plaçons les fichiers de plugin nécessaires. Contrairement aux plugins classiques, il n'est pas nécessaire de maintenir une syntaxe spéciale et les fonctionnalités peuvent être déclarées directement.

Ici, à titre d'exemple, un fichier avec le code du compteur de présence a été créé.
L'intérieur de ce fichier ressemble à ceci

// ...A la place de cette ligne, insérez le code du compteur...

Dans le panneau d'administration, cela ressemblera à Requis

Salutations, amis. Aujourd'hui, nous allons découvrir comment faire fonctionner n'importe quel code PHP dans des widgets, des articles et sur des pages WordPress. Par défaut, une telle fonction n'est pas disponible dans ce CMS et le maximum sur lequel un utilisateur peut compter est l'implémentation du code HTML.

Pourquoi le code PHP ne fonctionne pas par défaut

Il semblerait que les développeurs n'aient pas récompensé un moteur aussi populaire et pratique avec des capacités utiles pour l'exécution automatique du code PHP. Au début, j'y ai pensé, mais je suis arrivé à la conclusion que cette politique est menée du point de vue de la sécurité, car une utilisation inappropriée de PHP dans les widgets ou dans les publications peut entraîner des conséquences irréparables - quelque chose va se briser dans la base de données et dans l'ensemble du site. va planter.

Par conséquent, travailler avec PHP est laissé aux programmeurs ou à des personnes plus ou moins avancées en la matière - tous les scripts sont exécutés directement dans les fichiers.

Pour les sites publics (où il y a plusieurs auteurs), exécuter PHP dans le corps d'un article augmente le risque de sabotage délibéré, puisque n'importe quel auteur peut accéder pleinement au site via la fenêtre d'édition de l'article.

Selon le degré de danger, je diviserais toute cette situation en 3 niveaux :

1. Laisser tout comme les développeurs l'ont prévu est difficile d'endommager le site en toute sécurité, accidentellement ou intentionnellement.
2. Autoriser l'exécution de PHP dans les widgets – niveau de danger moyen, seul l'administrateur du site y a accès.
3. Utiliser du code partout est dangereux, puisque toute personne autorisée à éditer des articles et des pages (modérateurs, auteurs) peut gérer le site.

Pourquoi avez-vous besoin de PHP dans les widgets ?

La question est individuelle, puisque tout peut être implémenté avec ce langage de programmation. Personnellement, j'ai été incité à écrire cet article par une commande d'un client dont je suis actuellement en train de créer le site Web. Il était nécessaire d'afficher dans la barre latérale d'un widget séparé une liste d'actualités d'une catégorie - « Actualités ». Les widgets WordPress standard n'ont pas cette fonctionnalité.

La question était entre trouver un plugin doté des fonctionnalités appropriées ou utiliser du code PHP simple. Le script pour une telle tâche est vraiment petit et je ne voulais pas charger le site avec un plugin supplémentaire qui ne serait utilisé nulle part ailleurs.

De manière générale, en permettant à PHP de s'exécuter, on peut résoudre 2 problèmes :

• Remplacez certains plugins du site par des scripts et réduisez ainsi la charge sur l'hébergement ;
• Implémentez des fonctions pour lesquelles les plugins n'existent pas encore.

Dans un premier temps, je parlerai des widgets, puis, dans un bloc séparé, de la sortie de code dans le contenu.

Plugins PHP dans les widgets

L'avantage des plugins : Lors du changement de thème WordPress, les fonctions ajoutées au modèle ne sont pas perturbées ; tout continue de fonctionner sans nécessiter l'intervention du webmaster. Les hooks ajoutés au modèle lors du changement de thème devront être transférés manuellement vers le nouveau.

Dans mon exemple ci-dessus, je crée un site Web pour un client et s'il souhaite modifier le design lui-même, les paramètres définis via les fichiers function.php et autres disparaîtront, je lui facilite donc la tâche au maximum. pour gérer le site, en s'appuyant sur des plugins (surtout dans sa niche, le trafic est faible et il n'y aura pas beaucoup de charge).

Widget de code PHP

J'utilise ce plugin dans mon travail depuis longtemps ; il s'ajoute à la liste des widgets disponibles, similaire à un widget de texte normal, capable uniquement de traiter PHP en plus du texte et du HTML.

PHP Code Widget est présent dans le référentiel officiel WordPress et peut être facilement trouvé par son nom. Comment installer de tels plugins.

Aucun paramètre n'est requis, le widget apparaîtra dans la liste immédiatement après l'installation et l'activation du plugin. Faites glisser « Code PHP » vers la barre latérale et ajoutez-y n'importe quel script.

PHP dans le widget WordPress sans plugin

Dans ce cas, nous aurons besoin d'un hook qui remplacera la fonction standard qui permet au widget texte WordPress de fonctionner avec une fonction qui permet de traiter PHP.

Ce hook est ajouté au fichier function.php du thème courant (tout à la fin avant la parenthèse fermante ?>). Après cela, aucune nouvelle option de widget n'apparaît, comme c'est le cas avec le plugin ; les codes PHP commencent à fonctionner en texte standard.

Code prêt :

Add_filter("widget_text"," text_html_php_widget ",100); fonction text_html_php_widget($text) ( if(strpos($text,"".$text); $text = ob_get_contents(); ob_end_clean(); ) return $text; )

La première ligne est un filtre qui remplace la fonction de widget de texte standard par une nouvelle à chaque fois qu'elle est appelée - text_html_php_widget, puis il y a une description de la nouvelle fonction elle-même.

Pourquoi le code PHP dans les articles et publications WordPress

Dans les publications, le code PHP exécutable est beaucoup moins souvent requis que dans les widgets, donc dans la première partie de l'article, j'ai examiné séparément la barre latérale afin que vous puissiez éviter de connecter inutilement des fonctions potentiellement dangereuses.

Mais même dans les publications, il est nécessaire d'utiliser des scripts. L’exemple le plus courant est l’affichage d’un plan du site sans plugin. Certes, vous pouvez utiliser une autre technique pour la carte : créer un modèle de page spécial (il s'agit d'un sujet distinct).

Une fois, j'avais besoin d'une sortie PHP dans le but suivant :

J'ai créé un site Web vidéo. Les épisodes de la série étaient affichés dans des playlists par saison, et sous chaque playlist de la saison il fallait afficher une liste d'épisodes avec un lien vers votre page. Cela ressemble à un plan du site, mais en plus compliqué : la conclusion devait être tirée de listes de sections individuelles. Il était possible de saisir manuellement chaque lien grâce au code HTML, mais il y a plusieurs centaines d'épisodes et la procédure est fastidieuse. De plus, si une nouvelle série apparaissait, un lien vers celle-ci devrait être ajouté manuellement, ce qui n'est pas pratique. J'ai donc décidé d'utiliser les fonctions PHP pour l'implémentation.

Plugin pour l'exécution de PHP dans le contenu Exec-PHP

Malgré le fait que ce plugin n'ait pas été mis à jour depuis 7 ans, il fait parfaitement son travail. Et je l'ai choisi pour une raison : il n'utilise aucun shortcode, comme ses concurrents, mais permet d'insérer du code pur dans les articles WordPress, en commençant par .

Le plugin Exec-PHP se trouve dans le référentiel et est installé via le menu du panneau d'administration du moteur.

Parmi les paramètres, il n'y en a qu'un - autorisation/interdiction d'exécution de code dans un widget de texte, il n'y a pas d'option pour désactiver le travail dans les publications et sur les pages, si vous devez le supprimer, désactivez le plugin.

Pour insérer du code PHP dans un article, il faut le passer en mode HTML (onglet Texte). Le mode visuel gâchera très probablement le code.

Exécuter du code PHP dans des articles WordPress sans plugin

Par analogie avec les widgets, on peut remplacer le plugin par une fonction spéciale qui permet l'exécution de scripts PHP dans le contenu. Malheureusement, je n'ai pas pu trouver d'option dans laquelle le code fonctionnerait automatiquement comme dans le cas d'un plugin, réagissant aux balises. Nécessite l’utilisation d’un shortcode. Ma connaissance de PHP n'était pas suffisante pour écrire moi-même la fonction requise, je la présente donc telle quelle. Travailler avec un shortcode présente un inconvénient important qui complique le travail, j'en parlerai ci-dessous.

Comment utiliser la fonction ci-dessous

1. Nous le collons dans le fichier function.php du thème ;
2. Au bon endroit dans l'article nous insérons la construction - code exécutable sans

Fonction:

/* Exécution de php dans les articles et pages WordPress : code */ function start_php($matches)( eval("ob_start();".$matches."$inline_execute_output = ob_get_contents();ob_end_clean();"); return $inline_execute_output ; ) fonction inline_php($content)( $content = preg_replace_callback("/\((.|\n)*?)\[\/startphp\]/", "start_php", $content); $content = preg_replace( "/\((.|\n)*?)\[\/startphp\]/", "$1", $content); return $content; ) add_filter("the_content", "inline_php");

Défaut

Si le code PHP inséré contient des inserts HTML ou du texte, cela ne fonctionnera pas. Tout texte ou balise devra être inséré à l'aide de la commande echo, ce qui n'est pas toujours pratique. Autrement dit, le code doit être purement PHP avec 100 formats corrects.

Droite

Echo « Voici comment cela fonctionnera » ;

Faux

Echo "Cette ligne est correcte" ; Ça ne marchera pas comme ça

Il n'y a pas de problème de ce type dans le plugin Exec-PHP - le texte et le HTML seront exécutés, mais tous les éléments du code PHP doivent être encadrés dans les balises appropriées.

Pour de nombreux webmasters, le sujet décrit dans cet article ouvre des possibilités infinies de créativité - vous pouvez implémenter quelque chose qui ne pouvait pas être fait auparavant, ainsi que vous débarrasser de nombreux plugins, en les remplaçant par différents filtres, fonctions et hooks.

Toutes les personnes familiarisées avec WordPress ont entendu parler du fichier de thème (modèle) function.php. Cependant, tout le monde ne comprend pas bien son objectif, le considérant uniquement comme un fichier stockant diverses fonctions PHP. Sur Internet, comme sur mon site, il est souvent proposé d'ajouter du code PHP à ce fichier. Cependant, tous les codes ne fonctionneront pas pour ce fichier. Non pas parce que ça ne marchera pas, mais parce que ça ne rentre pas dans la logique d’utilisation.

De plus, lors de l'édition de fonctions.php, les débutants commettent des erreurs à cause desquelles le site cesse de fonctionner.

Dans cet article, je vais essayer de considérer tous ces points : quand utiliser Functions.php et quand il vaut mieux ne pas le faire, quelles erreurs peuvent survenir lors de l'édition de Functions.php.

Caractéristiques fonctions.php

function.php se trouve dans le dossier du thème et est chargé à chaque fois, lors de la visualisation de la partie externe du site, dans le panneau d'administration, et même lors des requêtes AJAX. Il n'y a aucun cas où Functions.php ne sera pas inclus et cela ouvre de larges opportunités pour les développeurs.

Par exemple, le code suivant inséré dans le fichier function.php du thème étendra les capacités du thème en activant la prise en charge des miniatures de publication :

Add_action("after_setup_theme", "wp_kama_theme_setup"); function wp_kama_theme_setup())( // Prise en charge des vignettes add_theme_support("post-thumbnails"); )

Autre exemple, le code remplacera le texte du pied de page du panneau d'administration WordPress par des données sur le nombre de requêtes de base de données, le temps de génération des pages et l'utilisation de la mémoire :

## Données sur le nombre de requêtes vers la base de données dans le panneau d'administration add_filter("admin_footer_text", "wp_usage"); // dans le panneau d'administration add_filter("wp_footer", "wp_usage"); // sur le site web, fonction wp_usage())( echo sprintf(__("SQL : %d in %s sec. %s MB", "km"), get_num_queries(), timer_stop(0, 3), round(memory_get_peak_usage () /1024/1024, 2)); )

fonctions.php vs plugins

- "Les plugins fonctionnent plus lentement que le code du fichier function.php", disent les ignorants - ce n'est pas vrai !

En théorie, insérer du code dans Functions.php revient à installer un plugin, mais ce n'est pas la même chose. Après tout, lorsque nous changeons de thème, nous obtiendrons un fichier function.php complètement différent et toutes les modifications apportées seront perdues, mais le plugin restera, peu importe à quel point le thème est modifié. Pour ces raisons, nous devons nous référer au fichier function.php. Si la fonctionnalité ajoutée concerne non seulement le thème, mais également le site dans son ensemble, alors vous devriez penser à la connecter en tant que plugin.

Le deuxième exemple ci-dessus est « Données sur le nombre de requêtes vers la base de données dans le pied de page du panneau d'administration ». Logiquement, il ne convient pas à une utilisation dans le fichier function.php. Parce que si nous changeons le modèle, nous perdrons cette fonctionnalité, mais elle est utilisée dans le panneau d'administration et est nécessaire quel que soit le thème utilisé.

Alors supprimons-le de function.php et faisons-en un plugin - c'est facile !

Pour créer un plugin, vous devez créer un fichier avec le code ci-dessous (le nom du fichier peut être n'importe quoi), l'ajouter au répertoire du plugin wp-content/plugins/ et activer le plugin dans le panneau d'administration :

Si vous ne souhaitez pas voir un autre plugin dans le panneau d'administration, vous pouvez utiliser les plugins Must-Use.

Que fait réellement function.php ?

Comme je l'ai écrit plus haut : function.php est nécessaire afin d'étendre les fonctionnalités du thème et uniquement pour cela ! Dans ce fichier, vous devez ajouter tout code nécessaire au modèle lui-même, mais pas au site dans son ensemble.

Si sur une ressource il vous est demandé d'ajouter du code au fichier function.php et que la fonction du code n'est pas directement liée au modèle, alors ne soyez pas paresseux pour créer un plugin à partir de ce code et peut-être qu'à l'avenir vous le ferez éviter la perte inattendue de fonctionnalités précédemment ajoutées.

Comment fonctions.php est chargé

function.php est inclus lors de l’initialisation du thème actuel, une fois que toutes les fonctions WordPress et tous les plugins actifs sont activés. Je vais décrire brièvement la chronologie de chargement de WordPress, où vous pouvez voir quand des fichiers importants sont connectés :

Index.php wp-blog-header.php wp-load.php wp-config.php wp-settings.php // Les fonctions les plus basiques sont connectées (connexion à la base de données $wpdb et au système de filtrage) // Les filtres de base sont connecté // SHORTINIT : Arrêt du chargement, où il n'y a que le plus basique : if (SHORTINIT) return false ; // tout l'environnement WordPress est connecté : fonctions de base, filtres // les plugins indispensables sont connectés, puis l'événement est déclenché : do_action("muplugins_loaded"); // les plugins activés sont connectés, puis l'événement est déclenché : do_action("plugins_loaded"); // les variables globales sont définies : wp_the_query, wp_query, wp_rewrite, wp, wp_widget_factory, wp_roles ... do_action("setup_theme"); // installe le thème actuel // connecte le fichier du thème >>>>>>>>>>>>> function.php<<<<<<<<<<<< do_action("after_setup_theme"); // событие, когда среда WP, все плагины и тема полностью подключены, но на экран еще ничего не выведено: do_action("init"); // проверка статуса сайта для мультисайтовой сборки // тоже самое что init только после проверки статуса (до этой строки работа PHP может не дойти) do_action("wp_loaded"); wp() // заполняет основной запрос WP и все глобальные переменные связанные с ним wp-includes/template-loader.php // подключает нужный файл шаблона

Le processus de chargement de WordPress, et de function.php en particulier, est bien illustré dans cette figure :

Erreurs dans function.php lors du collage du code

J'ai rencontré à plusieurs reprises des questions sur des erreurs, telles que : "Après avoir installé le code dans le fichier function.php, le site a cessé de fonctionner - un écran blanc. Que dois-je faire ?" J'ai moi-même rencontré quelque chose de similaire une fois.

Pour moi, certaines solutions à ce problème sont restées longtemps un mystère - il semblait que je n'avais rien fait, et il n'y avait même pas de danse avec un tambourin, mais une fois que tout a fonctionné. Pourquoi cela arrive-t-il? Examinons les situations possibles à cause desquelles le site peut « casser » et leur explication :

Vous insérez le code terminé - le site cesse de fonctionner.

1. Vous modifiez function.php - le site cesse de fonctionner.

Le plus souvent, il s'agit de balises PHP d'ouverture et de fermeture. En règle générale, si le code que vous insérez comporte ces balises au début et à la fin, elles doivent alors être supprimées. De plus, le fichier function.php ne doit afficher aucun texte (code HTML ou autre contenu) à l'écran. La sortie de texte n'est autorisée qu'à l'intérieur des fonctions qui seront utilisées ultérieurement dans le modèle ou qui sont attachées aux hooks (voir ci-dessous pour plus de détails).

Aucun caractère autorisé avant, y compris les caractères invisibles (saut de ligne), car function.php est connecté avant de définir les en-têtes http (ces en-têtes transmettent diverses données, par exemple, qu'il s'agit d'un document html ; que l'encodage utf-8 est différent). Selon les règles PHP, le contenu doit être affiché à l'écran après l'envoi des en-têtes. Et tout ce qui est dehorsc'est le contenu - le texte affiché à l'écran, même le caractère \n invisible. Ce texte provoque donc une erreur.

Pour éviter les erreurs, considérez 4 points :

#1 Une bonne nidification

Par exemple, nous avions cette structure :

.......voici le code......... ?>

Correctement comme ceci :

#2 Pas de sauts de ligne, d'espaces, de texte avant

Ce code provoquera une erreur :

Mais celui-ci ne le fait pas :

Il est plus logique de l'écrire ainsi :

Il arrive qu'un saut de ligne soit placé à la toute fin de fonctions.php, et cela devient alors un vrai problème, car tout semble correct, mais le site ne fonctionne pas. En fait, après ?> ou avant

il y a une ligne vide ici

Pour cette raison, de nombreux développeurs suppriment complètement la balise de fermeture ?> ; cela est acceptable en PHP. Je recommande de toujours faire ceci :

#3 Utilisationà l'intérieur des fonctions PHP

S'il existe une fonction dans function.php, alors les balises peuvent être utilisées à l'intérieur de cette fonction, par exemple, afin de mettre en évidence visuellement le code HTML à l'intérieur d'une fonction :

Le fait est que dans ce cas, la fonction est uniquement enregistrée et n'effectue aucune action. Tout ce qui se trouve à l'intérieur d'une fonction (entre ( )) ne fonctionne pas tant que cette fonction n'est pas appelée, et ces fonctions sont généralement appelées à partir d'un modèle ou via des filtres, après l'envoi des en-têtes HTTP. Donc, dans cet exemple, nous pouvons ignorer les sauts de ligne et utiliser ?> et

#4 Encodage

Autre remarque concernant le fichier function.php : définissez l'encodage du fichier sur UTF-8 (UTF-8 sans BOM). Sinon, si le fichier de fonction contient du texte en cyrillique, il sera affiché en caractères incompréhensibles : charabia, gribouillis - appelez-le comme vous voulez.

Dans ce guide, nous verrons de plus près comment créer un plugin WordPress avec sa propre page d'administration. Une caractéristique de tout plugin est la séparation de son code du code principal de WordPress. Si quelque chose arrive au plugin, le reste du site fonctionnera.

• Éditeur de texte

Pour suivre les étapes de ce didacticiel, vous aurez besoin d'un éditeur de texte tel que Notepad++ ou l'environnement de développement NetBeans. Vous avez également besoin d'un accès FTP dans votre compte d'hébergement et .

Ce guide des plugins WordPress est écrit pour ceux qui possèdent déjà . Conformément au didacticiel, nous allons créer une nouvelle fonction, appeler les fonctions WordPress existantes en les utilisant comme paramètres.

Qu'est-ce qu'un plugin WordPress ?

Plugin WordPress est un code autonome qui améliore et étend les fonctionnalités de WordPress. En utilisant n'importe quelle combinaison de PHP, HTML, CSS, JavaScript/jQuery ou un certain nombre d'autres langages de programmation, un plugin WordPress peut ajouter de nouvelles fonctionnalités à n'importe quelle partie de votre site, y compris la console d'administration. Vous pouvez modifier le comportement par défaut de WordPress ou supprimer complètement les comportements inutiles. Les plugins facilitent la personnalisation de WordPress en fonction de vous et de vos besoins.

Puisqu’un plugin WordPress est un code distinct, il n’interfère directement avec aucune partie du code principal de WordPress. Le plugin peut être copié ou installé sur n’importe quelle installation WordPress. Alternative (et fortement déconseillé) La façon d’apporter des modifications dans WordPress consiste à écrire une nouvelle fonction dans un fichier WordPress. fonctions.php, qui se trouve dans le répertoire /wp-inclut/ ou vers un fichier fonctions.php, qui fait partie de votre thème. Cela peut entraîner un certain nombre de problèmes possibles.

WordPress et ses thèmes sont mis à jour régulièrement. Et tant que vous utilisez un thème enfant WordPress, la prochaine mise à jour écrasera le fichier fonctions.php, et le nouveau code que vous avez ajouté sera supprimé et vous devrez l'ajouter encore et encore. Un autre moment gênant peut survenir si vous écrivez beaucoup de fonctions et que l'une d'elles a un bug que vous ne pouvez pas localiser, vous devrez peut-être remplacer le fichier actuel par celui d'origine, mais vous devrez sacrifier toutes les autres fonctions . Cela entraînera un grand nombre d'erreurs PHP sur le site, car les appels aux fonctions déjà supprimées seront toujours effectués depuis d'autres endroits.

Les plugins ne sont jamais automatiquement écrasés ou supprimés lors de la mise à jour de WordPress. S'il y a des erreurs dans le code de votre plugin WordPress, vous pouvez simplement le désactiver dans la console d'administration pendant que l'erreur est corrigée. Dans le cas où votre plugin présente un bug sérieux, WordPress peut parfois le désactiver automatiquement pour que l’ensemble du site continue de fonctionner.

Qu'est-ce qu'un crochet ?

Les plugins WordPress interagissent avec le code principal via ce qu'on appelle crochets (crochets, de l'anglais crochet – crochet). Vous pouvez y « accrocher », comme des hooks, l'exécution de toutes les fonctions qui nous intéressent. Il existe deux types de hooks dans WordPress :

1. Hooks d’action ou hooks d’événement (ajouter/supprimer une fonction personnalisée à un événement).
2. Hooks de filtre ou hooks de filtre (pour modifier les données traitées par les fonctions).

Événements et crochets d'événement

Visiter n’importe quelle page d’un site WordPress implique d’appeler un ensemble de fonctions PHP (appelées événements - Actions). Les fonctions sont liées à crochets d'action. Le mécanisme de hook d’événement est fourni par WordPress. Tu peux ajouter vos fonctions à n'importe quel événement de la liste des événements utilisant le mécanisme de hook et elles seront lancées lorsque cet événement sera déclenché. tu peux aussi supprimer fonctions déjà existantes à partir de n’importe quelle liste de hooks d’événement. Les hooks d'événement sont liés à l'exécution d'un événement spécifique. Par exemple, avant de fermer une balise sur n'importe quelle page, l'événement hook est appelé wp_head() et un certain nombre de fonctions liées à ce hook sont lancées wp_head().

Ajout de fonctions à un hook d'événement à l'aide de add_action()

À ajouter fonction sur n’importe quel hook d’événement, votre plugin WordPress doit appeler une fonction WordPress appelée ajouter_action(), avec au moins deux paramètres.

// Hook d'événement "init", appelé une fois que WordPress a fini de charger le code principal add_action("init", "add_Cookie"); // Définition d'un cookie avec l'heure actuelle, fonction add_Cookie() ( setcookie("last_visit_time", date("r"), time()+60*60*24*30, "/"); )

• crochets d'événement(crochet d'action), auquel nous allons lier notre fonction.
• Le deuxième paramètre obligatoire est le nom les fonctions, que nous lancerons.
• une priorité (priorité) la fonction que vous êtes sur le point d'exécuter. Vous pouvez lier autant de fonctions que vous le souhaitez à un seul hook d'événement et y accéder dans n'importe quel ordre. La priorité de lancement par défaut est de 10, votre fonction s'exécute immédiatement après les fonctions WordPress intégrées. La fonction de priorité 11 s'exécutera ensuite, et ainsi de suite.
• nombre d'arguments, signifie le nombre de paramètres que votre fonction personnalisée peut accepter. Par défaut, le nombre de paramètres est 1.

Exemple de code de plugin pour afficher le texte après la section de pied de page sur chaque page

Ce plugin WordPress intercepte le hook d'événement wp_footer(), qui est appelé immédiatement avant la balise de fermeture

sur chaque page et ajoute une nouvelle fonctionnalité appelée mfp_Add_Text(). Étant donné que le plugin WordPress n'est pas lié à un thème, la fonctionnalité fonctionnera même si vous changez le thème en un autre. Vous pouvez enregistrer cet exemple dans un fichier PHP et le télécharger dans le répertoire wp-content/plugins/ et activez-le dans la console d'administration pour voir les modifications.

Voici le résultat :

Note: PHP charge le contenu de l'intégralité du script en une seule fois avant de l'exécuter, ce qui signifie que vous pouvez appeler ajouter_action() avant de définir votre fonction : appelez ajouter_action() avec vos fonctions au début du fichier dans l'ordre dans lequel elles seront chargées, puis définissez vos fonctions dans le même ordre ci-dessous. Structurer le code de cette façon rendra le fichier plus facile à lire.

Suppression de fonctions des hooks d'événement à l'aide de remove_action()

Pour suppression la fonction associée au hook d'événement doit être utilisée supprimer_action(). L'exemple ci-dessous vous aidera à comprendre comment fonctionne l'ajout et la suppression de fonctions vers/d'un hook d'événement.

// Hook pour l'événement "init", qui est appelé une fois le chargement du noyau WordPress terminé et la fonction "remove_My_Meta_Tags" add_action("init", "remove_My_Meta_Tags"); // Supprimez la fonction "add_My_Meta_Tags" de la fonction de hook d'événement wp_head Remove_My_Meta_Tags() ( Remove_action("wp_head", "add_My_Meta_Tags"); )

Départs supprimer_action() au moins deux paramètres.

• Le premier paramètre obligatoire est le titre crochets d'événement(crochet d'action), auquel la fonction était rattachée
• Le deuxième paramètre obligatoire est le nom les fonctions tu veux supprimer
• Le troisième paramètre (facultatif) est la priorité de la fonction à supprimer. Ce paramètre doit correspondre à la priorité spécifiée lors de l'ajout de l'événement au hook d'événement. Si elle n'a pas été définie, n'activez pas cette option.

Exemple: Imaginons que vous souhaitiez que le texte que vous avez ajouté dans le pied de page de l'exemple précédent ne s'affiche pas le lundi. Une façon d'implémenter ceci consiste à utiliser la fonction date PHP pour obtenir le jour de la semaine en cours en passant une instruction conditionnelle. si donc... et vérifiez si le jour en cours est lundi, puis appelez supprimer_action(), si c'est lundi. Nous appelons la fonction de vérification et de suppression par jour de la semaine en utilisant ajouter_action(), attaché à un événement qui se produit plus tôt (par exemple, wp_head) que celui auquel notre action de texte de pied de page principale est attachée ( wp_footer). Si nous sélectionnons un événement survenant après wp_footer, la suppression n'aura pas lieu puisque la page sera déjà générée.

Après avoir chargé le pied de page du site, mon texte est ajouté !

Filtres et crochets pour filtres

Filtres de fonctions vous permettent de modifier les données renvoyées par d'autres fonctions et doivent d'abord être interceptées à l'aide de crochets de filtre. Les hooks de filtre sont légèrement différents des hooks d’événement. Cependant, ils fonctionnent de manière similaire aux hooks d'événement : ils peuvent être appelés à différents moments du script et de manière contextuelle. Une liste complète des hooks de filtre et du contexte d’appel peut être trouvée sur la page de référence de l’API/filtre du plugin WordPress.

Ajout de filtres à l'aide de add_filter()

À ajouter n'importe quelle fonction à un hook de filtre, votre plugin doit appeler une fonction WordPress appelée ajouter_filter(), avec au moins deux paramètres.

// Interception du hook de filtre "the_content" (le contenu de n'importe quel message), exécutant la fonction "mfp_Fix_Text_Spacing" add_filter("the_content", "mfp_Fix_Text_Spacing"); // Correction automatique de la fonction double espace mfp_Fix_Text_Spacing($the_Post) ( $the_New_Post = str_replace(" ", " ", $the_Post); return $the_New_Post; )

• Le premier paramètre obligatoire est le nom crochet de filtre(crochet de filtre), sur lequel nous voulons accrocher la fonction.
• Le deuxième paramètre est le nom fonction de filtre, que nous souhaitons lancer.
• Le troisième paramètre (facultatif) est une priorité (priorité) la fonction que vous souhaitez exécuter. Vous pouvez ajouter autant de filtres de fonctions différents que vous le souhaitez à un hook de filtre. La priorité par défaut est 10, ce qui place votre fonction définie par l'utilisateur après toute fonction intégrée. La fonction de priorité 11 s'exécutera ensuite, et ainsi de suite.
• Le quatrième paramètre (facultatif) est nombre d'arguments, ce qui signifie le nombre de paramètres que votre fonction personnalisée peut accepter. Par défaut, le nombre de paramètres est 1.

Exemple. Plugin WordPress pour modifier un fragment/extrait d'un article

WordPress a une fonction qui extrait un extrait (citation) d'un article, elle s'appelle get_the_excerpt(), et est également un crochet de filtre. La fonction qui affiche les extraits d'appels get_the_excerpt(), pour l'obtenir, c'est ici que le filtre est appliqué et le passage est modifié avant d'être affiché. Ce plugin WordPress définit une fonction de filtre qui prend un morceau de texte comme paramètre d'entrée, ajoute du texte devant celui-ci et renvoie une nouvelle valeur à chaque fois qu'il est appelé. get_the_excerpt(). Depuis que la fonction est revenue get_the_excerpt() la valeur est un véritable morceau de texte, elle est automatiquement entrée en paramètre dans la fonction $old_Extrait, lorsqu'on l'appelle en utilisant add_filter(). La fonction que vous définissez devrait renvoyer une nouvelle valeur.

Extrait:" . $old_Excerpt; return $new_Excerpt; ) ?>

Résultat final:


Supprimer des filtres à l'aide de remove_filter()

Pour supprimer un filtre il vous suffit d'appeler la fonction supprimer_filter(). Par exemple, ajoutons à nouveau une condition simple et supprimons le texte si nous sommes aujourd'hui jeudi.

// Filtre hook get_the_excerpt, exécutant la fonction mfp_Add_Text_To_Excerpt add_filter("get_the_excerpt", "mfp_Add_Text_To_Excerpt"); // Si aujourd'hui c'est jeudi, supprimez le filtre the_excerpt() if (date("l") === "Thursday") ( remove_filter("get_the_excerpt", "mfp_Add_Text_To_Excerpt"); ) // Prenez un extrait, ajoutez du texte et renvoie une nouvelle fonction d'extrait mfp_Add_Text_To_Excerpt($old_Excerpt) ( $new_Excerpt = " Extrait:" . $old_Excerpt; return $new_Excerpt; )

Maintenant que nous avons une compréhension de base des hooks, des filtres et des événements, créons un simple plugin WordPress qui ajoute un nouveau lien et une nouvelle page à la console d'administration.

Étape 1 – Sauvegarde du plugin

La première étape de la création d’un plugin WordPress consiste à créer un répertoire pour stocker tous vos fichiers. Tous les plugins sont stockés dans le répertoire : / wp-content/plugins/. Le répertoire que vous créez doit avoir un nom unique et compréhensible qui ne chevauche pas celui d'autres plugins. Connectez-vous à votre compte d'hébergement via FTP. Depuis le répertoire principal de WordPress, accédez à contenu wp puis dans plugins. Dans le catalogue plugins créez un nouveau répertoire appelé mon-premier-plugin.


Il est préférable de séparer thématiquement les fichiers individuels avec le code du plugin dans des sous-répertoires dans le répertoire principal du plugin au lieu de tout stocker dans un seul répertoire, cela évitera toute confusion et constituera une bonne séparation sémantique des fichiers sources du plugin. En particulier, la séparation des fichiers par signification sera très visible lorsque votre plugin grandira et deviendra plus complexe. Si votre plugin utilise ses propres styles CSS, créez un répertoire CSS et enregistrez-y tous les fichiers CSS. Si votre plugin WordPress utilise JavaScript, créez un répertoire Javascript.

Étape 2 – Créez le premier fichier

Le premier fichier de votre plugin est très important. Il contient toutes les informations dont WordPress a besoin pour afficher votre plugin dans la liste des plugins actuellement actifs.

Dans votre catalogue mon-premier-plugin créez un nouveau fichier PHP et nommez-le mon-premier-plugin.php. C'est une bonne pratique de nommer le fichier principal du plugin ainsi que le répertoire. Ajouter une balise d'ouverture PHP en première ligne. Vous n'êtes pas obligé d'ajouter la balise de fermeture à la fin du fichier (pour comprendre pourquoi, lisez la note sur la page de manuel PHP). Ce fichier contiendra principalement ce que l’on appelle des « commentaires d’en-tête » avec des informations qui seront lues et affichées par WordPress. Les commentaires d'en-tête sont des commentaires PHP multilignes, chaque ligne définissant des informations spéciales, commençant par des caractères spéciaux, afin que vous puissiez déterminer à quoi la ligne fait référence. Cette structure doit être présente uniquement dans le premier fichier et son pas besoin répéter dans le reste.

La première ligne du commentaire dans le fichier mon-premier-plugin.php vous devez ajouter le nom du plugin. Démarrez un commentaire PHP multiligne en l'ouvrant avec des caractères /* sur la deuxième ligne du fichier, juste après la balise d'ouverture PHP. Sur la troisième ligne, écrivez Nom du plugin : Mon premier plugin. Dans les deux lignes distinctes suivantes, vous pouvez préciser la description du plugin et le nom de l'auteur. Puis, à partir de la ligne suivante, fermer le bloc de commentaire avec les symboles */ . Votre fichier ressemble maintenant à ceci :

Le nom de l'auteur.

Étape 3 – Écriture des fonctions du plugin

Comme mentionné ci-dessus, c'est une bonne pratique de séparer le code du plugin en fichiers et répertoires appropriés. Puisque la fonction principale du premier fichier est de contenir des informations sur le plugin, nous placerons le plugin WordPress lui-même dans d’autres fichiers et répertoires et utiliserons la fonction PHP « include » pour y accéder. Tous les fichiers stockés dans les sous-répertoires sont appelés directement à partir de notre code et uniquement à partir de notre code, le nom du sous-répertoire n'a donc pas besoin de préfixe. Cependant, il est fortement recommandé d'utiliser un préfixe unique pour vos fichiers, fonctions et variables afin d'éviter les conflits avec d'autres plugins. À cet égard, nous utiliserons le préfixe MFP, abréviation de « Mon premier plugin ».

Dans le répertoire principal de votre plugin, créez un nouveau sous-répertoire appelé comprend. Tout fichier qui sera inclus via « inclure » ​​dans un autre fichier ira dans ce sous-répertoire. Créer un nouveau fichier PHP dans un sous-répertoire comprend et enregistrez-le sous mfp-functions.php. Ouvrir la balise en première ligne. Ce nouveau fichier stockera les fonctions de votre plugin.

Maintenant, retourne à mon-premier-plugin.php dans le répertoire principal du plugin. Nous devons inclure le fichier mfp-functions.php, afin d'utiliser de nouvelles fonctionnalités. Puisqu'il s'agit du fichier principal du plugin, la connexion mfp-functions.php ici rendra les fonctions disponibles dans n'importe quel autre fichier de votre plugin. Utiliser Demandez une fois, pour inclure le fichier de fonctions une fois et être sûr que le plugin ne fonctionne que si les fonctions sont disponibles. Le moyen le plus simple d'inclure des fichiers de votre répertoire de plugins est d'utiliser la fonction WordPress plugin_dir_path(__FILE__), qui donne le chemin complet vers le répertoire où est stocké notre plugin WordPress, puis utilisez . (point) pour compléter le nom du sous-répertoire que nous avons créé précédemment ( comprend), puis le nom du fichier que nous avons créé ( mfp-functions.php).

Édition mon-premier-plugin.php comme indiqué ci-dessous, puis enregistrez et chargez à nouveau, en écrasant la version précédente.

Revenons à mfp-functions.php dans un sous-répertoire comprend.

C'est une bonne idée de combiner plusieurs fonctions ensemble et d'écrire un commentaire sur plusieurs lignes au-dessus de chaque groupe décrivant le groupe, puis un court commentaire d'une ligne avant chaque fonction le décrivant. De cette façon, vous n'avez pas besoin de lire tout le code pour trouver la fonction et comprendre ce qu'elle fait. Appelons la fonction mfp_Add_My_Admin_Link(). Cela ajoutera un nouveau lien supérieur dans la console d'administration dans le menu de navigation.

Pour résumer, nous écrivons une nouvelle fonction en suivant ces étapes :

• Nous écrivons des commentaires décrivant la fonction
• Appeler la fonction
• Écrire une fonction

DANS mfp-functions.php, nous écrivons ce qui suit :

Dans notre fonction, nous devons utiliser la fonction WordPress intégrée add_menu_page() pour définir le nom du menu, le titre et qui peut le voir. Ensuite, nous indiquons ce qu'il faut afficher lorsque nous naviguons vers la page. Vous pouvez également ajouter une icône au lien dans le menu et définir sa position dans le menu de navigation du panneau d'administration - les deux sont facultatifs, nous ne nous attarderons donc pas là-dessus dans notre guide. Une icône par défaut apparaîtra à côté du lien vers votre page. Notre lien apparaîtra au bas du menu de navigation de la console d'administration. Toutes ces informations sont saisies en paramètres dans add_menu_page().

Quatre paramètres obligatoires add_menu_page()– chacun sur une nouvelle ligne pour une meilleure clarté :

1. Le nom de la page que vous verrez après avoir cliqué sur le lien (affiché dans l'onglet du navigateur).
2. Le texte affiché dans le lien du menu (affiché dans la liste de navigation de la console d'administration) peut être le nom de votre plugin.
3. Conditions requises pour que l'utilisateur puisse voir le menu. Dans cet exemple, seuls les utilisateurs disposant de la capacité « manage_options » peuvent accéder à la page (ne vous inquiétez pas pour l'instant).
4. Quel fichier utiliser, quand ouvrir la page (nous la créerons à l'étape suivante), qui sera stocké dans un sous-répertoire comprend et être appelé mfp-first-acp-page.php. L'URL saisie ici est connue sous le nom de « slug ».

Avant de continuer, il est important de savoir qu’il existe une autre façon d’utiliser cette fonctionnalité. Le quatrième paramètre pourrait simplement être une chaîne de texte qui apparaît dans l'URL du lien après ' wp-admin/admin.php?page='. Si vous entrez 'my-plugin-page', l'URL deviendra 'wp-admin/admin.php?page=my-plugin-page'. Le quatrième paramètre devrait alors être le nom de la fonction qui génère quelque chose. Vous pouvez écrire une fonction qui imprime simplement « Bienvenue sur la page 1 », par exemple. Il est beaucoup plus simple de créer un fichier PHP qui contiendra votre page.

Édition mfp-functions.php, supprimer // Mon code va ici, remplacez-le par add_menu_page() et transmettez les paramètres comme indiqué ci-dessous :

Pour exécuter cette fonction, nous devons utiliser une fonction WordPress appelée ajouter_action() avec deux paramètres, comme décrit dans la section « Ajout de fonctions à un Event Hook » de ce didacticiel. Vous souhaiterez peut-être relire cette section avant de continuer.

• Le premier paramètre est crochet d'action que vous voulez attraper. Dans notre cas, le hook d'événement est admin_menu– cela signifie que notre fonction est chargée lorsque le menu Admin commence à être généré.
• Le deuxième paramètre est simplement le nom de la fonction à exécuter. La fonction que nous avons écrite s'appelle mfp_Add_My_Admin_Link. Notez qu’il n’y a pas de parenthèses écrites ici. N'oubliez pas que PHP charge l'intégralité du script avant son exécution, vous permettant d'utiliser add_action() avant de définir la fonction spécifiée dans le paramètre 2.

Notre fichier final ressemble à ceci :

Téléverser un fichier mfp-functions.php au catalogue comprend et écrasez l'ancien.

Étape 4 – Créer une nouvelle page d'administration

Vous pouvez désormais créer une page qui s'affichera lorsque vous cliquerez sur un lien dans votre console d'administration. Revenir au sous-répertoire comprend et créez un nouveau fichier PHP appelé mfp-first-acp-page.php. La balise d'ouverture PHP n'est pas requise dans ce fichier puisque nous utiliserons uniquement du HTML. Écrivez le code HTML comme indiqué ci-dessous et téléchargez le fichier.