Een grondige kennis van de WordPress-kernhooks en -filters: van basisbeginselen tot praktische programmeertechnieken.

De kracht en flexibiliteit van WordPress komt gedeeltelijk van het zorgvuldig ontworpen systeem van “hooks en filters”. Dit mechanisme biedt ontwikkelaars de mogelijkheid om alle aspecten van WordPress diep te personaliseren en uit te breiden, zonder de kerncode te hoeven aanpassen. Of je nu wilt toevoegen aan artikelinhoud of de standaardlogica van een bepaalde functie wilt veranderen: hooks en filters vormen de basis voor dit proces. Het begrijpen van hun werking is een belangrijke stap om van een WordPress-gebruiker een ontwikkelaar te worden.

Fundamentale concepten van hooks en filters

In WordPress worden ‘hooks’ gezamenlijk genoemd en ze vallen voornamelijk in twee categorieën: Action Hooks en Filter Hooks. Samen vormen ze de event-driven architectuur van WordPress.

Action hooks bieden je de mogelijkheid om je eigen code uit te voeren op bepaalde tijdstippen of wanneer bepaalde gebeurtenissen plaatsvinden. Bijvoorbeeld wordt een action hook in WordPress geactiveerd wanneer een artikel wordt gepubliceerd of wanneer een gebruiker inlogt. Je kunt hierdoor op deze momenten specifieke acties uitvoeren, zoals het weergeven van extra informatie of het uitvoeren van automatische verwerkingen. add_action() De functie “monteert” je eigen gedefinieerde functie op deze “haakken”, zodat deze op vooraf bepaalde momenten specifieke taken uitvoert. Action-haakken verwachten geen teruggegeven waarde; het belangrijkste doel is om een actie uit te voeren.

Aanbevolen leesmateriaal Hoe je met WooCommerce een WordPress-website voor e-commerce maakt met een hoge conversieratio。

De filter-haken bieden je de mogelijkheid om gegevens te “bewerken” voordat deze worden gebruikt of opgeslagen. Denk hierbij aan artikeltitels die worden verwerkt voordat ze in de browser worden weergegeven, of gebruikerscommentaren die worden opgeslagen in de database. add_filter() De functie maakt je eigen functie beschikbaar voor deze filters, waardoor de doorgegeven gegevens worden gewijzigd. De filters vormen een stap in de datastroom en kunnen de gegevens verwerken.

UltaHost WordPress-hosting

30-daagse garantie voor het terugbetalen van het geld, onbeperkt bandbreedte- en databestand, gratis DDoS-beveiliging, en een prijsvoordeel van 50% bij een aankoop van 3 jaar.

toegangspagina

Een simpel manier om dit te onthouden is: een ‘Actie’ betekent dat je iets doet, en een ‘Filter’ betekent dat je iets verandert.

Detaileerde uitleg en gebruik van de kernfuncties

Om hooken te gebruiken, moet je enkele belangrijke functies beheersen. Deze functies vormen de interface waarmee je met het evenementensysteem van WordPress kunt communiceren.

De belangrijkste hook-functie is… add_action() 和 add_filter()De basisgrammatiek is erg vergelijkbaar. De eerste parameter is de naam van de hook, de tweede parameter is de naam van de zelfgemaakte functie die moet worden opgeroepen, de derde parameter is een optionele prioriteit (de standaardwaarde is 10), en de vierde parameter is het aantal optionele argumenten (de standaardwaarde is 1).

// 挂载一个动作到 'init' 钩子
add_action( 'init', 'my_custom_init_function' );
function my_custom_init_function() {
    // 当 WordPress 初始化时，执行这里的代码
    // 例如，注册一个自定义文章类型
}

// 挂载一个过滤器到 ‘the_title’ 钩子
add_filter( 'the_title', 'my_custom_title_filter' );
function my_custom_title_filter( $title ) {
    // 修改传入的标题
    $modified_title = '前缀：' . $title;
    // 必须返回修改后的值
    return $modified_title;
}

De prioriteitsparameters bepalen de volgorde van uitvoering wanneer meerdere functies zijn gemonteerd op dezelfde hook. Hoe lager het nummer, des hoger de prioriteit en des eerder de uitvoering. Het aantal parameters vertelt WordPress hoeveel gegevens uw callback-functie moet ontvangen. do_action() 或 apply_filters() De parameters van...

Aanbevolen leesmateriaal De WordPress-website, van beginner tot expert: een complete handleiding voor het opzetten en optimaliseren van de prestaties.。

In overeenstemming met dit, is de functie die de haak verwijdert: remove_action() 和 remove_filter()Ze worden meestal gebruikt om bepaalde functies in een thema of plugin uit te schakelen. Het is belangrijk om ervoor te zorgen dat de vereiste ‘hooks’ zijn toegevoegd en dat de parameters (met betrekking tot de prioriteit) volledig overeenkomen met de vereisten.

