Bilemo admin

Introduction

This project is the Bilemo administration application using Bilemo REST API as part of my 7th OpenClassRooms PHP/Symfony Developer project. This application is built with Symfony 3.4. A working demo can be found here (admin credentials: bilemo - pwdbilemo).

Read instructions below to fork this admin application.

Prerequisites

• PHP >=5.5.9
• MySQL
• Composer to install Symfony 3.4 and project dependencies

Dependencies

This project uses:

• CsaGuzzleBundle a PHP HTTP client that makes it easy to send HTTP requests to call Bilemo API

This dependency is included in composer.json.

This project also uses:

• WebPack Encore for assets management
• bootstrap-sass Bootstrap SASS library
• sass-loader to compile your SCSS files to CSS

Those dependencies are included in package.json

Installation

First of all, follow Bilemo API instructions to add your application as a Bilemo admin application and get credentials you will need later:

client_id: {YourClientId}
client_secret: {YourClientSecret}
username: {YourApplicationName}
password: {YourPassword}

Once you got your credentials, you can go on:

1. Clone this repository on your local machine by using this command line in your folder git clone https://github.com/bhalexx/bilemo_admin.git.
2. Rename app/config/parameters.yml.dist in app/config/parameters.yml, edit database parameters with yours and fill parameters with the credentials you got from Bilemo API.
3. Edit API URI (e.g.: URI from your forked API project) from parameters.yml (parameter bilemo_api_url).
4. In project folder open a new terminal window and execute command line composer install.
5. Then execute command line npm install to install node modules for assets management.

Your project is ready to be run!

Customization

Assets are located in app\Resources\assets, and minified and built by Encore in web\build. To add/edit or any other configuration customization, look at webpack.config.js!

You can modify the max number of mobiles by editing NUMBER_OF_ITEMS constant value in the AppBundle\Entity\Mobile.php file.

Documentation

This application communicates with Bilemo API so an OAuth2 authentication is needed to access to API endpoints. Bilemo admin application credentials are defined in parameters.yml.

Please refer to Bilemo API project and API documentation.

Related projects

Two other projects were created to complete this 7th project:

• Bilemo - the Bilemo REST API
• OpenMobileRooms - a Bilemo B2B partner application