印前检查设置
要启用 AEM Sites Optimizer 的预检功能,需要在通用编辑器、基于文档的预览,或 AEM Cloud Service 中设置预检功能扩展,以便在页面发布前执行预检审计。
启用用户访问权限
要使用预检扩展,请确保您的用户在 Adobe Admin Console 中被分配到以下 AEM Sites Optimizer 产品轮廓中的至少一个:
- AEM Sites Optimizer - 自动建议用户
- AEM Sites Optimizer - 自动优化用户
启用预检功能扩展
若要在通用编辑器中设置预检功能,请执行以下步骤:
-
打开 Extension Manager:
https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor -
找到 AEM Sites Optimizer 预检功能扩展,并提交启用请求。
-
Adobe AEM 团队 将会审核并为您的组织启用该扩展。
-
扩展启用后,在 通用编辑器 中打开某个页面,例如:
https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html -
预检功能扩展 将在 侧边栏 中显示。
-
从侧边栏中选择 预检功能扩展,即可开始对当前页面执行 预检审计。
要为基于文档的创作设置预检功能,请执行以下步骤:
-
在 Edge Delivery Services 项目的 GitHub 存储库中,将以下配置添加到
/tools/sidekick/config.json文件:code language-json { "plugins": [ { "id": "preflight", "titleI18n": { "en": "Preflight" }, "environments": ["preview"], "event": "preflight" } ] } -
新建文件
/tools/sidekick/aem-sites-optimizer-preflight.js,并添加以下内容:code language-javascript (function () { let isAEMSitesOptimizerPreflightAppLoaded = false; function loadAEMSitesOptimizerPreflightApp() { const script = document.createElement('script'); script.src = 'https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=plugin'; script.onload = function () { isAEMSitesOptimizerPreflightAppLoaded = true; }; script.onerror = function () { console.error('Error loading AEMSitesOptimizerPreflightApp.'); }; document.head.appendChild(script); } function handlePluginButtonClick() { if (!isAEMSitesOptimizerPreflightAppLoaded) { loadAEMSitesOptimizerPreflightApp(); } } // Sidekick V1 extension support const sidekick = document.querySelector('helix-sidekick'); if (sidekick) { sidekick.addEventListener('custom:preflight', handlePluginButtonClick); } else { document.addEventListener('sidekick-ready', () => { document.querySelector('helix-sidekick') .addEventListener('custom:preflight', handlePluginButtonClick); }, { once: true }); } // Sidekick V2 extension support const sidekickV2 = document.querySelector('aem-sidekick'); if (sidekickV2) { sidekickV2.addEventListener('custom:preflight', handlePluginButtonClick); } else { document.addEventListener('sidekick-ready', () => { document.querySelector('aem-sidekick') .addEventListener('custom:preflight', handlePluginButtonClick); }, { once: true }); } }()); -
在
/scripts/scripts.js文件中更新loadLazy()函数,以导入适用于预览 URL 的预检功能脚本:code language-javascript if (window.location.href.includes('.aem.page')) { import('../tools/sidekick/aem-sites-optimizer-preflight.js'); } -
打开需要审计页面的预览 URL(
*.aem.page)。 -
在 Sidekick 中点击 预检 功能按钮,即可开始对当前页面进行审计。
要在 AEM Sites 页面编辑器中使用预检功能,您可以在 Web 浏览器中创建一个书签小程序。执行以下步骤:
-
在 Web 浏览器中显示 书签栏:
- 在 Windows 上按 Ctrl+Shift+B,或在 Mac 上按 Cmd+Shift+B。
!. 在浏览器中创建一个新书签:
- 右键单击书签栏,选择 新建页面 或 添加书签。
- 在 地址(URL) 字段中粘贴以下代码:
| code language-javascript |
|---|
|
-
将该书签命名为 预检(或其他任意名称)。
-
在 AEM Sites 页面编辑器 中打开需要审计页面的预览 URL(
*.aem.page)。 -
在书签栏中点击 预检 书签,即可开始对当前页面进行审计。
最佳实践
在运行预检审计时,请注意以下准则:
- 请务必在发布到生产环境之前,先在 暂存环境或预览页面 上运行审计。
- 优先解决 高影响问题,例如链接失效、缺少 H1 标记或不安全的链接。
- 在受保护的暂存环境中运行审计前,请确保已启用 身份验证。
- 查看并应用 元标记建议,以提升 SEO 性能。