[IMP] eCommerce: brand new doc on payment methods + requested config changes for Paypal

general/base_import/adapt_template.rst

@@ -0,0 +1,50 @@
+===============================
+How to adapt an import template
+===============================
+
+Import templates are provided in the import tool of the most common data to
+import (contacts, products, bank statements, etc.).
+You can open them with any spreadsheets software (Microsoft Office, 
+OpenOffice, Google Drive, etc.).
+
+How to customize the file
+=========================
+
+* Remove columns you don't need. We advise to not remove the *ID* one (see
+  why here below).
+* Set a unique ID to every single record by dragging down the ID sequencing.
+
+.. image:: media/dragdown.gif
+    :align: center
+
+* When you add a new column, Odoo might not be able to map it automatically if its 
+  label doesn't fit any field of the system. 
+  If so, find the corresponding field using the search.
+
+    .. image:: media/field_list.png
+        :align: center
+
+  Then, use the label you found in your import template in order to make it work
+  straight away the very next time you try to import.
+
+Why an “ID” column
+==================
+
+The **ID** (External ID) is an unique identifier for the line item.
+Feel free to use the one of your previous software to ease the transition to Odoo.
+
+Setting an ID is not mandatory when importing but it helps in many cases:
+
+* Update imports: you can import the same file several times without creating duplicates;
+* Import relation fields (see here below).
+
+How to import relation fields
+=============================
+
+An Odoo object is always related to many other objects (e.g. a product is linked
+to product categories, attributes, vendors, etc.). To import those relations you need to
+import the records of the related object first from their own list menu.
+
+You can do it using either the name of the related record or its ID. The ID is expected when
+two records have the same name. In such a case add " / ID" at the end of the column title
+(e.g. for product attributes: Product Attributes / Attribute / ID).

general/base_import/import_faq.rst

@@ -1,30 +1,79 @@
-=======================
-Import CSV file to Odoo
-=======================
+============================
+How to import data into Odoo
+============================
+
+How to start
+------------
+You can import data on any Odoo's business object using either Excel 
+(.xlsx) or CSV (.csv) formats:
+contacts, products, bank statements, journal entries and even orders!
+
+Open the view of the object you want to populate and click *Import*.
+
+.. image:: media/import_button.gif
+    :align: center
+
+There you are provided with templates you can easily populate
+with your own data. Such templates can be imported in one click; 
+The data mapping is already done.
 
 
+How to adapt the template
+-------------------------
 
-Frequently Asked Questions
---------------------------
+* Add, remove and sort columns to fit at best your data structure.
+* We advise to not remove the **ID** one (see why in the next section).
+* Set a unique ID to every single record by dragging down the ID sequencing.
+
+.. image:: media/dragdown.gif
+    :align: center
+
+* When you add a new column, Odoo might not be able to map it automatically if its 
+  label doesn't fit any field in Odoo. Don't worry! You can map
+  new columns manually when you test the import. Search the list for the
+  corresponding field.
+
+    .. image:: media/field_list.png
+        :align: center
+
+  Then, use this field's label in your file in order to make it work
+  straight on the very next time.
 
 
-Need to import data from an other application?
-----------------------------------------------
+How to import from another application
+--------------------------------------
 
-In order to re-create relationships between different records, you should use the unique identifier from the original application and map it to the **ID** (External ID) column in Odoo. When you import an other record that links to the first one, use **XXX/ID** (XXX/External ID) to the original unique identifier.
+In order to re-create relationships between different records, 
+you should use the unique identifier from the original application 
+and map it to the **ID** (External ID) column in Odoo. 
+When you import another record that links to the first one, 
+use **XXX/ID** (XXX/External ID) to the original unique identifier.
+You can also find this record using its name but you will be stuck 
+if at least 2 records have the same name.
 
-The **ID** (External ID) will also be used to update the original import if you need to re-import modified data later, it's thus good practice to specify it whenever possible.
+The **ID** will also be used to update the original import 
+if you need to re-import modified data later, 
+it's thus good practice to specify it whenever possible.
 
 
+I cannot find the field I want to map my column to
+--------------------------------------------------
 
-I cannot find the field I want to map my column to?
----------------------------------------------------
-
-Odoo try to find with some heuristic, based on the first ten lines of the files, the type of field for each columns inside your file. For example if you have a column only containing numbers, only the fields that are of type integer will be displayed for you to choose from. While this behaviour might be good and easy for most cases scenarios, it is also possible that it goes wrong sometimes or that you want to map your column to a field that is not proposed by default.
-
-If that happens, you just have to check the **Show all fields for completion (advanced)** option, you will then be able to choose from the complete list of fields for each columns.
+Odoo tries to find with some heuristic, based on the first ten lines of 
+the files, the type of field for each column inside your file. 
+For example if you have a column only containing numbers, 
+only the fields that are of type *Integer* will be displayed for you 
+to choose from. 
+While this behavior might be good and easy for most cases, 
+it is also possible that it goes wrong or that you want to 
+map your column to a field that is not proposed by default.
 
+If that happens, you just have to check the 
+** Show fields of relation fields (advanced)** option, 
+you will then be able to choose from the complete list of fields for each column.
 
+.. image:: media/field_list.png
+  :align: center
 
 Where can I change the date import format?
 ------------------------------------------