Italiano
Română
РусскийDesinstalar, Activar, Desactivar un plugin: características típicas y cómo hacerlo
Estoy creando un plugin para WordPress. ¿Cuáles son las cosas típicas que debería incluir en la función de desinstalación?
Por ejemplo, ¿debería eliminar las tablas que creé en la función de instalación?
¿Debo limpiar mis entradas de opciones?
¿Algo más?
Esto es genial, PERO lo que realmente quiero saber son las cosas que debería incluir en mi método de desactivación... por ejemplo, ¿debería eliminar mis tablas en la base de datos o dejarlas por si el usuario cambia de opinión y reactiva el plugin?
redconservatory
Sobre el "PERO": Mencioné que hay 3 métodos. Uno para activación, uno para desactivación temporal y otro para desinstalación. En mi opinión, "uninstall" significa "Elimíname y todo lo que hice", mientras que "deactivate" es un estado temporal y podría revertirse. Pero: Mira la actualización. Añadí comentarios sobre tu pregunta + la amplié con algunas recomendaciones de desarrollo.
kaiser
Ah, ahora lo entiendo. Solo una pregunta, ¿cuándo se llama a uninstalled? ¿Cuando se eliminan los archivos?
redconservatory
Hmm. Buena pregunta. plugin.php es el archivo que contiene register_uninstall_hook y se carga con los archivos iniciales en wp-settings.php (que es el archivo principal que siempre debes revisar). Actualicé la pregunta con los docblocks del núcleo.
kaiser
También agregué la verificación de la constante WP_UNINSTALL_PLUGIN, que básicamente es el nombre del archivo, para que puedas colocar tus funciones de desinstalación en un archivo separado y evitar la ejecución de otras funciones que están en los archivos de tus plugins.
kaiser
Para probar el sistema actual en busca de características requeridas como la versión de PHP o extensiones instaladas, puedes usar algo como esto:
<?php # -*- coding: utf-8 -*-
/**
* Plugin Name: T5 Verificar Requisitos del Plugin
* Description: Prueba para versión de PHP y extensiones instaladas
* Plugin URI:
* Version: 2013.03.31
* Author: Fuxia Scholz
* Licence: MIT
* License URI: http://opensource.org/licenses/MIT
*/
/*
* No iniciar en cada página, la página de plugins es suficiente.
*/
if ( ! empty ( $GLOBALS['pagenow'] ) && 'plugins.php' === $GLOBALS['pagenow'] )
add_action( 'admin_notices', 't5_check_admin_notices', 0 );
/**
* Prueba el sistema actual para las características que el plugin necesita.
*
* @return array Errores o array vacío
*/
function t5_check_plugin_requirements()
{
$php_min_version = '5.4';
// ver http://www.php.net/manual/en/extensions.alphabetical.php
$extensions = array (
'iconv',
'mbstring',
'id3'
);
$errors = array ();
$php_current_version = phpversion();
if ( version_compare( $php_min_version, $php_current_version, '>' ) )
$errors[] = "Tu servidor está ejecutando PHP versión $php_current_version pero
este plugin requiere al menos PHP $php_min_version. Por favor realiza una actualización.";
foreach ( $extensions as $extension )
if ( ! extension_loaded( $extension ) )
$errors[] = "Por favor instala la extensión $extension para ejecutar este plugin.";
return $errors;
}
/**
* Llama a t5_check_plugin_requirements() y desactiva este plugin si hay errores.
*
* @wp-hook admin_notices
* @return void
*/
function t5_check_admin_notices()
{
$errors = t5_check_plugin_requirements();
if ( empty ( $errors ) )
return;
// Suprimir el aviso "Plugin activado".
unset( $_GET['activate'] );
// nombre de este plugin
$name = get_file_data( __FILE__, array ( 'Plugin Name' ), 'plugin' );
printf(
'<div class="error"><p>%1$s</p>
<p><i>%2$s</i> ha sido desactivado.</p></div>',
join( '</p><p>', $errors ),
$name[0]
);
deactivate_plugins( plugin_basename( __FILE__ ) );
}
Prueba con una verificación para PHP 5.5:
Un poco confundido, básicamente aquí no hay una llamada a register_activation_hook -- ¿por qué no usarlo? También, ¿esto se ejecutará antes o después de register_activation_hook y register_activation_hook se ejecutará incluso si lo anterior no pasa?
orionrush
Se ejecuta después del hook de activación solo en la página del plugin.
fuxia
Entiendo - pero si el plugin se activa fuera de la página del plugin (digamos como parte de una dependencia del tema) entonces tus verificaciones se saltarán, ¿no? Así que intenté mover add_action( 'admin_notices', 't5_check_admin_notices', 0 ); a un hook de activación y el plugin se activa sin realizar las verificaciones...
orionrush
@kaiser ha explicado cómo funciona el gancho de activación, yo quería mostrar una alternativa. Si el plugin no se activa desde la página de plugins, podría ocurrir un error fatal, sí. Este enfoque no puede funcionar en un gancho de activación sin una reescritura seria, porque ese gancho se dispara después de admin_notices.
fuxia
De hecho, acabo de encontrarme con la forma fácil: http://stackoverflow.com/a/13927297/362445
orionrush