From 531699a1a628710cb71a93b7ebee76d31de59543 Mon Sep 17 00:00:00 2001 From: mateuswetah Date: Wed, 26 May 2021 11:32:55 -0300 Subject: [PATCH] Updates links from mailing list to dicourse forum --- _navbar.md | 10 +- _sidebar.md | 2 +- dev/creating-metadata-type.md | 17 ++- dev/extra-view-modes.md | 2 +- faq.md | 8 +- plugins.md | 2 +- pt-br/_navbar.md | 10 +- pt-br/_sidebar.md | 2 +- pt-br/faq.md | 10 +- pt-br/optimization.md | 90 ++++++++-------- pt-br/release-testing.md | 4 +- pt-br/testing-capabilities.md | 171 +++++++++++++++++------------- pt-br/testing-collections.md | 26 +++-- pt-br/testing-exporters.md | 3 +- pt-br/testing-filters.md | 20 ++-- pt-br/testing-gutenberg-blocks.md | 4 +- pt-br/testing-importers.md | 14 +-- pt-br/testing-item-submission.md | 2 +- pt-br/testing-items.md | 41 +++---- pt-br/testing-metadata.md | 28 ++--- pt-br/testing-search.md | 16 +-- pt-br/testing-taxonomies.md | 2 +- release-testing.md | 112 +++++++++---------- 23 files changed, 319 insertions(+), 277 deletions(-) diff --git a/_navbar.md b/_navbar.md index 863cfc18..b4b52068 100644 --- a/_navbar.md +++ b/_navbar.md @@ -1,5 +1,5 @@ -* [Oficial website](https://tainacan.org ':ignore') - -* Language - * [English](/#tainacan-wiki) - * [Brazilian Portuguese](/pt-br/#wiki-do-tainacan) \ No newline at end of file +- [Oficial website](https://tainacan.org ":ignore") +- [Community forum](https://tainacan.discourse.group ":ignore") +- Language + - [English](/#tainacan-wiki) + - [Brazilian Portuguese](/pt-br/#wiki-do-tainacan) diff --git a/_sidebar.md b/_sidebar.md index 6b1cda69..0ef93460 100644 --- a/_sidebar.md +++ b/_sidebar.md @@ -40,7 +40,7 @@ - [:link:Publications](https://pesquisa.tainacan.org/ ":ignore") - [Presentations](/presentations "Slideshow presentations related to Tainacan - Tainacan Wiki") - Community & Misc - - [:link:Community list](https://lists.riseup.net/www/subscribe/tainacan ":ignore") + - [:link:Community forum](https://tainacan.discourse.group ":ignore") - [Improve this wiki](CONTRIBUTING "How to contribute to the Tainacan Wiki - Tainacan Wiki") - [Release Testing](/release-testing.md "How to test Tainacan versions - Tainacan Wiki") - [Data and Archive Processing](data-processing "A word on Data and Archive Processing - Tainacan Wiki") diff --git a/dev/creating-metadata-type.md b/dev/creating-metadata-type.md index 011ddfc6..0f075d66 100644 --- a/dev/creating-metadata-type.md +++ b/dev/creating-metadata-type.md @@ -234,9 +234,8 @@ const TainacanMetadataTypeCustom = { `, }; -window.tainacan_extra_components[ - "tainacan-metadata-type-custom" -] = TainacanMetadataTypeCustom; +window.tainacan_extra_components["tainacan-metadata-type-custom"] = + TainacanMetadataTypeCustom; ``` The first and last lines are an important step for registering custom components to the plugin JS bundle. @@ -371,9 +370,8 @@ const TainacanMetadataFormCustomType = { `, }; -window.tainacan_extra_components[ - "tainacan-metadata-form-type-custom" -] = TainacanMetadataFormCustomType; +window.tainacan_extra_components["tainacan-metadata-form-type-custom"] = + TainacanMetadataFormCustomType; ``` Some observation here: @@ -533,9 +531,8 @@ window.tainacan_extra_components = typeof window.tainacan_extra_components != "undefined" ? window.tainacan_extra_components : {}; -window.tainacan_extra_components[ - "tainacan-metadata-type-custom" -] = TainacanMetadataTypeCustom; +window.tainacan_extra_components["tainacan-metadata-type-custom"] = + TainacanMetadataTypeCustom; ``` ### Build it! @@ -551,6 +548,6 @@ If everything goes well, you shall have a new folder `node_modules` and a new fi ## Wrapping up -Creating your custom Metadata Type for Tainacan requires following some _naming conventions_ and understanding a bit of the structure existing on the plugin code. We here summarized how to [Register](#registering-your-metadata-type), create the [Class](#creating-the-php-class) and the [Custom Vue Components](#creating-vue-web-component) related to it. But you can learn a lot more by studying the [source code of some more complex examples](https://github.com/tainacan/tainacan/tree/develop/src/views/admin/components/metadata-types ":ignore"). Feel free to reach us at the GitHub repo or at the [community mailing list](https://lists.riseup.net/www/subscribe/tainacan ":ignore") :wink: +Creating your custom Metadata Type for Tainacan requires following some _naming conventions_ and understanding a bit of the structure existing on the plugin code. We here summarized how to [Register](#registering-your-metadata-type), create the [Class](#creating-the-php-class) and the [Custom Vue Components](#creating-vue-web-component) related to it. But you can learn a lot more by studying the [source code of some more complex examples](https://github.com/tainacan/tainacan/tree/develop/src/views/admin/components/metadata-types ":ignore"). Feel free to reach us at the GitHub repo or at the [community forum](https://tainacan.discourse.group ":ignore") :wink: > Oh, and BTW. Are you ready to also create a [Custom Filter Type](/dev/creating-filters-type) for your new Metadata Type? diff --git a/dev/extra-view-modes.md b/dev/extra-view-modes.md index cb895fcc..906aacba 100644 --- a/dev/extra-view-modes.md +++ b/dev/extra-view-modes.md @@ -530,4 +530,4 @@ In our sample repository, we also have a `build.sh` script, that takes care of c ## Conclusion -There are lots of things that you can do to improve your items list visualization. Hopefully our [sample files](https://github.com/tainacan/tainacan-extra-view-mode-samples ":ignore") and our [demo plugin](https://wordpress.org/plugins/tainacan-extra-view-modes/ ":ignore") will set you up for creating your own. Feel free to reach us in the [Tainacan email list](https://lists.riseup.net/www/info/tainacan ":ignore") to discuss any issues! +There are lots of things that you can do to improve your items list visualization. Hopefully our [sample files](https://github.com/tainacan/tainacan-extra-view-mode-samples ":ignore") and our [demo plugin](https://wordpress.org/plugins/tainacan-extra-view-modes/ ":ignore") will set you up for creating your own. Feel free to reach us in the [Tainacan Discourse Forum](https://tainacan.discourse.group ":ignore") to discuss any issues! diff --git a/faq.md b/faq.md index 5ff276b7..dcfd0bd5 100644 --- a/faq.md +++ b/faq.md @@ -2,7 +2,7 @@ We list and answer the most frequently asked questions by our community: -> To participate in the Tainacan community [register here](https://lists.riseup.net/www/subscribe/tainacan ":ignore")! +> To participate in the Tainacan community [register here](https://tainacan.discourse.group ":ignore")! Skip to an specific section: @@ -25,7 +25,7 @@ Tainacan as free software is developed from results of scientific research and e We are a network of researchers and developers that unites scientific knowledge and the implementation of technological solutions in cultural institutions. -Currently our network gathers researchers from the University of Brasilia (UnB), Federal University of Goiás (UFG) and Brazilian Institute of Information in Science and Technology (IBICT) and also our developers and users from our Tainacan community [(register here)](https://lists.riseup.net/www/subscribe/tainacan). +Currently, our network gathers researchers from the University of Brasilia (UnB), Federal University of Goiás (UFG) and Brazilian Institute of Information in Science and Technology (IBICT) and also our developers and users from our Tainacan community [(register here)](https://tainacan.discourse.group). ### Why is Tainacan free software? @@ -37,7 +37,7 @@ Its main goal is to help cultural institutions to organize, publish and spread t ### I think I found an error. How should I proceed? -We are always available at [Tainacan's mailing list](https://lists.riseup.net/www/subscribe/tainacan ":ignore"), where conversations can be started and at [the project's github](https://github.com/tainacan/tainacan ":ignore"), where more technical _issues_ can be reported. If you start a conversation on the list, we recommend that you always give as much detail as possible so that you can help identify what is happening. Some suggestions are: +We are always available at [Tainacan's forum](https://tainacan.discourse.group ":ignore"), where conversations can be started and at [the project's github](https://github.com/tainacan/tainacan ":ignore"), where more technical _issues_ can be reported. If you start a conversation on the list, we recommend that you always give as much detail as possible so that you can help identify what is happening. Some suggestions are: - Describe step by step what is being done, what occurs and what was expected; - Check and if possible send us the information from [System Diagnosis Page](/optimization#system-check); @@ -127,4 +127,4 @@ By default, your website homepage will be the list of posts to your blog. To set As your site administrator, you can register new users with different [roles and permissions](/users-roles) to edit your collection. If, however, you want items to be submited without new users being registered in the system, you can create a public [Item Submission Form](/item-submission), to receive direct external contributions in your repository. -> To join the Tainacan community [sign up here](https://lists.riseup.net/www/subscribe/tainacan)! +> To join the Tainacan community [sign up here](https://tainacan.discourse.group)! diff --git a/plugins.md b/plugins.md index b5603aef..22ea6de2 100644 --- a/plugins.md +++ b/plugins.md @@ -11,7 +11,7 @@ So far the ones below are the plugins available for Tainacan: - [Extra View Modes](/plugin-extra-view-modes) - Adds many demonstration templates of Extra View Modes, ideal for developers who want to learn how to create their own; - [WordPress 3DHOP](/plugin-3d-hop) - Allows WordPress to render interactive 3D models using [3D HOP](http://3dhop.net/); -If you are a developer and would like to extend Tainacan with some solution, we invite you to check our [developers session for that](/dev/#plugin-development-or-extension) and also to dive into their source code as it can be a good learning resource 🤓 . Also, in case you have created a plugin and want to have it listed here, please talk to us in [our mailing list](https://lists.riseup.net/www/subscribe/tainacan)! +If you are a developer and would like to extend Tainacan with some solution, we invite you to check our [developers session for that](/dev/#plugin-development-or-extension) and also to dive into their source code as it can be a good learning resource 🤓 . Also, in case you have created a plugin and want to have it listed here, please talk to us in [our forum](https://tainacan.discourse.group)! ## Installing a Plugin diff --git a/pt-br/_navbar.md b/pt-br/_navbar.md index 863cfc18..70ef24a7 100644 --- a/pt-br/_navbar.md +++ b/pt-br/_navbar.md @@ -1,5 +1,5 @@ -* [Oficial website](https://tainacan.org ':ignore') - -* Language - * [English](/#tainacan-wiki) - * [Brazilian Portuguese](/pt-br/#wiki-do-tainacan) \ No newline at end of file +- [Site oficial](https://tainacan.org ":ignore") +- [Fórum da comunidade](https://tainacan.discourse.group ":ignore") +- Idiomas + - [Inglês](/#tainacan-wiki) + - [Português Brasileiro](/pt-br/#wiki-do-tainacan) diff --git a/pt-br/_sidebar.md b/pt-br/_sidebar.md index 5c42ab1b..c1cbdc7f 100644 --- a/pt-br/_sidebar.md +++ b/pt-br/_sidebar.md @@ -40,7 +40,7 @@ - [:link:Publicações](https://pesquisa.tainacan.org// ":ignore") - [Apresentações](/pt-br/presentations "Apresentações relacionadas ao Tainacan - Tainacan Wiki") - Comunidade & Outros - - [:link:Lista da Comunidade](https://lists.riseup.net/www/subscribe/tainacan ":ignore") + - [:link:Fórum da Comunidade](https://tainacan.discourse.group ":ignore") - [Colabore com esta Wiki](/pt-br/CONTRIBUTING "Como contribuir com a Wiki do Tainacan - Tainacan Wiki") - [Teste de Versões](/pt-br/release-testing.md "Como realizar testes de versões do Tainacan - Tainacan Wiki") - [Coleções](/pt-br/testing-collections.md) diff --git a/pt-br/faq.md b/pt-br/faq.md index ae701c45..4bc81710 100644 --- a/pt-br/faq.md +++ b/pt-br/faq.md @@ -2,7 +2,7 @@ Listamos e respondemos as perguntas mais frequentes feitas pela nossa comunidade: -> Para participar da comunidade do Tainacan [inscreva-se aqui](https://lists.riseup.net/www/subscribe/tainacan)! +> Para participar da comunidade do Tainacan [inscreva-se aqui](https://tainacan.discourse.group)! Pule pra alguma sessão específica: @@ -25,7 +25,7 @@ O software livre Tainacan é desenvolvido a partir de resultados de pesquisas ci Somos uma rede de pesquisadores e desenvolvedores que une o conhecimento científico e a implementação de soluções tecnológicas em instituições culturais. -Atualmente nossa rede reúne pesquisadores da Universidade de Brasília (UnB), Universidade Federal de Goiás (UFG) e Instituto Brasileiro de Informação em Ciência e Tecnologia (IBICT) e também nossa desenvolvedores e usuários da nossa comunidade do Tainacan [(inscreva-se aqui)](https://lists.riseup.net/www/subscribe/tainacan). +Atualmente nossa rede reúne pesquisadores da Universidade de Brasília (UnB), Universidade Federal de Goiás (UFG) e Instituto Brasileiro de Informação em Ciência e Tecnologia (IBICT) e também nossa desenvolvedores e usuários da nossa comunidade do Tainacan [(inscreva-se aqui)](https://tainacan.discourse.group). ### Por que o Tainacan é um software livre? @@ -37,7 +37,7 @@ Seu objetivo principal é ajudar instituições culturais a organizarem, publica ### Acho que encontrei um erro. Como devo proceder? -Estamos sempre a disposição na [lista de emails do Tainacan](https://lists.riseup.net/www/subscribe/tainacan), onde podem ser iniciadas conversas e no [github do projeto](https://github.com/tainacan/tainacan), onde podem ser reportadas _issues_ mais técnicas. Caso você comece uma conversa na lista, recomendamos dar sempre o máximo de detalhes para que possa ajudar a identificar o que está ocorrendo. Algumas sugestões, são: +Estamos sempre a disposição no [fórum de discussão do Tainacan](https://tainacan.discourse.group), onde podem ser iniciadas conversas e no [github do projeto](https://github.com/tainacan/tainacan), onde podem ser reportadas _issues_ mais técnicas. Caso você comece uma conversa na lista, recomendamos dar sempre o máximo de detalhes para que possa ajudar a identificar o que está ocorrendo. Algumas sugestões, são: - Descrever passo a passo o que está sendo feito, o que ocorre e o que era esperado; - Verificar e se possível nos mandar as informações da [Página de Diagnóstico do Sistema](/pt-br/optimization?id=diagnóstico-do-sistema); @@ -81,7 +81,7 @@ Em geral, erros de processos como importadores e exportadores são gravados em u ### Sinto que minha instalação está demorando muito para carregar os itens... tem como melhorar? -Se sua coleção é pequena e simples, então é bem capaz que há algum problema ocorrendo e pode ser discutido na lista de emails. Já se sua base tem milhares de itens, com dezenas de metadados, então as razões para lentidões podem ter relação com o servidor ou com as configurações de busca atuais. Sugerimos uma leitura detalhada [desta página](#/optimization) que vai te guiar por algumas opções em questão de performance. +Se sua coleção é pequena e simples, então é bem capaz que há algum problema ocorrendo e pode ser discutido no fórum de suporte. Já se sua base tem milhares de itens, com dezenas de metadados, então as razões para lentidões podem ter relação com o servidor ou com as configurações de busca atuais. Sugerimos uma leitura detalhada [desta página](#/optimization) que vai te guiar por algumas opções em questão de performance. --- @@ -127,4 +127,4 @@ Por padrão, a página inicial do seu site será a lista de posts do seu blog. P Como administrador do seu site, é possível cadastrar novos usuário com diferentes [papéis e permissões](/pt-br/users-roles) para editar seu acervo. Se no entanto você quer que possam ser inseridos itens sem o cadastro de novos usuários no sistema, pode criar um [Formulário de Submissão de itens](/pt-br/item-submission) público, para receber contribuições externas diretas no seu repositório. -> Para participar da comunidade do Tainacan [inscreva-se aqui](https://lists.riseup.net/www/subscribe/tainacan)! +> Para participar da comunidade do Tainacan [inscreva-se aqui](https://tainacan.discourse.group)! diff --git a/pt-br/optimization.md b/pt-br/optimization.md index 97576e49..cb767a7c 100644 --- a/pt-br/optimization.md +++ b/pt-br/optimization.md @@ -4,37 +4,37 @@ Esta página reúne dicas e configurações para **otimizar a performance** do Tainacan em seu servidor. -Algumas coisas podem ser feitas diretamente pelo painel administrativo do **WordPress**, e outras ações podem envolver edição de *arquivos de configuração e acesso a configurações no seu servidor*, também pode ser necessário conhecimento técnico mais avançado ou contato com o administrador do servidor da instalação. +Algumas coisas podem ser feitas diretamente pelo painel administrativo do **WordPress**, e outras ações podem envolver edição de _arquivos de configuração e acesso a configurações no seu servidor_, também pode ser necessário conhecimento técnico mais avançado ou contato com o administrador do servidor da instalação. ------- +--- ## Diagnóstico do Sistema -A partir da versão [0.8](https://wordpress.org/plugins/tainacan/%7C) do plugin do Tainacan para *WordPress* foi implementada uma seção para a realização automática de um *diagnóstico* da sua instalação. +A partir da versão [0.8](https://wordpress.org/plugins/tainacan/%7C) do plugin do Tainacan para _WordPress_ foi implementada uma seção para a realização automática de um _diagnóstico_ da sua instalação. -1. Acesse o *painel administrativo* do WordPress; -2. No menu lateral esquerdo, **passe** o *mouse* sobre Tainacan; +1. Acesse o _painel administrativo_ do WordPress; +2. No menu lateral esquerdo, **passe** o _mouse_ sobre Tainacan; 3. Selecione o submenu **Diagnóstico do Sistema**; Esta tela exibe as seguintes informações: -* **Versão do WordPress**: Retorna informações sobre a sua versão *instalada* do **WordPress** em comparação com a versão mais recente disponível. -* **Versão PHP**: Retorna informações sobre a sua versão *instalada* do **PHP** em comparação com a versão mais recente disponível. -* **Versão da base de dados**: Retorna informações sobre a sua versão *instalada* do **Banco de Dados** em comparação com a versão mais recente disponível. -* **Módulos PHP**: Retorna informações sobre os módulos obrigatórios e recomendados para o funcionamento adequado do Tainacan. -* **Tempo máximo de execução do PHP**: Retorna o *valor atual* e o *recomendado* para a execução de processos. -* **Estrutura de Links Permanentes**: Retorna se a estrutura de *Links Permanentes* está **habilitada** ou não. -* **Pasta de Upload**: Retorna se a *pasta para envio de mídia* está **gravável** ou não. -* **Tamanho máximo do upload de arquivos**: Retorna o **tamanho máximo** de arquivos permitido para *upload* na instalação. -* **Cron**: Retorna a **existência** ou *ausência* de **tarefas agendadas** de *backup* da instalação. +- **Versão do WordPress**: Retorna informações sobre a sua versão _instalada_ do **WordPress** em comparação com a versão mais recente disponível. +- **Versão PHP**: Retorna informações sobre a sua versão _instalada_ do **PHP** em comparação com a versão mais recente disponível. +- **Versão da base de dados**: Retorna informações sobre a sua versão _instalada_ do **Banco de Dados** em comparação com a versão mais recente disponível. +- **Módulos PHP**: Retorna informações sobre os módulos obrigatórios e recomendados para o funcionamento adequado do Tainacan. +- **Tempo máximo de execução do PHP**: Retorna o _valor atual_ e o _recomendado_ para a execução de processos. +- **Estrutura de Links Permanentes**: Retorna se a estrutura de _Links Permanentes_ está **habilitada** ou não. +- **Pasta de Upload**: Retorna se a _pasta para envio de mídia_ está **gravável** ou não. +- **Tamanho máximo do upload de arquivos**: Retorna o **tamanho máximo** de arquivos permitido para _upload_ na instalação. +- **Cron**: Retorna a **existência** ou _ausência_ de **tarefas agendadas** de _backup_ da instalação. Os resultados são acompanhados de um pequeno retorno visual (▇) à esquerda em que as cores indicam: -* ▇ - Parâmetro **incorreto** para funcionamento adequado; -* ▇ - Parâmetro **parcialmente suficiente**, com ajustes possíveis; -* ▇ - Parâmetro **adequado**! +- ▇ - Parâmetro **incorreto** para funcionamento adequado; +- ▇ - Parâmetro **parcialmente suficiente**, com ajustes possíveis; +- ▇ - Parâmetro **adequado**! -Em caso de dúvidas ou sugestões inscreva-se na [comunidade do Tainacan](https://lists.riseup.net/www/subscribe/tainacan)! +Em caso de dúvidas ou sugestões inscreva-se na [comunidade do Tainacan](https://tainacan.discourse.group)! ### Permissões do Módulo Imagick (Não está gerando miniaturas a partir de arquivos PDF) @@ -58,8 +58,7 @@ E mude para ficar assim: Em seguida, reinicie seu servidor web. - ------- +--- ## Orientações para performance @@ -112,7 +111,7 @@ Caso este comportamento não seja adequado para você, é possível configurar o Para fazer isso, adicione a seguinte linha no seu arquivo `wp-config.php`: ```php -define('TAINACAN_FACETS_DISABLE_FILTER_ITEMS', true); +define('TAINACAN_FACETS_DISABLE_FILTER_ITEMS', true); ``` ### Melhorando a velocidade de carregamento das facetas @@ -125,13 +124,14 @@ Caso você não tenha acesso ou condições de modificar as configurações do s 1. Considere diminuir o número de facetas, mantendo apenas as essenciais. Caso algumas facetas sejam essenciais para o trabalho de gestão, mas dispensáveis para a navegação do público em geral, marque estas como “visível apenas por editores”. Desta maneira, você irá melhorar a experiência do seu visitante. 2. Desative a contagem de itens por faceta. Para fazer isso, adicione a seguinte linha no seu arquivo `wp-config.php`: + ```php define('TAINACAN_FACETS_DISABLE_COUNT_ITEMS', true); ``` Mais informações sobre facetas na documentação para desenvolvedores [da busca facetada](/dev/faceted-search). ------- +--- ## Ajustes nas configurações do servidor @@ -139,13 +139,13 @@ Os ajustes presentes nesta seção dizem respeito a configuração do seu servid Para saber exatamente como fazer cada uma dessas configurações, consulte a documentação do servidor utilizado, o administrador de sistemas responsável ou o suporte técnico de sua hospedagem. As diretivas recomendadas aqui tomam como base um servidor com as seguintes configurações: -* Processador: Intel(R) Xeon(R) CPU E5-2609 0 @ 2.40GHz, 4 cores; -* Sistema operacional: Ubuntu Linux 16.04.1; -* Memória real e virtual: 16 GB e 2 GB; -* Kernel e CPU: Linux 4.4.0-72-generic on x86_64 -* Versão do Apache: 2.4 +- Processador: Intel(R) Xeon(R) CPU E5-2609 0 @ 2.40GHz, 4 cores; +- Sistema operacional: Ubuntu Linux 16.04.1; +- Memória real e virtual: 16 GB e 2 GB; +- Kernel e CPU: Linux 4.4.0-72-generic on x86_64 +- Versão do Apache: 2.4 -### Aumente o *timeout* do seu servidor +### Aumente o _timeout_ do seu servidor Por padrão, grande parte dos servidores está configurado com um timeout de `30 segundos`. Isso significa que qualquer requisição que demore mais do que 30 segundos para concluir será cancelada. @@ -153,7 +153,7 @@ No geral, este tempo é suficiente, porém ele pode ser um gargalo em algumas op Por segurança, aumente este valor para algo em torno de `200` a `300 segundos`. -### Configure o *KeepAlive* +### Configure o _KeepAlive_ Esta diretiva se definida como `on`, permite conexões persistentes ao apache. Para um melhor desempenho, é recomendado definir esta opção como `on` e permitir que mais de uma solicitação por conexão. @@ -161,7 +161,7 @@ MaxKeepAliveRequests: Esta diretiva é usada para definir o número de solicita KeepAliveTimeout: Esta diretiva é usada para definir quanto tempo, em segundos, o apache irá esperar por um posterior pedido antes de fechar a conexão. O valor `10` é uma boa média a ser utilizada. -### Configure o *MPM Prefork* +### Configure o _MPM Prefork_ Em algumas páginas do Tainacan, especialmente na listagem de itens, são realizadas muitas requisições simultâneas ao servidor. Para melhorar o desempenho nessas situações, é recomendável que você configure o módulo MPM Prefork do servidor Apache. @@ -169,27 +169,29 @@ Para a conceitualização de cada diretiva de configuração apresentada abaixo Segue abaixo as configurações recomendadas que devem ser realizadas no arquivo `/etc/apache2/mods-availave/mpm_prefork.conf`: -* **StartServers**: definir o valor para `4`. -* **MaxClients**: definir o valor para `256`. -* **MinSpareServers**: definir o valor para `15`. -* **MaxSpareServer**: definir o valor para `30`. -* **MaxRequestsPerChild**: definir o valor para `5`. -* **MaxRequestWorkers**: definir o valor para `250`. +- **StartServers**: definir o valor para `4`. +- **MaxClients**: definir o valor para `256`. +- **MinSpareServers**: definir o valor para `15`. +- **MaxSpareServer**: definir o valor para `30`. +- **MaxRequestsPerChild**: definir o valor para `5`. +- **MaxRequestWorkers**: definir o valor para `250`. -Realizadas tais configurações outro aspecto importante é blindar a instalação Wordpress na qual o plugin e tema do Tainacan serão executados. A próxima seção trata desse aspecto. +Realizadas tais configurações outro aspecto importante é blindar a instalação Wordpress na qual o plugin e tema do Tainacan serão executados. A próxima seção trata desse aspecto. ------ +--- ## Blindando o Wordpress O primeiro passo é configurar as permissões dos arquivos e diretórios da instalação corretamente. Isso pode feito por meio dos seguintes comandos que: -Para diretórios: +Para diretórios: + ```shell find /caminho/para/a/pasta/do/wordpress/ -type d -exec chmod 755 {} \; ``` -Para arquivos: +Para arquivos: + ```shell find /caminho/para/a/pasta/do/wordpress/ -type f -exec chmod 644 {} \; ``` @@ -218,7 +220,7 @@ deny from all ``` -Desabilitar a listagem de arquivos e o acesso direto a arquivos *.php* no diretório de uploads. Isso pode ser feito pela inclusão de um arquivo `.htaccess` dentro do diretório `/wp-content/uploads` da instalação Wordpress com o seguinte conteúdo: +Desabilitar a listagem de arquivos e o acesso direto a arquivos _.php_ no diretório de uploads. Isso pode ser feito pela inclusão de um arquivo `.htaccess` dentro do diretório `/wp-content/uploads` da instalação Wordpress com o seguinte conteúdo: ```php Options -Indexes @@ -234,12 +236,12 @@ Require all denied Fechando as recomendações de segurança recomenda-se a instalação, ativação e configuração do plugin [Wordfence](https://wordpress.org/plugins/wordfence/) que possui uma gama de recursos que objetivam proteger a instalação Wordpress do mais diversos tipos de ataques e exploração de vulnerabildades. -O plugin e a sua documentação podem ser acessados [aqui](https://wordpress.org/plugins/wordfence/). +O plugin e a sua documentação podem ser acessados [aqui](https://wordpress.org/plugins/wordfence/). ## Cache Existem diversos plugins de cache para o WordPress que podem acelerar bastante o carregamento das páginas para seus visitantes. -Existe um cuidado que precisa ser tomado quando for utilizar um plugin de cache. Como o Tainacan utiliza "nonces", que são códigos de segurança para verificar a intenção do usuário de realizar determinadas ações, é preciso configurar o cache para não durar mais do que 12 horas. Esses códigos duram esse tempo e, se o cache durar mais do que 12 horas, possivelmente você irá visitar o site com um código expirado e terá problemas de permissão. +Existe um cuidado que precisa ser tomado quando for utilizar um plugin de cache. Como o Tainacan utiliza "nonces", que são códigos de segurança para verificar a intenção do usuário de realizar determinadas ações, é preciso configurar o cache para não durar mais do que 12 horas. Esses códigos duram esse tempo e, se o cache durar mais do que 12 horas, possivelmente você irá visitar o site com um código expirado e terá problemas de permissão. -Se quiser mais detalhes sobre isso, veja [estes](https://medium.com/myatus/wordpress-caching-and-nonce-lifespan-bb357d984da9) [artigos](https://joshpress.net/wordpress-nonces-and-wordpress-caching/). \ No newline at end of file +Se quiser mais detalhes sobre isso, veja [estes](https://medium.com/myatus/wordpress-caching-and-nonce-lifespan-bb357d984da9) [artigos](https://joshpress.net/wordpress-nonces-and-wordpress-caching/). diff --git a/pt-br/release-testing.md b/pt-br/release-testing.md index d34f6d71..05b710d5 100644 --- a/pt-br/release-testing.md +++ b/pt-br/release-testing.md @@ -6,7 +6,7 @@ Esta sessão descreve o roteiro para testes de integridade na instalação ou at Estes são os procedimentos para que novas versões do plugin do Tainacan sejam validadas previamente pela comunidade, evitando o envio do plugin com a presença de bugs para o repositório do WordPress: -1. Divulgar a RC na [comunidade do Tainacan](https://lists.riseup.net/www/subscribe/tainacan) para que sejam realizados os testes de uso; +1. Divulgar a RC na [comunidade do Tainacan](https://tainacan.discourse.group) para que sejam realizados os testes de uso; 2. Fazer testes seguindo este [Roteiro de Testes](#roteiro-de-testes-do-plugin) a seguir; 3. Resolver eventuais problemas encontrados e lançar uma nova versão RC _(Release Candidate)_ até os testes não apontarem problemas. 4. A partir disso, seguir os passos para [lançar uma nova versão](/dev/release.md) para WordPress. @@ -15,7 +15,7 @@ Estes são os procedimentos para que novas versões do plugin do Tainacan sejam Este roteiro é destinado para a realização de testes que verifiquem o funcionamento adequado das funções e a realização de processos pelo Plugin do Tainacan. -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). Há vários tipos de testes que podem ser feitos para cobrir o máximo de funcionalidades possíveis. Todos começam com as seguintes etapas básicas: diff --git a/pt-br/testing-capabilities.md b/pt-br/testing-capabilities.md index 3d2e6458..efce052e 100644 --- a/pt-br/testing-capabilities.md +++ b/pt-br/testing-capabilities.md @@ -7,51 +7,56 @@ As permissões e a gestão de funções de usuários estão entre os recursos ma 1. Acesse o **painel de controle do WordPress** onde a sua versão de testes do plugin Tainacan está instalada e ativada (geralmente, o endereço do seu site + `/wp-admin`); 2. Na barra lateral esquerda, clique em **Adicionar Novo** na seção **Usuários**; 3. Crie um usuário de teste com os dados que preferir, marcando sua função como `Assinante`; -4. Faça *log-off*, clicando em `Sair` no canto do menu de usuário do canto superior direito; +4. Faça _log-off_, clicando em `Sair` no canto do menu de usuário do canto superior direito; 5. Entre com o usuário criado no painel de controle do Wordpress; 6. Na barra lateral esquerda, clique em **Tainacan** para acessar o painel Admin do Tainacan; - [x] Já na página inicial do plugin, verifique se estão inacessíveis: - * Os links de Metadados e Filtros Nível Repositório; - * Os links de Metadados, Filtros e Atividades Nível Coleção; + - Os links de Metadados e Filtros Nível Repositório; + - Os links de Metadados, Filtros e Atividades Nível Coleção; - [x] Veja por outro lado se estão disponíveis: - * Os links de Taxonomias, Atividades, Importadores e Exportadores nível repositório; - * Os links para a Lista de Coleções e para as listas de itens de cada coleção; + - Os links de Taxonomias, Atividades, Importadores e Exportadores nível repositório; + - Os links para a Lista de Coleções e para as listas de itens de cada coleção; 7. Acesse a Lista de Itens uma das Coleções do Repositório; - [x] Confira se estão inacessíveis: - * O botão de adicionar novo Item; - * Os items privados; - * Os links para editar ou deletar os itens; - * A opção de selecionar e editar itens em massa; - * Os links no menu da coleção para Metadados, Atividades, Filtros e Permissões da Coleção; + - O botão de adicionar novo Item; + - Os items privados; + - Os links para editar ou deletar os itens; + - A opção de selecionar e editar itens em massa; + - Os links no menu da coleção para Metadados, Atividades, Filtros e Permissões da Coleção; - [x] Confirme que estão disponíveis: - * Os filtros ao lado da lista de itens; - * As abas de Itens Publicados, Rascunho e Lixeira; - * As opções de controle da Busca como Ordenação e Modos de Visualização; + - Os filtros ao lado da lista de itens; + - As abas de Itens Publicados, Rascunho e Lixeira; + - As opções de controle da Busca como Ordenação e Modos de Visualização; 8. Clique em um dos Itens para acessar sua página no Admin: - [x] Confirme que não há link para editar o item; - [x] Veja se todos os dados do item estão visíveis, exceto pelas Atividades, que não devem ser listadas; 9. Vá para lista de Coleções, disponível no menu lateral do Repositório; - [x] Confira se estão inacessíveis: - * O botão de adicionar nova Coleção; - * As coleções privadas; - * Os links para editar ou deletar as Coleções; + - O botão de adicionar nova Coleção; + - As coleções privadas; + - Os links para editar ou deletar as Coleções; - [x] Confirme que estão disponíveis: - * As abas de Coleções Publicadas e Lixeira; - * As opções de Ordenação e Busca textual; + - As abas de Coleções Publicadas e Lixeira; + - As opções de Ordenação e Busca textual; 10. Vá para lista de Taxonomias, disponível no menu lateral do Repositório; - - [x] Confira se estão inacessíveis: - * O botão de adicionar nova Taxonomia; - * As taxonomias privadas; - * Os links para editar ou deletar as Taxonomias; - - [x] Confirme que estão disponíveis: - * As abas de Taxonomias Publicados, Rascunho e Lixeira; - * As opções de Ordenação e Busca textual; + +- [x] Confira se estão inacessíveis: + - O botão de adicionar nova Taxonomia; + - As taxonomias privadas; + - Os links para editar ou deletar as Taxonomias; +- [x] Confirme que estão disponíveis: + - As abas de Taxonomias Publicados, Rascunho e Lixeira; + - As opções de Ordenação e Busca textual; + 11. Escolha uma Taxonomia e clique nela; - - [x] Confirme que a aba onde seria feita a edição da Taxonomia está sem permissão de acesso; - - [x] Cheque se a aba que lista os termos está acessível. Porém não deve ser possível adicionar ou editar termos; + +- [x] Confirme que a aba onde seria feita a edição da Taxonomia está sem permissão de acesso; +- [x] Cheque se a aba que lista os termos está acessível. Porém não deve ser possível adicionar ou editar termos; + 12. Vá para a lista de Atividades do Repositório, disponível no menu lateral do Repositório; - - [x] Confirme que as Atividades não são listadas da aba Atividades; - - [x] Confirme que a aba Processos não contém nenhum processo em execução (não por falta de permissão, mas porque este usuário, recém criado, não possui nenhum processo); + +- [x] Confirme que as Atividades não são listadas da aba Atividades; +- [x] Confirme que a aba Processos não contém nenhum processo em execução (não por falta de permissão, mas porque este usuário, recém criado, não possui nenhum processo); ## Adicionando todas as permissões para uma função de usuário @@ -61,69 +66,85 @@ As permissões e a gestão de funções de usuários estão entre os recursos ma 4. Passando o mouse em cima do função, selecione a opção "Editar"; 5. Na tela de edição da função, marque a opção `Gerenciar Tainacan`; - [x] Observe que todas demais permissões foram marcadas e não podem ser alteradas já que estão sobre influência da permissão maior. -4. Clique em `Salvar Alterações`; -5. Faça *log-off*, clicando em `Sair` no canto do menu de usuário do canto superior direito; -6. Entre com um usuário de testes criado que possua a função de usuário alterada no painel de controle do Wordpress; -7. Na barra lateral esquerda, clique em **Tainacan** para acessar o painel Admin do Tainacan; +6. Clique em `Salvar Alterações`; +7. Faça _log-off_, clicando em `Sair` no canto do menu de usuário do canto superior direito; +8. Entre com um usuário de testes criado que possua a função de usuário alterada no painel de controle do Wordpress; +9. Na barra lateral esquerda, clique em **Tainacan** para acessar o painel Admin do Tainacan; - [x] Confirme que todos os elementos e funções do Tainacan estão acessíveis desta vez; -8. Volte para o painel de controle do WordPress, clicando na logo do WordPress no canto superior direito; -9. Faça *log-off*, clicando em `Sair` no canto do menu de usuário do canto superior direito; +10. Volte para o painel de controle do WordPress, clicando na logo do WordPress no canto superior direito; +11. Faça _log-off_, clicando em `Sair` no canto do menu de usuário do canto superior direito; ## Adicionando algumas permissões para uma função de usuário -1. Entre como administrador novamente e acesse mais uma vez a tela de configuração da função de usuário escolhida (*por exemplo, Assinante*); +1. Entre como administrador novamente e acesse mais uma vez a tela de configuração da função de usuário escolhida (_por exemplo, Assinante_); 2. Na tela de edição da função, desmarque a opção `Gerenciar Tainacan`; - - [x] Observe que as permissões foram todas desmarcadas e agora podem ser alteradas. + +- [x] Observe que as permissões foram todas desmarcadas e agora podem ser alteradas. + 3. Troque para a aba "Coleções"; 4. Com o seletor marcado em `Todas as Coleções`, ative as seguintes permissões: - 1. Gerenciar Metadados; - 2. Deletar Filtros; - 3. Ver Itens Privados; + 1. Gerenciar Metadados; + 2. Deletar Filtros; + 3. Ver Itens Privados; 5. Troque o seletor para alguma coleção específica; - - [x] Note que algumas permissões já estão marcadas e não podem ser alteradas, aquelas marcadas no nível de `Todas as coleções`; + +- [x] Note que algumas permissões já estão marcadas e não podem ser alteradas, aquelas marcadas no nível de `Todas as coleções`; + 6. Nesta coleção, marque as seguintes permissões: - 1. Editar Itens em Massa; - 2. Editar Itens; - 3. Editar Itens Publicados; - 4. Editar Itens de Outros; - 5. Deletar Itens; + 1. Editar Itens em Massa; + 2. Editar Itens; + 3. Editar Itens Publicados; + 4. Editar Itens de Outros; + 5. Deletar Itens; 7. Clique em `Salvar Alterações`; -8. Faça *log-off*, clicando em `Sair` no canto do menu de usuário do canto superior direito; +8. Faça _log-off_, clicando em `Sair` no canto do menu de usuário do canto superior direito; 9. Entre com um usuário de testes criado que possua a função de usuário alterada no painel de controle do Wordpress; 10. Na barra lateral esquerda, clique em **Tainacan** para acessar o painel Admin do Tainacan; - - [x] Já na página inicial do plugin, verifique se estão inacessíveis: - * Os links de Metadados e Filtros Nível Repositório; - * Os links de Atividades e Filtros Nível Coleção; - - [x] Veja por outro lado se estão disponíveis: - * Os links de Taxonomias, Atividades, Importadores e Exportadores nível repositório; - * Os links para a Lista de Coleções e para as Listas de Itens e Metadados de cada coleção; + +- [x] Já na página inicial do plugin, verifique se estão inacessíveis: + - Os links de Metadados e Filtros Nível Repositório; + - Os links de Atividades e Filtros Nível Coleção; +- [x] Veja por outro lado se estão disponíveis: + - Os links de Taxonomias, Atividades, Importadores e Exportadores nível repositório; + - Os links para a Lista de Coleções e para as Listas de Itens e Metadados de cada coleção; + 11. Entre na Coleção definida no passo **5**; - - [x] Confira se estão inacessíveis: - * Os links para deletar os itens; - * Os links no menu da coleção para Atividades, Filtros e Permissões da Coleção; - - [x] Confirme que estão disponíveis: - * O botão de adicionar novo Item; - * Os links para editar os itens; - * Os filtros ao lado da lista de itens; - * As abas de Itens Publicados, Privados, Rascunho e Lixeira; - * As opções de controle da Busca como Ordenação e Modos de Visualização; - * A opção de selecionar e editar itens em massa; - * Os link no menu da coleção para Metadados da Coleção; + +- [x] Confira se estão inacessíveis: + - Os links para deletar os itens; + - Os links no menu da coleção para Atividades, Filtros e Permissões da Coleção; +- [x] Confirme que estão disponíveis: + - O botão de adicionar novo Item; + - Os links para editar os itens; + - Os filtros ao lado da lista de itens; + - As abas de Itens Publicados, Privados, Rascunho e Lixeira; + - As opções de controle da Busca como Ordenação e Modos de Visualização; + - A opção de selecionar e editar itens em massa; + - Os link no menu da coleção para Metadados da Coleção; + 12. Entre em algum dos itens desta coleção; - - [x] Confirme que há link para editar o item; - - [x] Veja se todos os dados do item estão visíveis, exceto pelas Atividades, que não devem ser listadas; + +- [x] Confirme que há link para editar o item; +- [x] Veja se todos os dados do item estão visíveis, exceto pelas Atividades, que não devem ser listadas; + 13. Clique em "Editar Item"; - - [x] Confirme que não há link para deletar o item, já que este item foi criado por outro usuário; + +- [x] Confirme que não há link para deletar o item, já que este item foi criado por outro usuário; + 14. Voltando à Lista de Itens, clique em Adicionar Novo para criar um novo Item; 15. Preecha o item como desejar; - - [x] Note que, por não ter a permissão "Publicar Items" você só pode salvar o novo item como rascunho; + +- [x] Note que, por não ter a permissão "Publicar Items" você só pode salvar o novo item como rascunho; + 16. Ao concluir, volte para a Lista de Itens; - - [x] Veja que o item que você acabou de criar está na aba rascunho e pode, além de ser editado, ser deletado; + +- [x] Veja que o item que você acabou de criar está na aba rascunho e pode, além de ser editado, ser deletado; + 17. Por fim, entre na tela de Metadados da Coleção; - - [x] Confirme que é possível ordenar e editar os metados, porém não é possível deletá-los; - - ?> _TODO_ Continuar a descrever o teste. +- [x] Confirme que é possível ordenar e editar os metados, porém não é possível deletá-los; + +?> _TODO_ Continuar a descrever o teste. ## Configurando permissões específicas em uma coleção @@ -133,8 +154,8 @@ As permissões e a gestão de funções de usuários estão entre os recursos ma 4. Acesse a página de Permissões Relacionadas à Coleção, na barra de menu da coleção; 5. Selecione alguma permissão para alterar, por exemplo "Editar itens em massa"; 6. Retire ou adicione esta permissão de alguma função de usuário; -7. Faça *log-off* e entre com algum usuário da função alterada; - - [x] Verifique se a permissão foi modificada; +7. Faça _log-off_ e entre com algum usuário da função alterada; +- [x] Verifique se a permissão foi modificada; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). \ No newline at end of file +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-collections.md b/pt-br/testing-collections.md index bbbfe786..333fed9a 100644 --- a/pt-br/testing-collections.md +++ b/pt-br/testing-collections.md @@ -7,7 +7,7 @@ 3. Defina status diferentes para cada uma, como Pública e Privado, ou Pública (Rascunho não é possível); 4. Salve as mudanças cliando em `Concluir`: 5. Vá para a lista de coleções e cheque se as coleções estão nas abas corretas de acordo com seu status; - - [x] Observe o tempo de carregamento da tela de *Criação de coleção* e *Lista de Coleções*; + - [x] Observe o tempo de carregamento da tela de _Criação de coleção_ e _Lista de Coleções_; - [x] Observe o tempo de conclusão ao **concluir** ou **salvar** as coleções; ## A Visualização da Coleção no Tema e Comentários nos Itens @@ -16,27 +16,35 @@ 2. Configure a opção de "Permitir comentários" para habilitar a configuração de comentários nos itens; 3. Salve as mudanças clicando em `Concluir`; 4. Acesse a Página da Coleção no tema (por padrão a lista de itens da coleção), clicando no botão em formato de olho no canto superior direito; - - [x] Observe se todos elementos da página foram exibidos corretamente; - - [x] Cheque se os modos habilitados estão disponíveis e se o modo marcado como padrão foi o primeiro; + +- [x] Observe se todos elementos da página foram exibidos corretamente; +- [x] Cheque se os modos habilitados estão disponíveis e se o modo marcado como padrão foi o primeiro; + 5. Volte ao painel administrativo e desta vez acesse tente editar um item desta coleção: - - [x] Verifique que existe ou não a opção de alterar comentários na página de edição do item, de acordo com o configurado no passo *2*; + +- [x] Verifique que existe ou não a opção de alterar comentários na página de edição do item, de acordo com o configurado no passo _2_; + 7. Volte às configurações da coleção e habilite a opção "Página de capa". Escolha uma página qualquer como página de capa da coleção; 8. Salve as mudanças clicando em `Concluir`; 9. Acesse novamente a Página da Coleção no tema; - - [x] Cheque se a página marcada foi definida como a capa página desta coleção; -7. Volte às configurações e lembre-se de desabilitar a opção "Página de capa" caso não deseje utilizá-la. -## O *slug* da Coleção +- [x] Cheque se a página marcada foi definida como a capa página desta coleção; + +7. Volte às configurações e lembre-se de desabilitar a opção "Página de capa" caso não deseje utilizá-la. + +## O _slug_ da Coleção 1. No formulário de edição da coleção, troque o `slug` por algum valor de peferência sua; 2. Salve a mudança clicando em `Concluir`; 3. Acesse a Página da Coleção no tema, clicando no botão em formato de olho no canto superior direito; - - [x] O link da página está escrito usando o `slug` configurado? + +- [x] O link da página está escrito usando o `slug` configurado? ## Herança de Coleções + 1. Crie alguns metadados e filtros na coleção; 2. Vá para as configurações de outra coleção e selecione a primeira como "Coleção Raiz"; 3. Acesse a página de metadados e de filtros desta coleção; - [x] Os metadados e filtros foram herdados? -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). \ No newline at end of file +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-exporters.md b/pt-br/testing-exporters.md index 661ab2c0..c8b39333 100644 --- a/pt-br/testing-exporters.md +++ b/pt-br/testing-exporters.md @@ -1,4 +1,3 @@ - ?> _TODO_ Esta página pode ser melhorada com mais exemplos # Testando Exportadores @@ -14,4 +13,4 @@ O Tainacan oferece diferentes importadores, incluindo alguns que podem ser criad - [x] Ao concluir a execução do exportador, verifique os logs (Arquivos de Registro) na página de Processos para ver se não houve nenhum alerta. - [x] Baixe e abra o arquivo gerado para confirmar que os dados foram exportados corretamente, incluindos os valores e campos especiais dos metadados. -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). \ No newline at end of file +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-filters.md b/pt-br/testing-filters.md index 75cab758..b7982264 100644 --- a/pt-br/testing-filters.md +++ b/pt-br/testing-filters.md @@ -5,21 +5,21 @@ 1. Para poder testar ao máximo os filtros, crie pelo menos um de cada tipo de metadado existente na tela de configuração de metadados de coleção ou de repositório; 2. Também sugerimos criar alguns itens com valores destes metadados preenchidos. O [Importador Teste](/pt-br/importers#importador-teste) neste momento pode ser bem útil! 3. Crie os diferentes tipos de filtros a **nível de coleção**, em coleções diferentes: - 1. Lembre-se de criar pelo menos um filtro para um metadado do tipo *relacionamento* e um para um metadado do tipo *taxonomia*; - 2. Busque marcar opções diferentes de Status entre os filtros e demais campos de texto: -4. Teste as ações de *exclusão*, *troca de ordem*, *edição de filtros* ou *desabilitar*. - - [x] Recarregue a página e verifique as mudanças para confirmar que tudo foi salvo; - - [x] Observe o tempo de carregamento na criação de filtros; - - [x] Observe o tempo de conclusão ao **salvar** cada filtro; - - [x] Veja se as **configurações se refletem** na lista de items, tanto no Admin do Tainacan, quanto na lista de itens desta coleção no tema; +4. Lembre-se de criar pelo menos um filtro para um metadado do tipo _relacionamento_ e um para um metadado do tipo _taxonomia_; +5. Busque marcar opções diferentes de Status entre os filtros e demais campos de texto: +6. Teste as ações de _exclusão_, _troca de ordem_, _edição de filtros_ ou _desabilitar_. + +- [x] Recarregue a página e verifique as mudanças para confirmar que tudo foi salvo; +- [x] Observe o tempo de carregamento na criação de filtros; +- [x] Observe o tempo de conclusão ao **salvar** cada filtro; +- [x] Veja se as **configurações se refletem** na lista de items, tanto no Admin do Tainacan, quanto na lista de itens desta coleção no tema; ## Nível Repositório 1. Repita os passos descritos acima para alguns filtros nível repositório; 2. Entre na página de filtros de uma coleção; - - [x] Verifique se os filtros foram herdados e se suas configurações foram respeitas; + - [x] Verifique se os filtros foram herdados e se suas configurações foram respeitas; - [x] Verifique se é possível trocar a ordem dos mesmos no nível da coleção; - [x] Veja se os filtros aparecem tanto na lista de itens nível repositório do Admin do Tainacan quando no tema, ao acessar a lista de itens do repositório em `/itens`; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). - +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-gutenberg-blocks.md b/pt-br/testing-gutenberg-blocks.md index b95dc71a..ec256ed9 100644 --- a/pt-br/testing-gutenberg-blocks.md +++ b/pt-br/testing-gutenberg-blocks.md @@ -22,6 +22,6 @@ A maioria dos blocos Gutenberg são "dinâmicos", o que significa que suas infor 2. Configure a busca aplicando filtros; 3. Publique o post; 4. Vá para o Tainacan, altere a lista de itens de maneira que a busca configurada anteriormente resulte em algo diferente; -5. Acesse novamente o post publicado, verifique se a mudança está refletida no bloco; +5. Acesse novamente o post publicado, verifique se a mudança está refletida no bloco; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). \ No newline at end of file +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-importers.md b/pt-br/testing-importers.md index 0438351d..d262492f 100644 --- a/pt-br/testing-importers.md +++ b/pt-br/testing-importers.md @@ -6,13 +6,13 @@ Há diversos importadores para o Tainacan, incluindo alguns que podem ser criado 1. Vá para a página de Importadores, acessível pelo menu do repositório; 2. Selecione o Importador CSV; -3. Escolha um arquivo CSV para testar. É importante que seu arquivo cubra alguns dos casos mais comuns da importação. Se você não tiver um em mãos, pode utilizar algum [destes aqui](http://oficinas.tainacan.org/ ':ignore'); +3. Escolha um arquivo CSV para testar. É importante que seu arquivo cubra alguns dos casos mais comuns da importação. Se você não tiver um em mãos, pode utilizar algum [destes aqui](http://oficinas.tainacan.org/ ":ignore"); 4. Preencha o formulário, selecionando uma Coleção destino e subindo o arquivo CSV; 5. Clique em `Próximo`; - [x] Ao entrar na Tela de Mapeamento, verifique se as coluna foram devidamente separadas de acordo com seu separador configurado na página anterior. - - [x] Cheque se estão disponíveisos metadados existentes nesta coleção nos seletores do mapeamento. + - [x] Cheque se estão disponíveisos metadados existentes nesta coleção nos seletores do mapeamento. 6. Preencha o mapeamento dos metadados. Caso sua coleção ainda não tenha metadados configurados, [deixe o importador criá-los](#criando-metadados-no-mapeamento). Se já estiver configurada, faça os mapeamentos adequados para cada tipo; - - [x] Confirme que, cada vez que um metadado é associado à uma coluna do mapeador, ele deixa de estar disponível nos outros seletores; + - [x] Confirme que, cada vez que um metadado é associado à uma coluna do mapeador, ele deixa de estar disponível nos outros seletores; 7. Clique em `Executar` para rodar o importador; - [x] Confirme que, se você não tiver mapeado nenhuma coluna para o "Metadado principal Título" da Coleção, você receberá um alerta sugerindo que isso seja feito; - [x] Ao concluir a execução do importador, verifique os logs (Arquivos de Registro) na página de Processos para ver se não houve nenhum alerta; @@ -28,9 +28,11 @@ Há diversos importadores para o Tainacan, incluindo alguns que podem ser criado 6. Selecione o Importador CSV; 7. Use a mesma coleção como destino e faça o upload do arquivo CSV que foi alterado; 8. Não se esqueça de deixar a opção "Item Repetido" no formulário selecionada em `Atualizar`; -9. Clique em `Próximo`; +9. Clique em `Próximo`; 10. Na tela de Mapeamento dos Metadados, mantenha as mesmas colunas que foram usadas para os metadados na importação anterior; - - [x] Cheque se o campo especial `special_item_id` foi detectado. + +- [x] Cheque se o campo especial `special_item_id` foi detectado. + 11. Clique em `Executar` para rodar o importador; - [x] Ao concluir a execução do importador, verifique os logs (Arquivos de Registro) na página de Processos para ver se não houve nenhum alerta; - [x] Confirme que os itens que tiveram linhas alteradas foram atualizados no processo de importação; @@ -50,4 +52,4 @@ Há diversos importadores para o Tainacan, incluindo alguns que podem ser criado - [x] Ao concluir a execução do importador, verifique os logs (Arquivos de Registro) na página de Processos para ver se não houve nenhum alerta; - [x] Confirme que os tipos de metadados foram criados corretamente, incluindo suas configurações como "Permitir valores múltiplos", "Status" e "Permitir inserção de novos termos"; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). \ No newline at end of file +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-item-submission.md b/pt-br/testing-item-submission.md index df3e0762..78317bd4 100644 --- a/pt-br/testing-item-submission.md +++ b/pt-br/testing-item-submission.md @@ -71,4 +71,4 @@ A partir da versão 0.17 o Tainacan permite a submissão de itens em páginas p 5. Experimente alterar algumas cores e tamanho da fonte; 2. Publique a página e verifique os efeitos no bloco do formulário; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-items.md b/pt-br/testing-items.md index 414fb764..691cfd23 100644 --- a/pt-br/testing-items.md +++ b/pt-br/testing-items.md @@ -9,26 +9,31 @@ 5. Altere a opção de permitir Comentários na página de algum item; 6. Clique em `Salvar`; 7. Acesse a página do item no tema. - - [x] Observe o tempo de carregamento ao abrir as coleções; - - [x] Observe o tempo de carregamento ao criar itens; - - [x] Observe se todos elementos da página da coleção foram exibidos corretamente; - - [x] Observe se todos elementos da página da criação de item foram exibidos corretamente; - - [x] Observe o tempo de conclusão ao **salvar** ou **publicar** cada item; + +- [x] Observe o tempo de carregamento ao abrir as coleções; +- [x] Observe o tempo de carregamento ao criar itens; +- [x] Observe se todos elementos da página da coleção foram exibidos corretamente; +- [x] Observe se todos elementos da página da criação de item foram exibidos corretamente; +- [x] Observe o tempo de conclusão ao **salvar** ou **publicar** cada item; ## Preenchendo Metadados 1. Abra uma coleção; 2. Edite diferentes Itens nela. Preencha os campos de metadados; - 1. Teste o *não preenchimento* de metadados marcados como obrigatório; - 2. Teste o preenchimento de campos de metadados do tipo taxonomia, e a criação de novos termos; - 3. Teste o preenchimento inválido de campos de metadados tipo numérico ou data; - 4. Após criar itens em uma *primeira coleção*, teste o preenchimento de metadados do tipo relacionamento em *outra coleção*. - - [x] Observe se todos metadados a nível de repositório e da colação foram exibidos corretamente para preenchimento, na página da criação de item; - - [x] Observe se eventuais dicas de preenchimento, configuradas em determinados metadados, estão exibidas corretamente; - - [x] Observe se o aviso de **preenchimento de metadados obrigatórios** funciona corretamente, ao **salvar** ou **publicar** cada item; - 5. Teste o preenchimento de *metadados compostos* que aceitam valores múltiplos. De início, o campo virá vazio, apenas com o botão de adicionar valor. Ao adicionar, surgirá o primeiro grupo de inputs com os metadados filhos - - [x] Observe se metadados filhos marcados como obrigatórios estão gerando erros na lista de erros do formulário; - - [x] Observe se a ordem em que os filhos aparecem é aquela que foi configurada na tela de configurações do metadado. - 6. Teste a funcionalidade de *Definir o item do autor como padrão* para metadados tipo *Usuário*. Ao se criar o item este campo deve vir preenchido. - -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). +3. Teste o _não preenchimento_ de metadados marcados como obrigatório; +4. Teste o preenchimento de campos de metadados do tipo taxonomia, e a criação de novos termos; +5. Teste o preenchimento inválido de campos de metadados tipo numérico ou data; +6. Após criar itens em uma _primeira coleção_, teste o preenchimento de metadados do tipo relacionamento em _outra coleção_. + +- [x] Observe se todos metadados a nível de repositório e da colação foram exibidos corretamente para preenchimento, na página da criação de item; +- [x] Observe se eventuais dicas de preenchimento, configuradas em determinados metadados, estão exibidas corretamente; +- [x] Observe se o aviso de **preenchimento de metadados obrigatórios** funciona corretamente, ao **salvar** ou **publicar** cada item; + +5. Teste o preenchimento de _metadados compostos_ que aceitam valores múltiplos. De início, o campo virá vazio, apenas com o botão de adicionar valor. Ao adicionar, surgirá o primeiro grupo de inputs com os metadados filhos + +- [x] Observe se metadados filhos marcados como obrigatórios estão gerando erros na lista de erros do formulário; +- [x] Observe se a ordem em que os filhos aparecem é aquela que foi configurada na tela de configurações do metadado. + +6. Teste a funcionalidade de _Definir o item do autor como padrão_ para metadados tipo _Usuário_. Ao se criar o item este campo deve vir preenchido. + +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-metadata.md b/pt-br/testing-metadata.md index 1ca49e9b..28e7ec98 100644 --- a/pt-br/testing-metadata.md +++ b/pt-br/testing-metadata.md @@ -3,27 +3,31 @@ ## O Básico 1. Crie os diferentes tipos de metadados a **nível de coleção**, em coleções diferentes: - 1. Lembre-se de criar pelo menos um metadado do tipo *relacionamento*, um do tipo *taxonomia*, um do tipo *composto* e um do tipo *usuário*; - 2. Busque marcar opções diferentes entre os metadados em: +1. Lembre-se de criar pelo menos um metadado do tipo _relacionamento_, um do tipo _taxonomia_, um do tipo _composto_ e um do tipo _usuário_; +1. Busque marcar opções diferentes entre os metadados em: + + * Status; * Exibir na listagem; * Opções de Preenchimento (muito importante checar as opções de preenchimento *requerido*, *multiplo* ou *único*); * Demais campos de texto; -2. Teste as ações de *exclusão*, *troca de ordem*, *edição de metadados* ou *desabilitar*. - - [x] Recarregue a página e verifique as mudanças para confirmar que tudo foi salvo; - - [x] Observe o tempo de carregamento na criação de metadados; - - [x] Observe o tempo de conclusão ao **salvar** cada metadado; - - [x] Veja se as **configurações se refletem** na lista de items e nos formulários de criação de itens; - - ?> *Nota 1*: É diferente um metadado estar "desabilitado" de estar marcado para "Não exibir na listagem". Com o primeiro, não é possível nem mesmo inserir o metadado no item. Com o segundo, ele só muda a visibilidade na lista de itens. - ?> *Nota 2*: A ordenação de filhos do metadado composto só funciona dentro de seu grupo e não são permitidos, no momento, taxonomias como filhos de compostos. +2. Teste as ações de _exclusão_, _troca de ordem_, _edição de metadados_ ou _desabilitar_. + +- [x] Recarregue a página e verifique as mudanças para confirmar que tudo foi salvo; +- [x] Observe o tempo de carregamento na criação de metadados; +- [x] Observe o tempo de conclusão ao **salvar** cada metadado; +- [x] Veja se as **configurações se refletem** na lista de items e nos formulários de criação de itens; + +?> _Nota 1_: É diferente um metadado estar "desabilitado" de estar marcado para "Não exibir na listagem". Com o primeiro, não é possível nem mesmo inserir o metadado no item. Com o segundo, ele só muda a visibilidade na lista de itens. + +?> _Nota 2_: A ordenação de filhos do metadado composto só funciona dentro de seu grupo e não são permitidos, no momento, taxonomias como filhos de compostos. ## Nível Repositório 1. Repita os passos descritos acima para alguns metadados nível repositório; 2. Entre na página de metadados de uma coleção; - - [x] Verifique se os metadados foram herdados; + - [x] Verifique se os metadados foram herdados; - [x] Verifique se é possível trocar a ordem dos mesmos quando acessados na tela de configuração de metadados da coleção; -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-search.md b/pt-br/testing-search.md index bde23fee..d959f9ca 100644 --- a/pt-br/testing-search.md +++ b/pt-br/testing-search.md @@ -20,9 +20,9 @@ Para testar a busca facetada de itens, é preciso ter uma coleção com uma mín 1. Acessar a Coleção ou a lista de Itens Nível Repositório; 2. Abrir a Avançada; 3. Criar um critério de busca para cada tipo de metadado, com diferentes combinações de operadores; - - [x] Tente criar buscas que de fato levem a algum resultado específico; - - [x] Verifique se ao remover cada critério e re-aplicar a busca, novos itens aparecem; - - [x] Selecione a URL da busca aplicada, copie e cole em outra aba do navegador para ver se todos as configurações são mantidas; + - [x] Tente criar buscas que de fato levem a algum resultado específico; + - [x] Verifique se ao remover cada critério e re-aplicar a busca, novos itens aparecem; + - [x] Selecione a URL da busca aplicada, copie e cole em outra aba do navegador para ver se todos as configurações são mantidas; 4. Repita os passos descritos acima tanto para a lista de itens do Admin quando na lista de itens do tema. ## Os Expositores @@ -30,9 +30,9 @@ Para testar a busca facetada de itens, é preciso ter uma coleção com uma mín 1. Acessar a Coleção ou a lista de Itens Nível Repositório; 2. Repita a aplicação de alguns filtros, como feito no primeiro teste; 3. Clique no botão "Ver como..." para abrir o modal de expositores; - - [x] Cheque se o link para a lista de itens no site está correto; - - [x] Verifique se as opções de expositores disponíveis (PDF, HTML, CSV) estão gerando links que refletem a lista de items; - - [x] Verifique se aplicando o checkbox de "Expor apenas metadados exibidos", os metadados que não foram marcados para exibição são retirados da lista resultante; + - [x] Cheque se o link para a lista de itens no site está correto; + - [x] Verifique se as opções de expositores disponíveis (PDF, HTML, CSV) estão gerando links que refletem a lista de items; + - [x] Verifique se aplicando o checkbox de "Expor apenas metadados exibidos", os metadados que não foram marcados para exibição são retirados da lista resultante; 4. Repita os passos descritos acima tanto para a lista de itens do Admin quando na lista de itens do tema. - -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ':ignore') ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ':ignore') do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). + +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/pt-br/testing-taxonomies.md b/pt-br/testing-taxonomies.md index 87f7ed4c..64f913ad 100644 --- a/pt-br/testing-taxonomies.md +++ b/pt-br/testing-taxonomies.md @@ -46,4 +46,4 @@ - [x] Confirme que não é possível inserir novos termos na taxonomia, já que a configuração da Taxonomia tem prioridade sobre a do Metadado; - [x] Recarregue a página do item para ver se os termos possíveis foram salvos -?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). +?> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues ":ignore") ou para o [fórum da comunidade](https://tainacan.discourse.group ":ignore") do Tainacan. Alguns erros comuns como páginas não carregando podem ser melhor descritos usando [sugestões da página de Perguntas Frequentes](/pt-br/faq#acho-que-encontrei-um-erro-como-devo-proceder). diff --git a/release-testing.md b/release-testing.md index 534ce2d0..a0e17a5f 100644 --- a/release-testing.md +++ b/release-testing.md @@ -1,35 +1,35 @@ -?> _TODO_ This page is in *Brazilian Portuguese* only so far. **If you can, please help us translate it to *English*.** +?> _TODO_ This page is in _Brazilian Portuguese_ only so far. **If you can, please help us translate it to _English_.** # Roteiro de Testes Este artigo descreve o roteiro para testes de integridade na instalação ou atualização do Plugin do Tainacan para WordPress: -## Fluxo para lançamento de versão RC *(Release Candidate)* +## Fluxo para lançamento de versão RC _(Release Candidate)_ Este fluxo pretende estabelecer procedimentos para que novas versões do plugin do Tainacan sejam validadas previamente pela comunidade, evitando o envio do plugin com a presença de bugs para o repositório do WordPress. -1. Divulgar a RC na [comunidade do Tainacan](https://lists.riseup.net/www/subscribe/tainacan) para que sejam realizados os testes de uso; +1. Divulgar a RC na [comunidade do Tainacan](https://tainacan.discourse.group) para que sejam realizados os testes de uso; 2. Fazer testes seguindo este Roteiro de Testes; -3. Resolver eventuais problemas encontrados e lançar uma nova versão RC *(Release Candidate)* até os testes não apontarem problemas. +3. Resolver eventuais problemas encontrados e lançar uma nova versão RC _(Release Candidate)_ até os testes não apontarem problemas. 4. A partir disso, seguir os passos para [lançar uma nova versão](/pt-br/dev/release.md) para WordPress. ## Roteiro de Testes do Plugin Este roteiro é destinado para a realização de testes que verifiquem o funcionamento adequado das funções e a realização de processos pelo Plugin do Tainacan. -> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues) ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net) do Tainacan. +> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues) ou para o [fórum da comunidade](https://tainacan.discourse.group) do Tainacan. -1. Acesse o endereço onde a versão *RC* do Tainacan está instalada; +1. Acesse o endereço onde a versão _RC_ do Tainacan está instalada; 2. Acesse o **painel de controle do WordPress**; -3. Verifique os *níveis de permissão do seu usuário* (para os testes, recomenda-se **Administrador** ou **Editor**) +3. Verifique os _níveis de permissão do seu usuário_ (para os testes, recomenda-se **Administrador** ou **Editor**) 4. Na barra lateral esquerda, clique em **Diagnóstico da Instalação** na seção Tainacan: - 1. Verifique se a instalação está com os requisitos recomendados para o funcionamento do *Plugin do Tainacan*. - 2. Baixe o arquivo de log no botão `Baixar Log` para **anexar estas informações** ao Relatório de Testes. -5. Na barra lateral esquerda, clique em Tainacan: +5. Verifique se a instalação está com os requisitos recomendados para o funcionamento do _Plugin do Tainacan_. +6. Baixe o arquivo de log no botão `Baixar Log` para **anexar estas informações** ao Relatório de Testes. +7. Na barra lateral esquerda, clique em Tainacan: -* Observe o tempo de carregamento da tela inicial; -* Observe se todos elementos da página foram exibidos corretamente; - * Observe novamente estes aspectos ao concluir os processos a seguir para reportar eventuais alterações substanciais no tempo de carregamento de tela ou exibição incorreta dos elementos. +- Observe o tempo de carregamento da tela inicial; +- Observe se todos elementos da página foram exibidos corretamente; + - Observe novamente estes aspectos ao concluir os processos a seguir para reportar eventuais alterações substanciais no tempo de carregamento de tela ou exibição incorreta dos elementos. ### Coleções @@ -38,44 +38,48 @@ Este roteiro é destinado para a realização de testes que verifiquem o funcion 3. Defina status diferentes para cada uma, como Pública e Privado, ou Pública e Rascunho; 4. Conclua ou clique em `Salve e ir para Metadados`; -* Observe o tempo de carregamento da tela de *Criação de coleção*; -* Observe se todos elementos da página foram exibidos corretamente; -* Observe o tempo de conclusão ao **concluir** ou **salvar** as coleções; +- Observe o tempo de carregamento da tela de _Criação de coleção_; +- Observe se todos elementos da página foram exibidos corretamente; +- Observe o tempo de conclusão ao **concluir** ou **salvar** as coleções; ### Taxonomias 1. Crie uma ou mais taxonomias; 2. Crie um ou mais termos em cada taxonomia criada; - 1. Envie uma *Imagem da Header* em pelo menos um item de cada taxonomia; - 2. Busque preencher todos os campos, como **nome**, **descrição**, etc. - 3. Crie pelo menos um nível hierárquico em cada taxonomia; +3. Envie uma _Imagem da Header_ em pelo menos um item de cada taxonomia; +4. Busque preencher todos os campos, como **nome**, **descrição**, etc. +5. Crie pelo menos um nível hierárquico em cada taxonomia; -* Observe o tempo de carregamento da tela de *Criação de Taxonomia*; -* Observe se todos elementos da página foram exibidos corretamente; -* Observe o tempo de conclusão ao **salvar** cada taxonomia; -* Observe o tempo de conclusão ao **salvar** cada termo; +- Observe o tempo de carregamento da tela de _Criação de Taxonomia_; +- Observe se todos elementos da página foram exibidos corretamente; +- Observe o tempo de conclusão ao **salvar** cada taxonomia; +- Observe o tempo de conclusão ao **salvar** cada termo; ### Metadados 1. Crie os diferentes tipos de metadados a **nível de repositório**: - 1. Lembre-se de criar metadado do tipo *taxonomia*; - 2. Busque marcar opções diferentes entre os metadados em: - * Status; - * Exibir na listagem; - * Opções de Preenchimento; - * Demais campos de texto; -2. Crie alguns metadados também a **nível de coleção**, em cada coleção: - 1. Lembre-se de criar metadado do tipo *relacionamento*; - 2. Busque marcar opções diferentes entre os metadados em: - * Status; - * Exibir na listagem; - * Opções de Preenchimento; - * Demais campos de texto; -3. Teste as ações de *exclusão* ou *edição de metadados*. - -* Observe o tempo de carregamento na criação de metadados; -* Observe se todos elementos da página foram exibidos corretamente; -* Observe o tempo de conclusão ao **salvar** cada metadado; +1. Lembre-se de criar metadado do tipo _taxonomia_; +1. Busque marcar opções diferentes entre os metadados em: + + - Status; + - Exibir na listagem; + - Opções de Preenchimento; + - Demais campos de texto; + +1. Crie alguns metadados também a **nível de coleção**, em cada coleção: +1. Lembre-se de criar metadado do tipo _relacionamento_; +1. Busque marcar opções diferentes entre os metadados em: + + - Status; + - Exibir na listagem; + - Opções de Preenchimento; + - Demais campos de texto; + +1. Teste as ações de _exclusão_ ou _edição de metadados_. + +- Observe o tempo de carregamento na criação de metadados; +- Observe se todos elementos da página foram exibidos corretamente; +- Observe o tempo de conclusão ao **salvar** cada metadado; ### Itens @@ -85,18 +89,18 @@ Este roteiro é destinado para a realização de testes que verifiquem o funcion 4. Edite a miniatura de diferentes itens; 5. Edite e adicione anexos em diferentes itens; 6. Preencha os campos de metadados; - 1. Teste o *não preenchimento* de metadados marcados como obrigatório; - 2. Teste o preenchimento de campos de metadados do tipo taxonomia, e a criação de novos termos; - 3. Após criar itens em uma *primeira coleção*, teste o preenchimento de metadados do tipo relacionamento em *outra coleção*. - -* Observe o tempo de carregamento ao abrir as coleções; -* Observe o tempo de carregamento ao criar itens; -* Observe se todos elementos da página da coleção foram exibidos corretamente; -* Observe se todos elementos da página da criação de item foram exibidos corretamente; -* Observe se todos metadados a nível de repositório e da colação foram exibidos corretamente para preenchimento, na página da criação de item; -* Observe se eventuais dicas de preenchimento, configuradas em determinados metadados, estão exibidas corretamente -* Observe se o aviso de **preenchimento de metadados obrigatórios** funciona corretamente, ao **salvar** ou **publicar** cada item; -* Observe o tempo de conclusão ao **salvar** ou **publicar** cada item; +7. Teste o _não preenchimento_ de metadados marcados como obrigatório; +8. Teste o preenchimento de campos de metadados do tipo taxonomia, e a criação de novos termos; +9. Após criar itens em uma _primeira coleção_, teste o preenchimento de metadados do tipo relacionamento em _outra coleção_. + +- Observe o tempo de carregamento ao abrir as coleções; +- Observe o tempo de carregamento ao criar itens; +- Observe se todos elementos da página da coleção foram exibidos corretamente; +- Observe se todos elementos da página da criação de item foram exibidos corretamente; +- Observe se todos metadados a nível de repositório e da colação foram exibidos corretamente para preenchimento, na página da criação de item; +- Observe se eventuais dicas de preenchimento, configuradas em determinados metadados, estão exibidas corretamente +- Observe se o aviso de **preenchimento de metadados obrigatórios** funciona corretamente, ao **salvar** ou **publicar** cada item; +- Observe o tempo de conclusão ao **salvar** ou **publicar** cada item; ### Importadores @@ -110,4 +114,4 @@ Este roteiro é destinado para a realização de testes que verifiquem o funcion ?> _TODO_ Implementar este roteiro de testes -> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues) ou para o [e-mail da comunidade](mailto:tainacan@lists.riseup.net) do Tainacan. \ No newline at end of file +> Problemas encontrados podem ser reportados como [issue no GitHub](https://github.com/tainacan/tainacan/issues) ou para o [fórum da comunidade](https://tainacan.discourse.group) do Tainacan.