• +34 685 967 885
  • +34 695 898 191
  • antgarprats@gmail.com
  • Antonio García Prats

creando un plugin en wordpress

Creación de un plugin básico

Un plugin de WordPress es una herramienta esencial para personalizar y ampliar la funcionalidad de tu sitio web. Te permite agregar características únicas, desde simples widgets hasta complejas integraciones con otros servicios. En este tutorial, te guiaremos paso a paso en el proceso de creación de un plugin básico.

Paso 1: Entendiendo la Estructura de un Plugin

Un plugin de WordPress es esencialmente un directorio que contiene uno o más archivos PHP. La estructura básica es la siguiente:

nombre-del-plugin/: Este es el directorio principal de tu plugin.

nombre-del-plugin.php: Este es el archivo principal que contiene la información básica del plugin, como su nombre, descripción y versión.

Paso 2: Creando el Archivo Principal

Comencemos creando el archivo nombre-del-plugin.php. Reemplaza nombre-del-plugin con el nombre que deseas asignarle a tu plugin.

<?php
/*
Plugin Name: Mi Primer Plugin
Plugin URI: https://tudominio.com
Description: Una breve descripción de lo que hace tu plugin.
Version: 1.0
Author: Tu Nombre
Author URI: https://tudominio.com
*/

// Aquí irá el código de tu plugin

Plugin Name: El nombre que se mostrará en el panel de administración.

Plugin URI: La URL del sitio web principal del plugin.

Description: Una breve descripción del plugin.

Version: La versión actual del plugin.

Author: Tu nombre o el nombre de tu empresa.

Author URI: La URL de tu sitio web.

Paso 3: Agregando Funcionalidad

Ahora, vamos a agregar algo de funcionalidad a nuestro plugin. Por ejemplo, podemos crear un mensaje de bienvenida que se mostrará en la parte superior de la pantalla de administración.

function mi_primer_plugin_mensaje() {
    echo '<div class="notice notice-success is-dismissible"><p>¡Bienvenido a mi primer plugin!</p></div>';
}
add_action('admin_notices', 'mi_primer_plugin_mensaje');

mi_primer_plugin_mensaje: Esta función crea el mensaje de bienvenida.

add_action: Esta función engancha nuestra función a la acción admin_notices, lo que significa que se ejecutará cada vez que se cargue la pantalla de administración.

Paso 4: Activando el Plugin

Una vez que hayas creado el plugin, debes activarlo desde el panel de administración de WordPress. Ve a Plugins y busca tu nuevo plugin. Haz clic en el botón Activar.

Paso 5: Probando el Plugin

Después de activar el plugin, inicia sesión en el panel de administración de WordPress. Deberías ver el mensaje de bienvenida que creamos anteriormente en la parte superior de la pantalla.

Ampliando tu Plugin

Esta es solo una introducción básica a la creación de plugins. Puedes hacer mucho más con los plugins de WordPress. Aquí hay algunas ideas para ampliar tu plugin:

Crear un nuevo tipo de publicación: Puedes crear un nuevo tipo de publicación personalizado para almacenar contenido específico.

Agregar un nuevo widget: Puedes crear un widget personalizado para mostrar contenido en las barras laterales o en otras áreas de tu sitio.

Modificar el aspecto de tu sitio: Puedes modificar el aspecto de tu sitio utilizando hojas de estilo CSS y archivos JavaScript.

Integrar tu sitio con otros servicios: Puedes integrar tu sitio con servicios externos como Mailchimp, Google Analytics, …

Mejores Prácticas para el Desarrollo de Plugins

Organización del código:

Estructura de carpetas: Utiliza una estructura clara y consistente para organizar tus archivos. Por ejemplo:

mi-plugin/
├── mi-plugin.php
├── includes/
│   ├── admin.php
│   └── public.php
└── assets/
    ├── css/
    └── js/

Nombrar archivos y funciones: Utiliza nombres descriptivos y sigue un estándar de nomenclatura (por ejemplo, CamelCase para clases y funciones).

