预检设置

AEM Sites Optimizer印前检查机会识别需要设置Preflight扩展。 您可以在通用编辑器、基于文档的预览或AEM Cloud Service中进行设置,以便在发布页面之前,对页面运行印前检查审核。

启用用户访问权限

要使用Preflight扩展,请确保您的用户在Adobe Admin Console中至少被分配到以下AEM Sites Optimizer产品配置文件之一:

  • AEM Sites Optimizer - 自动建议用户
  • AEM Sites Optimizer - 自动优化用户

启用预检功能扩展

通用编辑器

若要在通用编辑器中设置预检功能,请执行以下步骤:

  1. 打开 Extension Manager
    https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor

  2. 找到 AEM Sites Optimizer 预检功能扩展,并提交启用请求。

  3. Adobe AEM团队​将审核并启用贵组织的扩展。

  4. 扩展启用后,在 通用编辑器 中打开某个页面,例如:
    https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html

  5. 预检扩展​出现在​ 侧边栏 ​中。

  6. 从侧边栏中选择​预检功能扩展,即可开始对当前页面执行​预检审计

基于文档的创作

要为基于文档的创作设置预检功能,请执行以下步骤:

  1. 在 Edge Delivery Services 项目的 GitHub 存储库中,将以下配置添加到 /tools/sidekick/config.json 文件:

    code language-json
    {
      "plugins": [
        {
          "id": "preflight",
          "titleI18n": {
            "en": "Preflight"
          },
          "environments": ["preview"],
          "event": "preflight"
        }
      ]
    }
    
  2. 新建文件 /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 });
      }
    }());
    
  3. /scripts/scripts.js 文件中更新 loadLazy() 函数,以导入适用于预览 URL 的预检功能脚本:

    code language-javascript
    if (window.location.href.includes('.aem.page')) {
       import('../tools/sidekick/aem-sites-optimizer-preflight.js');
    }
    
  4. 打开要审核的页面的预览URL (*.aem.page)。

  5. Sidekick 中点击​ 预检 ​功能按钮,即可开始对当前页面进行审计。

AEM Sites 页面编辑器

要在 AEM Sites 页面编辑器中使用预检功能,您可以在 Web 浏览器中创建一个书签小程序。执行以下步骤:

  1. 在Web浏览器中显示​书签栏

    • 在 Windows 上按 Ctrl+Shift+B,或在 Mac 上按 Cmd+Shift+B
  2. 在浏览器中创建一个新书签:

    • 右键单击书签栏,选择​ 新建页面 ​或​添加书签
    • 在​ 地址(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);})();
    
  3. 将该书签命名为​预检(或其他任意名称)。

  4. *.aem.pageAEM Sites页面编辑器​中打开要审核的页面的预览URL ()。

  5. 在书签栏中点击​ 预检 ​书签,即可开始对当前页面进行审计。

Adobe Managed Services
note important
IMPORTANT
仅支持使用Adobe的标识提供程序(IMS)对AEM Author进行身份验证的Adobe Managed Services (AMS)环境。 如果您的组织使用任何其他身份提供程序进行AMS身份验证,则Preflight不起作用。

要在AMS环境的AEM Sites页面编辑器中使用Preflight,请在Web浏览器中创建小书签,步骤如下:

  1. 在 Web 浏览器中显示​书签栏

    • 在 Windows 上按 Ctrl+Shift+B,或在 Mac 上按 Cmd+Shift+B
  2. 在浏览器中创建一个新书签:

    • 右键单击书签栏,选择​ 新建页面 ​或​添加书签
    • 在​ 地址(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);})();
    
  3. 将该书签命名为​预检(或其他任意名称)。

  4. 在​ AEM Sites页面编辑器 ​中打开要审核的页面。

  5. 在书签栏中点击​ 预检 ​书签,即可开始对当前页面进行审计。

最佳实践

在运行预检审计时,请注意以下准则:

  • 请务必在发布到生产环境之前,先在​ 暂存环境或预览页面 ​上运行审计。
  • 优先解决​高影响问题,例如链接失效、缺少 H1 标记或不安全的链接。
  • 在运行审核之前,请确保为受保护的暂存环境启用了​身份验证
  • 查看并应用​元标记建议,以提升 SEO 性能。
recommendation-more-help
29d47e33-0f78-4290-8597-29cd85e8565a