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

A Django app for adding a carousel of recent papers, etc. to a Django site with django CMS-specific features
https://github.com/mfcovington/djangocms-lab-carousel

Last synced: 11 months ago
JSON representation

A Django app for adding a carousel of recent papers, etc. to a Django site with django CMS-specific features

• Host: GitHub
• URL: https://github.com/mfcovington/djangocms-lab-carousel
• Owner: mfcovington
• License: bsd-3-clause
• Created: 2015-04-16T17:30:48.000Z (over 11 years ago)
• Default Branch: develop
• Last Pushed: 2016-09-03T15:22:19.000Z (almost 10 years ago)
• Last Synced: 2025-07-17T15:02:17.216Z (about 1 year ago)
• Language: Python
• Homepage: https://pypi.python.org/pypi/djangocms-lab-carousel/
• Size: 55.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

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

djangocms-lab-carousel

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

``djangocms-lab-carousel`` is a Django app for adding a carousel of recent papers, etc. to a Django site with django CMS-specific features. It uses ``djangocms-lab-publications`` manage publications.

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

.. contents:: :local:

Installation

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

**PyPI**

.. code-block:: sh

    pip install djangocms-lab-carousel

**GitHub (development branch)**

.. code-block:: sh

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

Configuration

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

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

        

- Do the following in ``settings.py``:

  - Add ``cms_lab_carousel`` and its dependencies to ``INSTALLED_APPS``:

    .. code-block:: python

        INSTALLED_APPS = (

            # ...

            'cms_lab_carousel',

            'cms_lab_publications',

            'colorfield',

            'easy_thumbnails',

            'filer',

            'mptt',

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

Migrations

==========

Create and perform migrations ``cms_lab_carousel`` and its dependencies:

.. code-block:: sh

    python manage.py makemigrations cms_lab_carousel

    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.

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

*Version 0.2.1*