Tainacan Beta 0.20.4 - Compatibilidade com o WP 6.3, Requisição mínima do WP 5.9 e PHP 7.0, Nova Paleta de Cores e Melhor Documentação!

English below

Salve comunidade! :wave:t3: :tainacan:

Estamos lançando hoje uma versão especial do Tainacan. Por um lado é cheia de ajustes internos no código, por outro, provavelmente não chamará muito a atenção dos usuários. Mas é um passo importante no amadurecimento do plugin que começa a preparar o terreno para futuras versões com mais novidades.

Baixe a versão 0.20.4 do Tainacan no repositório de plugins do WordPress.

Atualização dos Requisitos Mínimos para Rodar o Tainacan

Com o passar dos anos, torna-se difícil garantir compatibilidade com diferentes tecnologias e mesmo assim implementar novas features. Depender de bibliotecas antigas também pode ser um risco de segurança, tendo em vista que há um esforço contínuo de se melhorar a segurança delas. Por conta disso, estamos seguindo os passos do próprio WordPress e de outros plugins populares e vamos subir pela primeira vez os nossos requisitos mínimos de versão para rodar o Tainacan.

Versão mínima do WordPress esperada: 5.9

Até antes desta versão, nossa versão mínima esperada do WordPress era a 5.0, aquela onde foi apresentado o editor de blocos Gutenberg. De lá pra cá muitos recursos novos foram apresentados e temos tentado fazer um uso incremental destas novidades, mas isto tem como custo a manutenção e testagem mais complexa. Baseando-se no ecossistema de plugins do WordPress, estamos subindo agora a versão mínima para a 5.9, lançada em Janeiro de 2022. Isto nos permite deixar o código mais limpo e fazer uso de funcionalidades mais recentes do WordPress.

Embora recomendamos atualizar sempre seu WordPress, isto não quer dizer que o Tainacan vai simplesmente parar de funcionar. Você pode manter o uso da versão 0.20.3 enquanto não puder atualizar, ou pode até atualizar estando em uma versão anterior do WordPress, mas é importante notar que novas features, em especial aquelas relacionadas ao editor de blocos, podem deixar de funcionar ou ter comportamento indesejado.

Versão mínima do PHP esperada: 7.0

Outra importante atualização é a exigência de versão mínima do PHP para 7.0. Esta exigência não é só nossa, mas também vem com a última versão do WordPress. O PHP 5.6 foi lançado no longínquo ano de 2014 e tem sido mantido à duras penas com novas versões em diversos servidores. Mas a linguagem segue evoluindo bastante e hoje já se encontra em fase de migração para sua versão 8.0, que deve trazer significativas melhoras de performance e segurança. Se o seu provedor de hospedagem não atualizou ainda o PHP para uma versão superior ao 7.0 (recomendamos fortemente a 7.4), informe-o sobre a recomendação que vem não só do plugin como do próprio WordPress que também está abandonando o suporte para as versões anteriores à 7.0:

Suporte ao WordPress 6.3

A versão 6.3 do WordPress foi lançada na semana passada. Para se ter uma noção dos incríveis recursos que chegaram nesta versão, vale dar uma explorada neste site de apresentação que fizeram:

Além de ganhos de performance consideráveis, esta versão traz muito mais recursos para os blocos Gutenberg, tornando layouts antes inimagináveis sem código agora apenas à alguns cliques dos usuários. Um dos recursos mais poderosos está na criação de padrões de bloco via interface gráfica… pretendemos falar sobre isso mais adiante em um Workshop sobre as novas capacidades de edição do Gutenberg.

Como não podia deixar de ser, fizemos alguns ajustes para integrar melhor o plugin à estas novas mudanças.

Documentação da API REST

Até recentemente, nossa documentação API ficava hospedada neste link. Essa documentação, apesar de mostrar uma visão geral dos endpoints era bastante incompleta. Quase nenhum dos endpoints mostrava realmente todos os parâmetros possíveis e as possíveis saídas das requisições era bem superficial.

Por isso tomamos os últimos meses para dar uma revisão geral em todos nossos repositórios e acrescentarmos uma boa porção de documentação na nossa API, seguindo de forma mais próxima o padrão OpenAPIs. Graças à este padrão, podemos hospedar nossa documentação em ferramentas terceiras, como o famoso ReDoc, que nos permite navegar por todos os endpoints de forma muito mais completa. Assim, este será o nosso novo endereço de documentação da API, que está sendo gerado diretamente do código do plugin:

Documentação das Actions e Filters

Além disso, nossa refatoração da documentação inclui um esforço enorme para automatizar a extração de comentários do código que são usados para documentar nossas Actions e Filters, que são mecanismos pelos quais desenvolvedores podem extender ou alterar o comportamento do Tainacan seguindo o padrão de hooks do WordPress. Embora ainda haja um bom trabalho a ser feito aqui, boa parte da documentação gerada automaticamente já pode ser vista nestes dois links da Wiki:

