1 |
85ad3d82
|
Assos Assos
|
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 entity types: content, taxonomy terms,
|
12 |
|
|
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 content, users, and taxonomy terms.
|
30 |
|
|
Because 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, content or menu which point to standard Drupal URLs it will bypass
|
34 |
|
|
the 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 content 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 content type (or taxonomy)
|
61 |
|
|
When the pattern for a content 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 content 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.
|