Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Link Plugin for django-cms
Python HTML

README.rst

djangocms-link

A Link plugin for django CMS.

Installation

This plugin requires django CMS 3.0 or higher to be properly installed and configured. If you have many pages it supports ajax loading for selecting a page. To enable this install Django-Select2 3.1.2 or above.

  • In your projects virtualenv, run pip install djangocms-link.
  • Add djangocms_link' to your INSTALLED_APPS setting.
  • If using Django 1.7 add 'djangocms_link': 'djangocms_link.migrations_django', to MIGRATION_MODULES (or define :code:`MIGRATION_MODULES` if it does not exists); when django CMS 3.1 will be released, migrations for Django 1.7 will be moved to the standard location and the south-style ones to south_migrations.
  • Run manage.py migrate djangocms_link.

If you want to enable the ajax loading:

  • In your projects virtualenv, run pip install Django-Select2.
  • Add 'django_select2 to your INSTALLED_APPS settings.
  • Add url(r'^select2/, include('django_select2.urls')), to your main urls.py.

Settings

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:
DJANGOCMS_LINK_INTRANET_HOSTNAME_PATTERN = r'[a-z,0-9,-]{1,15}'

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

Either of these might accept a URL such as:

http://SEARCHHOST/?q=some+search+string

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

Children

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.

Translations

If you want to help translate the plugin please do it on transifex:

https://www.transifex.com/projects/p/djangocms-link/resource/djangocms-link/

Something went wrong with that request. Please try again.