À quoi sert le dossier wordpress wp-includes?

15

À quoi sert le dossier wordpress wp-includes? Autrement dit, quel est le but architectural fondamental de celui-ci, par exemple pourquoi n'est-il pas tout dans des thèmes ou un dossier d'administration?

Un développeur de plugin peut-il s'appuyer sur son contenu (par exemple jQuery) et pendant combien de temps?

J'aimerais également savoir qui décide de ce qui s'y passe et comment est-il maintenu à mesure que Wordpress change, tout cela est-il documenté quelque part en tant que document de politique?

Simon Gibbs
la source

Réponses:

17

wp-includescontient tout le nécessaire pour exécuter WordPress via le frontend (et puis certains). C'est le territoire de WordPress Core, et comme l'adage le dit, ne modifiez jamais le core en aucune circonstance.

Bien qu'il wp-contentpuisse définir des plugins et des thèmes, l'API elle-même et la grande majorité du noyau WordPress se trouvent dans ce dossier. Ceux-ci dépendent de la quasi-totalité de WordPress. Toutes vos fonctions standard et leurs dépendances se trouvent dans ce dossier.

Cela en fait une ressource précieuse pour la recherche et la recherche de choses.

wp-admin peut définir des éléments supplémentaires mais ce n'est pas aussi vital pour le fonctionnement du frontend

./wp-admin    - Admin code
./wp-content  - User-defined code and content
./wp-includes - Common files

Quant à la fiabilité des fichiers dans ce dossier, vous ne devez pas vous fier aux fichiers de ce dossier. Vous ne devriez jamais avoir besoin d'inclure un fichier ou un chemin à partir de wp-includes et si vous essayez ou devez, vous avez fait quelque chose d'horriblement mal et vous devez vous arrêter et revenir en arrière.

Bien que les fichiers de ce dossier puissent changer sans avertissement, cela ne devrait pas avoir de conséquence, car l'API contenue est maintenue rétrocompatible pendant une durée significative.

En dehors des mises à jour de WordPress, wp-includesne devrait jamais être modifié et devrait idéalement être en lecture seule.

Si vous devez ajouter une dépendance à votre code, utilisez les versions de wp-includes plutôt que d'ajouter la vôtre. Par exemple, n'incluez pas de jQuery personnalisé, utilisez celui fourni avec WordPress (ne le désenregistrez pas et ne le réenregistrez pas non plus).

Les modifications apportées à wp-includes peuvent entraîner des risques de sécurité, une dégradation des performances, des plugins / thèmes cassés, etc.

Les modifications apportées aux packages et aux bibliothèques incluses sont annoncées avant les versions. Les anciennes dépendances qui ne sont plus nécessaires (comme l'ancien sélecteur de couleurs) sont conservées, mais marquées comme obsolètes pour éviter la rupture du code

Tom J Nowell
la source
5

Le wp-includesrépertoire comprend les packages inclus par core . L' équipe principale gère les packages inclus dans wp-includes. Les thèmes et plugins peuvent compter sur la disponibilité de ces packages pour toute version donnée de WordPress.

C'est une énorme raison pour laquelle il est extrêmement important de ne mettre en file d'attente que les versions de scripts groupées , en utilisant l' enregistrement de script défini par le noyau , tel que:, wp_enqueue_script( 'jquery' )afin que votre thème / plugin utilise toujours la version fournie avec le noyau, peu importe ce version de WordPress est en cours d'exécution.

Chip Bennett
la source
3

WordPress, en tant qu'application, est constitué de plusieurs parties mobiles. Le /wp-includesdossier contient des fonctionnalités communes pour l'API WordPress (que vous utilisez dans les thèmes / plugins) et l'administrateur WordPress.

Donc en gros:

./wp-admin    - Admin code
./wp-content  - User-defined code and content
./wp-includes - Common files

Le /wp-includesrépertoire est l'endroit où les bibliothèques tierces utiles (c'est-à-dire SimplePie pour RSS et IncutioRPC pour XML-RPC) sont stockées. C'est également là qu'une grande partie de l'API WordPress (c'est-à-dire WP_Http, WP_Filesystem) est définie.

Un développeur de plugin peut-il s'appuyer sur son contenu? et pour combien de temps?

Oui. Ces fichiers sont ce qui définit l'API WordPress en premier lieu. L'équipe principale s'efforce de conserver la compatibilité descendante, donc si des modifications sont introduites dans WordPress qui casseront ce que vous utilisez, vous le saurez bien avant.

J'aimerais également savoir qui décide de ce qui s'y passe et comment est-il maintenu à mesure que Wordpress change, tout cela est-il documenté quelque part en tant que document de politique?

Les décisions concernant l'API WordPress sont définies par l'équipe de développement. Vous pouvez généralement suivre les modifications sur http://make.wordpress.org/core . Les bibliothèques sont toujours maintenues car changer ces bibliothèques est ce qui change WordPress.

EAMann
la source
Ce ne sont pas les fichiers qui définissent l'API, mais les fonctions et classes de ces fichiers le font. Les fichiers peuvent se déplacer ou disparaître sans aucune modification de l'API.
fuxia
0

wp-includesest le répertoire qui contient la plupart des fonctionnalités principales de WordPress. C'est là que vivent tous les principaux codes WordPress.

WordPress fait un excellent travail pour maintenir la compatibilité descendante entre les versions. Vous pouvez utiliser les fonctions incluses dans ce dossier pour créer des plugins (c'est ainsi que vous vous connectez au système).

WordPress Trac est le principal domaine qui décide comment WordPress va de l'avant, donc si vous avez des opinions / ajouts, impliquez-vous là :)

Zach
la source