[5.2] SEF: Enforce suffix

[Hackwar]

Pull Request for Issue #15025 .

Summary of Changes

Joomla has been improving its SEO performance constantly and one issue which is still open is the behavior of the suffix. Right now, you can access a URL in Joomla with or without suffix when the option is enabled in the global configuration. This PR introduces a new setting the SEF system plugin which enforces a consistent suffix behavior.

When SEF URLs are enabled, the suffix is enabled and this option is enabled, Joomla will always redirect GET requests to a URL with a suffix if none is present. It will also redirect URLs with a query format parameter to the nicer URL and replace the "nice" suffix with the format parameter if the two collide.

With Joomla 6.0 the option to switch this on/off should be removed again and this should be the default behavior, which would then be added to SiteRouter::parseFormat(). Right now this is YASO (Yet Another Stupid Option) to allow people to test this in live systems and to switch it off if we encounter unforseen issues. The time from 5.1 to 6.0 could be seen as a grace period.

This PR depends on #42692.

I'd like to thank djumla GmbH for sponsoring this feature.

Testing Instructions

1. Make sure that you have PR [5.1] Implement onAfterInitialiseRouter event #42692 in your test installation
2. Apply the patch
3. Enable SEF URLs and the "Add Suffix to URL" options in global configuration
4. Go to "System - SEF" plugin and enable the option to "Enforce Suffix"
5. Open a URL in the frontend and see that URLs ending in a / don't have a suffix, everything else has a suffix.
6. Take a URL with a suffix and remove the suffix. See that Joomla redirects back to a URL with .html.
7. Take a URL with a suffix and add ?format=feed to it, for example for a category blog view. See that you get the feed output with the right URL.

Link to documentations

Please select:

• Documentation link for docs.joomla.org: https://docs.joomla.org/Search_Engine_Friendly_URLs

• No documentation changes for docs.joomla.org needed

• Pull Request link for manual.joomla.org:

• No documentation changes for manual.joomla.org needed

[brianteeman]

This looks like it addresses a 7 year old bug #15025

[ceford]

I have tested this item ✅ successfully on 784cfda

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[nielsnuebel]

I have tested this item ✅ successfully on 784cfda

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[viocassel]

I have tested this item ✅ successfully on 784cfda

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[richard67]

RTC

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[brianteeman]

In favour of the bug fix. Not in favour of the option. As such this should be in 4.4 as a bug fix and not as a new feature in a future release

[Hackwar]

Link to documentation has been added.

[Hackwar]

This is a change in behavior and not just a bugfix. That's why we wont get around this option. For Joomla 6.0 this option will be removed again and the behavior added to the normal behavior of the Add Suffix to URL option. So as long as we will stick to semantic versioning we will have to add this as an option.

[Nuyonuyonoina]

Failed. Too bad, because it's a strong request from a client of mine and for that reason SEO agency it's working with ask to migrate to another CMS...

[Hackwar]

@Nuyonuyonoina could you comment what is failing on your end? Otherwise I can't fix that and this PR wont be merged.

[webfeuerflo]

failed. followed the instructions, but if I remove .html from the URL it does not get added back

[webfeuerflo]

I have tested this item 🔴 unsuccessfully on 784cfda

failed. followed the instructions, but if I remove .html from the URL it does not get added back

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[webfeuerflo]

Tested on PHP 8.1.27, 10.4.32-MariaDB, Joomla! 5.1.0-alpha4 Alpha [ Kudumisha ] 20-February-2024 16:31 GMT

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[SniperSister]

I have tested this item ✅ successfully on ef8201e

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[webnet-assmann]

I have tested this item ✅ successfully on ef8201e

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[robbiejackson]

I have tested this item ✅ successfully on ef8201e

I tested this by just patching the changed files into my 5.1 instance.

I confirmed that with the global config set then the html prefix is restored after you remove it manually.

I also confirmed that an xml feed document was returned correctly whenever a prefix of .feed or a query parameter of format=feed was set in the URL.

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/42850.}

[bembelimen]

@ceford could you please check if the problem still exists?

[pe7er]

Thanks @Hackwar !

[Slava287]

@Hackwar Hello. When turning on Enforce suffix. Problems appear on multi -language sites. The .html is added, for example: site/de, it becomes site/de.html

The problem with the main page

[brianteeman]

@Slava287 unable to confirm. Are you using the core Joomla ,htaccess?

[Slava287]

@brianteeman

[Slava287]

.htaccess

[Hackwar]

If you think there is a serious bug, please open a new ticket. Don't respond in closed pull requests, since these are most likely going to be overlooked.

[Slava287]

Everything works. I apologize, these were problems on my side.

[ghost]

these were problems on my side

@Slava287 which?

[Slava287]

I had unnecessary redirects to .htaccess

[brianteeman]

That is why I specifically asked you

[ghost]

so @brianteeman asked the correct question comment

@Slava287 Thanks for the answer. It might help other.