Digamos que voc\u00ea esteja trabalhando em um projeto no qual deseja fornecer ao usu\u00e1rio a capacidade de baixar todos os endere\u00e7os de e-mail dos usu\u00e1rios que existem na instala\u00e7\u00e3o do WordPress. Concedido, isso tem alguns requisitos:<\/p>\n
Cada um dos conceitos acima provavelmente j\u00e1 foi abordado aqui antes, mas e se voc\u00ea quiser junt\u00e1-los todos? Ou seja, e se voc\u00ea quiser facilitar o download de endere\u00e7os de e-mail de usu\u00e1rios via JSON no WordPress de, digamos, um menu de administra\u00e7\u00e3o ou um submenu?<\/p>\n
Uma foto obrigat\u00f3ria de onde estou trabalhando enquanto escrevo este post.<\/p>\n
Aqui est\u00e1 uma maneira de resolver esse problema. Observe que ele pressup\u00f5e que voc\u00ea tenha algum conhecimento dos itens acima, mas farei o que puder para cobrir cada um dos itens acima.<\/p>\n
Antes de come\u00e7ar, observe que estou configurando isso para funcionar sempre que um usu\u00e1rio clicar em um submenu no\u00a0 menu Ferramentas<\/strong> no WordPress.<\/p>\n Como voc\u00ea configura seus ganchos pode variar. Comecei a usar um tipo particular de arquitetura que est\u00e1 se tornando cada vez mais padr\u00e3o nos projetos que uso para mim e que usamos na Pressware<\/a>, mas estou divagando sobre isso (talvez eu forne\u00e7a algumas dicas para isso mais tarde).<\/p>\n De qualquer forma, aqui est\u00e1 o c\u00f3digo para adicionar o submenu<\/a>.<\/p>\n \u00c9 exatamente o que voc\u00ea esperaria, certo? Se estiver usando c\u00f3digo orientado a objetos, voc\u00ea pode (ou n\u00e3o, novamente, dependendo de como voc\u00ea arquitetou sua solu\u00e7\u00e3o) precisar usar uma matriz para especificar uma inst\u00e2ncia da classe atual e seu m\u00e9todo.<\/p>\n Observe tamb\u00e9m que n\u00e3o vou me preocupar com internacionaliza\u00e7\u00e3o no contexto deste post. N\u00e3o \u00e9 que n\u00e3o possa ser feito; n\u00e3o \u00e9 que n\u00e3o seja importante. \u00c9 uma quest\u00e3o de tentar manter o post o mais enxuto poss\u00edvel.<\/p>\n Vou supor que voc\u00ea tenha um\u00a0 arquivo exportEmail.js<\/strong> localizado em seu perfil e este \u00e9 o arquivo que ser\u00e1 respons\u00e1vel por consultar o lado do servidor e retornar o arquivo para download.<\/p>\n A primeira coisa a fazer \u00e9 registrar com seguran\u00e7a o JavaScript no lado do servidor usando as fun\u00e7\u00f5es padr\u00e3o da API<\/a> :<\/p>\n Feito isso, voc\u00ea pode escrever o JavaScript que chamar\u00e1 o server-side. Mas esta \u00e9 uma etapa de duas partes: inclui JavaScript e mais c\u00f3digo do lado do servidor.<\/p>\n Como o b\u00e1sico est\u00e1 em vigor para chamar o lado do servidor, \u00e9 poss\u00edvel configurar o JavaScript agora.<\/p>\n Primeiro, h\u00e1 o manipulador de cliques<\/a> :<\/p>\n A chamada get<\/strong> inicial deve ser algo assim<\/a> :<\/p>\n Observe que ele usa o valor de seguran\u00e7a que criamos anteriormente e, em seguida, usa o nome de outra fun\u00e7\u00e3o, ou seja\u00a0, getEmailAddresses<\/strong>, que est\u00e1 chamando no lado do servidor.<\/p>\n Essa fun\u00e7\u00e3o \u00e9 respons\u00e1vel por executar uma consulta, obter os endere\u00e7os de e-mail e gravar um arquivo JSON tempor\u00e1rio para retornar ao usu\u00e1rio.<\/p>\n Primeiro, WP_User_Query<\/a> possibilitar\u00e1 a retirada de todos os usu\u00e1rios para determinados crit\u00e9rios<\/a>.<\/p>\n Para os prop\u00f3sitos deste exemplo, obviamente estou esclarecendo os argumentos.<\/p>\nAdicionando um submenu<\/h3>\n
<?php\npublic function addSubmenuPage()\n{\n add_submenu_page(\n 'tools.php',\n 'Export Emails',\n 'Export Emails',\n 'manage_options',\n 'acme-export-emails',\n 'exportEmails'\n );\n}\n<\/code><\/pre>\nRegistrando o JavaScript<\/h3>\n
<?php\n\npublic function addJavaScript()\n{\n if (!current_user_can('manage_options')) {\n return;\n }\n\n wp_enqueue_script(\n 'acme-email-export-admin',\n $this->plugin_url. 'Emails\/assets\/scripts\/exportEmail.js',\n array('jquery')\n );\n\n wp_localize_script(\n 'acme-email-export-admin',\n 'acme_email_export',\n array(\n 'ajax_url' => admin_url('admin-ajax.php'),\n 'security' => wp_create_nonce('acme-email-export-nonce')) );\n}\n<\/code><\/pre>\nO lado do cliente chamando o lado do servidor<\/h3>\n
$('a[href=\"tools.php?page=acme-export-emails\"]').on('click', function(evt){\n evt.preventDefault();\n _getEmailAddresses($(this));\n});<\/code><\/pre>\nvar _getEmailAddresses = function($elem) {\n $.get(acme_email_export.ajax_url, {\n security: acme_email_export.security,\n action: 'getEmailAddresses'\n }, function(response) {\n\n if ('' === response) {\n return;\n }\n \/\/ TODO...\n });\n};<\/code><\/pre>\n1 Obtenha os endere\u00e7os de e-mail dos usu\u00e1rios<\/h4>\n
<?php\nprivate function getUserResults()\n{\n $query = new WP_User_Query(\n array(\n 'role_in' => array('administrator','subscriber')) );\n return $query->get_results();\n}\n<\/code><\/pre>\n2 Analise o e-mail dos resultados<\/h4>\n