1 |
790c5a62
|
Assos Assos
|
Please read this file and also the INSTALL.txt.
|
2 |
85ad3d82
|
Assos Assos
|
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 |
790c5a62
|
Assos Assos
|
** Description:
|
7 |
|
|
The Pathauto module provides support functions for other modules to
|
8 |
|
|
automatically generate aliases based on appropriate criteria, with a
|
9 |
85ad3d82
|
Assos Assos
|
central settings path for site administrators.
|
10 |
|
|
|
11 |
|
|
Implementations are provided for core entity types: content, taxonomy terms,
|
12 |
790c5a62
|
Assos Assos
|
and users (including blogs and forum pages).
|
13 |
85ad3d82
|
Assos Assos
|
|
14 |
790c5a62
|
Assos Assos
|
Pathauto also provides a way to delete large numbers of aliases. This feature
|
15 |
|
|
is available at Administer > Configuration > Search and metadata > URL aliases
|
16 |
|
|
> Delete aliases.
|
17 |
85ad3d82
|
Assos Assos
|
|
18 |
790c5a62
|
Assos Assos
|
** Benefits:
|
19 |
85ad3d82
|
Assos Assos
|
Besides making the page address more reflective of its content than
|
20 |
790c5a62
|
Assos Assos
|
"node/138", it's important to know that modern search engines give
|
21 |
|
|
heavy weight to search terms which appear in a page's URL. By
|
22 |
|
|
automatically using keywords based directly on the page content in the URL,
|
23 |
85ad3d82
|
Assos Assos
|
relevant search engine hits for your page can be significantly
|
24 |
|
|
enhanced.
|
25 |
|
|
|
26 |
790c5a62
|
Assos Assos
|
** Installation AND Upgrades:
|
27 |
85ad3d82
|
Assos Assos
|
See the INSTALL.txt file.
|
28 |
|
|
|
29 |
790c5a62
|
Assos Assos
|
** Notices:
|
30 |
85ad3d82
|
Assos Assos
|
Pathauto just adds URL aliases to content, users, and taxonomy terms.
|
31 |
790c5a62
|
Assos Assos
|
Because it's an alias, the standard Drupal URL (for example node/123 or
|
32 |
|
|
taxonomy/term/1) will still function as normal. If you have external links
|
33 |
|
|
to your site pointing to standard Drupal URLs, or hardcoded links in a module,
|
34 |
85ad3d82
|
Assos Assos
|
template, content or menu which point to standard Drupal URLs it will bypass
|
35 |
|
|
the alias set by Pathauto.
|
36 |
|
|
|
37 |
790c5a62
|
Assos Assos
|
There are reasons you might not want two URLs for the same content on your
|
38 |
|
|
site. If this applies to you, please note that you will need to update any
|
39 |
|
|
hard coded links in your content or blocks.
|
40 |
85ad3d82
|
Assos Assos
|
|
41 |
|
|
If you use the "system path" (i.e. node/10) for menu items and settings like
|
42 |
|
|
that, Drupal will replace it with the url_alias.
|
43 |
|
|
|
44 |
790c5a62
|
Assos Assos
|
For external links, you might want to consider the Path Redirect or
|
45 |
|
|
Global Redirect modules, which allow you to set forwarding either per item or
|
46 |
|
|
across the site to your aliased URLs.
|
47 |
85ad3d82
|
Assos Assos
|
|
48 |
|
|
URLs (not) Getting Replaced With Aliases:
|
49 |
|
|
Please bear in mind that only URLs passed through Drupal's l() or url()
|
50 |
|
|
functions will be replaced with their aliases during page output. If a module
|
51 |
|
|
or your template contains hardcoded links, such as 'href="node/$node->nid"'
|
52 |
|
|
those won't get replaced with their corresponding aliases. Use the
|
53 |
|
|
Drupal API instead:
|
54 |
|
|
|
55 |
|
|
* 'href="'. url("node/$node->nid") .'"' or
|
56 |
|
|
* l("Your link title", "node/$node->nid")
|
57 |
|
|
|
58 |
790c5a62
|
Assos Assos
|
See http://api.drupal.org/api/HEAD/function/url and
|
59 |
85ad3d82
|
Assos Assos
|
http://api.drupal.org/api/HEAD/function/l for more information.
|
60 |
|
|
|
61 |
|
|
** Disabling Pathauto for a specific content type (or taxonomy)
|
62 |
790c5a62
|
Assos Assos
|
When the pattern for a content type is left blank, the default pattern will be
|
63 |
|
|
used. But if the default pattern is also blank, Pathauto will be disabled
|
64 |
85ad3d82
|
Assos Assos
|
for that content type.
|
65 |
|
|
|
66 |
790c5a62
|
Assos Assos
|
** Credits:
|
67 |
85ad3d82
|
Assos Assos
|
The original module combined the functionality of Mike Ryan's autopath with
|
68 |
|
|
Tommy Sundstrom's path_automatic.
|
69 |
|
|
|
70 |
|
|
Significant enhancements were contributed by jdmquin @ www.bcdems.net.
|
71 |
|
|
|
72 |
790c5a62
|
Assos Assos
|
Matt England added the tracker support (tracker support has been removed in
|
73 |
|
|
recent changes).
|
74 |
85ad3d82
|
Assos Assos
|
|
75 |
|
|
Other suggestions and patches contributed by the Drupal community.
|
76 |
|
|
|
77 |
790c5a62
|
Assos Assos
|
Current maintainers:
|
78 |
|
|
Dave Reid - http://www.davereid.net
|
79 |
|
|
Greg Knaddison - http://www.knaddison.com
|
80 |
85ad3d82
|
Assos Assos
|
Mike Ryan - http://mikeryan.name
|
81 |
|
|
Frederik 'Freso' S. Olesen - http://freso.dk |