Articles

Kompletní Průvodce Vytváření Vlastní Shortcodes v WordPress

by admin

WordPress shortcodes jsou používány: 1) snížit množství kódu musíte napsat; 2) zjednodušit použití WordPress pluginy, témata, a další funkce. Chovají se jako makra, když vložíte krátký kód, je nahrazen úryvkem kódu. Může to být cokoliv.

WordPress přichází s nějaké předem definované shortcodes, jako , a jsou také součástí mnoha populárních pluginů a témat. Můžete si také vytvořit vlastní krátké kódy, abyste mohli dělat věci, jako je vytváření sloupců na vašem webu WordPress.

V tomto příspěvku, budeme vás krok-za-krokem prostřednictvím procesu vytváření a pomocí své vlastní shortcodes. Budeme vás provede celý proces vytváření nové zkrácený a ukázat vám, jak upravovat a kontrolovat zkrácený atributy a funkce.

Vezměte prosím na vědomí, že se jedná o pokročilejší příspěvek, který půjde do podrobností o tom, jak vytvořit krátké kódy. Pokud pracujete s kódem je nad vaše technické znalosti, a vy jen chcete, nejjednodušší způsob, jak začít s vytvářením a pomocí shortcodes možná budete chtít začít s zkrácený plugin.

při vytváření vlastních shortcodes, existují dvě věci, které musíte udělat:

  1. Vytvořte funkci shortcode handler. Funkce zkráceného kódu je funkce, která přijímá volitelné parametry (atributy) a vrací výsledek.
  2. zaregistrujte funkci obslužného programu shortcode. Použijte vestavěný WordPress add_shortcut funkce pro registraci vlastních shortcodes.

Příprava WordPress pro Vlastní Shortcodes

i když to není nutné, je to dobrý nápad, aby se vaše vlastní shortcodes v jejich vlastní soubor. Případně je můžete přidat do souboru functions.php.

nejprve vytvořte nový soubor s názvem custom-shortcodes.php a uložte jej do stejné složky jako soubor functions.php.

Pak, uvnitř nově vytvořeného souboru přidejte následující blok kódu:

<?php ?>

Next, otevřete functions.php souboru a přidejte následující řádek kódu:

include('custom-shortcodes.php');

Nyní jste připraveni začít přidávat vlastní krátké kódy.

základní krátké kódy

v tomto prvním příkladu vytvoříme základní zkrácený WordPress, který vloží den obrázku nezávislého avatara níže.

Vytvoření Zkrácený

první krok je vytvořit zkrácený funkce. Do souboru custom-shortcodes.php přidejte následující blok kódu:

function dotiavatar_function() { return '<img src="http://dayoftheindie.com/wp-content/uploads/avatar-simple.png" alt="doti-avatar" width="96" height="96" class="left-align" />';}

V příkladu kódu výše, dotiavatar_function vrátí funkce pre-určuje obraz s názvem avatar-simple.png.

dalším krokem je registrace s WordPress shortcode pomocí vestavěné funkce add_shortcode. Stále uvnitř custom-shortcodes.php přidejte následující řádek kódu:

add_shortcode('dotiavatar', 'dotiavatar_function');

Když se zaregistrujete zkrácený pomocí add_shortcode funkce, můžete projít na zkrácený tag ($tag) a odpovídající funkce ($func)/hák, který se bude provádět vždy, když zástupce je používá.

v tomto případě je značka zástupce dotiavatar a háček je dotiavatar_function.

Poznámka: při pojmenování značek používejte pouze malá písmena a nepoužívejte spojovníky; podtržítka jsou přijatelná.

pomocí zkráceného kódu

Nyní, když máte vytvořený a registrovaný zkrácený kód, je čas to vyzkoušet! Vždy, když chcete DOTI avatar se objeví v post obsah, můžete použít zkrácený místo:

Shortcodes s Parametry (Atributy)

V předchozím příkladu, tam nebyl moc prostor to změnit. Řekněme, že místo toho, abychom tlačili jeden obrázek, bychom chtěli být schopni nastavit, který obrázek použít pomocí parametru. Můžete to udělat přidáním některých atributů ($atts).

