MgdSchema method create

Midgard 1.9:

Events

Notes

Description:

bool $obj->create(void)

Minimum version: Midgard 1.7

Creates MgdSchema object's record(s) in database.

title = 'MyTitle';  
    $object->name = 'Some Name';  
    $object->topic = 3;  /* holds parentfield value */
  
    if ($object->create()) {
         echo "Object created with id {$object->id}";
    } else {
         echo 'Failed to create object, reason '.mgd_errstr();
    }
    ?>

Returns TRUE when object is successfully created, FALSE otherwise

When create method is invoked , such properties are being internally set:

guid (since Midgard 1.8)
id (if set as primary property)
metadata.creator (since Midgard 1.8)
metadata.created (since Midgard 1.8)
metadata.revisor (since Midgard 1.8)
metadata.revised (since Midgard 1.8)
metadata.revision (since Midgard 1.8)
metadata.published (since Midgard 1.8)

More about midgard_metadata object.

Since Midgard 1.8 , Midgard Administrator (Sitegroup 0) is able to specify sitegroup of a created object.

<?php

$host = new midgard_host();
$host->name = 'www.example.com';
$host->sitegroup = 5;
$host->create();
?>

Midgard 1.9:

Events

action_create event is emited when method is invoked
action_created is emited if object is created
action_create_hook event is emited by extension before core's create method is invoked

Notes

Follow mgd_errstr() function to get error message on failure.

Midgard error codes are descibed in midgard_object_create ( part of midgard-core ) ducumentation.

Remember that parentfield should be defined in object's property if object has such definition in MgdSchema.
Read about metadata constants if you want to get property which stores parentfield value.