WordPress provides a powerful mechanism for developers to customize translatable texts using filter hooks. This article will focus on two specific filter hooks: gettext and ngettext, with a special emphasis on the ngettext_{$domain} filter. Change any content of your WordPress site, using these filter hook.

1. Understanding gettext Filter Hook:

The gettext filter hook allows developers to modify translated strings before they are displayed on the site. This can be particularly useful when you want to change specific texts without altering the original source code. Let's take a look at a practical example using the WooCommerce Product Table plugin.

add_filter('gettext', 'wpt_custom_specific_text_change', 10, 3);
function wpt_custom_specific_text_change($translation, $text, $domain) {
    if ($domain !== 'woo-product-table') return $translation;
    // Check if the original translation text matches "Your Text"
    if ($translation === 'Your Text') {
        return 'Your Custom Text'; // Replace with your custom text
    return $translation;


In this example, we're using the gettext filter hook to check if the text domain is 'woo-product-table' and if the original translation text is "Your Text." If the conditions are met, we replace it with the custom text "Your Custom Text." Adjust the custom text as needed for your specific use case.

if ($domain !== 'woo-product-table') return $translation;

You can remove this line, If you want to replace from whole site. We set condition, so that it work for any one plugin.

2. Understanding ngettext_{$domain} Filter Hook:

The ngettext_{$domain} filter hook is a specialized filter that allows developers to modify pluralized translated strings for a specific text domain. Let's continue with our example using the WooCommerce Product Table plugin.


* Replace your item and items text 
* for Footer Cart
add_filter('ngettext_woo-product-table', 'wpt_custom_item_text_change', 10, 5);
function wpt_custom_item_text_change($translation, $single, $plural, $number, $domain) {
    if ($single !== '%d item') return $translation;
    switch ($translation) {
        case '%d item':
            return '%d iTEM'; // Replace with custom text, ensuring '%d' is present.
        case '%d items':
            return '%d iTEMSS'; // Replace with custom text, ensuring '%d' is present.
            return $translation;

In this instance, we're using the ngettext_woo-product-table filter hook to customize the translation of singular and plural items in the Footer Cart.
See Screenshot:

In Short:

WordPress filter hooks like gettext and ngettext provide developers with the flexibility to tailor translatable texts according to their specific needs. By understanding and utilizing these hooks, you can enhance the user experience on your WordPress site while maintaining compatibility with plugins and themes

Share This Article