Reword

Developer

Jean-Francois Paradis

3rd Party (Free)

272 downloads (last 90 days)

MIT License Download v1.0.0

EE Version Support

  • ExpressionEngine 2

Compatibility

If an item is crossed out, it might be untested, not applicable or incompatible. Contact the developer to be sure.

  • Updater
  • Multi Site Manager
  • Stand Alone Entry Form
  • Low Variables
  • Content Elements
  • Better Workflow
  • Matrix
  • Grid
  • Webservice
  • Publisher

Requirements

  • jQuery for the Control Panel

Add-On Type(s)

Plugin

Tags

An equivalent to translate() or __() in Wordpress which translates a given string using a dictionary. This implementation can also handle placeholders (eg: Hello %s) and can translate dates formats (eg: Today is %d).

#Sk Reword - ExpressionEngine Plugin

Version: 1.0.0
Jean-Francois Paradis - http://github.com/skaimauve
Copyright (c) 2012 Jean-Francois Paradis
MIT License - please see LICENSE file included with this distribution
http://github.com/skaimauve/reword

##Introduction

This plugin extends on similar functionality provided by the function translate() or __() in Wordpress which translates a given string using a dictionary.

This implementation can also handle placeholders (eg: Hello %s) and can translate dates formats (eg: Today is %d).

The language of the user is detected using the browser settings and stored in a cookie. The language can be changed by providing a ‘lang’ parameter in the url (eg: http://example.com?lang=fr). This changes the cookie, and persists even id the ‘lang’ parameter does not appear in subsequent urls.

The list of supported languages is defined in languages.php, which allows to convert between language codes (sent by the browser ‘Accept Language’ header or by the ‘lang’ parameters) and language strings used by Code Igniter.

The dictionaries are located in the ‘language_path’ folder defined in the configuration (default /themes if not provided), in the given languages subfolder. The system also supports multisite and multiple language sets per language (default ‘all’).

example (one file for all):
/var/www/themes/languages/default_site/french/lang.all.php

example (one file for set=‘front’, one for set=‘profile’, the rest goes in ‘all’):
/var/www/themes/languages/default_site/french/lang.front.php
/var/www/themes/languages/default_site/french/lang.profile.php
/var/www/themes/languages/default_site/french/lang.all.php

The language file must define a $lang associative array as follows.

example:

<?php
$lang = array(
‘Hello’ => ‘Bonjour’,
‘Hello %s’ => ‘Bonjour %s’,
‘%s search results for “%s”’ => ‘%s résultats pour “%s”’,
‘%M %d, %Y’ => ‘%d %M %Y’,
‘Posted %d’ => “Publié le %d”
);

If navigating to example.com/?lang=fr:

{exp:sk_reword text=‘Hello’}

{exp:sk_reword text=‘Hello %s’ string=‘Mary’}

{exp:sk_reword text=’%s search results for “%s”’ string=‘25|Test’}

{exp:sk_reword text=‘Posted %d’ format=’%M %d, %Y’ date=‘2010-01-01’}

Will render as (if using the set above):

Bonjour
Bonjour Mary
25 résultats pour “Test”
Publié le 07 Sep 2012

##Setup

Download the “sk_reword” folder and upload it to the third party directory of your ExpressionEngine folder.

##Usage:

### Basic Translation

{exp:sk_reword text=’‘}

Replaces $text with its translated equivalence in the dictionary using the language of the user. If there is no translation, the original text is returned.

example: {exp:sk_reword text=‘Hello’} 

You can also specify a language set.

example: {exp:sk_reword set=‘profile’ text=‘My Profile’} 

### String replacement

{exp:sk_reword text=’’ string=’‘}

Translates $text as above, then replaces %s in $text with the content of $string. Can also replace multiple occurrences of %s when multiple values are provided in $string and separated by ‘|’.

example: {exp:sk_reword text=‘Hello %s’ string=’{username}’} 
example: {exp:sk_reword text=’%s search results for “%s”’ string=’{exp:search:total_results}|{exp:search:keywords}’} 

### Date format and replacement

{exp:sk_reword text=’’ format=’’ date=’‘}

Translates $text as above, then translates $format using the same process, and then replaces %d in $text with $date (default current date) using the given $format. This function is used to support language-specific date formats. If $text is not provided, the date is returned with the correct format.

example: {exp:sk_reword text=‘Posted %d’ format=’%M %d, %Y’ date=’{entry_date}’}
example: {exp:sk_reword format=’%M %d, %Y’}

##Changelog

1.0.0 - Initial plugin

Download Reword

EE Support Downloads Add-On Version Release Date
Not Specified Download 1.0.0

This entry was created September 13, 2012, 10:25 am.
This entry was last updated September 13, 2012, 10:39 am.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!

Returns: devot:ee has a 30-day return policy on all commercial add-ons sold through devot-ee.com. If you need to return an add-on, do not go to the developer or the developer's site, but rather visit our returns page at https://devot-ee.com/returns to initiate your return. If you have questions, email support@devot-ee.com.

There are no reviews for this add-on yet.

What are you waiting for? Rate it and review it!