How do I load a field collection from a node?

Question

I have a node that has a few field collections on it.

When I look at node_load() output, I see:

[field_rich_text_group] => Array
        (
            [und] => Array
                (
                    [0] => Array
                        (
                            [value] => 6
                        )

                    [1] => Array
                        (
                            [value] => 7
                        )

                    [2] => Array
                        (
                            [value] => 8
                        )

                )

        )

What API function can I use to actually load the field data contained in the collection that has an entity_id of 6, 7, 8, etc?

Answer 1

Doh! I should have looked in the field collection module:

entity_load('field_collection_item', array($item_id))

Answer 2

There is also a wrapper function that does the same trick:

field_collection_item_load($id, $reset = FALSE)

or as per comment, use:

field_collection_item_load_multiple($ids = array(), $conditions = array(), $reset = FALSE)

to load multiple collections (for example if you have an Add more buttons).

Answer 3

field_collection_field_get_entity() should be used in order to load the correct revision.

Example usage:

$node = node_load(1);
$items = field_get_items('node', $node, 'field_fc');
foreach ($items as $item) {
 $fc = field_collection_field_get_entity($item);
 // Do something.
}

Answer 4

You can use entity_metadata_wrapper from the Entity API module:

$node_wrapper = entity_metadata_wrapper('node', $node);
$field_collection = $node_wrapper->field_rich_text_group[0]->value();
dpm($field_collection);

You can loop all the collections as well:

$node_wrapper = entity_metadata_wrapper('node', $node);
foreach ($node_wrapper->field_rich_text_group as $field_collection_wrapper) {
  $field_collection = $field_collection_wrapper->value();
  dpm($field_collection);
}