La mayor\u00eda del trabajo que hago en este momento se enfoca en complementos personalizados o utilidades que funcionan sobre WordPress.<\/p>\n
Si tuviera que conceptualizar cu\u00e1ntos de los proyectos que construyo est\u00e1n juntos, revisar\u00eda WordPress (y todo lo que implica) como base, y luego el c\u00f3digo tiene una capa que se comunica con WordPress, y que puede comunicarse con API de terceros.<\/p>\n
Sin embargo, al hacer esto, a menudo hay un componente frontal que requiere que represente la informaci\u00f3n en plantillas. Aunque la creaci\u00f3n de plantillas para WordPress no es intr\u00ednsecamente dif\u00edcil (aunque desear\u00eda que tuvi\u00e9ramos algo m\u00e1s que etiquetas de plantilla, como un motor de plantillas, esa es otra publicaci\u00f3n), creo que vale la pena ver un par de formas en que podemos manejar plantillas que empaquetamos con complementos.<\/p>\n
Sin embargo, una de las primeras preguntas que suele surgir con esta declaraci\u00f3n es<\/p>\n
\n\u00bfPor qu\u00e9 incluir\u00eda plantillas personalizadas en un complemento?<\/p>\n<\/blockquote>\n
Y lo entiendo en algunos niveles.<\/p>\n
\n
- Mantener las plantillas en un complemento difumina un poco las l\u00edneas entre temas y complementos, especialmente cuando deja temas para presentaci\u00f3n y complementos para l\u00f3gica comercial.<\/li>\n
- Pedir a los usuarios que copien archivos de temas de una ubicaci\u00f3n a otra es una mala experiencia para el usuario.<\/li>\n<\/ol>\n
Pero hay algunas refutaciones o quiz\u00e1s excepciones absolutas a los casos anteriores.<\/p>\n
Gancho de WordPress template_redirect<\/h2>\n
Antes de hablar sobre el gancho template_redirect<\/a> de WordPress, quiero hablar un poco sobre los puntos mencionados anteriormente.<\/p>\n
1 Plantillas en Complementos<\/h3>\n
Si est\u00e1 creando un complemento personalizado que interact\u00faa tanto con WordPress como con una API de terceros o que usa alg\u00fan tipo de combinaci\u00f3n de repositorios, f\u00e1bricas, modelos y vistas, entonces necesitar\u00e1 mostrar esta informaci\u00f3n en el frente. -end, y debe ser independiente del tema.<\/p>\n
Esto no significa que alguien no pueda dise\u00f1ar los elementos de la p\u00e1gina o incluir la plantilla en su trabajo, pero s\u00ed significa que el complemento debe proporcionar un nivel b\u00e1sico de informaci\u00f3n que se presenta al usuario.<\/p>\n
2 Pedir a los usuarios que copien archivos es malo<\/h3>\n
\u00bfRecuerdas el eslogan que Apple sol\u00eda promocionar como \u00bb simplemente funciona?<\/a><\/strong> " Aunque puede que no sea algo que digan tanto como antes (si es que lo hacen, ya), me gusta la idea de que "simplemente funcione" para el usuario, y es algo por lo que trato de esforzarme en mi trabajar.<\/p>\n
Entonces, cuando se trata de crear plantillas personalizadas o vistas para complementos, no quiero pedirle al usuario que tenga que copiar archivos. Solo quiero que ellos:<\/p>\n
\n
- instalar el complemento,<\/li>\n
- haga clic en activar.<\/li>\n<\/ol>\n
Y eso es. El resto debe ser evidente o estar bien documentado.<\/p>\n
De vuelta al gancho<\/h2>\n
De acuerdo, supongamos por un momento que hemos creado un complemento, el complemento incluye varias plantillas b\u00e1sicas (o vistas seg\u00fan la jerga que use) y que las plantillas deben escribirse en la ra\u00edz del directorio del tema activo.<\/p>\n
Puede usar el gancho template_redirect<\/a><\/strong> (y muchos complementos populares lo hacen). Puede leer m\u00e1s sobre esto aqu\u00ed, pero la esencia es la siguiente:<\/p>\n
\nEste enlace de acci\u00f3n se ejecuta justo antes de que WordPress determine qu\u00e9 p\u00e1gina de plantilla cargar. Es un buen enlace para usar si necesita hacer una redirecci\u00f3n con pleno conocimiento del contenido que se ha consultado.<\/p>\n<\/blockquote>\n
Y, para ser claros, no estoy disuadiendo el uso de este gancho. Solo ofrezco una alternativa. Y eso es esto (ya que deber\u00eda funcionar de la siguiente manera):<\/p>\n
\n
- activar el complemento,<\/li>\n
- localizar el tema activo,<\/li>\n
- si a\u00fan no existen, copie los archivos de plantilla del complemento al directorio ra\u00edz del tema activo<\/li>\n<\/ol>\n
El paso final es fundamental porque si los archivos de plantilla existen, entonces es importante no sobrescribirlos principalmente porque el usuario podr\u00eda haber escrito sus personalizaciones.<\/p>\n
Dicho esto, as\u00ed es como puede hacerlo en una sola funci\u00f3n<\/a><\/strong> (completa con comentarios para mostrar lo que est\u00e1 usando).<\/p>\n
<?php\n\nadd_action('plugins_loaded', __NAMESPACE__. 'acmeCopyTemplates');\n\/**\n * Copies the template files from the `assets\/templates` directory to the root directory \n * of the currently active theme (if they do not already exist).\n *\/\nfunction acmeCopyTemplates()\n{\n \/\/ Find the currently active theme.\n $activeThemeDir = get_template_directory();\n\n \/**\n * Read all of the template files from assets\/templates into an array but\n * exclude the '.' and the '..' from the array.\n *\/\n $templates = array_slice(scandir(dirname(__FILE__).'\/assets\/templates'), 2);\n\n \/**\n * Now copy all of these files to the active theme directory.\n * If the file already exists, then don't do it.\n *\/\n foreach ($templates as $template) {\n if (!file_exists($destination = trailingslashit($activeThemeDir).$template)) {\n continue;\n }\n\n $source = dirname(__FILE__).'\/assets\/templates\/'.$template;\n $destination = trailingslashit($activeThemeDir).$template;\n\n copy($source, $destination);\n }\n}\n<\/code><\/pre>\nTenga en cuenta que esto utiliza varias funciones de PHP. A saber:<\/p>\n
\n
- array_slice<\/a><\/strong><\/li>\n
- escandir<\/a><\/strong><\/li>\n
- dirname<\/a><\/strong><\/li>\n
- El archivo existe<\/a><\/strong><\/li>\n
- Copiar<\/a><\/strong><\/li>\n<\/ul>\n
Todos los cuales creo que son \u00fatiles e importantes para saber, independientemente de la naturaleza en la que los est\u00e9 utilizando.<\/p>\n
\u00bfLos anfitriones admiten esto?<\/h2>\n