• ⌂ cObject
• Methods
  • Constructor
  • add_variant()
  • approve()
  • as_array()
  • can_add_variant()
  • can_delete_variant()
  • can_edit_variant()
  • can_reorder_variant()
  • clone()
  • delete()
  • edit_variant()
  • enum()
  • get_active_object()
  • get_all_variants()
  • get_attributes()
  • get_dimensions()
  • get_dimension_with()
  • get_parent()
  • get_primary_cpath()
  • get_variant()
  • Keywords()
  • lock_object()
  • reload_data()
  • repo()
  • revert()
  • save()
  • store()
  • unlock_object()
  • update_from_array()
  • validate()

cObject::add_variant()

Creates a new variant for the content object this model represents.  The new variant's initial values will be based on the values of this model, with the exception of the dimensions passed here as an option.

Prototype

cObject add_variant(cObject|array $dimensions = NULL)

Parameters

• dimensions - The dimension or array of dimensions to apply to the new variant.  If none are specified, the new variant will have the same dimensions as the one it is copied from.

Return

The cObject representing the new variant.

Example

$repo = comand::repo();

// get Spanish Language Dimension
$es = $repo->get_first("FROM Language WHERE Title='Spanish'");

// get the Spanish variant of an Article, if it exists
$article = $repo->get_first("FROM Article WHERE Title='Article Title'");
$article_es = $article->get_variant($es);
if(!$article_es) {
    // if a Spanish variant doesn't exist, add one
    $article_es = $article->add_variant($es);
}
// update the approved Spanish variant title
$article_es->Title = 'Título del artículo';
$article_es->approve();

Related

edit_variant(), can_add_variant()

• < Constructor
• approve() >