Newer
Older
<?php
// $Id$
/**
* @file
* Enables users to rename URLs.
*/
/**
* Implementation of hook_help().
*/
Gábor Hojtsy
committed
function path_help($path, $arg) {
switch ($path) {
case 'admin/help#path':
$output = '<p>'. t('The path module allows you to specify aliases for Drupal URLs. Such aliases improve readability of URLs for your users and may help internet search engines to index your content more effectively. More than one alias may be created for a given page.') .'</p>';
$output .= t('<p>Some examples of URL aliases are:</p>
<ul>
<li>user/login => login</li>
<li>image/tid/16 => store</li>
<li>taxonomy/term/7+19+20+21 => store/products/whirlygigs</li>
<li>node/3 => contact</li>
</ul>
');
Gábor Hojtsy
committed
$output .= '<p>'. t('The path module enables appropriately permissioned users to specify an optional alias in all node input and editing forms, and provides an interface to view and edit all URL aliases. The two permissions related to URL aliasing are <em>administer url aliases</em> and <em>create url aliases</em>. ') .'</p>';
$output .= '<p>'. t('This module also provides user-defined mass URL aliasing capabilities, which is useful if you wish to uniformly use URLs different from the default. For example, you may want to have your URLs presented in a different language. Access to the Drupal source code on the web server is required to set up mass URL aliasing. ') .'</p>';
Gábor Hojtsy
committed
$output .= '<p>'. t('For more information, see the online handbook entry for <a href="@path">Path module</a>.', array('@path' => 'http://drupal.org/handbook/modules/path/')) .'</p>';
Gábor Hojtsy
committed
return '<p>'. t("Drupal provides complete control over URLs through aliasing, which is often used to make URLs more readable or easy to remember. For example, the alias 'about' may be mapped onto the post at the system path 'node/1', creating a more meaningful URL. Each system path can have multiple aliases.") .'</p>';
return '<p>'. t('Enter the path you wish to create the alias for, followed by the name of the new alias.') .'</p>';
}
}
/**
* Implementation of hook_menu().
*/
Dries Buytaert
committed
function path_menu() {
$items['admin/build/path'] = array(
'title' => 'URL aliases',
'description' => "Change your site's URL paths by aliasing them.",
Dries Buytaert
committed
'page callback' => 'path_admin_overview',
Dries Buytaert
committed
'access arguments' => array('administer url aliases'),
'file' => 'path.admin.inc',
Dries Buytaert
committed
);
$items['admin/build/path/edit'] = array(
'title' => 'Edit alias',
'page callback' => 'path_admin_edit',
Dries Buytaert
committed
'type' => MENU_CALLBACK,
'file' => 'path.admin.inc',
Dries Buytaert
committed
);
$items['admin/build/path/delete'] = array(
'title' => 'Delete alias',
Dries Buytaert
committed
'page callback' => 'drupal_get_form',
'page arguments' => array('path_admin_delete_confirm'),
Dries Buytaert
committed
'type' => MENU_CALLBACK,
'file' => 'path.admin.inc',
Dries Buytaert
committed
);
$items['admin/build/path/list'] = array(
'title' => 'List',
Dries Buytaert
committed
'type' => MENU_DEFAULT_LOCAL_TASK,
'weight' => -10,
);
$items['admin/build/path/add'] = array(
'title' => 'Add alias',
'page callback' => 'path_admin_edit',
Dries Buytaert
committed
'access arguments' => array('administer url aliases'),
'type' => MENU_LOCAL_TASK,
'file' => 'path.admin.inc',
Dries Buytaert
committed
);
return $items;
}
/**
* Post-confirmation; delete an URL alias.
*/
function path_admin_delete($pid = 0) {
db_query('DELETE FROM {url_alias} WHERE pid = %d', $pid);
drupal_set_message(t('The alias has been deleted.'));
}
/**
* Set an aliased path for a given Drupal path, preventing duplicates.
*/
function path_set_alias($path = NULL, $alias = NULL, $pid = NULL, $language = '') {
Gábor Hojtsy
committed
$path = urldecode($path);
$alias = urldecode($alias);
// First we check if we deal with an existing alias and delete or modify it based on pid.
if ($pid) {
// An existing alias.
if (!$path || !$alias) {
// Delete the alias based on pid.
db_query('DELETE FROM {url_alias} WHERE pid = %d', $pid);
}
else {
// Update the existing alias.
db_query("UPDATE {url_alias} SET src = '%s', dst = '%s', language = '%s' WHERE pid = %d", $path, $alias, $language, $pid);
}
Gábor Hojtsy
committed
// Check for existing aliases.
if ($alias == drupal_get_path_alias($path, $language)) {
// There is already such an alias, neutral or in this language.
// Update the alias based on alias; setting the language if not yet done.
db_query("UPDATE {url_alias} SET src = '%s', dst = '%s', language = '%s' WHERE dst = '%s'", $path, $alias, $language, $alias);
else {
Gábor Hojtsy
committed
// A new alias. Add it to the database.
db_query("INSERT INTO {url_alias} (src, dst, language) VALUES ('%s', '%s', '%s')", $path, $alias, $language);
Gábor Hojtsy
committed
}
else {
// Delete the alias.
if ($alias) {
db_query("DELETE FROM {url_alias} WHERE dst = '%s'", $alias);
Gábor Hojtsy
committed
else {
db_query("DELETE FROM {url_alias} WHERE src = '%s'", $path);
Gábor Hojtsy
committed
}
Gábor Hojtsy
committed
drupal_clear_path_cache();
Gábor Hojtsy
committed
/**
* Implementation of hook_nodeapi().
*
* Allows URL aliases for nodes to be specified at node edit time rather
* than through the administrative interface.
*/
function path_nodeapi(&$node, $op, $arg) {
Gábor Hojtsy
committed
// Permissions are required for everything except node loading.
if (user_access('create url aliases') || user_access('administer url aliases') || ($op == 'load')) {
Gábor Hojtsy
committed
$language = isset($node->language) ? $node->language : '';
switch ($op) {
case 'validate':
$node->path = trim($node->path);
if (db_result(db_query("SELECT COUNT(dst) FROM {url_alias} WHERE dst = '%s' AND src != '%s' AND language = '%s'", $node->path, "node/$node->nid", $language))) {
form_set_error('path', t('The path is already in use.'));
}
break;
case 'load':
Gábor Hojtsy
committed
$path = 'node/'. $node->nid;
$alias = drupal_get_path_alias($path, $language);
if ($path != $alias) {
$node->path = $alias;
}
break;
case 'insert':
// Don't try to insert if path is NULL. We may have already set
// the alias ahead of time.
Gábor Hojtsy
committed
path_set_alias('node/'. $node->nid, $node->path, NULL, $language);
Gábor Hojtsy
committed
path_set_alias('node/'. $node->nid, isset($node->path) ? $node->path : NULL, isset($node->pid) ? $node->pid : NULL, $language);
Gábor Hojtsy
committed
$path = 'node/'. $node->nid;
if (drupal_get_path_alias($path) != $path) {
path_set_alias($path);
}
break;
}
}
}
/**
* Implementation of hook_form_alter().
*/
Dries Buytaert
committed
function path_form_alter(&$form, $form_state, $form_id) {
Steven Wittens
committed
if (isset($form['type']) && isset($form['#node']) && $form['type']['#value'] .'_node_form' == $form_id) {
Dries Buytaert
committed
$path = isset($form['#node']->path) ? $form['#node']->path : NULL;
$form['path'] = array(
'#type' => 'fieldset',
'#title' => t('URL path settings'),
'#collapsible' => TRUE,
'#collapsed' => empty($path),
'#access' => user_access('create url aliases'),
'#weight' => 30,
);
$form['path']['path'] = array(
'#type' => 'textfield',
'#default_value' => $path,
'#maxlength' => 250,
'#collapsible' => TRUE,
'#collapsed' => TRUE,
'#description' => t('Optionally specify an alternative URL by which this node can be accessed. For example, type "about" when writing an about page. Use a relative path and don\'t add a trailing slash or the URL alias won\'t work.'),
);
if ($path) {
$form['path']['pid'] = array(
'#type' => 'value',
Gábor Hojtsy
committed
'#value' => db_result(db_query("SELECT pid FROM {url_alias} WHERE dst = '%s' AND language = '%s'", $path, $form['#node']->language))
);
}
}
}
/**
* Implementation of hook_perm().
*/
function path_perm() {
return array('create url aliases', 'administer url aliases');
}
/**
* Fetch a specific URL alias from the database.
*/
function path_load($pid) {
return db_fetch_array(db_query('SELECT * FROM {url_alias} WHERE pid = %d', $pid));
}