public
Description: A reusable django application for managing press releases and press coverage.
Homepage:
Clone URL: git://github.com/howiworkdaily/django-pressbox.git
django-pressbox / README
100644 50 lines (34 sloc) 2.411 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
Django-Pressbox
=================
 
This is a simple press item management application for your Django powered site.
 
Many projects I develop need a "press" section for their site. So instead of reinventing the wheel each time I've selected the features most share and created this reusable Django app. I also provided basic example app to get you started.
 
This app follows several "best practices" for reusable apps by allowing for template overrides and extra_context
arguments and such.
 
Features
===================
 
I'll add more details later, but for now the features are basic:
 
1. add press item(s).
2. add press categories to structure the display of press items.
3. add images to a press item. (I suggest using django-sorl to thumbnail images, etc)
4. add a downloadedable file to a press item.
5. allow both press categories and press items to honor manual sorting if set.
6. allow users to set press items to active/inactive to control their display on the site.
7. a template tag to easily specify the specific press category (via slug) you'd like to display and then iterate through associated press items.
 
Installation
============
 
1. add 'pressbox' directory to your Python path.
2. add 'pressbox' to your INSTALLED_APPS tuple found in your settings file.
3. execute ./manage.py syncdb to created database tables
4. Log into your admin and enjoy!
5. To customize the templates add a "pressbox" directory to your project's templates dir.
 
Example Site
============
 
I included an example site in the /example directory. You should be able to
simply execute './manage.py syncdb' and then './manage.py runserver' and have
the example site up and running. I assume your system has sqlite3 available -
it is set as the default database with the DATABASE_NAME = 'pressbox.db'
 
1. From the repository root directory execute "cd example" to jump into the example dir.
 
2. Execute './manage.py syncdb' (This assumes that sqlite3 is available as it is set as the default database with th DATABASE_NAME = 'pressbox.db'.)
 
3. Executing ./manage.py syncdb will load initial data for you, making use of the initial_data.json file found in the root of the example project directory.
 
4. Execute './manage.py runserver' and you will have the example site up and running. The home page will have links to get to the available views.
 
5. The admin is available at "/admin". Feel free to play around with it!