Documentation on Pretty URL's could use some clarification

[cnymike]

The documentation on enabling Pretty URL's is not clear to me and therefore is probably not clear to other non-coders out there.

Currently it states :

Code: Select all

The internal mechanism is handled entirely within PHP and doesn't require mod_rewrite in Apache. However, it won't work on IIS, and if you do enable it, you must also ensure that your template contains a {metadata} tag. To enable it, set this option to true:

$config['internal_pretty_urls'] = true;

If you want to use mod_rewrite to handle URLs, you need to enable this:

$config['assume_mod_rewrite'] = true; 

What is confusing about this is that it is an either/or decision. If you choose to use the internal mechanism, then you do not want to enable mod_rewrite. And if you choose mod_rewrite, you do not want to also have the internal mechanism enabled. right?

The way it is written and the way a newbie would be following the instructions would imply that it is OK to have the internal mechanism enabled and also  have mod_rewrite enabled. At least that's how I interpret it.

Am I wrong?

[Pierre M.]

Hello,

What is confusing about this is that it is an either/or decision. If you choose to use the internal mechanism, then you do not want to enable mod_rewrite. And if you choose mod_rewrite, you do not want to also have the internal mechanism enabled. right?

The way it is written and the way a newbie would be following the instructions would imply that it is OK to have the internal mechanism enabled and also  have mod_rewrite enabled. At least that's how I interpret it.

Internal PHP hack URL rewriting and External mod_rewrite URL rewriting are EXclusive. It is either one or the other, not both at once.

If you find something in the wiki that can be better worded, feel free to improve it : you have write access to the wiki with your forum account.

Pierre M.

[cnymike]

I made the change in the wiki yesterday
already. Please review it and correct if necessary.

[Pierre M.]

Hello,

Please review it and correct if necessary.

Reviewing

If you want to use mod_rewrite instead of the internal mechanism to handle URLs, make sure that 'assume_mod_rewrite' is first set to false, and then you need to enable this:

$config['assume_mod_rewrite'] = true;

I think you mean "make sure that 'internal_pretty_urls' is first set to false" ?

Pierre M.

[cnymike]

My bad.

I fixed it.

[Pierre M.]

Thank you very much for your contribution by clarification.
Have fun with CMSms !

Pierre M.