Class lispa\amos\core\migration\AmosMigrationTranslations
| Inheritance | lispa\amos\core\migration\AmosMigrationTranslations » yii\db\Migration » yii\base\Component » yii\base\Object |
|---|---|
| Implements | yii\base\Configurable, yii\db\MigrationInterface |
| Uses Traits | yii\db\SchemaBuilderTrait |
Class AmosMigrationTranslations
This class is useful to add translations to db if the translatemanager module is present in the project. The only method to override is "setTranslations". This method return an array of array of array in which you can set the translations that you want to add. In this array you can specify the translations for various languages. In each single translation array you can specify an alternative language, different from the major one. Then you must specify the category, the source message and the translation message. In the class are specified some constants for the major languages. All the translations set in a major language are assumed of this language. Note: when reverting a translations migration are removed only the translations and not the source in order to preserve for other use. If you want to remove even the source you must set the 'removeSource' key in a single translation array. The array must be in the format described below.
[
'LANG_TO_TRANSLATE' => [
[
'language' => 'ALTERNATIVE_LANG_TO_TRANSLATE' (optional alternative language)
'category' => 'CATEGORY_OF_THE_MESSAGE',
'source' => 'THE_MESSAGE_SOURCE',
'translation' => 'THE_MESSAGE_TRANSLATION',
'removeSource' => true
],
.
.
.
],
.
.
.
]
Here is an example of a single message translation from a source to italian language and the same message translated in French language with the optional 'language' key.
[
self::LANG_IT => [
[
'category' => 'amoscore',
'source' => 'Save',
'translation' => 'Salva',
],
[
'language' => self::LANG_FR (optional alternative language)
'category' => 'amoscore',
'source' => 'Save',
'translation' => 'Enregistrer',
'removeSource' => true
],
.
.
.
],
.
.
.
],
Public Properties
| Property | Type | Description | Defined By |
|---|---|---|---|
| $behaviors | yii\base\Behavior[] | List of behaviors attached to this component | yii\base\Component |
| $db | yii\db\Connection|array|string | The DB connection object or the application component ID of the DB connection that this migration should work with. | yii\db\Migration |
Public Methods
| Method | Description | Defined By |
|---|---|---|
| __call() | Calls the named method which is not a class method. | yii\base\Component |
| __clone() | This method is called after the object is created by cloning an existing one. | yii\base\Component |
| __construct() | Constructor. | yii\base\Object |
| __get() | Returns the value of a component property. | yii\base\Component |
| __isset() | Checks if a property is set, i.e. defined and not null. | yii\base\Component |
| __set() | Sets the value of a component property. | yii\base\Component |
| __unset() | Sets a component property to be null. | yii\base\Component |
| addColumn() | Builds and executes a SQL statement for adding a new DB column. | yii\db\Migration |
| addCommentOnColumn() | Builds and execute a SQL statement for adding comment to column | yii\db\Migration |
| addCommentOnTable() | Builds a SQL statement for adding comment to table | yii\db\Migration |
| addForeignKey() | Builds a SQL statement for adding a foreign key constraint to an existing table. | yii\db\Migration |
| addPrimaryKey() | Builds and executes a SQL statement for creating a primary key. | yii\db\Migration |
| alterColumn() | Builds and executes a SQL statement for changing the definition of a column. | yii\db\Migration |
| attachBehavior() | Attaches a behavior to this component. | yii\base\Component |
| attachBehaviors() | Attaches a list of behaviors to the component. | yii\base\Component |
| batchInsert() | Creates and executes an batch INSERT SQL statement. | yii\db\Migration |
| behaviors() | Returns a list of behaviors that this component should behave as. | yii\base\Component |
| bigInteger() | Creates a bigint column. | yii\db\SchemaBuilderTrait |
| bigPrimaryKey() | Creates a big primary key column. | yii\db\SchemaBuilderTrait |
| binary() | Creates a binary column. | yii\db\SchemaBuilderTrait |
| boolean() | Creates a boolean column. | yii\db\SchemaBuilderTrait |
| canGetProperty() | Returns a value indicating whether a property can be read. | yii\base\Component |
| canSetProperty() | Returns a value indicating whether a property can be set. | yii\base\Component |
| char() | Creates a char column. | yii\db\SchemaBuilderTrait |
| className() | Returns the fully qualified name of this class. | yii\base\Object |
| createIndex() | Builds and executes a SQL statement for creating a new index. | yii\db\Migration |
| createTable() | Builds and executes a SQL statement for creating a new DB table. | yii\db\Migration |
| date() | Creates a date column. | yii\db\SchemaBuilderTrait |
| dateTime() | Creates a datetime column. | yii\db\SchemaBuilderTrait |
| decimal() | Creates a decimal column. | yii\db\SchemaBuilderTrait |
| delete() | Creates and executes a DELETE SQL statement. | yii\db\Migration |
| detachBehavior() | Detaches a behavior from the component. | yii\base\Component |
| detachBehaviors() | Detaches all behaviors from the component. | yii\base\Component |
| double() | Creates a double column. | yii\db\SchemaBuilderTrait |
| down() | This method contains the logic to be executed when removing this migration. | yii\db\Migration |
| dropColumn() | Builds and executes a SQL statement for dropping a DB column. | yii\db\Migration |
| dropCommentFromColumn() | Builds and execute a SQL statement for dropping comment from column | yii\db\Migration |
| dropCommentFromTable() | Builds a SQL statement for dropping comment from table | yii\db\Migration |
| dropForeignKey() | Builds a SQL statement for dropping a foreign key constraint. | yii\db\Migration |
| dropIndex() | Builds and executes a SQL statement for dropping an index. | yii\db\Migration |
| dropPrimaryKey() | Builds and executes a SQL statement for dropping a primary key. | yii\db\Migration |
| dropTable() | Builds and executes a SQL statement for dropping a DB table. | yii\db\Migration |
| ensureBehaviors() | Makes sure that the behaviors declared in behaviors() are attached to this component. | yii\base\Component |
| execute() | Executes a SQL statement. | yii\db\Migration |
| float() | Creates a float column. | yii\db\SchemaBuilderTrait |
| getBehavior() | Returns the named behavior object. | yii\base\Component |
| getBehaviors() | Returns all behaviors attached to this component. | yii\base\Component |
| hasEventHandlers() | Returns a value indicating whether there is any handler attached to the named event. | yii\base\Component |
| hasMethod() | Returns a value indicating whether a method is defined. | yii\base\Component |
| hasProperty() | Returns a value indicating whether a property is defined for this component. | yii\base\Component |
| init() | lispa\amos\core\migration\AmosMigrationTranslations | |
| insert() | Creates and executes an INSERT SQL statement. | yii\db\Migration |
| integer() | Creates an integer column. | yii\db\SchemaBuilderTrait |
| money() | Creates a money column. | yii\db\SchemaBuilderTrait |
| off() | Detaches an existing event handler from this component. | yii\base\Component |
| on() | Attaches an event handler to an event. | yii\base\Component |
| primaryKey() | Creates a primary key column. | yii\db\SchemaBuilderTrait |
| renameColumn() | Builds and executes a SQL statement for renaming a column. | yii\db\Migration |
| renameTable() | Builds and executes a SQL statement for renaming a DB table. | yii\db\Migration |
| safeDown() | This method contains the logic to be executed when removing this migration. | lispa\amos\core\migration\AmosMigrationTranslations |
| safeUp() | This method contains the logic to be executed when applying this migration. | lispa\amos\core\migration\AmosMigrationTranslations |
| smallInteger() | Creates a smallint column. | yii\db\SchemaBuilderTrait |
| string() | Creates a string column. | yii\db\SchemaBuilderTrait |
| text() | Creates a text column. | yii\db\SchemaBuilderTrait |
| time() | Creates a time column. | yii\db\SchemaBuilderTrait |
| timestamp() | Creates a timestamp column. | yii\db\SchemaBuilderTrait |
| trigger() | Triggers an event. | yii\base\Component |
| truncateTable() | Builds and executes a SQL statement for truncating a DB table. | yii\db\Migration |
| up() | This method contains the logic to be executed when applying this migration. | yii\db\Migration |
| update() | Creates and executes an UPDATE SQL statement. | yii\db\Migration |
Protected Methods
| Method | Description | Defined By |
|---|---|---|
| afterAddConfs() | Override this to make operations after adding the translations configurations. | lispa\amos\core\migration\AmosMigrationTranslations |
| afterRemoveConfs() | Override this to make operations after removing the translations configurations. | lispa\amos\core\migration\AmosMigrationTranslations |
| beforeAddConfs() | Override this to make operations before adding the translations configurations. | lispa\amos\core\migration\AmosMigrationTranslations |
| beforeRemoveConfs() | Override this to make operations before removing the translations configurations. | lispa\amos\core\migration\AmosMigrationTranslations |
| getDb() | yii\db\SchemaBuilderTrait | |
| setTranslations() | Override this method to set all the translations configurations. | lispa\amos\core\migration\AmosMigrationTranslations |
Constants
| Constant | Value | Description | Defined By |
|---|---|---|---|
| FIELD_TYPE_ARRAY | 'ARRAY' | lispa\amos\core\migration\AmosMigrationTranslations | |
| FIELD_TYPE_BOOL | 'BOOL' | lispa\amos\core\migration\AmosMigrationTranslations | |
| FIELD_TYPE_INT | 'INT' | lispa\amos\core\migration\AmosMigrationTranslations | |
| FIELD_TYPE_STRING | 'STRING' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_DE | 'de-DE' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_EN_GB | 'en-GB' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_EN_US | 'en-US' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_ES | 'es-ES' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_FR | 'fr-FR' | lispa\amos\core\migration\AmosMigrationTranslations | |
| LANG_IT | 'it-IT' | lispa\amos\core\migration\AmosMigrationTranslations |
Method Details
Override this to make operations after adding the translations configurations.
| protected boolean afterAddConfs ( ) |
Override this to make operations after removing the translations configurations.
| protected boolean afterRemoveConfs ( ) |
Override this to make operations before adding the translations configurations.
| protected boolean beforeAddConfs ( ) |
Override this to make operations before removing the translations configurations.
| protected boolean beforeRemoveConfs ( ) |
| public void init ( ) | ||
| throws | Exception | |
|---|---|---|
This method contains the logic to be executed when removing this migration.
This method differs from down() in that the DB logic implemented here will be enclosed within a DB transaction. Child classes may implement this method instead of down() if the DB logic needs to be within a transaction.
Note: Not all DBMS support transactions. And some DB queries cannot be put into a transaction. For some examples,
please refer to implicit commit. If this is the case,
you should still implement up() and down(), instead.
| public boolean safeDown ( ) | ||
| return | boolean | Return a false value to indicate the migration fails and should not proceed further. All other return values mean the migration succeeds. |
|---|---|---|
This method contains the logic to be executed when applying this migration.
This method differs from up() in that the DB logic implemented here will be enclosed within a DB transaction. Child classes may implement this method instead of up() if the DB logic needs to be within a transaction.
Note: Not all DBMS support transactions. And some DB queries cannot be put into a transaction. For some examples,
please refer to implicit commit. If this is the case,
you should still implement up() and down(), instead.
| public boolean safeUp ( ) | ||
| return | boolean | Return a false value to indicate the migration fails and should not proceed further. All other return values mean the migration succeeds. |
|---|---|---|
Override this method to set all the translations configurations.
| protected array setTranslations ( ) |