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

A Django app to extend django-lab-members with django CMS-specific features
https://github.com/mfcovington/djangocms-lab-members

Last synced: 12 days ago
JSON representation

A Django app to extend django-lab-members with django CMS-specific features

• Host: GitHub
• URL: https://github.com/mfcovington/djangocms-lab-members
• Owner: mfcovington
• License: bsd-3-clause
• Created: 2015-04-10T21:45:28.000Z (over 11 years ago)
• Default Branch: develop
• Last Pushed: 2018-02-03T20:37:35.000Z (over 8 years ago)
• Last Synced: 2026-03-30T12:05:57.318Z (4 months ago)
• Language: Python
• Homepage: https://pypi.python.org/pypi/djangocms-lab-members/
• Size: 42 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
*********************

djangocms-lab-members

*********************

``djangocms-lab-members`` is a Django app to extend ``django-lab-members`` with django CMS-specific features.

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

.. contents:: :local:

Installation

============

**PyPI**

.. code-block:: sh

    pip install djangocms-lab-members

**GitHub (development branch)**

.. code-block:: sh

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

Configuration

=============

- Ignore instructions for `django-lab-members `_, the non-django CMS app that this app extends.

- `Install django CMS and start a project `_, if one doesn't already exist.

- Unless you use this app as part of `djangocms-lab-site `_ or plan to style the app from scratch, you will want to choose the ``Use Twitter Bootstrap Theme`` option (when running ``djangocms``) and then edit the resulting ``templates/base.html``.

  - This will add style that looks like Bootstrap 2. To use Bootstrap 3 styling, remove the following line for the ``bootstrap-theme.min.css`` stylesheet from ``templates/base.html``:

    .. code-block:: python

        

  - The default menu settings for django CMS using Bootstrap will allow the user to access specific lab members via a dropdown menu, but will not give easy access to the summary page of all lab member. To fix this do one of the following:

    - In ``templates/base.html``, change ``{% show_menu 0 1 100 100 "menu.html" %}`` to ``{% show_menu 0 0 100 100 "menu.html" %}``, or

    - Use a split button dropdowns by changing that line to `{% show_menu 0 100 1 1 '_menu.html' %}` and populate `_menu.html` as done in `djangocms-lab-site `_.

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

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

    .. code-block:: python

        INSTALLED_APPS = (

            # ...

            'cms_lab_members',

            'cms_lab_publications',

            'easy_thumbnails',

            'filer',

            'friendlytagloader',

            'lab_members',

            'taggit',

        )

  - 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'

  - Pre-populate placeholder content for research/personal interests and sidebar:

    .. code-block:: python

        # Pre-populate placeholder content

        CMS_PLACEHOLDER_CONF = {

            # ...

            'research interests': {

                'default_plugins': [

                    {

                        'plugin_type': 'TextPlugin',

                        'values': {

                            'body':"
[Enter 'Edit Mode' and double-click here to add your research interests.]
",

                        },

                    },

                ],

            },

            'personal interests': {

                'default_plugins': [

                    {

                        'plugin_type': 'TextPlugin',

                        'values': {

                            'body':"
[Enter 'Edit Mode' and double-click here to add your personal interests.]
",

                        },

                    },

                ],

            },

            'scientist sidebar': {

                'default_plugins': [

                    {

                        'plugin_type': 'TextPlugin',

                        'values': {

                            'body':"
[Enter 'Edit Mode' and double-click here to add sidebar content.]
",

                        },

                    },

                ],

            },

        }


Migrations

==========

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

.. code-block:: sh

    python manage.py makemigrations cms_lab_members

    python manage.py makemigrations lab_members

    python manage.py makemigrations cms_lab_publications

    python manage.py migrate

Usage

=====

- Start the development server:

.. code-block:: sh

    python manage.py runserver

- Visit: ``http://127.0.0.1:8000/``

- Create a CMS page and then:

  - Attach the ``Lab Members App`` under ``Advanced Settings`` for the page, **OR**

  - Insert the ``Scientist Plugin`` into a placeholder field.

*Version 0.2.0*