Darío Ferrer - Blog

Cuando desarrollas un plugin, WordPress activa todas sus funciones nativas (etiquetas, hooks, etc.) al archivo de tu plugin que has identificado como principal y se “olvida” de los demás. Es necesario entonces colocar una ruta hacia wp-load.php, cuya función consiste precisamente en habilitar estas funciones al archivo que quieras.

El problema

Muchos son los plugins que necesitan transferir funciones nativas de WordPress a archivos adicionales. Hasta el momento la mayoría ha logrado superar este paso colocando -desde el archivo secundario- una ruta estática hacia wp-load.php de esta manera:

Esto funciona correctamente siempre y cuando la instalación de WordPress se mantenga intacta pero ¿qué pasaría si el usuario, en su wp-config.php, define una ruta personalizada para el directorio de plugins (PLUGIN_DIR)?. Pues sencillamente el plugin quedará totalmente inutilizado, pues es probable que wp-load.php no se encuentre en el directorio específico apuntado en el require_once. Siendo así, PHP devolverá error y no quedará otro remedio que desactivar el plugin.

En pocas palabras, un plugin con rutas estáticas hacia archivos clave condenará a quien lo usa a mantener las configuraciones predeterminadas de sus directorios, al menos hasta que éste decida descartarlo de su lista de plugins.

La solución: establecer una ruta dinámica hacia wp-load.php

Siempre he dicho que WordPress -sin ovlidar a sus usuarios de siempre- debería enfocar mayor atención en la habilitación de recursos para desarrolladores. No es posible que una tontería de éstas sea la gran culpable de que quienes programen bajo dicha plataforma se priven de implementar mejores recursos a sus scripts.

En fin, todo el lío consiste en lograr que un archivo secundario sea capaz de recibir la instrucción ABSPATH (función de WordPress que imprime la ruta absoluta de un archivo) y con ello lograr imprimir la ruta hacia el script, independientemente del directorio donde se encuentre el archivo. El script en cuestión es éste (Por supuesto lo escribirás en el archivo principal de tu plugin):

Qué es lo que hace este script

• Imprime la ruta absoluta completa al archivo wp-load.php (el que activa las funciones de WordPress en archivos estáticos) independientemente del lugar donde se encuentre el directorio del plugin. Si posteriormente la carpeta es movida, el script localizará automáticamente al archivo.
• Si el archivo a modificar no es escribible, el script lanzará una advertencia en el panel de que es necesario incluir el código, proporcionando la ruta correcta del mismo en una etiqueta <pre>.
• Si el código está correctamente en su lugar, el anuncio no saldrá (aunque el archivo no sea escribible).

Complementando: La historia de este lío

Hace algunas semanas comencé a darle vueltas a este asunto y concluí que la solución más sensata era hacer que PHP escribiera la ruta en el archivo secundario. En síntesis, el procedimiento era escribir la función en el archivo principal, quien se encargaría de leer una línea específica en el secundario y escribir la ruta correcta en caso de que no se encotrara allí (o fuera diferente).

Hice un código inicial que técnicamente cumplía con su misión, pero presentaba grandes fallas de implementación, pues la función escribía la línea una y otra vez con cada actualización en el frontend del sitio (la interfaz de usuario). Es decir, en un sitio con 10.000 visitas diarias el PHP tendría que escribir el archivo 10.000 veces, así que ese aspecto me desanimó.

No fue sino hasta que expuse el problema ante los muchachos de Foros del Web cuando el script por fin funcionó.

Si tienes una duda técnica sobre este artículo, por favor formúlala en el foro.