Analyse van praktische toepassingsscenario's

Theorie en praktijk moeten worden gecombineerd om een volledig begrip te krijgen. Laten we via enkele veel voorkomende ontwikkelingssituaties kijken hoe hooks en filters kunnen worden gebruikt om echte problemen op te lossen.

Een typisch voorbeeld is dat er automatisch aangepaste content wordt toegevoegd aan het begin en einde van een artikel. We kunnen dit gebruiken om... the_content Deze filter… Deze ‘hook’ is echt zeer krachtig; alles wat er doorheen komt, wordt verwerkt. the_content() Alles wat de functie uitgeeft, wordt door deze functie verwerkt.

hosting.com gedeelde hosting

Hoge prestaties met AMD EPYC CPU's, NVMe SSD opslag en LiteSpeed, 24/7 deskundige interne ondersteuning, geavanceerde beveiligingsmaatregelen waaronder SSL, bescherming tegen brute kracht, malware en DDoS, besparingen tot 73%

toegangspagina

add_filter( ‘the_content’, ‘add_signature_to_post’ );
function add_signature_to_post( $content ) {
    // Voeg alleen een handtekening toe op de pagina met één artikel, niet bij de feed-uitvoer
    if ( is_single() && ! is_feed() ) {
        $signature = ‘ <span class="author-name">Door</span> <span class="author-url">'.get_the_author_url().'</span>';
        $content = str_replace( 'Author:', $signature, $content );
    }
}‘<p><em>Dit artikel is voor het eerst gepubliceerd op mijn blog. Als u het wilt herpubliceren, moet u de bron vermelden.</em></p>’$content = $content . $signature;
    }
    return $content;
}

Een andere situatie is wanneer je de pagina wilt bepalen waar de gebruiker na inloggen heen wordt geleid. Standaard worden gebruikers na inloggen naar de beheeromgeving geleid. Op een membership-website kunnen we echter willen dat ze naar de homepagina of een specifieke pagina gaan. Hiervoor kun je gebruikmaken van… login_redirect Filteren.

add_filter( ‘login_redirect’, ‘custom_login_redirect’, 10, 3 );
function custom_login_redirect( $redirect_to, $request, $user ) {
    // 检查用户对象是否存在且不是WP_Error，并且有权限
    if ( isset( $user->roles ) && is_array( $user->roles ) ) {
        // 如果是管理员，跳转到后台；否则跳转到站点首页
        if ( in_array( ‘administrator’, $user->roles ) ) {
            return admin_url();
        } else {
            return home_url();
        }
    }
    // 默认情况返回原来的重定向地址
    return $redirect_to;
}

Advanced Techniques and Development Practices

Als je de basis van de gebruikersinterface onder de knie hebt, kun je ontdekken hoe je efficiënter en veiliger kunt ontwikkelen.

