stfalcon-studio/lost-and-found

Web-service for announcements of lost and found things.

Lost and Found

Web-service for announcements of lost and found things., _(*1)

Currently in development. Things may change or break until a solid release has been announced., _(*2)

, _(*3)

History

This service started as a training project for students from Khmelnytskyi Polytechnic College during their practice at Studio Stfalcon.com. You can also check a presentation and video about that practice., _(*4)

, _(*5)

Requirements

• PHP 5.6 and later
• Symfony 2.7 and later
• Doctrine 2.5 and later
• Facebook application

Installation

Install Composer

$ curl -s https://getcomposer.org/installer | php

Create project via Composer

$ composer.phar create-project -s dev stfalcon-studio/lost-and-found lost-and-found

-s dev means non-stable version, until we make first stable release., _(*6)

Check your system configuration

Before you begin, make sure that your local system is properly configured for Symfony2. To do this, execute the following:, _(*7)

$ php app/check.php

If you got any warnings or recommendations, fix them before moving on., _(*8)

Setting up permissions for directories app/cache/ and app/logs

$ HTTPDUSER=`ps aux | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1`
$ sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs
$ sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs
````

#### Change DBAL settings, create DB, update it and load fixtures

Change DBAL setting if your need in `app/config/config.yml`, `app/config/config_dev.yml` or
`app/config/config_test.yml`. After that execute the following:

```bash
$ ./console doctrine:database:create
$ ./console doctrine:migrations:migrate
$ ./console doctrine:fixtures:load

You can set test environment for command if you add --env=test to it., _(*9)

Create new application on Facebook

• Register as Facebook Developer
• Then open https://developers.facebook.com/quickstarts/?platform=web
• Type the name of your application, e.g. Lost and Found. Localhost
• Press "Create New Facebook App ID"
• Choose category "Apps for Pages"
• Press "Create App ID"
• Set your site URL. If it is on localhost, then something like this http://lost-and-found.localhost/app_dev.php/ and press Next
• Use the newly generated App ID and App Secret parameters for your application, update parameters facebook_app_id and facebook_app_secret in parameters.yml file

That's all. Enjoy "Lost and Found" and send feedback ^_^, _(*10)