Lost and Found

Web-service for announcements of lost and found things.

Currently in development. Things may change or break until a solid release has been announced.

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.

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.

Check your system configuration

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

$ php app/check.php

If you got any warnings or recommendations, fix them before moving on.

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:

$ ./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.

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 ^_^