Como fazer um plugin requer outro plugin?

23

Estou criando um plug-in que adiciona funcionalidades extras a um plug-in principal. Idealmente na tela de administração de plugins, o link "activate" deve ser desabilitado e uma nota inline deve ser adicionada, informando ao usuário para instalar e ativar o plug-in principal antes que ele possa usar o plugin atual.

    
por kosinix 28.12.2013 / 10:15
fonte

4 respostas

31

Obrigado pelas respostas caras. Embora ambas as respostas me colocaram no caminho certo, nenhuma funcionou de imediato. Então, estou compartilhando minhas soluções abaixo.

Método 1 - Usando register_activation_hook:

Crie o plug-in pai em plugins / parent-plugin / parent-plugin.php:

<?php
/*
Plugin Name: Parent Plugin
Description: Demo plugin with a dependent child plugin.
Version: 1.0.0
*/

Crie o plug-in filho em plugins / child-plugin / child-plugin.php:

<?php
/*
Plugin Name: Child Plugin
Description: Parent Plugin should be installed and active to use this plugin.
Version: 1.0.0
*/
register_activation_hook( __FILE__, 'child_plugin_activate' );
function child_plugin_activate(){

    // Require parent plugin
    if ( ! is_plugin_active( 'parent-plugin/parent-plugin.php' ) and current_user_can( 'activate_plugins' ) ) {
        // Stop activation redirect and show error
        wp_die('Sorry, but this plugin requires the Parent Plugin to be installed and active. <br><a href="' . admin_url( 'plugins.php' ) . '">&laquo; Return to Plugins</a>');
    }
}

Observe que não estou usando deactivate_plugins( $plugin ); porque, por algum motivo, isso não funciona. Então usei o wp_die para cancelar o redirecionamento de ativação e informar o usuário.

Vantagem:

  • Solução simples e não incorre em hits de db adicionais em comparação com o método 2

Desvantagens:

  • a tela do wp_die é feia
  • A tela wp_die AINDA aparecerá se você ativar o plug-in pai e o plug-in filho ao mesmo tempo usando as caixas de seleção na tela de administração de plug-ins.

Método 2 - Usando admin_init e admin_notices

Crie o plug-in pai em plugins / parent-plugin / parent-plugin.php:

<?php
/*
Plugin Name: Parent Plugin
Description: Demo plugin with a dependent child plugin.
Version: 1.0.0
*/

Crie o plug-in filho em plugins / child-plugin / child-plugin.php:

<?php
/*
Plugin Name: Child Plugin
Description: Parent Plugin should be installed and active to use this plugin.
Version: 1.0.0
*/
add_action( 'admin_init', 'child_plugin_has_parent_plugin' );
function child_plugin_has_parent_plugin() {
    if ( is_admin() && current_user_can( 'activate_plugins' ) &&  !is_plugin_active( 'parent-plugin/parent-plugin.php' ) ) {
        add_action( 'admin_notices', 'child_plugin_notice' );

        deactivate_plugins( plugin_basename( __FILE__ ) ); 

        if ( isset( $_GET['activate'] ) ) {
            unset( $_GET['activate'] );
        }
    }
}

function child_plugin_notice(){
    ?><div class="error"><p>Sorry, but Child Plugin requires the Parent plugin to be installed and active.</p></div><?php
}

Vantagem:

  • Funciona quando você ativa o plug-in pai-filho ao mesmo tempo usando as caixas de seleção

Desvantagem:

  • Incorra em ocorrências adicionais de db, pois o plug-in é realmente ativado inicialmente e desativado assim que o admin_init for executado.

Quanto à minha pergunta sobre a desativação do link de ativação, eu poderia usar:

add_filter( 'plugin_action_links', 'disable_child_link', 10, 2 );
function disable_child_link( $links, $file ) {

    if ( 'child-plugin/child-plugin.php' == $file and isset($links['activate']) )
        $links['activate'] = '<span>Activate</span>';

    return $links;
}

No entanto, acabou por ser altamente impraticável, pois não há lugar para colocar este código. Não consegui colocá-lo no plug-in pai, pois o plug-in pai deve estar ativo para que esse código seja executado. Certamente não pertence ao plugin filho ou functions.php. Então, estou descartando essa ideia.

    
por kosinix 28.01.2014 / 07:43
fonte
2

