Etherpad plugin that grants limited access to users that are not logged in via another authentication plugin such as ep_openid_connect.

When a user first visits Etherpad, they will be "authenticated" as a guest user with permissions configured by the administrator. A "log in" button in the user drop-down list forces the user to authenticate via Etherpad's built-in HTTP basic authentication or via an authentication plugin (if one is installed). After logging in, the "log in" button becomes a "log out" button.

This is a fork of ep_readonly_guest that allows admins to relax that plugin's read-only restriction.

  "requireAuthentication": true,

The following is equivalent to the above minimal example:

  "requireAuthentication": true,
  "ep_guest": {
    "username": "guest"
  },
  "users": {
    "guest": {
      "displayname": "Read-Only Guest",
      "displaynameChangeable": false,
      "readOnly": true
    }
  },

• requireAuthentication: Must be explicitly set to true to enable this plugin.
• ep_guest.username (optional, defaults to "guest"): The username used for the guest account. The corresponding object in the users setting (see below) contains settings for the guest account.
• users[ep_guest.username] (optional, default is described below): Object in users that holds settings for the guest account. Relevant properties:
  • displayname (optional): See the ep_user_displayname plugin.
  • displaynameChangeable (optional): See the ep_user_displayname plugin.
  • readOnly (optional): See Etherpad's settings.json documentation.
  • canCreate (optional): See Etherpad's settings.json documentation.

If settings.json (or another plugin) does not define a user object for the guest user, an object like the following is used:

{
  "displayname": "Read-Only Guest",
  "displaynameChangeable": false,
  "readOnly": true
}

Copyright © 2022 the ep_guest authors and contributors
Copyright © 2020–2022 the ep_reaonly_guest authors and contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.