? 264909_pathauto_updated_docs_10.patch ? 264909_pathauto_updated_docs_11.patch Index: INSTALL.txt =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/INSTALL.txt,v retrieving revision 1.2 diff -u -p -r1.2 INSTALL.txt --- INSTALL.txt 28 Oct 2007 22:46:58 -0000 1.2 +++ INSTALL.txt 19 Jun 2008 08:42:38 -0000 @@ -1,16 +1,20 @@ **Installation: -Note that pathauto is an extension to the path module, which must -be enabled. +Pathauto is an extension to the path module, which must be enabled. -1. Unpack the pathauto folder and contents in the modules directory of -your Drupal installation. -2. Enable the pathauto module in the administration tools. +Pathauto also relies on the Token module, which must be downloaded and +enabled separately. + +1. Unpack the Pathauto folder and contents in the appropriate modules +directory of your Drupal installation. This is probably + sites/all/modules/ +2. Enable the Pathauto module in the administration tools. 3. If you're not using Drupal's default administrative account, make sure "administer pathauto" is enabled through access control administration. -4. Visit the pathauto settings page: - When first installing pathauto, to define the desired alias patterns. +4. Visit the Pathauto settings page and make appropriate configurations + For 5.x: Administer > Site Configuration > Pathauto + For 6.x: Administer > Site building > URL alias > Automated alias settings **Transliteration support: If you desire transliteration support in the creation of URLs (e.g. the @@ -24,20 +28,25 @@ For details on how to transliterate any i18n-ascii-fill.txt file information at http://drupal.org/node/185664 **Upgrading from previous versions: -If you are upgrading from Pathauto 5.x-1.x to 5.x-2.x (or 6.x-2.x) then you will -probably need to change your patterns. +If you are upgrading from Pathauto 5.x-1.x to 5.x-2.x (or 6.x-2.x) then you +will probably need to change your patterns. For content patterns: [user] is now [author-name] [cat] is now [term] There may be other changes as well. Please review the pattern examples on - Administration > Site Configuration > Pathauto - -NOTE: You must also have the token module installed. If you upgraded from -Pathauto 5.x-1.x directly without enabling token first then you will need to -1) download/install the token module 2) disable the Pathauto module 3) re-enable -the Pathauto module 4) confirm the dependency on the token module. + Administration > Site Configuration > Pathauto +If you upgraded from Pathauto 5.x-1.x directly without enabling Token +first then you will need to + 1) download/install the Token module + 2) disable the Pathauto module + 3) re-enable the Pathauto module + +Upgrade to 6.x: +Note that the settings page has moved so that it is more logically grouped with +other URL alias related items under + Administer > Site building > URL alias > Automated alias settings $Id: INSTALL.txt,v 1.2 2007/10/28 22:46:58 greggles Exp $ Index: README.txt =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/README.txt,v retrieving revision 1.15 diff -u -p -r1.15 README.txt --- README.txt 5 Apr 2008 22:20:10 -0000 1.15 +++ README.txt 19 Jun 2008 08:42:38 -0000 @@ -9,7 +9,10 @@ automatically generate aliases based on central settings path for site administrators. Implementations are provided for core content types: nodes, taxonomy -terms, users, blogs, and events. +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 @@ -20,28 +23,33 @@ relevant search engine hits for your pag enhanced. **Installation AND Upgrades: -See the INSTALL.txt - especially step 4. +See the INSTALL.txt file. **Notices: -Pathauto just adds url aliases to nodes 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 menus to use the alias. Also, please bear in mind that +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: +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 instead +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") @@ -57,9 +65,9 @@ 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. +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. @@ -67,7 +75,6 @@ Failure to do so may cause errors about 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. @@ -77,9 +84,12 @@ Matt England added the tracker support. Other suggestions and patches contributed by the Drupal community. -Current maintainer: Greg Knaddison (greg AT knaddison DOT com) +Current maintainers: + Greg Knaddison - http://growingventuresolutions.com + Mike Ryan - http://mikeryan.name + Frederik 'Freso' S. Olesen - http://freso.dk **Changes: -See the CHANGELOG.txt +See the CHANGELOG.txt file. $Id: README.txt,v 1.15 2008/04/05 22:20:10 greggles Exp $