apply_filters( 'gettext', string $translation , string $text , string $domain )
Filters text with its translation.
Parameters
- $translation
-
(string) Translated text.
- $text
-
(string) Text to translate.
- $domain
-
(string) Text domain. Unique identifier for retrieving translated strings.
More Information
This filter hook is applied to the translated text by the internationalization functions (__()
, _e()
, etc.).
IMPORTANT: This filter is always applied even if internationalization is not in effect, and if the text domain has not been loaded. If there are functions hooked to this filter, they will always run. This could lead to a performance problem.
For singular/plural aware translation functions such as _n()
, see ngettext()
.
For context-specific translation functions such as _x()
, see filter hook gettext_with_context()
and ngettext_with_context()
.
Source
File: wp-includes/l10n.php
Changelog
Version | Description |
---|---|
2.0.11 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
This filter is ideally avoided as the performance aspect can be huge. If you do need it, be aware with a common suite of plugins installed this can easily run thousands of times on one page! WooCommerce and similar make everything translatable.
It’s far improved to check the domain right away and return the translation instantly if it’s not the domain you’re wanting to translate. This minimises the overhead, rather than some of these examples that are running str_replace(), is_single() etc over and over unnecessarily which adds up due to the sheer quantity of times this code will run.
Change the “Register” text on the WordPress default login page.
Expand full source codeCollapse full source code
Change the Comment Form
Change the default field names of the comment form. Assumes the current form includes field names “Name” and “Email” and that ‘theme_text_domain’ is the name of your theme’s text domain.
Expand full source codeCollapse full source code
Remove Text from Admin Form
Expand full source codeCollapse full source code
Change Text in Custom Post Admin Form
Expand full source codeCollapse full source code