lostplaces | ||
.gitignore | ||
LICENSE | ||
MANIFEST.in | ||
Pipfile | ||
Readme.md | ||
Readme.rst | ||
setup.py |
lostplaces-backend
lostplaces-backend is a django (3.x) based webproject. It once wants to become a software which allows a group of urban explorers to manage, document and share the locations of lost places while not exposing too much / any information to the public.
The software is currently in early development status, neither scope, datalmodel(s) nor features are finalized yet. Therefore we would not recommend to download or install this piece of software anywhere - except your local django dev server.
Features
- manage lost places with lots of usefull information
- sensitive information is not accesiable for anonymous (not logged in) users
- user self registration using a voucher system, only people you invite can join your instance
- collaboration, every user can add informations like tags, photos and external links to your place
Dependencies
Right now it depends on the following non-core Python 3 libraries. These can be installed using the package manager of your distribution or into the venv locally.
- django django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.
- easy-thumbnails A powerful, yet easy to implement thumbnailing application for Django 1.11+
- image Image cropping for django
- django-widget-tweaks Tweak the form field rendering in templates, not in python-level form definitions.
- django-taggit A simpler approach to tagging with Django.
Installing a development instance
Clone the repository
git clone https://git.mowoe.com/reverend/lostplaces-backend.git
Setting up a (pipenv) virtual environment for development
After having obtained the repository contents (either via .zip download or git clone), you can easily setup a pipenv virtual environment. The repo provides a Pipfile for easy dependency management that does not mess with your system.
$ cd lostplaces-backend
$ pipenv install
$ pipenv shell
(lostplaces-backend) $ lostplaces/manage.py makemigrations
(lostplaces-backend) $ lostplaces/manage.py migrate
(lostplaces-backend) $ lostplaces/manage.py createsuperuser
(lostplaces-backend) $ lostplaces/manage.py runserver --ipv6
Returning to the venv
$ cd lostplaces-backend
$ pipenv shell
(lostplaces-backend) $ pipenv update # If dependencies changed, or updates available
(lostplaces-backend) $ lostplaces/manage.py makemigrations # If datamodels changed
(lostplaces-backend) $ lostplaces/manage.py migrate # If datamodels changed
(lostplaces-backend) $ lostplaces/manage.py runserver --ipv6
Visit: admin for administrative backend or frontend
Installing a productive instance
Currently there are two ways to deploy the lostplaces project:
- Cloning this repository, including the configured django instance
- Install the package and setup the django instance your self
Cloning the repository
Essently, this is the same as installing an development instance, but without the development server (manage.py runserver) and something powerfull (Apache, NGINX) instead. You have to configure the webserve to work with the *SGI Api respectivly, reference django's guide for deployment for further information.
You also should setup an dedicated database server, the build in SQLite file is not recommened for production use. Reference django's guide for databases for further information.
Before making the django instance public, you should tweak the config settings.py
:
- Change the secret key, the one found in the config is already public. Choose something secure (i.e. this)
- Turn off debug mode by setting
DEBUG = False
- Tune the localization settings, see django's documentation
Run lostplaces/managy.py collectstatic
you should be ready to go.
Installing the lostplaces_app to an existing django instance
Installing django and the lostplaces app
If you haven't already setup an django instance, see django's documentation.
After that, download the desired release (probably the latest one) from the realeases page and install it using pip install --user name-of-the-file.tar.gz
.
Note: You can run pip install without the --user flag, which will require root privileges and introduces potential security issues
Configuring the django instance
Now configure your settings.py
as follows:
- Add the following apps to the django project
INSTALLED_APPS = [
...
'lostplaces_app',
'easy_thumbnails',
'widget_tweaks',
'django_taggit'
]
- Set the URL's and Root-directories for file handling, for example
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static_files')
MEDIA_URL = '/uploads/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')
- Set the user model (this will be changed in the next release)
AUTH_USER_MODEL = 'lostplaces_app.Explorer'
- Set the URL's for login, for example
LOGIN_URL = reverse_lazy('login')
LOGIN_REDIRECT_URL = reverse_lazy('lostplaces_home')
LOGOUT_REDIRECT_URL = reverse_lazy('lostplaces_home')
Configuring the URL's
In the urls.py
configure the urlpatter
like this
urlpatterns = [
path('admin/', admin.site.urls),
path('signup/', SignUpView.as_view(), name='signup'), # If you want to use lostplaces sign up view
path('explorers/', include('django.contrib.auth.urls')), # You can change the 'explorers/' to whatever you desire
path('', include('lostplaces_app.urls')), # In this configuration lostplaces will be at the top level of you website, change '' to 'lostplaces/', if you don't want this
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) # So django can deliver user uploaded files
Before making the django instance public, you should tweak the config settings.py
:
- Change the secret key, the one found in the config is already public. Choose something secure (i.e. this)
- Turn off debug mode by setting
DEBUG = False
- Tune the localization settings, see django's documentation
Run lostplaces/managy.py collectstatic
you should be ready to go.
Happy developing ;-)