Updated Contacts Doc

user_manual/pim/contacts.rst

@@ -1,160 +1,328 @@
 Using the Contacts App
 ======================
 
-The contacts app of ownCloud is like any other mobile contact app but with more
-functionality.  Just as you open your account you will get the a default
-addressbook available.
-We will see later that Of course you can always add and remove addressbooks in
-here.
+The ownCloud Contacts app is similar to other mobile contact applications, but 
+with more functionality.  When you first access the Contacts app, a default 
+address book becomes available.
 
-Adding contacts
+.. figure:: ../images/contacts_empty.png
+  :scale: 75%
+
+**Contacts app (empty)**
+
+In the Apps Information field for the Contacts app, you can choose to create a
+new contact or a new group.  This field also enables you to filter your contacts
+based on grouped or ungrouped contacts.
+
+Adding Contacts
 ---------------
-There are two ways in which you can add contacts
+You can add contacts using one of the following methods:
 
-1. Add them manually
-2. Import a VCF file
+* Import contacts using a Variant Call Format (VCF) file
 
-Importing
-~~~~~~~~~
+* Add contacts manually
 
-So first we'll check out how to import all the VCF files as they are a lot
-more faster way of creating contacts.
-Just below the contact list, click on the gear button:
+Importing Contacts
+~~~~~~~~~~~~~~~~~~
 
-.. figure:: ../images/contact_bottombar.png
+The fastest way to add contacts is through the use of a Variant Call Format
+(VCF) file.
 
-   Contact settings icon
+To import contacts using a VCF file:
 
-Once you've clicked it, an up arrow button which lets you upload files will be shown:
+1. At the bottom of the Contacts app information field, locate the gear button.
 
-.. figure:: ../images/contact_uploadbutton.png
+  .. figure:: ../images/contact_bottombar.png
 
-   Contact file upload icon
+     **Contact settings gear button**
 
-After choosing an addressbook to import into, click on the arrow. The upload
-window will be opened and let you choose your files.  You can upload the files
-one by one or upload all of them at one go.
+2. Click the gear button. The Contacts app upload field opens. 
 
-Let us demonstrate.
-Open the directory in which you store all the files and then do the following
-Keep pressing CTRL and select the files to upload.
-After you are done just click on the ``Open`` button.
-After the upload it should look something like this in which all the names and
-contacts will be sorted alphabetically
+  .. figure:: ../images/contact_uploadbutton.png
 
-.. figure:: ../images/contact_vcfpick.jpg
+   **Contacts app upload field**
 
-   Picking VCF files
+3. Choose an address book to which you want to import contacts by clicking the
+checkbox next to the address book.
 
