ep_frontend_community

    0.0.1 • Public • Published

    Etherpad Plugin ep_frontend_community

    User-Management System for etherpad-lite

    This plugin is based mainly on the code of the plugin ep_user_pad_frontend published at https://github.com/aoberegg/ep_user_pad_frontend.

    In differenz to the named above plugin, neither public registration nor public pads are allowed. All users need to login.

    There are three types of users:

    • pad system administrators
    • group owners
    • normal users

    Pad system adminitrators are able to assign new users to the pad system, create (private) groups, and manage users and groups. Group owners are allowed to assigne existing users to to their groups. Normal users are allowed to create pads in their groups and also edit all existing pads of their groups.

    Download

    https://github.com/ckubu/ep_frontend_community/archive/master.zip

    Install

    • Create needed mysql tables and an initial user (PAD System Administrator)
    CREATE TABLE `GroupPads` (
      `UserID` int(11) DEFAULT '1',
      `GroupID` int(11) NOT NULL,
      `PadName` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL,
      PRIMARY KEY (`GroupID`,`PadName`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    
    
    CREATE TABLE `Groups` (
      `groupID` int(11) NOT NULL AUTO_INCREMENT,
      `name` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL DEFAULT '',
      PRIMARY KEY (`groupID`,`name`)
    ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
    
    
    CREATE TABLE `NotRegisteredUsersGroups` (
      `email` varchar(255) NOT NULL,
      `groupID` int(11) NOT NULL
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    
    
    CREATE TABLE `User` (
      `userID` int(11) NOT NULL AUTO_INCREMENT,
      `name` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin NOT NULL DEFAULT '',
      `pwd` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL,
      `considered` tinyint(11) DEFAULT NULL,
      `SSO` tinyint(4) DEFAULT NULL,
      `FullName` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL,
      `considerationString` varchar(50) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL,
      `salt` varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL,
      `active` int(1) DEFAULT NULL,
      `isAdmin` int(1) NOT NULL DEFAULT '0',
      PRIMARY KEY (`userID`,`name`)
    ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
    
    
    CREATE TABLE `UserGroup` (
      `userID` int(11) NOT NULL DEFAULT '0',
      `groupID` int(11) NOT NULL DEFAULT '0',
      `Role` int(11) DEFAULT NULL,
      PRIMARY KEY (`userID`,`groupID`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    
    
    --  Initial User - Pad System Administrator
    --
    --    User: admin@example.com - Password: admin
    --
    INSERT INTO `User` 
       VALUES (
          1,'admin@example.com',
          '53e8f649c9bfbccf8f8e2b588d05de8ce26f26228a9cc9340cdc8c5f9b1a0d1e',
          1,0,'Pad System Adminstrator',
          'fGREpQX1cwnUqv3fsqHPkjP3WtlG1ZsXFFx6v0mR','EYEcciC6Nk',1,0
    );
    
    • Download from git repository into folder "node_modules" of your etherpad-lite installation.
    # as user of your "etherpad-lite" installation do:
    git clone https://github.com/ckubu/ep_frontend_community.git
    
    • Install Plugin
    cd ep_frontend_community
    
    # as user of your "etherpad-lite" installation do:
    npm install
    
    # Restart etherpad-lite (i.e debian installation: as root user do:)
    service etherpad-lite restart
    
    • Adjust email.json to your needs
    • Maybe you want replace static/images/logo.png with your logo

    Now you can login with credentials:

       username......: admin@example.com
       password......: admin
    

    Create a Plugin

    See https://github.com/Pita/etherpad-lite/wiki/Creating-a-plugin [Step 5 Install plugin])

    Install

    npm i ep_frontend_community

    DownloadsWeekly Downloads

    2

    Version

    0.0.1

    License

    GPLv3

    Last publish

    Collaborators

    • ckubu