Editing Translation (section)

=== Setting the language of outgoing e-mail messages ===

By default, all e-mail messages are sent out on the default language of the depository. You might let the users choose their preferred language so that they'll receive messages on that language. The ''lang'' (system) field is defined for all users; the value can be set automatically in 
[[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/cfg.d|cfg/cfg.d/user_fields_automatic.pl]] for example by

 $c->{set_user_automatic_fields} = sub
 { my ( $user ) = @_;
    if( !$user -> is_set( "frequency" ) )
   {
         $user->set_value("frequency","never");
    }
    ## NEW: set default language to the session language
    if( !$user -> is_set( "lang" ) )
    {
         $user->set_value("lang",$user->{session}->{lang}->{id});
    }
 }

and also let the user edit their own preference by inserting the ''lang'' field in the [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/workflows/user|cfg/workflows/user/default.xml]] workflow, say in the personal section:

   <component type="Field::Multi">
      <title><epc:phrase ref="user_section_personal" /></title>
      <field ref="name" required="yes" />
      <field ref="lang"/> &lt;-- NEW!!! edit preferred language --&gt;
      <field ref="dept"/>
      <field ref="org"/>
      <field ref="address"/>
      <field ref="country"/>
      <field ref="url"/>
    </component>

Finally, you might want the default language appear on the user's profile pages. This needs editing the [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/cfg.d|cfg/cfg.d/user_render.pl]] file by inserting the following into the place of your choice (I coose just next to "country"):

  if( $user->is_set( "lang" ) )
  {
       $p->appendChild($session->make_element( "br" ) );
       $p->appendChild($session->html_phrase("user_preferred_language",
                 lang => $user->render_value( "lang" ) ) );
  }

here the new phrase "user_preferred_language" should be defined in one of the phrase files (see the [[#Phrases|Phrases]] section); in it the pin "lang" contains the language itself:

  &lt;epp:phrase id="user_preferred_language"&gt;Preferred language: 
       &lt; epc:pin name="lang"/&gt;
  &lt;/epp:phrase&gt;

<span style="color:red; font-weight:bold">WARNING!</span> While e-mail messages are sent out utf-8 encoded, they are not properly formatted. For non-English e-mails you must apply the "Proper utf-8 encoding for outgoing e-mails" patch from the [[#Patches|Patches]] section. Also, by default, the text version of the e-mail does not contain links. This is also corrected by this patch.