Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
This project provides D7 versions of the 'node_reference' and 'user_reference' field types, that were part of the CCK package in D6, at functional parity with the D6 counterparts. See http://drupal.org/node/533222 for details.
Note for users upgrading from References 7.x-2.0-beta3
There were a couple changes in the way 'References' views are handled ("referenceable nodes/users defined by a view"), which might require double-checking those existing on your site:
- The 'label' (node title or user name) is no longer automatically added if not included in the view. If some of your 'References' views currently do not include it, you might want to add it explicitly, else it will no longer appear in the widgets.
- The HTML generated by the view is no longer stripped out before being handed to "checkboxes / radios" widgets, thus allowing advanced formatting. You might want to check for Reference views having fields configured to display "as links", since the (probably unwanted)
<a>
tags generated by Views are not removed anymore.
Note for users upgrading from CCK D6
- The References project integrates with the
content_migrate
module present in CCK 7.x-2.x-dev to allow the migration of field definitions and field values from D6nodereference
anduserreference
fields. Field values are safely migrated, and a best effort is made for the field definitions, but the settings for widgets and formatters might need to be manually checked and adjusted after the migration. - The "referenceable nodes/users defined by a view" feature is now supported through the dedicated 'References' views Display type, as opposed to using the
default
display in D6. A temporary backward-compatibility layer is included and the existing views should keep working as expected (if they have been properly adapted/migrated from D6 themselves), but it is highly recommended to edit them and add an explicit 'References' display - submitting the "field settings" will lose the currently selected view if it doesn't have a 'References' display. - The remarks in "Note for users upgrading from beta3" above also apply.
Similar modules:
- Entity Reference
- If you started with References and want to switch to Entity Reference consider the Reference to EntityReference Field Migration module
Supporting organizations:
Project information
- Seeking co-maintainer(s)
Maintainers are looking for help reviewing issues. - Maintenance fixes only
Considered feature-complete by its maintainers. - 43,958 sites report using this module
- Created by fgm on , updated
- Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
7.x-2.4
released 22 June 2022
Works with Drupal: 7.x
✓ Recommended by the project’s maintainer.
Development version: 7.x-2.x-dev updated 22 Jun 2022 at 16:57 UTC