Instrucciones de WordPress: los fundamentos del desarrollo de plugins de WP

Artículo escrito por:
  • Consejos para blogs
  • Actualizado: Ago 12, 2013

Estaremos trabajando en una serie de artículos centrados en “como hacer X con WordPress". Estos artículos serán un poco largos y serán principalmente para webmasters y desarrolladores experimentados; En caso de que sea nuevo en WordPress, por favor revise mi Guía de tu primer blog de WordPress.

Y ahora, una introducción básica.

Expandiendo las características de WordPress desarrollando un nuevo complemento

Página de WordPress

WordPress es la plataforma de administración de contenido más popular del mundo, con más de 60 millones de usuarios de su paquete de instalación de PHP auto hospedado y millones más que utilizan su servicio WordPress.com basado en la web y el hospedaje remoto. Esto no es una coincidencia o un error. WordPress es, sencillamente, la aplicación de gestión de contenido más asequible y con todas las funciones del mundo. Sin embargo, incluso este titán de la administración de contenido no es absolutamente perfecto, y muchos usuarios finalmente encuentran que el software carece de una o dos funciones esenciales sin las cuales no pueden vivir.

entrar WordPress plugins.

Estos usuarios insatisfechos luego irán a una búsqueda, una búsqueda grande, en un esfuerzo por encontrar el complemento adecuado para realizar el trabajo. Algunas personas encuentran el complemento que necesitan, PERO muchas otras simplemente no encuentran lo que están buscando.

Algunos usuarios de WordPress pueden contentarse con simplemente abandonar la pelea y resignarse a una vida en la que falta una característica esencial de su sitio web. Pero un grupo considerable de estos usuarios simplemente no está dispuesto a tirar la toalla, y seguirán el proceso de diseñar su propio complemento personalizado para realizar el trabajo. Puede parecer complicado e intimidante, y algunas partes podrían serlo. Ciertamente, Conocimiento sólido de PHP será necesario para complementos más avanzados que agreguen funciones reales a la funcionalidad de WordPress. Pero un complemento es una cosa relativamente fácil de escribir, especialmente para funciones básicas que son estándar en WordPress y simplemente necesita ser "reelaborado" para hacer el trabajo mejor y presentarlo de una manera más agradable.

Los usuarios que no se conforman con ser los mejores, y están pensando en crear su propio complemento, solo deben seguir los sencillos pasos a continuación para colocar su instalación de WordPress en un camino hacia una mayor funcionalidad y compatibilidad con sus grandes ideas y grandes planes para dominar Internet .

Paso 1: crea un nuevo archivo dentro del directorio de complementos y dale un propósito

Plugins WP

El primer paso para crear un complemento es simplemente crear un nuevo archivo de complemento de PHP dentro del directorio de complementos de WordPress existente.

En este momento, la mayoría de los usuarios deberían saber dónde ubicar ese directorio, ya que es probable que hayan subido algunos complementos para mejorar la funcionalidad de sus instalaciones de WordPress. Sin embargo, para aquellos que realmente se están acercando a este proceso como un principiante completo y total, el directorio que contiene todos los pug en archivos se encuentra en la siguiente ubicación para cada versión e iteración del software de WordPress:

/ public_html / wp-content / plugins /

Vaya a ese directorio y cree un nuevo archivo (en blanco, en este punto) llamado "my-custom-plugin.php". Este es el archivo que contendrá todo nuestro trabajo de principio a fin, y le daremos un El nombre obvio no se elimina ni se activa prematuramente durante el proceso de desarrollo. Una vez que este archivo se haya creado y cargado en el servidor, use un cliente FTP para editarlo directamente (usando un editor de texto incorporado) mientras aún esté alojado en el servidor. Esta es la mejor manera de editar archivos remotos, ya que hace que guardar y cargar sea esencialmente automático, y definitivamente más fácil que administrar múltiples versiones del mismo archivo almacenado en diferentes ubicaciones.

Ahora se nombrará, describirá y dará un nombre al complemento. Este es el mismo tipo de información que se coloca en la parte superior del archivo de la hoja de estilo "style.css" de un tema, y ​​los desarrolladores del tema se sentirán como en casa al completar la información a continuación. Coloque esta información en la parte superior del archivo del complemento antes de cualquier otro código. Incluso la etiqueta PHP de apertura no debe colocarse antes de estas líneas comentadas. Si estas líneas se colocan incorrectamente, o se omiten por completo, el complemento en sí no aparecerá en el Panel de WordPress. Eso significa que no se puede activar, usar, probar o depurar, y eso no es bueno. Esto es lo que se debe completar antes de abrir el archivo y proceder a definir una función:

