| [ Index ] |
PHP Cross Reference of BackPress |
[Source view] [Print] [Project Stats]
Class for a set of entries for translation and their associated headers
| Version: | $Id: translations.php 1183 2026-03-30 00:28:59Z dd32 $ |
| File Size: | 546 lines (13 kb) |
| Included or required: | 2 times |
| Referenced: | 0 times |
| Includes or requires: | 2 files includes/pomo/plural-forms.php includes/pomo/entry.php |
Translations:: (12 methods):
add_entry()
add_entry_or_merge()
set_header()
set_headers()
get_header()
translate_entry()
translate()
select_plural_form()
get_plural_forms_count()
translate_plural()
merge_with()
merge_originals_with()
Gettext_Translations:: (6 methods):
gettext_select_plural_form()
nplurals_and_expression_from_header()
make_plural_form_function()
parenthesize_plural_exression()
make_headers()
set_header()
NOOP_Translations:: (10 methods):
add_entry()
set_header()
set_headers()
get_header()
translate_entry()
translate()
select_plural_form()
get_plural_forms_count()
translate_plural()
merge_with()
Class: Translations - X-Ref
Translations class.| add_entry( $entry ) X-Ref |
| Adds an entry to the PO structure. since: 2.8.0 return: bool True on success, false if the entry doesn't have a key. param: array|Translation_Entry $entry |
| add_entry_or_merge( $entry ) X-Ref |
| Adds or merges an entry to the PO structure. since: 2.8.0 return: bool True on success, false if the entry doesn't have a key. param: array|Translation_Entry $entry |
| set_header( $header, $value ) X-Ref |
| Sets $header PO header to $value If the header already exists, it will be overwritten TODO: this should be out of this class, it is gettext specific since: 2.8.0 param: string $header header name, without trailing : param: string $value header value, without trailing \n |
| set_headers( $headers ) X-Ref |
| Sets translation headers. since: 2.8.0 param: array $headers Associative array of headers. |
| get_header( $header ) X-Ref |
| Returns a given translation header. since: 2.8.0 return: string|false Header if it exists, false otherwise. param: string $header |
| translate_entry( &$entry ) X-Ref |
| Returns a given translation entry. since: 2.8.0 return: Translation_Entry|false Translation entry if it exists, false otherwise. param: Translation_Entry $entry Translation entry. |
| translate( $singular, $context = null ) X-Ref |
| Translates a singular string. since: 2.8.0 return: string param: string $singular param: string $context |
| select_plural_form( $count ) X-Ref |
| Given the number of items, returns the 0-based index of the plural form to use Here, in the base Translations class, the common logic for English is implemented: 0 if there is one element, 1 otherwise This function should be overridden by the subclasses. For example MO/PO can derive the logic from their headers. since: 2.8.0 return: int Plural form to use. param: int $count Number of items. |
| get_plural_forms_count() X-Ref |
| Returns the plural forms count. since: 2.8.0 return: int Plural forms count. |
| translate_plural( $singular, $plural, $count, $context = null ) X-Ref |
| Translates a plural string. since: 2.8.0 return: string param: string $singular param: string $plural param: int $count param: string $context |
| merge_with( &$other ) X-Ref |
| Merges other translations into the current one. since: 2.8.0 param: Translations $other Another Translation object, whose translations will be merged in this one (passed by reference). |
| merge_originals_with( &$other ) X-Ref |
| Merges originals with existing entries. since: 2.8.0 param: Translations $other |
Class: Gettext_Translations - X-Ref
Gettext_Translations class.| gettext_select_plural_form( $count ) X-Ref |
| The gettext implementation of select_plural_form. It lives in this class, because there are more than one descendant, which will use it and they can't share it effectively. since: 2.8.0 return: int Plural form to use. param: int $count Plural forms count. |
| nplurals_and_expression_from_header( $header ) X-Ref |
| Returns the nplurals and plural forms expression from the Plural-Forms header. since: 2.8.0 return: array{0: int, 1: string} param: string $header |
| make_plural_form_function( $nplurals, $expression ) X-Ref |
| Makes a function, which will return the right translation index, according to the plural forms header. since: 2.8.0 return: callable param: int $nplurals param: string $expression |
| parenthesize_plural_exression( $expression ) X-Ref |
| Adds parentheses to the inner parts of ternary operators in plural expressions, because PHP evaluates ternary operators from left to right since: 2.8.0 return: string the expression with parentheses added param: string $expression the expression without parentheses |
| make_headers( $translation ) X-Ref |
| Prepare translation headers. since: 2.8.0 return: array<string, string> Translation headers param: string $translation |
| set_header( $header, $value ) X-Ref |
| Sets translation headers. since: 2.8.0 param: string $header param: string $value |
Class: NOOP_Translations - X-Ref
Provides the same interface as Translations, but doesn't do anything.| add_entry( $entry ) X-Ref |
| List of translation headers. since: 2.8.0 |
| set_header( $header, $value ) X-Ref |
| Sets a translation header. since: 2.8.0 param: string $header param: string $value |
| set_headers( $headers ) X-Ref |
| Sets translation headers. since: 2.8.0 param: array $headers |
| get_header( $header ) X-Ref |
| Returns a translation header. since: 2.8.0 return: false param: string $header |
| translate_entry( &$entry ) X-Ref |
| Returns a given translation entry. since: 2.8.0 return: false param: Translation_Entry $entry |
| translate( $singular, $context = null ) X-Ref |
| Translates a singular string. since: 2.8.0 param: string $singular param: string $context |
| select_plural_form( $count ) X-Ref |
| Returns the plural form to use. since: 2.8.0 return: int param: int $count |
| get_plural_forms_count() X-Ref |
| Returns the plural forms count. since: 2.8.0 return: int |
| translate_plural( $singular, $plural, $count, $context = null ) X-Ref |
| Translates a plural string. since: 2.8.0 return: string param: string $singular param: string $plural param: int $count param: string $context |
| merge_with( &$other ) X-Ref |
| Merges other translations into the current one. since: 2.8.0 param: Translations $other |
| Generated: Sun Apr 19 01:00:12 2026 | Cross-referenced by PHPXref 0.7.1 |