modules/pathauto/README.txt

Please read this file and also the INSTALL.txt.  
They contain answers to many common questions.
If you are developing for this module, the API.txt may be interesting.
If you are upgrading, check the CHANGELOG.txt for major changes.

**Description:
The Pathauto module provides support functions for other modules to 
automatically generate aliases based on appropriate criteria, with a 
central settings path for site administrators.

Implementations are provided for core content types: nodes, taxonomy 
terms, and users (including blogs and tracker pages).

Pathauto also provides a way to delete large numbers of aliases.  This feature 
is available at  Administer > Site building > URL aliases > Delete aliases

**Benefits:
Besides making the page address more reflective of its content than
"node/138", it's important to know that modern search engines give 
heavy weight to search terms which appear in a page's URL. By 
automatically using keywords based directly on the page content in the URL, 
relevant search engine hits for your page can be significantly
enhanced.

**Installation AND Upgrades:
See the INSTALL.txt file.

**Notices:
Pathauto just adds URL aliases to nodes, users, and taxonomy terms. Because 
it's an alias, the standard Drupal URL (for example node/123 or 
taxonomy/term/1) will still function as normal.  If you have external links 
to your site pointing to standard Drupal URLs, or hardcoded links in a module, 
template, node or menu which point to standard Drupal URLs it will bypass the 
alias set by Pathauto.

There are reasons you might not want two URLs for the same content on your 
site. If this applies to you, please note that you will need to update any 
hard coded links in your nodes or blocks. 

If you use the "system path" (i.e. node/10) for menu items and settings like
that, Drupal will replace it with the url_alias.

For external links, you might want to consider the Path Redirect or 
Global Redirect modules, which allow you to set forwarding either per item or 
across the site to your aliased URLs. 

URLs (not) Getting Replaced With Aliases:
Please bear in mind that only URLs passed through Drupal's l() or url()
functions will be replaced with their aliases during page output. If a module
or your template contains hardcoded links, such as 'href="node/$node->nid"'
those won't get replaced with their corresponding aliases. Use the
Drupal API instead:

* 'href="'. url("node/$node->nid") .'"' or
* l("Your link title", "node/$node->nid")

See http://api.drupal.org/api/HEAD/function/url and 
http://api.drupal.org/api/HEAD/function/l for more information.

** Disabling Pathauto for a specific node type (or taxonomy)
When the pattern for a node type is left blank, the default pattern will be 
used. But if the default pattern is also blank, Pathauto will be disabled 
for that node type.

** Bulk Updates Must be Run Multiple Times:
As of 5.x-2.x Pathauto now performs bulk updates in a manner which is more 
likely to succeed on large sites.  The drawback is that it needs to be run 
multiple times.  If you want to reduce the number of times that you need to 
run Pathauto you can increase the "Maximum number of objects to alias in a 
bulk update:" setting under General Settings.

**WYSIWYG Conflicts - FCKEditor, TinyMCE, etc.
If you use a WYSIWYG editor, please disable it for the Pathauto admin page.  
Failure to do so may cause errors about "preg_replace" problems due to the <p>
tag being added to the "strings to replace".  See http://drupal.org/node/175772

**Credits:
The original module combined the functionality of Mike Ryan's autopath with
Tommy Sundstrom's path_automatic.

Significant enhancements were contributed by jdmquin @ www.bcdems.net.

Matt England added the tracker support.

Other suggestions and patches contributed by the Drupal community.

Current maintainers: 
  Greg Knaddison - http://growingventuresolutions.com
  Mike Ryan - http://mikeryan.name
  Frederik 'Freso' S. Olesen - http://freso.dk

**Changes:
See the CHANGELOG.txt file.

