Skip to main content

A Django app to publish Web-based vacancies.

Project description


Vacancies is a simple Django app to publish Web-based vacancies :) For each vacancy, editors can choose between a various number of attributes.

Detailed documentation is in the "docs" directory - one day


pip install django-vacancies

Quick start

1. Add "vacancies" to your INSTALLED_APPS setting like this::

        # or
        'vacancies.apps.VacanciesConfig', # <- prefered for localized app name

2. Include the vacancies URLconf in your project like this::

    path('vacancies/', include('vacancies.urls', namespace='vacancies')),

3. Run `python migrate` to create the vacancies models.

4. Start the development server and visit
   to create a vacancy (you'll need the Admin app enabled).

5. Visit to view your wonderful vacancies.

Admin Integration

By default django admin autodiscover is beeing used. If you have custom admin site, register the vacancies models by yourself e.g.:

# project/
from django.contrib import admin
from django.contrib.auth.admin import User, UserAdmin, Group, GroupAdmin
from django.utils.translation import ugettext_lazy as _
from vacancies.admin import Vacancy, VacancyAdmin, ContactPerson, ContactPersonAdmin, Location, LocationAdmin

class AdminSite(admin.AdminSite):
    site_title = 'My cool Admin'
    site_header = _('Database Interface')
    index_title = _('Administration')

site = AdminSite()
site.register(User, UserAdmin)
site.register(Group, GroupAdmin)
site.register(Vacancy, VacancyAdmin)
site.register(ContactPerson, ContactPersonAdmin)
site.register(Location, LocationAdmin)


You can create a vacancies/vacancies_base.html Base Template to implement you pug environemnt e.g.

# vacancies/vacancies_base.html
{% extends "base.pug" %}


Contribute Locales

# Inside cloned repository folder:
mkdir .virtualenv && python3 -m venv .virtualenv && sv
pip install django
mkdir vacancies/locale/NEW_LOCALE
cd vacancies
django-admin makemessages --ignore=.virtualenv/* --ignore=fixtures/* --ignore=assets/* -a --no-location -e html,pug,py,txt
# Use Po-Edit or other editor to edit locales

Package and Install Development Version

# Inside cloned repository folder:
# Adjust setup.cfg
python sdist

# Inside Dev Project Apps Dir:
ln -s  ../../django-vacancies/vacancies

# Or:
pip install --user django-vacancies/dist/django-vacancies-0.1.tar.gz
pip uninstall django-vacancies


# Inside cloned repository folder:
python sdist
twine upload --repository-url dist/*


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-vacancies-0.1.7.tar.gz (11.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page