[Pkg-owncloud-commits] [owncloud-doc] 209/270: Updated Contacts Doc
David Prévot
taffit at moszumanska.debian.org
Thu Jul 31 03:53:31 UTC 2014
This is an automated email from the git hooks/post-receive script.
taffit pushed a commit to branch master
in repository owncloud-doc.
commit d3da2bd12e4f8c1583a7cdb238dc2d5a33246879
Author: Mark Barnard <keyboardmidas88 at gmail.com>
Date: Tue Jul 8 11:32:14 2014 -0400
Updated Contacts Doc
---
user_manual/images/Thumbs.db | Bin 845312 -> 948736 bytes
user_manual/images/contact_address_book_add.png | Bin 0 -> 11245 bytes
user_manual/images/contact_emptycontact.png | Bin 19910 -> 21414 bytes
user_manual/images/contact_new.png | Bin 0 -> 37635 bytes
user_manual/images/contact_picture.png | Bin 0 -> 1415 bytes
user_manual/images/contact_picture_default.png | Bin 0 -> 2057 bytes
user_manual/images/contact_uploadbutton.png | Bin 4305 -> 8934 bytes
user_manual/images/contacts_empty.png | Bin 0 -> 30482 bytes
user_manual/images/contacts_settings.png | Bin 0 -> 9199 bytes
user_manual/pim/contacts.rst | 364 +++++++++++++++++-------
10 files changed, 266 insertions(+), 98 deletions(-)
diff --git a/user_manual/images/Thumbs.db b/user_manual/images/Thumbs.db
index 5e3d50c..d5630eb 100644
Binary files a/user_manual/images/Thumbs.db and b/user_manual/images/Thumbs.db differ
diff --git a/user_manual/images/contact_address_book_add.png b/user_manual/images/contact_address_book_add.png
new file mode 100644
index 0000000..e0f7762
Binary files /dev/null and b/user_manual/images/contact_address_book_add.png differ
diff --git a/user_manual/images/contact_emptycontact.png b/user_manual/images/contact_emptycontact.png
index ae5c09d..178d0ee 100644
Binary files a/user_manual/images/contact_emptycontact.png and b/user_manual/images/contact_emptycontact.png differ
diff --git a/user_manual/images/contact_new.png b/user_manual/images/contact_new.png
new file mode 100644
index 0000000..30c610a
Binary files /dev/null and b/user_manual/images/contact_new.png differ
diff --git a/user_manual/images/contact_picture.png b/user_manual/images/contact_picture.png
new file mode 100644
index 0000000..17e828a
Binary files /dev/null and b/user_manual/images/contact_picture.png differ
diff --git a/user_manual/images/contact_picture_default.png b/user_manual/images/contact_picture_default.png
new file mode 100644
index 0000000..24802de
Binary files /dev/null and b/user_manual/images/contact_picture_default.png differ
diff --git a/user_manual/images/contact_uploadbutton.png b/user_manual/images/contact_uploadbutton.png
index c524af8..ce90275 100644
Binary files a/user_manual/images/contact_uploadbutton.png and b/user_manual/images/contact_uploadbutton.png differ
diff --git a/user_manual/images/contacts_empty.png b/user_manual/images/contacts_empty.png
new file mode 100644
index 0000000..f5658a7
Binary files /dev/null and b/user_manual/images/contacts_empty.png differ
diff --git a/user_manual/images/contacts_settings.png b/user_manual/images/contacts_settings.png
new file mode 100644
index 0000000..a42659e
Binary files /dev/null and b/user_manual/images/contacts_settings.png differ
diff --git a/user_manual/pim/contacts.rst b/user_manual/pim/contacts.rst
index 1d05759..20538b5 100755
--- a/user_manual/pim/contacts.rst
+++ b/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.
+
+To import contacts using a VCF file:
+
+1. At the bottom of the Contacts app information field, locate the gear button.
+
+ .. figure:: ../images/contact_bottombar.png
- Contact settings icon
+ **Contact settings gear button**
-Once you've clicked it, an up arrow button which lets you upload files will be shown:
+2. Click the gear button. The Contacts app upload field opens.
-.. figure:: ../images/contact_uploadbutton.png
+ .. figure:: ../images/contact_uploadbutton.png
- Contact file upload icon
+ **Contacts app upload field**
-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.
+3. Choose an address book to which you want to import contacts by clicking the
+checkbox next to the address book.
-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
+4. Select one of the options from the Import pulldown menu. These options
+include the following:
-.. figure:: ../images/contact_vcfpick.jpg
+ - 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.
- Picking VCF files
+ An Upload File window opens.
+
+6. Navigate to the appropriate file on your system and select it for upload.
-After upload, the interface will automatically place your contacts into ownCloud.
+ .. 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.
-Create contacts manually
-~~~~~~~~~~~~~~~~~~~~~~~~
+ .. figure:: ../images/contact_vcfpick.jpg
+
+ **Selecting VCF files**
+
+ The interface automatically places your contacts into ownCloud.
+
+
+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:
-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.
+ - 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
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-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.
+The Contacts app enables you to edit or remove contact information.
-.. figure:: ../images/contact_emptycontact.png
+To edit contact information:
- Empty contact view
+1. Navigate to the specific contact that you want to modify.
-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.
+2. Select the information in the field that you want to edit.
-Adding picture to the contact
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+3. Make your modifications.
-There are two methods in which you can give a picture id to the specific contact
+ 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.
-.. figure:: ../images/contact_picture.jpg
+3. Click the trash bin to the right of the contact information.
- Contact picture options
+ Changes that you make to any contact information are implemented immediately.
-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
+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
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+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**
+
+To crop the image:
-You can crop the picture however you wish and then press OK.
+1. Move the image crop box to the desired location and resize the box any way
+ you like.
-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.
+2. Click ``Crop Picture`` in the crop image dialog box.
-Creating new addressbooks
---------------------------
+ The Contacts app crops the image and replaces whatever image was originally
+ used for the contact.
-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.
+Managing Address Books
+----------------------
-.. figure:: ../images/contact_del_ab.png
+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.
- Addressbook options
+.. figure:: ../images/contacts_settings.png
-There, you have the ability to add, delete, download or share your addressbooks.
-Hover your cursor on every icon to see what they mean.
+ **Contacts settings**
+The Contacts settings enables you to share, export, edit, and delete address
+books.
-Keeping your addressbook in sync
----------------------------------
+.. note:: You can hover the cursor over each icon to view a brief pop-up
+ description for each.
-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
+Adding an Address Book
+----------------------
+To add an address book:
-Syncing with Android
-~~~~~~~~~~~~~~~~~~~~
+1. Click the ``+ Add Address Book`` option in the Contacts settings field.
-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 :)
+ 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.
+
+
+Synchronizing Address Books
+---------------------------
+
+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.
+
+
+Synchronizing With 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``.
+
+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.
-Now should now find your contacts in the address book of your iPhone.
+Using Other Synchronization Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Other Syncing options provided by ownCloud
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ownCloud provides the following alternative 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/>`_.
+- 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
---------------
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git
More information about the Pkg-owncloud-commits
mailing list