Atualização da Paleta de Cores

Por fim, uma novidade que pode (ou não) saltar aos olhos. Estamos atualizando algumas cores da paleta de cores do painel administrativo do Tainacan. Calma, nosso azul turquesa não está indo embora! De maneira geral estamos apenas escurecendo um pouco alguns tons e fazendo ajustes de saturação para melhorar legibilidade dos elementos com um foco em melhor acessibilidade. Na figura abaixo, pode ser visto um antes e depois, onde as cores em vermelho são as novas cores:

Correções de Erro

E claro, temos algumas pequenas correções de erro, oficializando ajustes que testamos aqui na comunidade nas últimas semanas!


English:

Hello community! :wave:t3: :tainacan:

We are releasing a special version of Tainacan today. On one hand it’s full of internal code tweaks, on the other hand it probably won’t draw much attention from users. But it is an important step in the maturation of the plugin that starts to prepare the ground for future versions with more new features.

Donwload Tainacan 0.20.4 on the WordPress plugins repository.

Updating the Minimum Requirements to Run Tainacan

Over the years, it becomes difficult to ensure compatibility with different technologies and still implement new features. Relying on old libraries can also be a security risk, since there is a continuous effort to improve their security. Because of this, we are following in the footsteps of WordPress itself and other popular plugins and will be raising our minimum version requirements for running Tainacan for the first time.

Minimum expected WordPress version: 5.9

Until before this release, our minimum expected WordPress version was 5.0, the one where the Gutenberg block editor was introduced. Since then many new features have been introduced and we have tried to make incremental use of these new features, but this comes at the cost of more complex maintenance and testing. Based on the WordPress plugin ecosystem, we are now moving up the minimum version to 5.9, released in January 2022. This allows us to make the code cleaner and make use of newer WordPress features.

While we recommend always updating your WordPress, this does not mean that Tainacan will simply stop working. You can keep using version 0.20.3 while you can’t update, or you can even update while on a previous version of WordPress, but it’s important to note that new features, especially those related to the block editor, may stop working or have undesired behavior.

Minimum PHP version expected: 7.0

Another important update is the minimum PHP version requirement for 7.0. This requirement is not only ours, but also comes with the latest version of WordPress. PHP 5.6 was released in the distant year of 2014 and has been maintained with great difficulty with new versions on several servers. But the language continues to evolve a lot and today it is already in the migration phase to its version 8.0, which should bring significant improvements in performance and security. If your hosting provider has not yet updated PHP to a version higher than 7.0 (we strongly recommend 7.4), inform them about the recommendation that comes not only from our plugin but also from WordPress itself, which is also abandoning support for versions prior to 7.0:

WordPress 6.3 support

WordPress version 6.3 was released last week. To get a sense of the amazing features that have arrived in this release, it’s worth taking a look at this presentation site they made:

In addition to considerable performance gains, this version brings many more features to the Gutenberg blocks, making layouts previously unimaginable without code now just a few clicks away. One of the most powerful features is the creation of block patterns via the graphical interface… we plan to talk about this later in a Workshop on Gutenberg’s new editing capabilities.

As always, we made some adjustments to better integrate the plugin with these new changes.

REST API documentation

Until recently, our API documentation was hosted at this link. This documentation, while showing an overview of the endpoints was rather incomplete. Almost none of the endpoints really showed all the possible parameters and the possible outputs of the requests were quite superficial.

That’s why we took the last months to give a general overhaul to all our repositories and add a good portion of documentation to our API, following more closely the OpenAPIs standard. Thanks to this standard, we can host our documentation in third party tools, like the famous ReDoc, which allows us to browse all endpoints in a much more complete way. So, this will be our new API documentation address, which is being generated directly from the plugin code:

Actions and Filters documentation

In addition, our documentation refactoring includes a huge effort to automate the extraction of comments from the code that are used to document our Actions and Filters, which are mechanisms by which developers can extend or change Tainacan’s behavior following the WordPress hooks pattern. While there is still a good bit of work to be done here, much of the automatically generated documentation can already be seen in these two Wiki links:

Color Palette Update

Finally, a feature that may (or may not) jump to the eyes. We are updating some colors of the Tainacan admin panel color palette. Relax, our turquoise blue is not going away! In general, we are just darkening some tones a bit and making saturation adjustments to improve readability of elements with a focus on better accessibility. In the picture below, you can see a before and after, where the colors in red are the new colors:

Error Corrections

And of course, we have some minor bug fixes, making official the tweaks we’ve tested here in the community over the past few weeks!

3 curtidas

Já atualizando por aqui! :clap: Vida longa ao Tainacan! :muscle:

2 curtidas