/** * @param string|int $field Field name or ID * @param mixed $value Field value * @param bool $loadIn Populate the data fields without marking as changed */ public function setField($field, $value, $loadIn = false) { if (empty($field)) { trigger_error("Field not specified", E_USER_ERROR); } // Set id, libraryID, and key without loading data first switch ($field) { case 'id': case 'libraryID': case 'key': // Allow libraryID to be set if empty, even if primary data is loaded, // which happens if an item type is set in the constructor if ($field == 'libraryID' && !$this->{$field}) { } else { if ($this->loaded['primaryData']) { throw new Exception("Cannot set {$field} after item is already loaded"); } } //this._checkValue(field, val); $this->{$field} = $value; return; } if ($this->id || $this->key) { if (!$this->loaded['primaryData']) { $this->loadPrimaryData(true); } } else { $this->loaded['primaryData'] = true; } // Primary field if (in_array($field, Zotero_Items::$primaryFields)) { if ($loadIn) { throw new Exception("Cannot set primary field {$field} in loadIn mode"); } switch ($field) { case 'itemID': case 'serverDateModified': case 'itemVersion': case 'numNotes': case 'numAttachments': trigger_error("Primary field '{$field}' cannot be changed through setField()", E_USER_ERROR); } if (!Zotero_ItemFields::validate($field, $value)) { trigger_error("Value '{$value}' of type " . gettype($value) . " does not validate for field '{$field}'", E_USER_ERROR); } if ($this->{$field} != $value) { Z_Core::debug("Field {$field} has changed from {$this->{$field}} to {$value}", 4); if ($field == 'itemTypeID') { $this->setType($value, $loadIn); } else { $this->{$field} = $value; $this->changed['primaryData'][$field] = true; } } return true; } // // itemData field // if (!$this->itemTypeID) { trigger_error('Item type must be set before setting field data', E_USER_ERROR); } // If existing item, load field data first unless we're already in // the middle of a load if ($this->id) { if (!$loadIn && !$this->loaded['itemData']) { $this->loadItemData(); } } else { $this->loaded['itemData'] = true; } $fieldID = Zotero_ItemFields::getID($field); if (!$fieldID) { throw new Exception("'{$field}' is not a valid itemData field.", Z_ERROR_INVALID_INPUT); } if ($value !== false && !Zotero_ItemFields::isValidForType($fieldID, $this->itemTypeID)) { throw new Exception("'{$field}' is not a valid field for type '" . Zotero_ItemTypes::getName($this->itemTypeID) . "'", Z_ERROR_INVALID_INPUT); } if (!$loadIn) { // Save date field as multipart date if (Zotero_ItemFields::isFieldOfBase($fieldID, 'date') && !Zotero_Date::isMultipart($value)) { $value = Zotero_Date::strToMultipart($value); } else { if ($fieldID == Zotero_ItemFields::getID('accessDate')) { if ($value && (!Zotero_Date::isSQLDate($value) && !Zotero_Date::isSQLDateTime($value) && $value != 'CURRENT_TIMESTAMP')) { Z_Core::debug("Discarding invalid accessDate '" . $value . "'"); return false; } } } // If existing value, make sure it's actually changing if (!isset($this->itemData[$fieldID]) && $value === false || isset($this->itemData[$fieldID]) && $this->itemData[$fieldID] === $value) { return false; } // TODO: Save a copy of the object before modifying? } $this->itemData[$fieldID] = $value; if (!$loadIn) { $this->changed['itemData'][$fieldID] = true; } return true; }