public static function message($file, $path = NULL, $default = NULL)
{
static $messages;
if (!isset($messages[$file])) {
$messages[$file] = array();
if ($files = self::load_messages($file)) {
$messages[$file] = Wparr::merge($messages[$file], $files);
}
}
if ($path === NULL) {
return $messages[$file];
} else {
return Wparr::path($messages[$file], $path, $default);
}
}
/**
* Returns the error messages. If no file is specified, the error message
* will be the name of the rule that failed. When a file is specified, the
* message will be loaded from "field/rule", or if no rule-specific message
* exists, "field/default" will be used. If neither is set, the returned
* message will be "file/field/rule".
*
* By default all messages are translated using the default language.
* A string can be used as the second parameter to specified the language
* that the message was written in.
*
* // Get errors from messages/forms/login.php
* $errors = $Validation->errors('forms/login');
*
* @uses Kohana::message
* @param string $file file to load error messages from
* @param mixed $translate translate the message
* @return array
*/
public function errors($file = NULL, $translate = false)
{
if ($file === NULL) {
// Return the error list
return $this->_errors;
}
// Create a new message list
$messages = array();
foreach ($this->_errors as $field => $set) {
list($error, $params) = $set;
// Get the label for this field
$label = $this->_labels[$field];
if ($translate) {
if (is_string($translate)) {
// Translate the label using the specified language
$label = __($label, NULL, $translate);
} else {
// Translate the label
$label = __($label);
}
}
// Start the translation values list
$values = array(':field' => $label, ':value' => Wparr::get($this, $field));
if (is_array($values[':value'])) {
// All values must be strings
$values[':value'] = implode(', ', Wparr::flatten($values[':value']));
}
if ($params) {
foreach ($params as $key => $value) {
if (is_array($value)) {
// All values must be strings
$value = implode(', ', Wparr::flatten($value));
} elseif (is_object($value)) {
// Objects cannot be used in message files
continue;
}
// Check if a label for this parameter exists
if (isset($this->_labels[$value])) {
// Use the label as the value, eg: related field name for "matches"
$value = $this->_labels[$value];
if ($translate) {
if (is_string($translate)) {
// Translate the value using the specified language
$value = __($value, NULL, $translate);
} else {
// Translate the value
$value = __($value);
}
}
}
// Add each parameter as a numbered value, starting from 1
$values[':param' . ($key + 1)] = $value;
}
}
if ($message = Helper::message($file, "{$field}.{$error}") and is_string($message)) {
// Found a message for this field and error
} elseif ($message = Helper::message($file, "{$field}.default") and is_string($message)) {
// Found a default message for this field
} elseif ($message = Helper::message($file, $error) and is_string($message)) {
// Found a default message for this error
} elseif ($message = Helper::message('validation', $error) and is_string($message)) {
// Found a default message for this error
} else {
// No message exists, display the path expected
$message = "{$file}.{$field}.{$error}";
}
if ($translate) {
if (is_string($translate)) {
// Translate the message using specified language
$message = __($message, $values, $translate);
} else {
// Translate the message using the default language
$message = __($message, $values);
}
} else {
// Do not translate, just replace the values
$message = strtr($message, $values);
}
// Set the message for this field
$messages[$field] = $message;
}
return $messages;
}
public static function flatten($array)
{
$is_assoc = Wparr::is_assoc($array);
$flat = array();
foreach ($array as $key => $value) {
if (is_array($value)) {
$flat = array_merge($flat, Wparr::flatten($value));
} else {
if ($is_assoc) {
$flat[$key] = $value;
} else {
$flat[] = $value;
}
}
}
return $flat;
}
