Español
Română
РусскийDisinstallare, Attivare, Disattivare un plugin: funzionalità tipiche e guida
Sto creando un plugin WordPress. Quali sono le operazioni tipiche che dovrei includere nella funzionalità di disinstallazione?
Ad esempio, dovrei eliminare le tabelle che ho creato nella funzione di installazione?
Devo pulire le mie voci nelle opzioni?
Qualcos'altro?
Questo è fantastico MA quello che voglio davvero sapere sono le cose che dovrei includere nel mio metodo di disattivazione... ad esempio, dovrei eliminare le mie tabelle nel database o lasciarle nel caso in cui l'utente cambi idea e riattivi il plugin?
redconservatory
Riguardo al "MA": ho menzionato che ci sono 3 metodi. Uno per l'attivazione, uno per la disattivazione temporanea e uno per la disinstallazione. Secondo me "uninstall" significa "Rimuovimi e tutto ciò che ho fatto", mentre "deactivate" è uno stato temporaneo e potrebbe essere annullato. Ma: vedi l'aggiornamento. Ho aggiunto commenti sulla tua domanda + l'ho estesa con alcuni consigli per lo sviluppo.
kaiser
Ah ora capisco. Solo una domanda, quando viene chiamato uninstall? Quando i file vengono eliminati??
redconservatory
Hmm. Bella domanda. plugin.php è il file che contiene register_uninstall_hook e viene caricato con i file iniziali in wp-settings.php (che è il file principale da sempre controllare). Aggiorno la domanda con i docblock del core.
kaiser
Ho anche aggiunto il controllo per la costante WP_UNINSTALL_PLUGIN, che sostanzialmente è il nome del file, così puoi tenere le tue funzioni di disinstallazione in un file separato ed evitare l'esecuzione di altre funzioni presenti nei file del tuo plugin.
kaiser
Per verificare i requisiti di sistema come la versione di PHP o le estensioni installate, puoi utilizzare qualcosa di simile:
<?php # -*- coding: utf-8 -*-
/**
* Plugin Name: T5 Verifica Requisiti Plugin
* Description: Verifica la versione PHP e le estensioni installate
* Plugin URI:
* Version: 2013.03.31
* Author: Fuxia Scholz
* Licence: MIT
* License URI: http://opensource.org/licenses/MIT
*/
/*
* Non eseguire su ogni pagina, basta la pagina dei plugin.
*/
if ( ! empty ( $GLOBALS['pagenow'] ) && 'plugins.php' === $GLOBALS['pagenow'] )
add_action( 'admin_notices', 't5_check_admin_notices', 0 );
/**
* Verifica i requisiti di sistema necessari per il plugin.
*
* @return array Errori o array vuoto
*/
function t5_check_plugin_requirements()
{
$php_min_version = '5.4';
// vedi 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[] = "Il tuo server sta eseguendo PHP versione $php_current_version ma
questo plugin richiede almeno PHP $php_min_version. Esegui un aggiornamento.";
foreach ( $extensions as $extension )
if ( ! extension_loaded( $extension ) )
$errors[] = "Installa l'estensione $extension per eseguire questo plugin.";
return $errors;
}
/**
* Chiama t5_check_plugin_requirements() e disattiva questo plugin se ci sono errori.
*
* @wp-hook admin_notices
* @return void
*/
function t5_check_admin_notices()
{
$errors = t5_check_plugin_requirements();
if ( empty ( $errors ) )
return;
// Sopprime il messaggio "Plugin attivato".
unset( $_GET['activate'] );
// nome di questo plugin
$name = get_file_data( __FILE__, array ( 'Plugin Name' ), 'plugin' );
printf(
'<div class="error"><p>%1$s</p>
<p><i>%2$s</i> è stato disattivato.</p></div>',
join( '</p><p>', $errors ),
$name[0]
);
deactivate_plugins( plugin_basename( __FILE__ ) );
}
Test con una verifica per PHP 5.5:
Sono un po' confuso, quindi fondamentalmente qui non c'è una chiamata a register_activation_hook -- perché non usarla? Inoltre, questo verrà eseguito prima o dopo register_activation_hook e register_activation_hook verrà eseguito comunque anche se il codice sopra non passa?
orionrush
Viene eseguito dopo l'hook di attivazione solo nella pagina del plugin.
fuxia
Capisco - ma se il plugin viene attivato al di fuori della pagina del plugin (ad esempio come parte delle dipendenze di un tema) allora i tuoi controlli verranno saltati, giusto? Quindi ho provato a spostare add_action( 'admin_notices', 't5_check_admin_notices', 0 ); in un hook di attivazione e il plugin si attiva senza eseguire i controlli...
orionrush
@kaiser ha spiegato come funziona l'hook di attivazione, volevo mostrare un'alternativa. Se il plugin non viene attivato tramite la pagina dei plugin, potrebbe verificarsi un errore fatale, sì. Questo approccio non può funzionare su un hook di attivazione senza una seria riscrittura, perché quell'hook viene attivato dopo admin_notices.
fuxia
In realtà mi sono appena imbattuto nel modo semplice: http://stackoverflow.com/a/13927297/362445
orionrush