<?php
App::uses('Model', 'Model');
/**
* Application model
*
* This file is the base model of all other models
*
* PHP version 5
*
* @category Models
* @package Croogo
* @version 1.0
* @author Fahad Ibnay Heylaal <hide@address.com>
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
* @link http://www.croogo.org
*/
class AppModel extends Model {
/**
* use Caching
*
* @var string
*/
public $useCache = true;
/**
* Display fields for admin_index. Use displayFields()
*
* @var array
* @access protected
*/
protected $_displayFields = array();
/**
* Edit fields for admin_edit. Use editFields()
*
* @var array
* @access protected
*/
protected $_editFields = array();
/**
* Constructor
*
* @param mixed $id Set this ID for this model on startup, can also be an array of options, see above.
* @param string $table Name of database table to use.
* @param string $ds DataSource connection name.
*/
public function __construct($id = false, $table = null, $ds = null) {
Croogo::applyHookProperties('Hook.model_properties', $this);
parent::__construct($id, $table, $ds);
}
/**
* Override find function to use caching
*
* Caching can be done either by unique names,
* or prefixes where a hashed value of $options array is appended to the name
*
* @param mixed $type
* @param array $options
* @return mixed
* @access public
*/
public function find($type = 'first', $options = array()) {
if ($this->useCache) {
$cachedResults = $this->_findCached($type, $options);
if ($cachedResults) {
return $cachedResults;
}
}
$args = func_get_args();
$results = call_user_func_array(array('parent', 'find'), $args);
if ($this->useCache) {
if (isset($options['cache']['name']) && isset($options['cache']['config'])) {
$cacheName = $options['cache']['name'];
} elseif (isset($options['cache']['prefix']) && isset($options['cache']['config'])) {
$cacheName = $options['cache']['prefix'] . md5(serialize($options));
}
if (isset($cacheName)) {
$cacheName .= '_' . Configure::read('Config.language');
Cache::write($cacheName, $results, $options['cache']['config']);
}
}
return $results;
}
/**
* Check if find() was already cached
*
* @param mixed $type
* @param array $options
* @return void
* @access private
*/
protected function _findCached($type, $options) {
if (isset($options['cache']['name']) && isset($options['cache']['config'])) {
$cacheName = $options['cache']['name'];
} elseif (isset($options['cache']['prefix']) && isset($options['cache']['config'])) {
$cacheName = $options['cache']['prefix'] . md5(serialize($options));
} else {
return false;
}
$cacheName .= '_' . Configure::read('Config.language');
$results = Cache::read($cacheName, $options['cache']['config']);
if ($results) {
return $results;
}
return false;
}
/**
* Updates multiple model records based on a set of conditions.
*
* call afterSave() callback after successful update.
*
* @param array $fields Set of fields and values, indexed by fields.
* Fields are treated as SQL snippets, to insert literal values manually escape your data.
* @param mixed $conditions Conditions to match, true for all records
* @return boolean True on success, false on failure
* @access public
*/
public function updateAll($fields, $conditions = true) {
$args = func_get_args();
$output = call_user_func_array(array('parent', 'updateAll'), $args);
if ($output) {
$created = false;
$options = array();
$field = sprintf('%s.%s', $this->alias, $this->primaryKey);
if (!empty($args[1][$field])) {
foreach ($args[1][$field] as $id) {
$this->id = $id;
$event = new CakeEvent('Model.afterSave', $this, array(
$created, $options
));
$this->getEventManager()->dispatch($event);
}
}
$this->_clearCache();
return true;
}
return false;
}
/**
* Fix to the Model::invalidate() method to display localized validate messages
*
* @param string $field The name of the field to invalidate
* @param mixed $value Name of validation rule that was not failed, or validation message to
* be returned. If no validation key is provided, defaults to true.
* @access public
*/
public function invalidate($field, $value = true) {
return parent::invalidate($field, __($value));
}
/**
* Return formatted display fields
*
* @param array $displayFields
* @return array
*/
public function displayFields($displayFields = null) {
if (isset($displayFields)) {
$this->_displayFields = $displayFields;
}
$out = array();
$defaults = array('sort' => true, 'type' => 'text', 'url' => array(), 'options' => array());
foreach ($this->_displayFields as $field => $label) {
if (is_int($field)) {
$field = $label;
list(, $label) = pluginSplit($label);
$out[$field] = Set::merge($defaults, array(
'label' => Inflector::humanize($label),
));
} elseif (is_array($label)) {
$out[$field] = Set::merge($defaults, $label);
if (!isset($out[$field]['label'])) {
$out[$field]['label'] = Inflector::humanize($field);
}
} else {
$out[$field] = Set::merge($defaults, array(
'label' => $label,
));
}
}
return $out;
}
/**
* Return formatted edit fields
*
* @param array $editFields
* @return array
*/
public function editFields($editFields = null) {
if (isset($editFields)) {
$this->_editFields = $editFields;
}
if (empty($this->_editFields)) {
$this->_editFields = array_keys($this->schema());
$id = array_search('id', $this->_editFields);
if ($id !== false) {
unset($this->_editFields[$id]);
}
}
$out = array();
foreach ($this->_editFields as $field => $label) {
if (is_int($field)) {
$out[$label] = array();
} elseif (is_array($label)) {
$out[$field] = $label;
} else {
$out[$field] = array(
'label' => $label,
);
}
}
return $out;
}
/**
* Validation method for alias field
* @return bool true when validation successful
* @deprecated Protected validation methods are no longer supported
*/
protected function _validAlias($check) {
return $this->validAlias($check);
}
/**
* Validation method for name or title fields
* @return bool true when validation successful
* @deprecated Protected validation methods are no longer supported
*/
protected function _validName($check) {
return $this->validName($check);
}
/**
* Validation method for alias field
*
* @return bool true when validation successful
*/
public function validAlias($check) {
return (preg_match('/^[\p{Ll}\p{Lm}\p{Lo}\p{Lt}\p{Lu}\p{Nd}-_]+$/mu', $check[key($check)]) == 1);
}
/**
* Validation method for name or title fields
*
* @return bool true when validation successful
*/
public function validName($check) {
return (preg_match('/^[\p{Ll}\p{Lm}\p{Lo}\p{Lt}\p{Lu}\p{Nd}-_\[\]\(\) ]+$/mu', $check[key($check)]) == 1);
}
}