Comentarios: Documenta tu código con comentarios claros y concisos para facilitar su comprensión y mantenimiento. Seguridad:

Validación de datos: Siempre valida y sanitiza los datos que ingresan al plugin para prevenir inyecciones de código y otros ataques.

Actualizaciones: Mantén tu plugin actualizado y corrige las vulnerabilidades de seguridad tan pronto como sean descubiertas.

Permisos: Utiliza los permisos adecuados para restringir el acceso a las funcionalidades del plugin.

Pruebas:

Pruebas unitarias: Escribe pruebas unitarias para garantizar que cada parte de tu código funciona correctamente.

Pruebas de integración: Asegúrate de que tu plugin funciona correctamente con otros plugins y temas.

Internacionalización: Si tu plugin está destinado a una audiencia global, internacionalízalo para que pueda ser traducido a diferentes idiomas. Compatibilidad: Asegúrate de que tu plugin sea compatible con las últimas versiones de WordPress y PHP.

Ampliando Nuestro Plugin de Ejemplo: Un Plugin de Testimonios

Funcionalidad: Permitir a los administradores agregar testimonios de clientes, que se mostrarán en una sección personalizada del sitio web.

<?php
/*
Plugin Name: Testimonios WP
Plugin URI: https://tudominio.com
Description: Plugin para agregar testimonios de clientes.
Version: 1.0
Author: Tu Nombre
Author URI: https://tudominio.com
*/

// Crear un nuevo tipo de publicación personalizado
function crear_tipo_publicacion_testimonio() {
    $labels = array(
        'name'                  => _x( 'Testimonios', 'Post Type General Name', 'testimonios-wp' ),
        'singular_name'         => _x( 'Testimonio', 'Post Type Singular Name', 'testimonios-wp' ),
        // ... otros labels
    );

    $args = array(
        'labels'            => $labels,
        'public'            => false,
        'publicly_queryable' => false,
        'show_ui'           => true,
        'show_in_menu'      => true,
        'query_var'         => true,
        'capability_type'   => 'post',
        'has_archive'       => false,
        'hierarchical'      => false,
        'menu_position'     => null,
        'supports'          => array( 'title', 'editor', 'thumbnail' )
    );

    register_post_type( 'testimonio', $args );
}
add_action( 'init', 'crear_tipo_publicacion_testimonio' );

// Crear un shortcode para mostrar los testimonios
function mostrar_testimonios_shortcode() {
    $args = array(
        'post_type'      => 'testimonio',
        'posts_per_page' => -1,
    );
    $testimonios = get_posts( $args );

    if ( $testimonios ) {
        $output = '<div class="testimonios">';
        foreach ( $testimonios as $testimonio ) {
            $output .= '<div class="testimonio">';
            $output .= get_the_post_thumbnail( $testimonio->ID, 'thumbnail' );
            $output .= '<p>' . $testimonio->post_content . '</p>';
            $output .= '</div>';
        }
        $output .= '</div>';
        return $output;
    } else {
        return 'No hay testimonios disponibles.';
    }
}
add_shortcode( 'testimonios', 'mostrar_testimonios_shortcode' );

Explicación:

Nuevo tipo de publicación: Creamos un nuevo tipo de publicación personalizado llamado «testimonio» para almacenar los testimonios.

Shortcode: Creamos un shortcode [testimonios] que se puede utilizar en cualquier página o publicación para mostrar los testimonios.

Diseño: Puedes personalizar el diseño de los testimonios utilizando hojas de estilo CSS.

Aplicaciones en la vida real:

Sitios web de negocios: Mostrar testimonios de clientes satisfechos para aumentar la confianza.

Blogs personales: Destacar opiniones de otros sobre tus artículos.

Portfolios: Mostrar testimonios de clientes sobre tus servicios.

Próximos pasos:

Opciones de configuración: Agregar opciones de configuración para que los administradores puedan personalizar el plugin.

Diseño responsivo: Asegurarse de que los testimonios se muestren correctamente en diferentes dispositivos.

Traducción: Internacionalizar el plugin para que pueda ser utilizado en diferentes idiomas.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *