-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
145 additions
and
145 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -23,23 +23,23 @@ | |
| ║ ║ | ||
| ╚════════════════════════════════════════════════════════════════════════════════════╝ | ||
| --> | ||
| # [![gContactOOo logo][0]][-1] Documentation | ||
| # [![gContactOOo logo][1]][2] Documentation | ||
|
|
||
| **Ce [document][1] en français.** | ||
| **Ce [document][3] en français.** | ||
|
|
||
| **The use of this software subjects you to our [Terms Of Use][2] and [Data Protection Policy][3].** | ||
| **The use of this software subjects you to our [Terms Of Use][4] and [Data Protection Policy][5].** | ||
|
|
||
| # version [1.0.3][4] | ||
| # version [1.0.3][6] | ||
|
|
||
| ## Introduction: | ||
|
|
||
| **gContactOOo** is part of a [Suite][5] of [LibreOffice][6] ~~and/or [OpenOffice][7]~~ extensions allowing to offer you innovative services in these office suites. | ||
| **gContactOOo** is part of a [Suite][7] of [LibreOffice][8] ~~and/or [OpenOffice][9]~~ extensions allowing to offer you innovative services in these office suites. | ||
| This extension gives you access, in LibreOffice, to your phone contacts (the contacts of your Android phone). | ||
|
|
||
| Being free software I encourage you: | ||
| - To duplicate its [source code][8]. | ||
| - To duplicate its [source code][10]. | ||
| - To make changes, corrections, improvements. | ||
| - To open [issue][9] if needed. | ||
| - To open [issue][11] if needed. | ||
|
|
||
| In short, to participate in the development of this extension. | ||
| Because it is together that we can make Free Software smarter. | ||
|
|
@@ -52,15 +52,15 @@ In order to take advantage of the latest versions of the Python libraries used i | |
| This means that **gContactOOo no longer supports OpenOffice and LibreOffice 6.x on Windows since version 1.0.0**. | ||
| I can only advise you **to migrate to LibreOffice 7.x**. | ||
|
|
||
| gContactOOo uses a local [HsqlDB][10] database version 2.7.2. | ||
| HsqlDB being a database written in Java, its use requires the [installation and configuration][11] in LibreOffice / OpenOffice of a **JRE version 11 or later**. | ||
| I recommend [Adoptium][12] as your Java installation source. | ||
| gContactOOo uses a local [HsqlDB][12] database version 2.7.2. | ||
| HsqlDB being a database written in Java, its use requires the [installation and configuration][13] in LibreOffice / OpenOffice of a **JRE version 11 or later**. | ||
| I recommend [Adoptium][14] as your Java installation source. | ||
|
|
||
| If you are using **LibreOffice on Linux**, you are subject to [bug 139538][13]. To work around the problem, please **uninstall the packages** with commands: | ||
| If you are using **LibreOffice on Linux**, you are subject to [bug 139538][15]. To work around the problem, please **uninstall the packages** with commands: | ||
| - `sudo apt remove libreoffice-sdbc-hsqldb` (to uninstall the libreoffice-sdbc-hsqldb package) | ||
| - `sudo apt remove libhsqldb1.8.0-java` (to uninstall the libhsqldb1.8.0-java package) | ||
|
|
||
| If you still want to use the Embedded HsqlDB functionality provided by LibreOffice, then install the [HyperSQLOOo][14] extension. | ||
| If you still want to use the Embedded HsqlDB functionality provided by LibreOffice, then install the [HyperSQLOOo][16] extension. | ||
|
|
||
| ___ | ||
|
|
||
|
|
@@ -69,15 +69,15 @@ ___ | |
| It seems important that the file was not renamed when it was downloaded. | ||
| If necessary, rename it before installing it. | ||
|
|
||
| - [![OAuth2OOo logo][15]][16] Install **[OAuth2OOo.oxt][17]** extension [![Version][18]][17] | ||
| - [![OAuth2OOo logo][17]][18] Install **[OAuth2OOo.oxt][19]** extension [![Version][20]][19] | ||
|
|
||
| You must install this extension, if it is not already installed. | ||
|
|
||
| - [![jdbcDriverOOo logo][19]][20] Install **[jdbcDriverOOo.oxt][21]** extension [![Version][22]][21] | ||
| - [![jdbcDriverOOo logo][21]][22] Install **[jdbcDriverOOo.oxt][23]** extension [![Version][24]][23] | ||
|
|
||
| You must install this extension, if it is not already installed. | ||
|
|
||
| - ![gContactOOo logo][23] Install **[gContactOOo.oxt][24]** extension [![Version][25]][24] | ||
| - ![gContactOOo logo][25] Install **[gContactOOo.oxt][26]** extension [![Version][27]][26] | ||
|
|
||
| Restart LibreOffice / OpenOffice after installation. | ||
|
|
||
|
|
@@ -87,20 +87,20 @@ ___ | |
|
|
||
| In LibreOffice / OpenOffice go to: **File -> Wizards -> Address Data Source...** | ||
|
|
||
| ![gContactOOo screenshot 1][26] | ||
| ![gContactOOo screenshot 1][28] | ||
|
|
||
| The **Address Book Datasource Wizard** open. | ||
|
|
||
| In step: **1.Address Book Type**: | ||
| - Select: **Other external data source**. | ||
| - Click button: **Next**. | ||
|
|
||
| ![gContactOOo screenshot 2][27] | ||
| ![gContactOOo screenshot 2][29] | ||
|
|
||
| In step: **2.Connection Settings**: | ||
| - Click button: **Settings**. | ||
|
|
||
| ![gContactOOo screenshot 3][28] | ||
| ![gContactOOo screenshot 3][30] | ||
|
|
||
| A new wizard opens. **Data source properties**. | ||
|
|
||
|
|
@@ -109,22 +109,22 @@ In Database type list: | |
| - Select: **Google Contacts**. | ||
| - Click button: **Next**. | ||
|
|
||
| ![gContactOOo screenshot 4][29] | ||
| ![gContactOOo screenshot 4][31] | ||
|
|
||
| In step: **2.Connection Settings**. | ||
| In General: Enter the DBMS/driver-specific connection string here. | ||
| - Put your Google account (ie: [email protected]) | ||
| - Click button: **Test connection**. | ||
|
|
||
| ![gContactOOo screenshot 5][30] | ||
| ![gContactOOo screenshot 5][32] | ||
|
|
||
| After authorizing the [OAuth2OOo][16] application to access your Contacts, normally you should see: Connection Test: The connection was established successfully. | ||
| After authorizing the [OAuth2OOo][18] application to access your Contacts, normally you should see: Connection Test: The connection was established successfully. | ||
|
|
||
| ![gContactOOo screenshot 6][31] | ||
| ![gContactOOo screenshot 6][33] | ||
|
|
||
| If the connection has been established, you can complete this wizard with the **Finish** button. | ||
|
|
||
| ![gContactOOo screenshot 7][32] | ||
| ![gContactOOo screenshot 7][34] | ||
|
|
||
| In step: **3.Table Selection**. | ||
| If your data source has multiple tables, you will be asked to select the primary table. | ||
|
|
@@ -134,7 +134,7 @@ In step: **4.Field Assignment**. | |
| If necessary it is possible to rename the names of the columns of the data source using the button: **Field Assignment**. | ||
| Please continue this wizard with the button: **Next**. | ||
|
|
||
| ![gContactOOo screenshot 8][33] | ||
| ![gContactOOo screenshot 8][35] | ||
|
|
||
| In step: **5.Data Source Title**. | ||
|
|
||
|
|
@@ -146,7 +146,7 @@ This odb file must also be made accessible. To do this you must: | |
| - **Check the box**: Make this address book available to all modules in LibreOffice | ||
| - Named the address book in the field: **Address book name**. | ||
|
|
||
| ![gContactOOo screenshot 9][34] | ||
| ![gContactOOo screenshot 9][36] | ||
|
|
||
| Have fun... | ||
|
|
||
|
|
@@ -160,10 +160,10 @@ ___ | |
|
|
||
| * LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 - Adoptium JDK Hotspot 11.0.17 (x64) (under Lubuntu 22.04 / VirtualBox 6.1.38) | ||
|
|
||
| * **Does not work with OpenOffice on Windows** see [bug 128569][32]. Having no solution, I encourage you to install **LibreOffice**. | ||
| * **Does not work with OpenOffice on Windows** see [bug 128569][37]. Having no solution, I encourage you to install **LibreOffice**. | ||
|
|
||
| I encourage you in case of problem :confused: | ||
| to create an [issue][9] | ||
| to create an [issue][11] | ||
| I will try to solve it :smile: | ||
|
|
||
| ___ | ||
|
|
@@ -174,19 +174,19 @@ ___ | |
|
|
||
| This extension was written in order to make usable in free software (LibreOffice or OpenOffice) your personal data (your address book) stored in your Android phone. | ||
|
|
||
| With the [eMailerOOo][33] extension, it can be the data source for [mail merge][34] by email, to your correspondents contained in your phone. | ||
| With the [eMailerOOo][38] extension, it can be the data source for [mail merge][39] by email, to your correspondents contained in your phone. | ||
|
|
||
| It will give you access to an information system that only larges companies are able, today, to implement. | ||
|
|
||
| ### What has been done for version 0.0.5: | ||
|
|
||
| - Integration and use of the new Hsqldb v2.5.1. | ||
|
|
||
| - Writing of a new [Replicator][35] interface, launched in the background (python Thread) responsible for: | ||
| - Writing of a new [Replicator][40] interface, launched in the background (python Thread) responsible for: | ||
|
|
||
| - Perform the necessary procedures when creating a new user (initial Pull). | ||
|
|
||
| - Writing of a new [DataBase][36] interface, responsible for making all calls to the database. | ||
| - Writing of a new [DataBase][41] interface, responsible for making all calls to the database. | ||
|
|
||
| - Many other fix... | ||
|
|
||
|
|
@@ -196,9 +196,9 @@ It will give you access to an information system that only larges companies are | |
|
|
||
| - Driver is now registred for a new protocol: **sdbc:address:google:your_account@gmail.com** | ||
|
|
||
| - The [jdbcDriverOOo][20] extension now provides the driver needed to access the HsqlDB database used by gContactOOo. | ||
| - The [jdbcDriverOOo][22] extension now provides the driver needed to access the HsqlDB database used by gContactOOo. | ||
|
|
||
| - Modifying the [Replicator][35] in order to: | ||
| - Modifying the [Replicator][40] in order to: | ||
|
|
||
| - Open and close the database at each replication. | ||
| - Go on hold after the last closing of the address book. | ||
|
|
@@ -230,44 +230,44 @@ It will give you access to an information system that only larges companies are | |
|
|
||
| - Anything welcome... | ||
|
|
||
| [0]: </img/contact.svg#collapse> | ||
| [-1]: <https://prrvchr.github.io/gContactOOo/> | ||
| [1]: <https://prrvchr.github.io/gContactOOo/README_fr> | ||
| [2]: <https://prrvchr.github.io/gContactOOo/source/gContactOOo/registration/TermsOfUse_en> | ||
| [3]: <https://prrvchr.github.io/gContactOOo/source/gContactOOo/registration/PrivacyPolicy_en> | ||
| [4]: <https://prrvchr.github.io/gContactOOo#historical> | ||
| [5]: <https://prrvchr.github.io/> | ||
| [6]: <https://www.libreoffice.org/download/download/> | ||
| [7]: <https://www.openoffice.org/download/index.html> | ||
| [8]: <https://github.com/prrvchr/gContactOOo> | ||
| [9]: <https://github.com/prrvchr/gContactOOo/issues/new> | ||
| [10]: <http://hsqldb.org/> | ||
| [11]: <https://wiki.documentfoundation.org/Documentation/HowTo/Install_the_correct_JRE_-_LibreOffice_on_Windows_10> | ||
| [12]: <https://adoptium.net/releases.html?variant=openjdk11> | ||
| [13]: <https://bugs.documentfoundation.org/show_bug.cgi?id=139538> | ||
| [14]: <https://prrvchr.github.io/HyperSQLOOo/> | ||
| [15]: <https://prrvchr.github.io/OAuth2OOo/img/OAuth2OOo.svg#middle> | ||
| [16]: <https://prrvchr.github.io/OAuth2OOo> | ||
| [17]: <https://github.com/prrvchr/OAuth2OOo/releases/latest/download/OAuth2OOo.oxt> | ||
| [18]: <https://img.shields.io/github/v/tag/prrvchr/OAuth2OOo?label=latest#right> | ||
| [19]: <https://prrvchr.github.io/jdbcDriverOOo/img/jdbcDriverOOo.svg#middle> | ||
| [20]: <https://prrvchr.github.io/jdbcDriverOOo/> | ||
| [21]: <https://github.com/prrvchr/jdbcDriverOOo/releases/latest/download/jdbcDriverOOo.oxt> | ||
| [22]: <https://img.shields.io/github/v/tag/prrvchr/jdbcDriverOOo?label=latest#right> | ||
| [23]: <img/gContactOOo.svg#middle> | ||
| [24]: <https://github.com/prrvchr/gContactOOo/releases/latest/download/gContactOOo.oxt> | ||
| [25]: <https://img.shields.io/github/downloads/prrvchr/gContactOOo/latest/total?label=v1.0.3#right> | ||
| [26]: <img/gContactOOo-1.png> | ||
| [27]: <img/gContactOOo-2.png> | ||
| [28]: <img/gContactOOo-3.png> | ||
| [29]: <img/gContactOOo-4.png> | ||
| [30]: <img/gContactOOo-5.png> | ||
| [31]: <img/gContactOOo-6.png> | ||
| [32]: <img/gContactOOo-7.png> | ||
| [33]: <img/gContactOOo-8.png> | ||
| [34]: <img/gContactOOo-9.png> | ||
| [35]: <https://bz.apache.org/ooo/show_bug.cgi?id=128569> | ||
| [36]: <https://prrvchr.github.io/eMailerOOo> | ||
| [37]: <https://en.wikipedia.org/wiki/Mail_merge> | ||
| [38]: <https://github.com/prrvchr/gContactOOo/blob/master/uno/lib/uno/addressbook/replicator.py> | ||
| [39]: <https://github.com/prrvchr/gContactOOo/blob/master/uno/lib/uno/addressbook/database.py> | ||
| [1]: </img/contact.svg#collapse> | ||
| [2]: <https://prrvchr.github.io/gContactOOo/> | ||
| [3]: <https://prrvchr.github.io/gContactOOo/README_fr> | ||
| [4]: <https://prrvchr.github.io/gContactOOo/source/gContactOOo/registration/TermsOfUse_en> | ||
| [5]: <https://prrvchr.github.io/gContactOOo/source/gContactOOo/registration/PrivacyPolicy_en> | ||
| [6]: <https://prrvchr.github.io/gContactOOo#historical> | ||
| [7]: <https://prrvchr.github.io/> | ||
| [8]: <https://www.libreoffice.org/download/download/> | ||
| [9]: <https://www.openoffice.org/download/index.html> | ||
| [10]: <https://github.com/prrvchr/gContactOOo> | ||
| [11]: <https://github.com/prrvchr/gContactOOo/issues/new> | ||
| [12]: <http://hsqldb.org/> | ||
| [13]: <https://wiki.documentfoundation.org/Documentation/HowTo/Install_the_correct_JRE_-_LibreOffice_on_Windows_10> | ||
| [14]: <https://adoptium.net/releases.html?variant=openjdk11> | ||
| [15]: <https://bugs.documentfoundation.org/show_bug.cgi?id=139538> | ||
| [16]: <https://prrvchr.github.io/HyperSQLOOo/> | ||
| [17]: <https://prrvchr.github.io/OAuth2OOo/img/OAuth2OOo.svg#middle> | ||
| [18]: <https://prrvchr.github.io/OAuth2OOo> | ||
| [19]: <https://github.com/prrvchr/OAuth2OOo/releases/latest/download/OAuth2OOo.oxt> | ||
| [20]: <https://img.shields.io/github/v/tag/prrvchr/OAuth2OOo?label=latest#right> | ||
| [21]: <https://prrvchr.github.io/jdbcDriverOOo/img/jdbcDriverOOo.svg#middle> | ||
| [22]: <https://prrvchr.github.io/jdbcDriverOOo/> | ||
| [23]: <https://github.com/prrvchr/jdbcDriverOOo/releases/latest/download/jdbcDriverOOo.oxt> | ||
| [24]: <https://img.shields.io/github/v/tag/prrvchr/jdbcDriverOOo?label=latest#right> | ||
| [25]: <img/gContactOOo.svg#middle> | ||
| [26]: <https://github.com/prrvchr/gContactOOo/releases/latest/download/gContactOOo.oxt> | ||
| [27]: <https://img.shields.io/github/downloads/prrvchr/gContactOOo/latest/total?label=v1.0.3#right> | ||
| [28]: <img/gContactOOo-1.png> | ||
| [29]: <img/gContactOOo-2.png> | ||
| [30]: <img/gContactOOo-3.png> | ||
| [31]: <img/gContactOOo-4.png> | ||
| [32]: <img/gContactOOo-5.png> | ||
| [33]: <img/gContactOOo-6.png> | ||
| [34]: <img/gContactOOo-7.png> | ||
| [35]: <img/gContactOOo-8.png> | ||
| [36]: <img/gContactOOo-9.png> | ||
| [37]: <https://bz.apache.org/ooo/show_bug.cgi?id=128569> | ||
| [38]: <https://prrvchr.github.io/eMailerOOo> | ||
| [39]: <https://en.wikipedia.org/wiki/Mail_merge> | ||
| [40]: <https://github.com/prrvchr/gContactOOo/blob/master/uno/lib/uno/addressbook/replicator.py> | ||
| [41]: <https://github.com/prrvchr/gContactOOo/blob/master/uno/lib/uno/addressbook/database.py> | ||
Oops, something went wrong.