An open API service indexing awesome lists of open source software.

https://github.com/mfcovington/django-lab-members

A Django app to display lab personnel and information about them
https://github.com/mfcovington/django-lab-members

Last synced: 10 months ago
JSON representation

A Django app to display lab personnel and information about them

Awesome Lists containing this project

README

          

******************
django-lab-members
******************

``django-lab-members`` is a Django app to display lab personnel and information about them. This app can be extended by ``djangocms-lab-members`` for use with django CMS.

Source code is available on GitHub at `mfcovington/django-lab-members `_. Information about and source code for ``djangocms-lab-members`` is available on GitHub at `mfcovington/djangocms-lab-members `_.

.. contents:: :local:

Installation
============

**PyPI**

.. code-block:: sh

pip install django-lab-members

**GitHub (development branch)**

.. code-block:: sh

pip install git+http://github.com/mfcovington/django-lab-members.git@develop

Configuration
=============

- Edit the project's ``settings.py`` file.

- Add ``lab_members`` and its dependencies to your ``INSTALLED_APPS`` setting:

.. code-block:: python

INSTALLED_APPS = (
# ...
'lab_members',
'easy_thumbnails',
'filer',
'mptt',
'sekizai',
'friendlytagloader',
)

- Specify your media settings, if not already specified:

.. code-block:: python

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

- Add ``easy_thumbnail`` settings:

.. code-block:: python

# For easy_thumbnails to support retina displays (recent MacBooks, iOS)
THUMBNAIL_HIGH_RESOLUTION = True
THUMBNAIL_QUALITY = 95
THUMBNAIL_PROCESSORS = (
'easy_thumbnails.processors.colorspace',
'easy_thumbnails.processors.autocrop',
'filer.thumbnail_processors.scale_and_crop_with_subject_location',
'easy_thumbnails.processors.filters',
)
THUMBNAIL_PRESERVE_EXTENSIONS = ('png', 'gif')
THUMBNAIL_SUBDIR = 'versions'

- Add ``sekizai`` settings:

- For **Django 1.7**, add ``sekizai.context_processors.sekizai`` to ``TEMPLATE_CONTEXT_PROCESSORS``:

.. code-block:: python

from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_CONTEXT_PROCESSORS += ('sekizai.context_processors.sekizai',)

- For **Django 1.8**, add ``sekizai.context_processors.sekizai`` to ``TEMPLATES``:

.. code-block:: python

TEMPLATES = [
{
# ...
'OPTIONS': {
'context_processors': [
# ...
'sekizai.context_processors.sekizai',
],
},
},
]

- Include URL configurations for ``lab_members`` and media (if ``DEBUG == True``) in your project's ``urls.py`` file:

- For **Django 1.7**:

.. code-block:: python

# ...
from django.conf import settings

urlpatterns = patterns('',
# ...
url(r'^lab_members/', include('lab_members.urls', namespace='lab_members')),
# ...
)

if settings.DEBUG:
urlpatterns += patterns('',
(r'^media/(?P.*)$', 'django.views.static.serve', {
'document_root': settings.MEDIA_ROOT}))

- For **Django 1.8**:

.. code-block:: python

# ...
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
# ...
url(r'^lab_members/', include('lab_members.urls', namespace='lab_members')),
# ...
]

if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Migrations
==========

Create and perform migrations for ``lab_members`` and its dependencies:

.. code-block:: sh

python manage.py makemigrations lab_members
python manage.py migrate

Usage
=====

- Start the development server:

.. code-block:: sh

python manage.py runserver

- Login and add a scientist: ``http://localhost:8000/admin/lab_members/scientist/add/``
- Visit: ``http://127.0.0.1:8000/lab_members/``

*Version 0.3.0*