YAMS (Yet Another Multilingual Solution) 1.1.9-(stable)

YAMS (Yet Another Multilingual Solution) 1.1.9-(stable)

Released May 24, 2010 by pms
YAMS is a highly configurable multilingual solution that doesn't require the user to maintain multiple document trees and which allows the user to work with existing document templates.

YAMS allows users to define language groups and specify certain templates as multilingual. All documents associated with those templates are then accessible in multiple languages via different URLs. The different language versions can be distinguished by root folder name or by server name. Unlike other multilingual solutions, it is NOT necessary to manage multiple document trees with YAMS. Instead, all content for all languages is stored in template variables in the multilingual documents. YAMS has a ManagerManager extension that will organise the template variables for different languages onto different tabs. YAMS is also capable of creating and managing the multilingual template variables automatically. Whether or not a template is multilingual can be configured simply via the module interface.

Multi-language content for the main document variables (pagetitle, longtitle, description, introtext, menutitle, content) is handled automatically and transparently and is subject to normal MODx caching. No special syntax is required for these document variables. For example, use [*content*] and the correct language content will appear.

In addition, YAMS provides a range of placeholders which provide access to the language tag (for use in lang="" or xml:lang=""), the language direction (for use in dir=""), language name and which allow the insertion of multilingual URLs for the current or any other document. These can be used throughout the site, including in snippet templates.

More advanced functionality is available via the YAMS snippet call. For example, via the snippet call it is possible to repeat content over multiple languages using templates. It is also possible to generate language lists or drop-down boxes in order to change language.

Since snippets are generally responsible for parsing the placeholders in templates supplied to them, like [+pagetitle+] for example, they wont automatically know to insert the correct multilingual content. For Ditto I have overcome this by writing an extender which fixes this issue. For the templates of other snippets it is possible to overcome this problem by replacing these placeholders by special YAMS snippet calls, eg:

I have provided YAMS compatible default templates for Wayfinder which already include the appropriate YAMS snippet calls.

As of version 1.0.3, YAMS *should be* fully compatible with EasyLingual. See the Setup tab for instructions on how to migrate a site from EasyLingual to YAMS.

YAMS has been developed on MODx Evolution v0.9.6.3 and with the latest version of PHP (5.2.6-3). I haven't made any effort as yet to make it backwards compatible with older versions of either. Download 151kb (5052 downloads)
Downloads: 8,696
License: GPLv3
Discuss Extra
Requires Evolution 1.0.x or greater
Supports mysql
This is now the recommended version of YAMS. It fixes a couple of bugs, one of which was introduced in YAMS 1.1.8.

Up to date [url=http://svn.modxcms.com/docs/display/ADDON/YAMS]YAMS documentation[/url] is available. Some content is available in multiple languages.

Please check out the [url=http://modxcms.com/forums/index.php/board,381.0.html]YAMS forums[/url] for more information about YAMS.

You might want to consult a list of [url=http://modxcms.com/forums/index.php/topic,43846.0.html]outsanding bugs[/url] for this version.

Installation Instructions

See the readme.txt or the [url=http://svn.modxcms.com/docs/display/ADDON/YAMS+Installation]online installation\upgrade instructions[/url].
Version Released Author Downloads
7 Versions 1 Contributors 8,710 Downloads
1.1.7-alpha rc7 Jan, 25 2010 pms 501
1.0.5-beta Aug, 17 2009 pms 1,254
1.0.4-beta Aug, 15 2009 pms 424
1.0.3-alpha Jul, 16 2009 pms 525
1.0.1-alpha Jul, 08 2009 pms 479
1.0.2-alpha Jul, 08 2009 pms 488