Tente isso, ele é comentado, então isso deve ajudá-lo a entender.

<?php
register_activation_hook( __FILE__, 'myplugin_activate' ); // Register myplugin_activate on
function myplugin_activate() {
    $plugin = plugin_basename( __FILE__ ); // 'myplugin'
    if ( is_plugin_active( 'plugin-directory/first-plugin.php' ) ) {
        // Plugin was active, do hook for 'myplugin'
    } else {
        // Plugin was not-active, uh oh, do not allow this plugin to activate
        deactivate_plugins( $plugin ); // Deactivate 'myplugin'
    }
}
?> 

Se isso gerar um erro, você também pode verificar a 'opção' de 'myplugin' e configurá-la como falsa ou não ativada.

    
por MrJustin 28.12.2013 / 10:48
fonte
2

Ambas as soluções sugeridas têm falhas.

Método 1: Como mencionado, a tela wp_die () AINDA aparecerá quando o Plugin Pai e o Plugin Filho forem ativados ao mesmo tempo usando as caixas de seleção na tela de administração dos plug-ins.

Método 2: Em alguns casos de uso, não é bom, já que 'admin_init' é executado após 'plugins_loaded' ( enlace ), e depois do gancho de desinstalação ( enlace ). Por exemplo, se quisermos que o complemento execute algum código na desinstalação, independentemente de o plug-in pai estar ativo ou não, essa abordagem NÃO funcionará.

Solução:

Primeiro de tudo, precisamos acrescentar o seguinte código ao final do arquivo PHP principal do plugin pai:

do_action( 'my_plugin_loaded' );

Isso despacha um evento / sinal para todos os assinantes, informando que o plugin principal foi carregado.

Em seguida, a classe do complemento deve se parecer com o seguinte:

class My_Addon
{
    static function init ()
    {
        register_activation_hook( __FILE__, array( __CLASS__, '_install' ) );

        if ( ! self::_is_parent_active_and_loaded() ) {
            return;
        }
    }

    #region Parent Plugin Check

    /**
     * Check if parent plugin is activated (not necessarly loaded).
     *
     * @author Vova Feldman (@svovaf)
     *
     * @return bool
     */
    static function _is_parent_activated()
    {
        $active_plugins_basenames = get_option( 'active_plugins' );
        foreach ( $active_plugins_basenames as $plugin_basename ) {
            if ( false !== strpos( $plugin_basename, '/my-plugin-main-file.php' ) ) {
                return true;
            }
        }

        return false;
    }

    /**
     * Check if parent plugin is active and loaded.
     *
     * @author Vova Feldman (@svovaf)
     *
     * @return bool
     */
    static function _is_parent_active_and_loaded()
    {
        return class_exists( 'My_Plugin' );
    }

    /**
     *
     * @author Vova Feldman (@svovaf)
     */
    static function _install()
    {
        if ( ! self::_is_parent_active_and_loaded() ) {
            deactivate_plugins( basename( __FILE__ ) );

            // Message error + allow back link.
            wp_die( __( 'My Add-on requires My Plugin to be installed and activated.' ), __( 'Error' ), array( 'back_link' => true ) );
        }
    }

    #endregion Parent Plugin Check
}

if (My_Addon::_is_parent_active_and_loaded())
{
    // If parent plugin already included, init add-on.
    My_Addon::init();
}
else if (My_Addon::_is_parent_activated())
{
    // Init add-on only after the parent plugins is loaded.
    add_action( 'my_plugin_loaded', array( __CLASS__, 'init' ) );
}
else
{
    // Even though the parent plugin is not activated, execute add-on for activation / uninstall hooks.
    My_Addon::init();
}

Espero que ajude:)

    
por vovafeldman 26.03.2016 / 20:58
fonte
0

Acho que você precisa de ativação de plug-in do TGM .

  

Ativação de Plugin do TGM é uma biblioteca PHP que permite que você facilmente   Exigir ou recomendar plugins para os seus temas WordPress (e plugins).   Permite que seus usuários instalem, atualizem e até mesmo automaticamente   ativar plugins no singular ou em massa usando o WordPress nativo   classes, funções e interfaces. Você pode referenciar plugins integrados,   plugins do Repositório de Plugins do WordPress ou mesmo plugins hospedados   em outro lugar na internet.

    
por Amir Hossein Hossein Zadeh 08.10.2018 / 18:53
fonte