You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
floatingghost 0802dc5777
ci/woodpecker/push/woodpecker Pipeline was successful Details
use v1 urls (#15)
6 months ago
build Revert including links in moderation log messages 2 years ago
config Add ability to disable settings/reports during compile time 4 years ago
docker Update docker configuration: 3 years ago
public Add README 4 years ago
src use v1 urls (#15) 6 months ago
static Keep static dir 4 years ago
test use v1 urls (#15) 6 months ago
.babelrc Add tests 4 years ago
.dockerignore Update docker configuration: 3 years ago
.editorconfig add editorconfig 6 years ago
.eslintignore init 6 years ago
.eslintrc.js Add forms for configuring server-settings 4 years ago
.gitignore Add test coverage to gitignore 4 years ago
.gitlab-ci.yml Remove --detectOpenHandles 3 years ago
.postcssrc.js Fix display of the icons 4 years ago
.travis.yml perf[chore]:set travis notifications:false 6 years ago
.woodpecker.yml Fix asset settings not loading in Frontend 10 months ago
AGPL-3 Add README 4 years ago
CHANGELOG.md CHANGELOG.md: Release 2.4.0 2 years ago
Dockerfile Update docker configuration: 3 years ago
LICENSE fixed typo 6 years ago
README.md Add installing dependencies to readme 3 years ago
README.png Add README 4 years ago
admin-fe.iml use v1 urls (#15) 6 months ago
favicon.ico perf:change favicon 6 years ago
index.html Kill tinymce 4 years ago
package.json bump version 10 months ago
yarn.lock Add options for translation services (#10) 9 months ago

README.md

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