Joomla4模板XML表单如何添加字段选择现有文章并获取URL

原生字段直接可用 #

你预期的type="article"字段写法是可行的，该字段是Joomla4内容组件自带的标准表单字段，仅未在通用表单字段文档中列出，实际可直接在模板配置XML中使用，渲染效果和菜单编辑页的文章选择器完全一致。
正确的字段定义示例（写入templateDetails.xml的配置表单字段组中即可）：

<field 
  name="linktomyarticle" 
  type="article" 
  label="选择目标文章" 
  description="选择要跳转的隐私政策、网站声明类文章"
/>

该字段保存后存储的值为选中文章的数字ID，不会直接存储URL。

前台获取文章访问URL的方法 #

不要手动拼接文章链接，使用Joomla原生路由类生成自动适配SEF规则的正确访问地址，在模板的index.php中加入以下代码即可：

use Joomla\CMS\Factory;
use Joomla\CMS\Router\Route;
use Joomla\Component\Content\Site\Helper\RouteHelper;

// 加载当前模板的配置参数
$tplParams = Factory::getApplication()->getTemplate(true)->params;
// 读取配置中保存的文章ID
$articleId = (int)$tplParams->get('linktomyarticle', 0);
$articleUrl = '';

if ($articleId > 0) {
    // 生成符合站点URL规则的可访问链接
    $articleUrl = Route::_(RouteHelper::getArticleRoute($articleId));
}

// 前台调用示例：
// <a href="<?php echo $articleUrl; ?>">隐私政策</a>

异常情况备选方案 #

如果遇到article字段加载失败的情况，可以直接替换为Joomla4另一个原生的文章选择字段modal_article，该字段为弹窗选择交互，和菜单配置页的文章选择逻辑完全一致，存储值同样为文章ID，前台获取链接的代码无需修改，字段写法如下：

<field 
  name="linktomyarticle" 
  type="modal_article" 
  label="选择目标文章" 
  description="点击弹出窗口选择对应文章"
/>

不推荐使用普通文本/数字字段让用户手动填写文章ID或链接，交互体验差且容易出现链接失效、SEF规则不兼容的问题。

内容的提问来源于stack exchange，提问作者Gratia-Mira