Allereerst: het gebruik van anonieme functies (of closure's). Voor eenvoudige, enkele keer te gebruiken en niet opnieuw te behoevende callback-functies, maken anonieme functies de code compacter en voorkomen ze dat de globale namensruimte wordt verontreinigd door te veel functies.

Aanbevolen leesmateriaal De ultieme gids voor het ontwikkelen van WordPress-thema's: van nul tot een professioneel webthema.。

add_action( ‘wp_footer’, function() {
    echo ‘<!-- 页面加载完成于：’ . current_time( ‘mysql’ ) . ‘ -->’;
});

Ten tweede: klassen en methoden worden gebruikt als callback-functies. In objectgerichte programmering is het beter om methoden van klassen te gebruiken als callback-functies in plugins of thema's. Hiervoor moet je een array gebruiken om de instansen van de klassen en de namen van de methoden aan te geven.

class My_Plugin_Core {
    public function __construct() {
        add_action( ‘admin_init’, array( $this, ‘register_admin_settings’ ) );
        add_filter( ‘pre_get_posts’, array( $this, ‘modify_main_query’ ) );
    }

public function register_admin_settings() {
        // 注册设置
    }

public function modify_main_query( $query ) {
        // 修改主查询
        if ( ! is_admin() && $query->is_main_query() ) {
            // 你的逻辑
        }
        return $query;
    }
}
new My_Plugin_Core();

Ten slotte: het afstellen en verkennen van hooks. Tijdens het ontwikkelingsproces is het van belang om te weten welke hooks op de huidige pagina worden uitgevoerd en in welke volgorde. Hiervoor kunnen tools worden gebruikt. Debug Bar Een plugin of een uitbreiding die is gebaseerd op een bestaande plugin. Debug Bar Actions and Filters Addon Er zijn plugins beschikbaar om alle geactiveerde hooks visueel te weergeven. Daarnaast is het ook een snelle manier om fouten op te sporen om bepaalde hooks rechtstreeks in het code te monitoren:

InterServer gedeelde hosting

Shared hosting $2.50 USD per maand, eerste maand $0.1 USD promo code tryinterserver, 461 cloud apps scripts, een klik te installeren.

toegangspagina

add_action( ‘all’, function( $hook_name ) {
    if ( strpos( $hook_name, ‘save_post’ ) !== false ) {
        error_log( ‘当前触发钩子：’ . $hook_name );
    }
});

Samenvatting

Het systeem van hooks en filters in WordPress vormt de essentie van de uitbreidbaarheid van het platform. Het maakt het mogelijk om de kern van WordPress elegant te scheiden van aangepaste code, dankzij een eventgedreven architectuur. Van de basisconcepten van actions en filters tot de meer geavanceerde mogelijkheden… add_action、add_filter Door de toepassing van kernfuncties en het oplossen van praktische problemen zoals het bewerken van artikelinhoud en het beheer van inloggingen, kunnen ontwikkelaars steeds meer ervaring opdoen met dit krachtige hulpmiddel. Op een hogere niveau kunnen ze anonieme functies, objectgerichte programmeringstechnieken en effectieve debugging-methoden gebruiken, waardoor hun code professioneler en onderhoudsvriendelijker wordt. Als je opmaken en filteren van WordPress-beheermechanismen onder de knie hebt, beschik je over de mogelijkheid om het gedrag van WordPress precies zo te bepalen als je wenst. Dit is de sleutel tot het efficiënt en veilig ontwikkelen van plugins en thema's.

Veelgestelde vragen (FAQ)

Wat is het fundamentele verschil tussen action-hooks en filter-hooks?

Action hooks worden gebruikt om op een bepaald moment in de tijd een stuk code uit te voeren. Ze retourneren geen waarde aan de oproeper; het belangrijkste doel is om een bepaalde actie of taak uit te voeren. Een typisch voorbeeld van een dergelijke functie is… do_action() 和 add_action()。

Filterhooks worden gebruikt om gegevens te bewerken voordat deze hun eindbestemming bereiken (bijvoorbeeld een database of een browser). Ze moeten een waarde teruggeven (meestal de gewijzigde invoerwaarde). Het belangrijkste doel is om de gegevens te veranderen. Een typisch voorbeeld van een dergelijke functie is… apply_filters() 和 add_filter()。

Hoe weet je of een bepaalde hook een actie (action) of een filter is?

De meest betrouwbare manier om dit te bepalen, is door te kijken naar de officiële documentatie (WordPress Codex/Developer Resources). In de praktijk kan je ook kijken naar de broncode om te controleren welke functies worden gebruikt: als een bepaalde functie daadwerkelijk wordt opgeroepen in de broncode, betekent dit dat deze functie beschikbaar is. do_action Het wordt genoemd een 'action hook'; als je dit gebruikt... apply_filters Als je deze functie gebruikt, wordt het een filterhook. Bovendien onderscheiden veel ontwikkelingshulpmiddelen en plugins (zoals Query Monitor) acties en filters ook wanneer ze worden weergegeven.

Waarom werken de filters die ik heb toegevoegd niet?

Er zijn enkele mogelijke redenen voor dit probleem: In de eerste plaats, moet je controleren of de spelling van de hook-naam correct is. Daarnaast moet je ervoor zorgen dat je callback-functie goed is gedefinieerd en dat deze wordt opgeroepen zoals verwacht. add_filter De toevoeging is succesvol gedaan (zorg ervoor dat de code is uitgevoerd voordat de hook wordt afgerond). Ten derde: controleer of je callback-functie de juiste waarde teruggeeft; de filter-functie moet namelijk een teruggegeven waarde hebben. Ten vierde: er kan een probleem met de prioriteit zijn; andere filters met een hogere prioriteit kunnen je aanpassingen overraken. Probeer de prioriteitsparameters te aanpassen. Ten slotte: gebruik conditionele tags (zoals…) is_single()Zorg ervoor dat je code werkt in het verwachte context.

Tijdens het ontwikkelen van plugins of thema's: wanneer moet je ervoor zorgen dat je eigen 'hooks' (speciale onderdelen van het programma) maakt?

Als de functies die je ontwikkelt complex genoeg zijn, en je wilt dat andere ontwikkelaars (of jezelf in de toekomst) mogelijkheden hebben om ze uit te breiden of te bewerken, moet je aangepaste ‘hooks’ (speciale onderdelen van het programma) maken. Bijvoorbeeld: nadat je plugin de belangrijkste logische stappen heeft uitgevoerd, kan je een aangepaste actie-hook activeren, zodat andere delen van het programma extra taken kunnen uitvoeren; of voordat je een complexe gegevensstroom weergeeft, kan je een aangepaste filter toepassen, zodat andere onderdelen de gegevens kunnen bewerken. Dit volgt het principe van openheid en afsluiting (open-closed principle), waardoor de code veel beter uitbreidbaar en gebruiksvriendelijk wordt. do_action Maak een aangepaste actie en gebruik deze. apply_filters Een persoonlijke filter maken.