Quando me sentei para come\u00e7ar este post, planejei escrever algo muito mais envolvente do que o que vou compartilhar. Inicialmente, eu queria passar por uma de duas coisas:<\/p>\n
A primeira seria focar em uma variedade de outras coisas sobre as quais falei, unindo-as todas e tendo uma refer\u00eancia definitiva. Mas isso \u00e9 algo que eu quero ter tempo para montar para garantir que seja feito corretamente.<\/p>\n
O segundo \u00e9 um que acho importante, mas estou em uma fase de transi\u00e7\u00e3o com algumas das minhas pr\u00f3prias ferramentas. At\u00e9 que isso seja feito, prefiro n\u00e3o escrever sobre isso.<\/p>\n
Mesmo assim, sempre h\u00e1 algo para cobrir, certo? Ent\u00e3o, hoje optei por algo mais simples: detalhando o uso de classes, templates e parciais em plugins do WordPress usando um exemplo simples.<\/p>\n
Para este t\u00f3pico em particular, uma pergunta imediata que pode vir \u00e0 mente \u00e9 simples: por que se preocupar em falar sobre isso?<\/p>\n
Porque \u00e9 2018 e ainda estamos vendo uma mistura bruta de PHP, CSS, marca\u00e7\u00e3o e JavaScript em um \u00fanico arquivo. Isso n\u00e3o \u00e9 para bater em outras tecnologias que fazem isso por padr\u00e3o (como React). Estou falando especificamente sobre plugins do WordPress e escrever c\u00f3digo sustent\u00e1vel de forma que seja f\u00e1cil [obviamente] manter, escrever e ler.<\/p>\n
Digamos que voc\u00ea esteja trabalhando em uma p\u00e1gina de submenu para algo que aparecer\u00e1 em um menu personalizado. Voc\u00ea registra sua p\u00e1gina<\/a> usando a API do WordPress:<\/p>\n Mas quando voc\u00ea configura uma fun\u00e7\u00e3o de retorno de chamada para exibir a p\u00e1gina, voc\u00ea n\u00e3o<\/strong> usa a fun\u00e7\u00e3o para misturar todos os v\u00e1rios idiomas juntos. Em vez disso, voc\u00ea o usa para incluir um arquivo.<\/a><\/strong><\/p>\n Observe que no arquivo acima, fa\u00e7o refer\u00eancia a uma propriedade $this->pluginPath<\/strong>. Isso \u00e9 definido no construtor da classe para que eu possa acessar facilmente a raiz do plugin.<\/p>\n De qualquer forma, como seria esse arquivo?<\/p>\n Nesse caso, suponho que seu modelo \u00e9 o que fornecer\u00e1 informa\u00e7\u00f5es ao usu\u00e1rio e solicitar\u00e1 sua entrada. A parcial ser\u00e1 respons\u00e1vel por exibir uma mensagem de sucesso, erro ou aviso ao usu\u00e1rio.<\/p>\n Para simplificar, manterei o modelo e o parcial o mais enxutos poss\u00edvel. Nesse caso, suponha que vamos renderizar uma p\u00e1gina, pedir ao usu\u00e1rio para salvar um valor e, se o valor for salvo com sucesso (e, portanto, existir na tabela wp_options<\/strong> ), exibiremos a mensagem de sucesso.<\/p>\n Isso significa:<\/p>\n D\u00ea uma olhada no c\u00f3digo para o modelo abaixo:<\/a><\/strong><\/p>\n Observe que, sim, ele tem uma entrada, um bot\u00e3o salvar e um nonce, todos importantes (mas fora do escopo deste post) para salvar informa\u00e7\u00f5es.<\/p>\n Mas observe tamb\u00e9m que ele tem uma fun\u00e7\u00e3o auxiliar que eu uso para verificar a presen\u00e7a de informa\u00e7\u00f5es salvas com sucesso. Esta fun\u00e7\u00e3o reside na mesma classe respons\u00e1vel por renderizar o template.<\/p>\n<?php\n\npublic function addMenuPage()\n{\n add_menu_page(\n 'Acme Menu',\n 'Acme Menu',\n 'manage_options',\n 'acme-custom-menu',\n array($this, 'display'),\n 'dashicons-dashboard',\n 30\n );\n\n add_submenu_page(\n 'acme-custom-menu',\n 'Acme Menu',\n 'Acme Menu',\n 'Acme Menu',\n 'acme-custom-menu',\n array($this, 'display')\n );\n}\n<\/code><\/pre>\n<?php\n\npublic function display()\n{\n include_once $this->pluginPath. 'views\/acme-settings.php';\n}\n<\/code><\/pre>\nUm modelo e um parcial<\/h3>\n
Uma amostra<\/h4>\n
\n
<?php\n\/**\n * Renders the settings page for the plugin.\n *\/\n?>\n<div class=\"wrap\">\n <h1 class=\"wp-heading-inline\"><?php echo get_admin_page_title(); ?><\/h1>\n <?php if ($this->showSuccessMessage()) { ?>\n <?php include_once 'partials\/settings-saved.php'; ?>\n ?>\n <div id=\"acme-settings-schedule\">\n <form id=\"acme-form\" method=\"post\" action=\"<?php echo esc_html(admin_url('admin-post.php')); ?>\"\">\n <!-- This is where your settings go. -->\n <p>\n <?php\n submit_button(\n 'Save',\n 'primary',\n 'acme-save-settings',\n false\n );\n wp_nonce_field(\n 'acme-save',\n 'acme-save-nonce'\n );\n ?>\n <\/p>\n <\/form>\n <\/div>\n<\/div>\n<\/code><\/pre>\nParcial<\/h4>\n