Joomla 4中如何移除URL中的组件视图名称

Joomla 4对SEF URL的路由规则进行了严格调整，导致原Joomla 3.x自定义组件的路由逻辑在J4中出现URL追加视图名的问题，以下是针对性的解决步骤：

• 修正组件路由文件
  找到组件根目录下的router.php，在buildRoute方法中添加菜单项匹配判断，当请求对应指定菜单项时移除view参数，避免URL中追加视图名称：

  public function buildRoute(&$query)
  {
      $segments = array();
      // 匹配目标菜单项
      if (isset($query['Itemid']) && $menu = JFactory::getApplication()->getMenu()->getItem($query['Itemid'])) {
          // 验证菜单项对应的视图为courses
          if ($menu->query['view'] === 'courses') {
              unset($query['view']);
              return $segments;
          }
      }
      // 保留原有其他路由逻辑
      // ...
      return $segments;
  }
  

• 检查组件配置与菜单项元数据

  1. 打开组件主配置文件com_course.xml，确认<view>节点的name属性与实际视图名courses完全一致，无拼写错误。
  2. 查看administrator/components/com_course/metadata/menu.xml，确保目标菜单项类型的query属性为view=courses，无多余参数。

• 刷新SEF缓存与路由规则

  1. 进入Joomla后台，依次点击「系统」→「清除缓存」，选择全部缓存并清理。
  2. 进入「系统」→「全局配置」→「SEO设置」，临时关闭「使用URL重写」并保存，随后重新开启，强制刷新路由映射。

• 检查菜单项高级设置
  编辑「kurse-nach-datum」菜单项，进入「高级」标签页，确认「URL后缀」为空，「附加参数」未手动添加view=courses参数。

内容的提问来源于stack exchange，提问作者Vishal Patel