Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
What's new
10
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Sign in
Toggle navigation
Open sidebar
project
drupal
Commits
99269244
Commit
99269244
authored
Mar 30, 2012
by
jhodgdon
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Issue
#1440834
by nmudgal: Add clarity and information to docs for hook_field_delete/update/insert
parent
e577cff7
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
30 additions
and
7 deletions
+30
-7
core/modules/field/field.api.php
core/modules/field/field.api.php
+30
-7
No files found.
core/modules/field/field.api.php
View file @
99269244
...
...
@@ -426,9 +426,14 @@ function hook_field_presave($entity_type, $entity, $field, $instance, $langcode,
}
/**
* Define custom insert behavior for this module's field
types
.
* Define custom insert behavior for this module's field
data
.
*
* Invoked from field_attach_insert().
* This hook is invoked from field_attach_insert() on the module that defines a
* field, during the process of inserting an entity object (node, taxonomy term,
* etc.). It is invoked just before the data for this field on the particular
* entity object is inserted into field storage. Only field modules that are
* storing or tracking information outside the standard field storage mechanism
* need to implement this hook.
*
* @param $entity_type
* The type of $entity.
...
...
@@ -442,6 +447,9 @@ function hook_field_presave($entity_type, $entity, $field, $instance, $langcode,
* The language associated with $items.
* @param $items
* $entity->{$field['field_name']}[$langcode], or an empty array if unset.
*
* @see hook_field_update()
* @see hook_field_delete()
*/
function
hook_field_insert
(
$entity_type
,
$entity
,
$field
,
$instance
,
$langcode
,
&
$items
)
{
if
(
variable_get
(
'taxonomy_maintain_index_table'
,
TRUE
)
&&
$field
[
'storage'
][
'type'
]
==
'field_sql_storage'
&&
$entity_type
==
'node'
&&
$entity
->
status
)
{
...
...
@@ -459,9 +467,14 @@ function hook_field_insert($entity_type, $entity, $field, $instance, $langcode,
}
/**
* Define custom update behavior for this module's field
types
.
* Define custom update behavior for this module's field
data
.
*
* Invoked from field_attach_update().
* This hook is invoked from field_attach_update() on the module that defines a
* field, during the process of updating an entity object (node, taxonomy term,
* etc.). It is invoked just before the data for this field on the particular
* entity object is updated into field storage. Only field modules that are
* storing or tracking information outside the standard field storage mechanism
* need to implement this hook.
*
* @param $entity_type
* The type of $entity.
...
...
@@ -475,6 +488,9 @@ function hook_field_insert($entity_type, $entity, $field, $instance, $langcode,
* The language associated with $items.
* @param $items
* $entity->{$field['field_name']}[$langcode], or an empty array if unset.
*
* @see hook_field_insert()
* @see hook_field_delete()
*/
function
hook_field_update
(
$entity_type
,
$entity
,
$field
,
$instance
,
$langcode
,
&
$items
)
{
if
(
variable_get
(
'taxonomy_maintain_index_table'
,
TRUE
)
&&
$field
[
'storage'
][
'type'
]
==
'field_sql_storage'
&&
$entity_type
==
'node'
)
{
...
...
@@ -540,10 +556,14 @@ function hook_field_storage_update_field($field, $prior_field, $has_data) {
}
/**
* Define custom delete behavior for this module's field
types
.
* Define custom delete behavior for this module's field
data
.
*
* This hook is invoked just before the data is deleted from field storage
* in field_attach_delete().
* This hook is invoked from field_attach_delete() on the module that defines a
* field, during the process of deleting an entity object (node, taxonomy term,
* etc.). It is invoked just before the data for this field on the particular
* entity object is deleted from field storage. Only field modules that are
* storing or tracking information outside the standard field storage mechanism
* need to implement this hook.
*
* @param $entity_type
* The type of $entity.
...
...
@@ -557,6 +577,9 @@ function hook_field_storage_update_field($field, $prior_field, $has_data) {
* The language associated with $items.
* @param $items
* $entity->{$field['field_name']}[$langcode], or an empty array if unset.
*
* @see hook_field_insert()
* @see hook_field_update()
*/
function
hook_field_delete
(
$entity_type
,
$entity
,
$field
,
$instance
,
$langcode
,
&
$items
)
{
list
(
$id
,
$vid
,
$bundle
)
=
entity_extract_ids
(
$entity_type
,
$entity
);
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment