WordPress introduceerde de shortcode API zes jaar geleden met de release van WordPress 2.5. Shortcodes worden nu gebruikt door een groot aantal WordPress plugins om gebruikers in staat om inhoud toe te voegen aan hun berichten en pagina ‘ s.
met de shortcode API kunt u uw eigen shortcodes maken door functies aan uw themafuncties toe te voegen.php template (dit is te vinden op www.yourwebsite.com/wp-content/themes/yourtheme/).
naast het maken van uw eigen shortcodes, WordPress bevat ook vijf standaard shortcodes met de WordPress core:
- audio-Hiermee kunt u audiobestanden insluiten.
- bijschrift-Hiermee kunt u bijschriften om de inhoud heen wikkelen. Het wordt vaak gebruikt met afbeeldingen.
- embed-Hiermee kunt u een breed scala aan inhoud insluiten, zoals video, audio en tweets.
- galerij-Hiermee kunt u Afbeeldingsgalerijen invoegen.
- video-Hiermee kunt u videobestanden insluiten.
hoewel de standaard WordPress shortcodes vaak worden gebruikt, maken maar weinig WordPress-gebruikers gebruik van de shortcode API en ontwerpen ze unieke shortcodes voor hun website. In deze zelfstudie wil ik u laten zien hoe eenvoudig het is om uw website te verbeteren met aangepaste shortcodes.
voordat u begint, zorg ervoor dat u een back-up maakt van functies.php en alle andere bestanden die u bewerkt voordat u wijzigingen aanbrengt met uw live website.
het maken van een Shortcode – een Basisvoorbeeld
om u een goed begrip te geven van hoe de WordPress Shortcode API werkt, laten we beginnen met een basis shortcode functie.
onthoud dat shortcodes gemaakt moeten worden voor inhoud en functionaliteit die u vaak gebruikt. Het hele punt van het gebruik van shortcodes is om iemand tijd te besparen. Als je maar één keer iets gaat gebruiken, heeft het niet veel zin om er een shortcode voor te maken.
Ik schrijf ongeveer een dozijn artikelen per week. Een ding dat ik doe vaak is aan te moedigen degenen die genoten van mijn artikelen om zich te abonneren op mijn blog (of de blog Ik schrijf voor). Ik schrijf dit op dit moment elke keer uit, maar ik kon mezelf een hoop tijd besparen door het creëren van een shortcode voor de tekst.
om dit te doen, zou ik een functie als deze kunnen toevoegen aan de functies van mijn thema.php-sjabloon:
degenen onder u die geen coderingservaring hebben kunnen de bovenstaande code een beetje ontmoedigend vinden, maar het is gemakkelijk te begrijpen als u de code regel voor regel breekt.
het eerste wat we doen is een opmerking toevoegen boven onze functie. Dit zal ons helpen snel te zien waar onze functie voor is wanneer we de code op een later tijdstip bekijken.
// Function to add subscribe text to posts and pages
We definiëren dan onze functie. Ik gebruik graag Namen die voor zichzelf spreken, dus heb ik mijn functie “subscribe_link_shortcode”genoemd.
function subscribe_link_shortcode() {
vervolgens definiëren we ons bericht. De return statement zal ons bericht weer te geven wanneer het wordt opgeroepen. Het slaat ook de berichten op (in tegenstelling tot echo, die het zal afdrukken, maar niet opslaan).
De functie wordt dan gesloten.
}
vervolgens definiëren we de shortcode zelf met behulp van de add_shortcode functie. De eerste variabele die wordt gespecificeerd definieert de shortcode die moet worden gebruikt en de tweede variabele roept onze functie aan (dat wil zeggen degene die we hierboven hebben gedefinieerd).
add_shortcode('subscribe', 'subscribe_link_shortcode');
na het opslaan van de functies.php template, kunnen we nu bellen onze boodschap wanneer we willen met behulp van de shortcode abonneren.
het gebruik van de subscribe shortcode in een post of pagina zal het volgende bericht produceren:
Als u dit artikel leuk vond, raad ik u aan om u via RSS te abonneren op de Elegant Themes blog.
Ik heb een eenvoudig bericht gebruikt in mijn voorbeeld, maar u kunt dit aanpassen om veel andere dingen weer te geven. U kunt bijvoorbeeld een shortcode maken voor het weergeven van AdSense-advertenties of een inschrijfformulier voor uw nieuwsbrief; en deze vervolgens overal invoegen waar u maar wilt in uw artikelen.
het maken van een Shortcode met attributen
attributen kunnen de functionaliteit van shortcodes uitbreiden door u toe te staan gegevens door uw shortcodes te geven.
in het voorbeeld hieronder zal ik u laten zien hoe attributen kunnen worden gebruikt om de functie die we eerder hebben gemaakt uit te breiden. Zoals je kunt zien, blijft veel van de code hetzelfde.
$atts is de naam van onze attribuutarray. Vervolgens gebruiken we de extractfunctie om variabelen uit onze array te importeren (via de Shortcode_atts WordPress functie).
twee attributen worden dan gedefinieerd: subtype en en subtypeurl. Deze vertegenwoordigen het type abonnement en de URL van het abonnement. Deze attributen worden dan aangeroepen in onze boodschap.
ons standaard abonnement type is RSS en onze standaard abonnement URL is http://feeds.feedburner.com/ElegantThemes. Deze informatie wordt weergegeven wanneer er geen attributen zijn gedefinieerd.
Daarom, wanneer u het volgende toevoegt aan een post:
krijgen we de volgende uitvoer:
schrijf u in op toekomstige elegante thema ‘ s updates door RSS.
als we attributen definiëren, is het resultaat anders. De volgende code:
zou uitvoeren:
zorg ervoor dat u zich abonneert op toekomstige elegante thema ‘ s updates door RSS.zorg ervoor dat u zich abonneert op toekomstige Elegant Themes updates door Twitter.zorg ervoor dat u zich abonneert op toekomstige Elegant Themes updates door Facebook.zorg ervoor dat u zich abonneert op toekomstige Elegant Themes updates van Google.
hoewel dit een basisvoorbeeld was van hoe attributen werken, is het gemakkelijk te zien hoe plugin-ontwikkelaars de shortcode API kunnen gebruiken om ingewikkelde functies gebruiksvriendelijker te maken voor gebruikers.
overzicht
Als u de stappen in deze tutorial volgt, moet u nu een basiskennis hebben van hoe u uw eigen aangepaste shortcodes voor uw website kunt maken. Shortcodes zijn een geweldige manier om ingewikkelde taken eenvoudiger te maken, dus ik moedig u aan om de WordPress shortcode API in gedachten te houden in de toekomst.
maak je geen zorgen als deze tutorial een beetje moeilijk voor je was. Alle elegante thema ‘ s ontwerpen komen verpakt met shortcodes die het publiceren van mooie inhoud gemakkelijk te maken. De shortcodes kunnen worden gebruikt om diavoorstellingen, kolommen en tabellen te maken. Hiermee kunt u zelfs uw inhoud met een wachtwoord beveiligen.
Ik hoop dat u deze tutorial hebt genoten over het maken van een unieke shortcode voor uw WordPress website. Als dat zo is, moedig ik je aan om je te abonneren op elegante thema ‘ s omdat we een aantal geweldige content in de pijplijn hebben 🙂
ook herinner ik je eraan om een back-up te maken van alle bestanden voordat je ze bewerkt.