Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/librecodecoop/dashboard
Administrative dashboard for VoIP system made with PHP and Laravel
https://github.com/librecodecoop/dashboard
dashboard docker docker-compose mariadb php php7 xdebug
Last synced: 2 months ago
JSON representation
Administrative dashboard for VoIP system made with PHP and Laravel
- Host: GitHub
- URL: https://github.com/librecodecoop/dashboard
- Owner: LibreCodeCoop
- License: mit
- Created: 2019-09-06T11:51:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-02T11:34:51.000Z (almost 2 years ago)
- Last Synced: 2024-11-24T20:10:07.211Z (2 months ago)
- Topics: dashboard, docker, docker-compose, mariadb, php, php7, xdebug
- Language: PHP
- Homepage:
- Size: 19.3 MB
- Stars: 3
- Watchers: 3
- Forks: 10
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Administrative dashboard
Administrative dashboard made with PHP
The first version of the dashboard will be to serve VoIP enterprise customers.
There are 2 types of users:
administrators and users associated with customers.
Users should log in to the system and view invoices and recording audios of all customers they have.
The project needs to be internationalized. Do not display any text to the user that cannot be translated.
## Instructions to getting run
Make sure port 3306 and 80 are free.
Create `.env` file from `.env.example`
Create `docker-compose.yml` file from `docker-compose-example.yml`
> PS: If you don't use internal database, remove the `db` service.
In first time run:
```bash
docker-compose up
docker-compose down
docker-compose up
```
open http://localhost
## Run in production
* Remove the `mailhog` service from `docker-compose.yml`
* Remove environment of xdebug from `docker-compose.yml`
* Remove instalation xdebug lines from `.docker/php7/Dockerfile`
## Customize
### Images
Look images in this folders and change:
* `public/image/`
* `public/material/image/`
### Assets: CSS
> NOTE: Read the concept first: https://laravel.com/docs/6.x/mix
Change the file `public/material/scss/material-dashboard/variables/_brand.scss`
using the vars from
* `public/material/scss/material-dashboard/variables/_colors.scss`
* `public/material/scss/material-dashboard/bootstrap/scss/_variables.scss`
If you want more CSS customizations, change the file `resources/sass/app.scss`
**Invoice customizations:**
* `resources/sass/invoice.scss`
After make all customizations, restart nodejs container to build assets:
```bash
docker-compose restart nodejs
```
### Translation
Define the default locale in `.env` file changing the environment `APP_LOCALE` to default app locale.
If don't exist, create a json file following instructions from https://laravel.com/docs/6.x/localization
If there is a word that is used in more than one place and it must have different translations in each place, look for that word or phrase in the project and change the word or phrase in each place to be different and apply the translation to each of the sentences. created.
> NOTE: When making a translation, please submit a pull request.
## Contributing
Read the [contributing](/CONTRIBUTING.md) file first.
Look the project [issues](/../../issues) and the [tasks](/../../projects) board