PHP: Função __(‘string’); dois underscores?!

Por João Paulo | Tags:L10n, php, wordpress

Ao personalizar um tema para WordPress ou mesmo abrir alguns dos arquivos pertencentes ao core do sistema, você pode se deparar com a função __() [dois underscores], como em __(‘Powered by WordPress’). Além disso, você também pode encontrar essa mesma função ao usar algum framework de desenvolvimento [Zend, Kohana, Yii, etc...].

A pergunta que você deve estar fazendo, principalmente se chegou até aqui via Google, é o que essa função faz? Onde eu encontro a documentação sobre ela?

O fato é que a função __() não faz parte do PHP, mas trata-se de uma função definida pelo WordPress ou Framework utilizado e, por senso comum, está relacionada à função de localização/internacionalização/tradução.

O seu funcionamento é muito simples: a função recebe como parâmetro uma mensagem [$message], busca no módulo de localização a tradução para o parâmetro passado [$message] e então retorna a tradução. Se a tradução não é encontrada, o próprio valor passado [$message] é retornado. Os detalhes, no caso do WordPress, podem ser vistos aqui.

Note, no entanto, que a função _() existe no PHP e trata-se de um alias para a função gettext(), que por sua vez é utilizado também quando se deseja promover a localização/internacionalização das aplicações.

Fica aí a dica!

• Wordpress 3.0 - Upgrade PHP Fatal error: Call to undefined function is_multisite()
• Wordpress 3.0 - Download já disponível!
• PHP: Estruturas de controle - sintaxe alternativa
• Uso de chaves [curly braces] em variáveis e strings PHP
• PHP: função preg_match() e problemas com UTF-8