wp-admin/options-permalink.php

   1 <?php
   2 /**
   3  * Permalink settings administration panel.
   4  *
   5  * @package WordPress
   6  * @subpackage Administration
   7  */
   8
   9 /** WordPress Administration Bootstrap */
  10 require_once('./admin.php');
  11
  12 if ( ! current_user_can( 'manage_options' ) )
  13         wp_die( __( 'You do not have sufficient permissions to manage options for this site.' ) );
  14
  15 $title = __('Permalink Settings');
  16 $parent_file = 'options-general.php';
  17
  18 add_contextual_help($current_screen,
  19         '<p>' . __('This screen provides some common options for your default permalinks URL structure.') . '</p>' .
  20         '<p>' . __('If you pick an option other than Default, your general URL path with structure tags, terms surrounded by <code>%</code>, will also appear in the custom structure field and your path can be further modified there.') . '</p>' .
  21         '<p>' . __('When you assign multiple categories or tags to a post, only one can show up in the permalink: the lowest numbered category. This applies if your custom structure includes <code>%category%</code> or <code>%tag%</code>.') . '</p>' .
  22         '<p>' . __('Note that permalinks beginning with the category, tag, author or postname structure tags require more advanced server resources. Double-check your hosting details to make sure those are in place or start your permalinks with other structure tags.') . '</p>' .
  23         '<p>' . __('The Optional fields let you customize the &#8220;category&#8221; and &#8220;tag&#8221; base names that will appear in archive URLs. For example, the page listing all posts in the &#8220;Uncategorized&#8221; category could be <code>/topics/uncategorized</code> instead of <code>/category/uncategorized</code>.') . '</p>' .
  24         '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
  25         '<p><strong>' . __('For more information:') . '</strong></p>' .
  26         '<p>' . __('<a href="http://codex.wordpress.org/Settings_Permalinks_SubPanel" target="_blank">Documentation on Permalinks Settings</a>') . '</p>' .
  27         '<p>' . __('<a href="http://codex.wordpress.org/Using_Permalinks" target="_blank">Documentation on Using Permalinks</a>') . '</p>' .
  28         '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
  29 );
  30
  31 /**
  32  * Display JavaScript on the page.
  33  *
  34  * @package WordPress
  35  * @subpackage Permalink_Settings_Panel
  36  */
  37 function add_js() {
  38         ?>
  39 <script type="text/javascript">
  40 //<![CDATA[
  41 jQuery(document).ready(function() {
  42         jQuery('input:radio.tog').change(function() {
  43                 if ( 'custom' == this.value )
  44                         return;
  45                 jQuery('#permalink_structure').val( this.value );
  46         });
  47         jQuery('#permalink_structure').focus(function() {
  48                 jQuery("#custom_selection").attr('checked', 'checked');
  49         });
  50 });
  51 //]]>
  52 </script>
  53 <?php
  54 }
  55 add_filter('admin_head', 'add_js');
  56
  57 include('./admin-header.php');
  58
  59 $home_path = get_home_path();
  60 $iis7_permalinks = iis7_supports_permalinks();
  61
  62 $prefix = $blog_prefix = '';
  63 if ( ! got_mod_rewrite() && ! $iis7_permalinks )
  64         $prefix = '/index.php';
  65 if ( is_multisite() && !is_subdomain_install() && is_main_site() )
  66         $blog_prefix = '/blog';
  67
  68 if ( isset($_POST['permalink_structure']) || isset($_POST['category_base']) ) {
  69         check_admin_referer('update-permalink');
  70
  71         if ( isset( $_POST['permalink_structure'] ) ) {
  72                 if ( isset( $_POST['selection'] ) && 'custom' != $_POST['selection'] )
  73                         $permalink_structure = $_POST['selection'];
  74                 else
  75                         $permalink_structure = $_POST['permalink_structure'];
  76
  77                 if ( ! empty( $permalink_structure ) ) {
  78                         $permalink_structure = preg_replace( '#/+#', '/', '/' . str_replace( '#', '', $permalink_structure ) );
  79                         if ( $prefix && $blog_prefix )
  80                                 $permalink_structure = $prefix . preg_replace( '#^/?index\.php#', '', $permalink_structure );
  81                         else
  82                                 $permalink_structure = $blog_prefix . $permalink_structure;
  83                 }
  84                 $wp_rewrite->set_permalink_structure( $permalink_structure );
  85         }
  86
  87         if ( isset( $_POST['category_base'] ) ) {
  88                 $category_base = $_POST['category_base'];
  89                 if ( ! empty( $category_base ) )
  90                         $category_base = $blog_prefix . preg_replace('#/+#', '/', '/' . str_replace( '#', '', $category_base ) );
  91                 $wp_rewrite->set_category_base( $category_base );
  92         }
  93
  94         if ( isset( $_POST['tag_base'] ) ) {
  95                 $tag_base = $_POST['tag_base'];
  96                 if ( ! empty( $tag_base ) )
  97                         $tag_base = $blog_prefix . preg_replace('#/+#', '/', '/' . str_replace( '#', '', $tag_base ) );
  98                 $wp_rewrite->set_tag_base( $tag_base );
  99         }
 100
 101         create_initial_taxonomies();
 102 }
 103
 104 $permalink_structure = get_option('permalink_structure');
 105 $category_base = get_option('category_base');
 106 $tag_base = get_option( 'tag_base' );
 107
 108 if ( $iis7_permalinks ) {
 109         if ( ( ! file_exists($home_path . 'web.config') && win_is_writable($home_path) ) || win_is_writable($home_path . 'web.config') )
 110                 $writable = true;
 111         else
 112                 $writable = false;
 113 } else {
 114         if ( ( ! file_exists($home_path . '.htaccess') && is_writable($home_path) ) || is_writable($home_path . '.htaccess') )
 115                 $writable = true;
 116         else
 117                 $writable = false;
 118 }
 119
 120 if ( $wp_rewrite->using_index_permalinks() )
 121         $usingpi = true;
 122 else
 123         $usingpi = false;
 124
 125 $wp_rewrite->flush_rules();
 126
 127
 128 if (isset($_POST['submit'])) : ?>
 129 <div id="message" class="updated"><p><?php
 130 if ( ! is_multisite() ) {
 131         if ( $iis7_permalinks ) {
 132                 if ( $permalink_structure && ! $usingpi && ! $writable )
 133                         _e('You should update your web.config now');
 134                 else if ( $permalink_structure && ! $usingpi && $writable )
 135                         _e('Permalink structure updated. Remove write access on web.config file now!');
 136                 else
 137                         _e('Permalink structure updated');
 138         } else {
 139                 if ( $permalink_structure && ! $usingpi && ! $writable )
 140                         _e('You should update your .htaccess now.');
 141                 else
 142                         _e('Permalink structure updated.');
 143         }
 144 } else {
 145         _e('Permalink structure updated.');
 146 }
 147 ?>
 148 </p></div>
 149 <?php endif; ?>
 150
 151 <div class="wrap">
 152 <?php screen_icon(); ?>
 153 <h2><?php echo esc_html( $title ); ?></h2>
 154
 155 <form name="form" action="options-permalink.php" method="post">
 156 <?php wp_nonce_field('update-permalink') ?>
 157
 158   <p><?php _e('By default WordPress uses web <abbr title="Universal Resource Locator">URL</abbr>s which have question marks and lots of numbers in them, however WordPress offers you the ability to create a custom URL structure for your permalinks and archives. This can improve the aesthetics, usability, and forward-compatibility of your links. A <a href="http://codex.wordpress.org/Using_Permalinks">number of tags are available</a>, and here are some examples to get you started.'); ?></p>
 159
 160 <?php
 161 if ( is_multisite() && !is_subdomain_install() && is_main_site() ) {
 162         $permalink_structure = preg_replace( '|^/?blog|', '', $permalink_structure );
 163         $category_base = preg_replace( '|^/?blog|', '', $category_base );
 164         $tag_base = preg_replace( '|^/?blog|', '', $tag_base );
 165 }
 166
 167 $structures = array(
 168         '',
 169         $prefix . '/%year%/%monthnum%/%day%/%postname%/',
 170         $prefix . '/%year%/%monthnum%/%postname%/',
 171         $prefix . '/archives/%post_id%'
 172         );
 173 ?>
 174 <h3><?php _e('Common settings'); ?></h3>
 175 <table class="form-table">
 176         <tr>
 177                 <th><label><input name="selection" type="radio" value="" class="tog" <?php checked('', $permalink_structure); ?> /> <?php _e('Default'); ?></label></th>
 178                 <td><code><?php echo get_option('home'); ?>/?p=123</code></td>
 179         </tr>
 180         <tr>
 181                 <th><label><input name="selection" type="radio" value="<?php echo esc_attr($structures[1]); ?>" class="tog" <?php checked($structures[1], $permalink_structure); ?> /> <?php _e('Day and name'); ?></label></th>
 182                 <td><code><?php echo get_option('home') . $blog_prefix . $prefix . '/' . date('Y') . '/' . date('m') . '/' . date('d') . '/sample-post/'; ?></code></td>
 183         </tr>
 184         <tr>
 185                 <th><label><input name="selection" type="radio" value="<?php echo esc_attr($structures[2]); ?>" class="tog" <?php checked($structures[2], $permalink_structure); ?> /> <?php _e('Month and name'); ?></label></th>
 186                 <td><code><?php echo get_option('home') . $blog_prefix . $prefix . '/' . date('Y') . '/' . date('m') . '/sample-post/'; ?></code></td>
 187         </tr>
 188         <tr>
 189                 <th><label><input name="selection" type="radio" value="<?php echo esc_attr($structures[3]); ?>" class="tog" <?php checked($structures[3], $permalink_structure); ?> /> <?php _e('Numeric'); ?></label></th>
 190                 <td><code><?php echo get_option('home') . $blog_prefix . $prefix; ?>/archives/123</code></td>
 191         </tr>
 192         <tr>
 193                 <th>
 194                         <label><input name="selection" id="custom_selection" type="radio" value="custom" class="tog" <?php checked( !in_array($permalink_structure, $structures) ); ?> />
 195                         <?php _e('Custom Structure'); ?>
 196                         </label>
 197                 </th>
 198                 <td>
 199                         <?php echo $blog_prefix; ?>
 200                         <input name="permalink_structure" id="permalink_structure" type="text" value="<?php echo esc_attr($permalink_structure); ?>" class="regular-text code" />
 201                 </td>
 202         </tr>
 203 </table>
 204
 205 <h3><?php _e('Optional'); ?></h3>
 206 <?php if ( $is_apache || $iis7_permalinks ) : ?>
 207         <p><?php _e('If you like, you may enter custom structures for your category and tag <abbr title="Universal Resource Locator">URL</abbr>s here. For example, using <kbd>topics</kbd> as your category base would make your category links like <code>http://example.org/topics/uncategorized/</code>. If you leave these blank the defaults will be used.') ?></p>
 208 <?php else : ?>
 209         <p><?php _e('If you like, you may enter custom structures for your category and tag <abbr title="Universal Resource Locator">URL</abbr>s here. For example, using <code>topics</code> as your category base would make your category links like <code>http://example.org/index.php/topics/uncategorized/</code>. If you leave these blank the defaults will be used.') ?></p>
 210 <?php endif; ?>
 211
 212 <table class="form-table">
 213         <tr>
 214                 <th><label for="category_base"><?php /* translators: prefix for category permalinks */ _e('Category base'); ?></label></th>
 215                 <td><?php echo $blog_prefix; ?> <input name="category_base" id="category_base" type="text" value="<?php echo esc_attr( $category_base ); ?>" class="regular-text code" /></td>
 216         </tr>
 217         <tr>
 218                 <th><label for="tag_base"><?php _e('Tag base'); ?></label></th>
 219                 <td><?php echo $blog_prefix; ?> <input name="tag_base" id="tag_base" type="text" value="<?php echo esc_attr($tag_base); ?>" class="regular-text code" /></td>
 220         </tr>
 221         <?php do_settings_fields('permalink', 'optional'); ?>
 222 </table>
 223
 224 <?php do_settings_sections('permalink'); ?>
 225
 226 <?php submit_button(); ?>
 227   </form>
 228 <?php if ( !is_multisite() ) { ?>
 229 <?php if ( $iis7_permalinks ) :
 230         if ( isset($_POST['submit']) && $permalink_structure && ! $usingpi && ! $writable ) :
 231                 if ( file_exists($home_path . 'web.config') ) : ?>
 232 <p><?php _e('If your <code>web.config</code> file were <a href="http://codex.wordpress.org/Changing_File_Permissions">writable</a>, we could do this automatically, but it isn&#8217;t so this is the url rewrite rule you should have in your <code>web.config</code> file. Click in the field and press <kbd>CTRL + a</kbd> to select all. Then insert this rule inside of the <code>/&lt;configuration&gt;/&lt;system.webServer&gt;/&lt;rewrite&gt;/&lt;rules&gt;</code> element in <code>web.config</code> file.') ?></p>
 233 <form action="options-permalink.php" method="post">
 234 <?php wp_nonce_field('update-permalink') ?>
 235         <p><textarea rows="9" class="large-text readonly" name="rules" id="rules" readonly="readonly"><?php echo esc_textarea( $wp_rewrite->iis7_url_rewrite_rules() ); ?></textarea></p>
 236 </form>
 237 <p><?php _e('If you temporarily make your <code>web.config</code> file writable for us to generate rewrite rules automatically, do not forget to revert the permissions after rule has been saved.')  ?></p>
 238                 <?php else : ?>
 239 <p><?php _e('If the root directory of your site were <a href="http://codex.wordpress.org/Changing_File_Permissions">writable</a>, we could do this automatically, but it isn&#8217;t so this is the url rewrite rule you should have in your <code>web.config</code> file. Create a new file, called <code>web.config</code> in the root directory of your site. Click in the field and press <kbd>CTRL + a</kbd> to select all. Then insert this code into the <code>web.config</code> file.') ?></p>
 240 <form action="options-permalink.php" method="post">
 241 <?php wp_nonce_field('update-permalink') ?>
 242         <p><textarea rows="18" class="large-text readonly" name="rules" id="rules" readonly="readonly"><?php echo esc_textarea( $wp_rewrite->iis7_url_rewrite_rules(true) ); ?></textarea></p>
 243 </form>
 244 <p><?php _e('If you temporarily make your site&#8217;s root directory writable for us to generate the <code>web.config</code> file automatically, do not forget to revert the permissions after the file has been created.')  ?></p>
 245                 <?php endif; ?>
 246         <?php endif; ?>
 247 <?php else :
 248         if ( $permalink_structure && ! $usingpi && ! $writable ) : ?>
 249 <p><?php _e('If your <code>.htaccess</code> file were <a href="http://codex.wordpress.org/Changing_File_Permissions">writable</a>, we could do this automatically, but it isn&#8217;t so these are the mod_rewrite rules you should have in your <code>.htaccess</code> file. Click in the field and press <kbd>CTRL + a</kbd> to select all.') ?></p>
 250 <form action="options-permalink.php" method="post">
 251 <?php wp_nonce_field('update-permalink') ?>
 252         <p><textarea rows="6" class="large-text readonly" name="rules" id="rules" readonly="readonly"><?php echo esc_textarea( $wp_rewrite->mod_rewrite_rules() ); ?></textarea></p>
 253 </form>
 254         <?php endif; ?>
 255 <?php endif; ?>
 256 <?php } // multisite ?>
 257
 258 </div>
 259
 260 <?php require('./admin-footer.php'); ?>