-After upload, the interface will automatically place your contacts into ownCloud.
+4. Select one of the options from the Import pulldown menu.  These options
+include the following:
+
+  - Automatic format -- Any VCF file. ownCloud determines the file format and 
+    imports accordingly (?? Is this correct?  I'm guessing here.??)
+	
+  - Gmail CSV -- The comma-separated values file from your Gmail account.
+  
+  - Outlook CSV -- The comma-separated values file from your Outlook account.
+  
+  - Thunderbird CSV -- The comma-separated values file from your Thunderbird 
+    account.
+	
+  - Yahoo CSV -- The comma-separated values file from your Yahoo account.
+  
+  - PHPLdapAdmin Idif Export -- The export record from your LDAP configuration.
+  
+  - Gmail VCard -- The VCard files from your Gmail account.
+  
+  - Standard VCard -- The VCard files from your Standard account. (??What is a
+    "Standard" VCard??)
+	
+  - Yahoo VCard  -- The VCard files from your Yahoo account.
+   
+5. Click the upload arrow to the right of the import option that you select. 
+
+  An Upload File window opens.
+  
+6. Navigate to the appropriate file on your system and select it for upload.
+
+  .. note:: You can upload files individually or, by selecting multiple files 
+    using the CTRL button and selecting them, you can upload multiple files at
+    one time.
+
+7. Once you have selected the appropriate files, click the `Open`` button.
+
+  .. figure:: ../images/contact_vcfpick.jpg
+
+    **Selecting VCF files**
+
+    The interface automatically places your contacts into ownCloud.
 
 
-Create contacts manually
+Creating Contacts Manually
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Contacts app enables you to create contacts manually.  
+
+To create a new contact:
+
+1. Click the ``+New contact`` option in the Contacts information field.
+
+   An empty new contact configuration opens in the Application View field.
+  
+  .. figure:: ../images/contact_new.png
+  
+2. Specify the new contact information as follows:
+
+  - Name -- The name of the contact.  This field provides the option of 
+    specifying added information for the user by clicking the pen button to the
+    right of the Name field.
+	
+  - Organization -- The organization for the contact.
+  
+  - Email -- The email address for the contact. This field defaults to the work
+    email address for the contact.  However, you can specify a different email 
+    designation by clicking the ``Work`` designation to the left of the email
+    field.
+	
+  - Phone -- The phone number for the contact. This field defaults to the home
+    phone number for the contact.  However, you can specify a different phone 
+    designation by clicking the ``Home`` designation to the left of the phone
+    field.
+	
+  - Address -- The address for the contact. This field defaults to the work
+    address for the contact.  However, you can specify a different address 
+    designation by clicking the ``Work`` designation to the left of the address
+    field.
+	
+  - Notes -- Any notes you want to add about the contact.
+  
+  .. note:: The Email, Phone, and Address fields provide the option of
+    specifying a contact method as "preferred."
+  
+Editing Contact Information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Contacts app enables you to edit or remove contact information.
+
+To edit contact information:
+
+1. Navigate to the specific contact that you want to modify.
+
+2. Select the information in the field that you want to edit.
+
+3. Make your modifications.
+
+  Changes that you make to any contact information are implemented immediately.
+  
+Removing Contact Information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Contacts app enables you to remove contact information.
+
+To remove contact information:
+
+1. Navigate to the specific contact that you want to modify.
+
+2. Locate the contact information field that you want to remove.
+
+3. Click the trash bin to the right of the contact information.
+
+  Changes that you make to any contact information are implemented immediately.
+
+
+Defining a Contact Avatar
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, new contacts receive a letter avatar (picture) of "U" (for "User").
+
+.. figure:: ../images/contact_picture_default.png
+
+  **Contact picture (default)**
+ 
+  When you specify the name of a contact, the avatar reflects the name by adopting
+  the first letter of the name you provide.  For example, if you were to specify 
+  the name of "Frederick," the avatar would dynamically change to "F" for that 
+  contact.  If you provide multiple contacts with the same name, or with names 
+  that start with the same first letter, the avatar uses the same letter but 
+  changes color to indicate the difference.
+ 
+.. figure:: ../images/contact_picture.png
+
+  **Contact picture (dynamic change)**
+
+Customizing an Avatar
+~~~~~~~~~~~~~~~~~~~~~
+
+In addition to dynamically altering the avatar for each contact, the Contacts 
+app enables you to customize the avatar. You can specify an avatar in one of the
+two following ways:
+
+- Upload new image -- By selecting this option, ownCloud opens a File Upload 
+  window.  You can choose a new image by navigating to the image, selecting it, 
+  and clicking ``Open``.
+  
+- Select image from Files -- By selecting this option, ownCloud opens the Files
+  app on the ownCloud server.  You can choose an image by navigating to the image
+  in the ownCloud directory, selecting it, and clicking ``Choose.``
+
+Cropping an Avatar Image
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-On the left side of contacts app, you could see the new contact button (first one).
-Click on it. You can now see an empty contact in the main part of the interface.
-You have the ability to add all your informations about the contact:
-the name, the address, the e-mail, the telephone nr, etc.
-
-Just click on a field and start typing the information.
-You can use the "Add Field" button to add another types of information for this contact.
-
-.. figure:: ../images/contact_emptycontact.png
-
-   Empty contact view
-
-When you want to remove an information of your contact, just click on little delete icon
-at the right of the field you want to remove.
-
-Adding picture to the contact
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are two methods in which you can give a picture id to the specific contact
-
-.. figure:: ../images/contact_picture.jpg
-
-   Contact picture options
-
-1) **Direct upload**
-2) **Select pics already uploaded in ownCloud files.**
-
-After you have selected the picture for the contact you get
-an option to crop the picture to suit your requirements
+After you have selected an image for your contact, the Contacts app enables you
+to crop the picture.
 
 .. figure:: ../images/contact_crop.jpg
 
-   Cropping contact picture
+   **Cropping contact image**
 
-You can crop the picture however you wish and then press OK.
+To crop the image:
 
-As you can see it is really easy to set things right in this app.
-It automatically picks up the First name, Middle name (if any) and the last name
-You may add or delete any section you want for your own convenience.
+1. Move the image crop box to the desired location and resize the box any way 
+   you like.
 
-Creating new addressbooks
---------------------------
+2. Click ``Crop Picture`` in the crop image dialog box.
 
-When you click on settings button on bottom bar,
-you will have access to the application's settings.
-Then, you will be shown all available addressbooks to access the options.
+  The Contacts app crops the image and replaces whatever image was originally 
+  used for the contact.
 
-.. figure:: ../images/contact_del_ab.png
+Managing Address Books
+----------------------
 
-   Addressbook options
+Clicking on the settings (gear) button at the bottom of the Apps Information 
+field provides access to the Contact app settings. This field shows all 
+available address books, certain options for each address book, and enables you
+to create new address books.
 
-There, you have the ability to add, delete, download or share your addressbooks.
-Hover your cursor on every icon to see what they mean.
+.. figure:: ../images/contacts_settings.png
+
+   **Contacts settings**
+
+The Contacts settings enables you to share, export, edit, and delete address 
+books.
+
+.. note:: You can hover the cursor over each icon to view a brief pop-up
+  description for each.
+
+Adding an Address Book
+----------------------
+
+To add an address book:
+
+1. Click the ``+ Add Address Book`` option in the Contacts settings field.
+
+  A field opens requesting you to enter a display name for the new address book.
+  
+  .. figure:: ../images/contact_address_book_add.png
+  
+  **Adding an address book**
+
+2. Specify a display name for the address book.
+
+3. Click the checkbox icon to create the new address book.
 
 
-Keeping your addressbook in sync
----------------------------------
+Synchronizing Address Books
+---------------------------
 
-One of the most important thing in any contact app is to keep it in Sync.
-You can sync this contact app to your phone which has the following OS's- Android and iOS
+One of the most important features in any contact application is the ability to 
+keep it in sync.  The ownCloud Contacts app enables you to sync your address
+books to external devices that use the Android or Apple iOS operating systems.
 
 
-Syncing with Android
-~~~~~~~~~~~~~~~~~~~~
+Synchronizing With Android
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-1) Install CardDAV- Sync free from Google play store by visiting `this link <https://play.google.com/store/apps/details?id=org.dmfs.carddav.sync>`_.
-2) This app supports auto- configuration which is a Boon- after installing visit this link - carddavs://example.org/remote.php/carddav/ to auto-configure the app.
-3) Enter your login details
-4) After the app has checked your login details you may just select- Sync server to phone option
-5) That's it there is nothing else to do for Android :)
+To synchronize with an Android device:
+
+1) Install CardDAV- Sync free from the Google play store by visiting `this link <https://play.google.com/store/apps/details?id=org.dmfs.carddav.sync>`_.
+   This app supports auto-configuration.
+  
+  .. note:: Following the installing, visit carddavs://example.org/remote.php/carddav/ to auto-configure the app.
+
+3) Enter your login details.
+
+4) After the app has checked your login details, select the ``Sync from server to phone only`` option.
 
 .. figure:: ../images/contact_syncopt.jpg
 
