Jak stworzyć własny shortcode w WordPress

Shortcode to prosty sposób na wstawianie dynamicznej treści w dowolnym miejscu strony lub wpisu w WordPress. Dzięki niemu możesz dodawać np. formularze, listy produktów czy specjalne komunikaty bez ręcznego pisania HTML za każdym razem.

1. Czym jest shortcode?

Shortcode to skrót w nawiasach kwadratowych, np. [moj_shortcode], który WordPress zamienia na określoną treść. Można go wstawić do edytora treści lub plików szablonu.

2. Tworzenie prostego shortcodu

Aby utworzyć swój shortcode:

1. Otwórz plik functions.php aktywnego motywu lub stwórz własną wtyczkę.
2. Dodaj poniższy kod:

function moj_shortcode_funkcja() {
    return "<p>Witaj, to jest mój pierwszy shortcode!</p>";
}
add_shortcode('moj_shortcode', 'moj_shortcode_funkcja');

Teraz możesz użyć [moj_shortcode] w treści wpisu, a WordPress wstawi przygotowany tekst.

3. Shortcode z parametrami

Możesz sprawić, by shortcode przyjmował parametry:

function powitanie_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'imie' => 'Gościu'
        ), 
        $atts, 
        'powitanie'
    );
    return "Witaj, {$atts['imie']}!";
}
add_shortcode('powitanie', 'powitanie_shortcode');

Przykład użycia:

[powitanie imie="Kasia"]

Wynik:

Witaj, Kasia!

4. Shortcode z dynamiczną treścią

Możesz też obsługiwać treść umieszczoną między znacznikami shortcodu:

function ramka_shortcode($atts, $content = null) {
    return "<div style='border:2px solid #333; padding:10px;'>" . do_shortcode($content) . "</div>";
}
add_shortcode('ramka', 'ramka_shortcode');

Przykład:

[ramka]To jest tekst w ramce[/ramka]

5. Gdzie używać shortcodów?

• W treści wpisów i stron
• W widgetach tekstowych
• W plikach PHP motywu (np. echo do_shortcode('[moj_shortcode]');)

Podsumowanie

Shortcody to potężne narzędzie dla programistów WordPress. Pozwalają w prosty sposób dodawać dynamiczne elementy do treści bez modyfikowania motywu za każdym razem.