No Description

bic 5fb095f4f7 readme con note 5 years ago
accounts 93dc62c322 Add admin screen filters for badge grants 5 years ago
events 6bdd6a392f Fix event admin filtering 5 years ago
get_together 8117346a68 Include FontAwesome files in hosted static files rather that referring to them externally. Fixes #115 5 years ago
resume 3defa51ff0 Fix resume redirects, add more test cases 5 years ago
simple_ga 39309057ce Fix event serialization to and from the session storage 5 years ago
totd 06870d6df0 Misc bug fixes 5 years ago
.dockerignore 11e335bb71 Make a smaller Docker image 5 years ago
.gitignore fa18721b45 Add local-only files to gitignore 5 years ago
.travis.yml dd6e70f941 Add .travis.yml file. 5 years ago
Dockerfile 7e6d478a8b Rebase off master with updated Dockerfile 5 years ago
LICENSE ae1000850d Initial commit, basic models only and just enough views to show it's working 6 years ago
MioReadme.md 5fb095f4f7 readme con note 5 years ago
README.md dd6e70f941 Add .travis.yml file. 5 years ago
docker-compose.yml 7e6d478a8b Rebase off master with updated Dockerfile 5 years ago
local_settings.example 9356020772 Fix typo in local_settings.example comment 5 years ago
manage.py ae1000850d Initial commit, basic models only and just enough views to show it's working 6 years ago
requirements.txt 9ddc993cd5 Add checks for missing user geoip coordinates and fall back to not sorting by distance 5 years ago

README.md

Get Together

Build Status

Get Together is an open source event manager for local communities.

Get Together is version 0.8.0.

Try it free at https://gettogether.community

Goals

  • Be feature-competitive with Meetup.com
  • Allow multiple instances to share federated event data
  • Provide sustainable, cost-effective hosting for FOSS communites
  • Be developed and maintained by the communities using it

Getting Started

To start running the service use the following commands:

virtualenv --python=python3 ./env
./env/bin/pip install -r requirements.txt
./env/bin/python manage.py migrate
./env/bin/python manage.py createsuperuser
./env/bin/python manage.py runserver

Loading City data

In order to make it easier to create Places and Teams without having to manually enter records for Country, SPR (State/Province/Region) and City, you can preload them using data files from http://download.geonames.org/export/dump/

The provided load_spr and load_cities commands will only load data if the parent country (or SPR for cities) exists in the database. This lets you choose whether you want to load every city, only cities for select countries, or only for select SPRs.

Countries

Download the countryInfo.txt file from GeoNames, then run:

./env/bin/python manage.py load_countries countryInfo.txt

SPR

Download the admin1CodesASCII.txt file from GeoNames, then run:

./env/bin/python manage.py load_spr admin1CodesASCII.txt

Cities

You have a few choices for City data files. GeoNames provides data files for cities with more than 15,000 residents, cities with more than 5,000 residents, and cities with more than 1,000 residents. The smaller the number, the more cities there will be in the data file (and the longer it will take to import them all).

Download the file you want from the links above. They will be zip files that you must unzip before using. Then import the cities by running (for your downloaded file):

./env/bin/python manage.py load_cities cities15000.txt

Using docker

docker build -t get_together .
docker run -e "DEBUG_MODE=True" -e "SECRET_KEY=xxxxx" -e "ALLOWED_HOSTS=localhost,127.0.0.1" -d --name get_together -p 8000:8000 get_together
docker exec -it get_together python3 manage.py createsuperuser

Using docker-compose

docker-compose up -d
docker-compose exec get_together python3 manage.py createsuperuser

You can then connect to the container by going to localhost:8000

Test Federation

You can import live event data into your "Searchable" table with this command:

./env/bin/python manage.py import https://gettogether.community/searchables/

Getting Involved

To contibute to Get Together, you can file issues here on GitHub, work on features you want it to have, or contact us on Gitter to learn more.

Currently the project needs:

  • Designers
    • We need a color scheme for the website
    • We need a logo for the project
    • We need user stories and mockups for those pages
  • Front-end developers
    • We need to pick a JS/CSS framework for the front-end
    • We need to Django page templates
    • We need to know what APIs are needed for a dynamic front-end
  • QA Engineers
    • We need Django test cases setup
    • We need fuzz-testing setup with something like model-mommy
    • We want testing automated on github pull requests
  • API/Federation experts
    • We need to decide on using AppStream or rolling our own data/protocol
    • We need to architect what data will be federated and it's use cases
    • We need to support authenticated access to APIs for 3rd party apps
  • Devops
    • We need a way to easily deploy and update GetTogether in production
    • We need an easy way to get a development environment up and running
    • We need to find a hosting service for gettogether.community

If you can help with any of these, please get in touch with me!