From f0d0cc00ed8ac33db5e820c81efacd69f5bf74cb Mon Sep 17 00:00:00 2001
From: M66B <M66B@users.noreply.github.com>
Date: Sun, 15 Aug 2021 13:26:34 +0200
Subject: [PATCH] Added FAQ about importing contacts

---
 FAQ.md                                        | 22 +++++++++++++++++++
 .../java/eu/faircode/email/FragmentSetup.java | 10 +++++++++
 app/src/main/res/layout/fragment_setup.xml    | 14 ++++++++++++
 app/src/main/res/values/strings.xml           |  1 +
 4 files changed, 47 insertions(+)

diff --git a/FAQ.md b/FAQ.md
index 7be80940d1..589515f53f 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -307,6 +307,7 @@ Fonts, sizes, colors, etc should be material design whenever possible.
 * [(169) Why does the app not start automatically?](#user-content-faq169)
 * [(170) Why can't folders be created with POP3?](#user-content-faq170)
 * [(171) How can I delete a contact?](#user-content-faq171)
+* [(172) How can I import contacts?](#user-content-faq172)
 
 [I have another question.](#user-content-get-support)
 
@@ -3831,6 +3832,27 @@ When a contact is store in the local contact database, you can delete it like th
 
 <br />
 
+<a name="faq172"></a>
+**(172) How can I import contacts?**
+
+FairEmail consults the Android address book and a local contact database for contact information.
+
+The local contact database is filled with contacts from sent and received messages.
+You can enable/disable this in the send settings of the app.
+
+The Android address book is managed by the Android Contacts app (or a replacement for this app).
+Please see [this article] about importing contacts to the Android address book.
+
+Related questions:
+
+* [What are local contacts for?](#user-content-faq84)
+* [Why can I still pick contacts after revoking contacts permissions?](#user-content-faq98)
+* [Can you add calendar/contact/tasks/notes management?](#user-content-faq138)
+* [How can I insert a contact group?](#user-content-faq152)
+* [How can I delete a contact?](#user-content-faq171)
+
+<br />
+
 <h2><a name="get-support"></a>Get support</h2>
 
 FairEmail is supported on Android smartphones and tablets and ChromeOS only.
diff --git a/app/src/main/java/eu/faircode/email/FragmentSetup.java b/app/src/main/java/eu/faircode/email/FragmentSetup.java
index cb37d8cb3e..6f858a3240 100644
--- a/app/src/main/java/eu/faircode/email/FragmentSetup.java
+++ b/app/src/main/java/eu/faircode/email/FragmentSetup.java
@@ -85,6 +85,7 @@ public class FragmentSetup extends FragmentBase {
 
     private TextView tvPermissionsDone;
     private Button btnPermissions;
+    private TextView tvImportContacts;
 
     private TextView tvDozeDone;
     private Button btnDoze;
@@ -146,6 +147,7 @@ public class FragmentSetup extends FragmentBase {
 
         tvPermissionsDone = view.findViewById(R.id.tvPermissionsDone);
         btnPermissions = view.findViewById(R.id.btnPermissions);
+        tvImportContacts = view.findViewById(R.id.tvImportContacts);
 
         tvDozeDone = view.findViewById(R.id.tvDozeDone);
         btnDoze = view.findViewById(R.id.btnDoze);
@@ -407,6 +409,14 @@ public class FragmentSetup extends FragmentBase {
             }
         });
 
+        tvImportContacts.setPaintFlags(tvImportContacts.getPaintFlags() | Paint.UNDERLINE_TEXT_FLAG);
+        tvImportContacts.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                Helper.viewFAQ(v.getContext(), 172, true);
+            }
+        });
+
         btnDoze.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
diff --git a/app/src/main/res/layout/fragment_setup.xml b/app/src/main/res/layout/fragment_setup.xml
index c542ecbd57..baecf01825 100644
--- a/app/src/main/res/layout/fragment_setup.xml
+++ b/app/src/main/res/layout/fragment_setup.xml
@@ -574,6 +574,20 @@
                     android:text="@string/title_setup_grant"
                     app:layout_constraintEnd_toEndOf="parent"
                     app:layout_constraintTop_toBottomOf="@id/tvPermissions" />
+
+                <eu.faircode.email.FixedTextView
+                    android:id="@+id/tvImportContacts"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="6dp"
+                    android:drawableEnd="@drawable/twotone_open_in_new_12"
+                    android:drawablePadding="6dp"
+                    android:drawableTint="?android:attr/textColorLink"
+                    android:text="@string/title_setup_permission_import_contacts"
+                    android:textAppearance="@style/TextAppearance.AppCompat.Small"
+                    android:textColor="?android:attr/textColorLink"
+                    app:layout_constraintStart_toStartOf="parent"
+                    app:layout_constraintTop_toBottomOf="@id/btnPermissions" />
             </androidx.constraintlayout.widget.ConstraintLayout>
         </androidx.cardview.widget.CardView>
 
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 2a814bdf78..db45a55b3d 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -214,6 +214,7 @@
     <string name="title_setup_permissions">Grant permissions</string>
     <string name="title_setup_permissions_remark">To access contact information (optional)</string>
     <string name="title_setup_permissions_explanation">Contact permissions are required to look up contact info and to suggest contacts</string>
+    <string name="title_setup_permission_import_contacts">How can I import contacts?</string>
     <string name="title_setup_doze">Disable battery optimizations</string>
     <string name="title_setup_doze_remark">To reliably send and receive email</string>
     <string name="title_setup_doze_explanation">Battery optimizations should be disabled for the app to ensure reliable sending and receiving of messages in the background</string>