diff --git a/user_manual/images/Thumbs.db b/user_manual/images/Thumbs.db index 5e3d50c48..d5630eb99 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 000000000..e0f77628e 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 ae5c09d6f..178d0eeb6 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 000000000..30c610afe 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 000000000..17e828a95 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 000000000..24802de2c 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 c524af8cc..ce9027551 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 000000000..f5658a7da 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 000000000..a42659e0a 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 1d05759e8..20538b554 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. - 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 `_. -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 `_. + 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 `_. -2. And for iOS (iPhone and iPad) use their app which can be found `here `_. +ownCloud provides the following alternative synchronization options: + +- For Android devices, you can use an official Android app. You can find this + app `here `_. + +- For iOS (iPhone and iPad) devices, you can use their official app. You can + find this app `here `_. Troubleshooting ---------------