djangocms-link 0,0 editorconfig travis-ci python

django CMS Link is a plugin for django CMS that allows you to add links on your site.

3 years after BSD-3-Clause

=============== django CMS Link

|pypi| |build| |coverage|

django CMS Link is a plugin for django CMS <>_ that allows you to add links on your site.

This plugin supports child plugins. If you add an other plugin as a child it will take this content instead of the link name as the content of the link.

This addon is compatible with Aldryn <> and is also available on the django CMS Marketplace <> for easy installation.

.. image:: preview.gif


This is a an open-source project. We'll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our contribution guidelines <>_.

One of the easiest contributions you can make is helping to translate this addon on Transifex <>_.


See REQUIREMENTS in the <>_ file for additional dependencies:

  • Python 2.7, 3.3 or higher
  • Django 1.8 or higher


For a manual install:

  • run pip install djangocms-link
  • add djangocms_link to your INSTALLED_APPS
  • run python migrate djangocms_link


Note that the provided templates are very minimal by design. You are encouraged to adapt and override them to your project's requirements.

This addon provides a default template for all instances. You can provide additional template choices by adding a DJANGOCMS_LINK_TEMPLATES setting::

    ('feature', _('Featured Version')),

You'll need to create the feature folder inside templates/djangocms_link/ otherwise you will get a template does not exist error. You can do this by copying the default folder inside that directory and renaming it to feature.

To support environments where non-standard URLs would otherwise work, this project supports the defining of an additional RegEx pattern for validating the host-portion of the URL.

For example: ::

# RFC1123 Pattern:

# NetBios Pattern:
DJANGOCMS_LINK_INTRANET_HOSTNAME_PATTERN = r'[a-z,0-9,[email protected]#$%^()\\-\'{}.~]{1,15}'

Either of these might accept a URL such as: ::


If left undefined, the normal Django URLValidator will be used.

Django Select2

This plugin supports `django-select2 <>`_
for simpler use of internal links. We **do not support 5.x**, this is why you
need to manually configure this feature:

* run ``pip install django-select2>=4.3,<5.0``
* add ``django_select2`` to your ``INSTALLED_APPS``
* add ``url(r'^select2/', include('django_select2.urls')),`` to your ````
* set ``DJANGOCMS_LINK_USE_SELECT2 = True`` in your ````

Running Tests

You can run tests by executing::

    virtualenv env
    source env/bin/activate
    pip install -r tests/requirements.txt
    python test

.. |pypi| image::
.. |build| image::
.. |coverage| image::

Related Repositories



A curated list of awesome django-cms add-ons. You should also checkout: https:// ...



A curated list of awesome CSS frameworks, libraries and software. ...



Restructured Text Plugin for the django CMS ...



A Django CMS plugin that provides responsive, full screen background media with ...



customizing django and django-cms to my likes ...

Top Contributors

yakky digi604 mkoistinen FinalAngel stefanfoulis morganwahl czpython vxsx chronossc jsma Chive evildmp brente donce briandant jedie ojii grigno sephii fp4code fygul otg-sandrey rda-dev


-   2.0.1 zip tar
-   2.0.0 zip tar
-   1.8.3 zip tar
-   1.8.2 zip tar
-   1.8.1 zip tar
-   1.8.0 zip tar
-   1.7.2 zip tar
-   1.7.1 zip tar
-   1.7.0 zip tar
-   1.6.2 zip tar
-   1.6.1 zip tar
-   1.6 zip tar
-   1.5 zip tar
-   1.4.0 zip tar
-   1.3.5 zip tar
-   1.3.4 zip tar
-   1.3.3 zip tar
-   1.3.2 zip tar
-   1.3.1 zip tar
-   1.3 zip tar
-   1.2 zip tar
-   1.1.3 zip tar
-   1.1.2 zip tar
-   1.1.1 zip tar
-   1.1 zip tar
-   1.0.6a1 zip tar
-   1.0.5 zip tar