$Id$

DESCRIPTION
===========
This module completes the job left unfinished by Drupal's Path module.
The module extends Drupal's path alias system by automatically applying
user-friendly page aliases not only to the base URL, e.g. "about-us" (for
"node/123"), but also to any of the common extensions of the base URL, e.g.
"about-us/edit", "about-us/track", "about-us/revisions*" etc.

The extended aliases may also be used when specifying visibility control for 
blocks (e.g. "about-us*"), or in fact anywhere where you are prompted to
specify pages to include or exclude.

Requiring no configuration, the module then makes sure that these user-friendly
(and SEO-friendly) aliases are shown everywhere, replacing their system-
generated equivalents, whether it's in the browser address bar or on
the page itself. Examples are the Edit, Track, Revisions etc. tabs, the page
statistics pages as well as any other links on your pages. No more ugly URLs 
like node/123/revisons/456/view or user/7/track.

All of this makes everyone's user experience just that little more convenient
across all pages of your site.

INSTALLATION
============
0. Before you start please ascertain that you have access to edit files in the
   drupal directory tree on the (possibly remote) machine that you're installing
   this module on.
1. As with any other module, uncompress the tar-bal, path_alias_xt.tar.gz, into
   the "sites/all/modules" subdirectory.
2. If you are installing to a live site, put the site off-line at
   Site configuration >> Site maintenance. You will only need about 30 seconds.
3. Visit Site building >> Modules to enable the path_alias_xt module. Press
   "Save configuration".
   You'll get a white page with a message. Don't panic. Proceed as follows.
4. You need to disable a function. Open file "inlcudes/path.inc" in a text
   editor. In this file find the line (near #109 ?) that starts with:
   
     function drupal_get_path_alias(

   then change the function name by inserting some easily recognisable
   prefix like _XXX_:

     function _XXX_drupal_get_path_alias(

   Press the refresh button on your browser.
5. Put your site back on line at Site configuration >> Site maintenance.

CONFIGURATION
=============
None, you're done.

USAGE
======
Users create and use aliases for nodes as per normal, i.e. via the
"URL path settings" fieldset on the Edit form. Or if you have PathAuto enabled
URL aliases for the base page are created automatically.

Let's say someone introduced "about-us" as an alias for some node, say the
system assigned node/123 to it. Whenever specifying page filters, for instance
on the page-specific visibility settings of a block's configuration page,
Site building >> Blocks >> configure, users may now type "about-us/edit",
"*about-us*" etc. rather than node/123/edit, node/123* etc.

When the system displays pages of the form "node/123/..", "about-us/.." will
be shown in the address bar instead. Plus all tabs and links on your pages are
human-readable and SEO-friendly to boot!

UNINSTALL
=========
You will again get a white screen when you uninstall Extended Path Aliases.
Change the name of _XXX_drupal_get_path_alias() back to its original
name, that is: remove the _XXX_ prefix.
Refresh the screen.
