django-lab-members

A Django app to display lab personnel and information about them.


License
BSD-3-Clause
Install
pip install django-lab-members==0.3.0

Documentation

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.

Installation

PyPI

pip install django-lab-members

GitHub (development branch)

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:

      INSTALLED_APPS = (
          # ...
          'lab_members',
          'easy_thumbnails',
          'filer',
          'mptt',
          'sekizai',
          'friendlytagloader',
      )
    • Specify your media settings, if not already specified:

      MEDIA_URL = '/media/'
      MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
    • Add easy_thumbnail settings:

      # 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:

        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:

        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:

      # ...
      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<path>.*)$', 'django.views.static.serve', {
              'document_root': settings.MEDIA_ROOT}))
    • For Django 1.8:

      # ...
      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:

python manage.py makemigrations lab_members
python manage.py migrate

Usage

  • Start the development server:
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