¿Para qué sirve la carpeta wordpress wp-includes?

15

¿Para qué sirve la carpeta wordpress wp-includes? Es decir, cuál es el propósito arquitectónico fundamental de la misma, por ejemplo, ¿por qué no está todo en temas o en una carpeta de administración?

¿Puede un desarrollador de complementos confiar en su contenido (por ejemplo, jQuery) y por cuánto tiempo?

También me gustaría saber, quién decide qué pasa allí y cómo se mantiene a medida que Wordpress cambia, ¿hay algo de esto documentado en alguna parte como documento de políticas?

Simon Gibbs
fuente

Respuestas:

17

wp-includescontiene todo lo necesario para ejecutar WordPress a través de la interfaz (y algo más). Es el territorio de WordPress Core, y como dice el adagio, nunca modifique el núcleo bajo ninguna circunstancia.

Si bien wp-contentpuede definir complementos y temas, la API en sí y la gran mayoría del núcleo de WordPress se encuentran en esa carpeta. De ellos depende casi la totalidad de WordPress. Todas sus funciones estándar y sus dependencias se encontrarán en esta carpeta.

Esto lo convierte en un recurso valioso para investigar y buscar cosas.

wp-admin puede definir elementos adicionales, pero no es tan vital para el funcionamiento de la interfaz

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

En cuanto a la confiabilidad de los archivos en esa carpeta, no debe confiar en los archivos de esa carpeta. Nunca debería necesitar incluir un archivo o ruta de wp-includes y si intenta o necesita hacerlo, entonces ha hecho algo terriblemente mal y necesita detenerse y regresar.

Si bien los archivos en esa carpeta pueden cambiar sin previo aviso, esto no debería tener ninguna consecuencia, ya que la API contenida es compatible con versiones anteriores durante un período de tiempo significativo.

Fuera de las actualizaciones de WordPress, wp-includesnunca debe modificarse e idealmente debe ser de solo lectura.

Si necesita agregar una dependencia a su código, confíe en las versiones en wp-includes en lugar de agregar la suya propia. por ejemplo, no incluya un jQuery personalizado, use uno incluido con WordPress (no lo anule y tampoco lo registre).

Las modificaciones a wp-includes pueden causar riesgos de seguridad, degradación del rendimiento, complementos / temas rotos, etc.

Los cambios en los paquetes y bibliotecas incluidos se anuncian antes de los lanzamientos. Las dependencias antiguas que ya no son necesarias (como el viejo selector de color) se mantienen, pero se marcan como obsoletas para evitar la rotura del código

Tom J Nowell
fuente
5

El wp-includesdirectorio incluye los paquetes incluidos por core . El equipo central mantiene los paquetes incluidos en wp-includes. Temas y complementos pueden confiar en que esos paquetes estén disponibles para cualquier versión dada de WordPress.

Esa es una gran razón por la cual es extremadamente importante poner en cola solo las versiones de scripts agrupadas en core , utilizando el registro de script definido por core , como:, wp_enqueue_script( 'jquery' )para que su Theme / Plugin siempre use la versión incluida en core, pase lo que pase Se está ejecutando la versión de WordPress.

Chip Bennett
fuente
3

WordPress, como aplicación, está compuesto de varias partes móviles. La /wp-includescarpeta contiene una funcionalidad común para la API de WordPress (que utiliza en temas / complementos) y el administrador de WordPress.

Así que básicamente:

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

El /wp-includesdirectorio es donde se almacenan las bibliotecas de terceros útiles (es decir, SimplePie para RSS e IncutioRPC para XML-RPC). También es donde se define gran parte de la API de WordPress (es decir, WP_Http, WP_Filesystem).

¿Puede un desarrollador de complementos confiar en su contenido? ¿y por cuánto tiempo?

Si. Estos archivos son lo que define la API de WordPress en primer lugar. El equipo central hace todo lo posible para mantener la compatibilidad con versiones anteriores, por lo que si alguna vez se introducen cambios en WordPress que rompan lo que está utilizando, sabrá de antemano bastante bien.

También me gustaría saber, quién decide qué pasa allí y cómo se mantiene a medida que Wordpress cambia, ¿hay algo de esto documentado en alguna parte como documento de políticas?

El equipo de desarrollo define las decisiones para la API de WordPress. Por lo general, puede seguir los cambios en http://make.wordpress.org/core . Las bibliotecas siempre se mantienen ya que cambiar estas bibliotecas es lo que cambia WordPress.

EAMann
fuente
No los archivos definen la API, las funciones y clases en esos archivos lo hacen. Los archivos pueden moverse o desaparecer sin ningún cambio en la API.
fuxia
0

wp-includeses el directorio que contiene la mayor parte de la funcionalidad principal de WordPress. Es donde reside todo el código principal de WordPress.

WordPress hace un excelente trabajo al mantener la compatibilidad con versiones anteriores entre versiones. Puede usar las funciones incluidas en esta carpeta para crear complementos (así es como se conecta al sistema).

WordPress Trac es el área principal que decide cómo WordPress avanza, así que si tiene opiniones / adiciones, participe allí :)

Zach
fuente