Carpoolear frontend

Español

Carpoolear es la primera aplicación argentina de Facebook que permite a los usuarios de dicha red social compartir viajes en automóvil con otros usuarios de su entorno.

Es una customización ad-hoc para Argentina de la filosofía carpooling, la cual consiste en compartir nuestros viajes en auto con otras personas de forma cotidiana. El carpooling es una práctica popular en Estados Unidos y Europa, donde se realiza de manera organizada para lograr aumentar el número de viajes compartidos y que estos sean concretados con otras personas además de nuestros vecinos y amigos.

English

Carpoolear is the first Argentine Facebook app that allow the users of this social network share car trips with other users.

It is and ad-hoc customization for Argentina with carpooling philosophy, with consist of sharing our car trips with other people. The carpooling is a popular practice in USA and Europe, where it is practice in a organized way with the purpose of increase the number of trips shared with new people in addition to our neighbors and friends.

Start coding

``` bash

git clone

git clone https://github.com/STS-Rosario/carpoolear.git

install dependencies

npm install

serve with hot reload at localhost:8080

npm run dev npm run prod (NOT WORKING)

serve with hot realod and with prod.env

npm run prod

```

Selecting project

``` bash

selec project, if not project selected, the default project is "default"

linux and osx

TARGET_APP=myProject

window poweshell

$env:TARGET_APP = "myProject"

```

Mobile apps

``` bash

in root folder

npm run build:android npm run build:ios npm run build-dev:android npm run build-dev:ios

the apk will be created in the dist folder

```

Creating new projects

This branch is multi project. You can handle multiple apps in only one source code. To create a new project, first select it's name, for example "YOUR-PROJECT-NAME".

1. Then have to go to ./projects folder and clone default folder. Change the name of the folder to "YOUR-PROJECT-NAME" and customize all the assets (google-services.js, config.xml and images). Remember that in config.xml in "cordova-plugin-facebook4" you must put your APPID and your APPNAME of facebook.

2. If you wanna customize some css files or any vue module like main.css, you must copy the file in the same folder and name it "main.YOUR-PROJECT-NAME.css". When compiling the project webpack will resolve the correct file.

3. Finally in ./config folder clone the files dev.env.js and prod.env.js and save as dev.YOUR-PROJECT-NAME.env.js and prod.YOUR-PROJECT-NAME.env.js. Personalize the files with your values. Your new project is ready.

Happy coding!

Config

In the config table in your carpoolear DB you can configure the following parameters:

| Property | Type | Description | | -------- | ---- | ----------- | | adminemail | STRING | Email of the admin.| | nameapp | STRING | Name of the app. | | targetapp | STRING | Only in development. (target project name) | | osmcountry | STRING | Country locale for Open Street Map. | | countryname | STRING | Your country name. | | locale | STRING | Country locale. | | homeredirection | STRING | Your home website url. | | modulevalidateddrivers | BOOLEAN | If enabled, drivers must be valdiated. | | tripcarddesign | STRING | 'default' or 'light' // 'default is the custom carpoolear theme. 'light' is an optional carpoolear theme. You can make your own themes. | | tripstars | BOOLEAN | If enabled, the punctuation of users is shown as stars, if not as numbers.| | maxcardsperrow | INT | How many trip cards must be shown per row. Default: 4 | | disableuserhints | BOOLEAN | If enabled, user hints are hidden. | | logincustomheader | BOOLEAN | If enabled, you can use a custom header. | | enablefooter | BOOLEAN | If enabled, you can login by facebook. | | donation | JSON | With donation you can configure donation campaigns. Object must be: {"ammountneeded": 1000, "monthdays": 0, "tripscount": 20, "tripsoffset": 0, "tripsrated": 2} | | moduletripseatspayment | BOOLEAN | If enabled, online payment if required to travel. | | moduleuserrequestlimited | JSON | Object must be: {"enabled": true, "hoursrange": 8} | | apicrice | BOOLEAN | If enabled, active the api that calculate the trip price. | | fuelprice | FLOAT | The local fuel price, to stimate the trip price. | | enablefacebook | BOOLEAN | If enabled, you can login with facebook. | | moduleonboardingnewuser | JSON | Object must be: {"enabled": true, "cards": 4} | | allowratingreply | BOOLEAN | If enabled, you can reply a comment of another user | | modulecoordinateby_message | BOOLEAN | If enabled, the trip coordination is in the chat view |

| module_references | BOOLEAN | If enabled, references can be made in another user profile |

Important

You must respect this linting configuration: /jshint esversion: 6/

All the variable and methods name must be in english.

License

The Carpoolear frontend is open-sourced software licensed under the GPL 3.0.