/*
Nombre del complemento: un complemento personalizado que se utiliza para aprender las formas de WordPress
URI del plugin: http://www.your-website-here.com
Descripción: este complemento se utiliza para demostrar cómo se coloca el código PHP, las variables de WordPress, XHTML, CSS y otra información en un archivo PHP de complemento estándar para agregar una nueva funcionalidad a una instalación estándar de WordPress.
Autor: tu nombre aquí
Version: 1.0
Autor URI: http://www.your-website-here.com
*/

Con esa información completa, el Panel de WordPress detectará el complemento y su información se mostrará correctamente junto con otros complementos dentro del panel de administración de la activación / eliminación de complementos. Ahora se le ha dado al complemento un nombre de archivo, un nombre descriptivo y un propósito. Todo lo que falta en este punto son algunas funciones. Ahí es donde entra el paso dos.

Plugins WP

Paso 2: Definición de una función de complemento (o funciones) para usar en un sitio web de WordPress

Esta demostración del complemento asumirá que el desarrollador ha creado un campo personalizado. Este campo se utilizará para determinar si los enlaces de redes sociales se incluyen o no en la publicación para que los usuarios puedan compartir la publicación con sus amigos y familiares que estén suscritos a las actualizaciones de sus redes sociales en sitios como Twitter, Facebook, LinkedIn y MySpace. . Se ha creado un campo personalizado, en este caso, denominado "social_links".

Usando el código PHP en el complemento, determinaremos si el campo de las redes sociales tiene datos dentro o no. Si lo hace, se mostrará una "barra" de enlaces de redes sociales para compartir. Si no tiene ningún dato dentro, se omitirán estos enlaces. Esta es una excelente manera de deshabilitar el uso compartido de publicaciones en su sitio web que simplemente no están destinadas a ser vistas por el público en general, y hacerlo en un complemento es una excelente manera de garantizar que esta funcionalidad se aplique a todos los temas, en lugar de simplemente Plantilla de entrada de un tema.

Este proceso se realiza al "agregar" una acción al código de WordPress. Esto se hace usando el comando PHP "add_action", estacionado con varias declaraciones de "eco" y lente existente del código de WordPress que se puede portar directamente desde los archivos de plantilla de WordPress existentes. Recuerde que prácticamente cualquier variable que se pueda usar en una plantilla también es válida para su inclusión en un archivo de complemento, aunque las etiquetas PHP de apertura y cierre deben omitirse, ya que el código ya está envuelto en una caja de etiquetas PHP de apertura y cierre que abarca todo. .

Así es como se ve la "acción" agregada dentro del archivo de complemento cuando está completamente lleno:

función social_links ($ post_ID) {
Global $ wp_query;
$ ID = $ wp_query-> post-> ID;
if (get_post_meta (13); == 1)
{
devuelve $ post_ID. "Botones de enlace de redes sociales";
}
más
{
devuelve $ post_ID. “”;
}
}
add_action ('the_content', 'social_links');

Las primeras líneas de código se usan simplemente para determinar si se ha completado o no alguna información "meta" en el Panel de WordPress para la entrada específica que se está viendo. Esto se hace consultando la base de datos de WordPress (usando la variable $ wp_query) y buscando información dentro del metacampo número 13. Cada campo personalizado recibe una identificación numérica, al igual que las entradas, los comentarios y las páginas. Este número puede usarse dentro de variables para sentencias condicionales.

Entonces, primero el complemento busca en el campo personalizado para cada entrada y ve si el contenido está presente o no en la tabla de la base de datos del campo. A continuación, se ejecuta a través del condicional. Si el contenido es igual a "1", continúa. El uso de "1" en este caso significa "si el campo tiene datos presentes". Lo inverso de esto sería "0" que se traduciría a "si el campo no tiene datos presentes". Por lo tanto, si el campo tiene datos presentes , o es igual a "1", la función pasa a la primera parte del condicional. Esa sección proporciona la visualización de enlaces para compartir en las redes sociales. Por razones de brevedad, esos enlaces no se han incluido con la función. Sin embargo, se puede pretender que usan XHTML simple dentro de las citas que siguen a la declaración "return $ post_ID".

Si el campo personalizado no tiene datos presentes, efectivamente es igual a "0" en lo que respecta al código de este complemento. Sin embargo, debido a que esta condicional es una declaración de uno u otro, en lugar de una con muchos resultados diferentes, simplemente utilizamos la construcción "else" para indicar al complemento que imprima el contenido alternativo en cualquier otra circunstancia. En este caso, simplemente no imprime nada. Por esta razón, todo lo que debe colocarse dentro de la función es:

devuelve $ post_ID “”

En la parte inferior de la declaración, agregamos nuestra nueva función como una "acción" a la variable PHP "the_content" existente. Esto agregará los botones de compartir redes sociales al final de una entrada directamente después de que el contenido de la entrada haya terminado de imprimirse. Las declaraciones en esta declaración entre paréntesis son cronológicas, lo que significa que la nueva acción ("social_links") podría colocarse antes de "the_content" si se suponía que esos botones se mostrarían al principio del contenido, justo después de que el título de la entrada se hubiera impreso en el pantalla.

