Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Generates a random database prefix, runs the install scripts on the
prefixed database and enable the specified modules. After installation
many caches are flushed and the internal browser is setup so that the
page requests will run on the new prefix.…

Code

<?php
functionfield_create_instance($instance) {
$field = field_read_field($instance['field_name']);
if (empty($field)) {
throw newFieldException(t("Attempt to create an instance of a field @field_name that doesn't exist or is currently inactive.", array('@field_name' => $instance['field_name'])));
}
// Check that the required properties exists.
if (empty($instance['entity_type'])) {
throw newFieldException(t('Attempt to create an instance of field @field_name without an entity type.', array('@field_name' => $instance['field_name'])));
}
if (empty($instance['bundle'])) {
throw newFieldException(t('Attempt to create an instance of field @field_name without a bundle.', array('@field_name' => $instance['field_name'])));
}
// Check that the field can be attached to this entity type.
if (!empty($field['entity_types']) && !in_array($instance['entity_type'], $field['entity_types'])) {
throw newFieldException(t('Attempt to create an instance of field @field_name on forbidden entity type @entity_type.', array('@field_name' => $instance['field_name'], '@entity_type' => $instance['entity_type'])));
}
// Set the field id.
$instance['field_id'] = $field['id'];
// Note that we do *not* prevent creating a field on non-existing bundles,
// because that would break the 'Body as field' upgrade for contrib
// node types.
// TODO: Check that the widget type is known and can handle the field type ?
// TODO: Check that the formatters are known and can handle the field type ?
// TODO: Check that the display view modes are known for the entity type ?
// Those checks should probably happen in _field_write_instance() ?
// Problem : this would mean that a UI module cannot update an instance with a disabled formatter.
// Ensure the field instance is unique within the bundle.
// We only check for instances of active fields, since adding an instance of
// a disabled field is not supported.
$prior_instance = field_read_instance($instance['entity_type'], $instance['field_name'], $instance['bundle']);
if (!empty($prior_instance)) {
$message = t('Attempt to create an instance of field @field_name on bundle @bundle that already has an instance of that field.', array('@field_name' => $instance['field_name'], '@bundle' => $instance['bundle']));
throw newFieldException($message);
}
_field_write_instance($instance);
// Clear caches
field_cache_clear();
// Invoke external hooks after the cache is cleared for API consistency.
module_invoke_all('field_create_instance', $instance);
return$instance;
}
?>