Cuando me sent\u00e9 para comenzar esta publicaci\u00f3n, plane\u00e9 escribir algo mucho m\u00e1s complicado de lo que voy a compartir. Inicialmente, quer\u00eda caminar a trav\u00e9s de una de dos cosas:<\/p>\n
El primero ser\u00eda centrarse en una variedad de otras cosas de las que he hablado, unirlas todas y tener una referencia definitiva. Pero esto es algo en lo que quiero tomarme el tiempo de armar para asegurarme de que se haga bien.<\/p>\n
El segundo es uno que creo que es importante, pero estoy en una fase de transici\u00f3n con algunas de mis propias herramientas. Hasta que eso est\u00e9 hecho, prefiero no escribir sobre eso.<\/p>\n
A\u00fan as\u00ed, siempre hay algo que cubrir, \u00bfverdad? As\u00ed que hoy opt\u00e9 por algo m\u00e1s simple: desglosar el uso de clases, plantillas y parciales en los complementos de WordPress usando un ejemplo simple.<\/p>\n
Para este tema en particular, una pregunta inmediata que puede surgir es simple: \u00bfPor qu\u00e9 molestarse en hablar de esto?<\/p>\n
Porque estamos en 2018 y seguimos viendo una gran combinaci\u00f3n de PHP, CSS, marcado y JavaScript en un solo archivo. Esto no es para tocar otras tecnolog\u00edas que hacen esto de manera predeterminada (como React). Me refiero espec\u00edficamente a los complementos de WordPress y a escribir c\u00f3digo mantenible de tal manera que sea [obviamente] f\u00e1cil de mantener, escribir y leer.<\/p>\n
Supongamos que est\u00e1 trabajando en una p\u00e1gina de submen\u00fa para algo que aparecer\u00e1 en un men\u00fa personalizado. Registras tu p\u00e1gina<\/a> usando la API de WordPress:<\/p>\n Pero cuando configura una funci\u00f3n de devoluci\u00f3n de llamada para mostrar la p\u00e1gina, no<\/strong> usa la funci\u00f3n para mezclar todos los idiomas. En su lugar, lo usa para incluir un archivo.<\/a><\/strong><\/p>\n Tenga en cuenta que en el archivo anterior, hago referencia a una propiedad $this->pluginPath<\/strong>. Esto se establece en el constructor de la clase para que pueda acceder f\u00e1cilmente a la ra\u00edz del complemento.<\/p>\n De todos modos, \u00bfc\u00f3mo podr\u00eda ser este archivo?<\/p>\n En este caso, asumo que su plantilla es lo que proporcionar\u00e1 informaci\u00f3n al usuario y solicitar\u00e1 su entrada. El parcial ser\u00e1 responsable de mostrar un mensaje de \u00e9xito, error o advertencia al usuario.<\/p>\n Para simplificar, mantendr\u00e9 la plantilla y el parcial lo m\u00e1s reducidos posible. En este caso, suponga que vamos a mostrar una p\u00e1gina, le pediremos al usuario que guarde un valor y, si el valor se guarda correctamente (y, por lo tanto, existe en la tabla wp_options<\/strong> ), mostraremos el mensaje de \u00e9xito.<\/p>\n Esto significa:<\/p>\n Eche un vistazo al c\u00f3digo de la plantilla a continuaci\u00f3n:<\/a><\/strong><\/p>\n Tenga en cuenta que, s\u00ed, tiene una entrada, un bot\u00f3n para guardar y un nonce, todos los cuales son importantes (pero m\u00e1s all\u00e1 del alcance de esta publicaci\u00f3n) para guardar informaci\u00f3n.<\/p>\n Pero tambi\u00e9n tenga en cuenta que tiene una funci\u00f3n de ayuda que uso para verificar la presencia de informaci\u00f3n guardada con \u00e9xito. Esta funci\u00f3n reside en la misma clase responsable de representar la plantilla.<\/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>\nUna plantilla y un parcial<\/h3>\n
Una plantilla<\/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