Source

cmsplugin-news / README.txt

ALPHA

Name: cmsplugin-news
Description: A news plugin for django-cms
Download: http://bitbucket.org/MrOxiMoron/cmsplugin-news/

Requirements:
- django-cms-2.0: rev 2b59edde3cf1c140edfb14b544f2fbcbd56073f8
- django: 1.1.1
+ requirements for django-cms-2.0

Last tested with:
- django-cms-2.0: rev 2b59edde3cf1c140edfb14b544f2fbcbd56073f8
- django: 1.1.1

Setup
- make sure requirements are installed and properly working
- add cmsplugin_news to python path
- add 'cmsplugin_news' to INSTALLED_APPS
- run 'python manage.py syncdb'
- Add the cmsplugin_news.urls to the CMS_APPLICATIONS_URLS setting 
- Add the cmsplugin_news.navigation.get_nodes to the CMS_NAVIGATION_EXTENDERS setting
- Create a page and link the application and navigation to it. (Restart of the server required due to caching!)
- Create the propper templates for your site, the ones included with the app are VERY basic

Todo and Tomaybes:
- Use the textplugin's way of using a editor for the content (WYMEditor done, still needs tinymce)
- Add more tests
- add to cms_plugins.py for plugins
 - month view with days that link to archive_day view
- add setup.py for easyinstall / pip
- Allow comments on news (add option to the news model for it)
- Add migrations
- Optimize the navigation code, it works but there is probably a better way to do it.
- Add RSS feed
- Add excerpt
- Add optional author field
- Add optional end date to hide news again
- Add Tags
- Add translations (I can do the dutch one)
- Ideas other people come up with :D

Examples:

CMS_APPLICATIONS_URLS = (
    ('cmsplugin_news.urls', 'News'),
)
CMS_NAVIGATION_EXTENDERS = (
    ('cmsplugin_news.navigation.get_nodes','News navigation'),
)
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.