在实际使用Syndication Links插件的过程中，如果经常发布到一些插件默认不支持的网站，就会遇到无法显示对应站点图标和名称的问题。本文记录了如何通过不直接修改插件源文件的方式，为该插件增加新的站点映射与图标，以避免更新时丢失修改。

插件的站点映射机制

Syndication Links插件在includes/class-syn-link-domain-icon-map.php中维护了一个私有静态数组$map，用于将域名映射到对应的图标名。例如：

private static $map = array(
    'twitter.com'  => 'twitter',
    'facebook.com' => 'facebook',
    // ...
);

当页面需要显示某个链接的图标时，插件会：

1. 从URL提取域名
2. 检查$map数组是否有该域名的映射
3. 如果有，则按映射名去svgs目录中加载对应的SVG图标文件
4. 同时从includes/simple-icons.php的simpleicons_syn_get_names()函数获取该映射名对应的显示名称

如果$map中没有对应域名，插件会尝试根据域名的中间部分去找图标文件；如果仍找不到，就会显示一个默认的website图标。

要添加新的站点映射，需要改动三个地方

1. 域名映射表 在$map中添加新域名及其图标名，例如：

   'sanguok.com'         => 'wordpress',
   'chatan.cc'         => 'iceshrimp',
   'library.chatan.cc'         => 'bookwyrm',
   

2. 图标名称映射 在includes/simple-icons.php中的simpleicons_syn_get_names()函数中，添加新的图标名与显示名称，例如：

   'bookwyrm' => 'Bookwyrm',
   

3. SVG图标文件 在插件的svgs目录下放置与图标名一致的.svg文件，例如bookwyrm.svg。 文件内容需要是有效的SVG代码，来源可以是自己绘制的，或从SVG Repo等网站下载并调整。

避免插件更新覆盖修改

如果直接编辑插件的源文件，在更新插件后修改会丢失。 解决办法是使用Code Snippets插件，在运行时通过钩子动态扩展映射和图标名。

示例：通过Code Snippets扩展映射

<?php
// 扩展域名映射
add_filter('syn_link_mapping', function($mapped, $url) {
    $custom_map = array(
        'sanguok.com'         => 'wordpress',
        'chatan.cc'         => 'iceshrimp',
        'library.chatan.cc'         => 'bookwyrm',
    );

    $host = str_replace('www.', '', parse_url($url, PHP_URL_HOST));
    if (isset($custom_map[$host])) {
        return $custom_map[$host];
    }
    return $mapped;
}, 10, 2);

// 扩展图标名称映射
add_filter('simpleicons_syn_get_names', function($icons) {
    $icons['bookwyrm'] = 'Bookwyrm';
    return $icons;
});

说明：

• syn_link_mapping过滤器允许在插件完成映射后，动态修改映射结果
• simpleicons_syn_get_names是一个我们假设添加的过滤器，如果插件没有，需要通过其他方式覆盖函数返回值（可能需要额外包装）

关于SVG文件

• SVG文件必须放在插件svgs目录下，否则插件找不到。
• 更新插件时，svgs目录里的文件也可能被覆盖或删除，建议在更新前备份。

实际操作步骤

1. 准备好新的域名与图标名映射表
2. 准备对应的SVG文件
3. 将SVG文件放到插件的svgs目录中
4. 在WordPress后台Code Snippets插件中创建一个新的Snippet，将上面的PHP代码粘贴进去
5. 保存并启用Snippet
6. 刷新前台页面验证是否生效

总结

• 核心流程是域名 → 映射名 → SVG 图标 → 显示名称
• 不直接改插件源码，使用钩子和Code Snippets是比较安全的做法
• SVG文件仍然需要放在插件目录中，但要注意更新时备份
• 如果插件未来提供更灵活的API（例如允许自定义SVG路径），则可以完全不改动插件目录