https://github.com/bedita/manager
BEdita Manager - BEdita API manager webapp
https://github.com/bedita/manager
admin api-client bedita manager rest webapp
Last synced: 2 months ago
JSON representation
BEdita Manager - BEdita API manager webapp
- Host: GitHub
- URL: https://github.com/bedita/manager
- Owner: bedita
- License: other
- Created: 2018-01-11T08:57:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-07-22T12:02:10.000Z (11 months ago)
- Last Synced: 2025-07-22T14:16:03.446Z (11 months ago)
- Topics: admin, api-client, bedita, manager, rest, webapp
- Language: PHP
- Homepage:
- Size: 16.3 MB
- Stars: 12
- Watchers: 7
- Forks: 11
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: COPYING
Awesome Lists containing this project
README
# BEdita Manager
[](https://github.com/bedita/manager/actions?query=workflow%3Aphp)
[](https://github.com/bedita/manager/actions?query=workflow%3Ajavascript)
[](https://codecov.io/gh/bedita/manager)
[](https://phpstan.org)
[](https://psalm.dev)
[](https://scrutinizer-ci.com/g/bedita/manager/)
[](https://packagist.org/packages/bedita/manager)
[](https://github.com/bedita/manager/blob/master/LICENSE.LGPL)
Backend Manager for [BEdita API](https://gihub.com/bedita/bedita).
## Prerequisites
* [PHP](https://www.php.net/) >= 8.3
* [Composer](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx)
* [Node](https://nodejs.org) >= 20
* [Yarn](https://yarnpkg.com) >= 1.15
## Install
* Create project via `composer`
```bash
composer create-project bedita/manager
```
This will create a new `manager` folder and install composer dependencies.
If you are using a **.zip** or **.tar.gz** release file you just need to unpack it and then run ``composer install``. Run same command if you do a `git clone` on this repo.
* Build JS/CSS bundles with `yarn` from `manager` folder
```bash
yarn && yarn build
```
* Configure BEdita API base URL and API KEY in `config/.env` like:
```bash
# set BEDITA base URL
export BEDITA_API="{bedita-url}"
# set BEDITA API KEY (optional)
export BEDITA_API_KEY="{bedita-api-key}"
```
To test the webapp you can simply run builtin webserver from `manager` folder like this
```bash
bin/cake server
```
And then point your browser to `http://localhost:8765/`
For any other use than a simple test we recommend to configure your preferred web server like Nginx/Apache and point to `webroot/` as vhost document root.
##Â Configuration
You can further configure your BEdita Manager instance in `config/app_local.php` with environment and project specific settings.
Have look at the main [Manager configuration wiki page](https://github.com/bedita/manager/wiki/Manager-App-Configuration) on how to customize your Manager instance.
## JS Development with webpack
### Using .env
It's easy to configure `config/.env` to match your web server and proxy requirements, see below.
(default proxy: localhost:8080, default server: localhost:3000)
```env
# BE Manager Entry Point
WEBPACK_SERVER_HOST=localhost
WEBPACK_SERVER_PORT=3000
# Proxy server
WEBPACK_PROXY_HOST=local-be4-web
WEBPACK_PROXY_PORT=8080
```
To start develop mode run
```bash
yarn develop
```
### Production build with Bundle Report
```bash
yarn run bundle-report
```
### ESlint
* Run ESlint via `yarn`, to check linting on js files
```bash
yarn run eslint resources/js/app/pages/admin/index.js
```
## Run unit tests
To setup tests locally simply copy `tests/.env.example` to `tests/.env` and set env vars accordingly.
To launch tests:
```bash
vendors/bin/phpunit [test folder or file, default '/tests']
```
To run those tests you may want to use a Docker image as BEdita4 API endpoint.
For instance if you can pull a Docker image via ```docker pull bedita/bedita:4``` or ```docker pull bedita/bedita:5```
Then you may run the image with
```bash
docker run -p 8090:80 --env BEDITA_ADMIN_USR=bedita --env BEDITA_ADMIN_PWD=bedita bedita/bedita:5
```
You can then set env vars accordingly like this:
```env
export BEDITA_API="http://localhost:8090"
export BEDITA_ADMIN_USR="bedita"
export BEDITA_ADMIN_PWD="bedita"
```
and you're ready to go
## Licensing
BEdita is released under [LGPL](/bedita/bedita/blob/master/LICENSE.LGPL), Lesser General Public License v3.