djangocms-link-manager 0.2.1

概述

在django CMS中，有众多插件提供超链接功能，每个插件都有自己的字段来存储各种类型的超链接。因此，在项目整个范围内查找坏链接可能成为一项挑战。本项目试图以可扩展的方式提供解决方案。

安装

此软件包需要Python 2.7或更高版本以及Django 1.8或更高版本。

首先，从PyPI安装此软件包

pip install djangocms-link-manager

然后将它添加到您的INSTALLED_APPS

# settings.py
...
INSTALLED_APPS = [
    ...
    'djangocms_link_manager',
]

使用方法

运行此软件包最简单的方法是

python manage.py check_links

但是，此命令接受多个可选参数

--verify-exists     Check that each link's target exists (use caution,
                    makes HTTP HEAD requests).
--scheme SCHEME     Default scheme to use for scheme-less URLs
                    (default: "http").
--host NETLOC       Default [host:port] to use for relative URLs (defaults
                    to "localhost:8000").
--template TEMPLATE Override the report rendering template.
--mail-managers     Instead of printing report to the console, email it to
                    the addresses defined in the MANAGERS list in the
                    project's settings.py.

扩展

此包目前支持以下通过类名识别的插件：Bootstrap3ButtonCMSPlugin和LinkPlugin，分别来自aldryn_bootstrap3和djangocms_link包。要添加对新CMSPlugin的支持，只需创建一个继承自djangocms_link_manager.link_manager.LinkManager的类，并根据您希望支持的CMSPlugin的具体情况重写check_link()方法。

创建完成后，在启动时使用以下代码将链接管理器注册到链接管理器池中：

from djangocms_link_manager.link_manager import LinkManager, LinkReport
from djangocms_link_manager.link_manager_pool import link_manager_pool

class MyLinkPluginLinkManager(LinkManager):
    """MyLinkPlugin only contains the fields 'name' and 'url'."""

    def check_link(self, instance, verify_exists=False):
        """Override this method and adapt to MyLinkPlugin."""
        return LinkReport(
            valid=self.validate_url(instance.url, verify_exists=verify_exists),
            text=instance.name,
            url=instance.url
        )

link_manager_pool.register('MyLinkPlugin', MyLinkPluginLinkManager)

def validate_MYSCHEME(self, parts, verify_exists=False):
    # Do your thing here
    if valid:
        return True
    else:
        return False

parts = {
    'scheme': ...,
    'netloc': ...,
    'path': ...,
    'params': ...,
    'query': ...,
    'fragment': ...,
}