🌍
Brasil
This shows you the differences between two versions of the page.
conf_locale [2014/02/25 19:32] msakik [The Local Configuration (LocalFiles Editor)] |
conf_locale [2014/03/11 13:40] (current) msakik [O que é isso?] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Editor de configurações locais (LocalFiles Editor) ====== | ====== Editor de configurações locais (LocalFiles Editor) ====== | ||
- | ===== What's that? ===== | + | ===== O que é isso? ===== |
- | Piwigo has a graphical interface for the administration panel, where many options can be easily changed in only a few clicks. But Piwigo allows much more customization. In order to keep the essential options easily identifiable, all these additional options are not available in the graphical interface but in a file. | + | 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! |
- | The default config file, __which should be never modified__, is **include/config_default.inc.php** : it's an essential file, and you can open it to see what the available additional options are, but not to modify them! | + | |
- | ===== How to change it? ===== | + | 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. |
- | The best way is to use the plugin **LocalFiles Editor**, available as a default plugin in any Piwigo installation : | + | Maiores informações sobre o plugin podem ser obtidas na sua página web: http://piwigo.org/ext/extension_view.php?eid=144 |
- | * Go to **[ Administration >> Plugins >> Manage ]** and activate **LocalFiles Editor** : if you don't find it, click on the tab **[ Other Plugins available ]**, and install it | + | |
- | * Go to **[ Administration >> Plugins >> LocalFiles Editor ]** : the Local Config page is directly displayed, because that's the first of the five tabs of this plugin. | + | |
- | * There you can | + | |
- | * check the default config file, by clicking on **__Display reference file: "config_default.inc.php"__** : it contains almost all the variables you can change | + | |
- | * change these variables by typing inside the text field where you currently see something like "File does not exist and will be created by LocalFiles Editor" | + | |
- | \\ | + | |
- | The Local Config uses a PHP syntax:\\ | + | |
- | ''$conf['NAME OF THE VARIABLE'] = VALUE_OF_THE_VARIABLE;''\\ | + | |
- | For example\\ | + | |
- | ''$conf['top_number'] = 15;\\ | + | |
- | $conf['comment_spam_reject'] = true;\\ | + | |
- | $conf['newcat_default_status'] = 'public';'' | + | |
- | The workflow: | + | {{wiki:localfileseditor.png?700}} |
- | * find the variable you need or about which you want explanation by displaying and searching (Ctrl+F) inside the reference file, "config_default.inc.php". | + | |
- | * copy the reference variable or the one given on the forum/doc, like\\ | + | ===== Como usar o Editor de Configurações Locais? ===== |
- | ''%%//%% newcat_default_visible : at creation, must a category be visible or not ?\\ | + | |
- | %%//%% Warning : if the parent category is invisible, the category is\\ | + | 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. |
- | %%//%% automatically create invisible. (invisible = locked)\\ | + | |
- | $conf['newcat_default_visible'] = true;\\'' | + | 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. |
- | * paste it inside the text field, where you currently see something like "File does not exist and will be created by LocalFiles Editor" if you have never changed the local config | + | |
- | * change the value according to explanotory text (above each variable), like ''$conf['newcat_default_visible'] = false;'' | + | ===== Aba Configuração Local ===== |
- | * click Save File | + | |
- | * it should display\\ | + | 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 | ||
+ | |||
+ | |||
+ | === Passo a passo === | ||
+ | |||
+ | * 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: <code> | ||
+ | // 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; | ||
+ | </code> | ||
+ | |||
+ | * 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: <code>$conf['newcat_default_visible'] = false;</code> | ||
+ | * Clique em **Salvar Arquivo**. Ele deve mostrar: | ||
<WRAP center round 60%> | <WRAP center round 60%> | ||
- | File written successfully. | + | Arquivo gravado com sucesso. |
- | Backup file created (local/config/config.inc.bak.php) | + | Cópia de segurança criada (local/config/config.inc.bak.php) |
</WRAP> | </WRAP> | ||
- | You can revert your changes by restoring the backup file.\\ | + | Você pode desfazer as mudanças restaurando o arquivo de backup. |
+ | |||
+ | === Informações adicionais === | ||
+ | O plugin propriamente cuida das tags php: <?php no início e ?> no final.\\ | ||
+ | O arquivo salvo fica em **local/config/config.inc.php**. | ||
+ | |||
+ | |||
+ | ===== Aba CSS ===== | ||
+ | |||
+ | 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 [[css_code]]. | ||
+ | ===== Aba Template ===== | ||
+ | |||
+ | ===== Aba Idiomas ===== | ||
+ | |||
+ | ===== Aba Plugin Pessoal ===== | ||
- | ===== Additional info ===== | + | 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. |
- | The plugin itself handle the php tags: <?php at the beginning and ?> at the end.\\ | + | |
- | The file location is **local/config/config.inc.php**. | + | |
+ | <wrap important>Esse plugin deve ser ativado no gerenciador de plugins para que tenha efeito.</wrap> | ||
+ | Você pode ver alguns exemplos de plugins pessoais na página http://piwigo.org/doc/doku.php?id=dev:compilation_of_personal_plugins |