Share
WordPress Shortcode API introducerades till WordPress i Version 2.5. Sedan dess har det blivit en allmänt använd metod för att möjliggöra snabb anpassning av layout och införande av vissa formateringsutdrag. Men kortkoder kan vara lika användbara när du skapar WordPress-teman - här är hur du kan utnyttja dem fullständigt!
Kortnummer har många fördelar om de används korrekt i temafiler. Om du är bekant med preprocessormakroner i C / C ++, kan kortkodar tjäna en något liknande funktion i WordPress. Det grundläggande syftet med att använda en kortnummer är att ersätta platshållaren med din egen HTML-kod när servern skickar sidan till klientsidan. Stegen involverade i skapandet och genomförandet av kortkoder är som följer.
I denna Snabba Tips ska vi använda kortnummer för att visa egna inlägg. Jag har gett en detaljerad förklaring om hur man skapar egna posttyper och använder tomma teman på Nettuts +, men för det här exemplet kommer vi att ändra standard TwentyTen-temat som tillhandahålls av WordPress.
Funktionen som du skapar för din kortnummer definierar faktiskt syftet med kortnumret. En grundläggande funktion kan definieras på följande sätt (du kan lägga till all kod längst ner i din functions.php-fil):
Accentsconagua
// Definiera funktionen som används för att visa den anpassade projektposten. funktion project_shortcode ($ atts) // Att extrahera argumenten för kortkoden. extrakt (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * Det här är var vi ska skriva koden för att hämta data * och bygga HTML-strukturen som ska returneras i $ output-variabeln. * / $ Output = 'Detta kommer att innehålla den slutliga HTML-utmatningen för din anpassade projektslinga.'; returnera $ output; Var noga med att inte lämna någon whitespace i slutet av functions.php-filen eftersom det kan orsaka problem. Låt oss nu lägga till en kod för att hämta det anpassade inlägget "projektet" och bygga HTML-strukturen som ersätter vår kortnummer.
funktion project_shortcode ($ atts) extrakt (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); // Skapa anpassad fråga för att hämta projekttypen anpassad post. $ loop = ny WP_Query (array ('post_type' => 'project', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Looping genom inlägg och bygga HTML-strukturen. om ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ output. = ''.Get_the_title ().'
'; $ output. = ''.Get_the_excerpt ().''; else $ output = 'Tyvärr, inga projekt ännu. Kom tillbaka snart.'; // Nu returnerar vi HTML-koden tillbaka till den plats där kortkoden heter. returnera $ output; '$ Atts' är de attribut som lämnas tillsammans med kortnumret. PHPs extraktmetod används för att dela upp arrayelementen i variabler så att de kan användas direkt i funktionen.
I det här exemplet använder vi attributen som passerade i funktionen för att skapa en anpassad fråga för att hämta "projekt" anpassade postdata. Sedan går vi igenom alla de inlämnade projektposterna.
Inom slingan hämtar vi och adderar data till utgångsvariabeln med lämpliga HTML-taggar. När slingan är klar innehåller utmatningsvariabelen den fullständiga HTML-koden för vår projektlista. Denna HTML-kod returneras och den kortnummer som används i temat ersätts av detta när sidan laddas.
Nu när vi har skapat funktionen måste vi registrera den i databasen tillsammans med den kortnummer som ska användas för den. Vi kan göra detta med
register_shortcode metod som tillhandahålls av WordPress.
add_shortcode ( 'projekt', 'project_shortcode');
Det första argumentet i denna metod är namnet på den kortnummer som vi kommer att använda i temat, och det andra argumentet är namnet på den funktion (som vi definierade ovan) som hänför sig till den kortnummer. Så här vet WordPress vad man ska göra när den korta koden analyseras eller stöter på.
WordPress tillhandahåller en shortcode parsing metod som mycket få utvecklare anser att använda allt som ofta. Metoden do_shortcode kan användas för att infoga kortkoder i temafilerna själva.
Kortkortsyntaxen liknar vad du skulle infoga i backendredigeraren. I det här fallet passerar vi attributen för gränsen för antalet inlägg som ska visas och hur man beställer dem. När vi visar "projekt" anpassade inlägg skapar vi en ny dedikerad sidmall och använder kortnumret i det. Skapa en mall som heter 'page-project.php' och använd följande:
Nu för att visa mallen som du just skapat, skapa en sida som heter "Projekt". Självklart skapa några demo "Project" inlägg också!
Voila! Kortkoden visar de anpassade inläggen framgångsrikt.
Som du kan se, hjälper ovanstående metod att skapa en kortnummer för anpassade inlägg och använda dem i vårt tema oss att hålla temafilerna hanterbara och rena. Detta har också en extra fördel att vem som helst kan infoga den anpassade postslingan från WordPress backendredigeraren också.
Ovanstående exempel visar hur vi kan använda kortkoder under temat utveckling på ett effektivt sätt. Det finns många innovativa och produktiva sätt att använda kortnummer i WordPress-teman - var god dela med dig av dina egna idéer i kommentarerna!
