[ XREF Home ] [ Index ]

PHP Cross Reference of WordPress Trunk

Provided by Yoast

title

Body

[close]

/wp-admin/ -> options-permalink.php (source)

   1  <?php
   2  /**
   3   * Permalink Settings Administration Screen.
   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_Screen" 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_Screen
  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'); ?>


Generated: Wed Jun 1 08:30:02 2011 Cross-referenced by PHPXref 0.7
Provided by Yoast and awesome WordPress Hosting