A maior parte do trabalho que fa\u00e7o agora se concentra em plugins ou utilit\u00e1rios personalizados que funcionam em cima do WordPress.<\/p>\n
Se voc\u00ea conceituar quantos dos projetos que eu construo s\u00e3o reunidos, voc\u00ea revisaria o WordPress (e tudo o que isso implica) como base, e ent\u00e3o o c\u00f3digo tem uma camada que se comunica com o WordPress e que pode se comunicar com APIs de terceiros.<\/p>\n
Ao fazer isso, por\u00e9m, geralmente h\u00e1 um componente de front-end que exige que eu renderize informa\u00e7\u00f5es em modelos. Embora a constru\u00e7\u00e3o de templates para WordPress n\u00e3o seja inerentemente dif\u00edcil (embora eu deseje ter um pouco mais do que tags de template \u2013 como um mecanismo de template, esse \u00e9 outro post), acho que vale a pena olhar para algumas maneiras de lidar com customiza\u00e7\u00e3o templates que juntamos com plugins.<\/p>\n
Uma das primeiras perguntas que muitas vezes s\u00e3o levantadas com essa declara\u00e7\u00e3o, no entanto, \u00e9<\/p>\n
\nPor que voc\u00ea incluiria modelos personalizados em um plugin?<\/p>\n<\/blockquote>\n
E eu entendo isso em alguns n\u00edveis.<\/p>\n
\n
- Manter templates em um plugin borra um pouco as linhas entre temas e plugins, especialmente quando voc\u00ea deixa temas para apresenta\u00e7\u00e3o e plugins para l\u00f3gica de neg\u00f3cios,<\/li>\n
- Pedir aos usu\u00e1rios que copiem arquivos de tema de um local para outro \u00e9 uma experi\u00eancia ruim para o usu\u00e1rio.<\/li>\n<\/ol>\n
Mas h\u00e1 algumas refuta\u00e7\u00f5es ou talvez exce\u00e7\u00f5es definitivas para os casos acima.<\/p>\n
Gancho template_redirect do WordPress<\/h2>\n
Antes de falar sobre o gancho template_redirect<\/a> do WordPress, quero falar um pouco sobre os pontos mencionados acima.<\/p>\n
1 Modelos em Plugins<\/h3>\n
Se voc\u00ea estiver criando um plug-in personalizado que fa\u00e7a interface com o WordPress e uma API de terceiros ou que use algum tipo de combina\u00e7\u00e3o de reposit\u00f3rios, f\u00e1bricas, modelos e visualiza\u00e7\u00f5es, voc\u00ea precisar\u00e1 exibir essas informa\u00e7\u00f5es na frente -end, e precisa ser independente do tema.<\/p>\n
Isso n\u00e3o significa que algu\u00e9m n\u00e3o possa estilizar os elementos da p\u00e1gina ou incluir o modelo em seu trabalho, mas significa que o plug-in deve fornecer um n\u00edvel b\u00e1sico de informa\u00e7\u00e3o que \u00e9 renderizado ao usu\u00e1rio.<\/p>\n
2 Pedir aos usu\u00e1rios para copiar arquivos \u00e9 ruim<\/h3>\n
Lembre-se do slogan que a Apple uma vez e muitas vezes divulgou como ” Simplesmente funciona?<\/a><\/strong> " Mesmo que n\u00e3o seja algo que eles falam tanto quanto antes (se \u00e9 que mais), eu gosto da ideia de ter "apenas trabalho" para o usu\u00e1rio, e \u00e9 algo que eu tento me esfor\u00e7ar no meu trabalhar.<\/p>\n
Portanto, quando se trata de criar modelos ou visualiza\u00e7\u00f5es personalizadas para plugins, n\u00e3o quero pedir ao usu\u00e1rio que copie arquivos. Eu s\u00f3 quero que eles:<\/p>\n
\n
- instale o plug-in,<\/li>\n
- clique em ativar.<\/li>\n<\/ol>\n
E \u00e9 isso. O resto deve ser auto-evidente ou bem documentado.<\/p>\n
De volta ao gancho<\/h2>\n
Ok, ent\u00e3o vamos supor por um momento que n\u00f3s constru\u00edmos um plugin, o plugin inclui v\u00e1rios templates b\u00e1sicos (ou visualiza\u00e7\u00f5es dependendo da linguagem que voc\u00ea usa) e que os templates precisam ser escritos na raiz do diret\u00f3rio do tema ativo.<\/p>\n
Voc\u00ea pode usar o gancho template_redirect<\/a><\/strong> (e muitos plugins populares fazem isso). Voc\u00ea pode ler mais sobre isso aqui, mas a ess\u00eancia \u00e9 a seguinte:<\/p>\n
\nEsse gancho de a\u00e7\u00e3o \u00e9 executado logo antes do WordPress determinar qual p\u00e1gina de modelo carregar. \u00c9 um bom gancho para usar se voc\u00ea precisar fazer um redirecionamento com pleno conhecimento do conte\u00fado que foi consultado.<\/p>\n<\/blockquote>\n
E, para ser claro, n\u00e3o estou dissuadindo o uso deste gancho. Estou apenas oferecendo uma alternativa. E \u00e9 isso (como deve funcionar da seguinte forma):<\/p>\n
\n
- ativar o plug-in,<\/li>\n
- localize o tema ativo,<\/li>\n
- se eles ainda n\u00e3o existirem, copie os arquivos de modelo do plugin para o diret\u00f3rio raiz do tema ativo<\/li>\n<\/ol>\n
A etapa final \u00e9 cr\u00edtica porque, se os arquivos de modelo existirem, \u00e9 importante n\u00e3o sobrescrev\u00ea-los principalmente porque o usu\u00e1rio pode ter escrito suas personaliza\u00e7\u00f5es.<\/p>\n
Com isso dito, veja como voc\u00ea pode fazer isso em uma \u00fanica fun\u00e7\u00e3o<\/a><\/strong> (completa com coment\u00e1rios para mostrar o que voc\u00ea 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>\nObserve que isso usa v\u00e1rias fun\u00e7\u00f5es do PHP. Nomeadamente:<\/p>\n
\n
- array_slice<\/a><\/strong><\/li>\n
- scandir<\/a><\/strong><\/li>\n
- dirname<\/a><\/strong><\/li>\n
- o arquivo existe<\/a><\/strong><\/li>\n
- c\u00f3pia de<\/a><\/strong><\/li>\n<\/ul>\n
Tudo o que eu acho que \u00e9 \u00fatil e importante saber, independentemente da natureza em que voc\u00ea est\u00e1 usando.<\/p>\n
Os hosts suportam isso?<\/h2>\n