Differences

This shows you the differences between two versions of the page.

--- plugin:authgooglesheets [2022-04-28 14:06] – created annda
+++ plugin:authgooglesheets [2022-05-16 21:01] – [Configuration] annda
@@ Line 33: / Line 33: @@
 ===== Configuration =====
-You need to set up a service account that will be used by DokuWiki to access the Google Sheets API.
+You need to set up a **service account** that will be used by DokuWiki to access the Google Sheets API.
   * Go to https://console.cloud.google.com/apis/
   * Select an existing project at the top or create a new one
-  * Go to "Enabled APIS and services" and make sure Google Sheets API is enabled
+  * Go to "Enabled APIS and services" and make sure Google Sheets API is enabled. No other services are required.
   * Then go to "Credentials" and create a service account
     * In the "Keys" tab of your new service account create a new key of the type JSON.
-    * Your browser will automatically download the key. Store it in a secure location and place a copy named ''authgooglesheets_credentials.json'' in the conf/ directory of your wiki.
+    * Your browser will automatically download the key. Store it in a secure location and place a copy named ''authgooglesheets_credentials.json'' in the conf/ directory of your wiki. :!: If you have a [[:farms|farm setup]], you will need to put the file in your animal's conf/ directory, not the farmer's.
-Prepare the spreadsheet that will store the users.
+Prepare the **spreadsheet** that will store the users.
-  * Create a new document and save its ID in the plugin configuration. You will find the ID in the URL, for example  https://docs.google.com/spreadsheets/d/**111111111111111111111111111111111**/edit#gid=0
+  * Create a new document and save its ''sheetId'' in the plugin configuration. You will find the ID in the URL, for example  https://docs.google.com/spreadsheets/d/**111111111111111111111111111111111**/edit#gid=0
-  * The **first** sheet will contain users. Name it ''DokuWikiAuth''. If you prefer something else, change the name in the plugin configuration as well!
+  * The sheet/table/tab that contains users is addressed by name **and** by ID.
+    * Name it ''DokuWikiAuth''. If you prefer something else, change the ''sheetName'' in the plugin configuration as well!
+    * Set the ''sheetGid'' to the ''gid'' parameter you find it the URL.
   * Create a header row with at least the required column names:
     * user