Getting Started english version

TODO

• Insert images
• Proofreading
• Formatting

Catarse – Open Source Crowdfunding Platform

Translated from Relsi Hur Maron's post in portuguese.

Catarse emerged as the first platform for collaborative financing for creative projects in Brazil, according to the creators, and had its source code released under the MIT license. I found out about the project around a month ago, while searching about crowdfunding, then i decided to give it a try, and downloaded the project to tinker with it.

In the next lines i'll show a short how-to about installing and running the project, and if you wish, how to create your own crowdfunding platform.

I'd like to thank Daniel Weinmann, one of the developers, for his patience in solving the doubts that i had during the installation and testing process; a big part of this post is due to him.

First of all you gotta clone the project with git: -$ git clone https://github.com/danielweinmann/catarse.git

Good. Now that the system is in your machine, let's make it run. The app is developed with Ruby, using Rails and PostgreSQL as the database, só you gotta have those platforms already installed in your machine to run the system.

If for you Ruby is the devil that used to make out with Sam Winchester, i suggest that you do some research first, or eles you'd be lost in the sand as i was. After a couple of messy trials i followed Daniel's suggestion and used RVM; if i knew about this tool before, this post would've been done much earlier.

Once you have all the development platforms installed, the first thing to do is the creation of a database for the application. The database configuration file can be found in config/database.sample.yml, just duplicate it and rename the copy to database.yml or skip the duplication part. With that done, you'll need to edit the development section in the database configuration file, as below:

`development:

adapter: postgresql

encoding: utf-8

database: database_name

pool: 5

username: database_user

password: 'database_user_password'

host: localhost

port: 5432 ` I left the other configurations untouched; i'm not a Ruby programmer, só i might make some mistakes during the process, but the configuration above worked fine for me; feel free to fix anything.

Once the file is modified and saved, open up a terminal window. Navigate to the directory where catarse is located and run the command:

~$ bundle install

Wait for the process to finish. If it goes error-free, run the command:

~$ rake db:migrate

And now, seed your catarse running the command :

~$ rake db:seed

With that done, we can run the system. In the terminal, fire up your server with the command: ~$ rails s Wait for the message “Listening on 0.0.0.0:3000, CTRL+C to stop” and then reach the system on http://localhost:3000/ If everything went as planned, you'll now facing this screen:

The next step is to log into the system.

The login is done with a Google Account, só just choose that option and grant the permissions when asked. You'll see your profile:

To create a project, go to http://localhost:3000/projects/new

Fill in the data and submit the project. You'll be redirected to the project page, as it's going to be shown once the app admins approve it.

At this moment, you're still a regular user. To get administrative rights and approve the exhibition of a project on the main page, you need to do some steps:

Fire up another terminal window and enter the following command:

~$ rails c

Enter the command:

~$ u = User.first

And set your user as admin:

~$ u.update_attribute :admin, true

That's it. Now you can access  http://localhost:3000/projects/pending  if everything went fine, and a page with the pending projects will be shown:

To mark the project as active, just check the Visível (Visible), Recomendado(Recommended) and Home Page options.

With that done, the project will be available to the users:

I think that's all for now. I'd like to thank Softa for releasing the system to the community, because i'm sure that having it as a starting point will be very helpful to those wishing to implement this kind of system. And i'd like to thank Daniel for the tips which made this post possible, and i wish i can contribute to the project somehow.