This is the next revision of nolotiro.org (v3), this time in Ruby On Rails.

• Ruby: 2.4
• Rails: 5.1
• PostgreSQL: 9.6

You need to install VirtualBox and Vagrant. Then from the root directory of the project, execute

vagrant up

When finished, you need to log in to the virtual machine with the command

vagrant ssh

Finally you should start the application server

cd /vagrant
bin/rails s -b 0.0.0.0

Now you can access the web application at this URL

http://localhost:3000

Check out the script in bin/bootstrap.sh - that's the same that Vagrant uses.

Running bin/rake will run all the tests, that should always pass on a freshly downloaded copy a nolotiro's master.

For obtaining geographic information we use Yahoo YQL.

For IP GeoLocation we use GeoLite2 City. The database is bundled with this repo in compressed format. To extract the database, run

bin/rake max_mind:extract

You can also, grab the latest version of the DB from MaxMind by running

bin/rake max_mind:update

For delayed tasks, we use Sidekiq, that uses Redis. For caching, we use Redis.

sudo apt-get install redis-server
bundle exec sidekiq

For the emails we recommend using mailcatcher. This doesn't send external emails during development, and you can see them in a nice web interface. The SMTP port is already configured.

gem install mailcatcher
mailcatcher
open http://localhost:1080

Happy hacking!

For the localization and translation interface we use [LocaleApp].

Example URLs:

https://beta.nolotiro.org/api/v1/woeid/list
https://beta.nolotiro.org/api/v1/woeid/766273/give
https://beta.nolotiro.org/api/v1/woeid/766273/give?page=2
https://beta.nolotiro.org/api/v1/ad/153735

• Core based on Ruby On Rails.
• Yahoo YQL - This project is strong WOEID integration centered.
• jQuery for Javascript.
• GeoLite2 data API by MaxMind to auto detect user location.
• Logo by Silvestre Herrera under GPL License.