semvec/pypi-packages huggingface dataset:
django-linklist 0.4
Django app to render a list of links with some meta information and a screenshot.
License: The MIT License
Keywords: django,links,linklist,reusable

CMSplugin Linklist
==================

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.


Prerequisites
-------------

You need at least the following packages in your virtualenv:

* Django 1.4
* South
* Filer
* Pillow or PIL
* Easy Thumbnails


Installation
------------

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


Usage
-----

Add links to your project via the Django admin.


Templatetags
------------

get_linklist
++++++++++++

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 %}


Roadmap
-------

See the issue tracker for current and upcoming features.