W3cubDocs

/CakePHP 4.1

Trait TranslateStrategyTrait

Contains common code needed by TranslateBehavior strategy classes.

Namespace: Cake\ORM\Behavior\Translate

Properties summary

  • $locale protected
    string|null

    The locale name that will be used to override fields in the bound table from the translations table

  • $table protected
    \Cake\ORM\Table

    Table instance

  • $translationTable protected
    \Cake\ORM\Table

    Instance of Table responsible for translating

Method Summary

Method Detail

afterSave() public 

afterSave(\Cake\Event\EventInterface $event, \Cake\Datasource\EntityInterface $entity)

Unsets the temporary _i18n property after the entity has been saved

Parameters

\Cake\Event\EventInterface $event

The beforeSave event that was fired

\Cake\Datasource\EntityInterface $entity

The entity that is going to be saved

buildMarshalMap() public 

buildMarshalMap(\Cake\ORM\Marshaller $marshaller, array $map, array $options)

Build a set of properties that should be included in the marshalling process.

Add in _translations marshalling handlers. You can disable marshalling of translations by setting 'translations' => false in the options provided to Table::newEntity() or Table::patchEntity().

Parameters

\Cake\ORM\Marshaller $marshaller

The marhshaller of the table the behavior is attached to.

array $map

The property map being built.

array $options

The options array used in the marshalling call.

Returns

array

A map of [property => callable] of additional properties to marshal.

getLocale() public 

getLocale()

Returns the current locale.

If no locale has been explicitly set via setLocale(), this method will return the currently configured global locale.

Returns

string

See Also

\Cake\I18n\I18n::getLocale()

\Cake\ORM\Behavior\TranslateBehavior::setLocale()

getTranslationTable() public 

getTranslationTable()

Return translation table instance.

Returns

\Cake\ORM\Table

setLocale() public 

setLocale(?string $locale)

Sets the locale to be used.

When fetching records, the content for the locale set via this method, and likewise when saving data, it will save the data in that locale.

Note that in case an entity has a _locale property set, that locale will win over the locale set via this method (and over the globally configured one for that matter)!

Parameters

string|null $locale

The locale to use for fetching and saving records. Pass null in order to unset the current locale, and to make the behavior fall back to using the globally configured locale.

Returns

$this

unsetEmptyFields() protected 

unsetEmptyFields(mixed $entity)

Unset empty translations to avoid persistence.

Should only be called if $this->_config['allowEmptyTranslations'] is false.

Parameters

\Cake\Datasource\EntityInterface $entity

The entity to check for empty translations fields inside.

Property Detail

$locale protected

The locale name that will be used to override fields in the bound table from the translations table

Type

string|null

$table protected

Table instance

Type

\Cake\ORM\Table

$translationTable protected

Instance of Table responsible for translating

Type

\Cake\ORM\Table

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/trait-Cake.ORM.Behavior.Translate.TranslateStrategyTrait.html