wireLangTranslations() function

Set predefined fallbaack translation values

These predefined translations are used when an existing translation is not available, enabling you to provide translations programmatically.

These translations will be used if the text is not translated in the admin. The translations are not specific to any textdomain and thus can serve as a fallback for any file. The array you provide should be associative, where the keys contain the text to translate, and the values contain the translation (see examples).

The function affects behavior of future __(), _x() and _n() calls, and their objected-oriented equivalents.

Available since version 3.0.154. Versions 3.0.125 to 3.0.153 can use __(true, array $values);

Example

// Return 'Hola' when text is 'Hello' and 'Mundo' when text is 'World'
if($user->language->name == 'es') {
  wireLangTranslations([
    'Hello' => 'Hola',
    'World' => 'Mundo'
  ]);
}

// Setting predefined translations with context
wireLangTranslations([
  // would apply only to a _x('Search', 'nav'); call (context)
  'Search' => [ 'Buscar', 'nav' ]
]);

Usage

// basic usage
$array = wireLangTranslations();

// usage with all arguments
$array = wireLangTranslations(array $values = array);

Arguments

NameType(s)Description
values (optional)array

Return value

array


Functions methods and properties

API reference based on ProcessWire core version 3.0.155

Twitter updates

  • This post covers a few of the bigger updates in ProcessWire 3.0.154+3.0.155. This includes new live replacement of text in core and modules, a new method for creating canonical URLs, and some major upgrades to our input->urlSegment() method! More
    24 April 2020
  • A brief look at what's new in ProcessWire 3.0.154 in this forum post: More
    17 April 2020
  • This week we’ve got a few new and interesting core updates in progress, though none quite ready to release just yet. So rather than releasing version 3.0.154 today, I thought we'd instead take a brief look at what’s coming over the next few weeks… More
    3 April 2020

Latest news

  • ProcessWire Weekly #310
    The 310th issue of ProcessWire Weekly is going to be short and sweet: in this issue we'll walk you through the latest core updates, introduce a third party module called Twack, and check out a really gorgeous new site of the week. Read on!
    Weekly.pw / 18 April 2020
  • ProcessWire 3.0.154 and 3.0.155 core updates
    This post covers a few of the bigger updates in ProcessWire 3.0.154 and 3.0.155 on the dev branch. This includes a new function for live replacement of text in core and modules, a new method for creating canonical URLs, and some major upgrades to our $input->urlSegment() method that I think you’ll like!
    Blog / 24 April 2020
  • Subscribe to weekly ProcessWire news

“The end client and designer love the ease at which they can update the website. Training beyond how to log in wasn’t even necessary since ProcessWire’s default interface is straightforward.” —Jonathan Lahijani