¿Para qué sirve la carpeta wp-includes de WordPress?

Question

¿Para qué sirve la carpeta wp-includes de WordPress?

4 dic 2012, 18:16:00

Vistas: 68.1K

Votos: 18

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

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

También me gustaría saber, ¿quién decide qué va en esa carpeta y cómo se mantiene a medida que WordPress evoluciona? ¿Existe toda esta información documentada en algún lugar como documento de políticas?

Simon Gibbs

403

desarrollo de plugins

Todas las respuestas a la pregunta

El directorio wp-includes contiene los paquetes incluidos por el núcleo. El equipo del núcleo mantiene los paquetes incluidos en wp-includes. Los temas y plugins pueden depender de que estos paquetes estén disponibles para cualquier versión de WordPress.

Esa es una razón importante por la que es extremadamente importante poner en cola solo versiones incluidas en el núcleo de los scripts, utilizando el registro de scripts definido por el núcleo, como: wp_enqueue_script( 'jquery' ), para que tu tema/plugin siempre use la versión incluida en el núcleo, sin importar qué versión de WordPress se esté ejecutando.

Chip Bennett

55.1K

4 dic 2012 18:22:51

WordPress, como aplicación, está construido con varias partes móviles. La carpeta /wp-includes contiene la funcionalidad común para la API de WordPress (que se utiliza en temas/plugins) y el administrador de WordPress.

Básicamente:

./wp-admin    - Código del administrador
./wp-content  - Código y contenido definido por el usuario
./wp-includes - Archivos comunes

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

¿Puede un desarrollador de plugins confiar en su contenido? ¿Y por cuánto tiempo?

Sí. Estos archivos son los que definen la API de WordPress en primer lugar. El equipo central hace grandes esfuerzos para mantener la compatibilidad con versiones anteriores, por lo que si alguna vez se introducen cambios en WordPress que rompan lo que estás utilizando, lo sabrás con suficiente antelación.

También me gustaría saber, ¿quién decide qué va ahí y cómo se mantiene a medida que WordPress cambia? ¿Está todo esto documentado en algún lugar como un documento de políticas?

Las decisiones para la API de WordPress son definidas por el equipo de desarrollo. Generalmente puedes 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

32.2K

4 dic 2012 18:24:15

Comentarios

No son los archivos los que definen la API, sino las funciones y clases dentro de esos archivos. Los archivos podrían moverse o desaparecer sin que haya cambios en la API.

fuxia

4 dic 2012 18:25:29

wp-includes es el directorio que contiene la mayor parte de la funcionalidad principal de WordPress. Aquí reside todo el código fundamental de WordPress.

WordPress hace un excelente trabajo manteniendo compatibilidad con versiones anteriores. Puedes utilizar las funciones incluidas en esta carpeta para construir plugins (así es como te conectas al sistema).

WordPress Trac es el área principal que decide cómo avanza WordPress, así que si tienes opiniones o adiciones, ¡participa allí! :)

Zach

1.94K

4 dic 2012 18:21:37

El manual de Make WordPress Core tiene una página útil titulada El Código Base de WordPress, que proporciona una buena visión general de Cómo Se Organiza el Código en WordPress, incluyendo:

wp-includes

El directorio wp-includes contiene las bibliotecas principales del núcleo y de terceros para WordPress. Muchos de estos archivos se cargan durante el arranque de la aplicación.

Los archivos en wp-includes siguen un conjunto (en su mayoría) estándar de prefijos y sufijos:

class-*.php – Clases PHP. Algunas de estas son bibliotecas externas.

ms-*.php – Código específico para la funcionalidad multisitio de WordPress.

default-*.php – Código que implementa o define funcionalidad por defecto, como constantes, widgets y filtros.

*deprecated.php – Funciones que están obsoletas.

*-template.php – Funciones de plantilla para la API relevante.

Los archivos en wp-admin/includes siguen convenciones de nombres similares.

y

wp-admin/includes

El directorio wp-admin/includes contiene las bibliotecas principales del núcleo y de terceros disponibles y utilizadas en el área de administración. Algunas de estas se cargan durante el arranque del administrador; consulta wp-admin/includes/admin.php para ver la lista principal de archivos incluidos.

y más... ¡échale un vistazo, gente del 2022! :-)

user1138

131

1 ago 2022 13:18:16

Tom J Nowell 60.7K · Accepted Answer · 2012-12-04T18:46:39Z

wp-includes contiene todo lo necesario para ejecutar WordPress en el frontend (y algo más). Es territorio del núcleo de WordPress y, como dice el dicho, nunca modifiques el núcleo bajo ninguna circunstancia.

Mientras que wp-content puede definir plugins y temas, la API en sí y la gran mayoría del núcleo de WordPress reside en esa carpeta. Casi todo WordPress depende de estos archivos. Todas tus funciones estándar y sus dependencias se encontrarán en esta carpeta.

Esto lo convierte en un recurso valioso para investigar y consultar información.

wp-admin puede definir elementos adicionales, pero no es tan vital para el funcionamiento del frontend.

./wp-admin    - Código de administración
./wp-content  - Código y contenido definido por el usuario
./wp-includes - Archivos comunes

En cuanto a la confiabilidad de los archivos en esa carpeta, no deberías depender de ellos. Nunca deberías necesitar incluir un archivo o ruta desde wp-includes, y si lo intentas o necesitas hacerlo, entonces has cometido un error grave y debes detenerte y retroceder.

Aunque los archivos en esa carpeta pueden cambiar sin previo aviso, esto no debería tener consecuencias, ya que la API contenida se mantiene compatible con versiones anteriores durante un tiempo significativo.

Fuera de las actualizaciones de WordPress, wp-includes nunca debería modificarse y, idealmente, debería ser de solo lectura.

Si necesitas agregar una dependencia a tu código, confía en las versiones en wp-includes en lugar de agregar las tuyas propias. Por ejemplo, no incluyas un jQuery personalizado, usa el que viene incluido con WordPress (y tampoco lo desregistres para volver a registrarlo).

Las modificaciones a wp-includes pueden causar riesgos de seguridad, degradación del rendimiento, plugins/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 antiguo selector de color) se mantienen, pero se marcan como obsoletas para evitar la ruptura del código.