Repository of the future http://ecobasa.org

Requisites

• Django (Python)
• PostgreSQL
• LESS (use node.js Grunt or Compass to compile CSS)

This is the base project for ecobasa. We are working with https://wechange.de

The ecobasa repository is mainly a configurable shell for the wechange apps we use, which are pluggable components. Most of the actual code resides in "cosinnus-core". See requirements_staging.txt for a full list of internal apps. ecobasa is built on top of wechange and extends the models and apps with its own data and interface.

Note: The wechange project is often refered to as "neww" in code and imports and the internal apps and python Objects are named "cosinnus" for historical reasons.

Setup local development with Docker

We use docker - a simple process isolation system that puts ecobasa in its own self-installing container. Install open-source edition here: https://store.docker.com/search?type=edition&offering=community

With docker installed: $ git submodule init $ git submodule update $ docker-compose up

Access django within docker

docker-compose exec web /bin/bash

How to set up local development for ecobasa

This will set up a local development envirenment, getting you ready to work on ecobasa and all its internal apps.

Note: ecobasa still runs on Python 2.7.15 using Django 1.8, but we are in the process of upgrading to Python 3 and Django >= 2.0!

Install PostgresSql

• Install PostgreSql for your system

We use PostgreSQL: http://www.postgresql.org/ For OSX we recommend: http://postgresapp.com/ See http://od-eon.com/blogs/calvin/postgresql-cheat-sheet-beginners/

• Create new psql database. Name it "ecobasa" or similar and note its password and user
  • you can use the root psql user, but we advise you to use a different one

for a bit of setup info. Basically:

$ sudo su - postgres $ createuser django -P # enter password, answer no to all questions $ createdb -E utf8 -O django ecobasa -T template0

Install Git

• Install a git client. Please refer to external guides if you are unsure how to do this for your system!

Get the ecobasa and cosinnus source code

• git clone [email protected]:ecobasa/ecobasa-3.0.git ecobasa
• ./ecobasa/local_install.sh | tee install.log

Notes:

• For wechange, we install the full set of dependencies via requirements.txt files. These are also used during our deployment and there are different files for local, staging and production environments.
• We tee the stdout so you can see errors more clearly.
• Deal with any errors you encounter here! Only move to the next step if you do not get any errors. Warnings are usually ok.
  • Especially Pillow and some other dependencies are known to cause trouble on some systems!
  • if you see any compile errors, often time the solution is to install the offending dependency using a pip Wheel for your system.

Configure up your local ecobasa projects

• cd ecobasa
• cp ecobasa/settings_local.py ecobasa/settings.py
• Edit ecobasa/settings.py:
  • replace the database settings in DATABASES['default']:
    • NAME, USER, PASSWORD: based on how you created your psql database
  • (this settings.py file is in .gitignore)

One-Time Django Setup

• ./manage.py migrate - creates all the empty database tables
• ./manage.py createsuperuser - create your own user account
  • enter the credentials for your local user
  • the username doesn't matter, you will log in using the email as credential

First-Time ecobasa Setup

• navigate to http://localhost:8000/admin and log in with the email address and password you just created
  • navigate to http://localhost:8000/admin/sites/site/1/ and change the default Site to
    • domain: localhost:8000
    • name: Local Site (or anything you wish)
• restart the server using "ctrl+c" and ./manage.py runserver

First-Time Wagtail Setup

We use Wagtail as CMS, and it will show up automatically as a root URL dashboard. You can skip this step configuring it, but all you will see on your root URL will be a blank page. Navigate to a page like http://localhost:8000/communities/ to see the ecobasa map.

• navigate to http://localhost:8000/cms-admin/pages/
  • Delete the page "Welcome to your new Wagtail Site"
  • create new Childpage on the root level
    • Tab Content (de): Title: enter "Root"
    • Tab Promote: Kurtitel (slug): enter "root"
    • Tab Settings: Portal: choose "Default Portal"
    • below in the drop-up: Click "Publish"
  • Hover over the new "Root" page and click "Add new Subpage"
    • Choose "Start-Page: Modular"
    • Tab Content (de): Title: enter "Dashboard"
    • Tab Promote: Kurtitel (slug): enter "dashboard"
    • below in the drop-up: Click "Publish"
  • In the left side menu, go to Settings > Sites
    • click "Add Site"
    • Hostname: localhost:8000
    • Port: 8000
    • click Choose Origin Site:
      • Navigate below Root using ">", choose page "Dashboard"
    • Check "Default Site" on
    • click "Save"
• navigate to http://localhost:8000/, you should see the blank CMS dashboard.
  • Its content can be edited in the "Dashboard" Page you just created in http://localhost:8000/cms-admin/pages/.

Check if you're up-and-running and create the Forum Group

• navigate to http://localhost:8000/groups/
• click "Create Group" in the left sidebar
  • enter Group Name: "Forum" (must be exact!)
  • click "Save" below
• If you get redirected to the Forum's Group Dashboard and "Forum" appears in the top navigation bar, you're all set!

Git Structure

ecobasa pulls Cosinnus-core and all cosinnus apps in directly from their Git repositories. See requirements_staging.txt for the repo locations and used branches.

Deployment

Deployment is automated with a comprehensive fab-file. Check ecobasa/fabfile.py!

When deploying using fab staging, the ecobasa and all the cosinnus projects will be deployed using their staging-branches! Same goes for production.

• To deploy to staging use:
  • fab staging deploy for a full deploy, shutting down the server, creating a database snapshot, and pulling up an "Under Maintenance" blanket on all URLs.
  • fab staging hotdeploy for a non-interruptive deploy. This is faster, creates no backups, and lets the site run as usual.
    • Note: hotdeploy should never be used when new database migrations are being pushed!

Set up the special group

Edit your local settings.py for ECOBASA_SPECIAL_COSINNUS_GROUP to point to the primary key of the special group every pioneer will become a member of and whose blog posts are exposed. You will have to do that after setting up the group in the admin interface.

We use LESS - CSS has to be compiled

You can use grunt with node.js. Package.json will install all necessary dependencies, just type $ npm install