public static function newTagInstance($sTagName, $sModelName, $iTaggedItemId)
{
$sTagName = StringUtil::normalize($sTagName);
$oTag = TagPeer::retrieveByName($sTagName);
if ($oTag === null) {
$oTag = new Tag();
$oTag->setName($sTagName);
$oTag->save();
}
$oTagInstance = self::retrieveByPK($oTag->getId(), $iTaggedItemId, $sModelName);
if ($oTagInstance !== null) {
throw new Exception("Instance of this tag does already exist");
}
$oTagInstance = new TagInstance();
$oTagInstance->setTag($oTag);
$oTagInstance->setModelName($sModelName);
$oTagInstance->setTaggedItemId($iTaggedItemId);
$oTagInstance->save();
return $oTagInstance;
}
/**
* Add a tag to the Page given by the id
*/
public static function addTagTo($sPageId, $mTag)
{
if ($mTag instanceof TagInstance) {
$mTag = $mTag->getTag();
}
if ($mTag instanceof Tag) {
$mTag = $mTag->getName();
}
$sTagName = StringUtil::normalize($mTag);
$oTag = TagQuery::create()->findOneByName($sTagName);
if ($oTag === null) {
$oTag = new Tag();
$oTag->setName($sTagName);
$oTag->save();
}
$oTagInstance = TagInstanceQuery::create()->findPk(array($oTag->getId(), $sPageId, "Page"));
if ($oTagInstance !== null) {
return $oTagInstance;
}
$oTagInstance = new TagInstance();
$oTagInstance->setTag($oTag);
$oTagInstance->setModelName("Page");
$oTagInstance->setTaggedItemId($sPageId);
$oTagInstance->save();
return $oTagInstance;
}
/**
* Exclude object from result
*
* @param TagInstance $tagInstance Object to remove from the list of results
*
* @return TagInstanceQuery The current query, for fluid interface
*/
public function prune($tagInstance = null)
{
if ($tagInstance) {
$this->addCond('pruneCond0', $this->getAliasedColName(TagInstancePeer::TAG_ID), $tagInstance->getTagId(), Criteria::NOT_EQUAL);
$this->addCond('pruneCond1', $this->getAliasedColName(TagInstancePeer::TAGGED_ITEM_ID), $tagInstance->getTaggedItemId(), Criteria::NOT_EQUAL);
$this->addCond('pruneCond2', $this->getAliasedColName(TagInstancePeer::MODEL_NAME), $tagInstance->getModelName(), Criteria::NOT_EQUAL);
$this->combine(array('pruneCond0', 'pruneCond1', 'pruneCond2'), Criteria::LOGICAL_OR);
}
return $this;
}
/**
* Adds an object to the instance pool.
*
* Propel keeps cached copies of objects in an instance pool when they are retrieved
* from the database. In some cases -- especially when you override doSelect*()
* methods in your stub classes -- you may need to explicitly add objects
* to the cache in order to ensure that the same objects are always returned by doSelect*()
* and retrieveByPK*() calls.
*
* @param TagInstance $obj A TagInstance object.
* @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally).
*/
public static function addInstanceToPool($obj, $key = null)
{
if (Propel::isInstancePoolingEnabled()) {
if ($key === null) {
$key = serialize(array((string) $obj->getTagId(), (string) $obj->getTaggedItemId(), (string) $obj->getModelName()));
}
// if key === null
TagInstancePeer::$instances[$key] = $obj;
}
}
/**
* @param TagInstance $tagInstance The tagInstance object to add.
*/
protected function doAddTagInstance($tagInstance)
{
$this->collTagInstances[] = $tagInstance;
$tagInstance->setTag($this);
}
/**
* Filter the query by a related TagInstance object
*
* @param TagInstance|PropelObjectCollection $tagInstance the related object to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return UserQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByTagInstanceRelatedByUpdatedBy($tagInstance, $comparison = null)
{
if ($tagInstance instanceof TagInstance) {
return $this->addUsingAlias(UserPeer::ID, $tagInstance->getUpdatedBy(), $comparison);
} elseif ($tagInstance instanceof PropelObjectCollection) {
return $this->useTagInstanceRelatedByUpdatedByQuery()->filterByPrimaryKeys($tagInstance->getPrimaryKeys())->endUse();
} else {
throw new PropelException('filterByTagInstanceRelatedByUpdatedBy() only accepts arguments of type TagInstance or PropelCollection');
}
}
