预检设置
AEM Sites Optimizer印前检查机会识别需要设置Preflight扩展。 您可以在通用编辑器、基于文档的预览或AEM Cloud Service中进行设置,以便在发布页面之前,对页面运行印前检查审核。
启用用户访问权限
要使用Preflight扩展,请确保您的用户在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 javascript:(function(){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=bookmarklet&target-source=aem-cloud-service';document.head.appendChild(script);})(); -
将该书签命名为预检(或其他任意名称)。
-
在
*.aem.pageAEM Sites页面编辑器中打开要审核的页面的预览URL ()。 -
在书签栏中点击 预检 书签,即可开始对当前页面进行审计。
| note important |
|---|
| IMPORTANT |
| 仅支持使用Adobe的标识提供程序(IMS)对AEM Author进行身份验证的Adobe Managed Services (AMS)环境。 如果您的组织使用任何其他身份提供程序进行AMS身份验证,则Preflight不起作用。 |
要在AMS环境的AEM Sites页面编辑器中使用Preflight,请在Web浏览器中创建小书签,步骤如下:
-
在 Web 浏览器中显示书签栏:
- 在 Windows 上按 Ctrl+Shift+B,或在 Mac 上按 Cmd+Shift+B。
-
在浏览器中创建一个新书签:
- 右键单击书签栏,选择 新建页面 或添加书签。
- 在 地址(URL) 字段中粘贴以下代码:
code language-javascript javascript:(function(){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=bookmarklet&target-source=ams';document.head.appendChild(script);})(); -
将该书签命名为预检(或其他任意名称)。
-
在 AEM Sites页面编辑器 中打开要审核的页面。
-
在书签栏中点击 预检 书签,即可开始对当前页面进行审计。
最佳实践
在运行预检审计时,请注意以下准则:
- 请务必在发布到生产环境之前,先在 暂存环境或预览页面 上运行审计。
- 优先解决高影响问题,例如链接失效、缺少 H1 标记或不安全的链接。
- 在运行审核之前,请确保为受保护的暂存环境启用了身份验证。
- 查看并应用元标记建议,以提升 SEO 性能。