Share
Die WordPress Shortcode-API wurde in Version 2.5 in WordPress eingeführt. Seitdem ist es eine weit verbreitete Methode, um das Layout schnell anzupassen und bestimmte Formatierungsausschnitte einzufügen. Shortcodes können jedoch ebenso nützlich sein, wenn Sie WordPress-Themes erstellen. So können Sie sie vollständig nutzen!
Shortcodes haben viele Vorteile, wenn sie ordnungsgemäß in Themendateien verwendet werden. Wenn Sie mit Präprozessor-Makros in C / C ++ vertraut sind, können Shortcodes eine ähnliche Funktion in WordPress erfüllen. Der grundlegende Zweck der Verwendung eines Shortcodes besteht darin, den Platzhalter durch Ihren eigenen benutzerdefinierten HTML-Code zu ersetzen, wenn der Server die Seite an den Client sendet. Die Schritte zum Erstellen und Implementieren von Kurzwahlen sind wie folgt.
In diesem Quick Tip verwenden wir Kurzcodes, um benutzerdefinierte Beiträge anzuzeigen. Ich habe ausführlich erklärt, wie Sie benutzerdefinierte Post-Typen erstellen und leere Motive bei Nettuts + verwenden. In diesem Beispiel ändern wir jedoch das von WordPress bereitgestellte Standard-TwentyTen-Design.
Die Funktion, die Sie für Ihren Shortcode erstellen, bestimmt den Zweck des Shortcodes. Eine grundlegende Funktion kann auf folgende Weise definiert werden (Sie können den gesamten Code unten in Ihrer Datei "functions.php" hinzufügen):
Accentsconagua
// Definieren der Funktion zum Anzeigen der benutzerdefinierten Projektbuchung. function project_shortcode ($ atts) // Extrahieren der Argumente für den Kurzcode. extrahieren (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * Hier schreiben wir den Code zum Abrufen von Daten * und erstellen die HTML-Struktur, die in der $ -Ausgabevariable zurückgegeben werden soll. * / $ Output = 'Dies enthält die endgültige HTML-Ausgabe für Ihre benutzerdefinierte Projektschleife.'; return $ output; Stellen Sie sicher, dass Sie am Ende der Datei functions.php kein Leerzeichen hinterlassen, da dies zu Problemen führen kann. Fügen wir nun etwas Code hinzu, um das benutzerdefinierte Post 'project' abzurufen und die HTML-Struktur zu erstellen, die unseren Shortcode ersetzt.
function project_shortcode ($ atts) extract (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); // Benutzerdefinierte Abfrage erstellen, um den benutzerdefinierten Beitrag des Projekttyps abzurufen. $ loop = new WP_Query (array ('post_type' => 'project', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Durchlaufen Sie die Posts und erstellen Sie die HTML-Struktur. if ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ output. = ''.get_the_title ().'
'; $ output. = ''.get_the_excerpt ().''; else $ output = 'Leider noch keine Projekte. Komm bald wieder.'; // Jetzt geben wir den HTML-Code an die Stelle zurück, von der aus der Shortcode aufgerufen wurde. return $ output; Die '$ atts' sind die Attribute, die zusammen mit dem Shortcode bereitgestellt werden. Die Extraktionsmethode von PHP wird verwendet, um die Array-Elemente in Variablen aufzuteilen, sodass sie direkt in der Funktion verwendet werden können.
In diesem Beispiel verwenden wir die in der Funktion übergebenen Attribute, um eine benutzerdefinierte Abfrage zum Abrufen der benutzerdefinierten Post-Daten des Projekts "Projekt" zu erstellen. Dann durchlaufen wir alle zurückgegebenen Projektbeiträge.
Innerhalb der Schleife rufen wir die Daten mit den entsprechenden HTML-Tags ab und hängen sie an die Ausgabevariable an. Wenn die Schleife abgeschlossen ist, enthält die Ausgabevariable den vollständigen HTML-Code für unsere Projektliste. Dieser HTML-Code wird zurückgegeben und der im Design verwendete Kurzcode wird beim Laden der Seite durch diesen Code ersetzt.
Nachdem wir die Funktion erstellt haben, müssen wir sie zusammen mit dem Shortcode, der für sie verwendet wird, in der Datenbank registrieren. Das können wir mit der
register_shortcode-Methode von WordPress.
add_shortcode ('projects', 'project_shortcode'); Das erste Argument in dieser Methode ist der Name des Shortcodes, den wir im Design verwenden werden, und das zweite Argument ist der Name der Funktion (die wir oben definiert haben), die sich auf diesen Shortcode bezieht. So weiß WordPress, was zu tun ist, wenn der Shortcode analysiert wird.
WordPress bietet eine Shortcode-Parsing-Methode, die nur sehr wenige Entwickler in Erwägung ziehen, all dies oft zu verwenden. Die Methode do_shortcode kann verwendet werden, um Shortcodes in Themendateien selbst einzufügen.
Die Shortcode-Syntax ähnelt derjenigen, die Sie im Backend-Editor einfügen würden. In diesem Fall übergeben wir die Attribute für die Begrenzung der Anzahl der anzuzeigenden Beiträge und deren Reihenfolge. Da wir benutzerdefinierte Projekt-Posts anzeigen, erstellen wir eine neue dedizierte Seitenvorlage und verwenden den Kurzcode. Erstellen Sie eine Vorlage mit dem Namen "page-project.php", und verwenden Sie Folgendes:
Um die soeben erstellte Vorlage anzuzeigen, erstellen Sie eine Seite mit dem Namen "Projekt". Offensichtlich auch einige Demo-Projekt-Beiträge erstellen!
Voila! Der Funktionscode zeigt die benutzerdefinierten Beiträge erfolgreich an.
Wie Sie sehen, hilft uns die obige Methode, einen Shortcode für benutzerdefinierte Beiträge zu erstellen und in unserem Thema zu verwenden, die Designdateien überschaubar und sauber zu halten. Dies hat auch den zusätzlichen Vorteil, dass jeder die benutzerdefinierte Nachschleife aus dem WordPress-Backend-Editor einfügen kann.
Das obige Beispiel zeigt, wie Shortcodes während der Themenentwicklung effizient verwendet werden können. Es gibt viele innovative und produktive Möglichkeiten, Shortcodes in WordPress-Themes zu verwenden. Teilen Sie Ihre eigenen Ideen in den Kommentaren mit!
