/djangocms-link

Link Plugin for django-cms

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

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.4 or above.

  • In your projects virtualenv, run pip install djangocms-link.
  • Add 'djangocms_link' to your INSTALLED_APPS setting.
  • Run manage.py migrate djangocms_link.

Warning

If upgrading for versions prior to 1.7, remove djangocms_link from MIGRATION_MODULES setting.

Warning

If using Django 1.6, you may need to eventually add 'djangocms_link': 'djangocms_link.south_migrations', to SOUTH_MIGRATION_MODULES

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/