From cf1cbbd59094ea386d509c270a73c6a5bd825e84 Mon Sep 17 00:00:00 2001
From: Valentin Deniaud <vdeniaud@entrouvert.com>
Date: Thu, 9 Apr 2020 18:36:23 +0200
Subject: [PATCH] csv_import: document @registration email option (#41292)

---
 .../authentic2/manager/user_imports.html         | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/authentic2/manager/templates/authentic2/manager/user_imports.html b/src/authentic2/manager/templates/authentic2/manager/user_imports.html
index 530ba375..bbdecabd 100644
--- a/src/authentic2/manager/templates/authentic2/manager/user_imports.html
+++ b/src/authentic2/manager/templates/authentic2/manager/user_imports.html
@@ -207,6 +207,13 @@
         </tr>
       </tbody>
     </table>
+    <h4 id="help-external-identifier">{% trans "Registration options" %}</h4>
+    <p>
+      {% blocktrans trimmed %}
+      When a user is first created, an email can be sent so they can set their password by using the
+      special column <var>@registration</var> with the value <var>send-email</var>.
+      {% endblocktrans %}
+    </p>
     <h4>{% trans "Examples" %}</h4>
     <p>{% blocktrans trimmed %}Importing first and last name of users keyed by email{% endblocktrans %}</p>
     <blockquote>
@@ -232,6 +239,15 @@ app1,1,john.doe@example.com,1234,John,Doe
       <pre>email key,first_name,last_name,_role_name
 john.doe@example.com,John,Doe,Role1
 john.doe@example.com,John,Doe,Role2
+</pre>
+    </blockquote>
+    <p>{% blocktrans trimmed %}Importing email, first and last name of users
+    and sending a password reset email to John (only if the account is created
+    by the import).{% endblocktrans %}</p>
+    <blockquote>
+      <pre>email key,first_name,last_name,@registration
+john.doe@example.com,John,Doe,send-email
+jane.doe@example.com,Jane,Doe,
 </pre>
     </blockquote>
   </div>
-- 
2.20.1