Skip to main content

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

Project description

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.

Installation

PyPI

pip install djangocms-lab-carousel

GitHub (development branch)

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:

      <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.x.x/css/bootstrap-theme.min.css">
      
  • Do the following in settings.py:

    • Add cms_lab_carousel and its dependencies to INSTALLED_APPS:

      INSTALLED_APPS = (
          # ...
          'cms_lab_carousel',
          'cms_lab_publications',
          'easy_thumbnails',
          'filer',
          'mptt',
          'taggit',
      )
      
    • 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'
      

Migrations

Create and perform migrations cms_lab_carousel and its dependencies:

python manage.py makemigrations cms_lab_carousel
python manage.py makemigrations cms_lab_publications
python manage.py migrate

Usage

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

Revision History

0.2.1 2015-12-07

  • Set slide’s publication date based on article’s publication date
  • Prevent deletion of publication that is being used by a slide
  • On carousel deletion, set slide’s carousel field to null
  • Show (and sort by) # of slides in carousel admin’s list display
  • Add save buttons to top of carousel admin
  • Minor behind-the-scenes improvements
  • Update README with more complete and accurate instructions
  • Prepare for distribution via PyPI

0.2.0 2015-08-27

  • Allow linking from a slide to a journal article (djangocms-lab-publication)
  • Configure bumpversion & wheel for easier distribution

0.1.4 2015-05-08

  • Add optional CMS page link button for slides

0.1.3 2015-04-21

  • Make minor improvements to styling

0.1.2 2015-04-19

  • Make minor improvements to styling

0.1.1 2015-04-17

  • Correct app name in setup.py

0.1.0 2015-04-17

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

Project details


Release history Release notifications

This version

0.2.1

Download files

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

Files for djangocms-lab-carousel, version 0.2.1
Filename, size & hash File type Python version Upload date
djangocms_lab_carousel-0.2.1-py32-none-any.whl (16.4 kB) View hashes Wheel 3.4
djangocms-lab-carousel-0.2.1.tar.gz (11.0 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page