#gq:
# 导入正则表达式模块，用于匹配和处理HTML中的<a>标签
import re
# 导入URL解析模块，用于解析链接的域名等信息
from urllib.parse import urlparse
# 导入Django博客系统的插件基类，当前插件需继承此类实现标准化功能
from djangoblog.plugin_manage.base_plugin import BasePlugin
# 导入插件钩子管理模块，用于注册和触发插件功能
from djangoblog.plugin_manage import hooks
# 导入文章内容钩子常量，指定插件要作用的具体钩子位置
from djangoblog.plugin_manage.hook_constants import ARTICLE_CONTENT_HOOK_NAME


# 定义外部链接处理插件类，继承自插件基类BasePlugin
class ExternalLinksPlugin(BasePlugin):
    # 插件名称，用于在插件管理界面展示
    PLUGIN_NAME = '外部链接处理器'
    # 插件功能描述，说明插件的核心作用
    PLUGIN_DESCRIPTION = '自动为文章中的外部链接添加 target="_blank" 和 rel="noopener noreferrer" 属性。'
    # 插件版本号，用于版本管理和更新识别
    PLUGIN_VERSION = '0.1.0'
    # 插件作者信息
    PLUGIN_AUTHOR = 'liangliangyy'

    # 注册插件钩子的方法，插件加载时会自动调用
    def register_hooks(self):
        # 将当前插件的process_external_links方法，注册到文章内容处理钩子上
        # 意味着文章内容渲染前，会自动执行该方法处理链接
        hooks.register(ARTICLE_CONTENT_HOOK_NAME, self.process_external_links)

    # 核心方法：处理文章内容中的外部链接
    # 参数content为文章原始HTML内容，*args和**kwargs用于接收额外参数（预留扩展性）
    def process_external_links(self, content, *args, **kwargs):
        # 导入Django工具函数，用于获取当前网站的域名（如example.com）
        from djangoblog.utils import get_current_site
        # 获取当前网站的域名，用于判断链接是否为"外部链接"
        site_domain = get_current_site().domain

        # 定义正则表达式，用于匹配HTML中的<a>标签
        # 匹配规则：<a 开头 + 任意属性（可选） + href=" + 链接地址 + " + 剩余属性及闭合标签
        # re.IGNORECASE表示忽略大小写（如<A>和<a>都能匹配）
        link_pattern = re.compile(r'(<a\s+(?:[^>]*?\s+)?href=")([^"]*)(".*?/a>)', re.IGNORECASE)

        # 定义正则替换的回调函数，每匹配到一个<a>标签就会执行一次
        def replacer(match):
            # 拆分匹配结果为3个分组：
            # group(1)：<a 到 href=" 的部分
            # group(2)：href属性中的链接地址
            # group(3)：href=" 之后到 </a> 的部分
            href = match.group(2)

            # 检查当前<a>标签是否已包含target属性（不区分大小写，如Target或TARGET）
            # 若已存在target属性，则不做处理，直接返回原标签
            if 'target=' in match.group(0).lower():
                return match.group(0)

            # 解析当前链接地址，获取其域名、路径等结构化信息
            parsed_url = urlparse(href)

            # 判断链接是否为外部链接：
            # 1. parsed_url.netloc不为空（排除无域名的链接，如相对路径 /about）
            # 2. 链接的域名（netloc）不等于当前网站域名（site_domain）
            if parsed_url.netloc and parsed_url.netloc != site_domain:
                # 若为外部链接，在href闭合后添加 target="_blank"（新窗口打开）
                # 和 rel="noopener noreferrer"（安全属性，防止窗口劫持）
                return f'{match.group(1)}{href}" target="_blank" rel="noopener noreferrer"{match.group(3)}'

            # 若为内部链接（或无域名链接），不做修改，直接返回原标签
            return match.group(0)

        # 使用正则表达式替换文章内容中的所有<a>标签，执行replacer回调函数
        # 返回处理后的文章内容
        return link_pattern.sub(replacer, content)


# 实例化插件类，使插件系统能识别并加载该插件
plugin = ExternalLinksPlugin()