织梦如何快速获取顶级栏目类型？

这是一个非常实用且常用的函数,主要用于在模板文件（通常是 .htm 文件）中获取当前栏目或指定栏目的顶级父级栏目的名称。

函数基本信息

• 函数名: GetTopTypeName
• 核心文件: /include/helpers/extend.helper.php
• 功能: 获取指定栏目ID的顶级栏目名称。
• 返回值: 字符串，即顶级栏目的名称，如果找不到，则返回空字符串 。

函数源码分析

为了更好地理解和使用这个函数,我们来看一下它的实现代码（通常在 extend.helper.php 文件中）：

if (!function_exists('GetTopTypeName'))
{
    function GetTopTypeName($typeid)
    {
        global $dsql;
        if (empty($typeid)) {
            return '';
        }
        // 获取当前栏目的顶级栏目ID
        $topid = GetTopid($typeid);
        // 如果顶级栏目ID为空或等于自身（说明它本身就是顶级栏目），则直接查询当前栏目
        if (empty($topid) || $typeid == $topid) {
            $row = $dsql->GetOne("SELECT typename FROM `#@__arctype` WHERE id='$typeid'");
            if (is_array($row)) {
                return $row['typename'];
            } else {
                return '';
            }
        }
        // 否则，根据顶级栏目ID查询其名称
        $row = $dsql->GetOne("SELECT typename FROM `#@__arctype` WHERE id='$topid'");
        if (is_array($row)) {
            return $row['typename'];
        } else {
            return '';
        }
    }
}

代码逻辑解读：

1. 参数检查: 首先检查传入的栏目ID $typeid 是否为空，如果为空则直接返回空字符串。
2. 获取顶级ID: 调用另一个核心辅助函数 GetTopid($typeid) 来获取当前栏目 $typeid 的顶级栏目ID。GetTopid 会递归向上查找父级，直到找到没有父级的顶级栏目。
3. 判断是否为顶级栏目:
   • GetTopid 返回空，或者返回的ID和当前ID相同，说明这个 $typeid 本身就是一个顶级栏目。
   • 这种情况下,函数就直接查询 #@__arctype 表中 id 为 $typeid 的记录，获取其 typename 字段（栏目名称）并返回。
4. 查询顶级栏目名称: $typeid 不是顶级栏目，GetTopid 返回的就是它的顶级栏目ID $topid，函数会查询 #@__arctype 表中 id 为 $topid 的记录，获取其 typename 并返回。
5. 返回结果: 如果查询成功，返回栏目名称；如果查询失败（例如ID不存在），则返回空字符串 。

如何使用

这个函数通常在织梦的模板文件中使用,最常见的场景是在文章页（article_article.htm）或列表页（list_*.htm）中获取当前文章或所在列表的顶级栏目名称。

场景1：在文章详情页 (article_article.htm) 中使用

在文章详情页,当前文章的栏目ID可以通过全局变量 $typeid 获取。

{dede:field name='typeid' function="GetTopTypeName(@me)"/}

或者更直接的方式：

{dede:GetTopTypename function='GetTopTypeName(@me)'}
    {dede:field.name/}
{/dede:GetTopTypename}

注意：第一种写法（function="GetTopTypeName(@me)"）是更简洁和推荐的方式。@me 在这里代表了 field 标签的原始值，也就是 $typeid。

场景2：在栏目列表页 (list_*.htm) 中使用

在栏目列表页,当前栏目的ID可以通过全局变量 $typeid 获取，用法与文章页完全相同。

当前顶级栏目名称是：{dede:field name='typeid' function="GetTopTypeName(@me)"/}

场景3：在自定义页面或首页调用

如果你想在首页或其他地方调用指定栏目的顶级名称,你需要先知道那个栏目的ID，然后使用 GetTopTypeName 函数。

你想获取ID为 5 的栏目的顶级名称，可以在模板里通过PHP代码实现：

{dede:php}
    $topTypeName = GetTopTypeName(5);
    echo "ID为5的栏目的顶级名称是：" . $topTypeName;
{/dede:php}

常见问题与注意事项

1. 函数未定义错误

   • 现象: 在模板中使用时，页面报错 Fatal error: Call to undefined function GetTopTypeName()。
   • 原因: 最常见的原因是 /include/helpers/extend.helper.php 文件不存在或没有被正确加载，请检查你的织梦程序是否完整，或者这个文件是否被误删。
   • 解决: 从完整的织梦程序包中重新复制 extend.helper.php 文件到你的服务器上。

2. 返回空字符串

   • 现象: 函数正常执行，但没有输出任何内容，返回了空字符串 。
   • 原因:
     • 传入的 $typeid 是一个不存在的ID。
     • 数据库 #@__arctype 表中对应ID的记录被删除了。
     • 权限问题导致数据库查询失败。
   • 解决: 检查你传入的栏目ID是否正确，并确保数据库连接正常。

3. 性能考虑

   • GetTopTypeName 函数内部会执行一次数据库查询，如果你在一个循环（如 {dede:arclist}）中频繁使用它，可能会对数据库造成压力。
   • 优化建议: 如果在循环中需要多次获取同一个顶级栏目的名称，建议先获取一次顶级ID，然后缓存其名称，避免重复查询。

相关函数

了解 GetTopTypeName 的同时，最好也了解一下它的“兄弟”函数，它们在开发中经常配合使用：

• GetTopid($typeid): 获取指定栏目ID的顶级栏目ID，这是 GetTopTypeName 的基础。
• GetTopTypeid($typeid): 功能与 GetTopid 几乎完全一样，也是获取顶级栏目ID，它们通常在代码中是互为补充或可以互相替代的。
• GetSonIds($typeid, $action='son', $channelid=0): 获取指定栏目下的所有子级栏目的ID（以逗号分隔的字符串），常用于生成子栏目的SQL查询条件。

GetTopTypeName 是织梦CMS模板开发中一个基础且重要的函数，它的核心作用是“向上追溯”，轻松获取任意栏目的顶级父级名称，这对于制作面包屑导航、栏目高亮、或者根据顶级栏目进行分类显示等场景非常有帮助，掌握它的用法，能让你在织梦模板开发中更加得心应手。