Merge pull request #119 from mredigonda/master

Minor fixes
This commit is contained in:
Maximiliano Redigonda 2018-02-20 16:10:45 -03:00 committed by GitHub
commit 66de1f176d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 39 additions and 38 deletions

View File

@ -2,7 +2,7 @@
[![Build Status](https://travis-ci.org/opensupports/opensupports.svg?branch=master)](https://travis-ci.org/opensupports/opensupports) v4.1.2 [![Build Status](https://travis-ci.org/opensupports/opensupports.svg?branch=master)](https://travis-ci.org/opensupports/opensupports) v4.1.2
OpenSupports is an open source ticket system built primarly with PHP and ReactJS. OpenSupports is an open source ticket system built primarily with PHP and ReactJS.
Please, visit our website for more information: [http://www.opensupports.com/](http://www.opensupports.com/) Please, visit our website for more information: [http://www.opensupports.com/](http://www.opensupports.com/)
## Requirements ## Requirements
@ -10,52 +10,53 @@ Please, visit our website for more information: [http://www.opensupports.com/](h
* MySQL 4.1+ * MySQL 4.1+
## Development ## Development
Here is a guide of how to set up the development environment in OpenSupports Here is a guide of how to set up the development environment in OpenSupports.
### Getting up and running FRONT-END (client folder) ### Getting up and running FRONT-END (client folder)
0. update `sudo apt-get update` 1. Update: `sudo apt-get update`
1. Clone this repo 2. Clone this repo: `git clone https://github.com/opensupports/opensupports.git`
2. Install node 4.x version 3. Install node 4.x version:
- `sudo apt-get install curl` - `sudo apt-get install curl`
- `curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -` - `curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -`
- `sudo apt-get install -y nodejs` - `sudo apt-get install -y nodejs`
3. Install npm `sudo apt-get install npm` 4. Install npm: `sudo apt-get install npm`
4. Install gulp `sudo npm install -g gulp` 5. Install gulp: `sudo npm install -g gulp`
5. Go to repo `cd os4-react/client` 6. Go to client: `cd opensupports/client`
6. Install dependences `npm install` 7. Install dependencies: `npm install`
7. Rebuild node-sass `npm rebuild node-sass` 8. Rebuild node-sass: `npm rebuild node-sass`
8. Run `gulp dev` 9. Run: `gulp dev`
9. Go to the main app: `http://localhost:3000/app` or the component demo `http://localhost:3000/demo` 10. Go to the main app: `http://localhost:3000/app` or to the component demo `http://localhost:3000/demo`
10. Your browser will automatically be opened and directed to the browser-sync proxy address 11. Your browser will automatically be opened and directed to the browser-sync proxy address.
12. Use `gulp dev --api` to disable fixtures and use the real php server api (it must be running at :8080). 12. Use `gulp dev --api` to disable fixtures and use the real PHP server api (it must be running at :8080).
Now that `gulp dev` is running, the server is up as well and serving files from the `/build` directory. Any changes in the `/src` directory will be automatically processed by Gulp and the changes will be injected to any open browsers pointed at the proxy address. Now that `gulp dev` is running, the server is up as well and serving files from the `/build` directory. Any changes in the `/src` directory will be automatically processed by Gulp and the changes will be injected to any open browsers pointed at the proxy address.
OpenSupport uses by default the port 3000, but this port could already be used. If this is the case, you can modify this in the file: `client/gulp/config.js`.
##### Production Task ##### Production Task
Just as there is the `gulp dev` task for development, there is also a `gulp prod` task for putting the project into a production-ready state. This will run each of the tasks, while also adding the image minification task discussed above. Just as there is a `gulp dev` task for development, there is also a `gulp prod` task for putting the project into a production-ready state. This will run each of the tasks, while also adding the image minification task discussed above.
**Reminder:** Notice there is `index.html` and `index.php`. The firstone searches the backend server where `config.js` say it, the second one uses `/api` to find the server. If you want to run OpenSupports in a single server, then use `index.php`. **Reminder:** Notice there is `index.html` and `index.php`. The first one searches the backend server where `config.js` says it, the second one uses `/api` to find the server. If you want to run OpenSupports in a single server, then use `index.php`.
#### Frontend Unit Testing #### Frontend Unit Testing
1. Do the steps described before 1. Do the steps described before.
2. Install mocha "sudo npm install -g mocha" 2. Install mocha: `sudo npm install -g mocha`
3. Run `npm test` to run the tests 3. Run `npm test` to run the tests.
### Getting up and running BACK-END (server folder) ### Getting up and running BACK-END (server folder)
1. Clone this repo 1. Clone this repo: `git clone https://github.com/opensupports/opensupports.git`
2. [Install PHP 5.6](https://www.dev-metal.com/install-setup-php-5-6-ubuntu-14-04-lts/) 2. [Install PHP 5.6](https://www.dev-metal.com/install-setup-php-5-6-ubuntu-14-04-lts/)
3. [Create MySQL Database](#markdown-header-create-mysql-database) 3. [Create MySQL Database](#markdown-header-create-mysql-database)
4. [Install composer](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-composer-on-ubuntu-14-04) 4. [Install composer](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-composer-on-ubuntu-14-04)
5. Go to `cd os4-react/api` 5. Go to the server folder: `cd opensupports/server`
6. Run `composer install` 6. Run: `composer install`
7. Run the server with `php -S localhost:8080` 7. Run the server with: `php -S localhost:8080`
##### Create MySQL Database ##### Create MySQL Database
1. Install mysql-server 1. Install mysql-server:
Ubuntu Ubuntu
@ -66,41 +67,41 @@ Just as there is the `gulp dev` task for development, there is also a `gulp prod
`sudo yum install mysql-server` `sudo yum install mysql-server`
`/etc/init.d/mysqld start` `/etc/init.d/mysqld start`
2. Access the mysql shell 2. Access the MySQL shell:
`mysql -u root` `mysql -u root`
3. Create a new database 3. Create a new database:
`CREATE DATABASE development;` `CREATE DATABASE development;`
4. Run the MySQL server 4. Run the MySQL server:
`sudo /etc/init.d/mysql start` `sudo /etc/init.d/mysql start`
##### BACKEND API RUBY TESTING ##### BACKEND API RUBY TESTING
1. Install ruby `sudo apt-get install ruby-full` 1. Install Ruby: `sudo apt-get install ruby-full`
2. Install mysql dev dependencies `sudo apt-get install libmysqlclient-dev libmysqlclient16 ruby-dev` 2. Install MySQL dev dependencies: `sudo apt-get install libmysqlclient-dev libmysqlclient16 ruby-dev`
3. Install bundle `sudo gem install bundler` 3. Install bundle: `sudo gem install bundler`
4. Go to test folder `cd os4-react/tests` 4. Go to tests folder: `cd opensupports/tests`
5. Install project dependencies `sudo gem install bundler` 5. Install project dependencies: `bundle install`
Test can run by using executing `run-tests.sh` file. Tests can run by using executing the `run-tests.sh` file.
##### BACKEND FAKE SMTP SERVER ##### BACKEND FAKE SMTP SERVER
If you're doing development, you can use a FakeSMTP server to see the mails that are being sent. If you're doing development, you can use a FakeSMTP server to see the mails that are being sent.
1. Install java if you don't have it jet 1. Install Java if you don't have it yet:
`sudo apt-get install default-jre` `sudo apt-get install default-jre`
`sudo apt-get install default-jdk` `sudo apt-get install default-jdk`
2. [Download FakeSMTP](https://nilhcem.github.io/FakeSMTP/download.html) 2. [Download FakeSMTP](https://nilhcem.github.io/FakeSMTP/download.html)
3. Extract the file from the zip and run it 3. Extract the file from the zip and run it:
`java -jar fakeSMTP-2.0.jar` `java -jar fakeSMTP-2.0.jar`
4. Set the port to 7070 and start the SMTP server 4. Set the port to 7070 and start the SMTP server.
5. Every time the application sends an email, it will be reflected there. 5. Every time the application sends an email, it will be reflected there.

View File

@ -358,7 +358,7 @@ export default {
'ACTIVITY_DEPARTMENT_CHANGED_THIS': 'changed department of this ticket to ', 'ACTIVITY_DEPARTMENT_CHANGED_THIS': 'changed department of this ticket to ',
'ACTIVITY_PRIORITY_CHANGED_THIS': 'changed priority of this ticket to', 'ACTIVITY_PRIORITY_CHANGED_THIS': 'changed priority of this ticket to',
'DATE_PREFIX': 'on', 'DATE_PREFIX': 'on',
'LEFT_EMPTY_DATABASE': 'Left empty for automatic database creation', 'LEFT_EMPTY_DATABASE': 'Leave empty for automatic database creation',
'REMEMBER_ME': 'Remember me', 'REMEMBER_ME': 'Remember me',
'EMAIL_LOWERCASE': 'email', 'EMAIL_LOWERCASE': 'email',
'PASSWORD_LOWERCASE': 'password', 'PASSWORD_LOWERCASE': 'password',

View File

@ -37,4 +37,4 @@ This request will return you the session data with an `userId` and a `token`. Yo
If you don't pass the userId and token, a `NO_PERMISSION` error will be returned. If you don't pass the userId and token, a `NO_PERMISSION` error will be returned.
Additionally, if there is no users (only staff members), you can check a ticket you created by providing your email and the ticketNumber to the `/ticket/check` path. This path will return you a `token` and `ticketNumber` you will use to comment, retrieve, or do any other operations to the ticket. Additionally, if there are no users (only staff members), you can check a ticket you created by providing your email and the ticketNumber to the `/ticket/check` path. This path will return you a `token` and `ticketNumber` you will use to comment, retrieve, or do any other operations to the ticket.