Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Django App to easily manage project sponsors

Project Description

Django App to easily manage Django projects sponsors

Documentation

The full documentation is at https://django-sponsors.readthedocs.org.

Installation

Install Django Sponsors:

  1. Using pip:

    pip install django-sponsors
    
  2. Add the sponsors application to INSTALLED_APPS in your settings file:

    INSTALLED_APPS = (
        ...
        'sponsors',
        ...
    )
    
  3. Sync database:

    ``$ ./manage.py syncdb``  and
    ``$ ./manage.py migrate``
    

Important: South 1.0 or greater is required to run migrations.

  1. Run the collectstatic management command:

    ``$ /manage.py collectstatic``
    

This will copy static sponsors.css into the directory given by the STATIC_ROOT setting.

  1. Load in your template the sponsors.css file like this:

    <link rel="stylesheet" href="{% static "sponsors/css/sponors.css" %}">
    

This will copy static sponsors.css into the directory given by the STATIC_ROOT setting.

  1. [OPTIONAL] Add sponsors urls into your project’s urls.py file:

    (r'^sponsors/', include('sponsors.urls')),
    

This will give url access to sponsors’ views, not many in the very firsts versions :-(

Usage

Then use it in a project:

To show all sponsors in uncategorized way:

{% show_sponsors %}

To show only platinum sponsors with its default platinum styles (see sponsors.css):

{% show_sponsors 'platinum' %}

To show gold and silver sponsors with their default gold and silver styles (see sponsors.css):

{% show_sponsors 'gold,silver' %}

Settings

  • SPONSOR_EXPIRATES = False
  • SPONSOR_EXPIRE_ON_MONTHS = 12
  • SPONSOR_LOGO_WIDTH = 200
  • SPONSOR_LOGO_HEIGHT = None

Features

  • Template Tags
  • Models

Tests

To run the tests on ‘sponsors’ application, simply type the following command:

$ python manage.py test sponsors

TODOs

  • add more kind of representations (columns, with descriptions, titles, …)
  • coverage 100%
  • test logo custom sizes
  • test logo sizes by cats
  • test background colors by cats
  • Become a Sponsor View
  • Become a Sponsor Form
  • Custom logo size and create thumbnail automatically

Contributing

Check the tips at CONTRIBUTING.

Change log

Check the history changes CHANGELOG.

License

MIT License. See LICENSE.

History

0.1.2 (2015-07-04)

  • Renaming ‘type’ field to ‘category’

0.1.1 (2015-05-28)

  • First REAL release on PyPI :-)

0.1.0 (2015-05-27)

  • First release on PyPI.
  • Basic Sponsor model
  • First version of templatetag
  • Some tests on model, view and templatetag
  • Optional default logo’s width and height in settings
  • Basic styles
  • Admin customized
  • Includes a ListView of Sponsors
Release History

Release History

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.1a1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-sponsors-0.1.2.tar.gz (11.9 kB) Copy SHA256 Checksum SHA256 Source Jul 4, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting