Editor de configurações locais (LocalFiles Editor)

O Piwigo possui um painel de administração gráfico onde muitas opções podem ser modificas em poucos cliques. O Piwigo, porém, permite muito mais customização. Com o intuito de manter as opções essenciais facilmente identificáveis, todas as demais opções estão disponíveis separadamente por meio de arquivos de configuração do sistema. Os arquivos de sistema NUNCA devem ser modificados. Eles podem e devem ser consultados para saber o que são as opções adicionais e seus valores padrão, mas nunca modificados!

O LocalFiles Editor é um plugin, que vem pré instalado no Piwigo, e que permite alterar as suas opções avançadas por meio da edição de arquivos de configuração. Os arquivos editados por meio do LocalFiles Editor ficam em uma pasta separada permitindo que as alterações sejam preservadas mesmo em uma atualização do Piwigo.

Maiores informações sobre o plugin podem ser obtidas na sua página web: http://piwigo.org/ext/extension_view.php?eid=144

O LocalFiles Editor é um plugin que vem pré instalado no Piwigo porém é necessário ativá-lo. Para tanto clique em [Administração » Plugins » Gerenciar] e ative o LocalFiles Editor. Se ele não estivér na lista, clique na aba [Outros plugins] e instale ele.

Uma vez instalado, você pode acessá-lo em [Administração » Plugins » LocalFiles Editor]. A aba [Configuração local] é exibida por padrão pois é a primeira das cinco abas disponíveis.

Nessa aba você pode:

• verificar o arquivo de configuração padrão, clicando em Mostre o arquivo de referência: “config_default.inc.php”. Ele contém praticamente todas as variáveis que você pode alterar.
• alterar as variáveis digitando na caixa de texto onde está escrito algo do tipo “O arquivo não existe e será criado pelo Editor Local de Arquivos”.

Esse arquivo utiliza a sintaxe do PHP onde:

$conf['NOME_DA_VARIAVEL'] = VALOR_DA_VARIAVEL;

Seguem alguns exemplos:

$conf['top_number'] = 15;
$conf['comment_spam_reject'] = true;
$conf['newcat_default_status'] = 'public';
// este é um comentário que não faz nada pois começa com barra dupla

• Encontre a variável que você precisa modificar ou que você quer alguma explicação no arquivo de referência “config_default.inc.php”. Você pode usar a busca clicando <ctrl+F> na janela apropriada.

• Copie a variável do arquivo de referência ou a partir do fórum ou da documentação onde você encontrou a variável. Por exemplo:

    // newcat_default_visible: at creation, must a category be visible or not ?
    // Warning: if the parent category is invisible, the category is
    // automatically create invisible. (invisible = locked)
    $conf['newcat_default_visible'] = true;

• Cole dentro da caixa de texto apropriada.
• Ajuste os valores das variáveis conforme necessário e de acordo com o texto explicativo quando houver. No exemplo acima podemos modificar da seguinte forma:

  $conf['newcat_default_visible'] = false;

• Clique em Salvar Arquivo. Ele deve mostrar:

  Arquivo gravado com sucesso.
  Cópia de segurança criada (local/config/config.inc.bak.php)

Você pode desfazer as mudanças restaurando o arquivo de backup.

O plugin propriamente cuida das tags php: <?php no início e ?> no final.
O arquivo salvo fica em local/config/config.inc.php.

A aba CSS permite modificar a aparência do Piwigo por meio de código CSS. Um tutorial completo sobre CSS pode ser visto em Como personalizar cores, fontes e mais (codificação CSS).

A aba Plugin Pessoal é um recurso bastante sofisticado do Piwigo que permite ao administrador escrever seus próprios plugins em tempo real adicionando seu código diretamente na caixa de texto dessa aba. Deve ser usado com bastante cuidado pois pode facilmente apresentar efeitos indesejados.

Esse plugin deve ser ativado no gerenciador de plugins para que tenha efeito.

Você pode ver alguns exemplos de plugins pessoais na página http://piwigo.org/doc/doku.php?id=dev:compilation_of_personal_plugins