Descrição
Add a Table of Contents block to your posts and pages. The TOC is a nested list of links to all heading found in the post or page. To use it, simply add a block and search for “SimpleTOC” or just “TOC”.
The maximum depth of the toc can be configured in in the blocks’ sidebar among many other options. There can hide the headline “Table of Contents” and add your own by using a normal heading block.
Rode uma nova instância do WordPress com o plugin SimpleTOC já instalado.
User Feedback
“It is lightweight, stable, and fully compatible with WordPress Full Site Editing. A reliable solution that integrates seamlessly and performs exactly as expected.”
— @js100 on wordpress.org“Does the job perfectly, and adds no bloat.”
— @clicknathan on wordpress.org“Simple yet powerful. Great plugin that does exactly what you need.”
— @mixey on wordpress.org
Acessibilidade
This plugin is designed & developed for WCAG 2.2 level AA conformance. The plugin is tested with assistive technology and intended to be accessible, however some third party plugins or themes may affect the individual accessibility on a given website. If you find an accessibility issue, please let us know and we’ll try to address it promptly.
Recursos
- Projetado para Gutenberg
- Zero configuration: Add the SimpleTOC block to your post and that’s it.
- Saída HTML mínima e válida.
- Utiliza a tag de detalhes incorporada do navegador para uma interface que pode ser expandida e recolhida.
- Nenhum JavaScript ou CSS é adicionado. A menos que você ative o menu sanfona.
- Style SimpleTOC with Gutenberg’s native group styling options.
- Herda o estilo do seu tema.
- Efeito de rolagem suave usando CSS.
- Accessibility built-in by following web standards.
- Rótulo ARIA opcional e atributos de função de navegação.
- Translated in multiple languages. Including German, Japanese, Chinese (Taiwan), Dutch, Brazilian Portuguese, French, Spanish and Latvia.
- Ideal para criar uma seção de perguntas frequentes no seu site.
Customization
- Os administradores podem utilizar as configurações globais para substituir as configurações de blocos individuais.
- Add background and text color with Gutenberg groups.
- Native block support for wide and full width.
- Controle a profundidade máxima dos títulos.
- Escolha entre uma lista HTML ordenada e com marcadores. Ou recue a lista.
- Selecione um nível de título ou transforme-o em um parágrafo.
- Disable the h2 heading of the TOC block and add your own.
Compatibility
- GeneratePress and Rank Math support.
- Works with popular AMP plugins.
How to contribute
SimpleTOC is open-source and developed on GitHub Pages. If you find a bug or have an idea for a feature please feel free to contribute and create a pull request.
Créditos
Este plugin é uma bifurcação do pdewouters e usa código do Easy-Table-of-Contents
Muito obrigado a Tom J Nowell e Sally CJ, que me ajudaram muito com minhas perguntas no wordpress.stackexchange.com
And many more thanks to all the developers on GitHub who helped me making SimpleTOC what it is today!
Thanks to Quintus Valerius Soranus for inventing the Table of Contents around 100 BC.
Capturas de tela
Bloco do SimpleTOC no editor do Gutenberg. 
SimpleTOC no post. 
Simples, mas poderoso. Personalize cada sumário como desejar. 
Controle a profundidade máxima dos títulos. 
SimpleTOC estilizado com os estilos de grupo nativos do Gutenberg. 
Recursos Avançados do SimpleTOC 
Bloco de Título do Gutenberg: Definir uma âncora personalizada 
SimpleTOC escondido no menu sanfona. 
Configurações globais do SimpleTOC.
Blocos
Este plugin disponibiliza 1 bloco.
- SimpleTOC Adds a Table of Contents.
Instalação
SimpleTOC pode ser encontrado e instalado através do menu Plugin na administração do WordPress (Plugins -> Adicionar Novo). Como alternativa, ele pode ser baixado do WordPress.org e instalado manualmente…
No Gutenberg, adicione um bloco e pesquise “SimpleTOC” ou apenas “TOC”. Salve seu conteúdo antes de usar o bloco.
Perguntas frequentes
-
Configurando as configurações globais no SimpleTOC
-
O SimpleTOC permite que você defina configurações globais para o seu site em WordPress. Essas configurações podem ser aplicadas globalmente, sobrepondo-se a quaisquer configurações em nível de bloco que possam existir. Para acessar essas configurações, navegue até a seção SimpleTOC das configurações do WordPress.
-
How do I add a background color to SimpleTOC using Gutenberg groups?
-
Select the block and select “group” in the context menu. Apply “background color”, “link color” and “text color” to this group. SimpleTOC will inherit these styles. You would like to use this styled SimpleTOC group next time you write a post? Convert it to a reusable block.
-
Como excluir um único título do Sumário?
-
Se você realmente quiser ocultar um único título do sumário, então adicione a classe CSS “simpletoc-hidden” a um bloco de título. Você pode encontrar este campo no mesmo lugar que o campo âncora HTML: Na barra lateral Bloco > Avançado. Mas primeiro, pense no motivo pelo qual você gostaria de esconder um título específico. Talvez você queira remover todos os títulos de um nível de profundidade específico. Então há uma opção para isso nas opções de blocos no Gutenberg. Se você acha que este título não deve fazer parte do sumário, talvez não seja necessário no próprio post?
-
Eu gostaria de salvar minhas configurações do SimpleTOC como padrão. Isso é possível?
-
Você pode converter o seu bloco SimpleTOC configurado em um bloco reutilizável no Gutenberg. Ele manterá suas configurações. Dessa forma, você pode usar as configurações desejadas para cada novo post adicionando o bloco reutilizável.
-
Como adicionar uma tag div de invólucro ao Sumário?
-
Se você adicionar uma classe personalizada ao bloco SimpleTOC em “Avançado” e então em “Classes CSS adicionais”, uma div com essa classe será envolvida na saída HTML.
-
Como permitir que os desenvolvedores excluam títulos específicos de forma programática?
-
Use o filtro ‘simpletoc_excluded_blocks’. Por exemplo, esse código irá excluir blocos de títulos que estão dentro de um bloco de coluna.
Exemplo:
add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) { $blocks[] = 'core/column'; return $blocks; } ); -
O personagem heavy plus que eu usei não pode ser colorido com css sem hacks. Mas você pode alterar o ícone para outra coisa e alterar a cor do novo ícone.
.simpletoc-collapsible::after { content: "✖"; color: #e94c89; } -
Como adicionar o SimpleTOC a todos os artigos automaticamente?
-
Não vejo uma solução fácil no momento. O SimpleTOC é apenas um bloco que pode ser colocado no seu post. Se houvesse um plugin que adicionasse blocos a todas os posts, então essa seria a solução. Acho que isso deveria ser um plugin separado para manter o código do SimpleTOC limpo e… bem, simples.
Avaliações
Colaboradores e desenvolvedores
“SimpleTOC – Bloco de sumário” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
Colaboradores
SimpleTOC – Bloco de sumário” foi traduzido para 17 localidades. Agradecemos aos tradutores por suas contribuições.
Traduzir o “SimpleTOC – Bloco de sumário” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
6.9.6
- Added: Coding standards cleanup with improved rules, cleaner code, safer output, and consistent naming. Thanks @ronalfy
- Added: Minimum PHP version requirement set to 7.3
6.9.4
- Added: Introduced proper PHP namespaces to avoid class and function name conflicts and improve overall code robustness. Thanks @ronalfy.
- Added: Improved sidebar sub-menu for the “Hide SimpleTOC” option
6.9.3
- Fix: Fix Multiple IDs in Table of Contents Thanks @ronalfy
- Added: Support for GenerateBlocks 2.1.0 Thanks @ronalfy
6.9.1
- Added: Support for the new V3 block api.
- Added: Tested compatibility with WordPress 6.9
6.7.3
- Added: Tested compatibility with WordPress 6.8
6.7.2
- Added: Support for GenerateBlocks 2.0. Thanks @blronaldhuereca
- Added: Included an accessibility statement in the plugin description. Thanks Gen Herres.
