WordPress es uno de los sistemas de gestión de contenidos (CMS) más populares en todo el mundo. Una de las mejores características de WordPress es la posibilidad de crear tus propios plugins y así personalizar y ampliar la funcionalidad de tu sitio web como desees. En esta publicación de blog, le brindaré una guía detallada sobre cómo crear un complemento de WordPress que integre múltiples funciones, tenga su propia página de administración y ofrezca funciones completas de activación y desactivación.
Paso 1: Comprenda los conceptos básicos del complemento
Antes de comenzar con el desarrollo real, necesitamos comprender los conceptos básicos de un complemento de WordPress. Un complemento es esencialmente una colección de archivos PHP que se colocan en el directorio de WordPress. wp-content/plugins ser cargado Amplía la funcionalidad de su sitio web y puede realizar varias tareas, desde personalizar el tema hasta agregar nuevas funciones.
Paso 2: Crear la estructura del complemento
Comencemos creando la estructura básica de nuestro complemento. Crea una nueva carpeta en wp-content/plugins y llámelo “mi-plugin”. En esta carpeta, cree un archivo principal llamado mi-plugin.php. Este archivo se carga cuando se activa el complemento y contiene el código que inicializa las funciones del complemento.
<?php /* Plugin Name: Mein WordPress Plugin Description: Ein tolles Plugin für deine Website. Version: 1.0 Author: Dein Name */ // Hier beginnt der Plugin-Code ?>
Paso 3: Agregar funciones
Ahora agregamos algunas funciones de ejemplo. Supongamos que queremos agregar un botón personalizado al editor de WordPress para insertar contenido especial. He aquí un ejemplo sencillo:
function mein_plugin_button($buttons) {
array_push($buttons, "mein_plugin_button");
return $buttons;
}
function mein_plugin_button_action($content) {
return $content . "<p>Hallo, das ist mein Plugin!</p>";
}
add_filter('mce_buttons', 'mein_plugin_button');
add_filter('mce_external_plugins', 'mein_plugin_button_action');
Si desea tener múltiples funciones en su complemento, hay algunas cosas a las que debe prestar atención:
1. Unicidad de los nombres de funciones: Evite utilizar nombres genéricos para sus funciones, ya que pueden entrar en conflicto con otros complementos o temas. En su lugar, utilice prefijos para garantizar que sean únicos (por ejemplo, mi_complemento_mi_función()).
2. Orden y estructura: Organice su código agrupando funciones relacionadas en archivos o secciones separados de su archivo principal. Esto hace que su código sea más claro y fácil de mantener.
3. Comentarios: Comenta tu código, especialmente si es complejo o poco claro. Esto le ayudará a usted y a otros desarrolladores a comprender el código más adelante.
4. Utilice acciones y filtros: En lugar de cambiar directamente el código central de WordPress, utilice acciones y filtros para realizar cambios. Esto garantiza que su complemento siga siendo compatible con futuras actualizaciones de WordPress.
5. Comprobación de la existencia de funciones: Si su complemento depende de ciertas características que podrían agregarse o eliminarse en versiones posteriores de WordPress, verifique siempre si esa característica existe antes de llamarlo:
if (function_exists('die_funktion')) {
die_funktion();
}
6. Pruebas: Antes de lanzar su complemento, debe probarlo exhaustivamente, especialmente en combinación con otros complementos y temas populares, para asegurarse de que no haya conflictos o efectos secundarios no deseados.
Paso 4: Crea tu propia página de administración (opcional)
Otro caso de uso común de los complementos es crear su propia página de administración. He aquí un ejemplo sencillo de cómo puedes hacerlo:
function mein_plugin_admin_page() {
add_menu_page(
'Mein Plugin Einstellungen',
'Mein Plugin',
'manage_options',
'mein-plugin-admin',
'mein_plugin_admin_page_callback'
);
}
function mein_plugin_admin_page_callback() {
echo '<div class="wrap">';
echo '<h2>Mein Plugin Einstellungen</h2>';
// Hier kannst du den Inhalt deiner Administrationsseite einfügen.
echo '</div>';
}
add_action('admin_menu', 'mein_plugin_admin_page');
4.1. La función mi_página_de_administración_de_complementos() crear
Primero creamos una función llamada mi_página_de_administración_de_complementos(). Esta función se utiliza para agregar la página de administración de nuestro complemento. El añadir_página_de_menú()La función se utiliza para agregar un elemento de menú en la interfaz de administración de WordPress.
function mein_plugin_admin_page() {
add_menu_page(
'Mein Plugin Einstellungen', // Seitentitel in der Menüleiste
'Mein Plugin', // Anzeigename im Menü
'manage_options', // Benutzerrolle, die Zugriff hat (hier: Administratoren)
'mein-plugin-admin', // Eindeutiger Seiten-Slug
'mein_plugin_admin_page_callback' // Callback-Funktion zum Rendern der Seite
);
}
'Mi configuración de complementos' Es el título que se muestra en la barra de menú de administración de WordPress.
'Mi complemento' es el nombre para mostrar en el menú.
'administrar_opciones' Indica que sólo los usuarios con el rol “Administrador” tienen acceso a esta página.
'mi-complemento-admin' Es un slug único para su página de administración.
'devolución de llamada de la página de administración de mi complemento' es la función de devolución de llamada que se llama para crear el contenido de la página de administración.
4.2. La función de devolución de llamada devolución de llamada de la página de administración de mi complemento() crear:
La función de devolución de llamada devolución de llamada de la página de administración de mi complemento() se llama para crear el contenido de la página de administración. Aquí puedes agregar todas las configuraciones y opciones para tu complemento. Por ejemplo:
function mein_plugin_admin_page_callback() {
echo '<div class="wrap">';
echo '<h2>Mein Plugin Einstellungen</h2>';
// Hier kannst du den Inhalt deiner Administrationsseite hinzufügen.
echo '</div>';
}
'<div class="wrap">' Se utiliza para envolver el contenido de la página y aplicar el estilo estándar de WordPress.
'<h2>Mi configuración de complementos</h2>' Es el título de la página de administración. Puedes personalizar este título a tu gusto.
En la linea //Aquí puedes agregar el contenido de tu página de administración. Puede agregar formularios HTML personalizados, campos de entrada y opciones para controlar la configuración de su complemento.
4.3. Agregar la página de administración
Para agregar su página de administración, vaya a la mi_página_de_administración_de_complementos()función y adjuntarla a la acción menú de administración. Esto suele ocurrir en el archivo principal de su complemento.
add_action('admin_menu', 'mein_plugin_admin_page');
Esta línea asegura que la función mi_página_de_administración_de_complementos() Se llama cuando se crea el menú de administración de WordPress. Esto hará que su complemento sea visible en la interfaz de administración de WordPress.
4.4. Página de prueba
Ahora puedes activar tu complemento y probar la página de administración. Vaya a su panel de WordPress, haga clic en el elemento de menú “Mi complemento” (o en el nombre para mostrar que haya elegido) y será redirigido a la página de administración donde podrá agregar sus configuraciones y funciones.
La creación de su propia página de administración permite a los usuarios personalizar la configuración de su complemento y hace que la experiencia general del usuario sea más sencilla. Puede utilizar esta página para agregar opciones, configuraciones u otro contenido específico del complemento que desee que los usuarios administren.
Paso 5: Gestionar la activación y desactivación (opcional)
Su complemento también debe ofrecer la opción de activarse y desactivarse. Esto se hace agregando funciones de activación y desactivación en el archivo principal de su complemento:
register_activation_hook(__FILE__, 'mein_plugin_activate');
register_deactivation_hook(__FILE__, 'mein_plugin_deactivate');
function mein_plugin_activate() {
// Hier kannst du Initialisierungsaktionen durchführen, wenn das Plugin aktiviert wird.
}
function mein_plugin_deactivate() {
// Hier kannst du Bereinigungsaktionen durchführen, wenn das Plugin deaktiviert wird.
}
Paso 6: Instalar el complemento terminado
Una vez que hayas terminado de programar tu complemento y quieras integrarlo en tu instalación de WordPress, sigue estos pasos:
1. Compilar archivos de complemento
- Su complemento debe tener un archivo principal que contenga los metadatos del complemento, como el nombre del complemento, la versión, el autor, etc. Estos metadatos se mostrarán en el área de administración de WordPress.
- Organice todos los archivos y directorios que pertenecen a su complemento en una carpeta separada.
2. Crear archivo ZIP
- Empaque la carpeta con su complemento en un archivo ZIP. Esto hace que la carga e instalación en WordPress sea más fácil.
3. Instalar el complemento en WordPress
Instalación manual a través del panel de WordPress
3.1. En el área de administración de WordPress, vaya a “Complementos” > “Instalar”.
3.2. Haga clic en “Cargar complemento” y seleccione el archivo ZIP creado previamente.
3.3. Haga clic en “Instalar ahora”.
3.4. Después de una instalación exitosa, haga clic en “Activar complemento”.
Instalación manual mediante FTP
3.1. Descomprima el archivo ZIP en su computadora.
3.2. Utilice un cliente FTP (por ejemplo, FileZilla) para conectarse a su servidor web.
3.3. Navegar al directorio wp-content/complementos/ su instalación de WordPress.
3.4. Sube tu carpeta de complementos a este directorio.
3.5. En el área de administración de WordPress, vaya a “Complementos”, busque su complemento en la lista y haga clic en “Activar”.
4. Pruebas
- Después de activar el complemento, debes probar su funcionalidad en tu sitio web. Asegúrese de que todo funcione como se espera y que no haya conflictos con otros complementos o el tema.
5. Actualizaciones y mantenimiento
- Siempre que realice actualizaciones en su complemento, incremente el número de versión en el encabezado de metadatos del complemento.
- Una vez que tenga una nueva versión, puede volver a empaquetar el complemento y actualizarlo a través del panel de control. Algunos desarrolladores también utilizan sistemas de gestión de actualizaciones para proporcionar actualizaciones para sus complementos.
Paso 7: Publicar el complemento (opcional)
Si quieres que otros usuarios puedan usar tu plugin, puedes publicarlo en el [Repositorio de Plugins de WordPress](https://wordpress.org/plugins/). Para hacer esto, necesitará crear una cuenta SVN, enviar su complemento para revisión y seguir las pautas de desarrollo de complementos de WordPress.
No olvide realizar copias de seguridad de su sitio web periódicamente, especialmente antes de instalar nuevos complementos o actualizar, para evitar posibles pérdidas de datos.
Conclusión
Crear un complemento de WordPress puede parecer complejo al principio, pero con una estructura clara y esta guía paso a paso, puedes desarrollar fácilmente tus propios complementos. Recuerde que la seguridad y el rendimiento siempre deben ser su máxima prioridad al crear complementos.
ES 
DE 
EN 
FR 
PT