Guía de pruebas

Esta página describe el enfoque de pruebas del plugin a alto nivel. La arquitectura de pruebas interna, los stubs de arranque (bootstrap), el diseño de los fixtures y el contenido exacto de la suite de pruebas no se publican aquí.

Lo que los colaboradores deben saber

• El plugin se distribuye con una suite de pruebas unitarias en PHP que se ejecuta localmente y en la integración continua del proyecto.
• Las pruebas están escritas con PHPUnit y están dirigidas a PHP 8.1 o posterior, coincidiendo con el requisito de tiempo de ejecución del propio plugin.
• Se espera que los nuevos cambios de comportamiento vayan acompañados de pruebas cuando el comportamiento pueda ser ejercitado razonablemente mediante pruebas unitarias.

Para la configuración del entorno (PHP, Composer, WordPress), consulte la Configuración de desarrollo local. Para conocer las convenciones que debe seguir el nuevo código, consulte los Estándares de codificación.

La organización interna de la suite de pruebas, los helpers que utiliza y el flujo de trabajo privado de integración continua son detalles de implementación.

Superficies de integración públicas compatibles

Al realizar la integración con el plugin, prefiera estas superficies estables:

• La interfaz de usuario de ajustes de administración del plugin.
• Los shortcodes documentados.
• Las anulaciones de plantillas a nivel de tema como se describe en el Sistema de plantillas y anulaciones.
• La Descripción general para desarrolladores general para orientarse.

Los nombres de clases internas, las claves de opciones, las tablas de la base de datos, los endpoints de REST y AJAX, los nombres de hooks de cron, los identificadores de capacidades y nonces, y la infraestructura de lanzamiento / actualización se tratan como detalles de implementación. Pueden cambiar entre versiones sin previo aviso y no forman parte del contrato de integración público.

Política de estabilidad y cambios

Cualquier elemento que no figure como superficie pública compatible anteriormente se considera un detalle de implementación interna. Las API internas, el diseño del almacenamiento y la implementación de la seguridad pueden cambiar entre versiones. No dependa de ellos desde código de terceros, temas o sistemas externos. No se admiten escrituras directas en la base de datos.

Aviso de documentación pública. Esta página proporciona únicamente una descripción general de la integración a alto nivel. Los detalles de implementación interna, las API privadas, los aspectos internos del almacenamiento y la infraestructura de lanzamiento sensible a la seguridad se mantienen por separado y no forman parte de la documentación pública. Las superficies de integración compatibles son los shortcodes documentados, las anulaciones de plantillas, la interfaz de usuario de ajustes y cualquier punto de extensión publicado explícitamente en esta sección.