Weet je niet helemaal wat het WordPress functions.php bestand is of wat je ermee kunt doen?
Heel kort door de bocht geeft het WordPress functions.php bestand je een manier om codefragmenten, ook wel snippets genoemend, aan je site toe te voegen. Je kunt deze snippets op allerlei nuttige manieren gebruiken, dus snappen hoe het functions.php bestand werkt kan je helpen een betere WordPress site te bouwen.
In onze ultieme handleiding voor het WordPress functions.php bestand leer je alles wat je over dit bestand moet weten.
Zodra je alles weet over het functions.php bestand, delen we ook 17 handige functions.php codesnippets om je te helpen met het aanpassen van je site.
Wat doet het WordPress functions.php bestand?
Het WordPress functions.php bestand is een themabestand dat je kunt gebruiken om je eigen codesnippets aan je site toe te voegen. Je kunt deze stukjes code gebruiken om de werking van verschillende delen van je site aan te passen of om nieuwe content/code aan je site toe te voegen.
Ondanks dat het WordPress functions.php bestand is opgenomen in je thema, is het niet beperkt tot het maken van aanpassingen aan je thema.
Je kunt aanpassingen maken aan elk onderdeel van je site, vergelijkbaar met hoe plugins werken.
Hier zijn enkele veel voorkomende soorten aanpassingen die je kunt maken met het WordPress functions.php bestand:
- Verander het gedrag van de WordPress core, zoals hoeveel berichten je op de pagina met zoekresultaten moet tonen of welke content je in de RSS feed van je site moet opnemen.
- Maak je eigen custom shortcodes.
- Voeg nieuwe content of scripts aan je site toe, zoals een script van je live chatdienst op bepaalde pagina’s injecteren of de footer van je site bewerken.
En dat is nog maar het begin..
Omdat je met het bestand functions.php custom PHP codesnippets aan je site kunt toevoegen in plaats van statische HTML, is de sky the limit als het gaat om de soorten aanpassingen die je kunt maken.
Waar bevindt het WordPress functions.php bestand zich?
Het WordPress functions.php bestand bevindt zich in de map van je actieve thema, samen met andere themabestanden. Om het bestand te vinden kun je met FTP of een programma voor bestandsbeheer verbinding maken met je server en bladeren naar …/wp-content/themes/[active-theme-name]/functions.php
Als je bijvoorbeeld het populaire OceanWP thema gebruikt, staat het bestand functions.php op …/wp-content/themes/oceanwp/functions.php
Zo werk je veilig met het functions.php bestand
Omdat het werken met het WordPress functions.php bestand het toevoegen van code aan je website inhoudt, is het belangrijk om wat best practices te volgen voordat je wijzigingen aanbrengt.
Zelfs iets simpels als een ontbrekende komma of apostrof kan fouten op je site veroorzaken, zoals het WordPress White Screen of Death.
In recente versies van WordPress is WordPress beter geworden in het afhandelen van deze fouten, zoals het tonen van het bericht “There has been a critical error on your website” of het controleren op PHP fouten voordat je je wijzigingen opslaat.
Maar toch – om problemen te voorkomen raden we altijd aan deze best practices te volgen..
Test je functions.php code op een testsite
Voordat je functies.php codesnippets toevoegt aan je live WordPress site, raden we altijd aan ze eerst te testen op een testversie van je site. Zo kun je eventuele fouten opsporen en controleren of het codefragment werkt zoals bedoeld.
Als je host bij Kinsta, biedt Kinsta een eenvoudige 1-click testtool op alle abonnementen, wat een van de voordelen is van het gebruik van managed WordPress hosting.
Als je elders host, kun je onze handleiding bekijken over het opzetten van een WordPress testsite.
Maak een backup van je site voordat je wijzigingen aanbrengt in functions.php
Naast het testen op een testsite wil je ook een backup maken van je live website voordat je het codefragment toevoegt aan het functions.php bestand van je live site.
Dit is een goed gebruik om te volgen bij het bewerken van WordPress bestanden.
Als er iets mis gaat met het codesnippet, kun je naar dit backuppunt terugkeren om je site direct weer werkend te krijgen.
Als je bij Kinsta host, maakt Kinsta elke dag automatisch een backup van je site en je kunt ook op elk moment handmatig een backup maken. Als je elders host, kun je onze handleiding lezen over het maken van een backup van een WordPress site.
Gebruik altijd een childthema als je het functions.php bestand bewerkt
Omdat het WordPress functions.php bestand in de code van je WordPress thema staat, zal je thema het functions.php bestand overschrijven als je je thema bijwerkt.
Om te voorkomen dat de wijzigingen die je in het functions.php bestand van je thema hebt aangebracht worden overschreven, moet je altijd een WordPress childthema gebruiken en je codesnippets toevoegen aan het functions.php bestand in het child thema.
Door een child thema te gebruiken, kun je nog steeds het parent thema bijwerken wanneer dat nodig is, maar al je functies.php aanpassingen zullen nooit overschreven worden.
Bekijk voor meer informatie onze volledige handleiding over het maken van een WordPress child hema.
De 2 alternatieven voor het functions.php die misschien beter zijn
Hoewel het WordPress functions.php bestand een gemakkelijke manier is om codesnippets aan je site toe te voegen, zijn er enkele functions.php alternatieven die in de meeste situaties een betere oplossing bieden:
- Een codemanagerplugin gebruiken
- Codesnippets opslaan in een custom plugin
Deze alternatieven kunnen een paar voordelen hebben ten opzichte van het gebruik van het functions.php bestand:
- Niet gebonden aan je thema – dit betekent dat als je ooit van thema verandert, je functions.php aanpassingen er nog steeds zijn.
- Betere organisatie – deze alternatieven maken het gemakkelijker om je codesnippets te organiseren, wat handig kan zijn als je van plan bent veel codesnippets aan je site toe te voegen.
- Meer controle – in het geval van een codemanagerplugin krijg je handige opties zoals het in- en uitschakelen van een snippet met een toggleknop, alleen snippets uitvoeren op de frontend of backend, en meer.
Een codemanagerplugin gebruiken
Een codemanagerplugin is een plugin die je een gebruiksvriendelijke interface geeft om code snippets toe te voegen en te bewerken die anders in het functions.php bestand zouden komen.
Een van de populairste opties is de gratis Code Snippets plugin, maar je kunt ook andere plugins vinden die vergelijkbare functionaliteit bieden.
Met Code Snippets kun je je functions.php codesnippets toevoegen vanuit het dashboard van WordPress, compleet met opties om..
- Een titel en beschrijving toe te voegen.
- Je snippets te organiseren met behulp van tags.
- De snippet alleen op een bepaald deel van je site uit te voeren.
Je kunt dan al je snippets in een lijst zien en ze gemakkelijk in- en uitschakelen als dat nodig is.
Omdat Code Snippets een plugin is, blijven al je codesnippets bestaan, zelfs als je van WordPress thema’s verandert.
Je eigen plugin schrijven
Een ander alternatief voor het WordPress functions.php bestand is om gewoon je eigen aangepaste plugin te maken om de codesnippets in onder te brengen.
Hoewel dit ingewikkeld klinkt, is het eigenlijk veel eenvoudiger dan het lijkt.
Dit is hoe het werkt:
- Maak een map aan op je lokale computer voor je plugin.
- Maak een .php bestand in die map en bewerk het met je favoriete teksteditor.
- Voeg het onderstaande codetemplate toe aan het bestand.
- Voeg je functions.php codesnippets toe aan het bestand
<?php
/**
* Plugin Name: My Custom Code Snippets
* Description: This is a custom plugin to house code snippets.
* Author: Kinsta
* Version: 1.0
*/
/* Add the first code snippet below this comment - use the comment to explain what it does. */
[CODE]
/* Add the second code snippet below this comment. */
[CODE]
/* Continue as needed. */
[CODE]
?>
Daarna hoef je de plugin alleen nog maar te installeren en te activeren op WordPress. Hier zijn 2 manieren om dat te doen:
- Maak via FTP/SFTP verbinding met je server en upload de aangepaste pluginmap naar de map wp-content/plugins. Ga dan naar de Plugins lijst en activeer de plugin.
- Gebruik je computer om een .zip bestand van de map te maken. Ga dan naar Plugins → Add New en upload het .zip-bestand om het net als elke andere plugin te installeren.
Zo krijg je toegang tot het WordPress functions.php bestand: 2 opties
Er zijn verschillende manieren waarop je het WordPress functions.php bestand kunt openen en bewerken. Hier zijn 2 van de meest veelzijdige methoden die op elke host werken:
- De Theme Editor in het WordPress dashboard.
- SFTP en je eigen code-editor.
1. Gebruik de Theme Editor in het WordPress dashboard
Standaard kun je met WordPress alle code van je thema bewerken vanuit je WordPress dashboard, inclusief het functions.php bestand:
- Open je WordPress dashboard.
- Ga naar Appearance → Theme File Editor.
- Selecteer het Theme Functions (functions.php) bestand in de lijst Theme Files aan de rechterkant.
- Voeg je bewerkingen toe in de code-editor.
- Klik op de knop Update File om je wijzigingen op te slaan.
Dat gezegd hebbende, veel mensen vinden het prettig om bestandsbewerking in het dashboard van WordPress uit te schakelen om de veiligheid te verbeteren. In dat geval kun je de volgende methode gebruiken.
2. Gebruik SFTP + je eigen code editor
Voor een andere manier om het WordPress functions.php bestand te bewerken, kun je via FTP/SFTP verbinding maken met je server en het bestand op die manier bewerken.
Hier zie je hoe:
- Download een FTP client als je dat nog niet hebt gedaan – we gebruiken de gratis FileZilla client voor de screenshots.
- Maak verbinding met je server met je FTP credentials – hier lees je hoe je SFTP gebruikt om verbinding te maken.
- Gebruik de mappenstructuur om te navigeren naar …/wp-content/themes/[jouw-actieve-childthema]
- Rechtsklik op het bestand functions.php en kies Edit.
Dit downloadt het bestand naar je lokale computer en opent het automatisch in een teksteditor. Je kunt nu je codesnippets aan het bestand toevoegen.
Als je klaar bent, sla dan je wijzigingen op en sluit het bestand.
FileZilla zou dan een vraag moeten tonen om de bewerkte versie opnieuw naar je server te uploaden.
De beste handige functies om toe te voegen aan je WordPress functions.php bestand
Nu je weet hoe je het WordPress functions.php bestand bewerkt, laten we enkele van de nuttigste functions.php codesnippets bekijken die je aan je site kunt toevoegen.
De “Laatst gewijzigd” datum tonen bij blogberichten
Standaard tonen de meeste thema’s de datum waarop je een blogbericht hebt gepubliceerd. Maar als je regelmatig oude content bijwerkt en ververst, wil je misschien ook de laatst gewijzigde datum tonen (of de publicatiedatum vervangen door de laatst gewijzigde datum).
Niet alleen laat dit je menselijke bezoekers weten dat je de content nog steeds bijwerkt, maar het laat ook Google zien dat je content vers is.
function show_last_updated( $content ) {
$u_time = get_the_time('U');
$u_modified_time = get_the_modified_time('U');
if ($u_modified_time >= $u_time + 86400) {
$updated_date = get_the_modified_time('F jS, Y');
$updated_time = get_the_modified_time('h:i a');
$custom_content .= '<p class="last-updated-date">Recently updated on '. $updated_date . ' at '. $updated_time .'</p>';
}
$custom_content .= $content;
return $custom_content;
}
add_filter( 'the_content', 'show_last_updated' );
Bekijk voor meer details ons volledige bericht Het tonen van “Laatst bijgewerkt” datum in WordPress.
De WordPress toolbar uitschakelen voor bepaalde gebruikers
Standaard toont WordPress de WordPress werkbalk voor alle ingelogde gebruikers die de ingebouwde WordPress gebruikersrollen gebruiken. Dit is niet noodzakelijkerwijs het geval voor aangepaste rollen, zoals de gebruikersrol Klant voor WooCommerce winkels.
Als je dit wilt veranderen, kun je een functions.php codesnippet gebruiken om de WordPress toolbar voor bepaalde gebruikersrollen te verbergen.
Dit voorbeeld zou de admin toolbar verbergen voor gebruikers met de Author gebruikersrol.
add_filter( 'show_admin_bar', function( $show ) {
if ( current_user_can( 'author' ) ) {
return false;
}
return $show;
} );
Het verschijnen van berichten in de RSS feed vertragen
Standaard verschijnt content in je RSS feed zodra je die publiceert. Dit kan contentscrapers de kans geven om je content te scrapen en in Google te indexeren voordat Google zelfs je oorspronkelijke bericht indexeert.
Om te voorkomen dat iemand anders met de eer strijkt voor jouw content, kun je het verschijnen van berichten in je RSS feed uitstellen.
Hoewel dit contentscrapers niet helemaal tegenhoudt, betekent het wel dat je Google de tijd geeft om je content eerst te indexeren.
Hier is het codesnippet – je kunt het getal – “30” in dit voorbeeld – veranderen in het aantal minuten dat je de vertraging wilt hebben:
function kinsta_delay_feed_content($where) {
global $wpdb;
if ( is_feed() ) {
// timestamp in WP-format
$now = gmdate('Y-m-d H:i:s');
// value for wait; + device
$wait = '30'; // integer
// http://dev.mysql.com/doc/refman/5.0/en/date-and-time-functions.html#function_timestampdiff
$device = 'MINUTE'; //MINUTE, HOUR, DAY, WEEK, MONTH, YEAR
// add SQL-sytax to default $where
$where .= " AND TIMESTAMPDIFF($device, $wpdb->posts.post_date_gmt, '$now') > $wait ";
}
return $where;
}
add_filter('posts_where', 'kinsta_delay_feed_content');
Bepaalde categorieën uitsluiten van de RSS feed
Naast het vertragen van het verschijnen van content in de RSS feed, kun je ook situaties hebben waarin je hele categorieën blogberichten wilt uitsluiten van verschijnen in de RSS feed van je site.
Om dit te bereiken kun je het volgende functions.php codesnippet gebruiken:
function kinsta_exclude_category_rss($query) {
if ($query->is_feed) {
$query->set('cat','-38');
}
return $query;
}
add_filter('pre_get_posts','kinsta_exclude_category_rss');
Zorg ervoor dat je de voorbeeld categorie-ID – “38” – vervangt door de werkelijke categorie ID’s die je wilt uitsluiten (en verwijder het minteken niet)
Hier zie je hoe je het ID nummer kunt vinden:
- Ga naar Posts → Categories om een lijst van alle categorieën op je site te zien.
- Klik op Edit onder de categorie die je wilt uitsluiten.
- Kijk naar de URL van de bewerkingspagina in de adresbalk van je browser. Het categorie ID is het nummer dat komt na ?taxonomy=category&tag_ID=X.
Als de URL bijvoorbeeld https://yoursite.com/wp-admin/term.php?taxonomy=category&tag_ID=38&post_type=post is, dan is de categorie ID 38.
WordPress revisies beperken per berichttype
Om te voorkomen dat de database van je site volloopt, wil je misschien beperken hoeveel berichtrevisies je opslaat.
Een manier om WordPress berichtrevisies sitebreed te beperken is door het wp-config.php bestand van je site te bewerken, maar misschien wil je verschillende aantallen revisies opslaan voor verschillende berichttypes – bijvoorbeeld blogposts versus WooCommerce producten.
Met deze functions.php codesnippet kun je dat doen. Om het je eigen te maken, verander je het berichttype – “post” in dit voorbeeld – in het eigenlijke posttype dat je wilt controleren en het getal – “5” in dit voorbeeld – in het aantal revisies dat je wilt opslaan.
function kinsta_post_revisions_by_type( $revisions, $post ) {
if( 'post' == $post->post_type ) {
$revisions = 5;
}
return $revisions;
}
add_filter( 'wp_revisions_to_keep', 'kinsta_post_revisions_by_type', 10, 2 );
* Let op – je bewerkt de “post” die direct na het “if” statement komt. Om bijvoorbeeld producten als doel te hebben, zou die regel er als volgt uitzien:
if( 'product' == $post->post_type ) {
De zoekfunctie van WordPress uitschakelen
Als je site geen zoekfunctie nodig heeft, wil je misschien de WordPress zoekfunctie uitschakelen om mogelijk misbruik te voorkomen.
Zelfs als je bijvoorbeeld geen zoekvak op je site toont, kunnen bots nog steeds de zoekfunctie gebruiken door ?s=[zoekterm] aan je URL toe te voegen.
Hiervoor kun je het volgende codesnippet toevoegen:
function kinsta_disable_wp_search( $query, $error = true ) {
if ( is_search() ) {
$query->is_search = false;
$query->query_vars[s] = false;
$query->query[s] = false;
// to error
if ( $error == true )
$query->is_404 = true;
}
}
add_action( 'parse_query', 'kinsta_disable_wp_search' );
add_filter( 'get_search_form', create_function( '$a', "return null;" ) );
Als iemand de zoekfunctie rechtstreeks probeert te gebruiken, geeft je site in plaats daarvan een 404 pagina terug.
Je eigen shortcodes maken (bijv. huidig jaar)
WordPress shortcodes zijn handige snelkoppelingen waarmee je dynamische content in je site kunt opnemen.
Hoewel veel WordPress plugins vertrouwen op shortcodes om hun functionaliteit te ondersteunen, kun je ook je eigen shortcodes maken met behulp van het WordPress functions.php bestand en de add_shortcode() functie.
Een veel voorkomende use case is bijvoorbeeld het maken van een shortcode die het huidige jaar weergeeft. Hiermee kun je automatisch het huidige jaar in al je content laten zien, zonder dat je elke 1 januari alles handmatig hoeft bij te werken.
Om zo’n shortcode te maken, kun je de volgende code gebruiken:
function year_shortcode() {
$year = date('Y');
return $year;
}
add_shortcode('currentyear', 'year_shortcode');
Wanneer je vervolgens de [currentyear] shortcode aan je content toevoegt, wordt deze automatisch vervangen door het huidige jaar – bijvoorbeeld 2023.
Shortcodes in berichttitels toestaan
Standaard zal WordPress geen shortcodes uitvoeren die je in het titelveld van je bericht plaatst. Als je shortcodes in WordPress berichttitels wilt gebruiken, kun je deze functionaliteit inschakelen door een eenvoudig codesnippet toe te voegen aan het WordPress functions.php bestand.
Bijvoorbeeld, in combinatie met de vorige codesnippet, zou dit je automatisch het huidige jaar in de berichttitel laten opnemen door de [currentyear] shortcode toe te voegen.
add_filter( 'the_title', 'do_shortcode' );
Aanmeldingsfouten verbergen om de veiligheid te verbeteren
Standaard toont WordPress een uitleg bij mislukte inlogpogingen. Dit bericht kan wat informatie weggeven, zoals of een bepaald e-mailadres wel of niet geregistreerd is op je site (zelfs als het wachtwoord onjuist is).
Om te voorkomen dat mogelijk gevoelige informatie uitlekt, kun je deze inlogfouten verbergen door het volgende codesnippet toe te voegen aan je functions.php bestand.
function kinsta_hide_login_errors(){
return 'These are not valid credentials';
}
add_filter( 'login_errors', 'kinsta_hide_login_errors' );
Deze snippet vervangt de standaard inlogfouttekst door het volgende bericht – Dit zijn geen geldige inloggegevens.
Je kunt de tekst naar eigen voorkeur aanpassen – maar probeer het gebruik van streepjes, schuine strepen of andere tekens te vermijden, want dat kan een fout veroorzaken (tenzij je deze tekens “ontsnapt”),
De lengte van het excerpt veranderen
Standaard toont het WordPress excerpt de eerste 55 woorden van een bericht.
Als je dit wilt aanpassen, kun je het volgende codesnippet toevoegen aan het bestand functions.php.
function kinsta_change_excerpt_length($length) {
return 90;
}
add_filter('excerpt_length', 'kinsta_change_excerpt_length');
Het bovenstaande codesnippet zal de lengte van het uittreksel veranderen in 90 woorden. Als je liever een ander getal hebt, kun je “90” veranderen in het exacte aantal woorden dat je wilt gebruiken.
Het versienummer van WordPress verwijderen
Om het voor kwaadwillenden moeilijker te maken om te ontdekken welke versie van WordPress je gebruikt, verwijderen sommige gebruikers graag het WordPress versienummer uit de frontendcode van je site.
Daarvoor kun je de volgende stukjes code toevoegen aan je functions.php bestand.
function kinsta_hide_version() {
return '';
}
add_filter('the_generator', 'kinsta_hide_version');
WordPress paginering instellen
Als je niet tevreden bent met hoe paginering in je thema werkt, kun je een functions.php codesnippet gebruiken om het pagineringsgedrag aan te passen of zelfs je eigen pagineringssysteem maken.
Als je geïnteresseerd bent in dit soort aanpassingen, hebben we een volledige handleiding voor WordPress paginering die enkele voorbeeldfuncties.php codesnippets voor je bevat.
Veranderen hoeveel resultaten er op de pagina met zoekresultaten staan
WordPress geeft je in het dashboard een optie om te bepalen hoeveel berichten er op archiefpagina’s worden vermeld (Settings → Reading).
Dit verandert echter het aantal voor alle archiefpagina’s. Wat als je alleen een ander aantal wilt gebruiken voor de pagina met zoekresultaten?
Daarvoor kun je deze snippet toevoegen aan je functions.php bestand – zorg ervoor dat je het getal (“12” in dit voorbeeld) verandert in het werkelijke aantal resultaten dat je wilt weergeven voordat je extra resultaten pagineert.
function kinsta_search_results_list() {
if ( is_search() )
set_query_var('posts_per_archive_page', 12);
}
add_filter('pre_get_posts', 'kinsta_search_results_list');
Uitgelichte afbeeldingen opnemen in de WordPress RSS feed
Als je de uitgelichte afbeeldingen van je berichten wilt opnemen in de content van je RSS feed, kun je het volgende snippet toevoegen aan je functions.php bestand.
function kinsta_featured_image_rss($content) {
global $post;
if ( has_post_thumbnail( $post->ID ) ){
$content = '<div>' . get_the_post_thumbnail( $post->ID, 'full', array( 'style' => 'margin-bottom: 15px;' ) ) . '</div>' . $content;
}
return $content;
}
add_filter('the_excerpt_rss', 'kinsta_featured_image_rss');
add_filter('the_content_feed', 'kinsta_featured_image_rss');
Het bovenstaande codesnippet zal de afbeelding op volledige grootte invoegen. Om een andere thumbnailgrootte te gebruiken, kun je “full” veranderen in een andere thumbnailgrootte – bijvoorbeeld “large” of “medium”.
Uploadondersteuning toevoegen voor bestandstypen (bijv. SVG)
Standaard blokkeert WordPress het uploaden van bepaalde bestandstypen, zoals SVG bestanden.
Om ondersteuning voor deze geblokkeerde bestandstypen in te schakelen, kun je het volgende codesnippet toevoegen aan het WordPress functions.php bestand:
function kinsta_myme_types($mime_types){
$mime_types['svg'] = 'image/svg+xml';
return $mime_types;
}
add_filter('upload_mimes', 'kinsta_myme_types', 1, 1);
Dit codesnippet maakt alleen SVG uploads mogelijk, maar je kunt het aanpassen om ondersteuning voor andere bestandstypen toe te voegen als dat nodig is.
WordPress update-reminders voor niet-beheerders verbergen
Standaard toont WordPress aan alle gebruikers met toegang tot het dashboard berichten als er een nieuwe update beschikbaar is.
Zelfs als de rol van een gebruiker hem niet toestaat om de update toe te passen, zal het dashboard bericht die gebruiker vertellen om contact op te nemen met de beheerder.
Om dit aan te passen kun je deze codesnippet gebruiken om updatemeldingen te verbergen voor alle niet-beheerder gebruikers:
function kinsta_hide_update_nag() {
if ( ! current_user_can( 'update_core' ) ) {
remove_action( 'admin_notices', 'update_nag', 3 );
}
}
add_action('admin_menu','kinsta_hide_update_nag');
Bekijk voor enkele andere variaties onze handleiding over het uitschakelen van WordPress updatemeldingen.
De automatische JPEG optimalisatiekwaliteit veranderen
Hoewel niet iedereen deze functie kent, comprimeert WordPress automatisch JPEG afbeeldingen bij het maken van thumbnails voor je site nadat je afbeeldingen hebt geüpload.
Sinds WordPress 4.5 heeft WordPress het standaard kwaliteitsniveau ingesteld op 82 (waarbij 100 nul compressie is).
Als je dit kwaliteitsniveau hoger of lager wilt maken, kun je het volgende codesnippet toevoegen aan je functions.php bestand – zorg ervoor dat je het getal (“90” in dit voorbeeld) verandert in het werkelijke kwaliteitsniveau dat je wilt gebruiken:
add_filter( 'jpeg_quality', create_function( '', 'return 90;' ) );
Best practices voor het organiseren van je WordPress functions.php bestand
Als je alleen het WordPress functions.php bestand gebruikt om een paar codesnippets toe te voegen, hoef je je waarschijnlijk geen zorgen te maken over organisatie.
Maar als je een heleboel codesnippets aan je site toevoegt, kan het snel onhandelbaar en complex worden als je niet enkele best practices volgt voor het organiseren van het functions.php bestand.
Hier zijn een paar best practices om je codesnippets georganiseerd te houden..
Voeg codecommentaar toe om alles uit te leggen
Als je voor het eerst een codesnippet toevoegt aan je functions.php bestand, weet je precies wat het snippet doet en waarom je het hebt toegevoegd. Maar als je een jaar later terugkijkt naar het bestand functions.php, is het misschien niet meer zo duidelijk.
Om dit te voorkomen kun je aan elk snippet codecommentaar toevoegen dat uitlegt wat het snippet doet en waarom je het hebt toegevoegd.
Codecommentaar is tekst die niet door WordPress wordt uitgevoerd, maar die menselijke gebruikers kunnen lezen om te begrijpen wat het codesnippet doet.
Om een eenregelig codecommentaar toe te voegen, kun je dit format gebruiken:
// This is a single-line code comment
Om een codecommentaar van meerdere regels toe te voegen, kun je dit format gebruiken:
/**
* This is a code comment that spans multiple lines
* This text is also in the same comment
* This is the last line in the code comment
*/
Hier is een voorbeeld van hoe je codecommentaar zou kunnen gebruiken – je ziet dat het commentaar voor elk snippet uitlegt wat het snippet doet.
Gebruik Include bestanden om snippets te scheiden in verschillende bestanden
Als je echt veel codesnippets hebt, kun je ze in aparte bestanden opslaan in plaats van alleen het functions.php bestand te gebruiken.
Vervolgens kun je die codesnippets opnemen in het functions.php bestand met behulp van include of require. Mike Schinkel heeft een goed voorbeeld van hoe je dit zou kunnen doen op StackExchange.
Overweeg een van de functions.php alternatieven van hierboven
Als je vindt dat je functions.php bestand een beetje onoverzichtelijk wordt, geef je misschien de voorkeur aan een van de functions.php alternatieven die we eerder beschreven hebben.
Bijvoorbeeld, de gratis Code Snippets plugin maakt het heel gemakkelijk om alles te organiseren, omdat je elk codesnippet apart kunt toevoegen, compleet met zijn eigen titel en beschrijving. Je kunt ook tags gebruiken om je snippets te organiseren.
Samenvatting
Het WordPress functions.php bestand is een themaspecifiek bestand waarmee je PHP codesnippets aan je website kunt toevoegen.
Als je codesnippets wilt toevoegen aan het functions.php bestand, moet je altijd een childthema gebruiken, zodat je wijzigingen niet worden overschreven als je je thema bijwerkt. We raden ook aan een backup te maken van je site voordat je snippets toevoegt en ze waar mogelijk te testen op een testsite.
Als alternatief voor het gebruik van het functions.php bestand kun je ook een codemanagerplugin overwegen of je eigen plugin maken om je snippets in onder te brengen.
Nu je weet hoe het WordPress functions.php bestand werkt, kun je je site op allerlei nuttige manieren gaan aanpassen.
De voorbeeldfuncties.php snippets hierboven geven je enkele goede plaatsen om te beginnen, maar de sky is de limit als het gaat om wat je kunt doen.
Laat een reactie achter