-Syncing your iOS device
-~~~~~~~~~~~~~~~~~~~~~~~
+Synchronizing With Apple iOS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Synchronizing the Address book
+To synchronize with an Apple iOS device:
 
 1. Open the settings application.
-2. Select Mail, Contacts, Calendars.
-3. Select Add Account.
-4. Select other as account type.
-5. Select Add CardDAV account.
-6. For server, type http://example.org/remote.php/carddav/principals/username
-7. Enter your user name and password.
+
+2. Select Mail > Contacts > Calendars.
+
+3. Select ``Add Account``.
+
+4. Select ``other`` as the account type.
+
+5. Select ``Add CardDAV account``.
+
+6. For ``server``, enter http://example.org/remote.php/carddav/principals/username
+
+7. Specify your username and password.
+
 8. Select Next.
-9. If your server does not support SSL, a warning will be displayed. Select Continue.
-10. If the iPhone is unable to verify the account information perform the following:
 
-* Select OK.
-* Select advanced settings.
-* Make sure Use SSL is set to OFF.
-* Change port to 80.
-* Go back to account information and hit Save.
+9. If your server does not support SSL, a warning is displayed. Select ``Continue``.
 
-Now should now find your contacts in the address book of your iPhone.
+10. If the iPhone is unable to verify the account information, perform the following:
+
+  a. Click ``OK``.
+  
+  b. Select ``advanced settings``.
+
+  c. Make sure ``Use SSL`` is set to "OFF".
+
+  d. Change the port to ``80``.
+  
+  e. Return to "account information" and click ``Save``.
+
+  Your contacts appear in the address book of your iPhone.
 
 
-Other Syncing options provided by ownCloud
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Using Other Synchronization Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-1. For Android you may use official Android app which can be found `here <https://owncloud.org/install/>`_.
-2. And for iOS (iPhone and iPad) use their app which can be found `here <https://owncloud.org/install/>`_.
+ownCloud provides the following alternative synchronization options:
+
+- For Android devices, you can use an official Android app.  You can find this
+  app `here <https://owncloud.org/install/>`_.
+  
+- For iOS (iPhone and iPad) devices, you can use their official app.  You can
+  find this app `here <https://owncloud.org/install/>`_.
 
 Troubleshooting
 ---------------