SimpleTOC – Inhaltsverzeichnis Block

FAQ

Konfiguration globaler Einstellungen in SimpleTOC.

SimpleTOC ermöglicht es dir, globale Einstellungen für deine WordPress-Website zu konfigurieren. Diese Einstellungen können global durchgesetzt werden und überschreiben mögliche Block-Level-Konfigurationen. Um auf diese Einstellungen zuzugreifen, navigiere zum SimpleTOC-Bereich der WordPress-Einstellungen.

How do I add colors or the Box style to SimpleTOC?

Select the SimpleTOC block and open Gutenberg’s Styles tab. Choose the Box style or use the native color controls to set text, link, and background colors. Native spacing controls are available for vertical margins and padding.

Wie kann man eine einzelne Überschrift aus dem TOC ausschließen?

Wenn du wirklich eine einzelne Überschrift aus dem Inhaltsverzeichnis ausblenden willst, dann füge die CSS-Klasse „simpletoc-hidden“ zu einem Überschriftenblock hinzu. Du findest dieses Feld an der gleichen Stelle wie das HTML-Ankerfeld: In der Seitenleiste Block > Erweitert. Überlege dir aber zuerst, warum du eine bestimmte Überschrift ausblenden möchtest. Vielleicht möchtest du alle Überschriften einer bestimmten Tiefenstufe entfernen. Dann gibt es dafür eine Option in den Blockoptionen in Gutenberg. Wenn du der Meinung bist, dass diese Überschrift nicht Teil des Inhaltsverzeichnisses sein sollte, wird sie vielleicht im Beitrag selbst nicht benötigt?

Ich würde gerne meine SimpleTOC-Einstellungen als Standard speichern. Ist das möglich?

Du kannst deinen konfigurierten SimpleTOC-Block in einen wiederverwendbaren Block in Gutenberg umwandeln. Er behält seine Einstellungen. Auf diese Weise kannst du deine gewünschten Einstellungen für jeden neuen Beitrag verwenden, indem du den wiederverwendbaren Block hinzufügst.

How can I style SimpleTOC through theme.json?

Add styles for the simpletoc/toc block to your theme.json. SimpleTOC uses the standard Gutenberg block wrapper and supports native colors, vertical margins, padding, font size, and line height settings.

The following example sets default colors, spacing, and typography for every SimpleTOC block:

{
    "$schema": "https://schemas.wp.org/trunk/theme.json",
    "version": 3,
    "styles": {
        "blocks": {
            "simpletoc/toc": {
                "color": {
                    "background": "#f5f5f5",
                    "text": "#1e1e1e"
                },
                "elements": {
                    "link": {
                        "color": {
                            "text": "#0057b8"
                        }
                    }
                },
                "spacing": {
                    "margin": {
                        "top": "1.5rem",
                        "bottom": "1.5rem"
                    },
                    "padding": {
                        "top": "1rem",
                        "right": "1rem",
                        "bottom": "1rem",
                        "left": "1rem"
                    }
                },
                "typography": {
                    "fontSize": "1rem",
                    "lineHeight": "1.6"
                }
            }
        }
    }
}

Replace the example values with your theme’s values or preset variables. Selecting the Box style adds the standard is-style-boxed class.

Wie kann man Entwicklern erlauben, bestimmte Überschriften programmatisch auszuschließen?

Verwende den Filter „simpletoc_excluded_blocks“. Dieser Code schließt unter anderem Überschriftenblöcke aus, die sich innerhalb eines Spaltenblocks befinden:

Beispiel:

add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) {
    $blocks[] = 'core/column';

    return $blocks;
} );

Wie kann ich die Farbe des Akkordeon-Menüs ändern?

Das heavy plus Zeichen, das ich verwendet habe, kann nicht ohne Hacks mit css eingefärbt werden. Aber Du kannst das Symbol in etwas anderes ändern und die Farbe des neuen Symbols ändern.

.simpletoc-collapsible::after {
    content: "✖";
    color: #e94c89;
}

Wie ändere ich die TOC-Überschrift ‚Inhaltsverzeichnis‘ in etwas anderes?

Ich sehe im Moment keine einfache Lösung. SimpleTOC ist nur ein Block, der in Ihrem Beitrag platziert werden kann. Wenn es ein Plugin gäbe, das Blöcke zu jedem Beitrag hinzufügt, dann wäre das die Lösung. Ich denke, dies sollte ein weiteres separates Plugin sein, um den Code von SimpleTOC sauber und … nun ja, einfach zu halten.