diff --git a/sites/all/modules/field_collection/LICENSE.txt b/sites/all/modules/field_collection/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d159169d1050894d3ea3b98e1c965c4058208fe1
--- /dev/null
+++ b/sites/all/modules/field_collection/LICENSE.txt
@@ -0,0 +1,339 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ GNU GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author
+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. Here is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ <signature of Ty Coon>, 1 April 1989
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.
diff --git a/sites/all/modules/field_collection/README.txt b/sites/all/modules/field_collection/README.txt
new file mode 100644
index 0000000000000000000000000000000000000000..6ae4ab265ced1ce4d8500360833ee8fbfcda7928
--- /dev/null
+++ b/sites/all/modules/field_collection/README.txt
@@ -0,0 +1,36 @@
+
+Field collection
+-----------------
+Provides a field collection field, to which any number of fields can be attached.
+
+Each field collection item is internally represented as an entity, which is
+referenced via the field collection field in the host entity. While
+conceptually field collections are treated as part of the host entity, each
+field collection item may also be viewed and edited separately.
+
+
+ Usage
+ ------
+
+ * Add a field collection field to any entity, e.g. to a node. For that use the
+ the usual "Manage fields" interface provided by the "field ui" module of
+ Drupal, e.g. "Admin -> Structure-> Content types -> Article -> Manage fields".
+
+ * Then go to "Admin -> Structure-> Field collection" to define some fields for
+ the created field collection.
+
+ * By the default, the field collection is not shown during editing of the host
+ entity. However, some links for adding, editing or deleting field collection
+ items is shown when the host entity is viewed.
+
+ * Widgets for embedding the form for creating field collections in the
+ host-entity can be provided by any module. In future the field collection
+ module might provide such widgets itself too.
+
+
+Restrictions
+-------------
+
+ * As of now, the field collection field does not properly respect different
+ languages of the host entity. Thus, for now it is suggested to only use the
+ field for entities that are not translatable.
\ No newline at end of file
diff --git a/sites/all/modules/field_collection/field-collection-item.tpl.php b/sites/all/modules/field_collection/field-collection-item.tpl.php
new file mode 100644
index 0000000000000000000000000000000000000000..8d345cb6c55221dcf3cddff3eae47346880a383c
--- /dev/null
+++ b/sites/all/modules/field_collection/field-collection-item.tpl.php
@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * @file
+ * Default theme implementation for field collection items.
+ *
+ * Available variables:
+ * - $content: An array of comment items. Use render($content) to print them all, or
+ * print a subset such as render($content['field_example']). Use
+ * hide($content['field_example']) to temporarily suppress the printing of a
+ * given element.
+ * - $title: The (sanitized) field collection item label.
+ * - $url: Direct url of the current entity if specified.
+ * - $page: Flag for the full page state.
+ * - $classes: String of classes that can be used to style contextually through
+ * CSS. It can be manipulated through the variable $classes_array from
+ * preprocess functions. By default the following classes are available, where
+ * the parts enclosed by {} are replaced by the appropriate values:
+ * - entity-field-collection-item
+ * - field-collection-item-{field_name}
+ *
+ * Other variables:
+ * - $classes_array: Array of html class attribute values. It is flattened
+ * into a string within the variable $classes.
+ *
+ * @see template_preprocess()
+ * @see template_preprocess_entity()
+ * @see template_process()
+ */
+?>
+<div class="<?php print $classes; ?> clearfix"<?php print $attributes; ?>>
+ <div class="content"<?php print $content_attributes; ?>>
+ <?php
+ print render($content);
+ ?>
+ </div>
+</div>
diff --git a/sites/all/modules/field_collection/field_collection.admin.inc b/sites/all/modules/field_collection/field_collection.admin.inc
new file mode 100644
index 0000000000000000000000000000000000000000..b6328a44ff4ed9e537fed0c03054448bb6f2a921
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.admin.inc
@@ -0,0 +1,47 @@
+<?php
+
+/**
+ * @file
+ * Provides the field_collection module admin pages.
+ */
+
+/**
+ * Menu callback; list all field collections on this site.
+ */
+function field_collections_overview() {
+ $instances = field_info_instances();
+ $field_types = field_info_field_types();
+ $bundles = field_info_bundles();
+ $header = array(t('Field name'), t('Used in'), array('data' => t('Operations'), 'colspan' => '2'));
+ $rows = array();
+ foreach ($instances as $entity_type => $type_bundles) {
+ foreach ($type_bundles as $bundle => $bundle_instances) {
+ foreach ($bundle_instances as $field_name => $instance) {
+ $field = field_info_field($field_name);
+ if ($field['type'] == 'field_collection') {
+ $admin_path = _field_ui_bundle_admin_path($entity_type, $bundle);
+ $rows[$field_name]['class'] = $field['locked'] ? array('menu-disabled') : array('');
+
+ $rows[$field_name]['data'][0] = $field['locked'] ? t('@field_name (Locked)', array('@field_name' => $field_name)) : $field_name;
+ $rows[$field_name]['data'][1][] = l($bundles[$entity_type][$bundle]['label'], $admin_path . '/fields');
+ }
+ }
+ }
+ }
+ foreach ($rows as $field_name => $cell) {
+ $rows[$field_name]['data'][1] = implode(', ', $cell['data'][1]);
+
+ $field_name_url_str = strtr($field_name, array('_' => '-'));
+ $rows[$field_name]['data'][2] = l(t('manage fields'), 'admin/structure/field-collections/' . $field_name_url_str . '/fields');
+ $rows[$field_name]['data'][3] = l(t('manage display'), 'admin/structure/field-collections/' . $field_name_url_str . '/display');
+ }
+ if (empty($rows)) {
+ $output = t('No field collections have been defined yet. To do so attach a field collection field to any entity.');
+ }
+ else {
+ // Sort rows by field name.
+ ksort($rows);
+ $output = theme('table', array('header' => $header, 'rows' => $rows));
+ }
+ return $output;
+}
diff --git a/sites/all/modules/field_collection/field_collection.api.php b/sites/all/modules/field_collection/field_collection.api.php
new file mode 100644
index 0000000000000000000000000000000000000000..28e827376da860286c51e994f8b35966a3464f34
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.api.php
@@ -0,0 +1,169 @@
+<?php
+
+/**
+ * @file
+ * Contains API documentation and examples for the Field collection module.
+ */
+
+/**
+ * @addtogroup hooks
+ * @{
+ */
+
+/**
+ * Alter whether a field collection item is considered empty.
+ *
+ * This hook allows modules to determine whether a field collection is empty
+ * before it is saved.
+ *
+ * @param boolean $empty
+ * Whether or not the field should be considered empty.
+ * @param FieldCollectionItemEntity $item
+ * The field collection we are currently operating on.
+ */
+function hook_field_collection_is_empty_alter(&$is_empty, FieldCollectionItemEntity $item) {
+ if (isset($item->my_field) && empty($item->my_field)) {
+ $is_empty = TRUE;
+ }
+}
+
+/**
+ * Acts on field collections being loaded from the database.
+ *
+ * This hook is invoked during field collection item loading, which is handled
+ * by entity_load(), via the EntityCRUDController.
+ *
+ * @param array $entities
+ * An array of field collection item entities being loaded, keyed by id.
+ *
+ * @see hook_entity_load()
+ */
+function hook_field_collection_item_load(array $entities) {
+ $result = db_query('SELECT pid, foo FROM {mytable} WHERE pid IN(:ids)', array(':ids' => array_keys($entities)));
+ foreach ($result as $record) {
+ $entities[$record->pid]->foo = $record->foo;
+ }
+}
+
+/**
+ * Responds when a field collection item is inserted.
+ *
+ * This hook is invoked after the field collection item is inserted into the
+ * database.
+ *
+ * @param FieldCollectionItemEntity $field_collection_item
+ * The field collection item that is being inserted.
+ *
+ * @see hook_entity_insert()
+ */
+function hook_field_collection_item_insert(FieldCollectionItemEntity $field_collection_item) {
+ db_insert('mytable')->fields(array(
+ 'id' => entity_id('field_collection_item', $field_collection_item),
+ 'extra' => print_r($field_collection_item, TRUE),
+ ))->execute();
+}
+
+/**
+ * Acts on a field collection item being inserted or updated.
+ *
+ * This hook is invoked before the field collection item is saved to the database.
+ *
+ * @param FieldCollectionItemEntity $field_collection_item
+ * The field collection item that is being inserted or updated.
+ *
+ * @see hook_entity_presave()
+ */
+function hook_field_collection_item_presave(FieldCollectionItemEntity $field_collection_item) {
+ $field_collection_item->name = 'foo';
+}
+
+/**
+ * Responds to a field collection item being updated.
+ *
+ * This hook is invoked after the field collection item has been updated in the
+ * database.
+ *
+ * @param FieldCollectionItemEntity $field_collection_item
+ * The field collection item that is being updated.
+ *
+ * @see hook_entity_update()
+ */
+function hook_field_collection_item_update(FieldCollectionItemEntity $field_collection_item) {
+ db_update('mytable')
+ ->fields(array('extra' => print_r($field_collection_item, TRUE)))
+ ->condition('id', entity_id('field_collection_item', $field_collection_item))
+ ->execute();
+}
+
+/**
+ * Responds to field collection item deletion.
+ *
+ * This hook is invoked after the field collection item has been removed from
+ * the database.
+ *
+ * @param FieldCollectionItemEntity $field_collection_item
+ * The field collection item that is being deleted.
+ *
+ * @see hook_entity_delete()
+ */
+function hook_field_collection_item_delete(FieldCollectionItemEntity $field_collection_item) {
+ db_delete('mytable')
+ ->condition('pid', entity_id('field_collection_item', $field_collection_item))
+ ->execute();
+}
+
+/**
+ * Act on a field collection item that is being assembled before rendering.
+ *
+ * @param $field_collection_item
+ * The field collection item entity.
+ * @param $view_mode
+ * The view mode the field collection item is rendered in.
+ * @param $langcode
+ * The language code used for rendering.
+ *
+ * The module may add elements to $field_collection_item->content prior to
+ * rendering. The structure of $field_collection_item->content is a renderable
+ * array as expected by drupal_render().
+ *
+ * @see hook_entity_prepare_view()
+ * @see hook_entity_view()
+ */
+function hook_field_collection_item_view($field_collection_item, $view_mode, $langcode) {
+ $field_collection_item->content['my_additional_field'] = array(
+ '#markup' => $additional_field,
+ '#weight' => 10,
+ '#theme' => 'mymodule_my_additional_field',
+ );
+}
+
+/**
+ * Alter the results of entity_view() for field collection items.
+ *
+ * This hook is called after the content has been assembled in a structured
+ * array and may be used for doing processing which requires that the complete
+ * field collection item content structure has been built.
+ *
+ * If the module wishes to act on the rendered HTML of the field collection item
+ * rather than the structured content array, it may use this hook to add a
+ * #post_render callback. See drupal_render() and theme() documentation
+ * respectively for details.
+ *
+ * @param $build
+ * A renderable array representing the field collection item content.
+ *
+ * @see hook_entity_view_alter()
+ */
+function hook_field_collection_item_view_alter($build) {
+ if ($build['#view_mode'] == 'full' && isset($build['an_additional_field'])) {
+ // Change its weight.
+ $build['an_additional_field']['#weight'] = -10;
+
+ // Add a #post_render callback to act on the rendered HTML of the entity.
+ $build['#post_render'][] = 'my_module_post_render';
+ }
+}
+
+/**
+ * @}
+ */
\ No newline at end of file
diff --git a/sites/all/modules/field_collection/field_collection.info b/sites/all/modules/field_collection/field_collection.info
new file mode 100644
index 0000000000000000000000000000000000000000..5e054b209c7a9a7d8df4a6aaf032b564e970a4e7
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.info
@@ -0,0 +1,16 @@
+name = Field collection
+description = Provides a field collection field, to which any number of fields can be attached.
+core = 7.x
+dependencies[] = entity
+files[] = field_collection.test
+files[] = field_collection.info.inc
+files[] = views/field_collection_handler_relationship.inc
+configure = admin/structure/field-collections
+package = Fields
+
+; Information added by drupal.org packaging script on 2012-12-25
+version = "7.x-1.0-beta5"
+core = "7.x"
+project = "field_collection"
+datestamp = "1356475963"
+
diff --git a/sites/all/modules/field_collection/field_collection.info.inc b/sites/all/modules/field_collection/field_collection.info.inc
new file mode 100644
index 0000000000000000000000000000000000000000..03c961a14364fa8730891a0343a37fd985f45278
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.info.inc
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * @file
+ * Provides entity property info for field collection items.
+ */
+
+class FieldCollectionItemMetadataController extends EntityDefaultMetadataController {
+
+ public function entityPropertyInfo() {
+ $info = parent::entityPropertyInfo();
+ $properties = &$info['field_collection_item']['properties'];
+
+ $properties['field_name']['label'] = t('Field name');
+ $properties['field_name']['description'] = t('The machine-readable name of the field collection field containing this item.');
+ $properties['field_name']['required'] = TRUE;
+
+ $properties['host_entity'] = array(
+ 'label' => t('Host entity'),
+ 'type' => 'entity',
+ 'description' => t('The entity containing the field collection field.'),
+ 'getter callback' => 'field_collection_item_get_host_entity',
+ 'setter callback' => 'field_collection_item_set_host_entity',
+ 'required' => TRUE,
+ );
+
+ return $info;
+ }
+
+}
\ No newline at end of file
diff --git a/sites/all/modules/field_collection/field_collection.install b/sites/all/modules/field_collection/field_collection.install
new file mode 100644
index 0000000000000000000000000000000000000000..c668b124ebbb13fbe5ab102615c8898ebf99899e
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.install
@@ -0,0 +1,215 @@
+<?php
+
+/**
+ * @file
+ * Install, update and uninstall functions for the field_collection module.
+ */
+
+/**
+ * Implements hook_schema().
+ */
+function field_collection_schema() {
+
+ $schema['field_collection_item'] = array(
+ 'description' => 'Stores information about field collection items.',
+ 'fields' => array(
+ 'item_id' => array(
+ 'type' => 'serial',
+ 'not null' => TRUE,
+ 'description' => 'Primary Key: Unique field collection item ID.',
+ ),
+ 'revision_id' => array(
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'description' => 'Default revision ID.',
+ ),
+ 'field_name' => array(
+ 'description' => 'The name of the field on the host entity embedding this entity.',
+ 'type' => 'varchar',
+ 'length' => 32,
+ 'not null' => TRUE,
+ ),
+ 'archived' => array(
+ 'description' => 'Boolean indicating whether the field collection item is archived.',
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'default' => 0,
+ ),
+ ),
+ 'primary key' => array('item_id'),
+ );
+ $schema['field_collection_item_revision'] = array(
+ 'description' => 'Stores revision information about field collection items.',
+ 'fields' => array(
+ 'revision_id' => array(
+ 'type' => 'serial',
+ 'not null' => TRUE,
+ 'description' => 'Primary Key: Unique revision ID.',
+ ),
+ 'item_id' => array(
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'description' => 'Field collection item ID.',
+ ),
+ ),
+ 'primary key' => array('revision_id'),
+ 'indexes' => array(
+ 'item_id' => array('item_id'),
+ ),
+ 'foreign keys' => array(
+ 'versioned_field_collection_item' => array(
+ 'table' => 'field_collection_item',
+ 'columns' => array('item_id' => 'item_id'),
+ ),
+ ),
+ );
+ return $schema;
+}
+
+/**
+ * Implements hook_field_schema().
+ */
+function field_collection_field_schema($field) {
+ $columns = array(
+ 'value' => array(
+ 'type' => 'int',
+ 'not null' => FALSE,
+ 'description' => 'The field collection item id.',
+ ),
+ 'revision_id' => array(
+ 'type' => 'int',
+ 'not null' => FALSE,
+ 'description' => 'The field collection item revision id.',
+ ),
+ );
+ return array(
+ 'columns' => $columns,
+ );
+}
+
+/**
+ * Update the administer field collection permission machine name.
+ */
+function field_collection_update_7000() {
+ db_update('role_permission')
+ ->fields(array('permission' => 'administer field collections'))
+ ->condition('permission', 'administer field-collections')
+ ->execute();
+}
+
+/**
+ * Add revision support.
+ */
+function field_collection_update_7001() {
+
+ // Add revision_id column to field_collection_item table.
+ $revision_id_spec = array(
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'description' => 'Default revision ID.',
+ // Set default to 0 temporarily.
+ 'initial' => 0,
+ );
+ db_add_field('field_collection_item', 'revision_id', $revision_id_spec);
+
+ // Initialize the revision_id to be the same as the item_id.
+ db_update('field_collection_item')
+ ->expression('revision_id', 'item_id')
+ ->execute();
+
+ // Add the archived column
+ $archived_spec = array(
+ 'description' => 'Boolean indicating whether the field collection item is archived.',
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'default' => 0,
+ );
+ db_add_field('field_collection_item', 'archived', $archived_spec);
+
+ // Create the new table. It is important to explicitly define the schema here
+ // rather than use the hook_schema definition: http://drupal.org/node/150220.
+ $schema['field_collection_item_revision'] = array(
+ 'description' => 'Stores revision information about field collection items.',
+ 'fields' => array(
+ 'revision_id' => array(
+ 'type' => 'serial',
+ 'not null' => TRUE,
+ 'description' => 'Primary Key: Unique revision ID.',
+ ),
+ 'item_id' => array(
+ 'type' => 'int',
+ 'not null' => TRUE,
+ 'description' => 'Field collection item ID.',
+ ),
+ ),
+ 'primary key' => array('revision_id'),
+ 'indexes' => array(
+ 'item_id' => array('item_id'),
+ ),
+ 'foreign keys' => array(
+ 'versioned_field_collection_item' => array(
+ 'table' => 'field_collection_item',
+ 'columns' => array('item_id' => 'item_id'),
+ ),
+ ),
+ );
+ db_create_table('field_collection_item_revision', $schema['field_collection_item_revision']);
+
+ // Fill the new table with the correct data.
+ $items = db_select('field_collection_item', 'fci')
+ ->fields('fci')
+ ->execute();
+ foreach ($items as $item) {
+ // Update field_collection_item_revision table.
+ db_insert('field_collection_item_revision')
+ ->fields(array(
+ 'revision_id' => $item->item_id,
+ 'item_id' => $item->item_id,
+ ))
+ ->execute();
+ }
+
+ // Update the field_collection_field_schema columns for all tables.
+ foreach (field_read_fields(array('type' => 'field_collection')) as $field_name => $field) {
+ $table_prefixes = array('field_data', 'field_revision');
+ foreach ($table_prefixes as $table_prefix) {
+
+ $table = sprintf('%s_%s', $table_prefix, $field_name);
+ $value_column = sprintf('%s_value', $field_name);
+ $revision_id_column = sprintf('%s_revision_id', $field_name);
+
+ // Add a revision_id column.
+ $revision_id_spec['description'] = 'The field collection item revision id.';
+ db_add_field($table, $revision_id_column, $revision_id_spec);
+
+ // Initialize the revision_id to be the same as the item_id.
+ db_update($table)
+ ->expression($revision_id_column, $value_column)
+ ->execute();
+ }
+ }
+
+ // Need to get the system up-to-date so drupal_schema_fields_sql() will work.
+ $schema = drupal_get_schema('field_collection_item_revision', TRUE);
+}
+
+/**
+ * Remove orphaned field collection item entities.
+ */
+function field_collection_update_7002() {
+ // Loop over all fields and delete any orphaned field collection items.
+ foreach (field_read_fields(array('type' => 'field_collection')) as $field_name => $field) {
+
+ $select = db_select('field_collection_item', 'fci')
+ ->fields('fci', array('item_id'))
+ ->condition('field_name', $field_name)
+ ->condition('archived', 0);
+ $select->leftJoin('field_data_' . $field_name, 'field', "field.{$field_name}_value = fci.item_id ");
+ $select->isNull('field.entity_id');
+ $ids = $select->execute()->fetchCol(0);
+
+ entity_delete_multiple('field_collection_item', $ids);
+ $count = count($ids);
+ drupal_set_message("Deleted $count orphaned field collection items.");
+ }
+}
diff --git a/sites/all/modules/field_collection/field_collection.module b/sites/all/modules/field_collection/field_collection.module
new file mode 100644
index 0000000000000000000000000000000000000000..bf6a005e6b9378b84b58764c0555f6e1152ffc67
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.module
@@ -0,0 +1,1864 @@
+<?php
+
+/**
+ * @file
+ * Module implementing field collection field type.
+ */
+
+/**
+ * Implements hook_help().
+ */
+function field_collection_help($path, $arg) {
+ switch ($path) {
+ case 'admin/help#field_collection':
+ $output = '';
+ $output .= '<h3>' . t('About') . '</h3>';
+ $output .= '<p>' . t('The field collection module provides a field, to which any number of fields can be attached. See the <a href="@field-help">Field module help page</a> for more information about fields.', array('@field-help' => url('admin/help/field'))) . '</p>';
+ return $output;
+ }
+}
+
+/**
+ * Implements hook_entity_info().
+ */
+function field_collection_entity_info() {
+ $return['field_collection_item'] = array(
+ 'label' => t('Field collection item'),
+ 'label callback' => 'entity_class_label',
+ 'uri callback' => 'entity_class_uri',
+ 'entity class' => 'FieldCollectionItemEntity',
+ 'controller class' => 'EntityAPIController',
+ 'base table' => 'field_collection_item',
+ 'revision table' => 'field_collection_item_revision',
+ 'fieldable' => TRUE,
+ // For integration with Redirect module.
+ // @see http://drupal.org/node/1263884
+ 'redirect' => FALSE,
+ 'entity keys' => array(
+ 'id' => 'item_id',
+ 'revision' => 'revision_id',
+ 'bundle' => 'field_name',
+ ),
+ 'module' => 'field_collection',
+ 'view modes' => array(
+ 'full' => array(
+ 'label' => t('Full content'),
+ 'custom settings' => FALSE,
+ ),
+ ),
+ 'access callback' => 'field_collection_item_access',
+ 'metadata controller class' => 'FieldCollectionItemMetadataController'
+ );
+
+ // Add info about the bundles. We do not use field_info_fields() but directly
+ // use field_read_fields() as field_info_fields() requires built entity info
+ // to work.
+ foreach (field_read_fields(array('type' => 'field_collection')) as $field_name => $field) {
+ $return['field_collection_item']['bundles'][$field_name] = array(
+ 'label' => t('Field collection @field', array('@field' => $field_name)),
+ 'admin' => array(
+ 'path' => 'admin/structure/field-collections/%field_collection_field_name',
+ 'real path' => 'admin/structure/field-collections/' . strtr($field_name, array('_' => '-')),
+ 'bundle argument' => 3,
+ 'access arguments' => array('administer field collections'),
+ ),
+ );
+ }
+
+ return $return;
+}
+
+/**
+ * Menu callback for loading the bundle names.
+ */
+function field_collection_field_name_load($arg) {
+ $field_name = strtr($arg, array('-' => '_'));
+ if (($field = field_info_field($field_name)) && $field['type'] == 'field_collection') {
+ return $field_name;
+ }
+}
+
+/**
+ * Loads a field collection item.
+ *
+ * @return field_collection_item
+ * The field collection item entity or FALSE.
+ */
+function field_collection_item_load($item_id, $reset = FALSE) {
+ $result = field_collection_item_load_multiple(array($item_id), array(), $reset);
+ return $result ? reset($result) : FALSE;
+}
+
+/**
+ * Loads a field collection revision.
+ *
+ * @param $revision_id
+ * The field collection revision ID.
+ */
+function field_collection_item_revision_load($revision_id) {
+ return entity_revision_load('field_collection_item', $revision_id);
+}
+
+/**
+ * Loads field collection items.
+ *
+ * @return
+ * An array of field collection item entities.
+ */
+function field_collection_item_load_multiple($ids = array(), $conditions = array(), $reset = FALSE) {
+ return entity_load('field_collection_item', $ids, $conditions, $reset);
+}
+
+/**
+ * Class for field_collection_item entities.
+ */
+class FieldCollectionItemEntity extends Entity {
+
+ /**
+ * Field collection field info.
+ *
+ * @var array
+ */
+ protected $fieldInfo;
+
+ /**
+ * The host entity object.
+ *
+ * @var object
+ */
+ protected $hostEntity;
+
+ /**
+ * The host entity ID.
+ *
+ * @var integer
+ */
+ protected $hostEntityId;
+
+ /**
+ * The host entity revision ID if this is not the default revision.
+ *
+ * @var integer
+ */
+ protected $hostEntityRevisionId;
+
+ /**
+ * The host entity type.
+ *
+ * @var string
+ */
+ protected $hostEntityType;
+
+ /**
+ * The language under which the field collection item is stored.
+ *
+ * @var string
+ */
+ protected $langcode = LANGUAGE_NONE;
+
+ /**
+ * Entity ID.
+ *
+ * @var integer
+ */
+ public $item_id;
+
+ /**
+ * Field collection revision ID.
+ *
+ * @var integer
+ */
+ public $revision_id;
+
+ /**
+ * The name of the field-collection field this item is associated with.
+ *
+ * @var string
+ */
+ public $field_name;
+
+ /**
+ * Whether this revision is the default revision.
+ *
+ * @var bool
+ */
+ public $default_revision = TRUE;
+
+ /**
+ * Whether the field collection item is archived, i.e. not in use.
+ *
+ * @see FieldCollectionItemEntity::isInUse()
+ * @var bool
+ */
+ public $archived = FALSE;
+
+ /**
+ * Constructs the entity object.
+ */
+ public function __construct(array $values = array(), $entityType = NULL) {
+ parent::__construct($values, 'field_collection_item');
+ // Workaround issues http://drupal.org/node/1084268 and
+ // http://drupal.org/node/1264440:
+ // Check if the required property is set before checking for the field's
+ // type. If the property is not set, we are hitting a PDO or a core's bug.
+ // FIXME: Remove when #1264440 is fixed and the required PHP version is
+ // properly identified and documented in the module documentation.
+ if (isset($this->field_name)) {
+ // Ok, we have the field name property, we can proceed and check the field's type
+ $field_info = $this->fieldInfo();
+ if (!$field_info || $field_info['type'] != 'field_collection') {
+ throw new Exception("Invalid field name given: {$this->field_name} is not a Field Collection field.");
+ }
+ }
+ }
+
+ /**
+ * Provides info about the field on the host entity, which embeds this
+ * field collection item.
+ */
+ public function fieldInfo() {
+ return field_info_field($this->field_name);
+ }
+
+ /**
+ * Provides info of the field instance containing the reference to this
+ * field collection item.
+ */
+ public function instanceInfo() {
+ if ($this->fetchHostDetails()) {
+ return field_info_instance($this->hostEntityType(), $this->field_name, $this->hostEntityBundle());
+ }
+ }
+
+ /**
+ * Returns the field instance label translated to interface language.
+ */
+ public function translatedInstanceLabel($langcode = NULL) {
+ if ($info = $this->instanceInfo()) {
+ if (module_exists('i18n_field')) {
+ return i18n_string("field:{$this->field_name}:{$info['bundle']}:label", $info['label'], array('langcode' => $langcode));
+ }
+ return $info['label'];
+ }
+ }
+
+ /**
+ * Specifies the default label, which is picked up by label() by default.
+ */
+ public function defaultLabel() {
+ // @todo make configurable.
+ if ($this->fetchHostDetails()) {
+ $field = $this->fieldInfo();
+ $label = $this->translatedInstanceLabel();
+
+ if ($field['cardinality'] == 1) {
+ return $label;
+ }
+ elseif ($this->item_id) {
+ return t('!instance_label @count', array('!instance_label' => $label, '@count' => $this->delta() + 1));
+ }
+ else {
+ return t('New !instance_label', array('!instance_label' => $label));
+ }
+ }
+ return t('Unconnected field collection item');
+ }
+
+ /**
+ * Returns the path used to view the entity.
+ */
+ public function path() {
+ if ($this->item_id) {
+ return field_collection_field_get_path($this->fieldInfo()) . '/' . $this->item_id;
+ }
+ }
+
+ /**
+ * Returns the URI as returned by entity_uri().
+ */
+ public function defaultUri() {
+ return array(
+ 'path' => $this->path(),
+ );
+ }
+
+ /**
+ * Sets the host entity. Only possible during creation of a item.
+ *
+ * @param $create_link
+ * (optional) Whether a field-item linking the host entity to the field
+ * collection item should be created.
+ */
+ public function setHostEntity($entity_type, $entity, $langcode = LANGUAGE_NONE, $create_link = TRUE) {
+ if (!empty($this->is_new)) {
+ $this->hostEntityType = $entity_type;
+ $this->hostEntity = $entity;
+ $this->langcode = $langcode;
+
+ list($this->hostEntityId, $this->hostEntityRevisionId) = entity_extract_ids($this->hostEntityType, $this->hostEntity);
+ // If the host entity is not saved yet, set the id to FALSE. So
+ // fetchHostDetails() does not try to load the host entity details.
+ if (!isset($this->hostEntityId)) {
+ $this->hostEntityId = FALSE;
+ }
+ // We are create a new field collection for a non-default entity, thus
+ // set archived to TRUE.
+ if (!entity_revision_is_default($entity_type, $entity)) {
+ $this->hostEntityId = FALSE;
+ $this->archived = TRUE;
+ }
+ if ($create_link) {
+ $entity->{$this->field_name}[$this->langcode][] = array('entity' => $this);
+ }
+ }
+ else {
+ throw new Exception('The host entity may be set only during creation of a field collection item.');
+ }
+ }
+
+ /**
+ * Returns the host entity, which embeds this field collection item.
+ */
+ public function hostEntity() {
+ if ($this->fetchHostDetails()) {
+ if (!isset($this->hostEntity) && $this->isInUse()) {
+ $this->hostEntity = entity_load_single($this->hostEntityType, $this->hostEntityId);
+ }
+ elseif (!isset($this->hostEntity) && $this->hostEntityRevisionId) {
+ $this->hostEntity = entity_revision_load($this->hostEntityType, $this->hostEntityRevisionId);
+ }
+ return $this->hostEntity;
+ }
+ }
+
+ /**
+ * Returns the entity type of the host entity, which embeds this
+ * field collection item.
+ */
+ public function hostEntityType() {
+ if ($this->fetchHostDetails()) {
+ return $this->hostEntityType;
+ }
+ }
+
+ /**
+ * Returns the id of the host entity, which embeds this field collection item.
+ */
+ public function hostEntityId() {
+ if ($this->fetchHostDetails()) {
+ if (!$this->hostEntityId && $this->hostEntityRevisionId) {
+ $this->hostEntityId = entity_id($this->hostEntityType, $this->hostEntity());
+ }
+ return $this->hostEntityId;
+ }
+ }
+
+ /**
+ * Returns the bundle of the host entity, which embeds this field collection
+ * item.
+ */
+ public function hostEntityBundle() {
+ if ($entity = $this->hostEntity()) {
+ list($id, $rev_id, $bundle) = entity_extract_ids($this->hostEntityType, $entity);
+ return $bundle;
+ }
+ }
+
+ protected function fetchHostDetails() {
+ if (!isset($this->hostEntityId)) {
+ if ($this->item_id) {
+ // For saved field collections, query the field data to determine the
+ // right host entity.
+ $query = new EntityFieldQuery();
+ $query->fieldCondition($this->fieldInfo(), 'revision_id', $this->revision_id);
+ if (!$this->isInUse()) {
+ $query->age(FIELD_LOAD_REVISION);
+ }
+ $result = $query->execute();
+ list($this->hostEntityType, $data) = each($result);
+
+ if ($this->isInUse()) {
+ $this->hostEntityId = $data ? key($data) : FALSE;
+ $this->hostEntityRevisionId = FALSE;
+ }
+ // If we are querying for revisions, we get the revision ID.
+ else {
+ $this->hostEntityId = FALSE;
+ $this->hostEntityRevisionId = $data ? key($data) : FALSE;
+ }
+ }
+ else {
+ // No host entity available yet.
+ $this->hostEntityId = FALSE;
+ }
+ }
+ return !empty($this->hostEntityId) || !empty($this->hostEntity) || !empty($this->hostEntityRevisionId);
+ }
+
+ /**
+ * Determines the $delta of the reference pointing to this field collection
+ * item.
+ */
+ public function delta() {
+ if (($entity = $this->hostEntity()) && isset($entity->{$this->field_name})) {
+ foreach ($entity->{$this->field_name} as $langcode => &$data) {
+ foreach ($data as $delta => $item) {
+ if (isset($item['value']) && $item['value'] == $this->item_id) {
+ $this->langcode = $langcode;
+ return $delta;
+ }
+ elseif (isset($item['entity']) && $item['entity'] === $this) {
+ $this->langcode = $langcode;
+ return $delta;
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * Determines the language code under which the item is stored.
+ */
+ public function langcode() {
+ if ($this->delta() != NULL) {
+ return $this->langcode;
+ }
+ }
+
+ /**
+ * Determines whether this field collection item revision is in use.
+ *
+ * Field collection items may be contained in from non-default host entity
+ * revisions. If the field collection item does not appear in the default
+ * host entity revision, the item is actually not used by default and so
+ * marked as 'archived'.
+ * If the field collection item appears in the default revision of the host
+ * entity, the default revision of the field collection item is in use there
+ * and the collection is not marked as archived.
+ */
+ public function isInUse() {
+ return $this->default_revision && !$this->archived;
+ }
+
+ /**
+ * Save the field collection item.
+ *
+ * By default, always save the host entity, so modules are able to react
+ * upon changes to the content of the host and any 'last updated' dates of
+ * entities get updated.
+ *
+ * For creating an item a host entity has to be specified via setHostEntity()
+ * before this function is invoked. For the link between the entities to be
+ * fully established, the host entity object has to be updated to include a
+ * reference on this field collection item during saving. So do not skip
+ * saving the host for creating items.
+ *
+ * @param $skip_host_save
+ * (internal) If TRUE is passed, the host entity is not saved automatically
+ * and therefore no link is created between the host and the item or
+ * revision updates might be skipped. Use with care.
+ */
+ public function save($skip_host_save = FALSE) {
+ // Make sure we have a host entity during creation.
+ if (!empty($this->is_new) && !(isset($this->hostEntityId) || isset($this->hostEntity) || isset($this->hostEntityRevisionId))) {
+ throw new Exception("Unable to create a field collection item without a given host entity.");
+ }
+
+ // Only save directly if we are told to skip saving the host entity. Else,
+ // we always save via the host as saving the host might trigger saving
+ // field collection items anyway (e.g. if a new revision is created).
+ if ($skip_host_save) {
+ return entity_get_controller($this->entityType)->save($this);
+ }
+ else {
+ $host_entity = $this->hostEntity();
+ if (!$host_entity) {
+ throw new Exception("Unable to save a field collection item without a valid reference to a host entity.");
+ }
+ // If this is creating a new revision, also do so for the host entity.
+ if (!empty($this->revision) || !empty($this->is_new_revision)) {
+ $host_entity->revision = TRUE;
+ if (!empty($this->default_revision)) {
+ entity_revision_set_default($this->hostEntityType, $host_entity);
+ }
+ }
+ // Set the host entity reference, so the item will be saved with the host.
+ // @see field_collection_field_presave()
+ $delta = $this->delta();
+ if (isset($delta)) {
+ $host_entity->{$this->field_name}[$this->langcode][$delta] = array('entity' => $this);
+ }
+ else {
+ $host_entity->{$this->field_name}[$this->langcode][] = array('entity' => $this);
+ }
+ return entity_save($this->hostEntityType, $host_entity);
+ }
+ }
+
+ /**
+ * Deletes the field collection item and the reference in the host entity.
+ */
+ public function delete() {
+ parent::delete();
+ $this->deleteHostEntityReference();
+ }
+
+ /**
+ * Deletes the host entity's reference of the field collection item.
+ */
+ protected function deleteHostEntityReference() {
+ $delta = $this->delta();
+ if ($this->item_id && isset($delta)) {
+ unset($this->hostEntity->{$this->field_name}[$this->langcode][$delta]);
+ entity_save($this->hostEntityType, $this->hostEntity);
+ }
+ }
+
+ /**
+ * Intelligently delete a field collection item revision.
+ *
+ * If a host entity is revisioned with its field collection items, deleting
+ * a field collection item on the default revision of the host should not
+ * delete the collection item from archived revisions too. Instead, we delete
+ * the current default revision and archive the field collection.
+ *
+ * If no revisions are left or the host is not revisionable, the whole item
+ * is deleted.
+ */
+ public function deleteRevision($skip_host_update = FALSE) {
+ if (!$this->revision_id) {
+ return;
+ }
+ $info = entity_get_info($this->hostEntityType());
+ if (empty($info['entity keys']['revision']) || !$this->hostEntity()) {
+ return $this->delete();
+ }
+ if (!$skip_host_update) {
+ // Just remove the item from the host, which cares about deleting the
+ // item (depending on whether the update creates a new revision).
+ $this->deleteHostEntityReference();
+ }
+ elseif (!$this->isDefaultRevision()) {
+ entity_revision_delete('field_collection_item', $this->revision_id);
+ }
+ // If deleting the default revision, take care!
+ else {
+ $row = db_select('field_collection_item_revision', 'r')
+ ->fields('r')
+ ->condition('item_id', $this->item_id)
+ ->condition('revision_id', $this->revision_id, '<>')
+ ->execute()
+ ->fetchAssoc();
+ // If no other revision is left, delete. Else archive the item.
+ if (!$row) {
+ $this->delete();
+ }
+ else {
+ // Make the other revision the default revision and archive the item.
+ db_update('field_collection_item')
+ ->fields(array('archived' => 1, 'revision_id' => $row['revision_id']))
+ ->condition('item_id', $this->item_id)
+ ->execute();
+ entity_get_controller('field_collection_item')->resetCache(array($this->item_id));
+ entity_revision_delete('field_collection_item', $this->revision_id);
+ }
+ }
+ }
+
+ /**
+ * Export the field collection item.
+ *
+ * Since field collection entities are not directly exportable (i.e., do not
+ * have 'exportable' set to TRUE in hook_entity_info()) and since Features
+ * calls this method when exporting the field collection as a field attached
+ * to another entity, we return the export in the format expected by
+ * Features, rather than in the normal Entity::export() format.
+ */
+ public function export($prefix = '') {
+ // Based on code in EntityDefaultFeaturesController::export_render().
+ $export = "entity_import('" . $this->entityType() . "', '";
+ $export .= addcslashes(parent::export(), '\\\'');
+ $export .= "')";
+ return $export;
+ }
+
+ /**
+ * Magic method to only serialize what's necessary.
+ */
+ public function __sleep() {
+ $vars = get_object_vars($this);
+ unset($vars['entityInfo'], $vars['idKey'], $vars['nameKey'], $vars['statusKey']);
+ unset($vars['fieldInfo']);
+ // Also do not serialize the host entity, but only if it has already an id.
+ if ($this->hostEntity && ($this->hostEntityId || $this->hostEntityRevisionId)) {
+ unset($vars['hostEntity']);
+ }
+
+ // Also key the returned array with the variable names so the method may
+ // be easily overridden and customized.
+ return drupal_map_assoc(array_keys($vars));
+ }
+
+ /**
+ * Magic method to invoke setUp() on unserialization.
+ *
+ * @todo: Remove this once it appears in a released entity API module version.
+ */
+ public function __wakeup() {
+ $this->setUp();
+ }
+}
+
+/**
+ * Implements hook_menu().
+ */
+function field_collection_menu() {
+ $items = array();
+ if (module_exists('field_ui')) {
+ $items['admin/structure/field-collections'] = array(
+ 'title' => 'Field collections',
+ 'description' => 'Manage fields on field collections.',
+ 'page callback' => 'field_collections_overview',
+ 'access arguments' => array('administer field collections'),
+ 'type' => MENU_NORMAL_ITEM,
+ 'file' => 'field_collection.admin.inc',
+ );
+ }
+
+ // Add menu paths for viewing/editing/deleting field collection items.
+ foreach (field_info_fields() as $field) {
+ if ($field['type'] == 'field_collection') {
+ $path = field_collection_field_get_path($field);
+ $count = count(explode('/', $path));
+
+ $items[$path . '/%field_collection_item'] = array(
+ 'page callback' => 'field_collection_item_page_view',
+ 'page arguments' => array($count),
+ 'access callback' => 'field_collection_item_access',
+ 'access arguments' => array('view', $count),
+ 'file' => 'field_collection.pages.inc',
+ );
+ $items[$path . '/%field_collection_item/view'] = array(
+ 'title' => 'View',
+ 'type' => MENU_DEFAULT_LOCAL_TASK,
+ 'weight' => -10,
+ );
+ $items[$path . '/%field_collection_item/edit'] = array(
+ 'page callback' => 'drupal_get_form',
+ 'page arguments' => array('field_collection_item_form', $count),
+ 'access callback' => 'field_collection_item_access',
+ 'access arguments' => array('update', $count),
+ 'title' => 'Edit',
+ 'type' => MENU_LOCAL_TASK,
+ 'context' => MENU_CONTEXT_PAGE | MENU_CONTEXT_INLINE,
+ 'file' => 'field_collection.pages.inc',
+ );
+ $items[$path . '/%field_collection_item/delete'] = array(
+ 'page callback' => 'drupal_get_form',
+ 'page arguments' => array('field_collection_item_delete_confirm', $count),
+ 'access callback' => 'field_collection_item_access',
+ 'access arguments' => array('delete', $count),
+ 'title' => 'Delete',
+ 'type' => MENU_LOCAL_TASK,
+ 'context' => MENU_CONTEXT_INLINE,
+ 'file' => 'field_collection.pages.inc',
+ );
+ // Add entity type and the entity id as additional arguments.
+ $items[$path . '/add/%/%'] = array(
+ 'page callback' => 'field_collection_item_add',
+ 'page arguments' => array($field['field_name'], $count + 1, $count + 2),
+ // The pace callback takes care of checking access itself.
+ 'access callback' => TRUE,
+ 'file' => 'field_collection.pages.inc',
+ );
+ // Add menu items for dealing with revisions.
+ $items[$path . '/%field_collection_item/revisions/%field_collection_item_revision'] = array(
+ 'page callback' => 'field_collection_item_page_view',
+ 'page arguments' => array($count + 2),
+ 'access callback' => 'field_collection_item_access',
+ 'access arguments' => array('view', $count + 2),
+ 'file' => 'field_collection.pages.inc',
+ );
+ }
+ }
+
+ $items['field_collection/ajax'] = array(
+ 'title' => 'Remove item callback',
+ 'page callback' => 'field_collection_remove_js',
+ 'delivery callback' => 'ajax_deliver',
+ 'access callback' => TRUE,
+ 'theme callback' => 'ajax_base_page_theme',
+ 'type' => MENU_CALLBACK,
+ 'file path' => 'includes',
+ 'file' => 'form.inc',
+ );
+
+ return $items;
+}
+
+/**
+ * Implements hook_menu_alter() to fix the field collections admin UI tabs.
+ */
+function field_collection_menu_alter(&$items) {
+ if (module_exists('field_ui') && isset($items['admin/structure/field-collections/%field_collection_field_name/fields'])) {
+ // Make the fields task the default local task.
+ $items['admin/structure/field-collections/%field_collection_field_name'] = $items['admin/structure/field-collections/%field_collection_field_name/fields'];
+ $item = &$items['admin/structure/field-collections/%field_collection_field_name'];
+ $item['type'] = MENU_NORMAL_ITEM;
+ $item['title'] = 'Manage fields';
+ $item['title callback'] = 'field_collection_admin_page_title';
+ $item['title arguments'] = array(3);
+
+ $items['admin/structure/field-collections/%field_collection_field_name/fields'] = array(
+ 'title' => 'Manage fields',
+ 'type' => MENU_DEFAULT_LOCAL_TASK,
+ 'weight' => 1,
+ );
+ }
+}
+
+/**
+ * Menu title callback.
+ */
+function field_collection_admin_page_title($field_name) {
+ return t('Field collection @field_name', array('@field_name' => $field_name));
+}
+
+/**
+ * Implements hook_admin_paths().
+ */
+function field_collection_admin_paths() {
+ if (variable_get('node_admin_theme')) {
+ return array(
+ 'field-collection/*/*/edit' => TRUE,
+ 'field-collection/*/*/delete' => TRUE,
+ 'field-collection/*/add/*/*' => TRUE,
+ );
+ }
+}
+
+/**
+ * Implements hook_permission().
+ */
+function field_collection_permission() {
+ return array(
+ 'administer field collections' => array(
+ 'title' => t('Administer field collections'),
+ 'description' => t('Create and delete fields on field collections.'),
+ ),
+ );
+}
+
+/**
+ * Determines whether the given user has access to a field collection.
+ *
+ * @param $op
+ * The operation being performed. One of 'view', 'update', 'create', 'delete'.
+ * @param $item
+ * Optionally a field collection item. If nothing is given, access for all
+ * items is determined.
+ * @param $account
+ * The user to check for. Leave it to NULL to check for the global user.
+ * @return boolean
+ * Whether access is allowed or not.
+ */
+function field_collection_item_access($op, FieldCollectionItemEntity $item = NULL, $account = NULL) {
+ // We do not support editing field collection revisions that are not used at
+ // the hosts default revision as saving the host might result in a new default
+ // revision.
+ if (isset($item) && !$item->isInUse() && $op != 'view') {
+ return FALSE;
+ }
+ if (user_access('administer field collections', $account)) {
+ return TRUE;
+ }
+ if (!isset($item)) {
+ return FALSE;
+ }
+ $op = $op == 'view' ? 'view' : 'edit';
+ // Access is determined by the entity and field containing the reference.
+ $field = field_info_field($item->field_name);
+ $entity_access = entity_access($op == 'view' ? 'view' : 'update', $item->hostEntityType(), $item->hostEntity(), $account);
+ return $entity_access && field_access($op, $field, $item->hostEntityType(), $item->hostEntity(), $account);
+}
+
+/**
+ * Implements hook_theme().
+ */
+function field_collection_theme() {
+ return array(
+ 'field_collection_item' => array(
+ 'render element' => 'elements',
+ 'template' => 'field-collection-item',
+ ),
+ 'field_collection_view' => array(
+ 'render element' => 'element',
+ ),
+ );
+}
+
+/**
+ * Implements hook_field_info().
+ */
+function field_collection_field_info() {
+ return array(
+ 'field_collection' => array(
+ 'label' => t('Field collection'),
+ 'description' => t('This field stores references to embedded entities, which itself may contain any number of fields.'),
+ 'instance_settings' => array(),
+ 'default_widget' => 'field_collection_hidden',
+ 'default_formatter' => 'field_collection_view',
+ // As of now there is no UI for setting the path.
+ 'settings' => array(
+ 'path' => '',
+ 'hide_blank_items' => TRUE,
+ ),
+ // Add entity property info.
+ 'property_type' => 'field_collection_item',
+ 'property_callbacks' => array('field_collection_entity_metadata_property_callback'),
+ ),
+ );
+}
+
+/**
+ * Implements hook_field_instance_settings_form().
+ */
+function field_collection_field_instance_settings_form($field, $instance) {
+
+ $element['fieldset'] = array(
+ '#type' => 'fieldset',
+ '#title' => t('Default value'),
+ '#collapsible' => FALSE,
+ // As field_ui_default_value_widget() does, we change the #parents so that
+ // the value below is writing to $instance in the right location.
+ '#parents' => array('instance'),
+ );
+ // Be sure to set the default value to NULL, e.g. to repair old fields
+ // that still have one.
+ $element['fieldset']['default_value'] = array(
+ '#type' => 'value',
+ '#value' => NULL,
+ );
+ $element['fieldset']['content'] = array(
+ '#pre' => '<p>',
+ '#markup' => t('To specify a default value, configure it via the regular default value setting of each field that is part of the field collection. To do so, go to the <a href="!url">Manage fields</a> screen of the field collection.', array('!url' => url('admin/structure/field-collections/' . strtr($field['field_name'], array('_' => '-')) . '/fields'))),
+ '#suffix' => '</p>',
+ );
+ return $element;
+}
+
+/**
+ * Returns the base path to use for field collection items.
+ */
+function field_collection_field_get_path($field) {
+ if (empty($field['settings']['path'])) {
+ return 'field-collection/' . strtr($field['field_name'], array('_' => '-'));
+ }
+ return $field['settings']['path'];
+}
+
+/**
+ * Implements hook_field_settings_form().
+ */
+function field_collection_field_settings_form($field, $instance) {
+
+ $form['hide_blank_items'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Hide blank items'),
+ '#default_value' => $field['settings']['hide_blank_items'],
+ '#description' => t("A blank item is always added to any multivalued field's form. If checked, any additional blank items are hidden except of the first item which is always shown."),
+ '#weight' => 10,
+ '#states' => array(
+ // Hide the setting if the cardinality is 1.
+ 'invisible' => array(
+ ':input[name="field[cardinality]"]' => array('value' => '1'),
+ ),
+ ),
+ );
+ return $form;
+}
+
+/**
+ * Implements hook_field_presave().
+ *
+ * Support saving field collection items in @code $item['entity'] @endcode. This
+ * may be used to seamlessly create field collection items during host-entity
+ * creation or to save changes to the host entity and its collections at once.
+ */
+function field_collection_field_presave($host_entity_type, $host_entity, $field, $instance, $langcode, &$items) {
+ foreach ($items as &$item) {
+ // In case the entity has been changed / created, save it and set the id.
+ // If the host entity creates a new revision, save new item-revisions as
+ // well.
+ if (isset($item['entity']) || !empty($host_entity->revision)) {
+
+ if ($entity = field_collection_field_get_entity($item)) {
+
+ if (!empty($entity->is_new)) {
+ $entity->setHostEntity($host_entity_type, $host_entity, LANGUAGE_NONE, FALSE);
+ }
+
+ // If the host entity is saved as new revision, do the same for the item.
+ if (!empty($host_entity->revision)) {
+ $entity->revision = TRUE;
+ $is_default = entity_revision_is_default($host_entity_type, $host_entity);
+ // If an entity type does not support saving non-default entities,
+ // assume it will be saved as default.
+ if (!isset($is_default) || $is_default) {
+ $entity->default_revision = TRUE;
+ $entity->archived = FALSE;
+ }
+ }
+ $entity->save(TRUE);
+
+ $item = array(
+ 'value' => $entity->item_id,
+ 'revision_id' => $entity->revision_id,
+ );
+ }
+ }
+ }
+}
+
+/**
+ * Implements hook_field_update().
+ *
+ * Care about removed field collection items.
+ */
+function field_collection_field_update($entity_type, $entity, $field, $instance, $langcode, &$items) {
+ $items_original = !empty($entity->original->{$field['field_name']}[$langcode]) ? $entity->original->{$field['field_name']}[$langcode] : array();
+ $original_by_id = array_flip(field_collection_field_item_to_ids($items_original));
+
+ foreach ($items as $item) {
+ unset($original_by_id[$item['value']]);
+ }
+
+ // If there are removed items, care about deleting the item entities.
+ if ($original_by_id) {
+ $ids = array_flip($original_by_id);
+
+ // If we are creating a new revision, the old-items should be kept but get
+ // marked as archived now.
+ if (!empty($entity->revision)) {
+ db_update('field_collection_item')
+ ->fields(array('archived' => 1))
+ ->condition('item_id', $ids, 'IN')
+ ->execute();
+ }
+ else {
+ // Delete unused field collection items now.
+ foreach (field_collection_item_load_multiple($ids) as $item) {
+ $item->deleteRevision(TRUE);
+ }
+ }
+ }
+}
+
+/**
+ * Implements hook_field_delete().
+ */
+function field_collection_field_delete($entity_type, $entity, $field, $instance, $langcode, &$items) {
+ // Also delete all embedded entities.
+ if ($ids = field_collection_field_item_to_ids($items)) {
+ // We filter out entities that are still being referenced by other
+ // host-entities. This should never be the case, but it might happened e.g.
+ // when modules cloned a node without knowing about field-collection.
+ $entity_info = entity_get_info($entity_type);
+ $entity_id_name = $entity_info['entity keys']['id'];
+ $field_column = key($field['columns']);
+
+ foreach ($ids as $id_key => $id) {
+ $query = new EntityFieldQuery();
+ $entities = $query
+ ->fieldCondition($field['field_name'], $field_column, $id)
+ ->execute();
+ unset($entities[$entity_type][$entity->$entity_id_name]);
+
+ if (!empty($entities[$entity_type])) {
+ // Filter this $id out.
+ unset($ids[$id_key]);
+ }
+ }
+
+ entity_delete_multiple('field_collection_item', $ids);
+ }
+}
+
+/**
+ * Implements hook_field_delete_revision().
+ */
+function field_collection_field_delete_revision($entity_type, $entity, $field, $instance, $langcode, &$items) {
+ foreach ($items as $item) {
+ if (!empty($item['revision_id'])) {
+ if ($entity = field_collection_item_revision_load($item['revision_id'])) {
+ $entity->deleteRevision(TRUE);
+ }
+ }
+ }
+}
+
+/**
+ * Get an array of field collection item IDs stored in the given field items.
+ */
+function field_collection_field_item_to_ids($items) {
+ $ids = array();
+ foreach ($items as $item) {
+ if (!empty($item['value'])) {
+ $ids[] = $item['value'];
+ }
+ }
+ return $ids;
+}
+
+/**
+ * Implements hook_field_is_empty().
+ */
+function field_collection_field_is_empty($item, $field) {
+ if (!empty($item['value'])) {
+ return FALSE;
+ }
+ elseif (isset($item['entity'])) {
+ return field_collection_item_is_empty($item['entity']);
+ }
+ return TRUE;
+}
+
+/**
+ * Determines whether a field collection item entity is empty based on the collection-fields.
+ */
+function field_collection_item_is_empty(FieldCollectionItemEntity $item) {
+ $instances = field_info_instances('field_collection_item', $item->field_name);
+ $is_empty = TRUE;
+
+ foreach ($instances as $instance) {
+ $field_name = $instance['field_name'];
+ $field = field_info_field($field_name);
+
+ // Determine the list of languages to iterate on.
+ $languages = field_available_languages('field_collection_item', $field);
+
+ foreach ($languages as $langcode) {
+ if (!empty($item->{$field_name}[$langcode])) {
+ // If at least one collection-field is not empty; the
+ // field collection item is not empty.
+ foreach ($item->{$field_name}[$langcode] as $field_item) {
+ if (!module_invoke($field['module'], 'field_is_empty', $field_item, $field)) {
+ $is_empty = FALSE;
+ }
+ }
+ }
+ }
+ }
+
+ // Allow other modules a chance to alter the value before returning.
+ drupal_alter('field_collection_is_empty', $is_empty, $item);
+ return $is_empty;
+}
+
+/**
+ * Implements hook_field_formatter_info().
+ */
+function field_collection_field_formatter_info() {
+ return array(
+ 'field_collection_list' => array(
+ 'label' => t('Links to field collection items'),
+ 'field types' => array('field_collection'),
+ 'settings' => array(
+ 'edit' => t('Edit'),
+ 'delete' => t('Delete'),
+ 'add' => t('Add'),
+ 'description' => TRUE,
+ ),
+ ),
+ 'field_collection_view' => array(
+ 'label' => t('Field collection items'),
+ 'field types' => array('field_collection'),
+ 'settings' => array(
+ 'edit' => t('Edit'),
+ 'delete' => t('Delete'),
+ 'add' => t('Add'),
+ 'description' => TRUE,
+ 'view_mode' => 'full',
+ ),
+ ),
+ 'field_collection_fields' => array(
+ 'label' => t('Fields only'),
+ 'field types' => array('field_collection'),
+ 'settings' => array(
+ 'view_mode' => 'full',
+ ),
+ ),
+ );
+}
+
+/**
+ * Implements hook_field_formatter_settings_form().
+ */
+function field_collection_field_formatter_settings_form($field, $instance, $view_mode, $form, &$form_state) {
+ $display = $instance['display'][$view_mode];
+ $settings = $display['settings'];
+ $elements = array();
+
+ if ($display['type'] != 'field_collection_fields') {
+ $elements['edit'] = array(
+ '#type' => 'textfield',
+ '#title' => t('Edit link title'),
+ '#default_value' => $settings['edit'],
+ '#description' => t('Leave the title empty, to hide the link.'),
+ );
+ $elements['delete'] = array(
+ '#type' => 'textfield',
+ '#title' => t('Delete link title'),
+ '#default_value' => $settings['delete'],
+ '#description' => t('Leave the title empty, to hide the link.'),
+ );
+ $elements['add'] = array(
+ '#type' => 'textfield',
+ '#title' => t('Add link title'),
+ '#default_value' => $settings['add'],
+ '#description' => t('Leave the title empty, to hide the link.'),
+ );
+ $elements['description'] = array(
+ '#type' => 'checkbox',
+ '#title' => t('Show the field description beside the add link.'),
+ '#default_value' => $settings['description'],
+ '#description' => t('If enabled and the add link is shown, the field description is shown in front of the add link.'),
+ );
+ }
+
+ // Add a select form element for view_mode if viewing the rendered field_collection.
+ if ($display['type'] !== 'field_collection_list') {
+
+ $entity_type = entity_get_info('field_collection_item');
+ $options = array();
+ foreach ($entity_type['view modes'] as $mode => $info) {
+ $options[$mode] = $info['label'];
+ }
+
+ $elements['view_mode'] = array(
+ '#type' => 'select',
+ '#title' => t('View mode'),
+ '#options' => $options,
+ '#default_value' => $settings['view_mode'],
+ '#description' => t('Select the view mode'),
+ );
+ }
+
+ return $elements;
+}
+
+/**
+ * Implements hook_field_formatter_settings_summary().
+ */
+function field_collection_field_formatter_settings_summary($field, $instance, $view_mode) {
+ $display = $instance['display'][$view_mode];
+ $settings = $display['settings'];
+ $output = array();
+
+ if ($display['type'] !== 'field_collection_fields') {
+ $links = array_filter(array_intersect_key($settings, array_flip(array('add', 'edit', 'delete'))));
+ if ($links) {
+ $output[] = t('Links: @links', array('@links' => check_plain(implode(', ', $links))));
+ }
+ else {
+ $output[] = t('Links: none');
+ }
+ }
+
+ if ($display['type'] !== 'field_collection_list') {
+ $entity_type = entity_get_info('field_collection_item');
+ if (!empty($entity_type['view modes'][$settings['view_mode']]['label'])) {
+ $output[] = t('View mode: @mode', array('@mode' => $entity_type['view modes'][$settings['view_mode']]['label']));
+ }
+ }
+
+ return implode('<br>', $output);
+}
+
+/**
+ * Implements hook_field_formatter_view().
+ */
+function field_collection_field_formatter_view($entity_type, $entity, $field, $instance, $langcode, $items, $display) {
+ $element = array();
+ $settings = $display['settings'];
+
+ switch ($display['type']) {
+ case 'field_collection_list':
+
+ foreach ($items as $delta => $item) {
+ if ($field_collection = field_collection_field_get_entity($item)) {
+ $output = l($field_collection->label(), $field_collection->path());
+ $links = array();
+ foreach (array('edit', 'delete') as $op) {
+ if ($settings[$op] && field_collection_item_access($op == 'edit' ? 'update' : $op, $field_collection)) {
+ $title = entity_i18n_string("field:{$field['field_name']}:{$instance['bundle']}:setting_$op", $settings[$op]);
+ $links[] = l($title, $field_collection->path() . '/' . $op, array('query' => drupal_get_destination()));
+ }
+ }
+ if ($links) {
+ $output .= ' (' . implode('|', $links) . ')';
+ }
+ $element[$delta] = array('#markup' => $output);
+ }
+ }
+ field_collection_field_formatter_links($element, $entity_type, $entity, $field, $instance, $langcode, $items, $display);
+ break;
+
+ case 'field_collection_view':
+
+ $element['#attached']['css'][] = drupal_get_path('module', 'field_collection') . '/field_collection.theme.css';
+ $view_mode = !empty($display['settings']['view_mode']) ? $display['settings']['view_mode'] : 'full';
+ foreach ($items as $delta => $item) {
+ if ($field_collection = field_collection_field_get_entity($item)) {
+ $element[$delta]['entity'] = $field_collection->view($view_mode);
+ $element[$delta]['#theme_wrappers'] = array('field_collection_view');
+ $element[$delta]['#attributes']['class'][] = 'field-collection-view';
+ $element[$delta]['#attributes']['class'][] = 'clearfix';
+ $element[$delta]['#attributes']['class'][] = drupal_clean_css_identifier('view-mode-' . $view_mode);
+
+ $links = array(
+ '#theme' => 'links__field_collection_view',
+ );
+ $links['#attributes']['class'][] = 'field-collection-view-links';
+ foreach (array('edit', 'delete') as $op) {
+ if ($settings[$op] && field_collection_item_access($op == 'edit' ? 'update' : $op, $field_collection)) {
+ $links['#links'][$op] = array(
+ 'title' => entity_i18n_string("field:{$field['field_name']}:{$instance['bundle']}:setting_$op", $settings[$op]),
+ 'href' => $field_collection->path() . '/' . $op,
+ 'query' => drupal_get_destination(),
+ );
+ }
+ }
+ $element[$delta]['links'] = $links;
+ }
+ }
+ field_collection_field_formatter_links($element, $entity_type, $entity, $field, $instance, $langcode, $items, $display);
+ break;
+
+ case 'field_collection_fields':
+
+ $view_mode = !empty($display['settings']['view_mode']) ? $display['settings']['view_mode'] : 'full';
+ foreach ($items as $delta => $item) {
+ if ($field_collection = field_collection_field_get_entity($item)) {
+ $element[$delta]['entity'] = $field_collection->view($view_mode);
+ }
+ }
+ break;
+ }
+
+ return $element;
+}
+
+/**
+ * Helper function to add links to a field collection field.
+ */
+function field_collection_field_formatter_links(&$element, $entity_type, $entity, $field, $instance, $langcode, $items, $display) {
+ $settings = $display['settings'];
+
+ if ($settings['add'] && ($field['cardinality'] == FIELD_CARDINALITY_UNLIMITED || count($items) < $field['cardinality'])) {
+ // Check whether the current is allowed to create a new item.
+ $field_collection_item = entity_create('field_collection_item', array('field_name' => $field['field_name']));
+ $field_collection_item->setHostEntity($entity_type, $entity, LANGUAGE_NONE, FALSE);
+
+ if (field_collection_item_access('create', $field_collection_item)) {
+ $path = field_collection_field_get_path($field);
+ list($id) = entity_extract_ids($entity_type, $entity);
+ $element['#suffix'] = '';
+ if (!empty($settings['description'])) {
+ $element['#suffix'] .= '<div class="description field-collection-description">' . field_filter_xss($instance['description']) . '</div>';
+ }
+ $title = entity_i18n_string("field:{$field['field_name']}:{$instance['bundle']}:setting_add", $settings['add']);
+ $add_path = $path . '/add/' . $entity_type . '/' . $id;
+ $element['#suffix'] .= '<ul class="action-links action-links-field-collection-add"><li>';
+ $element['#suffix'] .= l($title, $add_path, array('query' => drupal_get_destination()));
+ $element['#suffix'] .= '</li></ul>';
+ }
+ }
+ // If there is no add link, add a special class to the last item.
+ if (empty($element['#suffix'])) {
+ $index = count(element_children($element)) - 1;
+ $element[$index]['#attributes']['class'][] = 'field-collection-view-final';
+ }
+
+ $element += array('#prefix' => '', '#suffix' => '');
+ $element['#prefix'] .= '<div class="field-collection-container clearfix">';
+ $element['#suffix'] .= '</div>';
+
+ return $element;
+}
+
+/**
+ * Themes field collection items printed using the field_collection_view formatter.
+ */
+function theme_field_collection_view($variables) {
+ $element = $variables['element'];
+ return '<div' . drupal_attributes($element['#attributes']) . '>' . $element['#children'] . '</div>';
+}
+
+/**
+ * Implements hook_field_widget_info().
+ */
+function field_collection_field_widget_info() {
+ return array(
+ 'field_collection_hidden' => array(
+ 'label' => t('Hidden'),
+ 'field types' => array('field_collection'),
+ 'behaviors' => array(
+ 'multiple values' => FIELD_BEHAVIOR_CUSTOM,
+ 'default value' => FIELD_BEHAVIOR_NONE,
+ ),
+ ),
+ 'field_collection_embed' => array(
+ 'label' => t('Embedded'),
+ 'field types' => array('field_collection'),
+ 'behaviors' => array(
+ 'multiple values' => FIELD_BEHAVIOR_DEFAULT,
+ 'default value' => FIELD_BEHAVIOR_NONE,
+ ),
+ ),
+ );
+}
+
+/**
+ * Implements hook_field_widget_form().
+ */
+function field_collection_field_widget_form(&$form, &$form_state, $field, $instance, $langcode, $items, $delta, $element) {
+ static $recursion = 0;
+
+ switch ($instance['widget']['type']) {
+ case 'field_collection_hidden':
+ return $element;
+
+ case 'field_collection_embed':
+ // If the field collection item form contains another field collection,
+ // we might ran into a recursive loop. Prevent that.
+ if ($recursion++ > 3) {
+ drupal_set_message(t('The field collection item form has not been embedded to avoid recursive loops.'), 'error');
+ return $element;
+ }
+ $field_parents = $element['#field_parents'];
+ $field_name = $element['#field_name'];
+ $language = $element['#language'];
+
+ // Nest the field collection item entity form in a dedicated parent space,
+ // by appending [field_name, langcode, delta] to the current parent space.
+ // That way the form values of the field collection item are separated.
+ $parents = array_merge($field_parents, array($field_name, $language, $delta));
+
+ $element += array(
+ '#element_validate' => array('field_collection_field_widget_embed_validate'),
+ '#parents' => $parents,
+ );
+
+ if ($field['cardinality'] == 1) {
+ $element['#type'] = 'fieldset';
+ }
+
+ $field_state = field_form_get_state($field_parents, $field_name, $language, $form_state);
+
+ if (!empty($field['settings']['hide_blank_items']) && $delta == $field_state['items_count'] && $delta > 0) {
+ // Do not add a blank item. Also see
+ // field_collection_field_attach_form() for correcting #max_delta.
+ $recursion--;
+ return FALSE;
+ }
+ elseif (!empty($field['settings']['hide_blank_items']) && $field_state['items_count'] == 0) {
+ // We show one item, so also specify that as item count. So when the
+ // add button is pressed the item count will be 2 and we show to items.
+ $field_state['items_count'] = 1;
+ }
+
+ if (isset($field_state['entity'][$delta])) {
+ $field_collection_item = $field_state['entity'][$delta];
+ }
+ else {
+ if (isset($items[$delta])) {
+ $field_collection_item = field_collection_field_get_entity($items[$delta], $field_name);
+ }
+ // Show an empty collection if we have no existing one or it does not
+ // load.
+ if (empty($field_collection_item)) {
+ $field_collection_item = entity_create('field_collection_item', array('field_name' => $field_name));
+ }
+
+ // Put our entity in the form state, so FAPI callbacks can access it.
+ $field_state['entity'][$delta] = $field_collection_item;
+ }
+
+ field_form_set_state($field_parents, $field_name, $language, $form_state, $field_state);
+ field_attach_form('field_collection_item', $field_collection_item, $element, $form_state, $language);
+
+ if (empty($element['#required'])) {
+ $element['#after_build'][] = 'field_collection_field_widget_embed_delay_required_validation';
+ }
+
+ if ($field['cardinality'] == FIELD_CARDINALITY_UNLIMITED) {
+ $element['remove_button'] = array(
+ '#delta' => $delta,
+ '#name' => implode('_', $parents) . '_remove_button',
+ '#type' => 'submit',
+ '#value' => t('Remove'),
+ '#validate' => array(),
+ '#submit' => array('field_collection_remove_submit'),
+ '#limit_validation_errors' => array(),
+ '#ajax' => array(
+ 'path' => 'field_collection/ajax',
+ 'effect' => 'fade',
+ ),
+ '#weight' => 1000,
+ );
+ }
+
+ $recursion--;
+ return $element;
+ }
+}
+
+/**
+ * Implements hook_field_attach_form().
+ *
+ * Corrects #max_delta when we hide the blank field collection item.
+ *
+ * @see field_add_more_js()
+ * @see field_collection_field_widget_form()
+ */
+function field_collection_field_attach_form($entity_type, $entity, &$form, &$form_state, $langcode) {
+
+ foreach (field_info_instances($entity_type, $form['#bundle']) as $field_name => $instance) {
+ $field = field_info_field($field_name);
+
+ if ($field['type'] == 'field_collection' && $field['settings']['hide_blank_items']
+ && field_access('edit', $field, $entity_type) && $instance['widget']['type'] == 'field_collection_embed') {
+
+ $element_langcode = $form[$field_name]['#language'];
+ if ($form[$field_name][$element_langcode]['#max_delta'] > 0) {
+ $form[$field_name][$element_langcode]['#max_delta']--;
+ }
+ }
+ }
+}
+
+/**
+ * Page callback to handle AJAX for removing a field collection item.
+ *
+ * This is a direct page callback. The actual job of deleting the item is
+ * done in the submit handler for the button, so all we really need to
+ * do is process the form and then generate output. We generate this
+ * output by doing a replace command on the id of the entire form element.
+ */
+function field_collection_remove_js() {
+ // drupal_html_id() very helpfully ensures that all html IDS are unique
+ // on a page. Unfortunately what it doesn't realize is that the IDs
+ // we are generating are going to replace IDs that already exist, so
+ // this actually works against us.
+ if (isset($_POST['ajax_html_ids'])) {
+ unset($_POST['ajax_html_ids']);
+ }
+
+ list($form, $form_state) = ajax_get_form();
+ drupal_process_form($form['#form_id'], $form, $form_state);
+
+ // Get the information on what we're removing.
+ $button = $form_state['triggering_element'];
+ // Go two levels up in the form, to the whole widget.
+ $element = drupal_array_get_nested_value($form, array_slice($button['#array_parents'], 0, -3));
+ // Now send back the proper AJAX command to replace it.
+ $return = array(
+ '#type' => 'ajax',
+ '#commands' => array(
+ ajax_command_replace('#' . $element['#id'], drupal_render($element))
+ ),
+ );
+
+ // Because we're doing this ourselves, messages aren't automatic. We have
+ // to add them.
+ $messages = theme('status_messages');
+ if ($messages) {
+ $return['#commands'][] = ajax_command_prepend('#' . $element['#id'], $messages);
+ }
+
+ return $return;
+}
+
+/**
+ * Submit callback to remove an item from the field UI multiple wrapper.
+ *
+ * When a remove button is submitted, we need to find the item that it
+ * referenced and delete it. Since field UI has the deltas as a straight
+ * unbroken array key, we have to renumber everything down. Since we do this
+ * we *also* need to move all the deltas around in the $form_state['values']
+ * and $form_state['input'] so that user changed values follow. This is a bit
+ * of a complicated process.
+ */
+function field_collection_remove_submit($form, &$form_state) {
+ $button = $form_state['triggering_element'];
+ $delta = $button['#delta'];
+
+ // Where in the form we'll find the parent element.
+ $address = array_slice($button['#array_parents'], 0, -2);
+
+ // Go one level up in the form, to the widgets container.
+ $parent_element = drupal_array_get_nested_value($form, $address);
+ $field_name = $parent_element['#field_name'];
+ $langcode = $parent_element['#language'];
+ $parents = $parent_element['#field_parents'];
+
+ $field_state = field_form_get_state($parents, $field_name, $langcode, $form_state);
+
+ // Go ahead and renumber everything from our delta to the last
+ // item down one. This will overwrite the item being removed.
+ for ($i = $delta; $i <= $field_state['items_count']; $i++) {
+ $old_element_address = array_merge($address, array($i + 1));
+ $new_element_address = array_merge($address, array($i));
+
+ $moving_element = drupal_array_get_nested_value($form, $old_element_address);
+ $moving_element_value = drupal_array_get_nested_value($form_state['values'], $old_element_address);
+ $moving_element_input = drupal_array_get_nested_value($form_state['input'], $old_element_address);
+
+ // Tell the element where it's being moved to.
+ $moving_element['#parents'] = $new_element_address;
+
+ // Move the element around.
+ form_set_value($moving_element, $moving_element_value, $form_state);
+ drupal_array_set_nested_value($form_state['input'], $moving_element['#parents'], $moving_element_input);
+
+ // Move the entity in our saved state.
+ if (isset($field_state['entity'][$i + 1])) {
+ $field_state['entity'][$i] = $field_state['entity'][$i + 1];
+ }
+ else {
+ unset($field_state['entity'][$i]);
+ }
+ }
+
+ // Replace the deleted entity with an empty one. This helps to ensure that
+ // trying to add a new entity won't ressurect a deleted entity from the
+ // trash bin.
+ $count = count($field_state['entity']);
+ $field_state['entity'][$count] = entity_create('field_collection_item', array('field_name' => $field_name));
+
+ // Then remove the last item. But we must not go negative.
+ if ($field_state['items_count'] > 0) {
+ $field_state['items_count']--;
+ }
+
+ // Fix the weights. Field UI lets the weights be in a range of
+ // (-1 * item_count) to (item_count). This means that when we remove one,
+ // the range shrinks; weights outside of that range then get set to
+ // the first item in the select by the browser, floating them to the top.
+ // We use a brute force method because we lost weights on both ends
+ // and if the user has moved things around, we have to cascade because
+ // if I have items weight weights 3 and 4, and I change 4 to 3 but leave
+ // the 3, the order of the two 3s now is undefined and may not match what
+ // the user had selected.
+ $input = drupal_array_get_nested_value($form_state['input'], $address);
+ // Sort by weight
+ uasort($input, '_field_sort_items_helper');
+
+ // Reweight everything in the correct order.
+ $weight = -1 * $field_state['items_count'];
+ foreach ($input as $key => $item) {
+ if ($item) {
+ $input[$key]['_weight'] = $weight++;
+ }
+ }
+
+ drupal_array_set_nested_value($form_state['input'], $address, $input);
+ field_form_set_state($parents, $field_name, $langcode, $form_state, $field_state);
+
+ $form_state['rebuild'] = TRUE;
+}
+
+/**
+ * Gets a field collection item entity for a given field item.
+ *
+ * @param $field_name
+ * (optional) If given and there is no entity yet, a new entity object is
+ * created for the given item.
+ *
+ * @return
+ * The entity object or FALSE.
+ */
+function field_collection_field_get_entity(&$item, $field_name = NULL) {
+ if (isset($item['entity'])) {
+ return $item['entity'];
+ }
+ elseif (isset($item['value'])) {
+ // By default always load the default revision, so caches get used.
+ $entity = field_collection_item_load($item['value']);
+ if ($entity->revision_id != $item['revision_id']) {
+ // A non-default revision is a referenced, so load this one.
+ $entity = field_collection_item_revision_load($item['revision_id']);
+ }
+ return $entity;
+ }
+ elseif (!isset($item['entity']) && isset($field_name)) {
+ $item['entity'] = entity_create('field_collection_item', array('field_name' => $field_name));
+ return $item['entity'];
+ }
+ return FALSE;
+}
+
+/**
+ * FAPI #after_build of an individual field collection element to delay the validation of #required.
+ */
+function field_collection_field_widget_embed_delay_required_validation(&$element, &$form_state) {
+ // If the process_input flag is set, the form and its input is going to be
+ // validated. Prevent #required (sub)fields from throwing errors while
+ // their non-#required field collection item is empty.
+ if ($form_state['process_input']) {
+ _field_collection_collect_required_elements($element, $element['#field_collection_required_elements']);
+ }
+ return $element;
+}
+
+function _field_collection_collect_required_elements(&$element, &$required_elements) {
+ // Recurse through all children.
+ foreach (element_children($element) as $key) {
+ if (isset($element[$key]) && $element[$key]) {
+ _field_collection_collect_required_elements($element[$key], $required_elements);
+ }
+ }
+ if (!empty($element['#required'])) {
+ $element['#required'] = FALSE;
+ $required_elements[] = &$element;
+ $element += array('#pre_render' => array());
+ array_unshift($element['#pre_render'], 'field_collection_field_widget_render_required');
+ }
+}
+
+/**
+ * #pre_render callback that ensures the element is rendered as being required.
+ */
+function field_collection_field_widget_render_required($element) {
+ $element['#required'] = TRUE;
+ return $element;
+}
+
+/**
+ * FAPI validation of an individual field collection element.
+ */
+function field_collection_field_widget_embed_validate($element, &$form_state, $complete_form) {
+ $instance = field_widget_instance($element, $form_state);
+ $field = field_widget_field($element, $form_state);
+ $field_parents = $element['#field_parents'];
+ $field_name = $element['#field_name'];
+ $language = $element['#language'];
+
+ $field_state = field_form_get_state($field_parents, $field_name, $language, $form_state);
+ $field_collection_item = $field_state['entity'][$element['#delta']];
+
+ // Attach field API validation of the embedded form.
+ field_attach_form_validate('field_collection_item', $field_collection_item, $element, $form_state);
+
+ // Now validate required elements if the entity is not empty.
+ if (!field_collection_item_is_empty($field_collection_item) && !empty($element['#field_collection_required_elements'])) {
+ foreach ($element['#field_collection_required_elements'] as &$elements) {
+
+ // Copied from _form_validate().
+ if (isset($elements['#needs_validation'])) {
+ $is_empty_multiple = (!count($elements['#value']));
+ $is_empty_string = (is_string($elements['#value']) && drupal_strlen(trim($elements['#value'])) == 0);
+ $is_empty_value = ($elements['#value'] === 0);
+ if ($is_empty_multiple || $is_empty_string || $is_empty_value) {
+ if (isset($elements['#title'])) {
+ form_error($elements, t('!name field is required.', array('!name' => $elements['#title'])));
+ }
+ else {
+ form_error($elements);
+ }
+ }
+ }
+ }
+ }
+
+ // Only if the form is being submitted, finish the collection entity and
+ // prepare it for saving.
+ if ($form_state['submitted'] && !form_get_errors()) {
+
+ field_attach_submit('field_collection_item', $field_collection_item, $element, $form_state);
+
+ // Load initial form values into $item, so any other form values below the
+ // same parents are kept.
+ $item = drupal_array_get_nested_value($form_state['values'], $element['#parents']);
+
+ // Set the _weight if it is a multiple field.
+ if (isset($element['_weight']) && ($field['cardinality'] > 1 || $field['cardinality'] == FIELD_CARDINALITY_UNLIMITED)) {
+ $item['_weight'] = $element['_weight']['#value'];
+ }
+
+ // Put the field collection item in $item['entity'], so it is saved with
+ // the host entity via hook_field_presave() / field API if it is not empty.
+ // @see field_collection_field_presave()
+ $item['entity'] = $field_collection_item;
+ form_set_value($element, $item, $form_state);
+ }
+}
+
+/**
+ * Implements hook_field_create_field().
+ */
+function field_collection_field_create_field($field) {
+ if ($field['type'] == 'field_collection') {
+ field_attach_create_bundle('field_collection_item', $field['field_name']);
+
+ // Clear caches.
+ entity_info_cache_clear();
+ // Do not directly issue menu rebuilds here to avoid potentially multiple
+ // rebuilds. Instead, let menu_get_item() issue the rebuild on the next
+ // request.
+ variable_set('menu_rebuild_needed', TRUE);
+ }
+}
+
+/**
+ * Implements hook_field_delete_field().
+ */
+function field_collection_field_delete_field($field) {
+ if ($field['type'] == 'field_collection') {
+ // Notify field.module that field collection was deleted.
+ field_attach_delete_bundle('field_collection_item', $field['field_name']);
+
+ // Clear caches.
+ entity_info_cache_clear();
+ // Do not directly issue menu rebuilds here to avoid potentially multiple
+ // rebuilds. Instead, let menu_get_item() issue the rebuild on the next
+ // request.
+ variable_set('menu_rebuild_needed', TRUE);
+ }
+}
+
+/**
+ * Implements hook_i18n_string_list_{textgroup}_alter().
+ */
+function field_collection_i18n_string_list_field_alter(&$properties, $type, $instance) {
+ if ($type == 'field_instance') {
+ $field = field_info_field($instance['field_name']);
+
+ if ($field['type'] == 'field_collection' && !empty($instance['display'])) {
+
+ foreach ($instance['display'] as $view_mode => $display) {
+ if ($display['type'] != 'field_collection_fields') {
+ $display['settings'] += array('edit' => 'edit', 'delete' => 'delete', 'add' => 'add');
+
+ $properties['field'][$instance['field_name']][$instance['bundle']]['setting_edit'] = array(
+ 'title' => t('Edit link title'),
+ 'string' => $display['settings']['edit'],
+ );
+ $properties['field'][$instance['field_name']][$instance['bundle']]['setting_delete'] = array(
+ 'title' => t('Delete link title'),
+ 'string' => $display['settings']['delete'],
+ );
+ $properties['field'][$instance['field_name']][$instance['bundle']]['setting_add'] = array(
+ 'title' => t('Add link title'),
+ 'string' => $display['settings']['add'],
+ );
+ }
+ }
+ }
+ }
+}
+
+/**
+ * Implements hook_views_api().
+ */
+function field_collection_views_api() {
+ return array(
+ 'api' => '3.0-alpha1',
+ 'path' => drupal_get_path('module', 'field_collection') . '/views',
+ );
+}
+
+/**
+ * Implements hook_features_pipe_component_alter() for fields.
+ */
+function field_collection_features_pipe_field_alter(&$pipe, $data, $export) {
+ // Add the fields of the field collection entity to the pipe.
+ foreach ($data as $identifier) {
+ if (($field = features_field_load($identifier)) && $field['field_config']['type'] == 'field_collection') {
+ $fields = field_info_instances('field_collection_item', $field['field_config']['field_name']);
+ foreach ($fields as $name => $field) {
+ $pipe['field'][] = "{$field['entity_type']}-{$field['bundle']}-{$field['field_name']}";
+ }
+ }
+ }
+}
+
+/**
+ * Callback for generating entity metadata property info for our field instances.
+ *
+ * @see field_collection_field_info()
+ */
+function field_collection_entity_metadata_property_callback(&$info, $entity_type, $field, $instance, $field_type) {
+ $property = &$info[$entity_type]['bundles'][$instance['bundle']]['properties'][$field['field_name']];
+ // Set the bundle as we know it is the name of the field.
+ $property['bundle'] = $field['field_name'];
+ $property['getter callback'] = 'field_collection_field_property_get';
+}
+
+/**
+ * Entity property info setter callback for the host entity property.
+ *
+ * As the property is of type entity, the value will be passed as a wrapped
+ * entity.
+ */
+function field_collection_item_set_host_entity($item, $property_name, $wrapper) {
+ if (empty($item->is_new)) {
+ throw new EntityMetadataWrapperException('The host entity may be set only during creation of a field collection item.');
+ }
+ if (!isset($wrapper->{$item->field_name})) {
+ throw new EntityMetadataWrapperException('The specified entity has no such field collection field.');
+ }
+ $item->setHostEntity($wrapper->type(), $wrapper->value());
+}
+
+/**
+ * Entity property info getter callback for the host entity property.
+ */
+function field_collection_item_get_host_entity($item) {
+ // As the property is defined as 'entity', we have to return a wrapped entity.
+ return entity_metadata_wrapper($item->hostEntityType(), $item->hostEntity());
+}
+
+/**
+ * Entity property info getter callback for the field collection items.
+ *
+ * Like entity_metadata_field_property_get(), but additionally supports getting
+ * not-yet saved collection items from @code $item['entity'] @endcode.
+ */
+function field_collection_field_property_get($entity, array $options, $name, $entity_type, $info) {
+ $field = field_info_field($name);
+ $langcode = field_language($entity_type, $entity, $name, isset($options['language']) ? $options['language']->language : NULL);
+ $values = array();
+ if (isset($entity->{$name}[$langcode])) {
+ foreach ($entity->{$name}[$langcode] as $delta => $data) {
+ // Wrappers do not support multiple entity references being revisions or
+ // not yet saved entities. In the case of a single reference we can return
+ // the entity object though.
+ if ($field['cardinality'] == 1) {
+ $values[$delta] = field_collection_field_get_entity($data);
+ }
+ elseif (isset($data['value'])) {
+ $values[$delta] = $data['value'];
+ }
+ }
+ }
+ // For an empty single-valued field, we have to return NULL.
+ return $field['cardinality'] == 1 ? ($values ? reset($values) : NULL) : $values;
+}
+
+/**
+ * Implements hook_devel_generate().
+ */
+function field_collection_devel_generate($object, $field, $instance, $bundle) {
+ // Create a new field collection object and add fake data to its fields.
+ $field_collection = entity_create('field_collection_item', array('field_name' => $field['field_name']));
+ $field_collection->language = $object->language;
+ $field_collection->setHostEntity($instance['entity_type'], $object, $object->language, FALSE);
+
+ devel_generate_fields($field_collection, 'field_collection_item', $field['field_name']);
+
+ $field_collection->save(TRUE);
+
+ return array('value' => $field_collection->item_id);
+}
diff --git a/sites/all/modules/field_collection/field_collection.pages.inc b/sites/all/modules/field_collection/field_collection.pages.inc
new file mode 100644
index 0000000000000000000000000000000000000000..6e692662dd803a2cd5e64c0f7060fc6348e34f8c
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.pages.inc
@@ -0,0 +1,138 @@
+<?php
+
+/**
+ * @file
+ * Provides the field collection item view / edit / delete pages.
+ */
+
+// TODO: fix being embedded in a host with revisions.
+
+/**
+ * Field collection item view page.
+ */
+function field_collection_item_page_view($field_collection_item) {
+ // @todo: Set breadcrumb including the host.
+ drupal_set_title($field_collection_item->label());
+ return $field_collection_item->view('full', NULL, TRUE);
+}
+
+/**
+ * Form for editing a field collection item.
+ * @todo implement hook_forms().
+ */
+function field_collection_item_form($form, &$form_state, $field_collection_item) {
+ if (!isset($field_collection_item->is_new)) {
+ drupal_set_title($field_collection_item->label());
+ }
+ $form_state += array('field_collection_item' => $field_collection_item);
+
+ // Hack: entity_form_field_validate() needs the bundle to be set.
+ // @todo: Fix core and remove the hack.
+ $form['field_name'] = array('#type' => 'value', '#value' => $field_collection_item->field_name);
+
+ field_attach_form('field_collection_item', $field_collection_item, $form, $form_state);
+
+ $form['actions'] = array('#type' => 'actions', '#weight' => 50);
+ $form['actions']['submit'] = array(
+ '#type' => 'submit',
+ '#value' => t('Save'),
+ '#weight' => 5,
+ );
+ return $form;
+}
+
+/**
+ * Validation callback.
+ */
+function field_collection_item_form_validate($form, &$form_state) {
+ entity_form_field_validate('field_collection_item', $form, $form_state);
+}
+
+/**
+ * Submit builder. Extracts the form values and updates the entity.
+ */
+function field_collection_item_form_submit_build_field_collection($form, $form_state) {
+ entity_form_submit_build_entity('field_collection_item', $form_state['field_collection_item'], $form, $form_state);
+ return $form_state['field_collection_item'];
+}
+
+/**
+ * Submit callback that permanently saves the changes to the entity.
+ */
+function field_collection_item_form_submit($form, &$form_state) {
+ $field_collection_item = field_collection_item_form_submit_build_field_collection($form, $form_state);
+ $field_collection_item->save();
+ drupal_set_message(t('The changes have been saved.'));
+ $form_state['redirect'] = $field_collection_item->path();
+}
+
+/**
+ * Form for deleting a field collection item.
+ */
+function field_collection_item_delete_confirm($form, &$form_state, $field_collection_item) {
+ $form_state += array('field_collection_item' => $field_collection_item);
+ return confirm_form($form,
+ t('Are you sure you want to delete %label?', array('%label' => $field_collection_item->label())),
+ $field_collection_item->path(),
+ t('This action cannot be undone.'),
+ t('Delete'),
+ t('Cancel')
+ );
+}
+
+/**
+ * Submit callback for deleting a field collection item.
+ */
+function field_collection_item_delete_confirm_submit($form, &$form_state) {
+ $field_collection_item = $form_state['field_collection_item'];
+ $field_collection_item->deleteRevision();
+ drupal_set_message(t('%label has been deleted.', array('%label' => drupal_ucfirst($field_collection_item->label()))));
+ $form_state['redirect'] = '<front>';
+}
+
+/**
+ * Add a new field collection item.
+ *
+ * @todo: Support optionally passing in the revision_id and langcode parameters.
+ */
+function field_collection_item_add($field_name, $entity_type, $entity_id, $revision_id = NULL, $langcode = NULL) {
+ $info = entity_get_info();
+ if (!isset($info[$entity_type])) {
+ return MENU_NOT_FOUND;
+ }
+ $result = entity_load($entity_type, array($entity_id));
+ $entity = reset($result);
+ if (!$entity) {
+ return MENU_NOT_FOUND;
+ }
+ // Ensure the given entity is of a bundle that has an instance of the field.
+ list($id, $rev_id, $bundle) = entity_extract_ids($entity_type, $entity);
+ $instance = field_info_instance($entity_type, $field_name, $bundle);
+ if (!$instance) {
+ return MENU_NOT_FOUND;
+ }
+
+ // Check field cardinality.
+ $field = field_info_field($field_name);
+ $langcode = LANGUAGE_NONE;
+ if (!($field['cardinality'] == FIELD_CARDINALITY_UNLIMITED || !isset($entity->{$field_name}[$langcode]) || count($entity->{$field_name}[$langcode]) < $field['cardinality'])) {
+ drupal_set_message(t('Too many items.'), 'error');
+ return '';
+ }
+
+ $field_collection_item = entity_create('field_collection_item', array('field_name' => $field_name));
+ // Do not link the field collection item with the host entity at this point,
+ // as during the form-workflow we have multiple field collection item entity
+ // instances, which we don't want link all with the host.
+ // That way the link is going to be created when the item is saved.
+ $field_collection_item->setHostEntity($entity_type, $entity, LANGUAGE_NONE, FALSE);
+
+ $title = ($field['cardinality'] == 1) ? $instance['label'] : t('Add new !instance_label', array('!instance_label' => $field_collection_item->translatedInstanceLabel()));
+ drupal_set_title($title);
+
+ // Make sure the current user has access to create a field collection item.
+ if (!field_collection_item_access('create', $field_collection_item)) {
+ return MENU_ACCESS_DENIED;
+ }
+ return drupal_get_form('field_collection_item_form', $field_collection_item);
+}
diff --git a/sites/all/modules/field_collection/field_collection.test b/sites/all/modules/field_collection/field_collection.test
new file mode 100644
index 0000000000000000000000000000000000000000..b62d048736fa3b4f9711b2fac839e425a7ce24fa
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.test
@@ -0,0 +1,422 @@
+<?php
+
+/**
+ * @file
+ * field_collections tests.
+ */
+
+/**
+ * Test basics.
+ */
+class FieldCollectionBasicTestCase extends DrupalWebTestCase {
+
+ public static function getInfo() {
+ return array(
+ 'name' => 'Field collection',
+ 'description' => 'Tests creating and using field collections.',
+ 'group' => 'Field types',
+ );
+ }
+
+ function setUp() {
+ parent::setUp('field_collection');
+
+ // Create a field_collection field to use for the tests.
+ $this->field_name = 'field_test_collection';
+ $this->field = array('field_name' => $this->field_name, 'type' => 'field_collection', 'cardinality' => 4);
+ $this->field = field_create_field($this->field);
+ $this->field_id = $this->field['id'];
+
+ $this->instance = array(
+ 'field_name' => $this->field_name,
+ 'entity_type' => 'node',
+ 'bundle' => 'article',
+ 'label' => $this->randomName() . '_label',
+ 'description' => $this->randomName() . '_description',
+ 'weight' => mt_rand(0, 127),
+ 'settings' => array(),
+ 'widget' => array(
+ 'type' => 'hidden',
+ 'label' => 'Test',
+ 'settings' => array(),
+ ),
+ );
+ $this->instance = field_create_instance($this->instance);
+ }
+
+ /**
+ * Helper for creating a new node with a field collection item.
+ */
+ protected function createNodeWithFieldCollection() {
+ $node = $this->drupalCreateNode(array('type' => 'article'));
+ // Manually create a field_collection.
+ $entity = entity_create('field_collection_item', array('field_name' => $this->field_name));
+ $entity->setHostEntity('node', $node);
+ $entity->save();
+
+ return array($node, $entity);
+ }
+
+ /**
+ * Tests CRUD.
+ */
+ function testCRUD() {
+ list ($node, $entity) = $this->createNodeWithFieldCollection();
+ $node = node_load($node->nid, NULL, TRUE);
+ $this->assertEqual($entity->item_id, $node->{$this->field_name}[LANGUAGE_NONE][0]['value'], 'A field_collection has been successfully created and referenced.');
+ $this->assertEqual($entity->revision_id, $node->{$this->field_name}[LANGUAGE_NONE][0]['revision_id'], 'A field_collection has been successfully created and referenced.');
+
+ // Test adding an additional field_collection during node edit.
+ $entity2 = entity_create('field_collection_item', array('field_name' => $this->field_name));
+ $node->{$this->field_name}[LANGUAGE_NONE][] = array('entity' => $entity2);
+ node_save($node);
+
+ $node = node_load($node->nid, NULL, TRUE);
+ $this->assertTrue(!empty($entity2->item_id) && !empty($entity2->revision_id), 'Field_collection has been saved.');
+ $this->assertEqual($entity->item_id, $node->{$this->field_name}[LANGUAGE_NONE][0]['value'], 'Existing reference has been kept during update.');
+ $this->assertEqual($entity->revision_id, $node->{$this->field_name}[LANGUAGE_NONE][0]['revision_id'], 'Existing reference has been kept during update (revision).');
+ $this->assertEqual($entity2->item_id, $node->{$this->field_name}[LANGUAGE_NONE][1]['value'], 'New field_collection has been properly referenced');
+ $this->assertEqual($entity2->revision_id, $node->{$this->field_name}[LANGUAGE_NONE][1]['revision_id'], 'New field_collection has been properly referenced (revision)');
+
+ // Make sure deleting the field_collection removes the reference.
+ $entity2->delete();
+ $node = node_load($node->nid, NULL, TRUE);
+ $this->assertTrue(!isset($node->{$this->field_name}[LANGUAGE_NONE][1]), 'Reference correctly deleted.');
+
+ // Make sure field_collections are removed during deletion of the host.
+ node_delete($node->nid);
+ $this->assertTrue(entity_load('field_collection_item', FALSE) === array(), 'Field collections are deleted when the host is deleted.');
+
+ // Try deleting nodes with collections without any values.
+ $node = $this->drupalCreateNode(array('type' => 'article'));
+ node_delete($node->nid);
+ $this->assertTrue(node_load($node->nid, NULL, TRUE) == FALSE, 'Node without collection values deleted.');
+
+ // Test creating a field collection entity with a not-yet saved host entity.
+ $node = entity_create('node', array('type' => 'article'));
+ $entity = entity_create('field_collection_item', array('field_name' => $this->field_name));
+ $entity->setHostEntity('node', $node);
+ $entity->save();
+ // Now the node should have been saved with the collection and the link
+ // should have been established.
+ $this->assertTrue(!empty($node->nid), 'Node has been saved with the collection.');
+ $this->assertTrue(count($node->{$this->field_name}[LANGUAGE_NONE]) == 1 && !empty($node->{$this->field_name}[LANGUAGE_NONE][0]['value']) && !empty($node->{$this->field_name}[LANGUAGE_NONE][0]['revision_id']), 'Link has been established.');
+
+ // Again, test creating a field collection with a not-yet saved host entity,
+ // but this time save both entities via the host.
+ $node = entity_create('node', array('type' => 'article'));
+ $entity = entity_create('field_collection_item', array('field_name' => $this->field_name));
+ $entity->setHostEntity('node', $node);
+ node_save($node);
+ $this->assertTrue(!empty($entity->item_id) && !empty($entity->revision_id), 'Collection has been saved with the host.');
+ $this->assertTrue(count($node->{$this->field_name}[LANGUAGE_NONE]) == 1 && !empty($node->{$this->field_name}[LANGUAGE_NONE][0]['value']) && !empty($node->{$this->field_name}[LANGUAGE_NONE][0]['revision_id']), 'Link has been established.');
+
+ // Test Revisions.
+ list ($node, $item) = $this->createNodeWithFieldCollection();
+
+ // Test saving a new revision of a node.
+ $node->revision = TRUE;
+ node_save($node);
+ $item_updated = field_collection_item_load($node->{$this->field_name}[LANGUAGE_NONE][0]['value']);
+ $this->assertNotEqual($item->revision_id, $item_updated->revision_id, 'Creating a new host entity revision creates a new field collection revision.');
+
+ // Test saving the node without creating a new revision.
+ $item = $item_updated;
+ $node->revision = FALSE;
+ node_save($node);
+ $item_updated = field_collection_item_load($node->{$this->field_name}[LANGUAGE_NONE][0]['value']);
+ $this->assertEqual($item->revision_id, $item_updated->revision_id, 'Updating a new host entity without creating a new revision does not create a new field collection revision.');
+
+ // Create a new revision of the node, such we have a non default node and
+ // field collection revision. Then test using it.
+ $vid = $node->vid;
+ $item_revision_id = $item_updated->revision_id;
+ $node->revision = TRUE;
+ node_save($node);
+
+ $item_updated = field_collection_item_load($node->{$this->field_name}[LANGUAGE_NONE][0]['value']);
+ $this->assertNotEqual($item_revision_id, $item_updated->revision_id, 'Creating a new host entity revision creates a new field collection revision.');
+ $this->assertTrue($item_updated->isDefaultRevision(), 'Field collection of default host entity revision is default too.');
+ $this->assertEqual($item_updated->hostEntityId(), $node->nid, 'Can access host entity ID of default field collection revision.');
+ $this->assertEqual($item_updated->hostEntity()->vid, $node->vid, 'Loaded default host entity revision.');
+
+ $item = entity_revision_load('field_collection_item', $item_revision_id);
+ $this->assertFalse($item->isDefaultRevision(), 'Field collection of non-default host entity is non-default too.');
+ $this->assertEqual($item->hostEntityId(), $node->nid, 'Can access host entity ID of non-default field collection revision.');
+ $this->assertEqual($item->hostEntity()->vid, $vid, 'Loaded non-default host entity revision.');
+
+ // Delete the non-default revision and make sure the field collection item
+ // revision has been deleted too.
+ entity_revision_delete('node', $vid);
+ $this->assertFalse(entity_revision_load('node', $vid), 'Host entity revision deleted.');
+ $this->assertFalse(entity_revision_load('field_collection_item', $item_revision_id), 'Field collection item revision deleted.');
+
+ // Test having archived field collections, i.e. collections referenced only
+ // in non-default revisions.
+ list ($node, $item) = $this->createNodeWithFieldCollection();
+ // Create two revisions.
+ $node_vid = $node->vid;
+ $node->revision = TRUE;
+ node_save($node);
+
+ $node_vid2 = $node->vid;
+ $node->revision = TRUE;
+ node_save($node);
+
+ // Now delete the field collection item for the default revision.
+ $item = field_collection_item_load($node->{$this->field_name}[LANGUAGE_NONE][0]['value']);
+ $item_revision_id = $item->revision_id;
+ $item->deleteRevision();
+ $node = node_load($node->nid);
+ $this->assertTrue(!isset($node->{$this->field_name}[LANGUAGE_NONE][0]), 'Field collection item revision removed from host.');
+ $this->assertFalse(field_collection_item_revision_load($item->revision_id), 'Field collection item default revision deleted.');
+
+ $item = field_collection_item_load($item->item_id);
+ $this->assertNotEqual($item->revision_id, $item_revision_id, 'Field collection default revision has been updated.');
+ $this->assertTrue($item->archived, 'Field collection item has been archived.');
+ $this->assertFalse($item->isInUse(), 'Field collection item specified as not in use.');
+ $this->assertTrue($item->isDefaultRevision(), 'Field collection of non-default host entity is default (but archived).');
+ $this->assertEqual($item->hostEntityId(), $node->nid, 'Can access host entity ID of non-default field collection revision.');
+ $this->assertEqual($item->hostEntity()->nid, $node->nid, 'Loaded non-default host entity revision.');
+
+ // Test deleting a revision of an archived field collection.
+ $node_revision2 = node_load($node->nid, $node_vid2);
+ $item = field_collection_item_revision_load($node_revision2->{$this->field_name}[LANGUAGE_NONE][0]['revision_id']);
+ $item->deleteRevision();
+ // There should be one revision left, so the item should still exist.
+ $item = field_collection_item_load($item->item_id);
+ $this->assertTrue($item->archived, 'Field collection item is still archived.');
+ $this->assertFalse($item->isInUse(), 'Field collection item specified as not in use.');
+
+ // Test that deleting the first node revision deletes the whole field
+ // collection item as it contains its last revision.
+ node_revision_delete($node_vid);
+ $this->assertFalse(field_collection_item_load($item->item_id), 'Archived field collection deleted when last revision deleted.');
+
+ // Test that removing a field-collection item also deletes it.
+ list ($node, $item) = $this->createNodeWithFieldCollection();
+
+ $node->{$this->field_name}[LANGUAGE_NONE] = array();
+ $node->revision = FALSE;
+ node_save($node);
+ $this->assertFalse(field_collection_item_load($item->item_id), 'Removed field collection item has been deleted.');
+
+ // Test removing a field-collection item while creating a new host revision.
+ list ($node, $item) = $this->createNodeWithFieldCollection();
+ $node->{$this->field_name}[LANGUAGE_NONE] = array();
+ $node->revision = TRUE;
+ node_save($node);
+ // Item should not be deleted but archived now.
+ $item = field_collection_item_load($item->item_id);
+ $this->assertTrue($item, 'Removed field collection item still exists.');
+ $this->assertTrue($item->archived, 'Removed field collection item is archived.');
+ }
+
+ /**
+ * Make sure the basic UI and access checks are working.
+ */
+ function testBasicUI() {
+ // Add a field to the collection.
+ $field = array(
+ 'field_name' => 'field_text',
+ 'type' => 'text',
+ 'cardinality' => 1,
+ 'translatable' => FALSE,
+ );
+ field_create_field($field);
+ $instance = array(
+ 'entity_type' => 'field_collection_item',
+ 'field_name' => 'field_text',
+ 'bundle' => $this->field_name,
+ 'label' => 'Test text field',
+ 'widget' => array(
+ 'type' => 'text_textfield',
+ ),
+ );
+ field_create_instance($instance);
+
+ $user = $this->drupalCreateUser();
+ $node = $this->drupalCreateNode(array('type' => 'article'));
+
+ $this->drupalLogin($user);
+ // Make sure access is denied.
+ $path = 'field-collection/field-test-collection/add/node/' . $node->nid;
+ $this->drupalGet($path);
+ $this->assertText(t('Access denied'), 'Access has been denied.');
+
+ $user_privileged = $this->drupalCreateUser(array('access content', 'edit any article content'));
+ $this->drupalLogin($user_privileged);
+ $this->drupalGet("node/$node->nid");
+ $this->assertLinkByHref($path, 0, 'Add link is shown.');
+ $this->drupalGet($path);
+ $this->assertText(t('Test text field'), 'Add form is shown.');
+
+ $edit['field_text[und][0][value]'] = $this->randomName();
+ $this->drupalPost($path, $edit, t('Save'));
+ $this->assertText(t('The changes have been saved.'), 'Field collection saved.');
+
+ $this->assertText($edit['field_text[und][0][value]'], "Added field value is shown.");
+
+ $edit['field_text[und][0][value]'] = $this->randomName();
+ $this->drupalPost('field-collection/field-test-collection/1/edit', $edit, t('Save'));
+ $this->assertText(t('The changes have been saved.'), 'Field collection saved.');
+ $this->assertText($edit['field_text[und][0][value]'], "Field collection has been edited.");
+
+ $this->drupalGet('field-collection/field-test-collection/1');
+ $this->assertText($edit['field_text[und][0][value]'], "Field collection can be viewed.");
+
+ // Add further 3 items, so we have reached 4 == maxium cardinality.
+ $this->drupalPost($path, $edit, t('Save'));
+ $this->drupalPost($path, $edit, t('Save'));
+ $this->drupalPost($path, $edit, t('Save'));
+ // Make sure adding doesn't work any more as we have restricted cardinality
+ // to 1.
+ $this->drupalGet($path);
+ $this->assertText(t('Too many items.'), 'Maxium cardinality has been reached.');
+
+ $this->drupalPost('field-collection/field-test-collection/1/delete', array(), t('Delete'));
+ $this->drupalGet($path);
+ // Add form is shown again.
+ $this->assertText(t('Test text field'), 'Field collection item has been deleted.');
+
+ // Test the viewing a revision. There should be no links to change it.
+ $vid = $node->vid;
+ $node = node_load($node->nid, NULL, TRUE);
+ $node->revision = TRUE;
+ node_save($node);
+
+ $this->drupalGet("node/$node->nid/revisions/$vid/view");
+ $this->assertResponse(403, 'Access to view revision denied');
+ // Login in as admin and try again.
+ $user = $this->drupalCreateUser(array('administer nodes', 'bypass node access'));
+ $this->drupalLogin($user);
+ $this->drupalGet("node/$node->nid/revisions/$vid/view");
+ $this->assertNoResponse(403, 'Access to view revision granted');
+
+ $this->assertNoLinkByHref($path, 'No links on revision view.');
+ $this->assertNoLinkByHref('field-collection/field-test-collection/2/edit', 'No links on revision view.');
+ $this->assertNoLinkByHref('field-collection/field-test-collection/2/delete', 'No links on revision view.');
+
+ $this->drupalGet("node/$node->nid/revisions");
+ }
+}
+
+
+/**
+ * Test using field collection with Rules.
+ */
+class FieldCollectionRulesIntegrationTestCase extends DrupalWebTestCase {
+
+ public static function getInfo() {
+ return array(
+ 'name' => 'Field collection Rules integration',
+ 'description' => 'Tests using field collections with rules.',
+ 'group' => 'Field types',
+ 'dependencies' => array('rules'),
+ );
+ }
+
+ function setUp() {
+ parent::setUp(array('field_collection', 'rules'));
+ variable_set('rules_debug_log', 1);
+ }
+
+ protected function createFields($cardinality = 4) {
+ // Create a field_collection field to use for the tests.
+ $this->field_name = 'field_test_collection';
+ $this->field = array('field_name' => $this->field_name, 'type' => 'field_collection', 'cardinality' => $cardinality);
+ $this->field = field_create_field($this->field);
+ $this->field_id = $this->field['id'];
+
+ $this->instance = array(
+ 'field_name' => $this->field_name,
+ 'entity_type' => 'node',
+ 'bundle' => 'article',
+ 'label' => $this->randomName() . '_label',
+ 'description' => $this->randomName() . '_description',
+ 'weight' => mt_rand(0, 127),
+ 'settings' => array(),
+ 'widget' => array(
+ 'type' => 'hidden',
+ 'label' => 'Test',
+ 'settings' => array(),
+ ),
+ );
+ $this->instance = field_create_instance($this->instance);
+ // Add a field to the collection.
+ $field = array(
+ 'field_name' => 'field_text',
+ 'type' => 'text',
+ 'cardinality' => 1,
+ 'translatable' => FALSE,
+ );
+ field_create_field($field);
+ $instance = array(
+ 'entity_type' => 'field_collection_item',
+ 'field_name' => 'field_text',
+ 'bundle' => $this->field_name,
+ 'label' => 'Test text field',
+ 'widget' => array(
+ 'type' => 'text_textfield',
+ ),
+ );
+ field_create_instance($instance);
+ }
+
+ /**
+ * Test creation field collection items.
+ */
+ function testCreation() {
+ $this->createFields();
+
+ $node = $this->drupalCreateNode(array('type' => 'article'));
+ // Create a field collection.
+ $action_set = rules_action_set(array('node' => array('type' => 'node', 'bundle' => 'article')));
+ $action_set->action('entity_create', array(
+ 'type' => 'field_collection_item',
+ 'param_field_name' => $this->field_name,
+ 'param_host_entity:select' => 'node',
+ ));
+ $action_set->action('data_set', array('data:select' => 'entity-created:field-text', 'value' => 'foo'));
+ $action_set->execute($node);
+
+ $node = node_load($node->nid, NULL, TRUE);
+ $this->assertTrue(!empty($node->{$this->field_name}[LANGUAGE_NONE][0]['value']), 'A field_collection has been successfully created.');
+ $this->assertTrue(!empty($node->{$this->field_name}[LANGUAGE_NONE][0]['revision_id']), 'A field_collection has been successfully created (revision).');
+
+ // Now try making use of the field collection in rules.
+ $action_set = rules_action_set(array('node' => array('type' => 'node', 'bundle' => 'article')));
+ $action_set->action('drupal_message', array('message:select' => 'node:field-test-collection:0:field-text'));
+ $action_set->execute($node);
+
+ $msg = drupal_get_messages();
+ $this->assertEqual(array_pop($msg['status']), 'foo', 'Field collection can be used.');
+ RulesLog::logger()->checkLog();
+ }
+
+ /**
+ * Test using field collection items via the host while they are being created.
+ */
+ function testUsageDuringCreation() {
+ // Test using a single-cardinality field collection.
+ $this->createFields(1);
+
+ $node = $this->drupalCreateNode(array('type' => 'article'));
+ $entity = entity_create('field_collection_item', array('field_name' => $this->field_name));
+ $entity->setHostEntity('node', $node);
+ // Now the field collection is linked to the host, but not yet saved.
+
+ // Test using the wrapper on it.
+ $wrapper = entity_metadata_wrapper('node', $node);
+ $wrapper->get($this->field_name)->field_text->set('foo');
+ $this->assertEqual($entity->field_text[LANGUAGE_NONE][0]['value'], 'foo', 'Field collection item used during creation via the wrapper.');
+
+ // Now test it via Rules, which should save our changes.
+ $set = rules_action_set(array('node' => array('type' => 'node', 'bundle' => 'article')));
+ $set->action('data_set', array('data:select' => 'node:' . $this->field_name . ':field-text', 'value' => 'bar'));
+ $set->execute($node);
+ $this->assertEqual($entity->field_text[LANGUAGE_NONE][0]['value'], 'bar', 'Field collection item used during creation via Rules.');
+ $this->assertTrue(!empty($entity->item_id) && !empty($entity->revision_id), 'Field collection item has been saved by Rules and the host entity.');
+ RulesLog::logger()->checkLog();
+ }
+}
diff --git a/sites/all/modules/field_collection/field_collection.theme.css b/sites/all/modules/field_collection/field_collection.theme.css
new file mode 100644
index 0000000000000000000000000000000000000000..b619185c3841a828c2efe5ac570a2f786e8ed919
--- /dev/null
+++ b/sites/all/modules/field_collection/field_collection.theme.css
@@ -0,0 +1,66 @@
+@CHARSET "UTF-8";
+
+.field-collection-container {
+ border-bottom: 1px solid #D3D7D9;
+ margin-bottom: 1em;
+}
+
+.field-collection-container .field-items .field-item {
+ margin-bottom: 10px;
+}
+
+.field-collection-container .field-items .field-items .field-item {
+ margin-bottom: 0;
+}
+
+.field-collection-view {
+ padding: 1em 0 0.3em 0;
+ margin: 0 1em 0 1em;
+ border-bottom: 1px dotted #D3D7D9;
+}
+
+/* If there is no add link, don't show the final border. */
+.field-collection-view-final {
+ border-bottom: none;
+}
+
+.field-collection-view .entity-field-collection-item {
+ float: left;
+}
+
+.field-collection-view ul.field-collection-view-links {
+ float: right;
+ font-size: 0.821em;
+ list-style-type: none;
+ width: auto;
+ margin: 0 1em;
+ padding: 0;
+}
+
+.field-collection-view .field-label {
+ width: 25%;
+}
+
+.field-collection-view .content {
+ margin-top: 0;
+ width: 100%;
+}
+
+.field-collection-view .entity-field-collection-item {
+ width: 100%;
+}
+
+ul.field-collection-view-links li {
+ float: left;
+}
+
+ul.field-collection-view-links li a {
+ margin-right: 1em;
+}
+
+.field-collection-container ul.action-links-field-collection-add {
+ float: right;
+ padding: 0 0.5em 0 0;
+ margin: 0 0 1em 2em;
+ font-size: 0.821em;
+}
diff --git a/sites/all/modules/field_collection/views/field_collection.views.inc b/sites/all/modules/field_collection/views/field_collection.views.inc
new file mode 100644
index 0000000000000000000000000000000000000000..a4e8a0d9ea8de871f7efc65afa651da549c6992c
--- /dev/null
+++ b/sites/all/modules/field_collection/views/field_collection.views.inc
@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * Implements hook_field_views_data().
+ *
+ * Views integration for field collection fields. Adds a relationship to the
+ * default field data.
+ *
+ * @see field_views_field_default_views_data()
+ */
+function field_collection_field_views_data($field) {
+ $data = field_views_field_default_views_data($field);
+
+ foreach ($data as $table_name => $table_data) {
+ foreach ($table_data as $field_name => $field_data) {
+ // Only operate on the "field_api_field_name"_value column.
+ if (strrpos($field_name, '_value') === (strlen($field_name) - strlen('_value'))) {
+ $data[$table_name][$field_name]['relationship'] = array(
+ 'handler' => 'field_collection_handler_relationship',
+ 'base' => 'field_collection_item',
+ 'base field' => 'item_id',
+ 'label' => t('field collection item from !field_name', array('!field_name' => $field['field_name'])),
+ 'field_name' => $field['field_name'],
+ );
+ }
+ }
+ }
+
+ foreach ($field['bundles'] as $entity_type => $bundles) {
+ $entity_info = entity_get_info($entity_type);
+ $pseudo_field_name = $field['field_name'] . '_' . $entity_type;
+
+ list($label, $all_labels) = field_views_field_label($field['field_name']);
+ $entity = $entity_info['label'];
+ if ($entity == t('Node')) {
+ $entity = t('Content');
+ }
+
+ $data['field_collection_item'][$pseudo_field_name]['relationship'] = array(
+ 'title' => t('Entity with the @field (@field_name)', array('@entity' => $entity, '@field' => $label, '@field_name' => $field['field_name'])),
+ 'help' => t('Relate each @entity using @field.', array('@entity' => $entity, '@field' => $label)),
+ 'handler' => 'views_handler_relationship_entity_reverse',
+ 'field_name' => $field['field_name'],
+ 'field table' => _field_sql_storage_tablename($field),
+ 'field field' => $field['field_name'] . '_value',
+ 'base' => $entity_info['base table'],
+ 'base field' => $entity_info['entity keys']['id'],
+ 'label' => t('!field_name', array('!field_name' => $field['field_name'])),
+ );
+ }
+
+ return $data;
+}
diff --git a/sites/all/modules/field_collection/views/field_collection_handler_relationship.inc b/sites/all/modules/field_collection/views/field_collection_handler_relationship.inc
new file mode 100644
index 0000000000000000000000000000000000000000..afbe121710290209ce1d07f245e89c37c0f0afd4
--- /dev/null
+++ b/sites/all/modules/field_collection/views/field_collection_handler_relationship.inc
@@ -0,0 +1,58 @@
+<?php
+
+/**
+ * @file
+ * Provide relationship handler for field collection fields.
+ */
+class field_collection_handler_relationship extends views_handler_relationship {
+
+ function option_definition() {
+ $options = parent::option_definition();
+ $options['delta'] = array('default' => -1);
+
+ return $options;
+ }
+
+ /**
+ * Add a delta selector for multiple fields.
+ */
+ function options_form(&$form, &$form_state) {
+ parent::options_form($form, $form_state);
+
+ $field = field_info_field($this->definition['field_name']);
+
+ // Only add the delta selector if the field is multiple.
+ if ($field['cardinality']) {
+ $max_delta = ($field['cardinality'] == FIELD_CARDINALITY_UNLIMITED) ? 10 : $field['cardinality'];
+
+ $options = array('-1' => t('All'));
+ for ($i = 0; $i < $max_delta; $i++) {
+ $options[$i] = $i + 1;
+ }
+ $form['delta'] = array(
+ '#type' => 'select',
+ '#options' => $options,
+ '#default_value' => $this->options['delta'],
+ '#title' => t('Delta'),
+ '#description' => t('The delta allows you to select which item in a multiple value field to key the relationship off of. Select "1" to use the first item, "2" for the second item, and so on. If you select "All", each item in the field will create a new row, which may appear to cause duplicates.'),
+ );
+ }
+ }
+
+ function ensure_my_table() {
+ $field = field_info_field($this->definition['field_name']);
+
+ if (!isset($this->table_alias)) {
+ $join = $this->get_join();
+ if ($this->options['delta'] != -1 && $field['cardinality']) {
+ $join->extra[] = array(
+ 'field' => 'delta',
+ 'value' => $this->options['delta'],
+ 'numeric' => TRUE,
+ );
+ }
+ $this->table_alias = $this->query->add_table($this->table, $this->relationship, $join);
+ }
+ return $this->table_alias;
+ }
+}