social network for educational purposes only
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bootstrap
config
database
public
resources
storage
tests
.env.example
.gitattributes
.gitignore
artisan
composer.json
composer.lock
gulpfile.js
package.json
phpspec.yml
phpunit.xml
readme.md
server.php

readme.md

friendzone - a social network is rising

friendzone discontinued! Please use use the successor InstaHub.

Source code and install instructions are in English. Documentation and excersices currently are available in German only.

friendzone is a social network for educational purpose only. Students can create their own social network as a database admin. They learn basics about working in a software project, creating and managing a database, querying (SQL SELECT) and editing (SQL INSERT, UPDATE and DELETE).

This project aims to help students develop a general technical understanding of social networks. As result, they will be able to discuss sinjects as big data and information privacy.

Live Demo: https://friendzone.wi-wissen.de/

Read more (only in German): https://blog.wi-wissen.de/tag/friendzone

Standing on the shoulders of giants

Many thanks and respect to:

Install

Prerequisits

Prerequisits for Windows users

Mac Os, Ubuntu and Windows

  1. Create a local database named friendzone with encoding utf8_general_ci
  2. Create user friendzone and grant all rights on friendzone and for creating databases
  3. cd to your local target folder and clone remote project: git clone git://github.com/wi-wissen/friendzone.git
  4. Rename .env.example file to .envinside your project root and fill in the database information. (windows won't let you do that, so you have to use Notepad++ or open your console, cd your project root directory and run mv .env.example .env )
  5. Edit .env
    • APP_ENV=production
    • APP_DEBUG=false - enable only temporaly for debugging!
    • DB_* - if you want another database than MySQL, you have to edit source code.
    • DB_USERNAME - user for database
    • DB_PASSWORD - passwort for database
    • MAIL_* - mail provider for resetting passworts (admin accounts may reset passworts without sending a mail)
    • PHPMYADMIN - url for opening phpMyAdmin - Example: https://friendzone.wi-wissen.de/phpmyadmin
  6. Open the console and cd to your project root directory
  7. Run composer install or php composer.phar install
  8. Run php artisan key:generate
  9. Run php artisan migrate
  10. Run php artisan db:seed to run seeders, if necessary.
  11. Visit website and create first user.
  12. In the user table of your database, manually set the attribute is_admin to 1. Now your user is admin and may manage other accounts.

Contributing

Thank you for considering contributing to the friendzone! Create a pull request or contact me.

License

Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

Contact me if you need an other licence.