Cómo crear un plugin de WordPress: Guía de inicio paso a paso

WordPress plugin de creación de gráficos para principiantes

Crear tu propio plugin de WordPress es una de las habilidades más gratificantes que puedes aprender — si quieres añadir una pequeña característica personalizada, resolver un problema para tu sitio, compartir una herramienta con la comunidad, o incluso vender plugins premium. Con el editor de bloques (Gutenberg), edición de sitio completo, y REST API ahora madura, los plugins de construcción es más fácil y más poderoso que nunca.

En Cope Business, desarrollamos regularmente plugins personalizados para clientes como parte de nuestro servicios técnicos de auditoría de la SEO y soluciones personalizadas de WordPress — desde códigos simples a integraciones avanzadas. Esta guía amigable de principiantes te guía a través de la creación de tu primer plugin de WordPress paso a paso — no se requiere experiencia previa de desarrollo plugin.

¿Por qué crear tu propio plugin de WordPress?

  • Resolver problemas específicos que ningún plugin existente maneja perfectamente
  • Añadir características únicas a su sitio sin bloat
  • Compartir o vender su trabajo en WordPress.org o marketplaces
  • Aprender el desarrollo de WordPress profundamente (hooks, filtros, acciones, bloques)
  • Futuro-prueba tus personalizaciones (plugins sobreviven cambios temáticos)

Prerrequisitos (Lo que necesitas)

  • Un sitio de WordPress local o estancado (utiliza el PC local, DevKinsta o XAMPP)
  • Comprensión básica de PHP (lo explicaremos todo)
  • Un editor de códigos (VS Code, Sublime Text, o Notepad++)
  • Acceso FTP o acceso directo a archivos a wp-content/plugins

¡Siempre prueba en un sitio no vivo!

Paso 1: Crear la carpeta Plugin & Main File

  1. Vaya a su carpeta de instalación de WordPress → wp-content/plugins
  2. Crear una nueva carpeta: sobrecarga-primer-plugin (bajo uso, sin espacios, hyphens ok)
  3. Dentro de la carpeta, crear un archivo: cope-first-plugin.php

Paso 2: Agregue el encabezado Plugin (Requierido)

Abierto el primero-plugin.php y pega esto en la parte superior:

PHP

<?php
/**
 * Plugin Name:       Cope First Plugin
 * Plugin URI:        https://www.copebusiness.com
 * Description:       My very first custom WordPress plugin – created with Cope Business guide
 * Version:           1.0.0
 * Requires at least: 6.0
 * Requires PHP:      8.0
 * Author:            Cope Business
 * Author URI:        https://www.copebusiness.com
 * License:           GPL-2.0-or-later
 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain:       cope-first-plugin
 */

Este encabezado dice WordPress es un plugin — sin él, el plugin no aparecerá en el panel de control.

Paso 3: Agregue su primera característica simple (hola Ejemplo Mundial)

Agreguemos un código corto [cope_hello] que produce “Hola de Cope Business!”

Añada este código debajo del encabezado:

PHP

// Prevent direct access
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// Register shortcode
function cope_hello_shortcode() {
    return '<p style="color: #0073aa; font-weight: bold;">Hello from Cope Business! 🚀</p>';
}
add_shortcode( 'cope_hello', 'cope_hello_shortcode' );

Guardar el archivo → Ir a Plugins → Activar “Cope First Plugin”.

Ahora, en cualquier lugar de una publicación o página, escriba [cope_hello] — verá el mensaje!

Paso 4: Agregue más características útiles ( Ejemplos del Mundo Real)

Ejemplo 1: Aviso personalizado

PHP

// Show welcome notice in admin dashboard
function cope_welcome_notice() {
    ?>
    <div class="notice notice-success is-dismissible">
        <p>Thank you for using Cope First Plugin! Need help? <a href="https://www.copebusiness.com/contact">Contact us</a>.</p>
    </div>
    <?php
}
add_action( 'admin_notices', 'cope_welcome_notice' );

Ejemplo 2: Enqueue Custom CSS " JS

PHP

function cope_enqueue_assets() {
    wp_enqueue_style( 'cope-custom-style', plugin_dir_url( __FILE__ ) . 'assets/style.css' );
    wp_enqueue_script( 'cope-custom-script', plugin_dir_url( __FILE__ ) . 'assets/script.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'cope_enqueue_assets' );

Crear carpetas /sets/ y añadir estilo.css y script.js.

Ejemplo 3: Agregue una página de configuración

PHP

// Add settings page under Settings menu
function cope_add_settings_page() {
    add_options_page(
        'Cope Plugin Settings',
        'Cope Settings',
        'manage_options',
        'cope-settings',
        'cope_settings_page_callback'
    );
}
add_action( 'admin_menu', 'cope_add_settings_page' );

function cope_settings_page_callback() {
    ?>
    <div class="wrap">
        <h1>Cope Plugin Settings</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields( 'cope_settings_group' );
            do_settings_sections( 'cope-settings' );
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

(Expand with register_setting() and add_settings_field() for real options.)

Paso 5: Test, Secure & Publish

  • Prueba: Compruebe en múltiples dispositivos, navegadores y roles de usuario.
  • Seguridad: Siempre sanitize/escape salidas (esc html, esc url, etc.).
  • Control de versiones: Use Git para cambios.
  • Distribuir: Zip la carpeta → subir a WordPress.org (gratuito) o vender en su sitio/CodeCanyon.

Las mejores prácticas para WordPress Plugins

  • Use prefijos únicos (por ejemplo, cope o sus iniciales) para evitar conflictos
  • Siga las normas de codificación de WordPress
  • Añádase una licencia adecuada (GPLv2 o posterior)
  • Incluye uninstall.php para limpiar
  • Documenta tu código con comentarios
  • Prueba con el plugin Query Monitor para el rendimiento

Pensamientos finales

Crear su primer plugin de WordPress es más fácil de lo que la mayoría de la gente piensa — empezar pequeño con códigos cortos o avisos de administración, luego construir características más avanzadas. Una vez que entiendes acciones, filtros y bloques, las posibilidades son infinitas.

Plugins son cómo realmente hacer WordPress su propio.

¿Quieres ayudar a crear un plugin personalizado, optimizar tu sitio web, o convertir una idea en un producto premium? Contacto Cope Business para una consulta gratuita — le guiaremos de concepto a lanzamiento con código limpio, seguro y performant.

¿Fue útil este artículo?
No