We are extremely excited to announce the first stable release of our Erdiko User Admin project! After some hard work, we have a robust backend with an attractive UI to allow you to easily manage a set of roles and users you can host yourself!
We have strived to create a modular and complete solution for managing a persistent set of user records with an attractive and extendable UI.
Project Overview
The Erdiko User Admin is an
Erdiko based application that provides a backend for, and serves, a custom AngularJS application. This Angular Application provides an attractive UX to help view and manage the user records we store in a database.
Here are some screenshots to give you a basic idea of the UX:
Login & User Authorization
Only authorized user’s can use the application, and we provide an simple (and attractive) login form allowing a user to input their user credentials.
Any user who is not logged in will be redirected to this form.
Home
This view is the “landing” page for a logged in user. It displays some links to our other features, but mainly it’s the default page for authorized users.
User List
The user list is a page that displays a sortable and paginated list of users in our database. This screen allows you to select a user to edit or delete.
Create User
This page shows a form allowing you to create new user.
Edit User
This page, actually the same code as the Create User, allows you to edit an existing user. This page will become more powerful as we add features in the future.
User Event Log
This page shows a paginated and sortable list of user events logged by the system. This page too will become more powerful as we add features and more options on the data we log as we continue to develop this project.
Erdiko User Admin Modules & Packages
In case you were interested in how this whole project works and some of the underlying code, we’ll give a brief overview of the modules that we used to create this project.
We have worked hard to make this package easily extendible and customizable. While the User Admin uses all of these packages at once, you can extend or replace many of these packages for your own uses.
If you are looking for more in depth information about these packages, or how you can use these packages in your custom project, please refer to their respective documentations.
erdiko/authenticate
The
erdiko/authenticate package provides an authentication interface that allows us to verify a user’s provided credentials and log a user in and out. We use this to make sure you are who you say you are after logging in.
We have designed this package specifically to be flexible and extendable. If you would like to customize the authorization process, or even provide your own interface to verify a user’s identity, please refer to the documentation about extending this package.
erdiko/authorize
The
erdiko/authorize package provides a role based system that allows users who have the permissions to log in and edit user records. This gives us a level of access and security for each action, and makes sure your data is safe.
erdiko/users
The
erdiko/users is a package adding Service Models and AJAX endpoints for user management in a Erdiko application or your custom application.
This package requires both the erdiko/authenticate and erdiko/authorize packages to make sure a user is ‘allowed’ to interact with user records based on a requested action.
erdiko/user-admin
The
erdiko/user-admin is a
Erdiko MVC application that we have created in order to provide routing for our erdiko/users AJAX routes and to serve the AngularJS application we use for our UX.
If you would like more information about our Erdiko project to create a powerful and minimalistic MVC application, please refer to our documentation on
Erdiko.org.
ngx-user-admin
The erdiko/ngx-user-admin package is our npm package that provides the routes, services and components we use in the AngularJS application. We have developed this in a way that will ease extension/customization as well as a focus on code re-use.
If you would like to extend some of this code for customization, please refer to our documentation.
What’s next?
We have some big plans for this project and you should expect to see in the near future:
- More user roles!
- Bulk User Editing!
- An end-user interface & User Profiles!
How can you help?
We would love to have your help in our continued development of this project. Everything from development, testing and documentation; we welcome any and all feedback.
Trying it out
We highly suggest trying out the project yourself. This is the most effective way to evaluate a new project and we would love to get some feedback on how you feel about the application.
Quick start and installation instructions can be found at our official documentation site.
Reporting Bugs / Feature Requests
This project is very much a living and evolving one! We welcome feature requests and encourage our users to report bugs.
Feel free to create feature requests or report bugs on the User Admin repo we host on GitHub.
If you have a bug or feature request specific to a package please create the issue on the respective GitHub repo.
Pull Requests
Do you know what is causing an issue or a bug? Is there a missing feature or something you have worked on that you think would help out other users who use this project? We would love to see your code!
We encourage our developer end users to create Pull Requests from their forked repositories! Please make sure you abide by our contribution guidelines detailed in our official documentation.
Thanks so much for reading, we look forward to hearing some feedback on our project!