You are here

Home » API reference » i18n node reference synch 7

README.txt in i18n node reference synch 7 

23-05-2013, Copyright by Cipix Internet. E-mail: info@cipix.nl.

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Known issues
 * Installation
 * Details

INTRODUCTION
------------

Current Maintainer: Bas van Meurs <bas@cipix.nl> or <bvanmeurs1985@gmail.com.

Provides i18n field synchronisation for a node_reference field.

The referenced nodes are translated into the correct language. If no such
language exists, it is ignored. This is the same functionality as is supported
by the taxonomy reference translation in i18n_taxonomy.

KNOWN ISSUES
------------

The Simpletest will fail currently because of a bug in the 'parent' class in the
i18n.test file. Hopefully this will be fixed quickly.

INSTALLATION
------------

Enable the module. Enable the node_reference fields that you want to keep
synchronized in the 'Synchonize translations' on the node type edit page.

Nothing will directly be done to the existing field reference, but the next time
you will save a node the node reference field(s) will automatically be
synchronized.

DETAILS
------------

Consider saving multilingual node A (in language 'en', notation A[en]) with a
node reference field in which nodes X[en], Y[en], Z[und] are referenced.
Consider A has language 'en', but also has a version with language 'nl' (A[nl]).
Consider X, Y are both 'en', while Z is 'und' (not translatable).
X has also been translated in 'nl'.

Now, when saving A[en], the node references in A[nl] are also updated.
The values of the reference field in A[nl] will be set to: X[nl] and Z[und].
There is no 'nl' version for Y[en] so it is not referenced.

Next, when opening A[nl] and saving it, it is undesirable that the reference
from A[en] to Y[en] is removed (because it's obscure for the user that this
happens). That's why node references not available in the currently saved node's
language will be preserved when synchronizing node_reference fields.

File

README.txt
View source 
  1. 23-05-2013, Copyright by Cipix Internet. E-mail: info@cipix.nl.

  2. 

  3. CONTENTS OF THIS FILE

  4. ---------------------

  5. 

  6.  * Introduction

  7.  * Known issues

  8.  * Installation

  9.  * Details

  10. 

  11. INTRODUCTION

  12. ------------

  13. 

  14. Current Maintainer: Bas van Meurs  or 
  15. 

  16. Provides i18n field synchronisation for a node_reference field.

  17. 

  18. The referenced nodes are translated into the correct language. If no such

  19. language exists, it is ignored. This is the same functionality as is supported

  20. by the taxonomy reference translation in i18n_taxonomy.

  21. 

  22. KNOWN ISSUES

  23. ------------

  24. 

  25. The Simpletest will fail currently because of a bug in the 'parent' class in the

  26. i18n.test file. Hopefully this will be fixed quickly.

  27. 

  28. INSTALLATION

  29. ------------

  30. 

  31. Enable the module. Enable the node_reference fields that you want to keep

  32. synchronized in the 'Synchonize translations' on the node type edit page.

  33. 

  34. Nothing will directly be done to the existing field reference, but the next time

  35. you will save a node the node reference field(s) will automatically be

  36. synchronized.

  37. 

  38. DETAILS

  39. ------------

  40. 

  41. Consider saving multilingual node A (in language 'en', notation A[en]) with a

  42. node reference field in which nodes X[en], Y[en], Z[und] are referenced.

  43. Consider A has language 'en', but also has a version with language 'nl' (A[nl]).

  44. Consider X, Y are both 'en', while Z is 'und' (not translatable).

  45. X has also been translated in 'nl'.

  46. 

  47. Now, when saving A[en], the node references in A[nl] are also updated.

  48. The values of the reference field in A[nl] will be set to: X[nl] and Z[und].

  49. There is no 'nl' version for Y[en] so it is not referenced.

  50. 

  51. Next, when opening A[nl] and saving it, it is undesirable that the reference

  52. from A[en] to Y[en] is removed (because it's obscure for the user that this

  53. happens). That's why node references not available in the currently saved node's

  54. language will be preserved when synchronizing node_reference fields.