So erstellen Sie benutzerdefinierte WordPress -Shortcodes für Ihre Redakteure

WordPress -Shortcode Quick -Handbuch: Einfach HTML -Komponenten einbetten, ohne zu codieren

WordPress -Shortcodes bieten den Autoren eine bequeme Möglichkeit, HTML -Komponenten in gerenderte Seiten einfügen, ohne Code zu schreiben. Diese Kurzcodes können in Plugin -Code erstellt oder in der Datei functions.php des Themas platziert werden.

Schlüsselvorteile des kurzen Code:

• Vereinfachen Sie die HTML -Einbettung: Fügen Sie einfach einen komplexen HTML -Inhalt hinzu, ohne HTML -Code direkt zu schreiben.
• Parametrisierte Anpassung: Anpassen Sie die Ausgabe von Kurzcodes durch Parameter, um flexible personalisierte Einstellungen zu erzielen.
• Nistungsfunktion: unterstützt kurze Code -Verschachtelung, um komplexere Seitenfunktionen zu erstellen.
• Effizienz verbessern: Vereinfachen Sie das Inhaltsmanagement und verbessern Sie die Effizienz der Inhalteerstellung.

Es wird empfohlen, eine kurze Code-Schnell-Lookup-Tabelle mit verschiedenen Beispielen zu erstellen, insbesondere wenn es sich um komplexe Funktionen handelt, wodurch das Content-Management bequemer und benutzerfreundlicher wird.

Kurzer Codeerstellung Ort:

Im Allgemeinen sollten Kurzcodes für benutzerdefinierte Plugins im Plugin -Code selbst platziert werden. Sie können jedoch auch die Shortcode -Definition in die Datei functions.php des Themas einstellen. Ein praktischerer Weg ist das Erstellen einer separaten Shortcodes.php -Datei und dann in Funktionen.php mit der folgenden Anweisung:

include('shortcodes.php');

Der erste "Hello World" -Kortier:

kurze Code -Definition enthält:

1. Eine Funktion, die HTML -Code -Zeichenfolge zurückgibt;
Anruf des WordPress
2. -Haken, der die Shortcode -Textdefinition an die Funktion bindet. add_shortcode()

Das grundlegendste Beispiel:

// "Hello World" 短代码
function shortcode_HelloWorld() {
  return '<p>Hello World!</p>';
}
add_shortcode('helloworld', 'shortcode_HelloWorld');

Speichern Sie die Datei und geben Sie

in die Seite oder den Artikel ein. Besuchen Sie die Seite und Sie werden sehen, dass sie durch die "Hallo Welt" ersetzt wurde. [helloworld]

kurze Codeparameter:

Kurzcodes können optionale Parameter haben, wie z. B.

Der Parameter

<code>[sitemap title='网页列表', depth=3]</code>

wird als Array an die Shortcode -Funktion als erster Parameter übergeben. Der vollständige Code zum Generieren einer Seitenhierarchie -Sitemap:

// sitemap 短代码
function shortcode_GenerateSitemap($params = array()) {

  // 默认参数
  extract(shortcode_atts(array(
    'title' => '站点地图',
    'id'    => 'sitemap',
    'depth' => 2
  ), $params));

  // 创建站点地图
  $sitemap = wp_list_pages("title_li=&depth=$depth&sort_column=menu_order&echo=0");
  if ($sitemap) {
    $sitemap =
      ($title ? "<h2 id="title">$title</h2>" : '') .
      '<ul>' . $sitemap . '</ul>';
  }

  return $sitemap;
}
add_shortcode('sitemap', 'shortcode_GenerateSitemap');

Die Funktion weist bei Bedarf Standardwerte zu Parametern zu. Die PHP shortcode_atts() -Funktion wandelt dann jeden Arraywert in tatsächliche Variablen extract(), $title und $id um. (Wenn Sie PHP 5.4 oder höher verwenden, können Sie $depth durch die kürzere [...] -Syntax ersetzen.) Add array(...) Shortcodes zu jedem Artikel oder einer beliebigen Seite hinzufügen und die Parameter nach Bedarf wie [sitemap] ändern. [sitemap depth=5]

verschachtelte BBCode -Shortcode:

BBCode (Blockboard -Code) ist ein leichtes Tag -Format, das [方括号] verwendet, um Befehle darzustellen, genau wie Standard -Shortcodes. Auf diese Weise können Shortcodes Textinhalte enthalten oder miteinander verschachtelt werden. Angenommen, Ihre Seite erfordert Referenz und gemeinsamer Aufruf zu Aktionschaltflächen. Das Erstellen eines einzelnen Shortcode ist unpraktisch, insbesondere wenn der Knopf allein oder in eine Referenz eingebettet werden kann. Wir brauchen möglicherweise HTML wie folgt:

include('shortcodes.php');

Dies kann schief gehen, wenn der Editor mit HTML sehr vertraut ist. Glücklicherweise bieten kurze Codes einen einfacheren Weg, wie:

// "Hello World" 短代码
function shortcode_HelloWorld() {
  return '<p>Hello World!</p>';
}
add_shortcode('helloworld', 'shortcode_HelloWorld');

Der Inhalt zwischen dem

dem Inhalt zwischen den Tags wird als zweiter Parameter an die Shortcode -Funktion übergeben. Wir können zwei Shortcode -Funktionen erstellen:

<code>[sitemap title='网页列表', depth=3]</code>

Bitte beachten Sie die Verwendung der do_shortcode($content) -Funktion, die weitere Shortcodes auf den Inhalt anwendet, wenn sie existiert. Kurzcodes sind einfach zu implementieren und können schnell geändert oder verbessert werden. Ich schlage vor, einen kurzen Code -Schnell -Lookup -Tabelle mit Beispielen zu erstellen, damit sich der Editor beziehen kann, wenn komplexe Funktionen benötigt werden.

(Ein Teil des Artikels wird von SiteGround gesponsert. Vielen Dank für Ihre Unterstützung für die Partner, die SitePoint ermöglicht haben.)

Das obige ist der detaillierte Inhalt vonSo erstellen Sie benutzerdefinierte WordPress -Shortcodes für Ihre Redakteure. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!