Show Menu
TÓPICOS×

Configurações avançadas de URL

AEM CIF Componentes principais fornece configurações avançadas para personalizar os URLs das páginas de produtos e categorias. Muitas implementações personalizarão esses URLs para fins de otimização de mecanismo de pesquisa (SEO). O vídeo a seguir mostra detalhes sobre como configurar o UrlProvider Serviço e os recursos do Sling Mapping para personalizar os URLs das páginas de produto e categoria.

Configuração

Para configurar o UrlProvider serviço de acordo com os requisitos SEO e precisar de um projeto, é necessário fornecer uma configuração OSGI para a configuração "CIF do provedor de URL" e configurar o serviço conforme descrito abaixo.
O projeto da loja de referência de Venia, veja abaixo, inclui configurações de amostra para demonstrar o uso de URLs personalizados para páginas de produtos e categorias.

Modelo de URL da página do produto

Isso configura os URLs das páginas de produtos com as seguintes propriedades:
  • Modelo de URL do produto: define o formato de URLs com um conjunto de espaços reservados. O valor padrão é {{page}}.{{url_key}}.html#{{variant_sku}} , o que acaba gerando URLs como, por exemplo, /content/venia/us/en/products/product-page.chaz-kangeroo-hoodie.html#MH01-M-Orange
    • {{page}} foi substituído por /content/venia/us/en/products/product-page
    • {{url_key}} foi substituída por Magento url_key de propriedade do produto, chaz-kangeroo-hoodie
    • {{variant_sku}} foi substituída pela variante selecionada no momento, aqui MH01-M-Orange
  • Localização do identificador do produto: define o local do identificador que será usado para buscar os dados do produto. O valor padrão é SELECTOR , o outro valor possível é SUFFIX . Com o URL de exemplo anterior, isso significa que o identificador chaz-kangeroo-hoodie será usado para buscar os dados do produto.
  • Tipo de identificador do produto: define o tipo do identificador a ser usado ao buscar os dados do produto. O valor padrão é URL_KEY , o outro valor possível é SKU . Com o URL de exemplo anterior, isso significa que os dados do produto serão obtidos com um filtro Magento GraphQL como filter:{url_key:{eq:"chaz-kangeroo-hoodie"}} .

Modelo de URL da página de lista do produto

Isso configura os URLs das páginas de categoria ou lista do produto com as seguintes propriedades:
  • Modelo de URL de Categoria: define o formato de URLs com um conjunto de espaços reservados. O valor padrão é {{page}}.{{id}}.html , o que acaba gerando URLs como, por exemplo, /content/venia/us/en/products/category-page.3.html
    • {{page}} foi substituído por /content/venia/us/en/products/category-page
    • {{id}} foi substituída por Magento, aqui id a propriedade da categoria 3
  • Localização do identificador de Categoria: define o local do identificador que será usado para buscar os dados do produto. O valor padrão é SELECTOR , o outro valor possível é SUFFIX . Com o URL de exemplo anterior, isso significa que o identificador 3 será usado para buscar os dados do produto.
  • Tipo de identificador de Categoria: define o tipo do identificador a ser usado ao buscar os dados do produto. O valor padrão e o valor atualmente suportado é ID . Com o URL de exemplo anterior, isso significa que os dados da categoria serão obtidos com um filtro Magento GraphQL como category(id:3) .
É possível adicionar propriedades personalizadas para cada modelo, desde que os dados correspondentes estejam sendo definidos pelos componentes que usam o UrlProvider . Verifique, por exemplo, o código da ProductListItemImpl classe para descobrir como isso é implementado.
Também é possível substituir o UrlProvider serviço por um serviço OSGi totalmente personalizado. Nesse caso, é necessário implementar a UrlProvider interface e registrá-la com uma classificação de serviço mais alta para substituir a implementação padrão.

Combinar com mapeamentos Sling

Além do UrlProvider , também é possível configurar os Sling Mappings para reescrever e processar URLs. O projeto AEM Archetype também fornece um exemplo de configuração para configurar alguns Mapeamentos Sling para a porta 4503 (publicação) e 80 (despachante).

Combinar com AEM Dispatcher

As regravações de URL também podem ser alcançadas usando AEM servidor HTTP Dispatcher com mod_rewrite módulo. O AEM Project Archetype fornece uma referência AEM configuração do Dispatcher que já inclui regras básicas de regravação para o tamanho gerado.

Exemplo

O projeto da loja de referência de Venia inclui configurações de amostra para demonstrar o uso de URLs personalizados para páginas de produtos e categorias. Isso permite que cada projeto configure padrões de URL individuais para páginas de produtos e categorias de acordo com suas necessidades de SEO. É utilizada uma combinação de imagens CIF UrlProvider e Sling, conforme descrito acima.
Essa configuração deve ser ajustada com o domínio externo usado pelo projeto. Os Mapeamentos Sling estão funcionando com base no nome do host e no domínio. Portanto, essa configuração é desativada por padrão e deve ser ativada antes da implantação. Para fazer isso, renomeie a hostname.adobeaemcloud.com pasta Sling Mapping de ui.content/src/main/content/jcr_root/etc/map.publish/https acordo com o nome de domínio usado e ative essa configuração adicionando resource.resolver.map.location="/etc/map.publish" à JcrResourceResolver configuração do projeto.