pieceofcake2 / localized
CakePHP 2 Localized Plugin
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 175
Type:cakephp-plugin
Requires
- php: ^8.0
- composer/installers: *
- pieceofcake2/cakephp: ^2.10
Requires (Dev)
- cakephp/cakephp-codesniffer: ^5.0
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^9.6
- pieceofcake2/app: ^2.1
- pieceofcake2/phpstan-cakephp2: ^0.2.1
Replaces
- cakephp/localized: ^2.0
README
This is forked for CakePHP2.
This plugin contains various localized validation classes for specific countries.
Requirements
The master branch has the following requirements:
- CakePHP 2.1.0 or greater.
- PHP 8.0 or greater.
Installation
Install the plugin with Composer:
composer require pieceofcake2/localized
Then load the plugin in app/Config/bootstrap.php
:
CakePlugin::load('Localized');
Model validation
Localized validation classes can be used for validating model fields.
<?php App::uses('MxValidation', 'Localized.Validation'); class Post extends AppModel { public $validate = [ 'postal' => [ 'valid' => [ 'rule' => array('postal', null, 'mx'), 'message' => 'Must be valid mexico postal code', ], ], ]; }
For further information on validation rules see the cakephp documentation on validation
Using localized validations with Validation
You can also access the localized validators any time you would call Validation
methods. After importing the validation class.
if (Validation::postal($value, null, 'cz')) { // Do something with valid postal code }
Dynamic forwarding of validation
Using a snippet like the following could reduce the manual include/setup part when using multiple localizations:
// Inside your custom validation rule validatePostal() // $country (de, at, ...) and $value (12345, 1234, ...) given $className = ucfirst($country) . 'Validation'; App::uses($className, 'Localized.Validation'); // Skip if we don't have that country, then only check for existence if (!class_exists($className) || !method_exists($className, 'postal')) { return !empty($value); } try { $result = Validation::postal($value, null, $country); } catch (NotImplementedException $e) { $result = !empty($value); } return $result;
PO files
This plugin also houses translations for the client-facing translated strings in the core (the cake
domain). to use these files link or copy them
into their expected location: APP/Locale/<locale>/LC_MESSAGES/cake.po
LC_TIME files
This plugin also houses POSIX compliant LC_TIME files which are used for translating
time related string of LC_TIME domain. To use these files link or copy them into
their expected location: APP/Locale/<locale>/LC_TIME
.
Migration Guide
Localized.Validation
The lib path for validation files changed. They should now be either in APP/Validation/
or in APP/PluginName/Validation/
.
You also need to adjust your App::uses() statements in your code accordingly:
App::uses('MxValidation', 'Localized.Lib');
is now App::uses('MxValidation', 'Localized.Validation');
Contributing to Localized
If you find that your country is not part of the Localized plugin, please fork the project on github. Once you have forked the project you can commit your validator class (and any test cases). Once you have pushed your changes back to github send a pull request, and your changes will be reviewed and merged in or feedback will be given.
Validation methods
There are a few methods that are common to all classes, defined through the interface "ValidationInterface":
phone()
to check a phone numberpostal()
to check a postal codepersonId()
(andssn()
for BC) to check a country specific person ID
Please try to fit your validation rules in that naming scheme. Apart from that you can also define further validation methods in your implementing class, of course.
Issues with Localized
If you have issues with Localized, you can report them at https://github.com/pieceofcake2/localized/issues