Registry / web-framework / djangocms-link

djangocms-link

library5.1.1pypypiunverified

Adds a link plugin to django CMS, allowing editors to create links to internal pages, external URLs, mailto, telephone, and anchors. Current version 5.1.1, requires Python >=3.9, follows django CMS's release cadence.

web-framework database

pip install djangocms-link

github ↗package ↗

INSTALL

IMPORT

SIG · DJANGOCMS-LINK

djangocms-link

web-frameworkpythonv5.1.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

LinkPlugin

✓ from djangocms_link.models import LinkPlugin

✗ from djangocms_link.models import LinkPlugin

Add djangocms_link to INSTALLED_APPS, then migrate and collect static files.

INSTALLED_APPS = [ ... 'djangocms_link', ] # Then run: # python manage.py migrate djangocms_link # python manage.py collectstatic

Debug

Known issues

breakingVersion 5.0 introduced a new Link widget and JSON endpoint. If you have custom templates or subclass the plugin, you may need to adapt to the new widget implementation.

fix

Review the new widget and endpoint; update any custom code that relied on the old form field or internal URL generation.

affects: >=5.0.0

deprecatedThe `cms_plugins.LinkPlugin` import is deprecated. Use `djangocms_link.models.LinkPlugin` instead.

fix

Change import to from djangocms_link.models import LinkPlugin.

affects: >=5.0.0

gotchaPlugin fails silently on uninstalled apps or models (e.g., missing django-cms). Ensure django CMS is properly installed and in INSTALLED_APPS.

fix

Verify django CMS installation: 'django-cms' in INSTALLED_APPS and run migrations.

affects: >=5.1.0

gotchaThe 'to_url' template tag now accepts model objects as parameters (since 5.1.0). Passing unsupported types will raise errors.

fix

Ensure you pass a valid model instance (e.g., Page) or string URL to the tag.

affects: >=5.1.0

Upgrade

Version history

5.1.1latest on PyPI · released Feb 26, 2026

Audit

Dependencies

django-cmsrequiredCore dependency; the plugin is built for django CMS.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/django-cms/djangocms-link ↗

packagehttps://pypi.org/project/djangocms-link/ ↗