Merge branch 'master' into drop_php56

Author: LasseRafn

composer.json

@@ -19,7 +19,8 @@
 		"ext-json": "*",
 		"intervention/image": "^2.3",
 		"lasserafn/php-initials": "^2.20",
-		"lasserafn/php-string-script-language": "^0.1.0"
+		"lasserafn/php-string-script-language": "^0.1.0",
+		"overtrue/pinyin": "^4.0"
 	},
 	"require-dev": {
 		"doctrine/instantiator": "1.0.*",

composer.lock

@@ -7,6 +7,7 @@
 use Intervention\Image\ImageManager;
 use LasseRafn\Initials\Initials;
 use LasseRafn\StringScript;
+use LasseRafn\InitialAvatarGenerator\Translator\Base;
 
 class InitialAvatar
 {
@@ -29,6 +30,30 @@ class InitialAvatar
 	protected $fontFile           = '/fonts/OpenSans-Regular.ttf';
 	protected $generated_initials = 'JD';
 
+    /**
+     * Language eg.en zh-CN
+     *
+     * @var string
+     */
+    protected $language = 'en';
+
+    /**
+     * Role translator
+     *
+     * @var Base
+     */
+    protected $translator;
+
+    /**
+     * Language related to translator
+     *
+     * @var array
+     */
+    protected $translatorMap = [
+        'en' => 'LasseRafn\\InitialAvatarGenerator\\Translator\\En',
+        'zh-CN' => 'LasseRafn\\InitialAvatarGenerator\\Translator\\ZhCN',
+    ];
+
 	public function __construct() {
 		$this->setupImageManager();
 		$this->initials_generator = new Initials();
@@ -49,6 +74,7 @@ protected function setupImageManager() {
 	 * @return $this
 	 */
 	public function name( $nameOrInitials ) {
+        $nameOrInitials = $this->translate($nameOrInitials);
 		$this->name = $nameOrInitials;
 		$this->initials_generator->name( $nameOrInitials );
 
@@ -342,6 +368,66 @@ public function getAutoFont() {
 		return $this->autofont;
 	}
 
+    /**
+     * Set language of name, pls use `language` before `name`, just like
+     * ```php
+     * $avatar->language('en')->name('Mr Green'); // Right
+     * $avatar->name('Mr Green')->language('en'); // Wrong
+     * ```
+     *
+     * @param string $language
+     * @return $this
+     */
+    public function language($language)
+    {
+        $this->language = $language ? : 'en';
+
+        return $this;
+    }
+
+    /**
+     * Add new translators designed by user
+     *
+     * @param array $translatorMap
+     * ```php
+     * $translatorMap = [
+     *     'fr' => 'foo\bar\Fr',
+     *     'zh-TW' => 'foo\bar\ZhTW'
+     * ];
+     * ```
+     * @return $this
+     */
+    public function addTranslators($translatorMap)
+    {
+        $this->translatorMap = array_merge($this->translatorMap, $translatorMap);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function translate($nameOrInitials)
+    {
+        return $this->getTranslator()->translate($nameOrInitials);
+    }
+
+    /**
+     * Instance the translator by language
+     *
+     * @return Base
+     */
+    protected function getTranslator()
+    {
+        if ($this->translator instanceof Base && $this->translator->getSourceLanguage() === $this->language) {
+            return $this->translator;
+        }
+
+        $translatorClass = array_key_exists($this->language, $this->translatorMap) ? $this->translatorMap[$this->language] : 'LasseRafn\\InitialAvatarGenerator\\Translator\\En';
+
+        return $this->translato = new $translatorClass();
+    }
+
 	/**
 	 * @param ImageManager $image
 	 *

src/InitialAvatar.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace LasseRafn\InitialAvatarGenerator\Translator;
+
+interface Base
+{
+    /**
+     * Translate words to english
+     *
+     * @param string $words
+     * @return mixed
+     */
+    public function translate($words);
+
+    /**
+     * Get the source language of translator
+     *
+     * @return string
+     */
+    public function getSourceLanguage();
+}

src/Translator/Base.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace LasseRafn\InitialAvatarGenerator\Translator;
+
+class En implements Base
+{
+    /**
+     * @inheritdoc
+     */
+    public function translate($words)
+    {
+        return $words;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getSourceLanguage()
+    {
+        return 'en';
+    }
+}

src/Translator/En.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace LasseRafn\InitialAvatarGenerator\Translator;
+
+use Overtrue\Pinyin\Pinyin;
+
+class ZhCN implements Base
+{
+    /**
+     * Inherent instance of zh-CN translator
+     *
+     * @var Pinyin
+     */
+    protected $inherent;
+
+    /**
+     * ZhCN constructor, set the instance of PinYin
+     */
+    public function __construct()
+    {
+        $this->inherent = new Pinyin();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function translate($words)
+    {
+        return implode(' ', $this->inherent->name($words));
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getSourceLanguage()
+    {
+        return 'zh-CN';
+    }
+}