Skip to content
This repository has been archived by the owner on Mar 25, 2019. It is now read-only.

Commit

Permalink
Tidy up README.md
Browse files Browse the repository at this point in the history
- Fixed spelling.
- Added compatibility list (see #20 to why this was added).
- Changed GitLab links to GitHub.
- Fixed shields.
  • Loading branch information
Ralkage authored May 13, 2018
1 parent 26434d8 commit c69f714
Showing 1 changed file with 34 additions and 20 deletions.
54 changes: 34 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,43 @@
# Flarum User Management by ReFlar
# User Management by ReFlar

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitlab.com/ReFlar/user-management/blob/master/LICENSE) [![Latest Stable Version](https://img.shields.io/packagist/v/reflar/user-management.svg)](https://gitlab.com/ReFlar/user-management)
[![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/reflar/user-management/blob/master/LICENSE.md) [![Latest Stable Version](https://img.shields.io/packagist/v/reflar/user-management.svg)](https://packagist.org/packages/reflar/user-management) [![Total Downloads](https://img.shields.io/packagist/dt/reflar/user-management.svg)](https://packagist.org/packages/reflar/user-management)

A [Flarum](http://flarum.org) extension that allows your to manage every aspect of your users, with style!
A [Flarum](http://flarum.org) extension that allows you to manage every aspect of your users, with style!

This extension allows you to give users strikes for posts if they violate rules. Those strikes are kept and can be viewed at anytime by anyone with permission. This extension also allows your to disable the email registration option, as well as adds age and gender at registration. The user's age and gender is shown on their profile page. You can also manually activate users from the admin interface, or from the users page.
This extension allows you to give users strikes for posts if they violate rules. Those strikes are kept and can be viewed at any time by anyone with permission. This extension also allows you to disable the email registration option, as well as giving you the ability to add an age and gender field to the user registration modal. The user's age and gender is shown on their profile page. You can also manually activate users from the admin interface, or from the users page.

![gif](http://i.imgur.com/pkMM6aA.gif)


![gif](http://i.imgur.com/dfHaFwL.gif)

### Goals
## Compatibility

- To make registration more customizable
- To log user incidents
This extension might not be compatible with other extensions that make change to the sign up modal as well. If an extension is not listed below, please try it on a test forum first and let us know if it works.

### Usage
**Works With:**

- Moderators can asign strikes to posts
- Strikes can be tracked from admin page or directly from user page
- Remove email registration
- Added age and gender
- All ReFlar extensions

### Installation
**Does Not Work With:**

- [Flagrow Terms](https://github.com/flagrow/terms) (should be compatible again in future version 0.2) see [ReFlar/user-management#20](https://github.com/ReFlar/user-management/issues/20) for more details

## Goals

- To provide an easy and intuitive User Management solution.
- To make registration more customizable.
- To log user incidents.

## Usage

- User Management from the Admin CP.
- Moderators can assign strikes to posts.
- Strikes can be tracked from admin page or directly from the user page.
- Remove email registration.
- Added age and gender.

## Installation

Install it with composer:

Expand All @@ -33,25 +47,25 @@ composer require reflar/user-management

Then login and enable the extension.

### Developer Guide
## Developer Guide

You have 2 events to listen for "UserWillBeGivenStrike" as well as "UserWasGivenStike" which both contain the offending post, the user being struck, the strike issuer, and the reason.

You also have the api/strike post route to give a user a strike, /API strike/{userId} get route to get a user's strikes, and /api/strike/{id} delete route to delete the strike.

You can also post to /api/reflar/usermanagement/attributes to set a user's gender and age.

### To Do
## To Do

- Requests?

### Issues
## Issues

- None known
- Incompatibility with Flagrow's Terms extension.


### Links
## Links

- [on github](https://gitlab.com/ReFlar/user-management)
- [on github](https://github.com/ReFlar/user-management)
- [on packagist](https://packagist.org/packages/ReFlar/user-management)
- [issues](https://gitlab.com/ReFlar/user-management/issues)
- [issues](https://github.com/ReFlar/user-management/issues)

0 comments on commit c69f714

Please sign in to comment.