$Id: README.txt,v 1.15 2008/04/05 22:20:10 greggles Exp $
1	Please read this file and also the INSTALL.txt.
2	They contain answers to many common questions.
3	If you are developing for this module, the API.txt may be interesting.
4	If you are upgrading, check the CHANGELOG.txt for major changes.
5
6	**Description:
7	The Pathauto module provides support functions for other modules to
8	automatically generate aliases based on appropriate criteria, with a
9	central settings path for site administrators.
10
11	Implementations are provided for core content types: nodes, taxonomy
12	terms, and users (including blogs and tracker pages).
13
14	Pathauto also provides a way to delete large numbers of aliases. This feature
15	is available at Administer > Site building > URL aliases > Delete aliases
16
17	**Benefits:
18	Besides making the page address more reflective of its content than
19	"node/138", it's important to know that modern search engines give
20	heavy weight to search terms which appear in a page's URL. By
21	automatically using keywords based directly on the page content in the URL,
22	relevant search engine hits for your page can be significantly
23	enhanced.
24
25	**Installation AND Upgrades:
26	See the INSTALL.txt file.
27
28	**Notices:
29	Pathauto just adds URL aliases to nodes, users, and taxonomy terms. Because
30	it's an alias, the standard Drupal URL (for example node/123 or
31	taxonomy/term/1) will still function as normal. If you have external links
32	to your site pointing to standard Drupal URLs, or hardcoded links in a module,
33	template, node or menu which point to standard Drupal URLs it will bypass the
34	alias set by Pathauto.
35
36	There are reasons you might not want two URLs for the same content on your
37	site. If this applies to you, please note that you will need to update any
38	hard coded links in your nodes or blocks.
39
40	If you use the "system path" (i.e. node/10) for menu items and settings like
41	that, Drupal will replace it with the url_alias.
42
43	For external links, you might want to consider the Path Redirect or
44	Global Redirect modules, which allow you to set forwarding either per item or
45	across the site to your aliased URLs.
46
47	URLs (not) Getting Replaced With Aliases:
48	Please bear in mind that only URLs passed through Drupal's l() or url()
49	functions will be replaced with their aliases during page output. If a module
50	or your template contains hardcoded links, such as 'href="node/$node->nid"'
51	those won't get replaced with their corresponding aliases. Use the
52	Drupal API instead:
53
54	* 'href="'. url("node/$node->nid") .'"' or
55	* l("Your link title", "node/$node->nid")
56
57	See http://api.drupal.org/api/HEAD/function/url and
58	http://api.drupal.org/api/HEAD/function/l for more information.
59
60	** Disabling Pathauto for a specific node type (or taxonomy)
61	When the pattern for a node type is left blank, the default pattern will be
62	used. But if the default pattern is also blank, Pathauto will be disabled
63	for that node type.
64
65	** Bulk Updates Must be Run Multiple Times:
66	As of 5.x-2.x Pathauto now performs bulk updates in a manner which is more
67	likely to succeed on large sites. The drawback is that it needs to be run
68	multiple times. If you want to reduce the number of times that you need to
69	run Pathauto you can increase the "Maximum number of objects to alias in a
70	bulk update:" setting under General Settings.
71
72	**WYSIWYG Conflicts - FCKEditor, TinyMCE, etc.
73	If you use a WYSIWYG editor, please disable it for the Pathauto admin page.
74	Failure to do so may cause errors about "preg_replace" problems due to the <p>
75	tag being added to the "strings to replace". See http://drupal.org/node/175772
76
77	**Credits:
78	The original module combined the functionality of Mike Ryan's autopath with
79	Tommy Sundstrom's path_automatic.
80
81	Significant enhancements were contributed by jdmquin @ www.bcdems.net.
82
83	Matt England added the tracker support.
84
85	Other suggestions and patches contributed by the Drupal community.
86
87	Current maintainers:
88	Greg Knaddison - http://growingventuresolutions.com
89	Mike Ryan - http://mikeryan.name
90	Frederik 'Freso' S. Olesen - http://freso.dk
91
92	**Changes:
93	See the CHANGELOG.txt file.
94
95	$Id: README.txt,v 1.15 2008/04/05 22:20:10 greggles Exp $