Improve readme

diff --git a/README.rst b/README.rst
index 1f0b42b040fc03fd3d008e873135ec1535bdf9d6..6c687c6266ab675ba1a07293896585fe6e672014 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -4,7 +4,7 @@ NextCloud SQL address book plugin for Roundcube
 
 Roundcube__ plugin that allows access to NextCloud__ address books.
 Uses direct database access (SQL), which is much faster than accessing the
 
 Roundcube__ plugin that allows access to NextCloud__ address books.
 Uses direct database access (SQL), which is much faster than accessing the

-address book entries via CardDAV__.
+address book entries via the `CardDAV plugin`__.

 
 __ https://roundcube.net/
 __ https://nextcloud.com/
 
 __ https://roundcube.net/
 __ https://nextcloud.com/


@@ -26,13 +26,31 @@ Missing features
 
 Prerequisites
 =============
 
 Prerequisites
 =============

-- Read-only SQL database access from Roundcube to the NextCloud database
+- Read-only SQL database access from Roundcube to the NextCloud database.
+  Read access to the following tables needed:
+
+  - ``oc_addressbooks``
+  - ``oc_cards_properties``

 - Roundcube user login e-mail addresses must equal the username in NextCloud
   (Users log in with `alice@example.org` in both Roundcube and NextCloud)
 
 
 - Roundcube user login e-mail addresses must equal the username in NextCloud
   (Users log in with `alice@example.org` in both Roundcube and NextCloud)
 
 

+Installation
+============
+#. Clone the git repository into the roundcube ``plugins/`` directory as
+   ``nextcloud_sql_addressbook``.
+#. Copy ``config.inc.php.dist`` to ``config.inc.php`` and adjust it:
+
+   #. Database connection
+   #. Table prefix (defaults to ``oc_``)
+#. Enable the plugin in roundcube's ``config/config.inc.php`` file by
+   adding it to the ``$config['plugins']`` array.
+
+

 Debugging
 =========
 If you do not see any address books:
 The address books are only found if the ``principaluri`` in the ``oc_addressbooks``
 table equals ``principals/users/`` + ``$useremailaddress``.
 Debugging
 =========
 If you do not see any address books:
 The address books are only found if the ``principaluri`` in the ``oc_addressbooks``
 table equals ``principals/users/`` + ``$useremailaddress``.

+
+If you do not see all contacts: Only contacts with an e-mail address are shown.