No que diz respeito aos prot\u00f3tipos r\u00e1pidos e ao WordPress, fizemos duas coisas at\u00e9 agora:<\/p>\n
Neste ponto, fizemos trabalho suficiente para garantir o in\u00edcio da refatora\u00e7\u00e3o de nosso c\u00f3digo. Ou seja, vamos come\u00e7ar a converter o prot\u00f3tipo em c\u00f3digo. Mas isso \u00e9 algo que vai precisar ser feito em duas fases.<\/p>\n
Primeiro, vamos simplesmente introduzir classes que representam os diagramas do post anterior e que encapsulam a responsabilidade de cada projeto.<\/p>\n
Depois disso, veremos como organizar o c\u00f3digo em namespaces e pacotes. Antes de podermos fazer isso, por\u00e9m, precisamos ter certeza de que o c\u00f3digo \u00e9 orientado a objetos e permanece funcional. Ent\u00e3o \u00e9 isso que vai acontecer neste post.<\/p>\n
Se voc\u00ea est\u00e1 lendo os posts anteriores, note que estou planejando seguir a organiza\u00e7\u00e3o que esbocei no \u00faltimo post. Voc\u00ea n\u00e3o precisa seguir esse design espec\u00edfico, \u00e9 claro.<\/p>\n
Se voc\u00ea estiver usando o controle de origem, \u00e9 aqui que recomendo criar um branch<\/a> fora do branch master (se estiver usando o Git) para que voc\u00ea possa fazer seu trabalho sem prejudicar a vers\u00e3o est\u00e1vel do c\u00f3digo.<\/p>\n Isso est\u00e1 um pouco al\u00e9m do escopo da s\u00e9rie, portanto, se voc\u00ea n\u00e3o estiver usando o controle de origem, n\u00e3o se preocupe. Se voc\u00ea for, estou optando por desenvolver<\/strong> como o nome desta ramifica\u00e7\u00e3o. Vou mescl\u00e1-lo de volta ao mestre\u00a0<\/strong> assim que tiver certeza de que est\u00e1 funcional.<\/p>\n Conforme o trabalho esbo\u00e7ado ontem, vou criar duas classes:<\/p>\n Haver\u00e1 alguma reutiliza\u00e7\u00e3o de c\u00f3digo do que j\u00e1 vimos, como voc\u00ea ver\u00e1 no c\u00f3digo a seguir.<\/p>\n Primeiro, nossa metabox<\/a> :<\/p>\n E a seguir, nossa exibi\u00e7\u00e3o<\/a> :<\/p>\n Que no c\u00f3digo da caixa meta, no c\u00f3digo da caixa meta estamos explicitamente instanciando a exibi\u00e7\u00e3o para que possamos chamar seu m\u00e9todo de exibi\u00e7\u00e3o quando necess\u00e1rio.<\/p>\n Outra alternativa seria instanciar os dois objetos separadamente e ent\u00e3o injetar a exibi\u00e7\u00e3o na meta box via inje\u00e7\u00e3o de construtor ou algo semelhante. Isso precisaria ser feito em uma classe de terceiros.<\/p>\n As vantagens disso v\u00eam de desacoplar um pouco mais as duas classes. Talvez n\u00f3s vamos rever como fazer isso no pr\u00f3ximo post.<\/p>\n Depois disso, precisamos seguir em frente e definir a classe respons\u00e1vel por exibir as mensagens dentro do contexto do Meta Box Display. Isto \u00e9 o que chamaremos de Post Messenger<\/a> :<\/p>\n Observe aqui que o Post Messenger tamb\u00e9m faz refer\u00eancia \u00e0 Post Query<\/a>. Esta \u00e9 a classe onde a comunica\u00e7\u00e3o com o banco de dados acontece. Tamb\u00e9m inclu\u00ed algumas fun\u00e7\u00f5es auxiliares para tornar o c\u00f3digo de visualiza\u00e7\u00e3o um pouco mais simples, como veremos em breve.<\/p>\n E \u00e9 isso para as classes principais. Claro, ainda precisamos falar sobre os pontos de vista.<\/p>\n As views s\u00e3o respons\u00e1veis \u200b\u200bpor renderizar o HTML no contexto da meta box. N\u00e3o gosto de escrever HTML no contexto do PHP (nem gosto de misturar PHP no contexto do HTML, mas isso \u00e9 inevit\u00e1vel neste projeto).<\/p>\n Existem alguns grandes projetos de modelagem para tornar isso mais f\u00e1cil, mas eu discordo. De qualquer forma, voc\u00ea notar\u00e1 que no\u00a0 arquivo post-list.php<\/strong>, existem refer\u00eancias a fun\u00e7\u00f5es auxiliares na classe Post Query. Isso \u00e9 para ter certeza de que n\u00e3o estou expondo muitas propriedades e violando a Lei de Dem\u00e9ter.<\/p>\n Vamos dar uma olhada nesse arquivo primeiro, pois \u00e9 o mais complicado<\/a> :<\/p>\n Parece com o c\u00f3digo padr\u00e3o do WordPress, mas lembre-se de que, como esse arquivo \u00e9 chamado no Post Messenger<\/strong>, ele se referir\u00e1 \u00e0 consulta como a consulta envolvida por essa classe.<\/p>\n Os dois \u00faltimos arquivos s\u00e3o bastante simples. Um deles fornece uma descri\u00e7\u00e3o<\/a> :<\/p>\n O outro fornece uma mensagem quando n\u00e3o h\u00e1 postagens<\/a> :<\/p>\n Fora isso, a funcionalidade b\u00e1sica est\u00e1 feita.<\/p>\n A \u00faltima coisa que precisamos fazer \u00e9 iniciar o plugin. Para fazer isso, alteramos o c\u00f3digo no arquivo principal do plugin para que fique assim<\/a> :<\/p>\n Isso se conectar\u00e1 ao WordPress, instanciar\u00e1 nosso plug-in e o colocar\u00e1 em movimento. Ao execut\u00e1-lo em sua instala\u00e7\u00e3o do WordPress, ele deve ficar exatamente como na primeira vers\u00e3o.<\/p>\n A \u00fanica diferen\u00e7a \u00e9 que agora temos as coisas organizadas em classes ao inv\u00e9s de fun\u00e7\u00f5es individuais.<\/p>\n Primeiro, h\u00e1 oportunidades para refatora\u00e7\u00e3o aqui que reduziriam ainda mais o desacoplamento (como diferentes tipos de inje\u00e7\u00e3o de depend\u00eancia<\/a>, etc.), mas o objetivo desta s\u00e9rie n\u00e3o \u00e9 cobrir isso.<\/p>\n Em vez disso, \u00e9 pegar a ideia de ver plugins escritos por muitas fun\u00e7\u00f5es procedurais e ent\u00e3o dividi-los em classes mais conceituais que encapsulam suas responsabilidades.<\/p>\n Em segundo lugar, se voc\u00ea revisar o c\u00f3digo-fonte no reposit\u00f3rio para esta vers\u00e3o do projeto, ver\u00e1 que tamb\u00e9m apresentei composer.json. Isso \u00e9 para que eu possa aproveitar o PHP CodeSniffer<\/a> e os padr\u00f5es de codifica\u00e7\u00e3o do WordPress<\/a> ao escrever c\u00f3digo.<\/p>\n Na \u00faltima parte da s\u00e9rie, passaremos pelo namespace<\/a> e reorganizaremos os arquivos. Se o tempo permitir, incluiremos um autoloader para que n\u00e3o tenhamos que incluir manualmente os arquivos no topo do nosso arquivo de plugin.<\/p>\n Finalmente, mesclei este c\u00f3digo no master e o marquei como 0.2.1<\/a> (j\u00e1 que tive que fazer um pequeno hotfix), j\u00e1 que ainda \u00e9 um trabalho em andamento.<\/p>\nEscrevendo C\u00f3digo<\/h3>\n
\n
O c\u00f3digo<\/h4>\n
<?php\n\/**\n * Registers the Meta Box with WordPress.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Registers the Meta Box with WordPress. Defines the ID, title, display function,\n * and the post type on which it will live.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Meta_Box_Display\n *\/\n private $meta_box_display;\n\n \/**\n * Instantiates the class by setting its property equal to a reference to its display.\n *\/\n public function __construct() {\n $this->meta_box_display = new Meta_Box_Display();\n }\n\n \/**\n * The function responsible for hooking into the WordPress API.\n *\/\n public function init() {\n\n add_meta_box(\n 'three-recent-posts',\n 'Three Recent Posts',\n array( $this->meta_box_display, 'display' ),\n 'post',\n 'side'\n );\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Defines the display for the meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Defines the display for the meta box that will render the content in the\n * context of its meta box.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Meta_Box_Display {\n\n \/**\n * A reference to the class that will display the contents in the meta box.\n *\n * @access private\n * @var Post_Messenger\n *\/\n private $messenger;\n\n \/**\n * Instantiates the object by setting a property equal to that of the class\n * responsible for rendering the messages from the post query.\n *\/\n public function __construct() {\n $this->messenger = new Post_Messenger( $this );\n }\n\n \/**\n * If there are posts to display, renders them in the metabox. Otherwise, displays\n * a note that there are no posts to display.\n *\/\n public function display( $message) {\n $this->messenger->get_message();\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Display content for the meta box when requested.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Retrieves information from the class responsible for querying the database and\n * renders it in the context of our meta box when called via the Meta Box Display.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Messenger {\n\n \/**\n * A reference to the query resonsible for retrieving post information from\n * the database.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * A reference to the message that's displayed in the view of the\n * meta box.\n *\n * @access private\n *\/\n private $message;\n\n \/**\n * Instantiates the class by setting a reference to the query.\n *\/\n public function __construct() {\n $this->query = new Post_Query();\n }\n\n \/**\n * Retrieves the content to be displayed in the meta box.\n *\/\n public function get_message() {\n\n $this->get_description();\n\n if ($this->query->has_posts()) {\n $this->get_post_message();\n } else {\n $this->get_no_posts_message();\n }\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_post_message() {\n include_once 'post-list.php';\n }\n\n \/**\n * Displays the description of the content of the meta box.\n *\n * @access private\n *\/\n private function get_description() {\n include_once 'message-description.php';\n }\n\n \/**\n * Displays a message of there are no recent posts.\n *\n * @access private\n *\/\n private function get_no_posts_message() {\n include_once 'no-post-list.php';\n }\n}\n<\/code><\/pre>\n<?php\n\/**\n * Queries the database for three most recent posts.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\n\n\/**\n * Queries the database for three most recent posts. Returns the query to the\n * caller so that it can be interrogates for posts or not.\n *\n * @author Tom McFarlin\n * @since 0.2.0\n *\/\nclass Post_Query {\n\n \/**\n * A reference to the WP_Query this class wraps.\n *\n * @access private\n * @var WP_Query\n *\/\n private $query;\n\n \/**\n * Instantiates the class by preparing instance data and executing the\n * query so the display can render the contents.\n *\/\n public function __construct() {\n\n $this->query = null;\n $this->get_posts();\n }\n\n \/**\n * Executes the query for returning the post recent posts ordered by date.\n *\n * @access private\n *\/\n private function get_posts() {\n\n $args = array(\n 'post_type' => 'post',\n 'post_status' => 'publish',\n 'orderby' => 'date',\n 'order' => 'desc',\n );\n $this->query = new WP_Query( $args );\n\n return $this->query;\n }\n\n \/**\n * A helper function to determine if the query has any posts.\n *\/\n public function has_posts() {\n return! $this->query->have_posts();\n }\n\n \/**\n * A helper function for retrieving the next post in the list of\n * posts\n *\/\n public function the_post() {\n return $this->query->the_post();\n }\n}\n<\/code><\/pre>\nAs visualiza\u00e7\u00f5es<\/h4>\n
<ol>\n <?php while ($this->query->has_posts()) { ?>\n <?php $this->query->the_post(); ?>\n <li>\n <a href=\"<?php get_the_permalink(); ?>\" target=\"_blank\">\n <?php echo get_the_title(); ?>\n <\/a>\n <\/li>\n <?php } ?>\n<\/ol><\/code><\/pre>\n<p>\n <span class=\"description\">\n Displays up to the three most recent posts.\n <\/span><!-- .description -->\n<\/p><\/code><\/pre>\n<p>There are no recent posts.<\/p><\/code><\/pre>\nInicializando o plug-in<\/h3>\n
<?php\n\/**\n * Three Recent Posts\n *\n * @package TRP\n * @author Tom McFarlin\n * @copyright 2017 Tom McFarlin\n * @license MIT\n *\n * @wordpress-plugin\n * Plugin Name: Three Recent Posts\n * Plugin URI: https:\/\/tommcfarlin.com\/three-recent-posts\/\n * Description: Displays the three mot recent posts in your post editor screen.\n * Version: 0.2.0\n * Author: Tom McFarlin\n * Author URI: https:\/\/tommcfarlin.com\n * Text Domain: three-recent-posts\n * License: GPL\n * License URI: http:\/\/www.gnu.org\/licenses\/gpl-3.0.txt\n *\/\n\ninclude 'class-meta-box.php';\ninclude 'class-meta-box-display.php';\ninclude 'class-post-messenger.php';\ninclude 'class-post-query.php';\n\nadd_action( 'add_meta_boxes', 'trp_start' );\n\/**\n * Starts the plugin.\n *\/\nfunction trp_start() {\n\n $meta_box = new Meta_Box();\n $meta_box->init();\n}\n<\/code><\/pre>\nNotas<\/h2>\n
Postagens da s\u00e9rie<\/h2>\n
\n