admin-fe/README.md
Ilja 413e0f5b7f Add installing dependencies to readme
* For both development (running locally) and building we also need to install the dependencies. I added how I did it.
2020-11-29 20:52:45 +03:00

3.6 KiB

Pleroma AdminFE

screenshot

About

Admin UI for pleroma instance owners.

Branches

There are two main branches here:

  • develop: ongoing work and all merge requests go here, unstable
  • master: after develop is stabilized it is merged to master, master is stable, allegedly

Features

  1. User administration: grant roles to users (admin/moderator), deactivate/delete as well as force their statuses to have NSFW tag, strip media and many more
  2. Invites management: generate invite tokens & send invites via email
  3. Moderation log: track moderator/admin actions
  4. Settings: configure your pleroma instance via friendly (hopefully) UI
  5. Emoji packs: configure your emoji packs

You can have any combination of these features (i.e. you can disable anything, but user administration, see "Disabling features" section below).

Usage

Bundled

AdminFE is bundled with Pleroma, i.e. you can just visit https://your.instance/pleroma/admin/ to try it out.

Development

To run AdminFE locally execute

# install dependencies
npm install -g yarn
yarn

# run AdminFE locally
yarn dev

Build

To compile everything for production run

# install dependencies
npm install -g yarn
yarn

# compile everything for production
yarn build:prod

This will build admin-fe into dist folder, which you will need to upload to your server and/or point your webserver of choice to.

Disabling features

You can disable certain AdminFE features, like reports or settings by modifying config/prod.env.js env variable DISABLED_FEATURES, e.g. if you want to compile AdminFE without "Settings" you'll need to set it to: DISABLED_FEATURES: '["settings"]'.

Features, that can be disabled:

  • reports: DISABLED_FEATURES: '["reports"]'
  • invites: DISABLED_FEATURES: '["invites"]'
  • moderation log: DISABLED_FEATURES: '["moderationLog"]'
  • settings: DISABLED_FEATURES: '["settings"]'
  • emoji packs: DISABLED_FEATURES: '["emojiPacks"]'

Of course, you can disable multiple features just by adding to the array, e.g. DISABLED_FEATURES: '["emojiPacks", "settings"]' will have both emoji packs and settings disabled.

Users administration cannot be disabled.

Changelog

Detailed changes for each release are documented in the CHANGELOG.

Browsers support

Modern browsers and Internet Explorer 10+.

IE / Edge
IE / Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
IE10, IE11, Edge last 2 versions last 2 versions last 2 versions

License

Pleroma AdminFE is build on top of the Vue Element Admin, which is licensed under MIT license.

AdminFE's own code is licensed under AGPL