$params['pod'] string The Pod name (pod or pod_id is required)
$params['pod_id'] string The Pod ID (pod or pod_id is required)
$params['id'] int The item ID
$params['data'] array (optional) Associative array of field names + values
$params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
$params['track_changed_fields'] bool Set to true to enable tracking of saved fields via PodsAPI::get_changed_fields()
/**
* Save an item by giving an array of field data or set a specific field to a specific value.
*
* Though this function has the capacity to add new items, best practice should direct you
* to use add() for that instead.
*
* @see PodsAPI::save_pod_item
*
* @param array|string $data Either an associative array of field information or a field name
* @param mixed $value (optional) Value of the field, if $data is a field name
* @param int $id (optional) ID of the pod item to update
* @param array $params (optional) Additional params to send to save_pod_item
*
* @return int The item ID
*
* @since 2.0
* @link http://pods.io/docs/save/
*/
public function save($data = null, $value = null, $id = null, $params = null)
{
if (null !== $value) {
$data = array($data => $value);
}
$fetch = false;
if (null === $id) {
$fetch = true;
$id = $this->id();
}
$data = (array) $this->do_hook('save', $data, $id);
if (empty($data)) {
return $id;
}
$default = array();
if (!empty($params) && is_array($params)) {
$default = $params;
}
$params = array('pod' => $this->pod, 'id' => $id, 'data' => $data, 'allow_custom_fields' => true);
if (!empty($default)) {
$params = array_merge($params, $default);
}
$id = $this->api->save_pod_item($params);
if (0 < $id && $fetch) {
$this->fetch($id, false);
}
return $id;
}
/**
* Save an item by giving an array of field data or set a specific field to a specific value.
*
* Though this function has the capacity to add new items, best practice should direct you
* to use add() for that instead.
*
* @see PodsAPI::save_pod_item
*
* @param array|string $data Either an associative array of field information or a field name
* @param mixed $value (optional) Value of the field, if $data is a field name
* @param int $id (optional) ID of the pod item to update
* @param array $params (optional) Additional params to send to save_pod_item
*
* @return int The item ID
*
* @since 2.0
* @link http://pods.io/docs/save/
*/
public function save($data = null, $value = null, $id = null, $params = null)
{
if (null !== $value) {
$data = array($data => $value);
}
$fetch = false;
if (null === $id || $this->row && $id == $this->id()) {
$fetch = true;
if (null === $id) {
$id = $this->id();
}
}
$data = (array) $this->do_hook('save', $data, $id);
if (empty($data)) {
return $id;
}
$default = array();
if (!empty($params) && is_array($params)) {
$default = $params;
}
$params = array('pod' => $this->pod, 'id' => $id, 'data' => $data, 'allow_custom_fields' => true, 'clear_slug_cache' => false);
if (!empty($default)) {
$params = array_merge($params, $default);
}
$id = $this->api->save_pod_item($params);
if (0 < $id && $fetch) {
$this->fetch($id, false);
}
if (!empty($this->pod_data['field_slug'])) {
if (0 < $id && $fetch) {
$slug = $this->field($this->pod_data['field_slug']);
} else {
$slug = pods($this->pod, $id)->field($this->pod_data['field_slug']);
}
if (0 < strlen($slug)) {
pods_cache_clear($slug, 'pods_items_' . $this->pod);
}
}
return $id;
}