Con la función completada y la acción agregada al bucle de WordPress directamente después de que la parte principal del contenido de la entrada se imprima en la página, el complemento está esencialmente completo. Este es el momento adecuado para agregar la etiqueta PHP de cierre, guardar el archivo y cargarlo en el servidor para su uso.

Paso 3: activa el complemento y pruébalo

La parte más importante del proceso es activar el complemento y verificar que sus funciones funcionan como se espera y no causan problemas con los complementos existentes o las características estándar de WordPress. Este también es un buen momento para verificar la integridad del código PHP y garantizar que cualquier salida (XHTML o de otro tipo) se imprima como se desee.

Si surge algún error durante el proceso de activación y prueba, es importante revisar el archivo del complemento y asegurarse de que todas las declaraciones estén abiertas y cerradas correctamente. Esto significa verificar la puntuación, en muchos casos, incluidos paréntesis, punto y coma, corchetes y letras minúsculas. Recuerde que PHP distingue entre mayúsculas y minúsculas, y también es sensible a la puntuación: cualquier declaración no cerrada esencialmente continúa infinitamente y puede hacer que las páginas simplemente no se carguen, o que se carguen extremadamente lentamente.

Cuando todos los problemas se han resuelto, el trabajo está casi completo. Sin embargo, hay algunas consideraciones adicionales a tener en cuenta para otros escenarios.

Paso 4: Creando un archivo ReadMe de plugin

Crear un complemento de WordPress

Si el complemento está destinado exclusivamente para uso privado, simplemente no hay razón para crear un archivo "Léame" a menos que, por supuesto, tenga miedo de olvidar lo que hace el complemento, cómo se creó o cómo funciona dentro de El propio bucle de WordPress. Sin embargo, muchos desarrolladores crean complementos con la intención de distribuirlos a la comunidad más amplia de WordPress y, con más de 60 millones de usuarios, esta es una forma lucrativa de promocionar un sitio web y obtener ingresos secundarios.

A esos usuarios se les exige virtualmente que elaboren un documento ReadMe que describa las funciones del complemento, cómo instalar el archivo en el servidor y cómo configurarlo y personalizar sus funciones. Este archivo también puede contener información como el registro de cambios que detalla cada cambio y actualización realizados en el complemento a lo largo del tiempo. Sin embargo, lo importante es explicar qué hace el complemento, cómo funciona y cómo instalarlo. Los usuarios novatos no sabrán qué hacer si no son guiados a través del proceso, al igual que los desarrolladores novatos de complementos no sabían cómo crear una nueva función de WordPress hasta el último paso de esta guía.

Cuando el archivo del complemento se ha completado y emparejado con un archivo Léame (generalmente un archivo .txt), es el momento de colocar ambos documentos en su propia carpeta y comprimirlos utilizando el formato de archivo ZIP estándar. El complemento se puede cargar en la comunidad de complementos y temas de WordPress Extend, así como en el servidor del desarrollador para una solución auto hospedada.

Relativamente fácil de hacer, especialmente con las variables y funciones de WordPress

Lo mejor de desarrollar un nuevo complemento para WordPress es que el archivo puede usar cualquier función, variable o bucle PHP existente, que WordPress ya haya definido e inicializado. Esto facilita la extensión de las funciones de WordPress y la mejora de su funcionalidad en muchos temas, y hace que el proceso de desarrollo del complemento sea tan fácil como crear un nuevo tema para el propio software.

Siempre recuerde probar errores, errores de validación y conflictos de funciones antes de poner el complemento en uso activo o compartirlo con la comunidad de WordPress más amplia. Cuando se haya completado ese proceso y el complemento funcione correctamente, la etapa de desarrollo está completa y podrá disfrutar del éxito y las nuevas características que acaba de crear. ;)

Más lecturas sobre la RHRAP

Para profundizar en esto, echa un vistazo La lista de Jerry de complementos de WordPress esenciales de 20, 25 Handy Code Snippets para desarrolladores de WordPress, Más buscados WordPress Hacks, consejos y trucos; y, si está buscando un buen alojamiento de WordPress, vea lo que he estado usando recientemente: WP Engine - es un host bastante costoso (por lo tanto, no recomendado para novatos) pero obtienes lo que pagas.

Acerca de Jerry Low

Fundador de WebHostingSecretRevealed.net (WHSR): una revisión de alojamiento confiable y utilizada por los usuarios de 100,000. Más de 15 años de experiencia en alojamiento web, marketing de afiliación y SEO. Colaborador de ProBlogger.net, Business.com, SocialMediaToday.com y más.