opět, uvnitř custom-shortcodes.php, přidat další funkce, jako:

function dotirating_function( $atts = array() ) { // set up default parameters extract(shortcode_atts(array( 'rating' => '5' ), $atts)); return "<img src=\"http://dayoftheindie.com/wp-content/uploads/$rating-star.png\" alt=\"doti-rating\" width=\"130\" height=\"188\" class=\"left-align\" />";}

funkce nad přijímá jeden parametr: rating. Pokud hodnota rating není předána, použije výchozí hodnotu řetězce 5. Provede to rozbalením pole atributů pomocí vestavěné funkce shortcode_atts a kombinací výchozích hodnot s hodnotami, které mohly být předány do funkce.

nezapomeňte se zaregistrovat na zkrácený:

add_shortcode('dotirating', 'dotirating_function');

krátký kód funkce vytvořena, a háček dodal, shortcode je nyní připraven k použití uvnitř váš příspěvek obsah:

Případně můžete vynechat rating, a prostě jít s výchozí hodnota:

A je to! Nyní víte, jak vytvořit samouzavírací krátké kódy WordPress. Ale existuje i jiný druh, který můžete vytvořit.

Obklopující Shortcodes

až do teď, jsme pracovali s self-zavírání shortcodes. Ale tam je jiný typ shortcode: obklopující shortcodes.

uzavření shortcodes vám umožní použít formát BBCode stylu. To je styl, který vypadá takto:

content

Obklopující shortcodes jsou užitečné pro když potřebujete manipulovat přiložený obsah. Řekněme například, že máte určitý styl tlačítka, které používáte na svém webu; můžete použít HTML kód generovat tlačítko/styl pokaždé, když potřebujete, aby ji používat, nebo můžete nastavit vlastní obvodových zkrácený místo.

Použitím uzavřeného krátkého kódu se můžete soustředit spíše na obsah než na kód.

Vytvoření Zkrácený

uvnitř custom-shortcodes.php souboru přidejte následující blok kódu:

function dotifollow_function( $atts, $content = null ) { return '<a href="https://twitter.com/DayOfTheIndie" target="blank" class="doti-follow">' . $content . '</a>';}

V bloku kódu výše, $content = null se používá k identifikaci této funkce jako obklopující zkrácený. A uvnitř této funkce balíte svůj obsah ($content) do HTML kódu.

OK, Nyní je čas zaregistrovat krátký Kód:

add_shortcode('dotifollow', 'dotifollow_function');

a to je vše! Váš krátký kód je připraven k použití.

Použití Zkrácený

Pomocí obvodových zkrácený není příliš odlišná, než pomocí self-zavírání. Stejně jako HTML se musíte ujistit, že máte úvodní a závěrečné prohlášení:

Follow us on Twitter!

samozřejmě je to jen základní příklad. Můžete také přidat parametry obvodových zkrácený, s self-zavírání zkrácený.

Uvnitř custom-shortcodes.php, přidá se ještě jedna funkce:

function dotibutton_function( $atts = array(), $content = null ) { // set up default parameters extract(shortcode_atts(array( 'link' => '#' ), $atts)); return '<a href="'. $link .'" target="blank" class="doti-button">' . $content . '</a>';}

A pak se zaregistrovat na zkrácený:

add_shortcode('dotibutton', 'dotibutton_function');

Tato nová funkce vám dovolí nastavit odkaz pro tlačítko pomocí následující syntaxe:

Shop Now!

S obklopující shortcodes, si můžete udělat hodně s velmi málo kódu.

Slovo O Widgety

ve výchozím nastavení, shortcodes jsou podporovány pouze na příspěvky, stránky, nebo custom post typy, které nejsou podporovány v postranní widgety. Přidat podporu pro widgety, budete muset přidat následující kód functions.php file:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Jakmile to uděláte, můžete použít shortcodes v widgety – stejně jako vy do příspěvků/stránek.

balení věcí

přidání vlastních shortcodes nevyžaduje mnoho úsilí-zvláště jakmile pochopíte, jak jsou implementovány. Pokud se chcete dozvědět více, podívejte se na kodex WordPress.