Ganchos Customizados

A Lista de arquivos simples inclui vários ganchos que você pode usar para estender sua funcionalidade e integração com seu tema ou outros plug-ins. Além de saber quando uma ação ocorreu, os ganchos personalizados do SFL também retornam um array contendo mensagens relacionadas ao processo de ação.

Ganchos de upload de arquivos

Esses ganchos serão acionados após um trabalho de upload de arquivo bem-sucedido. Há um para o front-end e outro para o back-end.

eeSFL_Hook_Uploaded
eeSFL_Admin_Hook_Uploaded

Como usar os ganchos

Para fazer seu tema fazer algo especial quando o SFL dispara ganchos, adicione algo assim ao seu tema infantil arquivo functions.php.

// add_action('The Hook Name', 'Your Function Name', Priority, Number of Arguments)
add_action('eeSFL_Hook_Uploaded', 'eeHookTestOutput', 10, 1);

Em seguida, escreva uma função para fazer o que quiser quando a ação ocorrer e o gancho for acionado.

// When the hook is fired, add_action() calls this function
// Writes output to /wp-content/debug.log
function eeHookTestOutput($eeMessages) {
     
     error_log('Hook Fired'); 

     foreach($eeMessages as $eeMessage) {
          
           error_log($eeMessage);
     }
}

Mais ganchos

SFL é a lista carregada

Esse gancho será acionado toda vez que a lista de arquivos for carregada. A matriz de mensagens conterá a URL da página da lista e quantos itens foram mostrados.

eeSFL_Hook_Loaded

SFL é o item listado

Este gancho será acionado sempre que um arquivo ou pasta (Pro) for listado. A matriz de mensagens conterá a matriz de arquivo, que contém todos os detalhes do item.

eeSFL_Hook_Listed

Novo item adicionado

Esse gancho será acionado toda vez que um novo item (um que foi adicionado de fora do plug-in) for encontrado durante o processo de nova verificação.

eeSFL_Hook_Added

Item não encontrado

Este gancho será acionado sempre que um item não for mais encontrado na lista e for removido de fora do plug-in.

eeSFL_Hook_Removed

O item foi editado

Este gancho será acionado toda vez que um item for editado. A matriz de mensagem fornecerá informações sobre o que aconteceu.

eeSFL_Hook_Edited

O item foi excluído

Esse gancho será acionado toda vez que um item for excluído. A matriz da mensagem fornecerá o nome do arquivo excluído.

eeSFL_Hook_Deleted

O item foi movido

Este gancho será acionado sempre que um item for movido. A matriz da mensagem fornecerá o caminho antes e depois.

eeSFL_Hook_Moved

A lista foi verificada

Esse gancho será acionado toda vez que o disco for verificado novamente. A matriz de mensagem fornecerá informações sobre o que aconteceu.

eeSFL_Hook_Scanned

Ganchos são legais! Se você precisar de um para algo em seu projeto, por favor me avise!

3 pensamentos sobre “Ganchos personalizados”

  1. Gostaria de rastrear o uso dos arquivos que estamos compartilhando em nosso site. Qualquer chance de você adicionar mais alguns ganchos, ou seja, arquivo aberto, arquivo baixado, link copiado. Para cada um deles, o caminho para o arquivo seria benéfico, semelhante a como é fornecido com o gancho eeSFL_Hook_Moved. Além disso, o caminho completo para o arquivo excluído pode ser fornecido como um elemento na matriz de mensagens no gancho eeSFL_Hook_Deleted? Parece que não está incluindo subpastas.

    Resposta
    • Isso só seria possível para listas restritas usando a extensão File Access Manager. Normalmente, essas ações são simplesmente links diretos para os arquivos, portanto, não há nada para disparar o gancho. As listas restritas passam por um firewall de arquivo onde ganchos podem ser úteis. Vou colocar isso na minha lista de tarefas.

      Resposta
      • Bom ponto. Acabei prendendo os cliques e passando via REST para logar em um banco de dados. Infelizmente, a rota da lista restrita não me ajudaria, pois neste caso estamos disponibilizando os documentos publicamente.

        Resposta

Deixe um comentário

Este site usa o Akismet para reduzir o spam. Saiba como seus dados de comentário são processados.