Ticket #7660: 7660.r8895.diff
File 7660.r8895.diff, 22.9 KB (added by , 16 years ago) |
---|
-
rewrite.php
7 7 */ 8 8 9 9 /** 10 * add_rewrite_rule() - Add a straight rewrite rule10 * Add a straight rewrite rule. 11 11 * 12 * {@internal Missing Long Description}} 13 * 12 * @see WP_Rewrite::add_rule() for long description. 14 13 * @since 2.1.0 15 14 * 16 * @param unknown_type $regex17 * @param unknown_type $redirect18 * @param unknown_type $after15 * @param string $regex Regular Expression to match request against. 16 * @param string $redirect Page to redirect to. 17 * @param string $after Optional, default is 'bottom'. Where to add rule, can also be 'top'. 19 18 */ 20 19 function add_rewrite_rule($regex, $redirect, $after = 'bottom') { 21 20 global $wp_rewrite; … … 23 22 } 24 23 25 24 /** 26 * add_rewrite_tag() - Add a new tag (like %postname%)25 * Add a new tag (like %postname%). 27 26 * 28 * Warning: you must call this on init or earlier, otherwise 29 * the query var addition stuff won't work27 * Warning: you must call this on init or earlier, otherwise the query var 28 * addition stuff won't work. 30 29 * 31 30 * @since 2.1.0 32 31 * 33 * @param unknown_type$tagname34 * @param unknown_type$regex32 * @param string $tagname 33 * @param string $regex 35 34 */ 36 35 function add_rewrite_tag($tagname, $regex) { 37 36 //validation … … 47 46 } 48 47 49 48 /** 50 * add_feed() - Add a new feed type like /atom1/49 * Add a new feed type like /atom1/. 51 50 * 52 * {@internal Missing Long Description}}53 *54 51 * @since 2.1.0 55 52 * 56 * @param unknown_type$feedname57 * @param unknown_type $function58 * @return unknown53 * @param string $feedname 54 * @param callback $function Callback to run on feed display. 55 * @return string Feed action name. 59 56 */ 60 57 function add_feed($feedname, $function) { 61 58 global $wp_rewrite; … … 70 67 } 71 68 72 69 /** 73 * {@internal Missing Description}}70 * Endpoint Mask for Permalink. 74 71 * 75 72 * @since 2.1.0 76 73 */ 77 74 define('EP_PERMALINK', 1); 78 75 79 76 /** 80 * {@internal Missing Description}}77 * Endpoint Mask for Attachment. 81 78 * 82 79 * @since 2.1.0 83 80 */ 84 81 define('EP_ATTACHMENT', 2); 85 82 86 83 /** 87 * {@internal Missing Description}}84 * Endpoint Mask for date. 88 85 * 89 86 * @since 2.1.0 90 87 */ 91 88 define('EP_DATE', 4); 92 89 93 90 /** 94 * {@internal Missing Description}}91 * Endpoint Mask for year 95 92 * 96 93 * @since 2.1.0 97 94 */ 98 95 define('EP_YEAR', 8); 99 96 100 97 /** 101 * {@internal Missing Description}}98 * Endpoint Mask for month. 102 99 * 103 100 * @since 2.1.0 104 101 */ 105 102 define('EP_MONTH', 16); 106 103 107 104 /** 108 * {@internal Missing Description}}105 * Endpoint Mask for day. 109 106 * 110 107 * @since 2.1.0 111 108 */ 112 109 define('EP_DAY', 32); 113 110 114 111 /** 115 * {@internal Missing Description}}112 * Endpoint Mask for root. 116 113 * 117 114 * @since 2.1.0 118 115 */ 119 116 define('EP_ROOT', 64); 120 117 121 118 /** 122 * {@internal Missing Description}}119 * Endpoint Mask for comments. 123 120 * 124 121 * @since 2.1.0 125 122 */ 126 123 define('EP_COMMENTS', 128); 127 124 128 125 /** 129 * {@internal Missing Description}}126 * Endpoint Mask for searches. 130 127 * 131 128 * @since 2.1.0 132 129 */ 133 130 define('EP_SEARCH', 256); 134 131 135 132 /** 136 * {@internal Missing Description}}133 * Endpoint Mask for categories. 137 134 * 138 135 * @since 2.1.0 139 136 */ 140 137 define('EP_CATEGORIES', 512); 141 138 142 139 /** 143 * {@internal Missing Description}}140 * Endpoint Mask for tags. 144 141 * 145 142 * @since 2.3.0 146 143 */ 147 144 define('EP_TAGS', 1024); 148 145 149 146 /** 150 * {@internal Missing Description}}147 * Endpoint Mask for authors. 151 148 * 152 149 * @since 2.1.0 153 150 */ 154 151 define('EP_AUTHORS', 2048); 155 152 156 153 /** 157 * {@internal Missing Description}}154 * Endpoint Mask for pages. 158 155 * 159 156 * @since 2.1.0 160 157 */ … … 162 159 163 160 //pseudo-places 164 161 /** 165 * {@internal Missing Description}}162 * Endpoint Mask for default, which is nothing. 166 163 * 167 164 * @since 2.1.0 168 165 */ 169 166 define('EP_NONE', 0); 170 167 171 168 /** 172 * {@internal Missing Description}}169 * Endpoint Mask for everything. 173 170 * 174 171 * @since 2.1.0 175 172 */ 176 173 define('EP_ALL', 8191); 177 174 178 175 /** 179 * add_rewrite_endpoint() - Add an endpoint, like /trackback/176 * Add an endpoint, like /trackback/. 180 177 * 181 * {@internal Missing Long Description}} 178 * The endpoints are added to the end of the request. So a request matching 179 * "/2008/10/14/my_post/myep/", the endpoint will be "/myep/". 182 180 * 183 181 * @since 2.1.0 182 * @see WP_Rewrite::add_endpoint() Parameters and more description. 183 * @uses $wp_rewrite 184 184 * 185 185 * @param unknown_type $name 186 186 * @param unknown_type $places … … 191 191 } 192 192 193 193 /** 194 * _wp_filter_taxonomy_base() - filter the URL base for taxonomies, to remove any manually prepended /index.php/ 195 * @param string $base the taxonomy base that we're going to filter 194 * Filter the URL base for taxonomies. 195 * 196 * To remove any manually prepended /index.php/. 197 * 198 * @access private 199 * @since unknown (2.3.0?) 200 * @author Mark Jaquith 201 * 202 * @param string $base The taxonomy base that we're going to filter 196 203 * @return string 197 * @author Mark Jaquith198 204 */ 199 205 function _wp_filter_taxonomy_base( $base ) { 200 206 if ( !empty( $base ) ) { … … 204 210 return $base; 205 211 } 206 212 207 // examine a url (supposedly from this blog) and try to208 // determine the post ID it represents.209 213 /** 210 * url_to_postid() - Examine a url and try to determine the post ID it represents214 * Examine a url and try to determine the post ID it represents. 211 215 * 212 * {@internal Missing Long Description}}213 *214 216 * Checks are supposedly from the hosted site blog. 215 217 * 216 218 * @since 1.0.0 217 219 * 218 * @param unknown_type $url219 * @return unknown220 * @param string $url Permalink to check. 221 * @return int Post ID, or 0 on failure. 220 222 */ 221 223 function url_to_postid($url) { 222 224 global $wp_rewrite; … … 315 317 } 316 318 317 319 /** 318 * {@internal Missing Short Description}}320 * WordPress Rewrite Component. 319 321 * 320 * {@internal Missing Long Description}} 322 * The WordPress Rewrite class writes the rewrite module rules to the .htaccess 323 * file. It also handles parsing the request to get the correct setup for the 324 * WordPress Query class. 321 325 * 326 * The Rewrite along with WP class function as a front controller for WordPress. 327 * You can add rules to trigger your page view and processing using this 328 * component. The full functionality of a front controller does not exist, 329 * meaning you can't define how the template files load based on the rewrite 330 * rules. 331 * 322 332 * @since 1.5.0 323 333 */ 324 334 class WP_Rewrite { 325 335 /** 326 * {@internal Missing Description}}336 * Default permalink structure for WordPress. 327 337 * 328 338 * @since 1.5.0 329 339 * @access private 330 * @var unknown_type340 * @var string 331 341 */ 332 342 var $permalink_structure; 333 343 334 344 /** 335 * {@internal Missing Description}}345 * Whether to add trailing slashes. 336 346 * 337 347 * @since 2.2.0 338 348 * @access private … … 341 351 var $use_trailing_slashes; 342 352 343 353 /** 344 * {@internal Missing Description}}354 * Customized or default category permalink base ( example.com/xx/tagname ). 345 355 * 346 356 * @since 1.5.0 347 357 * @access private 348 * @var unknown_type358 * @var string 349 359 */ 350 360 var $category_base; 351 361 352 362 /** 353 * {@internal Missing Description}}363 * Customized or default tag permalink base ( example.com/xx/tagname ). 354 364 * 355 365 * @since 2.3.0 356 366 * @access private 357 * @var unknown_type367 * @var string 358 368 */ 359 369 var $tag_base; 360 370 361 371 /** 362 * {@internal Missing Description}}372 * Permalink request structure for categories. 363 373 * 364 374 * @since 1.5.0 365 375 * @access private 366 * @var unknown_type376 * @var string 367 377 */ 368 378 var $category_structure; 369 379 370 380 /** 371 * {@internal Missing Description}}381 * Permalink request structure for tags. 372 382 * 373 383 * @since 2.3.0 374 384 * @access private 375 * @var unknown_type385 * @var string 376 386 */ 377 387 var $tag_structure; 378 388 379 389 /** 380 * {@internal Missing Description}}390 * Permalink author request base ( example.com/author/authorname ). 381 391 * 382 392 * @since 1.5.0 383 393 * @access private … … 386 396 var $author_base = 'author'; 387 397 388 398 /** 389 * {@internal Missing Description}}399 * Permalink request structure for author pages. 390 400 * 391 401 * @since 1.5.0 392 402 * @access private 393 * @var unknown_type403 * @var string 394 404 */ 395 405 var $author_structure; 396 406 397 407 /** 398 * {@internal Missing Description}}408 * Permalink request structure for dates. 399 409 * 400 410 * @since 1.5.0 401 411 * @access private 402 * @var unknown_type412 * @var string 403 413 */ 404 414 var $date_structure; 405 415 406 416 /** 407 * {@internal Missing Description}}417 * Permalink request structure for pages. 408 418 * 409 419 * @since 1.5.0 410 420 * @access private 411 * @var unknown_type421 * @var string 412 422 */ 413 423 var $page_structure; 414 424 415 425 /** 416 * {@internal Missing Description}}426 * Search permalink base ( example.com/search/query ). 417 427 * 418 428 * @since 1.5.0 419 429 * @access private … … 422 432 var $search_base = 'search'; 423 433 424 434 /** 425 * {@internal Missing Description}}435 * Permalink request structure for searches. 426 436 * 427 437 * @since 1.5.0 428 438 * @access private 429 * @var unknown_type439 * @var string 430 440 */ 431 441 var $search_structure; 432 442 433 443 /** 434 * {@internal Missing Description}}444 * Comments permalink base. 435 445 * 436 446 * @since 1.5.0 437 447 * @access private … … 440 450 var $comments_base = 'comments'; 441 451 442 452 /** 443 * {@internal Missing Description}}453 * Feed permalink base. 444 454 * 445 455 * @since 1.5.0 446 456 * @access private … … 449 459 var $feed_base = 'feed'; 450 460 451 461 /** 452 * {@internal Missing Description}}462 * Comments feed request structure permalink. 453 463 * 454 464 * @since 1.5.0 455 465 * @access private … … 458 468 var $comments_feed_structure; 459 469 460 470 /** 461 * {@internal Missing Description}}471 * Feed request structure permalink. 462 472 * 463 473 * @since 1.5.0 464 474 * @access private … … 467 477 var $feed_structure; 468 478 469 479 /** 470 * {@internal Missing Description}}480 * Front URL path. 471 481 * 482 * The difference between the root property is that WordPress might be 483 * located at example/WordPress/index.php, if permalinks are turned off. The 484 * index.php will be the front portion. If permalinks are turned on, this 485 * will most likely be empty or not set. 486 * 472 487 * @since 1.5.0 473 488 * @access private 474 * @var unknown_type489 * @var string 475 490 */ 476 491 var $front; 477 492 478 493 /** 479 * {@internal Missing Description}}494 * Root URL path to WordPress (without domain). 480 495 * 496 * The difference between front property is that WordPress might be located 497 * at example.com/WordPress/. The root is the 'WordPress/' portion. 498 * 481 499 * @since 1.5.0 482 * @access 483 * @var unknown_type500 * @access private 501 * @var string 484 502 */ 485 503 var $root = ''; 486 504 487 505 /** 488 * {@internal Missing Description}}506 * Permalink to the home page. 489 507 * 490 508 * @since 1.5.0 491 509 * @access public … … 498 516 * 499 517 * @since 1.5.0 500 518 * @access private 501 * @var unknown_type519 * @var string 502 520 */ 503 521 var $matches = ''; 504 522 505 523 /** 506 * {@internal Missing Description}}524 * Rewrite rules to match against the request to find the redirect or query. 507 525 * 508 526 * @since 1.5.0 509 527 * @access private … … 512 530 var $rules; 513 531 514 532 /** 515 * {@internal Missing Description}}533 * Additional rules added external to the rewrite class. 516 534 * 517 * Those not generated by the class, see add_rewrite_rule() 535 * Those not generated by the class, see add_rewrite_rule(). 518 536 * 519 537 * @since 2.1.0 520 538 * @access private … … 523 541 var $extra_rules = array(); // 524 542 525 543 /** 526 * {@internal Missing Description}}544 * Additional rules that belong at the beginning to match first. 527 545 * 528 * Those not generated by the class, see add_rewrite_rule() 546 * Those not generated by the class, see add_rewrite_rule(). 529 547 * 530 548 * @since 2.3.0 531 549 * @access private … … 547 565 * 548 566 * @since 2.1.0 549 567 * @access private 550 * @var unknown_type568 * @var array 551 569 */ 552 570 var $extra_permastructs = array(); 571 572 /** 573 * Endpoints permalinks 574 * 575 * @since unknown 576 * @access private 577 * @var array 578 */ 553 579 var $endpoints; 554 580 555 581 /** … … 643 669 ); 644 670 645 671 /** 646 * {@internal Missing Description}}672 * Supported default feeds. 647 673 * 648 674 * @since 1.5.0 649 675 * @access private … … 652 678 var $feeds = array ( 'feed', 'rdf', 'rss', 'rss2', 'atom' ); 653 679 654 680 /** 655 * {@internal Missing Short Description}}681 * Whether permalinks are being used. 656 682 * 657 * {@internal Missing Long Description}}683 * This can be either rewrite module or permalink in the HTTP query string. 658 684 * 659 685 * @since 1.5.0 660 686 * @access public 661 687 * 662 * @return unknown688 * @return bool True, if permalinks are enabled. 663 689 */ 664 690 function using_permalinks() { 665 691 if (empty($this->permalink_structure)) … … 669 695 } 670 696 671 697 /** 672 * {@internal Missing Short Description}}698 * Whether permalinks are being used and rewrite module is not enabled. 673 699 * 674 * {@internal Missing Long Description}}700 * Means that permalink links are enabled and index.php is in the URL. 675 701 * 676 702 * @since 1.5.0 677 703 * @access public 678 704 * 679 * @return unknown705 * @return bool 680 706 */ 681 707 function using_index_permalinks() { 682 708 if (empty($this->permalink_structure)) { … … 692 718 } 693 719 694 720 /** 695 * {@internal Missing Short Description}}721 * Whether permalinks are being used and rewrite module is enabled. 696 722 * 697 * {@internal Missing Long Description}}723 * Using permalinks and index.php is not in the URL. 698 724 * 699 725 * @since 1.5.0 700 726 * @access public 701 727 * 702 * @return unknown728 * @return bool 703 729 */ 704 730 function using_mod_rewrite_permalinks() { 705 731 if ( $this->using_permalinks() && ! $this->using_index_permalinks()) … … 716 742 * @since 1.5.0 717 743 * @access public 718 744 * 719 * @param unknown_type $number720 * @return unknown745 * @param int $number Index number. 746 * @return string 721 747 */ 722 748 function preg_index($number) { 723 749 $match_prefix = '$'; … … 815 841 } 816 842 817 843 /** 818 * {@internal Missing Short Description}}844 * Retrieve date permalink structure, with year, month, and day. 819 845 * 820 * {@internal Missing Long Description}} 846 * The permalink structure for the date, if not set already depends on the 847 * permalink structure. It can be one of three formats. The first is year, 848 * month, day; the second is day, month, year; and the last format is month, 849 * day, year. These are matched against the permalink structure for which 850 * one is used. If none matches, then the default will be used, which is 851 * year, month, day. 821 852 * 853 * Prevents post ID and date permalinks from overlapping. In the case of 854 * post_id, the date permalink will be prepended with front permalink with 855 * 'date/' before the actual permalink to form the complete date permalink 856 * structure. 857 * 822 858 * @since 1.5.0 823 859 * @access public 824 860 * 825 * @return unknown861 * @return bool|string False on no permalink structure. Date permalink structure. 826 862 */ 827 863 function get_date_permastruct() { 828 864 if (isset($this->date_structure)) { … … 869 905 } 870 906 871 907 /** 872 * {@internal Missing Short Description}}908 * Retrieve the year permalink structure without month and day. 873 909 * 874 * {@internal Missing Long Description}} 910 * Gets the date permalink structure and strips out the month and day 911 * permalink structures. 875 912 * 876 913 * @since 1.5.0 877 914 * @access public 878 915 * 879 * @return unknown916 * @return bool|string False on failure. Year structure on success. 880 917 */ 881 918 function get_year_permastruct() { 882 919 $structure = $this->get_date_permastruct($this->permalink_structure); … … 894 931 } 895 932 896 933 /** 897 * {@internal Missing Short Description}}934 * Retrieve the month permalink structure without day and with year. 898 935 * 899 * {@internal Missing Long Description}} 936 * Gets the date permalink structure and strips out the day permalink 937 * structures. Keeps the year permalink structure. 900 938 * 901 939 * @since 1.5.0 902 940 * @access public 903 941 * 904 * @return unknown942 * @return bool|string False on failure. Year/Month structure on success. 905 943 */ 906 944 function get_month_permastruct() { 907 945 $structure = $this->get_date_permastruct($this->permalink_structure); … … 918 956 } 919 957 920 958 /** 921 * {@internal Missing Short Description}}959 * Retrieve the day permalink structure with month and year. 922 960 * 923 * {@internal Missing Long Description}}961 * Keeps date permalink structure with all year, month, and day. 924 962 * 925 963 * @since 1.5.0 926 964 * @access public 927 965 * 928 * @return unknown966 * @return bool|string False on failure. Year/Month/Day structure on success. 929 967 */ 930 968 function get_day_permastruct() { 931 969 return $this->get_date_permastruct($this->permalink_structure); 932 970 } 933 971 934 972 /** 935 * {@internal Missing Short Description}}973 * Retrieve the permalink structure for categories. 936 974 * 937 975 * {@internal Missing Long Description}} 938 976 * 939 977 * @since 1.5.0 940 978 * @access public 941 979 * 942 * @return unknown980 * @return bool|string False on failure. Category permalink structure. 943 981 */ 944 982 function get_category_permastruct() { 945 983 if (isset($this->category_structure)) { … … 962 1000 } 963 1001 964 1002 /** 965 * {@internal Missing Short Description}}1003 * Retrieve the permalink structure for tags. 966 1004 * 967 1005 * {@internal Missing Long Description}} 968 1006 * 969 1007 * @since 2.3.0 970 1008 * @access public 971 1009 * 972 * @return unknown1010 * @return bool|string False on failure. Tag permalink structure. 973 1011 */ 974 1012 function get_tag_permastruct() { 975 1013 if (isset($this->tag_structure)) { … … 991 1029 return $this->tag_structure; 992 1030 } 993 1031 1032 /** 1033 * Retrieve extra permalink structure by name. 1034 * 1035 * @since unknown 1036 * @access public 1037 * 1038 * @param string $name Permalink structure name. 1039 * @return string|bool False if not found. Permalink structure string. 1040 */ 994 1041 function get_extra_permastruct($name) { 995 1042 if ( isset($this->extra_permastructs[$name]) ) 996 1043 return $this->extra_permastructs[$name]; … … 998 1045 } 999 1046 1000 1047 /** 1001 * {@internal Missing Short Description}}1048 * Retrieve the author permalink structure. 1002 1049 * 1003 * {@internal Missing Long Description}} 1050 * The permalink structure is front property, author base, and finally 1051 * '/%author%'. Will set the author_structure property and then return it 1052 * without attempting to set the value again. 1004 1053 * 1005 1054 * @since 1.5.0 1006 1055 * @access public 1007 1056 * 1008 * @return unknown1057 * @return string|bool False if not found. Permalink structure string. 1009 1058 */ 1010 1059 function get_author_permastruct() { 1011 1060 if (isset($this->author_structure)) { … … 1023 1072 } 1024 1073 1025 1074 /** 1026 * {@internal Missing Short Description}}1075 * Retrieve the search permalink structure. 1027 1076 * 1028 * {@internal Missing Long Description}} 1077 * The permalink structure is root property, search base, and finally 1078 * '/%search%'. Will set the search_structure property and then return it 1079 * without attempting to set the value again. 1029 1080 * 1030 1081 * @since 1.5.0 1031 1082 * @access public 1032 1083 * 1033 * @return unknown1084 * @return string|bool False if not found. Permalink structure string. 1034 1085 */ 1035 1086 function get_search_permastruct() { 1036 1087 if (isset($this->search_structure)) { … … 1048 1099 } 1049 1100 1050 1101 /** 1051 * {@internal Missing Short Description}}1102 * Retrieve the page permalink structure. 1052 1103 * 1053 * {@internal Missing Long Description}} 1104 * The permalink structure is root property, and '%pagename%'. Will set the 1105 * page_structure property and then return it without attempting to set the 1106 * value again. 1054 1107 * 1055 1108 * @since 1.5.0 1056 1109 * @access public 1057 1110 * 1058 * @return unknown1111 * @return string|bool False if not found. Permalink structure string. 1059 1112 */ 1060 1113 function get_page_permastruct() { 1061 1114 if (isset($this->page_structure)) { … … 1073 1126 } 1074 1127 1075 1128 /** 1076 * {@internal Missing Short Description}}1129 * Retrieve the feed permalink structure. 1077 1130 * 1078 * {@internal Missing Long Description}} 1131 * The permalink structure is root property, feed base, and finally 1132 * '/%feed%'. Will set the feed_structure property and then return it 1133 * without attempting to set the value again. 1079 1134 * 1080 1135 * @since 1.5.0 1081 1136 * @access public 1082 1137 * 1083 * @return unknown1138 * @return string|bool False if not found. Permalink structure string. 1084 1139 */ 1085 1140 function get_feed_permastruct() { 1086 1141 if (isset($this->feed_structure)) { … … 1098 1153 } 1099 1154 1100 1155 /** 1101 * {@internal Missing Short Description}}1156 * Retrieve the comment feed permalink structure. 1102 1157 * 1103 * {@internal Missing Long Description}} 1158 * The permalink structure is root property, comment base property, feed 1159 * base and finally '/%feed%'. Will set the comment_feed_structure property 1160 * and then return it without attempting to set the value again. 1104 1161 * 1105 1162 * @since 1.5.0 1106 1163 * @access public 1107 1164 * 1108 * @return unknown1165 * @return string|bool False if not found. Permalink structure string. 1109 1166 */ 1110 1167 function get_comment_feed_permastruct() { 1111 1168 if (isset($this->comment_feed_structure)) { … … 1150 1207 } 1151 1208 1152 1209 /** 1153 * Generate the rules from permalink structure 1210 * Generate the rules from permalink structure. 1154 1211 * 1155 1212 * {@internal Missing Long Description}} 1156 1213 * … … 1640 1697 $wp->add_query_var($name); 1641 1698 } 1642 1699 1700 /** 1701 * {@internal Missing Short Description}} 1702 * 1703 * {@internal Missing Long Description}} 1704 * 1705 * @since unknown 1706 * @access public 1707 * 1708 * @param unknown_type $name 1709 * @param unknown_type $struct 1710 * @param unknown_type $with_front 1711 */ 1643 1712 function add_permastruct($name, $struct, $with_front = true) { 1644 1713 if ( $with_front ) 1645 1714 $struct = $this->front . $struct; … … 1647 1716 } 1648 1717 1649 1718 /** 1650 * {@internal Missing Short Description}}1719 * Remove rewrite rules and then recreate rewrite rules. 1651 1720 * 1652 * {@internal Missing Long Description}} 1721 * Calls {@link WP_Rewrite::wp_rewrite_rules()} after removing the 1722 * 'rewrite_rules' option. If the function named 'save_mod_rewrite_rules' 1723 * exists, it will be called. 1653 1724 * 1654 1725 * @since 2.0.1 1655 1726 * @access public … … 1702 1773 } 1703 1774 1704 1775 /** 1705 * {@internal Missing Short Description}}1776 * Set the main permalink structure for the blog. 1706 1777 * 1707 * {@internal Missing Long Description}} 1778 * Will update the 'permalink_structure' option, if there is a difference 1779 * between the current permalink structure and the parameter value. Calls 1780 * {@link WP_Rewrite::init()} after the option is updated. 1708 1781 * 1709 1782 * @since 1.5.0 1710 1783 * @access public 1711 1784 * 1712 * @param unknown_type $permalink_structure1785 * @param string $permalink_structure Permalink structure. 1713 1786 */ 1714 1787 function set_permalink_structure($permalink_structure) { 1715 1788 if ($permalink_structure != $this->permalink_structure) { … … 1719 1792 } 1720 1793 1721 1794 /** 1722 * {@internal Missing Short Description}}1795 * Set the category base for the category permalink. 1723 1796 * 1724 * {@internal Missing Long Description}} 1797 * Will update the 'category_base' option, if there is a difference between 1798 * the current category base and the parameter value. Calls 1799 * {@link WP_Rewrite::init()} after the option is updated. 1725 1800 * 1726 1801 * @since 1.5.0 1727 1802 * @access public 1728 1803 * 1729 * @param unknown_type $category_base1804 * @param string $category_base Category permalink structure base. 1730 1805 */ 1731 1806 function set_category_base($category_base) { 1732 1807 if ($category_base != $this->category_base) { … … 1736 1811 } 1737 1812 1738 1813 /** 1739 * {@internal Missing Short Description}}1814 * Set the tag base for the tag permalink. 1740 1815 * 1741 * {@internal Missing Long Description}} 1816 * Will update the 'tag_base' option, if there is a difference between the 1817 * current tag base and the parameter value. Calls 1818 * {@link WP_Rewrite::init()} after the option is updated. 1742 1819 * 1743 1820 * @since 2.3.0 1744 1821 * @access public 1745 1822 * 1746 * @param unknown_type $tag_base1823 * @param string $tag_base Tag permalink structure base. 1747 1824 */ 1748 1825 function set_tag_base( $tag_base ) { 1749 1826 if ( $tag_base != $this->tag_base ) { … … 1753 1830 } 1754 1831 1755 1832 /** 1756 * {@internal Missing Short Description}}1833 * PHP4 Constructor - Calls init(), which runs setup. 1757 1834 * 1758 * {@internal Missing Long Description}}1759 *1760 1835 * @since 1.5.0 1761 1836 * @access public 1762 1837 *