Joomla! Documentation™

Tutorial
O novo sistema de roteamento de URLs

Joomla! 

3.8

Introdução

O novo sistema de roteamento define uma interface nova e mais flexível para que os desenvolvedores gerenciem a criação e processamento de URLs, oferecendo aos usuários finais mais opções para exibição das URLs (incluindo a possibilidade muito solicitada de remover os IDs dos itens de conteúdo da URL).
A partir do Joomla! 3.8, para os componentes que suportam o novo roteador (Conteúdo, Contatos, Usuários e Newsfeeds), é possível configurar o roteador para executar em uma das três configurações a seguir:

• Sistema de roteamento atual (Permanece como comportamento padrão para novas instalações. É a opção que geralmente será recomendada na atualização de sites já existentes)
• Novo sistema de roteamento
• Novo sistema de roteamento sem IDs de item de conteúdo

Note

Because the URLs generated with the new routing system are not 100% compatible with the existing router and its URLs, it is suggested that existing sites do not enable the new system without thoroughly testing their sites in a staging environment and addressing any URL changes.
New sites are encouraged to make use of the new system immediately.

What are the changes in the URLs?

When SEF options are enabled, here are two pages from the testing sample data set with each of the routing configurations:

• Animals Photo Gallery Category Page:
  • Existing router: /article-categories/72-park-site/photo-gallery/animals
  • New router enabled with IDs: /article-categories/26-park-site/28-photo-gallery/72-animals
  • New router enabled without IDs: /article-categories/park-site/photo-gallery/animals
• Koala Article Page:
  • Existing router: /article-categories/72-park-site/photo-gallery/animals/25-koala
  • New router enabled with IDs: /article-categories/26-park-site/28-photo-gallery/72-animals/25-koala
  • New router enabled without IDs: /article-categories/park-site/photo-gallery/animals/koala

The numbers indicate the IDs of your categories and articles.
With the new router and the Remove IDs option enabled, the IDs are removed, which allow to have cleaner and more friendly URLs. It will also improve your SEO.

How can I enable the new routing system?

Enable the new router

The New Routing System is available for Content, Contacts, Users, and Newsfeeds. The way to enable this new features is the same for each of them.

Let's take Content as example.

• Log in the backend
• In the top menu, navigate to Content → Articles
• Click on the button Options at the top right
  
• Click on the Integration tab
  
• Activate the New Routing System:
  • Click on Experimental to enable the new URL Routing
  • Click on Yes if you want to remove IDs.
    
• Click on Save or Save & Close at the top left
• Visit your frontend and check your URLs.

Follow the same process for Contacts, Users, and Newsfeeds.

NB: There are cases where changing the routing system can change a page’s URL and cause an existing page to give a 404 response. Developers are still discussing ideas for a migration plan to keep old URLs working to some extent.