README

TOXID cURL 允许您将动态 CMS 内容加载到您的 OXID eShop 中。它保留了您从 CMS 中的用户友好的 URL，您可以将产品作为内容类型添加，它们也将从您的商店动态加载。

神奇！

那么让我们开始吧！

请注意：我们在 GitHub 上进行开发。为了确保获取最新版本，请查看那里

https://github.com/jkrug/TOXID-cURL

它是什么

从任何 XML 源渲染 CMS 页面和导航
调整源链接 URL

它不是什么

没有单点登录（因此不可能有受限页面）查看 TOXID 与 OxAPI
没有现成解决方案

系统要求

从版本 1.5 开始，最低 OXID 版本应为 4.6。这是因为我们可以删除自动加载器，并将几乎所有内容保留在模块目录中。基本主题也不再受支持。

如果您想用于任何较旧的 OXID eShop 版本，请查看上一个版本。

安装和配置

1 从模块复制文件到 /modules/toxid_curl/

2 在管理员中激活模块

3 设置您的 CMS 以提供 UTF-8 XML 格式的页面

<?xml version="1.0"?>
<toxid>
    <part1></part1>
    <part2></part2>
</toxid>

强烈建议将您的片段/部分包装在 CDATA 中，以防止 XML 错误

对于 WordPress，将“永久链接”设置更改为使用 SEO URL，例如通过条目名称（http://blog.mysite.com/content1），并确保调整 WordPress .htaccess 以允许 URL 重写。

4 在“扩展”>“TOXID 配置”中配置您的系统

具体来说，添加 CMS 的 URL 并在“URL 标识符/SEO 片段：”中输入 URL，例如“博客”。即使您只使用一种语言，也要为另一种语言输入值！否则，互联网可能会爆炸，或者至少您将获得商店中每个页面的博客内容。 :)

此外，确保在 CMS URL 的末尾添加一个“/”，例如“http://blog.mysite.com/”，否则您将在博客 URL 中得到双斜杠（“../Blog//foo-bar”）。

5 现在您可以像这样通过组件调用片段

[{assign var='toxid' value=$oViewConf->getToxid()}]
[{ $toxid->getCmsSnippet(part1) }]

请注意，搜索关键字将被附加在末尾

在 tpl/search.tpl（如果您使用基本主题）或 tpl/page/search/search.tpl 中添加以下代码

[{assign var='toxid' value=$oViewConf->getToxid()}]
[{assign var='typo3result' value=$toxid->getSearchResult($oView->getSearchParamForHtml())}]
[{if $typo3result}]
    <div>
        [{$typo3result}]
    </div>
[{/if}]

6 使用 OXID 的文件缓存将片段集成到导航中

当在 OXID eShop 的无处不在的部分使用片段时，您可能不想让 TOXID 在每个商店请求时都请求您的 CMS。在这种情况下，您可以使用 TTL 参数来缓存解析的片段标记一段时间

[{assign var='toxid' value=$oViewConf->getToxid()}]
[{ $toxid->getCmsSnippet('cms_navigation', false, null, 1800) }]

这将在 OXID 的文件缓存中存储请求的片段 30 分钟（1800 秒）。具有相同参数签名的后续调用将来自文件缓存，直到满足以下条件之一

给定 TTL 已过期
CMS 已在先前没有 TTL 参数的片段调用中查询。因此，当通过 toxid_curl 控制器请求内容页面时，带有 TTL 的片段调用将来自新鲜加载的 CMS 响应而不是缓存内容
当请求头 Cache-Control: no-cache 设置时。这样，您可以通过在浏览器中按 ctrl + shift + R 来刷新缓存片段
当清除 OXID 的 tmp/compile 目录时

有关 TTL 处理的更多信息，请参阅 oxUtils::toFileCache()

7 设置 WordPress 的预览功能！

从以下仓库安装toxid-preview WordPress插件：https://github.com/jkrug/wordpress-toxid 在WordPress仪表板->设置->常规中设置预览密码“预览密码”后，前往Oxid Admin中的Toxid设置。

在输入框“Admin URL 参数”中粘贴“preview=true&toxid-preview=”，其中“toxid-preview”获取您在WordPress中设置的密码。

将CMS特定的URL参数添加到输入框“允许的CMS特定参数”中，例如“p”用于WordPress。

最后，使用管理员用户登录商店前端，在您的博客中您也将看到当前是草稿的帖子。

4 实现WordPress的内容小工具！

创建一个名为“toxid-content-widget”的新WordPress页面和一个名为“page-toxid-content-widget.php”的新模板文件。

根据需要调整此模板。

在您的商店模板中实现以下代码片段以显示新内容页面的内容

[{oxid_include_widget cl='toxid_curl_content_widget'}]

9 调整您的模板！

测试数据

为了测试目的，我们添加了一些测试数据。

当然，您也可以用于调试。

使用非常简单。配置为toxid-source

德语：https:///modules/toxid_curl/tests/data/de/

英语：https:///modules/toxid_curl/tests/data/en/

我们已经实现的内容

完成：多语言支持
完成：缓存
完成：将产品作为CMS内容添加，由OXID渲染
CMS演示模板
完成：通过管理区域进行配置

ecs / toxid_curl

维护者

详细信息