README

本模块用于将类别、产品、内容或文件夹关联到一个或多个关键词。例如，您可以基于特定关键词显示项目，或使用标签系统组织页面。

如何安装

此模块必须位于您的 modules/ 目录中（thelia/local/modules/）。

您可以下载此模块的 .zip 文件，或像这样在项目中创建一个 git 子模块：

cd /path-to-thelia
git submodule add https://github.com/thelia-modules/Keyword.git local/modules/Keyword

接下来，转到 Thelia 管理面板以激活模块。

如何更新

在更新之前，请保存您的数据库。

如果您的模块版本是 2.3.x，并且您想更新到 2.4.x 版本，您必须使用 keyword:update 命令。 此命令仅从 v2.4.4 版本开始可用。

• 在保存您的数据库后，停用 Keyword 模块
• 用新文件替换 local/modules/Keyword 中的所有文件
• 激活新的 Keyword 模块：如果未执行，则将除 keyword_group_associated_keyword 表外的所有 keyword 模块表清空
• 通过 phpmyadmin 重新插入 Keyword 模块表数据（content_associated_keyword、folder_associated_keyword、category_associated_keyword、product_associated_keyword、keyword_group、keyword_group_i18n、keyword 和 keyword_i18n 的数据）
• 运行 Keyword 模块命令： keyword:update

将更新旧关联，并删除过时的 keyword_group_associated_keyword 表。

如何使用

您可以在模块的配置视图中通过模块列表上的“配置”按钮管理您的关键词。

要将一个或多个关键词关联到内容或文件夹，请转到内容或文件夹编辑视图的“模块”选项卡。

此模块允许您使用 6 个新循环：keyword_category、keyword_product、keyword_content、keyword_folder、keyword_group 和 keyword。

以下是使用每个循环的示例

使用 keyword_category 循环（与 "my_keyword" 关键词相关的类别列表）

{loop name="categories" type="keyword_category" keyword="my_keyword" association_order="manual_reverse"}
    ...
{/loop}

使用 keyword_product 循环（与 "my_keyword" 关键词相关的产品列表）

{loop name="products" type="keyword_product" keyword="my_keyword" association_order="manual_reverse"}
    ...
{/loop}

使用 keyword_content 循环（与 "my_keyword" 关键词相关的内容列表）

{loop name="contents" type="keyword_content" keyword="my_keyword" folder="1" association_order="manual_reverse"}
    ...
{/loop}

使用 keyword_folder 循环（与 "my_keyword" 关键词相关的文件夹列表）

{loop name="folders" type="keyword_folder" keyword="my_keyword"}
    ...
{/loop}

使用 keyword_category 循环（与 "my_keyword" 关键词相关的类别列表）

{loop name="categories" type="keyword_category" keyword="my_keyword"}
    ...
{/loop}

使用 keyword_product 循环（与 "my_keyword" 关键词相关的产品列表）

{loop name="products" type="keyword_product" keyword="my_keyword"}
    ...
{/loop}

使用 keyword 循环（列出所有可见关键词）

{loop name="keyword_list" type="keyword" visible="*" order="manual" backend_context="1" lang=$lang_id}
    ...
{/loop}

使用 keyword group 循环（列出所有可见关键词组）

{loop name="keyword_group_list" type="keyword_group" visible="*" order="manual" backend_context="1" lang=$lang_id}
    ...
{/loop}

您还可以通过使用本插件最新版本中可用的 Smarty 扩展来检查关键词与类别、产品、文件夹或内容之间的关联

检查 thelia 对象是否与 "my_keyword" 关键词相关

{category_has_keyword category_id=$ID keyword_code="my_keyword"} {* return true/false if relation exist or not *}
{product_has_keyword product_id=$ID keyword_code="my_keyword"}
{folder_has_keyword folder_id=$ID keyword_code="my_keyword"}
{content_has_keyword content_id=$ID keyword_code="my_keyword"}