git.cweiske.de
/
roundcube-nextcloud_sql_addressbook.git
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (from parent 1:
5e90878
)
Improve readme
author
Christian Weiske
<cweiske@cweiske.de>
Sat, 29 Dec 2018 17:20:43 +0000
(18:20 +0100)
committer
Christian Weiske
<cweiske@cweiske.de>
Sat, 29 Dec 2018 17:22:09 +0000
(18:22 +0100)
README.rst
patch
|
blob
|
history
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.