Django app to render a list of links with meta information and screenshots.
Please note that this repo contains the same code as cmsplugin-linklist. We will remove the Link-model related code from that repo soon so that the cmsplugin repo only contains the cmsplugin relevant code.
You need at least the following packages in your virtualenv:
- Django 1.4
- South
- Filer
- Pillow or PIL
- Easy Thumbnails
To get the latest stable release from PyPi:
$ pip install django-linklist (not available at the moment)
To get the latest commit from GitHub:
$ pip install -e git://github.com/bitmazk/django-linklist.git#egg=linklist
Add the app to your INSTALLED_APPS:
INSTALLED_APPS = [
...
'django',
'filer',
'easy_thumbnails',
'linklist',
]
Run the south migrations to create the app's database tables:
$ ./manage.py migrate linklist
Add links to your project via the Django admin.
Returns a number of links:
{% load linklist_tags %}
{% get_linklist 8 as linklist %}
{% for link in linklist %}
// YOur HTML markup
{% endfor %}
If you are using the LinkCategory model, you can get the links for a
cateogry like so:
{% get_linklist 8 categories='slug' as linklist %}
If you want to show links for several categories in one list:
{% get_linklist 8 categories='foo,bar' as linklist %}
See the issue tracker for current and upcoming features.