diff --git a/laravel/documentation/urls.md b/laravel/documentation/urls.md index 4263712f..8c03f9b1 100644 --- a/laravel/documentation/urls.md +++ b/laravel/documentation/urls.md @@ -59,6 +59,17 @@ Sometimes you may need to generate a URL to a named route, but also need to spec $url = URL::to_action('user@profile', array($username)); + +## URLs To A Different Language + +#### Generating a URL to the same page in another language: + + $url = URL::to_language('fr'); + +#### Generating a URL to your home page in another language: + + $url = URL::to_language('fr', true); + ## URLs To Assets diff --git a/laravel/documentation/views/html.md b/laravel/documentation/views/html.md index 1c6988fc..22b10d0b 100644 --- a/laravel/documentation/views/html.md +++ b/laravel/documentation/views/html.md @@ -87,6 +87,17 @@ For example, the < symbol should be converted to its entity representation. Conv echo HTML::link_to_action('user@profile', 'User Profile', array($username)); + +## Links To A Different Language + +#### Generating a link to the same page in another language: + + echo HTML::link_to_language('fr'); + +#### Generating a link to your home page another language + + echo HTML::link_to_language('fr', true); + ## Mail-To Links diff --git a/laravel/html.php b/laravel/html.php index 4e8dfb43..8bbf6d6d 100644 --- a/laravel/html.php +++ b/laravel/html.php @@ -247,6 +247,19 @@ class HTML { return static::link(URL::to_action($action, $parameters), $title, $attributes); } + /** + * Generate an HTML link to a different language + * + * @param string $language + * @param string $title + * @param array $attributes + * @return string + */ + public static function link_to_language($language, $title = null, $attributes = array()) + { + return static::link(URL::to_language($language), $title, $attributes); + } + /** * Generate an HTML mailto link. * @@ -356,7 +369,7 @@ class HTML { return '<'.$type.static::attributes($attributes).'>'.$html.''; } - + /** * Generate a definition list. * @@ -369,13 +382,13 @@ class HTML { $html = ''; if (count($list) == 0) return $html; - + foreach ($list as $term => $description) { $html .= '
'.static::entities($term).'
'; $html .= '
'.static::entities($description).'
'; } - + return ''.$html.''; } diff --git a/laravel/tests/cases/url.test.php b/laravel/tests/cases/url.test.php index 3bf37b40..290a1db0 100644 --- a/laravel/tests/cases/url.test.php +++ b/laravel/tests/cases/url.test.php @@ -106,6 +106,26 @@ class URLTest extends PHPUnit_Framework_TestCase { $this->assertEquals('http://localhost/index.php/url/test/taylor/otwell', URL::to_route('url-test-2', array('taylor', 'otwell'))); } + /** + * Test the URL::to_language method. + * + * @group laravel + */ + public function testToLanguageMethodGeneratesURLsToDifferentLanguage() + { + URI::$uri = 'foo/bar'; + Config::set('application.languages', array('sp', 'fr')); + Config::set('application.language', 'sp'); + + $this->assertEquals('http://localhost/index.php/fr/foo/bar', URL::to_language('fr')); + $this->assertEquals('http://localhost/index.php/fr/', URL::to_language('fr', true)); + + Config::set('application.index', ''); + $this->assertEquals('http://localhost/fr/foo/bar', URL::to_language('fr')); + + $this->assertEquals('http://localhost/sp/foo/bar', URL::to_language('en')); + } + /** * Test language based URL generation. diff --git a/laravel/url.php b/laravel/url.php index c87139e4..e0693252 100644 --- a/laravel/url.php +++ b/laravel/url.php @@ -294,6 +294,31 @@ class URL { return static::to($uri, $https); } + /** + * Get the URL to switch language, keeping the current page or not + * + * @param string $language The new language + * @param boolean $reset Whether navigation should be reset + * @return string An URL + */ + public static function to_language($language, $reset = false) + { + // Get the url to use as base + $url = $reset ? URL::home() : URL::to(URI::current()); + + // Validate the language + if (!in_array($language, Config::get('application.languages'))) + { + return $url; + } + + // Get the language we're switching from and the one we're going to + $from = '/'.Config::get('application.language').'/'; + $to = '/'.$language.'/'; + + return str_replace($from, $to, $url); + } + /** * Substitute the parameters in a given URI. *